diff --git a/02-DECISIONS/0290-a-decision-record-lives-whole-in-the-knowledge-base-made-of-clauses.md b/02-DECISIONS/0290-a-decision-record-lives-whole-in-the-knowledge-base-made-of-clauses.md index 897985df..f50e8fc6 100644 --- a/02-DECISIONS/0290-a-decision-record-lives-whole-in-the-knowledge-base-made-of-clauses.md +++ b/02-DECISIONS/0290-a-decision-record-lives-whole-in-the-knowledge-base-made-of-clauses.md @@ -25,10 +25,11 @@ extends: 02-DECISIONS/0153-the-record-is-read-by-a-module-and-the-console-lists- > inference layer. Following that, the knowledge base now reviews a proposal itself, through a fresh judgement. Option 3 of > *How a record is reviewed*, rule 4, rule 6 and the consequences say so. - -> **Updated — 2026-10-11.** Rule 8 gains `refresh`: comparing every imported record with its file found fields the +> **Updated — 2026-10-11, by the session building the knowledge base, under the operator's word to finish it.** Rule 8 +> gains `refresh`: comparing every imported record with its file found fields the > first import did not hold and clauses read from the wrong list (issue 487). A refresh writes a new version and > overwrites nothing, so the rule's *never overwrites* stands. + ## Context [Research 045](../01-RESEARCH/045-a-knowledge-base-the-mesh-writes/00-overview.md) measured, on 2026-10-11, how an @@ -155,7 +156,8 @@ rule 8 already decided that the issue tracker hands out decision and research nu 8. **The import reads this repository at a commit and can run again.** It writes every decision record and research effort whole, at its own number, with the commit as its first version's source; it creates what is absent, never overwrites, never advances a counter, and a second run changes nothing and says so. With `refresh` it re-reads a - record nobody but the import and the knowledge base's own drafting has written, and writes what an earlier import + record whose versions were all written by the import, a refresh, or the knowledge base's own drafting and + confirming of clauses, and writes what an earlier import misread as a new version naming why (to-be 55 §8). A record whose clauses are written as numbered statements gets them as `written`. A prose record gets them `drafted` by the agent's judgement ([ADR 0278](0278-the-issue-tracker-checks-every-new-issue-for-a-duplicate-through-a-judgement-the-agent-makes-without-tools.md)),