Development record
A reframe occasioned by a reading is a committed pointer to an event whose content stays local, and the frame it fingerprints is the framing as it presently stands, which adr-55 enumerates as three committed surfaces
Context
The cold-reading design lists where an accepted detection may land. Every landing exists but one: the frame. The design's landing table keeps two landings apart, the construal section rewritten by delivery (an Iteration 1 landing) and a frame-level revision record (Iteration 2), "without which a reframe occasioned by a reading cannot be recorded as a reframe". The closing run's purpose-durability and convergence readings need to tell a tension answered by a reframe from one answered by a build.
adr-55 rules that the framing as it presently stands is committed record and that declined construals, superseded terms and the reasoning that settled a dispute stay on the local side and are read by nothing automated. It enumerates that framing as three committed surfaces: The construal section's statement, the glossary's committed terms, and the committed scope. A frame-level record therefore cannot carry any prior text, and it cannot fingerprint fewer than the three surfaces without calling something narrower than the frame "the frame".
Decision
A reframe occasioned by a reading is one record in the working tier, beside the other reading families, carrying what occasioned it (a reading item, a disposition or a surprise), the content fingerprint of each of the three frame surfaces before and after the change, and the grounds. It carries no construal text, no term text and no scope text. It is warm, excluded from every reading by positive inclusion, and written only by a verb that reads the three surfaces' committed content itself and refuses a before-fingerprint it cannot find in their history.
The frame is the framing as it presently stands, which adr-55 enumerates as three committed surfaces: The construal section of the framing chapter, the committed glossary terms, and the committed scope. A reframe may touch any of the three, and the record shows which changed. A construal-only rewrite is one instance, not the definition.
Only a reframe a reading occasioned carries a record. A researcher may rewrite any of the three surfaces on their own account, and adr-55's rule that the construal is rewritten by delivery like any other brief passage stands for that case. This decision adds a pointer for the reading-occasioned case and no rule over every edit to the frame.
The join to the occasion is operator-asserted, with one check: the occasion predates the rewrite.
Alternatives Considered
- Fingerprint the construal section alone. Simpler, and narrower than both the design's frame and adr-55's framing: a reading-occasioned change to the glossary or the scope would go unrecorded as a reframe. Rejected.
- Require a reframe record on every frame edit, with a lint. Makes reframes countable at the cost of a rule on every edit to three brief surfaces and a lint that reads history, and the design asks only for the reading-occasioned case. Rejected for now; adoptable later without changing this record's shape.
- Carry the prior text in the record. Breaches adr-55: the abandoned framing is exactly what stays local. Rejected.
Consequences
- The three frame surfaces carry no marker and no history; the join lives in the record.
- The record dispatcher gains the reframe family, and the scribe's derived allow list and the comparative position's derived exclusion rows pick the family up from the ledger's directory list without a further change.
- adr-55 is refined, not superseded: its rule about what is committed and what stays local is untouched, and its enumeration of the framing's committed surfaces is the one this record fingerprints.
Status note
Accepted by the maintainer on 2026-09-02, at the planning interview for the
Iteration 2 intents, in the three-surface form because the single-section
form contradicted the design's landing table and adr-55's enumeration of the
framing's surfaces. Drafted
as proposed and held there until that interview, because it refines an
adopted decision, which is not an agent's act.
Frontmatter
| id | adr-2609021016288378 |
|---|---|
| type | adr |
| status | accepted |
| date | 2026-09-02 |
.abcd/development/decisions/adrs/2609021016288378-a-reframe-occasioned-by-a-reading-is-a.md
open on GitHub ↗ · commit history ↗
References4
- adr-50Framing traces never enter the record, and automated reviewers never read themrelated
- adr-55The construal stands in the record; its history does notrelated
- itd-143The brief gains a framing chapter under 01-product/ — the macro-why home: one section holds the project's framing, the why behind the why, and receives the brief-creation interview's committed framing products; the brief-lifeboat mapping gains the matching row so a lifeboat carries framing like any other sectionrelated
- itd-2609020625402518A reframe occasioned by a reading is recorded as a reframe, joined to what occasioned it, without carrying the construal it replacedrelated
mentions3
- dcn-26090200000000032026-09-02 — adr-2609021016272867, adr-2609021016275803, adr-2609021016270132 and adr-2609021016288378 are adopted (maintainer, at the same interview, each checked against the framework and the companion first). adr-2609021016272867: the comparative reading receives two body fields of one named widening run's items as the single exception to the prior-run exhaust, through a fourth closed operand naming the run; the maintainer chose the named operand over a derived selection because two widening runs coexist after the closing run, on the condition that an absent operand lists the runs the operator may choose from. adr-2609021016275803: per-run context stamps and a session-separation check that reports held-for-what-was-seen or unobserved, never clean; `scribe assemble` and `scribe ingest` with a ledger-only allow list derived from the ledger's directory list. adr-2609021016270132: the principles family is a declared record store with four typed keys, forward-only, read cold by statement and never by citation, with the inheritance check. adr-2609021016288378: in its three-surface form, because the single-section draft contradicted the design's two landings and adr-55's definition of the construal.
- dcn-26090200000000112026-09-02 — adr-56's third rule is refined, not contradicted, by the source-and-tests ruling (maintainer): a control that admits an input it cannot examine may pass it only with a per-item unscanned mark in its attestation, so the second rule (an attestation never says more than the examination) carries what the third rule carried; refusal stays the rule for an input the control claims to have examined and could not. Invariant 16 amended to say so. Every ADR is now checked against the framework v4 and the companion v4: adr-58 is superseded by adr-2609021016286571, adr-2609021016272867 is corrected to the derived run, and none of adr-55, adr-57, adr-2609021016275803, adr-2609021016270132, adr-2609021016288378 or adr-2609021016286571 contradicts either document. The two-hundred-thousand-token target is a clarification the documents do not speak to, kept as such.
- spc-2609020626048705The reframe record: `capture reframe` writes one `rfm-N` keyed on the committed fingerprints of the three frame surfaces before and after, joined to the reading item, disposition or surprise that occasioned it