<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/adr/4.x/2026-11-08-2-work-package-windows-are-recorded-at-the-opening-transition/">
  <id>https://docs.spec-kitty.ai/adr/4.x/2026-11-08-2-work-package-windows-are-recorded-at-the-opening-transition/</id>
  <title>ADR: work-package windows are recorded at the opening transition</title>
  <updated>2026-11-12T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/adr/4.x/2026-11-08-2-work-package-windows-are-recorded-at-the-opening-transition/"/>
  <summary>The consolidation gate judges each approved work package against the window recorded on the status event that opened it, built from one set of claim inputs.</summary>
  <content type="html">&lt;h2 id=&quot;work-package-windows-are-recorded-at-the-opening-transition&quot;&gt;Work-package windows are recorded at the opening transition&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Status:&lt;/strong&gt; Accepted (2026-11-10). The operator ratified it as written on PR #7490, including the interpretation that a review rejection back to &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; keeps the window and only a rewind from in-progress resets it.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Date:&lt;/strong&gt; 2026-11-08&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Deciders:&lt;/strong&gt; Stijn Dejongh (operator).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Amends:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;2026-10-04-5-approval-stamp-bounds-the-approved-claim&lt;/code&gt; (the approval stamp stays the closing edge of the window and the fallback bound; the lane’s own approval stamps stop exempting its commits on the window path).&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;2026-09-29-1-closed-world-refuse-on-mixed-lanes&lt;/code&gt; (the closed-world anchors are read from one frozen anchor set on resume; the lane anchor stays a named window variant).&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Technical Story:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;#7403: this Mission (consolidation window provenance and reconciliation split).&lt;/li&gt;
&lt;li&gt;#7358: parent sub-epic.&lt;/li&gt;
&lt;li&gt;#5721: the commit-between-two-approvals residual this ADR closes.&lt;/li&gt;
&lt;li&gt;#5048: the deletion-inference defect (fail-open history read), fixed in the same Mission.&lt;/li&gt;
&lt;li&gt;spec-kitty/spec-kitty-events#229: the cross-repository writer issue (FR-006), a context citation, not a gate.&lt;/li&gt;
&lt;li&gt;Follow-up: see #7359 (interrupted-run recovery and teardown honesty), #7362 (the forecast evaluating every verify-side check), #5703 (lane-id rebuild orphans recorded windows).&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Reader:&lt;/strong&gt; a maintainer who changes a consolidation check, the status transition pipeline, or the
forecast, and an agent doing either. It assumes you know the approval-stamp bound
(&lt;code dir=&quot;auto&quot;&gt;2026-10-04-5-approval-stamp-bounds-the-approved-claim&lt;/code&gt;) and the closed-world rule
(&lt;code dir=&quot;auto&quot;&gt;2026-09-29-1-closed-world-refuse-on-mixed-lanes&lt;/code&gt;).&lt;/p&gt;
&lt;h2 id=&quot;context-and-problem-statement&quot;&gt;Context and Problem Statement&lt;/h2&gt;
&lt;p&gt;The consolidation gate rebuilds each work package’s span of work from branch history after the
fact. Every check keeps its own idea of that span. Nine base or window notions exist on &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt;
(see the table under Decision Outcome), and a fix to one check has repeatedly had to reason about
the others. Of the 57 commits that touched &lt;code dir=&quot;auto&quot;&gt;consolidation/reconciliation.py&lt;/code&gt; on &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; before this
Mission, 43 carry a &lt;code dir=&quot;auto&quot;&gt;fix&lt;/code&gt; subject (&lt;code dir=&quot;auto&quot;&gt;git log --oneline main -- src/specify_cli/consolidation/reconciliation.py&lt;/code&gt;).&lt;/p&gt;
&lt;p&gt;Three problems follow:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;No recorded window.&lt;/strong&gt; The gate never knows where a work package’s work began. It infers the
window from stamps and branch history, so each check infers it differently.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Different inputs per mode.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate --dry-run&lt;/code&gt; (the forecast), a fresh run
and &lt;code dir=&quot;auto&quot;&gt;spec-kitty consolidate --resume&lt;/code&gt; call the same claim builder, &lt;code dir=&quot;auto&quot;&gt;build_approved_wp_set&lt;/code&gt;,
with different inputs. The forecast passes no excluded canceled work packages and a live
coordination base name; a resume reads some anchors from saved state and others from live
branches. The three can disagree on the same repository state.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;An unreviewed commit lands with exit 0.&lt;/strong&gt; A lane carries two work packages. WP01 is approved,
someone commits to the lane, WP02 opens and is approved. WP02’s approval stamp reaches the
stray commit, and the approval-stamp bound exempts everything an approval stamp of the lane
reaches. The gate accepts the commit (#5721, residual “a commit between two approvals on one
lane”).&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;consolidate&lt;/code&gt; here is lane consolidation: the local landing of approved lane work onto the local
target branch. It never publishes to a remote. “Primary” is not used in this record.&lt;/p&gt;
&lt;h2 id=&quot;decision-drivers&quot;&gt;Decision Drivers&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;The status event log is the only provenance authority (C-001). No second file, sidecar or store.&lt;/li&gt;
&lt;li&gt;The status package stays git-free (C-002). It reads git only through an injected probe.&lt;/li&gt;
&lt;li&gt;A missing window must never refuse a Mission by itself, and no refusal code is added (C-010).&lt;/li&gt;
&lt;li&gt;Missions in flight when this ships keep the verdict they would have had (user story 3).&lt;/li&gt;
&lt;li&gt;One recorded rule: every later change to a consolidation check follows the same window model.&lt;/li&gt;
&lt;li&gt;Forecast, fresh run and resume must feed the gate the same inputs, so an operator can trust a
forecast.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;considered-options&quot;&gt;Considered Options&lt;/h2&gt;
&lt;p&gt;For where the window is recorded (research R-01):&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;A.&lt;/strong&gt; Derive the window from existing &lt;code dir=&quot;auto&quot;&gt;lane_head&lt;/code&gt; stamps only, with no new key.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;B.&lt;/strong&gt; A separate provenance file or sidecar.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;C.&lt;/strong&gt; A new canonical event type that records the window.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;D.&lt;/strong&gt; Write the key only on the first opening move, with the status shell reading history to
decide.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;E.&lt;/strong&gt; A namespaced key on the status transition event, written on every non-migration move into
&lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt;, with the reader picking the window opener.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;For how far to unify the nine notions (R-02):&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;F.&lt;/strong&gt; One &lt;code dir=&quot;auto&quot;&gt;WindowLedger&lt;/code&gt; substrate for all nine notions now.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;G.&lt;/strong&gt; One window model, plus a table that maps every other notion to it or to a named window
variant.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;For a work package with no recorded window (R-03):&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;H.&lt;/strong&gt; Refuse, with an operator attestation as the escape hatch (what &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; did).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;I.&lt;/strong&gt; Fall back to the approval-stamp bound and report the gap.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;For the shape of the split of the reconciliation module (R-06), which this ADR constrains but does
not describe:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;J.&lt;/strong&gt; A subpackage. &lt;strong&gt;K.&lt;/strong&gt; Flat sibling modules behind a re-exporting facade.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;decision-outcome&quot;&gt;Decision Outcome&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Chosen options:&lt;/strong&gt; E, G, I and K.&lt;/p&gt;
&lt;h3 id=&quot;1-where-the-window-open-sha-is-recorded&quot;&gt;1. Where the window-open SHA is recorded&lt;/h3&gt;
&lt;p&gt;On every non-migration move of a lane-mapped work package into &lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt;, the
status shells write &lt;code dir=&quot;auto&quot;&gt;policy_metadata.wp_window&lt;/code&gt; on the transition event. The value comes from the
&lt;strong&gt;same lane-head reading&lt;/strong&gt; that produces &lt;code dir=&quot;auto&quot;&gt;lane_head&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;status/lane_head.py&lt;/code&gt;: &lt;code dir=&quot;auto&quot;&gt;read_lane_head&lt;/code&gt;
returns a &lt;code dir=&quot;auto&quot;&gt;LaneHeadReading&lt;/code&gt;), so recording adds no extra git read. The status transition pipeline
(&lt;code dir=&quot;auto&quot;&gt;status/transition_pipeline.py&lt;/code&gt;) stays git-free: the reading comes from the injected reader.&lt;/p&gt;
&lt;p&gt;The wire shape and the writer and reader rules (W-1 to W-7, R-1 to R-7) live in the contract
&lt;code dir=&quot;auto&quot;&gt;kitty-specs/consolidation-window-provenance-01M6Y84D/contracts/status-event-wp-window.md&lt;/code&gt;. This
record does not copy the JSON Schema. In prose, the writer rules are:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Write only for a non-migration actor, a move into &lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt;, and a work package
mapped to a non-planning execution lane (or a &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; Mission with a minted Mission
branch). &lt;code dir=&quot;auto&quot;&gt;blocked&lt;/code&gt; opens nothing.&lt;/li&gt;
&lt;li&gt;Take the value from the one lane-head reading. When both keys are written, &lt;code dir=&quot;auto&quot;&gt;open_sha&lt;/code&gt; equals
&lt;code dir=&quot;auto&quot;&gt;lane_head&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;A reading with a SHA writes &lt;code dir=&quot;auto&quot;&gt;open_sha&lt;/code&gt;. A reading of a mapped work package whose lane branch does
not exist writes the gap &lt;code dir=&quot;auto&quot;&gt;lane_branch_missing&lt;/code&gt;. Any other failed reading writes the gap
&lt;code dir=&quot;auto&quot;&gt;capture_failed&lt;/code&gt; with a cause of &lt;code dir=&quot;auto&quot;&gt;git_error&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;probe_error&lt;/code&gt;. A reading that does not apply
(planning lane, unassigned work package, no &lt;code dir=&quot;auto&quot;&gt;lanes.json&lt;/code&gt;) writes nothing.&lt;/li&gt;
&lt;li&gt;Never refuse, delay or retry a move because of the key. Never change another key. Never backfill
past rows (the log is append-only).&lt;/li&gt;
&lt;li&gt;A second writer, the Java write service, must write the same shape or preserve the key verbatim.
spec-kitty/spec-kitty-events#229 asks for that. A writer that drops the key turns later windows
into “not recorded” gaps, which is a weaker check and never a refusal.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The key is additive. An event that does not qualify is byte-identical to today’s row.&lt;/p&gt;
&lt;h3 id=&quot;2-the-typed-window-gap&quot;&gt;2. The typed window gap&lt;/h3&gt;
&lt;p&gt;A window gap is the explicit, typed absence of a usable window for a work package. Four reasons
exist:&lt;/p&gt;






























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Reason&lt;/th&gt;&lt;th&gt;Origin&lt;/th&gt;&lt;th&gt;Meaning&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;capture_failed&lt;/code&gt; (with &lt;code dir=&quot;auto&quot;&gt;cause&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;written&lt;/td&gt;&lt;td&gt;The lane branch exists but the head could not be read (&lt;code dir=&quot;auto&quot;&gt;git_error&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;probe_error&lt;/code&gt;).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;lane_branch_missing&lt;/code&gt;&lt;/td&gt;&lt;td&gt;written&lt;/td&gt;&lt;td&gt;The lane branch did not exist at the opening move. This is normal before &lt;code dir=&quot;auto&quot;&gt;implement&lt;/code&gt; creates the lane.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;not_recorded&lt;/code&gt;&lt;/td&gt;&lt;td&gt;reader only&lt;/td&gt;&lt;td&gt;The window opener carries no key (written before the upgrade, or by a writer that drops it), or the key is malformed.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;not_on_lane&lt;/code&gt;&lt;/td&gt;&lt;td&gt;reader only&lt;/td&gt;&lt;td&gt;The recorded SHA is not an ancestor of the lane tip (a rewritten lane), &lt;strong&gt;or does not resolve in this clone&lt;/strong&gt; (another clone, a collected object) (FR-022). Never a probe error; a git failure on a SHA that is in the clone is one, and the bound refuses on it (pre-PR fold M2).&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;The gap is a fact about what the writer observed (written reasons) or about the log and the lane at
read time (reader-only reasons). A missing approval stamp is not a window gap:
&lt;code dir=&quot;auto&quot;&gt;APPROVAL_STAMP_MISSING&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;APPROVAL_STAMP_NOT_ON_LANE&lt;/code&gt; keep their meaning and remedies.&lt;/p&gt;
&lt;h3 id=&quot;3-the-window-opener-fr-021&quot;&gt;3. The window opener (FR-021)&lt;/h3&gt;
&lt;p&gt;The recorded window binds to the &lt;strong&gt;window opener&lt;/strong&gt;, found by one shared selector:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;The cycle starts after the work package’s last non-migration move to &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; from a
non-review lane. Moves out of &lt;code dir=&quot;auto&quot;&gt;for_review&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;in_review&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt; are review
rejections and do &lt;strong&gt;not&lt;/strong&gt; reset the cycle (the genesis seed counts as a start).&lt;/li&gt;
&lt;li&gt;The candidates are the cycle’s non-migration moves into &lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt;, in event-log
order.&lt;/li&gt;
&lt;li&gt;Leading candidates that recorded &lt;code dir=&quot;auto&quot;&gt;lane_branch_missing&lt;/code&gt; are skipped: they prove no lane commit
existed at that instant.&lt;/li&gt;
&lt;li&gt;If the first remaining candidate has no usable value, that is the gap. An unrecorded opener is
never replaced by a later recorded one. Otherwise, among the SHA-bearing candidates, the
topologically earliest wins (the SHA that is an ancestor of every other), and event-log order
decides when the SHAs are unrelated.&lt;/li&gt;
&lt;li&gt;If only skipped candidates exist, the gap is &lt;code dir=&quot;auto&quot;&gt;lane_branch_missing&lt;/code&gt;. With no candidate at all,
the gap is &lt;code dir=&quot;auto&quot;&gt;not_recorded&lt;/code&gt;.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Interpretation recorded for review.&lt;/strong&gt; The operator ruling (Decision Moment
&lt;code dir=&quot;auto&quot;&gt;01M6YAG16WDVMM37HCJCHAC5YW&lt;/code&gt;) says the window opens after the work package “last returned to
&lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt;”. This ADR reads a review rejection as rework, not as a return: review rejections move a
work package &lt;code dir=&quot;auto&quot;&gt;in_review -&gt; planned&lt;/code&gt; today, and resetting the window there would put the work
package’s own earlier commits outside its window, refused with no attestation route. A move to
&lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; out of &lt;code dir=&quot;auto&quot;&gt;for_review&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;in_review&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;approved&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt; is therefore rework. Any other
move to &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; (today &lt;code dir=&quot;auto&quot;&gt;in_progress -&gt; planned&lt;/code&gt;) is a rewind and starts a new cycle. The &lt;code dir=&quot;auto&quot;&gt;force&lt;/code&gt;
flag is not read: a forced &lt;code dir=&quot;auto&quot;&gt;approved -&gt; planned&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;done -&gt; planned&lt;/code&gt; is rework like its unforced
twin, and a forced move to &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; out of any other lane is a rewind. The operator can overturn
this reading in review.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Clarification 2026-11-10 (operator ruling).&lt;/strong&gt; An unforced unclaim (&lt;code dir=&quot;auto&quot;&gt;in_progress -&gt; planned&lt;/code&gt;, and
&lt;code dir=&quot;auto&quot;&gt;blocked -&gt; planned&lt;/code&gt;) is a rewind: it starts a new cycle, so commits from the abandoned cycle that
are still on the lane are refused (“precedes approvals”). No attestation lifts that refusal. The
recovery is to take those commits off the lane, or not to unclaim work you mean to keep.&lt;/p&gt;
&lt;p&gt;The same selector (&lt;code dir=&quot;auto&quot;&gt;consolidation/wp_attribution.py&lt;/code&gt;: &lt;code dir=&quot;auto&quot;&gt;window_opener_events&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;window_open_of&lt;/code&gt;)
serves the &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; derivation when no window is recorded, with its legacy first-claim rule
(&lt;code dir=&quot;auto&quot;&gt;cycle=False&lt;/code&gt;). The opener rule lives once. The review-rejection reading above stays an
interpretation the operator may overturn; the shipped selector implements it and
&lt;code dir=&quot;auto&quot;&gt;tests/status/test_window_opener.py&lt;/code&gt; pins it.&lt;/p&gt;
&lt;h3 id=&quot;4-the-window-and-its-exemption-anchors&quot;&gt;4. The window and its exemption anchors&lt;/h3&gt;
&lt;p&gt;The &lt;strong&gt;work-package window&lt;/strong&gt; is &lt;code dir=&quot;auto&quot;&gt;(window-open SHA, newest approval stamp]&lt;/code&gt;. A work package with a
gap gets a &lt;strong&gt;degraded window&lt;/strong&gt;, &lt;code dir=&quot;auto&quot;&gt;(claim base, approval stamp]&lt;/code&gt;, which is exactly today’s
approval-stamp coverage for it.&lt;/p&gt;
&lt;p&gt;On a code lane with at least one recorded window, a lane commit that lies in no window and is
reached by no &lt;strong&gt;exemption anchor&lt;/strong&gt; is refused with &lt;code dir=&quot;auto&quot;&gt;LANE_MOVED_AFTER_APPROVAL&lt;/code&gt;, naming the commit
and the work package approved before it. The stamp refusals come first, as today, and merge
commits and bookkeeping-only commits are dropped exactly as today.&lt;/p&gt;
&lt;p&gt;The exemption anchors on the window path (Decision Moment &lt;code dir=&quot;auto&quot;&gt;01M6YAFYHT0RMVZB03THW1WWSE&lt;/code&gt;) are the
closed-world anchors (the dependency-lane tips of lanes that are not fully canceled, and the
target’s pre-consolidation tip) plus the approval stamps of &lt;strong&gt;other&lt;/strong&gt; bounded lanes. A lane’s own
approval stamps are &lt;strong&gt;not&lt;/strong&gt; anchors on this path: the windows replace them. That is what makes the
commit-between-two-approvals refusal possible.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Dependency-chain exception.&lt;/strong&gt; A commit another lane’s approval stamp reaches is content inside
that lane’s reviewed tip, so it stays exempt. If lane B depends on lane A, merged lane A’s tip with
a stray commit, and B’s work package was then approved, the stray commit is exempt on lane A. The
exception is deliberate and pinned by a dependency-chain fixture. The own-lane variant, where the
stray commit is reachable only from the lane’s own stamp, refuses.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Two tiers.&lt;/strong&gt; The lane check runs in two tiers (&lt;code dir=&quot;auto&quot;&gt;consolidation/write_branch_bound.py&lt;/code&gt;:
&lt;code dir=&quot;auto&quot;&gt;bind_lane_predicates&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;classify_windows&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;check_lane_windows&lt;/code&gt;). Tier 1 is today’s approval-stamp
check, &lt;code dir=&quot;auto&quot;&gt;check_lane&lt;/code&gt;, unchanged and first: the stamp refusals and content after a lane’s own
approval stamps keep today’s whole-lane text. Tier 2 runs only when tier 1 passed and refuses each
content commit in &lt;code dir=&quot;auto&quot;&gt;claim base..tip&lt;/code&gt; that no window covers and no exemption anchor reaches, one
refusal per commit, with the new per-commit text (&lt;code dir=&quot;auto&quot;&gt;render_lane_window_refusals&lt;/code&gt;), printed after
every lane’s tier-1 refusals. So the new text appears only for commits tier 1 cannot see (between
two approvals, or work abandoned before a rewind); a claim with no tier-2 refusal renders
byte-identical to today. The exempt set is computed once per lane and handed to both tiers.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Canceled work packages (operator ruling 2026-11-09).&lt;/strong&gt; A canceled work package gets no window, so
its commits on a lane with recorded windows would otherwise refuse in tier 2 although the mixed-lane
rules already judge them. The commits the mixed-lane resolution attributed to the lane’s canceled
work packages are therefore exempt from tier 2 (&lt;code dir=&quot;auto&quot;&gt;reconciliation_bound._canceled_window_exempt&lt;/code&gt;);
the mixed-lane and canceled-content rules are their only judge. Tier 1 is unchanged: a canceled
work package’s commit after an approval stamp still refuses (#5720). The &lt;code dir=&quot;auto&quot;&gt;orchestrator-api&lt;/code&gt; door
(&lt;code dir=&quot;auto&quot;&gt;approved_bound_refusal&lt;/code&gt;) runs neither the mixed-lane nor the canceled-content checks, so it
exempts no canceled commit: the strict window rule judges them there.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Declared dependency refs (pre-PR fold M9).&lt;/strong&gt; A lane can carry content inherited before its first
window: an external ref merged into it before the work package’s claim, or a lane cut from another
ref. Before windows were recorded, the lane’s own approval stamp exempted that content; with a
recorded window it lies before the window. The commits of the operator’s declared, pinned
&lt;code dir=&quot;auto&quot;&gt;--dependency-ref&lt;/code&gt; refs (#6771; exactly the verified set the closed world exempts) are therefore
exempt from tier 2 as well, so such a lane keeps its pre-window verdict. Tier 1 still never reads the
declaration, the &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; Mission-branch check is unchanged, and an undeclared external commit
before the window still refuses. Corpus cell &lt;code dir=&quot;auto&quot;&gt;fresh|single_lane|...|dependency_ref_merged_before_window&lt;/code&gt;
pins it.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Refusal text (pre-PR fold M8).&lt;/strong&gt; The tier-2 line names the commit and the work package approved
before it, and the recovery is to send that work package back for review and approve it again: its
window keeps its start and the new approval stamp moves its end past the commit. A commit that no
work package’s newest approval precedes (it lies before the named work package’s window, for example
work abandoned before a rewind) gets its own text and recovery: approving again moves a window’s end,
never its start, so no approval covers it and it has to come off the branch. A revert is never
advised: it is new content of its own and clears no window refusal.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;All-gap lane.&lt;/strong&gt; A lane on which every approved work package has a gap runs today’s
approval-stamp check (&lt;code dir=&quot;auto&quot;&gt;check_lane&lt;/code&gt;) unchanged, with today’s anchors, own stamps included. Its
verdict and refusal text are byte-identical to today’s (FR-023).&lt;/p&gt;
&lt;h3 id=&quot;5-claim-inputs-and-their-three-sources&quot;&gt;5. Claim inputs and their three sources&lt;/h3&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;ClaimInputs&lt;/code&gt; is one frozen value (&lt;code dir=&quot;auto&quot;&gt;consolidation/claim_inputs.py&lt;/code&gt;), built by one constructor
(&lt;code dir=&quot;auto&quot;&gt;build_claim&lt;/code&gt;), consumed by claim building and by the gate. Its source is a &lt;code dir=&quot;auto&quot;&gt;ClaimInputSource&lt;/code&gt;. Its fields are: the target base, the coordination base, the frozen lane tips, the frozen
dependency anchors, the dependency refs and their pins, the excluded canceled work packages, the
strategy, the status directory read, and its source.&lt;/p&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Source&lt;/th&gt;&lt;th&gt;Mode&lt;/th&gt;&lt;th&gt;Meaning&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;LIVE&lt;/code&gt;&lt;/td&gt;&lt;td&gt;forecast (&lt;code dir=&quot;auto&quot;&gt;--dry-run&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;Every value read from live branches.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;LIVE_THEN_SAVED&lt;/code&gt;&lt;/td&gt;&lt;td&gt;fresh run&lt;/td&gt;&lt;td&gt;Read live, then saved to &lt;code dir=&quot;auto&quot;&gt;state.json&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;ConsolidationState&lt;/code&gt;) at claim capture.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;SAVED&lt;/code&gt;&lt;/td&gt;&lt;td&gt;resume (&lt;code dir=&quot;auto&quot;&gt;--resume&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;Read from the saved record. A value that was saved is never re-read live.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Equality compares refs by the SHA they resolve to, and the status directory by its resolved path
and the digest of its event log. Phase 2 of the Mission keeps every per-mode quirk exactly. Phase 4
aligns the forecast’s excluded canceled work packages and its coordination base (resolved to a SHA)
with the fresh run’s (FR-013). The forecast keeps the status read door; it resolves the same status
directory as the fresh run’s write accessor on every topology the corpus builds, so no status
directory change was needed (one residual, below).&lt;/p&gt;
&lt;h3 id=&quot;6-durability-horizon&quot;&gt;6. Durability horizon&lt;/h3&gt;
&lt;p&gt;A recorded SHA is valid for one consolidation attempt: the forecast, a fresh run, a resume and the
teardown. It is &lt;strong&gt;branch-relative provenance&lt;/strong&gt;, consistent with
&lt;code dir=&quot;auto&quot;&gt;2026-11-07-1-dossier-commit-shas-are-branch-relative-provenance&lt;/code&gt;. After a rebase landing it may
not resolve, and no reader after the landing may require it. The key
&lt;code dir=&quot;auto&quot;&gt;policy_metadata.wp_window.open_sha&lt;/code&gt; is classified &lt;code dir=&quot;auto&quot;&gt;BRANCH_RELATIVE&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;DOSSIER_SHA_FIELDS&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_dossier_sha_provenance.py&lt;/code&gt;).&lt;/p&gt;
&lt;h3 id=&quot;7-missing-window-fallback&quot;&gt;7. Missing-window fallback&lt;/h3&gt;
&lt;p&gt;A work package with a window gap is judged by the approval-stamp bound with the degraded window and
is &lt;strong&gt;never refused for the gap alone&lt;/strong&gt;. No refusal code is added, and existing codes, remedies and
attestation flags keep their meaning. Every work package judged by the fallback is listed in the
&lt;strong&gt;gap report&lt;/strong&gt; with its reason. &lt;code dir=&quot;auto&quot;&gt;APPROVAL_STAMP_MISSING&lt;/code&gt; is unchanged. Missions in flight at
upgrade therefore reach the verdict they would have reached before it.&lt;/p&gt;
&lt;p&gt;Gap-report surfaces: the fresh run, the resume and the forecast (a human block headed “Window gaps
(judged by the approval-stamp bound)”, and &lt;code dir=&quot;auto&quot;&gt;window_gaps&lt;/code&gt; in the dry-run JSON, also on a refusal).
Each entry is a &lt;code dir=&quot;auto&quot;&gt;GapEntry&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;consolidation/wp_attribution.py&lt;/code&gt;), rendered by
&lt;code dir=&quot;auto&quot;&gt;consolidation/window_gap_report.py&lt;/code&gt;; the block prints before a claim-time refusal. The
&lt;code dir=&quot;auto&quot;&gt;orchestrator-api&lt;/code&gt; envelope is unchanged (no contract version change); see the residual below.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;The forecast reports the approved-bound refusals&lt;/strong&gt; (research R-09, settled by the corpus).
&lt;code dir=&quot;auto&quot;&gt;consolidate --dry-run&lt;/code&gt; builds the full claim, so a post-approval commit is forecast as
&lt;code dir=&quot;auto&quot;&gt;CLAIM_REFUSED_FORECAST&lt;/code&gt; naming &lt;code dir=&quot;auto&quot;&gt;LANE_MOVED_AFTER_APPROVAL&lt;/code&gt; (cell
&lt;code dir=&quot;auto&quot;&gt;forecast|single_lane|post_approval_commit&lt;/code&gt;), and a missing or rewritten stamp as
&lt;code dir=&quot;auto&quot;&gt;APPROVAL_STAMP_MISSING&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;APPROVAL_STAMP_NOT_ON_LANE&lt;/code&gt;. The window refusals reach it the same way.&lt;/p&gt;
&lt;h3 id=&quot;8-the-frozen-anchor-set-on-resume&quot;&gt;8. The frozen anchor set on resume&lt;/h3&gt;
&lt;p&gt;On &lt;code dir=&quot;auto&quot;&gt;--resume&lt;/code&gt;, one frozen claim-time anchor set, built from the dependency-lane tips frozen at
claim capture, feeds every consumer of the closed-world anchors (Decision Moment
&lt;code dir=&quot;auto&quot;&gt;01M6YAFZVZAYR4G20Q2X4PN0FT&lt;/code&gt;). There are four consumers:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;the mixed-lane resolver;&lt;/li&gt;
&lt;li&gt;the approved bound;&lt;/li&gt;
&lt;li&gt;the fully-canceled lane’s own commits;&lt;/li&gt;
&lt;li&gt;the approved-reviewed attestation check.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;A dependency lane that moved after the interruption no longer widens what is exempt on any axis.
A dependency lane rewound to an ancestor after the interrupted run keeps the frozen (wider) tip, matching what that run’s claim already judged.
A fresh run reads live tips, which equal what the claim freezes on an unmutated state, so its
verdict is unchanged. A dependency lane the record froze no tip for is read live, listed in
&lt;code dir=&quot;auto&quot;&gt;ClaimInputs.degraded_dependency_anchors&lt;/code&gt;, and named in a note on the resume. Only the coordination
topology freezes lane tips, so a resume of a &lt;code dir=&quot;auto&quot;&gt;LANES&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; Mission with a dependency
lane always prints that note.&lt;/p&gt;
&lt;h3 id=&quot;9-the-two-recording-tiers&quot;&gt;9. The two recording tiers&lt;/h3&gt;




















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Tier&lt;/th&gt;&lt;th&gt;What it records&lt;/th&gt;&lt;th&gt;Where&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Work-package transition&lt;/td&gt;&lt;td&gt;the window-open SHA or the gap, the approval stamp&lt;/td&gt;&lt;td&gt;the status event log&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Run claim&lt;/td&gt;&lt;td&gt;the claim inputs: bases, frozen lane tips, pins, excluded set, strategy&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;state.json&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;ConsolidationState&lt;/code&gt;)&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;ClaimInputs&lt;/code&gt; is run-level provenance. It never writes to the event log and never touches the
rollback snapshot. Rollback is out of scope: no module gains a rollback or branch-restore caller
outside the existing rollback authority (Follow-up: see #7359).&lt;/p&gt;
&lt;h3 id=&quot;10-the-nine-base-and-window-notions&quot;&gt;10. The nine base and window notions&lt;/h3&gt;
&lt;p&gt;Every notion on &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; maps to the one window model or to a named window variant. Homes are module
and symbol names after the split of &lt;code dir=&quot;auto&quot;&gt;reconciliation.py&lt;/code&gt; (now a re-exporting facade); line numbers
drift.&lt;/p&gt;

































































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;#&lt;/th&gt;&lt;th&gt;Notion&lt;/th&gt;&lt;th&gt;Home&lt;/th&gt;&lt;th&gt;Disposition in the window model&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;1&lt;/td&gt;&lt;td&gt;Coordination base (the lane-tip range base)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;consolidation/phase_claim.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;coord_base_ref&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;ClaimInputs.coord_base&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;2&lt;/td&gt;&lt;td&gt;Excluded window base (the target’s pre-mutation tip)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;consolidation/phase_claim.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;excluded_window_base&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;ClaimInputs.target_base&lt;/code&gt; (a claim-base input).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;3&lt;/td&gt;&lt;td&gt;The bound’s claim base&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;consolidation/reconciliation_bound.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;_bound_claim_base&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Derived from 1 and 2, unchanged. It is the degraded window’s opening edge.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;4&lt;/td&gt;&lt;td&gt;Presence lane bases&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;consolidation/wp_attribution.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;first_governed_open_stamp&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Named variant “lane anchor”&lt;/strong&gt;: &lt;code dir=&quot;auto&quot;&gt;blocked&lt;/code&gt; counts as an opener. Kept, because unifying it would change closed-world verdicts.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;5&lt;/td&gt;&lt;td&gt;Implementation and review windows&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;consolidation/wp_attribution.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;WorkWindow&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Named variant “canceled-content windows”&lt;/strong&gt;: class-change windows of mixed lanes. Unchanged.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;6&lt;/td&gt;&lt;td&gt;The approval stamp&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;consolidation/approved_bound.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;approval_stamp&lt;/code&gt;&lt;/td&gt;&lt;td&gt;The window’s closing edge, and the fallback bound.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;7&lt;/td&gt;&lt;td&gt;The owned-file evidence window (&lt;code dir=&quot;auto&quot;&gt;planning_commit_sha..tip&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;consolidation/wp_evidence.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Named variant “owned-file evidence”&lt;/strong&gt;: not stamp-based. Unchanged.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;8&lt;/td&gt;&lt;td&gt;The &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; authorship window (&lt;code dir=&quot;auto&quot;&gt;merge-base(target, mission)..mission&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;lanes/single_branch_landing.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;Named variant “&lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; authorship window”&lt;/strong&gt;, unchanged. &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; approval windows read the recorded window-open SHA when present (FR-011) and keep today’s derivation, reported as a gap, when absent.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;9&lt;/td&gt;&lt;td&gt;The closed-world anchors (dependency-lane tips and the target base)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;consolidation/reconciliation_kernel.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;_closed_world_anchors&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Anchor SHAs come from &lt;code dir=&quot;auto&quot;&gt;ClaimInputs&lt;/code&gt;. Frozen on resume (decision 8).&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;The &lt;code dir=&quot;auto&quot;&gt;blocked&lt;/code&gt; asymmetry is a named window variant, not drift: the approval-window opener ignores
&lt;code dir=&quot;auto&quot;&gt;blocked&lt;/code&gt;, the closed-world lane anchor counts it. Neither verdict changes.&lt;/p&gt;
&lt;h3 id=&quot;11-named-residuals&quot;&gt;11. Named residuals&lt;/h3&gt;
&lt;p&gt;These are accepted and named, so a later reader does not rediscover them:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Parallel claims on one lane&lt;/strong&gt;, and a claim parked without returning to &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt;: the window
opens early and also covers the other work package’s commits and any stray commit between them.
Over-wide window, pinned as a strict &lt;code dir=&quot;auto&quot;&gt;xfail&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A review rejection to &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; followed by another work package on the same lane.&lt;/strong&gt; WP01 is
rejected to &lt;code dir=&quot;auto&quot;&gt;planned&lt;/code&gt; (rework: its cycle continues), WP02 is claimed, worked and approved on the
same lane, then WP01 is claimed again and approved. WP01’s window still opens at its first opener,
so it covers WP02’s commits and any stray commit made between them. Over-wide window, a consequence
of reading a review rejection as rework (section 3).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The rewind boundary is found in event-log order.&lt;/strong&gt; Clock skew across the boundary itself is not
topology-corrected. (Skew between openers inside a cycle is corrected by topology order.)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Degraded anchors on resume.&lt;/strong&gt; A record written before the upgrade has no frozen tip for a
dependency lane, and a record whose status surface did not resolve at capture froze no tip. Both
keep today’s live read.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A full-restore re-baseline&lt;/strong&gt; (#6770) drops the frozen tips on &lt;code dir=&quot;auto&quot;&gt;LANES&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt;, so
the next resume is a fresh capture by design.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A canceled set that changes between capture and resume&lt;/strong&gt; only refuses or drops anchors, both
safe.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The forecast before the first status seed&lt;/strong&gt; (FR-013). A Mission whose coordination branch holds
no &lt;code dir=&quot;auto&quot;&gt;status.events.jsonl&lt;/code&gt; yet: the forecast reads the log through the read door’s pre-seed
fallback (the write checkout), while the fresh run seeds the coordination worktree and measures
its claim from that seed commit. Same log bytes, excluded set, lane tips and target base, but a
different status directory and coordination SHA. Pinned as the strict &lt;code dir=&quot;auto&quot;&gt;xfail&lt;/code&gt;
&lt;code dir=&quot;auto&quot;&gt;test_pre_seed_forecast_status_dir_and_coord_base_equal_fresh_run&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;tests/consolidation/test_forecast_fresh_run_parity.py&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The presence scope reads canceled lanes live on resume.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;reconciliation_authorship._presence_scope&lt;/code&gt;
is not one of the four frozen-anchor consumers. Its live read can only shrink the subtracted
canceled set, which makes the presence axis stricter, never looser.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Compound refusals exempt no canceled commit.&lt;/strong&gt; The canceled-dependency compound refusal evaluates
the bound before the mixed lanes are resolved, so the bound text it appends exempts no canceled
work package’s commit from tier 2. A canceled work package that is unattributable, attested
(&lt;code dir=&quot;auto&quot;&gt;--attest-canceled-superseded&lt;/code&gt;) or not, exempts nothing either. Both fail closed.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The window downgrade is invisible on &lt;code dir=&quot;auto&quot;&gt;orchestrator-api&lt;/code&gt;.&lt;/strong&gt; The envelope carries no gap report,
so a second writer that drops the key, or any other downgrade, is not visible to an orchestrator
until a later contract version carries the gap report.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;12-limits&quot;&gt;12. Limits&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Lane-id rebuild.&lt;/strong&gt; Recorded windows rely on the lane id to lane branch binding that
&lt;code dir=&quot;auto&quot;&gt;2026-10-04-2-started-work-package-lane-membership-is-frozen&lt;/code&gt; guarantees. A lane-id rebuild after
execution began orphans recorded windows (Follow-up: see #5703).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The Java writer&lt;/strong&gt; must write or preserve the key (spec-kitty/spec-kitty-events#229). Until it
does, work packages opened through it have no window.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;consequences&quot;&gt;Consequences&lt;/h2&gt;
&lt;h3 id=&quot;positive&quot;&gt;Positive&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;A commit made between two approvals on a lane with recorded windows is refused before any branch
moves (closes the #5721 residual).&lt;/li&gt;
&lt;li&gt;Every consolidation check has one place to ask where a work package’s window begins.&lt;/li&gt;
&lt;li&gt;Forecast, fresh run and resume build the claim from one construction point, so the forecast and
the fresh run can be compared on the same state.&lt;/li&gt;
&lt;li&gt;In-flight Missions are never refused for lacking a window, and the operator can see exactly which
work packages got the weaker check.&lt;/li&gt;
&lt;li&gt;The status package stays git-free, and recording adds no git read.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;negative&quot;&gt;Negative&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;The accepted dependency-chain exception.&lt;/strong&gt; A stray commit that a dependent lane merged before
its own approval stays exempt on the source lane.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A weaker check for a gap work package.&lt;/strong&gt; A gap work package’s degraded window covers a stray
commit between an earlier recorded work package’s approval and its own opening. The run passes
and the gap report names it. A gap work package followed by a recorded one, with a stray commit
between them, is newly refused.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A rewound window can still be over-wide&lt;/strong&gt; (residuals above).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A second writer can silently downgrade windows&lt;/strong&gt; until it writes the key and the envelope
carries the gap report.&lt;/li&gt;
&lt;li&gt;One more key on every opening event, and one more reader rule to keep in step with the Java
writer.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;neutral&quot;&gt;Neutral&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;No refusal code, allowlist entry, suppression or &lt;code dir=&quot;auto&quot;&gt;orchestrator-api&lt;/code&gt; contract version is added.&lt;/li&gt;
&lt;li&gt;The split of the reconciliation module follows this record but is behaviour-preserving, and the
only verdict changes are the named, red-first ones in the Mission.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;confirmation&quot;&gt;Confirmation&lt;/h3&gt;
&lt;p&gt;The characterization corpus, the refusal-precedence matrix and the surface pin landed first and
stayed unchanged across the split. Each behaviour change in this Mission is a named corpus cell
(NFR-002) with a test committed failing before its fix and passing after. As landed:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;(a), (b): a commit between two approvals refuses, naming the commit and the work package approved
before it (WP19). (c): a rewound work package’s window opens after the rewind, on lanes (WP19) and
&lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; (WP20).&lt;/li&gt;
&lt;li&gt;(d): a history-read error in the authored-content walk refuses the claim instead of counting the
path as deleted (#5048(b), WP16).&lt;/li&gt;
&lt;li&gt;(e), (f): on resume the closed world and the approved bound read the frozen anchors (WP18). On the
corpus (e) shape the new refusal is carried by the approved bound, because the closed world walks
only the non-merge commits of the first-parent spine and the dependency commit sits behind a
merge; the closed world’s own read of the frozen set is pinned by
&lt;code dir=&quot;auto&quot;&gt;test_resume_closed_world_does_not_exempt_a_post_interrupt_dependency_commit&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;(g): recorded unreachable. A fully-canceled lane has no frozen tip and is never an anchor, so any
route that brings its advance into the claim reaches a dependency lane after that lane’s approval
stamp, which the approved bound refuses with live or frozen anchors alike.
&lt;code dir=&quot;auto&quot;&gt;test_resume_fully_canceled_lane_flip_is_unreachable&lt;/code&gt; pins the reachable consequence.&lt;/li&gt;
&lt;li&gt;(h): the forecast excludes the fresh run’s canceled work packages (verdict-visible) and resolves
the coordination base to a SHA (field-level only) (WP17).&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The evidence: &lt;code dir=&quot;auto&quot;&gt;tests/status/test_wp_window_capture.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tests/status/test_window_opener.py&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;test_claim_inputs_parity.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_forecast_fresh_run_parity.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_lane_approval_windows.py&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;test_refusal_precedence_matrix_windows.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_lane_window_query_count.py&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;test_window_gap_report.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_window_gap_report_entry_points.py&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;test_authored_walk_read_error.py&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;test_resume_frozen_anchors.py&lt;/code&gt; (all under
&lt;code dir=&quot;auto&quot;&gt;tests/consolidation/&lt;/code&gt; unless named), and &lt;code dir=&quot;auto&quot;&gt;tests/integration/test_single_branch_approval_windows.py&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;Landing note (2026-11-10, operator ruling on #7490): the characterization corpus, the seeded-mutation
harness, the facade surface pin and the intended-verdict ledger were refactor scaffolding. They are
retired at landing, after an independent AST comparison showed every moved definition byte-identical
apart from the named verdict changes. The two intended-verdict checks no other test asserted moved
into &lt;code dir=&quot;auto&quot;&gt;test_resume_frozen_anchors.py&lt;/code&gt; (the merge-commit variant of (e)) and
&lt;code dir=&quot;auto&quot;&gt;test_lane_approval_windows.py&lt;/code&gt; (the naming line of (b)); each behaviour above is now carried by the
dedicated tests listed.&lt;/p&gt;
&lt;h2 id=&quot;pros-and-cons-of-the-options&quot;&gt;Pros and Cons of the Options&lt;/h2&gt;
&lt;h3 id=&quot;a-derive-from-lane_head-stamps-only&quot;&gt;A. Derive from &lt;code dir=&quot;auto&quot;&gt;lane_head&lt;/code&gt; stamps only&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;No new key.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;It cannot express a typed gap, so “capture failed” and “never recorded” look the same.&lt;/li&gt;
&lt;li&gt;The lane path would re-derive an opening from older stamps, which the operator ruled out.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;b-a-separate-file-or-sidecar&quot;&gt;B. A separate file or sidecar&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Free-form shape.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;A second authority and a second read door. Already rejected twice (ADRs
&lt;code dir=&quot;auto&quot;&gt;2026-09-29-1-closed-world-refuse-on-mixed-lanes&lt;/code&gt; and
&lt;code dir=&quot;auto&quot;&gt;2026-10-04-5-approval-stamp-bounds-the-approved-claim&lt;/code&gt;).&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;c-a-new-canonical-event-type&quot;&gt;C. A new canonical event type&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;A typed, versioned record.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;It duplicates the transition, adds an atomicity obligation, and is blocked on a spec-kitty-events
release.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;d-write-on-the-first-opening-move-only&quot;&gt;D. Write on the first opening move only&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;One row carries the key.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The shell must read history on every move, which moves window logic into the shell.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;e-a-namespaced-key-on-every-opening-move-chosen&quot;&gt;E. A namespaced key on every opening move (chosen)&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Ships from core alone: &lt;code dir=&quot;auto&quot;&gt;policy_metadata&lt;/code&gt; is an open mapping in the events payload.&lt;/li&gt;
&lt;li&gt;Reuses the lane-head reading already taken, so no extra git read.&lt;/li&gt;
&lt;li&gt;The reader, not the writer, decides which opener binds, so the status pipeline stays history-free.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Several rows can carry the key, so the reader must choose (the window opener rule).&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;f-a-full-windowledger-now&quot;&gt;F. A full &lt;code dir=&quot;auto&quot;&gt;WindowLedger&lt;/code&gt; now&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The right end state for all nine notions.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;It would turn a behaviour-preserving split into a redesign. Deferred.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;g-one-model-plus-named-variants-chosen&quot;&gt;G. One model plus named variants (chosen)&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Every notion is mapped, and no variant’s verdict changes outside the named lane change.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Variants remain, including the &lt;code dir=&quot;auto&quot;&gt;blocked&lt;/code&gt; asymmetry.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;h-refuse-with-attestation&quot;&gt;H. Refuse with attestation&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;A missing window is never silent.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;It would strand every Mission in flight at upgrade.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;i-fall-back-and-report-chosen&quot;&gt;I. Fall back and report (chosen)&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Missions in flight keep their verdict, and the gap is named in the output.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The fallback is a weaker check.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;j-a-subpackage&quot;&gt;J. A subpackage&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;It cannot share a name with the facade module, and a new &lt;code dir=&quot;auto&quot;&gt;__init__.py&lt;/code&gt; brings in the version-bump
rule.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;k-flat-sibling-modules-chosen&quot;&gt;K. Flat sibling modules (chosen)&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;No new package, and module ownership by directory glob stays unchanged.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;amendment-2026-11-12-7578-commit-to-target-single_branch-missions-record-their-window-points&quot;&gt;Amendment 2026-11-12 (#7578): commit-to-target single_branch Missions record their window points&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Status:&lt;/strong&gt; Accepted (operator rulings Q3 and Q8, 2026-11-12).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;What changes.&lt;/strong&gt; A commit-to-target &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; Mission is one whose write branch &lt;em&gt;is&lt;/em&gt; its target
branch: a Mission created with &lt;code dir=&quot;auto&quot;&gt;--commit-to-target&lt;/code&gt;, or created with an explicit
&lt;code dir=&quot;auto&quot;&gt;--topology single_branch&lt;/code&gt; on an unprotected target, where no Mission branch is minted. A Mission
created without &lt;code dir=&quot;auto&quot;&gt;--topology&lt;/code&gt; is not one: it mints a topic branch on every target
(&lt;code dir=&quot;auto&quot;&gt;core/mission_creation.py&lt;/code&gt;, FR-051). A Mission whose minted branch has landed reads as one too:
the landing’s teardown (&lt;code dir=&quot;auto&quot;&gt;consolidation/phase_teardown.py::_clear_landed_single_branch_mission_branch&lt;/code&gt;)
clears &lt;code dir=&quot;auto&quot;&gt;meta.mission_branch&lt;/code&gt;, so its later transitions are stamped at the target head; consolidation
has finished by then. Until now such a Mission recorded nothing: its transitions carried no
&lt;code dir=&quot;auto&quot;&gt;lane_head&lt;/code&gt; and its opening moves no &lt;code dir=&quot;auto&quot;&gt;wp_window&lt;/code&gt;. It now records both, taken at
the head of the target branch (&lt;code dir=&quot;auto&quot;&gt;status/lane_head.py::_single_branch_write_branch&lt;/code&gt;). The opening move
(&lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt;) records &lt;code dir=&quot;auto&quot;&gt;wp_window.open_sha&lt;/code&gt;; every lifecycle move records &lt;code dir=&quot;auto&quot;&gt;lane_head&lt;/code&gt;. A
missing target branch or a git failure is a typed gap, never a refused move. The planning lane of a
&lt;code dir=&quot;auto&quot;&gt;lanes&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;lanes_with_coord&lt;/code&gt; Mission still records nothing, and a Mission with an unlanded minted
Mission branch is unchanged. Its work package’s review range is derived from its committed status
events (operator ruling Q10) only where those events are committed on the branch its work is written
to: on a &lt;code dir=&quot;auto&quot;&gt;lanes&lt;/code&gt; Mission, and on a &lt;code dir=&quot;auto&quot;&gt;lanes_with_coord&lt;/code&gt; Mission whose coordination branch is the
planning lane’s write branch (a Mission created without &lt;code dir=&quot;auto&quot;&gt;--topology&lt;/code&gt; that settled &lt;code dir=&quot;auto&quot;&gt;lanes_with_coord&lt;/code&gt;,
before its landing). On any other &lt;code dir=&quot;auto&quot;&gt;lanes_with_coord&lt;/code&gt; Mission the events sit on the coordination
branch, apart from the work, and the range is unavailable.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Why.&lt;/strong&gt; The review range of a work package (#7578) reads a recorded window on every topology instead of
guessing one from branch history (ruling Q3).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Consolidation verdicts do not change (ruling Q8).&lt;/strong&gt; Such a Mission stays unbounded in consolidation:
&lt;code dir=&quot;auto&quot;&gt;reconciliation_bound._bound_write_branch&lt;/code&gt; returns &lt;code dir=&quot;auto&quot;&gt;None&lt;/code&gt; for it (it reads &lt;code dir=&quot;auto&quot;&gt;minted_mission_branch&lt;/code&gt;), and
&lt;code dir=&quot;auto&quot;&gt;approved_bound._approval_is_bounded&lt;/code&gt; excludes it. The new stamps would still have reached three other
readers. We measured each one on a real commit-to-target Mission, before and with the stamps, and
without a guard:&lt;/p&gt;



































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Reader&lt;/th&gt;&lt;th&gt;Before the stamps&lt;/th&gt;&lt;th&gt;With the stamps, no guard&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Canceled-work attribution on the planning lane (&lt;code dir=&quot;auto&quot;&gt;reconciliation_canceled._mixed_lanes&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;resolve_canceled_wp&lt;/code&gt;): WP01 approved, WP02 implemented then canceled&lt;/td&gt;&lt;td&gt;refused at claim time, exit 1: “canceled WP02 cannot be attributed … carry no commit attribution”&lt;/td&gt;&lt;td&gt;exit 0: the attribution came back empty and WP02’s committed content stayed on the target&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--dependency-ref&lt;/code&gt; guard (&lt;code dir=&quot;auto&quot;&gt;_recorded_lane_heads&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;exit 0, no recorded stamps&lt;/td&gt;&lt;td&gt;exit 0, 12 recorded stamps&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;--attest-approved-reviewed&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;_has_review_approval_stamp&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;exit 0, attestation recorded&lt;/td&gt;&lt;td&gt;exit 1: “WP01 already has one. Move it back for review instead.”&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Approved-only &lt;code dir=&quot;auto&quot;&gt;consolidate&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt;&lt;/td&gt;&lt;td&gt;exit 0 PASS / accept blocked by path conventions&lt;/td&gt;&lt;td&gt;unchanged&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;A commit after the last approval&lt;/td&gt;&lt;td&gt;exit 0, not refused&lt;/td&gt;&lt;td&gt;unchanged&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;The operator ruled to keep the stamps and keep every verdict as it was. One predicate decides
whether a Mission is commit-to-target: &lt;code dir=&quot;auto&quot;&gt;lanes/single_branch_landing.py::is_commit_to_target_meta&lt;/code&gt;,
which checks a stored &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; topology whose write branch equals the recorded target
(&lt;code dir=&quot;auto&quot;&gt;single_branch_branches&lt;/code&gt;, the reading the lane-head stamp also uses);
&lt;code dir=&quot;auto&quot;&gt;consolidation/commit_to_target_stamps.py::is_commit_to_target_mission&lt;/code&gt; calls it over a Mission’s
&lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt;. For such a Mission, &lt;code dir=&quot;auto&quot;&gt;consolidation_events&lt;/code&gt; removes &lt;code dir=&quot;auto&quot;&gt;lane_head&lt;/code&gt; and
&lt;code dir=&quot;auto&quot;&gt;wp_window&lt;/code&gt; from the status events that three seams read:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;the claim’s event log, &lt;code dir=&quot;auto&quot;&gt;reconciliation_kernel._ClaimEventLog.read&lt;/code&gt; (canceled-work attribution, the
canceled-dependency checks and the compound refusal);&lt;/li&gt;
&lt;li&gt;the &lt;code dir=&quot;auto&quot;&gt;--dependency-ref&lt;/code&gt; guard, &lt;code dir=&quot;auto&quot;&gt;reconciliation_closed_world._recorded_lane_heads&lt;/code&gt;;&lt;/li&gt;
&lt;li&gt;the attestation validation, &lt;code dir=&quot;auto&quot;&gt;approved_attestation.plan_approved_attestations&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;With the guard, all five rows above give the same verdict and the same text as before the stamps
(&lt;code dir=&quot;auto&quot;&gt;tests/consolidation/test_commit_to_target_stamp_characterization.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;STAMPED = True&lt;/code&gt;). The status
log keeps the stamps; only consolidation ignores them.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Corrections.&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Ruling Q3 named &lt;code dir=&quot;auto&quot;&gt;write_branch_bound.check_write_branch_windows&lt;/code&gt; as the consolidation mechanism these
stamps feed. For a commit-to-target Mission that check is never reached (&lt;code dir=&quot;auto&quot;&gt;_bound_write_branch&lt;/code&gt;
returns &lt;code dir=&quot;auto&quot;&gt;None&lt;/code&gt;). The rest of the ruling stands.&lt;/li&gt;
&lt;li&gt;Nothing refuses a commit-to-target Mission’s late commit today. The test that records this,
&lt;code dir=&quot;auto&quot;&gt;test_commit_to_target_unbounded_residual&lt;/code&gt;, is a strict &lt;code dir=&quot;auto&quot;&gt;xfail&lt;/code&gt;: its &lt;code dir=&quot;auto&quot;&gt;exit 1&lt;/code&gt; assertion fails, so the
residual (FR-078) stays open, and the stamps do not close it.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;amendment-2026-11-18-7726-the-bulk-edit-review-gate-reads-the-review-range&quot;&gt;Amendment 2026-11-18 (#7726): the bulk-edit review gate reads the review range&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Status:&lt;/strong&gt; Accepted (operator rulings A and B, 2026-11-18).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;What changes.&lt;/strong&gt; The bulk-edit review gate (&lt;code dir=&quot;auto&quot;&gt;agent action review&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;cli/commands/agent/workflow.py::_enforce_bulk_edit_diff_compliance&lt;/code&gt;) diffs from the work package’s
review range, &lt;code dir=&quot;auto&quot;&gt;review/wp_range.py::resolve_wp_review_range&lt;/code&gt;, on every topology. It no longer derives
its own base (&lt;code dir=&quot;auto&quot;&gt;lanes.json&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;mission_branch&lt;/code&gt;) and head (the review workspace branch). On
&lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; those two named the same branch, so the gate diffed &lt;code dir=&quot;auto&quot;&gt;X..X&lt;/code&gt; and passed having checked
nothing.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Head.&lt;/strong&gt; On &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; the gate judges up to the submission. Commits past it can be another
work package’s, so they are named as not judged; re-submitting judges them. On a lane topology it
judges up to the lane’s live head, as the gate did before, so a commit added to a lane after its
submission is still judged. The diff leaves out only the Mission’s own status files and task index
(&lt;code dir=&quot;auto&quot;&gt;review/wp_range.py::mission_bookkeeping_pathspecs&lt;/code&gt;: the &lt;code dir=&quot;auto&quot;&gt;kitty-specs/&amp;#x3C;mission&gt;/&lt;/code&gt; entries of
&lt;code dir=&quot;auto&quot;&gt;lanes/for_review_gate.py::status_only_excluded_prefixes&lt;/code&gt;, namely &lt;code dir=&quot;auto&quot;&gt;status.*&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;issue-matrix.*&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tasks/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;lanes.json&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;acceptance-matrix.json&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;analysis-report.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;decisions/&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;decisions.events.jsonl&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;traces/&lt;/code&gt;, plus &lt;code dir=&quot;auto&quot;&gt;tasks.md&lt;/code&gt;), so a ticked task file never blocks the
Mission’s own review. It does not leave out &lt;code dir=&quot;auto&quot;&gt;.kittify/&lt;/code&gt;: the range counts &lt;code dir=&quot;auto&quot;&gt;.kittify/&lt;/code&gt; as bookkeeping
when it lists commits (&lt;code dir=&quot;auto&quot;&gt;WpReviewRange.bookkeeping_pathspecs&lt;/code&gt;, which &lt;code dir=&quot;auto&quot;&gt;BULK_EDIT_REVIEW_RANGE_EMPTY&lt;/code&gt;
reads), but the gate still judges a &lt;code dir=&quot;auto&quot;&gt;.kittify/&lt;/code&gt; edit the occurrence map forbids, as it did on a
lane before #7726.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Planning lane in ruling Q10’s case.&lt;/strong&gt; A planning-lane work package of a &lt;code dir=&quot;auto&quot;&gt;lanes_with_coord&lt;/code&gt; Mission
whose coordination branch is not its planning branch has no review range: its status events sit
apart from its work. The gate judges it from its recorded claim base
(&lt;code dir=&quot;auto&quot;&gt;refs/spec-kitty/wp-base/&amp;#x3C;mission&gt;/&amp;#x3C;wp&gt;&lt;/code&gt;) to the head of its planning branch, named from &lt;code dir=&quot;auto&quot;&gt;meta.json&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;review.wp_range.planning_branch_apart_from_status&lt;/code&gt;), never the reviewer’s checkout. It applies only
in that case (gap &lt;code dir=&quot;auto&quot;&gt;not_recorded&lt;/code&gt;, no lane stamp, branches apart); every other missing range keeps the
range owner’s refusal. A missing claim base refuses: a claim base exists only in the clone that
claimed the work package, and no wider base stands in for it. The review context keeps ruling Q10
and shows no range.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Branches others commit to (ruling B).&lt;/strong&gt; On a commit-to-target &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; Mission and in the
planning-lane window, the gate judges only the paths that the window’s first-parent chain changed
itself, each with its net change over the window (&lt;code dir=&quot;auto&quot;&gt;bulk_edit/gate.py::_first_parent_paths&lt;/code&gt;, through
&lt;code dir=&quot;auto&quot;&gt;kernel.git.listing.log_paths(first_parent=True, remerge_merges=True)&lt;/code&gt;). Renames are split, so a moved
file’s old path stays judged. A merge on the chain contributes only what its own resolution
introduced (its diff against git’s automatic re-merge), never the commits it brought in. A foreign
commit that a rebase or a fast-forward puts on the first-parent chain cannot be told apart from the
work package’s own commits, so it is judged (fail-closed). When every changed path came in only
through merges, nothing the work package committed itself can be judged, and the gate refuses
&lt;code dir=&quot;auto&quot;&gt;BULK_EDIT_REVIEW_RANGE_EMPTY&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Refusals&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;bulk_edit/gate.py::review_range_refusal&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;workflow.py::_planning_lane_window&lt;/code&gt;), none
of them a pass:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;BULK_EDIT_REVIEW_RANGE_UNAVAILABLE&lt;/code&gt;: an &lt;code dir=&quot;auto&quot;&gt;UNAVAILABLE&lt;/code&gt; range, with its gap and a remedy, or a
commit listing that failed, or a planning-lane window without a claim base or planning branch;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;BULK_EDIT_REVIEW_RANGE_EMPTY&lt;/code&gt;: no commit outside Mission bookkeeping;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;BULK_EDIT_REVIEW_TIP_REWRITTEN&lt;/code&gt;: the submitted tip is no longer on its branch.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;A window that holds commits but no net change (for example a forbidden edit committed and then
reverted inside the window) passes: the gate judges what the work package would land, and an empty
net diff lands nothing, so there is nothing for the occurrence map to refuse. &lt;code dir=&quot;auto&quot;&gt;_EMPTY&lt;/code&gt; refuses only a
window with no commit outside bookkeeping, where the work package submitted no work at all.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Status moves need the local Mission branch (ruling A).&lt;/strong&gt; A minted &lt;code dir=&quot;auto&quot;&gt;single_branch&lt;/code&gt; Mission writes
its status to its Mission branch, so a status move without that branch locally refuses
&lt;code dir=&quot;auto&quot;&gt;DESTINATION_REF_NOT_FOUND&lt;/code&gt; (status routing, ADR &lt;code dir=&quot;auto&quot;&gt;2026-11-06-2&lt;/code&gt;, unchanged). That refusal now prints
the command that restores the branch: &lt;code dir=&quot;auto&quot;&gt;git fetch origin &amp;#x3C;b&gt;:&amp;#x3C;b&gt;&lt;/code&gt; when this clone’s view of origin
holds it (&lt;code dir=&quot;auto&quot;&gt;refs/remotes/origin/&amp;#x3C;b&gt;&lt;/code&gt;; the pre-flight contacts no remote), else
&lt;code dir=&quot;auto&quot;&gt;git branch &amp;#x3C;b&gt; &amp;#x3C;commit holding the work&gt;&lt;/code&gt;. Move-task’s &lt;code dir=&quot;auto&quot;&gt;SINGLE_BRANCH_IMPLEMENTATION_UNREADABLE&lt;/code&gt;
prints the &lt;code dir=&quot;auto&quot;&gt;git branch&lt;/code&gt; form. Recreating the branch is safe now, because the gate judges the work.
Fetching it automatically, through &lt;code dir=&quot;auto&quot;&gt;kernel.git.remote&lt;/code&gt;, is #7730.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Residuals.&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The ruling named a work package’s own merge commit as a fail-open edge (the approved bound’s
“content inside a merge commit”, ADR &lt;code dir=&quot;auto&quot;&gt;2026-10-04-5&lt;/code&gt;). The remerge diff closes it for a two-parent
merge: an edit folded into the merge is judged. An octopus merge (3 or more parents) contributes its
full first-parent diff instead, a superset that can include foreign content (fail-closed).&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;--diff-merges=remerge&lt;/code&gt; needs git 2.36 or later; an older git refuses the window rather than
judging less.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;references&quot;&gt;References&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Contract: &lt;code dir=&quot;auto&quot;&gt;kitty-specs/consolidation-window-provenance-01M6Y84D/contracts/status-event-wp-window.md&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Amends: &lt;code dir=&quot;auto&quot;&gt;2026-10-04-5-approval-stamp-bounds-the-approved-claim&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;2026-09-29-1-closed-world-refuse-on-mixed-lanes&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Related: &lt;code dir=&quot;auto&quot;&gt;2026-11-07-1-dossier-commit-shas-are-branch-relative-provenance&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;2026-10-04-2-started-work-package-lane-membership-is-frozen&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;2026-10-14-1-event-native-core-one-canonical-event-writer&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Decision Moments: &lt;code dir=&quot;auto&quot;&gt;01M6YAFYHT0RMVZB03THW1WWSE&lt;/code&gt; (lane anchor set), &lt;code dir=&quot;auto&quot;&gt;01M6YAFZVZAYR4G20Q2X4PN0FT&lt;/code&gt;
(resume anchor scope), &lt;code dir=&quot;auto&quot;&gt;01M6YAG16WDVMM37HCJCHAC5YW&lt;/code&gt; (window opener),
&lt;code dir=&quot;auto&quot;&gt;01M6YAG2HE6Q2XNQMGK6X3MBEK&lt;/code&gt; (events issue filing).&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty-events/issues/229&quot;&gt;spec-kitty/spec-kitty-events#229&lt;/a&gt;:
the Java write service adopts and types &lt;code dir=&quot;auto&quot;&gt;policy_metadata.wp_window&lt;/code&gt; (context citation, FR-006).&lt;/li&gt;
&lt;li&gt;Issues: #7403, #7358, #5721, #5048, #7359, #7362, #5703.&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
