feat(visibility): en lenke som ikke ble fulgt sier det - spor + betinget linje (ORDRE 20260821T142704Z)
okf._walk toleret en ulesbar/utenfor-basen lenke uten aa etterlate spor (okf.py:182
"continue # broken link"), og navigate_bundle returnerte kun filene den FANT. En base
der halve innholdet aldri ble lest var derfor umulig aa skille fra en base der de
dokumentene aldri ble skrevet - og toerrkjoeringen sa ingenting.
Toleransen er UROERT: OKF SPEC §4 krever at navigasjonen ikke kaster, og den kaster
fortsatt ikke. Dette er synlighet, ikke en ny nekt.
To tenner (samme form som ordre 20260821T092039Z, synlig uforankring):
1. okf.SkippedLink + Bundle.skipped - strukturert spor, aldri en streng: hvilken fil
lenken sto i, lenketeksten ORDRETT (operatoeren redigerer den teksten, ikke den
resolverte stien), og hvilken av de TO grunnene som gjaldt - outside-bundle (escape,
ofte bevisst) eller missing (inne i basen, ingen lesbar fil, nesten alltid en
skrivefeil). Dedup-grenen (canonical in seen) registreres ALDRI: den er korrekt
navigasjon og det som terminerer sykler.
2. run.skipped_links_notice - EN renderer, tar den alt opploeste tuppelen, returnerer
None naar ingenting ble hoppet over. Printes paa BEGGE flater: --live-dry-run og
den fulle enkeltkjoeringen (en kjoering som PRODUSERTE et forslag fra en halvlest
base er der tausheten kostet mest).
Defaulten er MOTSATT forrige ordres, og forskjellen er innsikten: cost_baseline_anchored
er paakrevd fordi begge defaults lyver, mens en TOM tuppel her er et aerlig positivt
utsagn ("hver lenke ble fulgt") - external_calls-presedensen. Vei-stien navigerer ingen
base, saa tom er bokstavelig sant der ogsaa.
Sporet bor paa RunResult.skipped_links (RUN-nivaa: navigasjonen skjer EN gang per
kjoering, foer noe forslag finnes), aldri paa ProvenanceStamp, som beskriver gaten som
doemte EN kandidat. Ingenting av dette naar bundle_context - derfor er de commons-eide
nav-goldenene byte-uendret, og Bundle( har fortsatt EN konstruksjons-sted (maalt).
Load-bearing MAALT (tests/test_navigation_visibility_loadbearing.py), aatte mutasjoner
alle roede mot HELE suiten + groenn kontroll 897 passed / 5 skipped:
detach missing-registreringen (6 roede) · detach outside-bundle (2) · kollaps de to
grunnene til en (2) · registrer dedup-grenen (1) · renderer returnerer alltid linja
(3, inkl. kontrollene - omisjonen er selv gatet) · detach dry-run-printen (1) ·
detach full-run-printen (1) · konstant tom trace ut av run_project (4).
Docs rettet der de paasto det motsatte: kunnskapsbase-for-en-kjoring.md §5.7 + §6,
presentasjon-bygge-kunnskapsbase.html (steg 8, steg 9, fallgruve 3, avslutningen),
README-ens navigasjonsavsnitt, og CLAUDE.md-ens navigasjons-kontrakt-invariant.
This commit is contained in:
parent
b6397229ca
commit
56c48f6f65
7 changed files with 547 additions and 28 deletions
|
|
@ -496,9 +496,25 @@ modellene er oppløst, takene er satt, og ingen ekstern tjeneste vil bli kontakt
|
|||
skjer før kuttet, uten et eneste modellkall (VERIFISERT: `run.py:513-516` ligger før
|
||||
dry-run-returen på `:565-588`).
|
||||
|
||||
**Hva `OK` sier fra om:** en lenke kjøringen ikke klarte å følge. Tørrkjøringen skriver da én
|
||||
blokk under `OK`-linja — én linje per lenke, med filen lenken sto i, lenketeksten ordrett, og
|
||||
hvorfor: `missing` (målet ligger inne i basen, men det er ingen lesbar fil der — nesten alltid en
|
||||
skrivefeil i lenken) eller `outside-bundle` (målet peker ut av basen). Er alle lenkene fulgt,
|
||||
skrives ingen linje i det hele tatt. Målt på en base med begge feilene:
|
||||
|
||||
```
|
||||
Knowledge base: 2 cross-link(s) NOT followed — the agents never read the document(s) behind them:
|
||||
- index.md -> metodikk-som-aldri-ble-skrevet.md (missing)
|
||||
- index.md -> ../nabobase/index.md (outside-bundle)
|
||||
```
|
||||
|
||||
Selve toleransen er uendret: en brutt lenke stopper ikke kjøringen (OKF SPEC §4 krever det). Det
|
||||
som er nytt er at den ikke lenger er taus — før dette var «dokumentet ble aldri skrevet» og «lenken
|
||||
til det var feil» umulig å skille utenfra. Den samme blokka skrives på en full kjøring.
|
||||
|
||||
**Hva `OK` ikke beviser:** at `cost-baseline.json` *finnes* (se [§4.1](#41-den-skarpeste-mangelen-cost-baselinejson)
|
||||
— sjekk det med `ls`), at lenkene i `index.md` når alle filene (en brutt lenke hoppes stille over),
|
||||
eller at innholdet er godt. `--docs-dir` må oppgis, men leses ikke på bundle-stien (VERIFISERT:
|
||||
— sjekk det med `ls`), at filene faktisk er lenket fra `index.md` (en fil ingen lenker til er
|
||||
unåbar, og da finnes det ingen lenke å rapportere), eller at innholdet er godt. `--docs-dir` må oppgis, men leses ikke på bundle-stien (VERIFISERT:
|
||||
`run.py:513-530` bruker bare `bundle_dir`; `:1504` krever flagget likevel). Pek den på samme
|
||||
mappe.
|
||||
|
||||
|
|
@ -538,10 +554,11 @@ så dokumentet ikke lover mer enn det som kan leveres.
|
|||
tilnærming i bestillingen (VERIFISERT: `run.py:634-638`; én `expel_query` for hele
|
||||
kjøringen). En bestilling med to tilnærminger mot to ulike kostlinjer får tidligere dommer
|
||||
hentet for den kandidaten `validator-input.json` beskriver.
|
||||
- **Det finnes ingen «er basen klar?»-kommando.** `--live-dry-run` beviser at basen *åpner*, og
|
||||
sier nå fra hvis `cost-baseline.json` mangler — men ingenting om brutte lenker, og ingenting om
|
||||
innholdets kvalitet. `preflight` sjekker Azure-konfigurasjon, ikke basen (VERIFISERT:
|
||||
`preflight.py` docstring).
|
||||
- **Det finnes ingen «er basen klar?»-kommando.** `--live-dry-run` beviser at basen *åpner*, sier
|
||||
fra hvis `cost-baseline.json` mangler, og lister lenkene den ikke klarte å følge
|
||||
([§5.7](#57-kjøreklar-sjekken)) — men ingenting om innholdets kvalitet, og ingenting om filer
|
||||
ingen lenker til (de er unåbare, så det finnes ingen brutt lenke å rapportere). `preflight`
|
||||
sjekker Azure-konfigurasjon, ikke basen (VERIFISERT: `preflight.py` docstring).
|
||||
- **Uforankret kjøring er synlig, men ikke summert.** Feltet og linja finnes per kjøring
|
||||
([§4.1](#41-den-skarpeste-mangelen-cost-baselinejson)); det finnes ingen rapport som teller opp
|
||||
hvor mange kjøringer i et porteføljepass som gikk uforankret.
|
||||
|
|
|
|||
|
|
@ -313,7 +313,7 @@
|
|||
du vil at det skal se.</p>
|
||||
<div class="done"><b>Ferdig når</b>Hvert dokument du har laget er lenket. Et dokument uten lenke
|
||||
eksisterer ikke, uansett hvor det ligger. Og trenger du fagstoff fra en annen base: kopier det
|
||||
inn — lenker ut av basen følges aldri, uten feilmelding.</div>
|
||||
inn — lenker ut av basen følges aldri, men tørrkjøringen lister dem, så du ser at det skjedde.</div>
|
||||
</section>
|
||||
|
||||
<section class="slide">
|
||||
|
|
@ -323,15 +323,19 @@
|
|||
stopper der — den koster ingenting, og kan kjøres hver gang basen endres.</p>
|
||||
<table>
|
||||
<tr><th>Tørrkjøringen beviser</th><th>Den beviser ikke</th></tr>
|
||||
<tr><td>at basen åpner</td><td>at lenkene når alle dokumentene</td></tr>
|
||||
<tr><td>at navnet stemmer overalt</td><td>at innholdet er godt</td></tr>
|
||||
<tr><td>at kostnadsgrunnlaget er lesbart</td><td>at forslagene blir kloke</td></tr>
|
||||
<tr><td>at basen åpner</td><td>at innholdet er godt</td></tr>
|
||||
<tr><td>at navnet stemmer overalt</td><td>at forslagene blir kloke</td></tr>
|
||||
<tr><td>at kostnadsgrunnlaget er lesbart</td><td>at alt du laget faktisk er lenket</td></tr>
|
||||
<tr><td>hvilke lenker den ikke klarte å følge</td><td>—</td></tr>
|
||||
<tr><td>at ingen ekstern tjeneste kontaktes</td><td>—</td></tr>
|
||||
</table>
|
||||
<p>Mangler kostnadsgrunnlaget, sier tørrkjøringen fra. Er en lenke brutt, hoppes dokumentet stille
|
||||
over — det er den ene feilen du må lete etter selv.</p>
|
||||
<div class="done"><b>Ferdig når</b>Tørrkjøringen er grønn, og du har lest gjennom listen over
|
||||
dokumenter den faktisk fant.</div>
|
||||
<p>Mangler kostnadsgrunnlaget, sier tørrkjøringen fra. Er en lenke brutt, stopper den fortsatt
|
||||
ikke kjøringen — men den skrives ut, med dokumentet den pekte på og hvorfor den ikke ble fulgt
|
||||
(<code>missing</code> = ingen fil der, <code>outside-bundle</code> = peker ut av basen). Er alle
|
||||
lenker fulgt, står det ingenting. Den feilen den fortsatt ikke kan se, er dokumentet
|
||||
<em>ingen</em> lenker til — da finnes det ingen lenke å rapportere.</p>
|
||||
<div class="done"><b>Ferdig når</b>Tørrkjøringen er grønn, den lister ingen lenker den ikke fulgte,
|
||||
og du har lest gjennom listen over dokumenter den faktisk fant.</div>
|
||||
</section>
|
||||
|
||||
<section class="slide">
|
||||
|
|
@ -416,8 +420,10 @@
|
|||
dømmer bare mot tall forslaget fant på selv. Dette er den dyreste feilen, fordi den er usynlig.</li>
|
||||
<li><strong>Gjennomførte tiltak står ikke i basen.</strong> Systemet foreslår dem på nytt, og
|
||||
besparelsen dobbelttelles.</li>
|
||||
<li><strong>Dokumenter uten lenke.</strong> De leses aldri, og ingen feilmelding sier fra.
|
||||
Symptomet er at forslagene virker uinformerte uten at noen skjønner hvorfor.</li>
|
||||
<li><strong>Dokumenter uten lenke.</strong> De leses aldri, og ingen feilmelding sier fra —
|
||||
for det finnes ingen lenke å klage på. Er lenken der, men feil, sier tørrkjøringen nå fra;
|
||||
er den aldri skrevet, er dokumentet usynlig. Symptomet er at forslagene virker uinformerte
|
||||
uten at noen skjønner hvorfor.</li>
|
||||
<li><strong>For mye materiale.</strong> Alt som lenkes leses i sin helhet. Ti sider støy koster
|
||||
like mye oppmerksomhet som ti sider substans.</li>
|
||||
<li><strong>Utledede tall.</strong> Et tall ingen kan peke på en kilde for, forurenser alt som
|
||||
|
|
@ -433,8 +439,9 @@
|
|||
kostnadstallene og å få en fagperson til å skrive ned rammene sine.</li>
|
||||
<li><strong>Det finnes ingen automatikk</strong> som lager basen av regnearkene deres. Det er
|
||||
håndarbeid, og det er derfor det tar tid.</li>
|
||||
<li><strong>Det finnes ingen «er basen klar»-knapp.</strong> Tørrkjøringen er det nærmeste, og
|
||||
den sier ingenting om brutte lenker eller om innholdet er godt.</li>
|
||||
<li><strong>Det finnes ingen «er basen klar»-knapp.</strong> Tørrkjøringen er det nærmeste: den
|
||||
sier fra om kostnadsgrunnlaget mangler og lister lenkene den ikke klarte å følge, men den sier
|
||||
ingenting om et dokument ingen har lenket til, og ingenting om innholdet er godt.</li>
|
||||
<li><strong>Systemet dømmer ikke.</strong> Det foreslår og kontrollerer regnestykket.
|
||||
Vurderingen av om tiltaket er klokt, gjør fagpersonen — og den vurderingen er det basen lærer av.</li>
|
||||
</ul>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue