<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/architecture/wp-runtime-state-eviction/">
  <id>https://docs.spec-kitty.ai/architecture/wp-runtime-state-eviction/</id>
  <title>WP Runtime-State Eviction — Architecture Design</title>
  <updated>2026-10-05T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/architecture/wp-runtime-state-eviction/"/>
  <summary>Architecture design for evicting runtime-mutable state from tasks/WP##.md into the append-only event log via a non-transition annotation event class; ADR 2026-07-16-1.</summary>
  <content type="html">&lt;span id=&quot;wp-runtime-state-eviction--architecture-design&quot;&gt;&lt;/span&gt;
&lt;p&gt;This design realises &lt;a href=&quot;/adr/3.x/2026-07-16-1-wp-runtime-state-authority-event-log-eviction/&quot;&gt;ADR 2026-07-16-1&lt;/a&gt;.
It moves &lt;em&gt;every&lt;/em&gt; runtime-mutable field out of &lt;code dir=&quot;auto&quot;&gt;tasks/WP##.md&lt;/code&gt; (and the &lt;code dir=&quot;auto&quot;&gt;tasks.md&lt;/code&gt;
subtask surface) into the canonical append-only event log, so that &lt;code dir=&quot;auto&quot;&gt;WP##.md&lt;/code&gt;
holds &lt;strong&gt;only static design-intent&lt;/strong&gt; and hashes stably across every runtime
mutation. It is the charter-completion of #2093 / #2400 and the prerequisite for
the YAML-authoritative WP-prompt schema (proposal Part 4 &lt;strong&gt;B3&lt;/strong&gt;).&lt;/p&gt;
&lt;p&gt;The authoritative scope, corrected writer/reader inventory, and the five pinned
decisions live in the ADR and in the working note
&lt;code dir=&quot;auto&quot;&gt;docs/plans/investigations/wp-runtime-state-eviction-scope.md&lt;/code&gt; (unpublished)
§“Squad review corrections (2026-07-16)”. This document is the buildable design
against those decisions.&lt;/p&gt;
&lt;h2 id=&quot;1-the-axis-problem-why-this-is-not-a-move-a-field-change&quot;&gt;1. The axis problem (why this is not a “move a field” change)&lt;/h2&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;status.events.jsonl&lt;/code&gt; is a &lt;strong&gt;transition ledger&lt;/strong&gt;. &lt;code dir=&quot;auto&quot;&gt;StatusEvent&lt;/code&gt; mandates
&lt;code dir=&quot;auto&quot;&gt;from_lane&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;to_lane&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;status/models.py:224-226&lt;/code&gt;), and &lt;code dir=&quot;auto&quot;&gt;validate_transition&lt;/code&gt;
rejects any edge outside the 9-lane FSM (&lt;code dir=&quot;auto&quot;&gt;status/transitions.py:53,83-99&lt;/code&gt;). Three
of the evicted mutations are &lt;strong&gt;non-transition&lt;/strong&gt; — they carry no lane change:&lt;/p&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Mutation&lt;/th&gt;&lt;th&gt;When&lt;/th&gt;&lt;th&gt;Today’s home&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;shell_pid&lt;/code&gt; refresh on &lt;strong&gt;resume&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;every &lt;code dir=&quot;auto&quot;&gt;implement&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;agent action&lt;/code&gt;, incl. resume of an already &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt; WP&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;implement_claim.py::_start_wp_implementation_status&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;workflow_executor.py:669&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;subtask mark&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;- [x] T###&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;mid-&lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tasks_materialization.py:260,304&lt;/code&gt;; uncheck in &lt;code dir=&quot;auto&quot;&gt;tasks.md&lt;/code&gt; at &lt;code dir=&quot;auto&quot;&gt;tasks_move_task.py:1662&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;activity-log note&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;mid-work, any time&lt;/td&gt;&lt;td&gt;6 writers incl. &lt;code dir=&quot;auto&quot;&gt;orchestrator_api/wp_lifecycle.py::append_history&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;A transition-event payload cannot carry any of these without a lane change to
attach to. The design’s core structural move is therefore a &lt;strong&gt;non-transition
annotation event class&lt;/strong&gt; (ADR Decision 1) that shares the same append-only log
and reducer but is &lt;em&gt;not&lt;/em&gt; a transition.&lt;/p&gt;
&lt;h2 id=&quot;2-target-architecture-per-evicted-field&quot;&gt;2. Target architecture per evicted field&lt;/h2&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;WP##.md&lt;/code&gt; becomes a read-derived view for the runtime parts; each field gets
exactly one new authority.&lt;/p&gt;

































































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Evicted field&lt;/th&gt;&lt;th&gt;New authority&lt;/th&gt;&lt;th&gt;Mechanism&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;shell_pid&lt;/code&gt; + baseline (&lt;strong&gt;initial claim&lt;/strong&gt;)&lt;/td&gt;&lt;td&gt;event log&lt;/td&gt;&lt;td&gt;rides the real &lt;code dir=&quot;auto&quot;&gt;planned→claimed&lt;/code&gt; transition via &lt;code dir=&quot;auto&quot;&gt;policy_metadata&lt;/code&gt; (no wire-schema change); typed in the reduced snapshot&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;shell_pid&lt;/code&gt; refresh (&lt;strong&gt;resume&lt;/strong&gt;)&lt;/td&gt;&lt;td&gt;event log&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;shell_refresh&lt;/code&gt; &lt;strong&gt;annotation event&lt;/strong&gt; (non-transition); reducer last-writer-wins&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;subtask &lt;code dir=&quot;auto&quot;&gt;done/total&lt;/code&gt;&lt;/td&gt;&lt;td&gt;event log&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;subtask_marked&lt;/code&gt; &lt;strong&gt;annotation event&lt;/strong&gt; (id, status); done-inference counts from the reduced snapshot, not the checkbox&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;activity_log&lt;/code&gt; narrative&lt;/td&gt;&lt;td&gt;event log&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;activity_note&lt;/code&gt; &lt;strong&gt;annotation event&lt;/strong&gt; with a free-text &lt;code dir=&quot;auto&quot;&gt;note&lt;/code&gt; payload (resolves M7 data-loss)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;history[]&lt;/code&gt; frontmatter mirror&lt;/td&gt;&lt;td&gt;event log&lt;/td&gt;&lt;td&gt;already DEAD (&lt;code dir=&quot;auto&quot;&gt;add_history_entry&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;frontmatter.py:347&lt;/code&gt;, no live callers) — confirm-removed; render &lt;code dir=&quot;auto&quot;&gt;## History&lt;/code&gt; from events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;review-cycle fields (&lt;code dir=&quot;auto&quot;&gt;review_status&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;reviewed_by&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;review_feedback&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;event log&lt;/td&gt;&lt;td&gt;already modelled as review events + &lt;code dir=&quot;auto&quot;&gt;review_ref&lt;/code&gt;; drop the frontmatter mirror and its fallback readers&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;agent&lt;/code&gt; (scalar), &lt;code dir=&quot;auto&quot;&gt;assignee&lt;/code&gt;&lt;/td&gt;&lt;td&gt;event log&lt;/td&gt;&lt;td&gt;carried on the claim/transition actor + reduced snapshot; frontmatter scalars retired&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;review_artifact_override_{at,actor,wp_id,reason}&lt;/code&gt;&lt;/td&gt;&lt;td&gt;event log&lt;/td&gt;&lt;td&gt;evict (annotation or review-event payload)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;base_branch&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;base_commit&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;created_at&lt;/code&gt;&lt;/td&gt;&lt;td&gt;event log&lt;/td&gt;&lt;td&gt;lane-genesis payload on the fresh-lane creation event (&lt;code dir=&quot;auto&quot;&gt;implement_support.py:133-142&lt;/code&gt;)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tracker_refs&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;UNRESOLVED — decide in mission&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;either author-immutable (move &lt;code dir=&quot;auto&quot;&gt;--tracker-ref&lt;/code&gt; write off the file) or evict; ship exactly one (ADR Decision 2 / scope §C3)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;progress&lt;/code&gt;&lt;/td&gt;&lt;td&gt;—&lt;/td&gt;&lt;td&gt;&lt;strong&gt;retire&lt;/strong&gt; (no live writer/reader)&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Static residue that &lt;strong&gt;stays&lt;/strong&gt; authored in &lt;code dir=&quot;auto&quot;&gt;WP##.md&lt;/code&gt; (no runtime writers
anywhere — scope §C3): &lt;code dir=&quot;auto&quot;&gt;work_package_id&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;title&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;dependencies&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;requirement_refs&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;plan_concern_refs&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;owned_files&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;create_intent&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;authoritative_surface&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;scope&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;task_type&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;cross_cutting&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;agent_profile&lt;/code&gt;
(authored assignment), &lt;code dir=&quot;auto&quot;&gt;branch_strategy&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;merge_target_branch&lt;/code&gt; /
&lt;code dir=&quot;auto&quot;&gt;planning_base_branch&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;priority&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;phase&lt;/code&gt;, and the prompt-body prose.&lt;/p&gt;
&lt;h2 id=&quot;3-event-schema-additions&quot;&gt;3. Event-schema additions&lt;/h2&gt;
&lt;p&gt;The additions are &lt;strong&gt;additive&lt;/strong&gt; and share the existing JSONL log + reducer.&lt;/p&gt;
&lt;h3 id=&quot;31-transition-carried-payload-initial-claim&quot;&gt;3.1 Transition-carried payload (initial claim)&lt;/h3&gt;
&lt;p&gt;No new event type. The &lt;code dir=&quot;auto&quot;&gt;planned→claimed&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;StatusEvent&lt;/code&gt; carries &lt;code dir=&quot;auto&quot;&gt;(shell_pid, baseline)&lt;/code&gt; in the existing generic &lt;code dir=&quot;auto&quot;&gt;policy_metadata: dict|None&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;models.py:234&lt;/code&gt;), already used as an event sidecar by &lt;code dir=&quot;auto&quot;&gt;implement_claim.py::_start_wp_implementation_status&lt;/code&gt; (via &lt;code dir=&quot;auto&quot;&gt;status.claim_policy_metadata&lt;/code&gt;, defined in &lt;code dir=&quot;auto&quot;&gt;status/emit.py&lt;/code&gt;). The
&lt;strong&gt;reduced snapshot&lt;/strong&gt; is where the pair becomes typed — frontmatter never sees
it.&lt;/p&gt;
&lt;h3 id=&quot;32-annotation-event-class-non-transition&quot;&gt;3.2 Annotation event class (non-transition)&lt;/h3&gt;
&lt;p&gt;A new record class in the same log, distinguished from transitions by the
&lt;strong&gt;absence of &lt;code dir=&quot;auto&quot;&gt;from_lane&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;to_lane&lt;/code&gt;&lt;/strong&gt; and the presence of &lt;code dir=&quot;auto&quot;&gt;annotation_kind&lt;/code&gt;:&lt;/p&gt;

































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Field&lt;/th&gt;&lt;th&gt;Notes&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;event_id&lt;/code&gt;&lt;/td&gt;&lt;td&gt;ULID; dedup key (&lt;code dir=&quot;auto&quot;&gt;reducer.py:139-149&lt;/code&gt;)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;wp_id&lt;/code&gt;&lt;/td&gt;&lt;td&gt;target WP&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;at&lt;/code&gt;&lt;/td&gt;&lt;td&gt;truthful timestamp (see §5 for reconstructed marks)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;actor&lt;/code&gt;&lt;/td&gt;&lt;td&gt;who annotated&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;annotation_kind&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;shell_refresh&lt;/code&gt; | &lt;code dir=&quot;auto&quot;&gt;subtask_marked&lt;/code&gt; | &lt;code dir=&quot;auto&quot;&gt;activity_note&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;payload&lt;/code&gt;&lt;/td&gt;&lt;td&gt;typed per kind: &lt;code dir=&quot;auto&quot;&gt;{pid, created_at}&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;{subtask_id, status}&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;{note}&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Annotation events &lt;strong&gt;bypass &lt;code dir=&quot;auto&quot;&gt;validate_transition&lt;/code&gt;&lt;/strong&gt; (they are not transitions;
ADR Decision 5) and are folded by the reducer as payload updates. The 9-lane FSM
and its 27 transition pairs are unchanged.&lt;/p&gt;
&lt;h3 id=&quot;33-reducer-fold--precedence&quot;&gt;3.3 Reducer fold + precedence&lt;/h3&gt;
&lt;p&gt;Fold in event order (&lt;code dir=&quot;auto&quot;&gt;reducer.py:160&lt;/code&gt; precedence extended, not rewritten):&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Transition events set the lane and any transition-carried payload (e.g. the
claim’s &lt;code dir=&quot;auto&quot;&gt;shell_pid&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;Annotation events fold their typed payload onto the reduced snapshot
&lt;strong&gt;after&lt;/strong&gt; transitions, &lt;strong&gt;last-writer-wins per field&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;At equal timestamps, the annotation fold applies after the transition fold —
so a later &lt;code dir=&quot;auto&quot;&gt;shell_refresh&lt;/code&gt; deterministically supersedes the claim’s initial
&lt;code dir=&quot;auto&quot;&gt;shell_pid&lt;/code&gt;, and an out-of-order read cannot clobber it.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;The reduced snapshot gains typed slots: &lt;code dir=&quot;auto&quot;&gt;shell_pid&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;shell_pid_created_at&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;baseline&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;subtask_state: {id -&gt; status}&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;notes: [str]&lt;/code&gt;, plus the existing
review/lane fields. These slots are the &lt;strong&gt;sole&lt;/strong&gt; read authority after cutover.&lt;/p&gt;
&lt;h2 id=&quot;4-reader-repoint-list-incl-legacy-fallback-deletions--scope-c5&quot;&gt;4. Reader-repoint list (incl. legacy-fallback deletions — scope §C5)&lt;/h2&gt;
&lt;p&gt;Eviction means &lt;strong&gt;remove, not merely stop writing&lt;/strong&gt; (ADR Decision 4;
&lt;a href=&quot;/adr/3.x/2026-07-01-1-no-legacy-compat-branches-in-resolvers/&quot;&gt;ADR 2026-07-01-1&lt;/a&gt;).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Repoint to the reduced snapshot:&lt;/strong&gt;&lt;/p&gt;






























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Reader&lt;/th&gt;&lt;th&gt;Today&lt;/th&gt;&lt;th&gt;After&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;claim-liveness&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;stale_detection.py:403&lt;/code&gt; reads frontmatter &lt;code dir=&quot;auto&quot;&gt;shell_pid&lt;/code&gt;&lt;/td&gt;&lt;td&gt;reads snapshot &lt;code dir=&quot;auto&quot;&gt;shell_pid&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;done-inference&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;subtask_rows.py:181&lt;/code&gt; → &lt;code dir=&quot;auto&quot;&gt;emit.py:302&lt;/code&gt; counts body checkboxes (&lt;code dir=&quot;auto&quot;&gt;done==total&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;counts snapshot &lt;code dir=&quot;auto&quot;&gt;subtask_state&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;model properties&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;WorkPackage.{shell_pid,agent,assignee}&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;task_utils/support.py:288,292,296&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;snapshot-backed&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;metadata coercion&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;WPMetadata&lt;/code&gt; coercion (&lt;code dir=&quot;auto&quot;&gt;wp_metadata.py:364,580&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;snapshot-backed&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;Delete outright (dormant no-canonical-field fallbacks):&lt;/strong&gt;&lt;/p&gt;




















&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Fallback&lt;/th&gt;&lt;th&gt;Location&lt;/th&gt;&lt;th&gt;Reads&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;review-status frontmatter fallback&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;workflow_cores.py:340-341&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;review_status&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;review_feedback&lt;/code&gt; when canonical &lt;code dir=&quot;auto&quot;&gt;review_ref&lt;/code&gt; absent&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;reviewed-by frontmatter fallback&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;done_bookkeeping.py:104-105&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;meta.reviewed_by&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;review_status&lt;/code&gt; off &lt;code dir=&quot;auto&quot;&gt;WPMetadata&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;Leaving either = a dormant no-canonical-field resolver path (violates the
&lt;em&gt;no legacy resolver paths&lt;/em&gt; invariant). They are deleted in the same slice that
cuts the writers.&lt;/p&gt;
&lt;h2 id=&quot;5-migration-sequence-adr-decision-3--scope-c6&quot;&gt;5. Migration sequence (ADR Decision 3 — scope §C6)&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Strict order — writer-first is prohibited (it opens the B3 clobber window):&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;backfill  →  verify  →  reader cutover  →  writer cutover&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;                        &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;(fallback kept until verify passes)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Backfill&lt;/strong&gt; — extend &lt;code dir=&quot;auto&quot;&gt;migration/strip_frontmatter.py:MUTABLE_FIELDS&lt;/code&gt; (the
single canonical field-set) with &lt;code dir=&quot;auto&quot;&gt;history&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;shell_pid_created_at&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;activity_log&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;review_artifact_override_*&lt;/code&gt;, resolved &lt;code dir=&quot;auto&quot;&gt;tracker_refs&lt;/code&gt;. For
each WP, emit seed transition + annotation events reconstructing today’s
frontmatter/checkbox state.
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Deterministic ULID seed-ids&lt;/strong&gt; — &lt;code dir=&quot;auto&quot;&gt;event_id&lt;/code&gt; must match &lt;code dir=&quot;auto&quot;&gt;ULID_PATTERN&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;models.py:70&lt;/code&gt;); a content hash is not a valid ULID. Use a namespaced
deterministic ULID from &lt;code dir=&quot;auto&quot;&gt;mission_id + wp_id + field&lt;/code&gt;, so re-runs are
idempotent (the reducer dedups by &lt;code dir=&quot;auto&quot;&gt;event_id&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Timestamp honesty&lt;/strong&gt; — subtask checkboxes carry no &lt;code dir=&quot;auto&quot;&gt;at&lt;/code&gt;. A reconstructed
&lt;code dir=&quot;auto&quot;&gt;subtask_marked&lt;/code&gt; has no truthful timestamp; the reconstruction contract
&lt;strong&gt;clamps to the WP’s &lt;code dir=&quot;auto&quot;&gt;claimed&lt;/code&gt; timestamp&lt;/strong&gt; rather than fabricating
precision. “No data loss” is stated against this contract, not as literal
millisecond fidelity.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Verify&lt;/strong&gt; — read back persisted events; confirm the reduced snapshot equals
the pre-migration frontmatter/checkbox state (count + value parity).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Reader cutover&lt;/strong&gt; — repoint §4 readers to the snapshot; keep the frontmatter
fallback &lt;strong&gt;behind a flag&lt;/strong&gt; until verify passes for the corpus.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Writer cutover&lt;/strong&gt; — cut every §2 / scope §C2 writer off the file, incl.
&lt;code dir=&quot;auto&quot;&gt;move-task&lt;/code&gt; and the external &lt;code dir=&quot;auto&quot;&gt;orchestrator_api&lt;/code&gt;. &lt;strong&gt;Co-sequence with #2160&lt;/strong&gt;
(its Wave-2 &lt;code dir=&quot;auto&quot;&gt;implement.py&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;workflow.py&lt;/code&gt; degod owns the same &lt;code dir=&quot;auto&quot;&gt;shell_pid&lt;/code&gt;
writers — add a &lt;code dir=&quot;auto&quot;&gt;blocks&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;blocked_by&lt;/code&gt; edge; do not race it).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Delete fallbacks&lt;/strong&gt; (§4) + land the stable-hash guard.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;6-invariants--acceptance-criteria&quot;&gt;6. Invariants &amp;#x26; acceptance criteria&lt;/h2&gt;









































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Invariant&lt;/th&gt;&lt;th&gt;Guard (AC)&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;WP##.md&lt;/code&gt; is never written by runtime&lt;/td&gt;&lt;td&gt;&lt;strong&gt;AC-1&lt;/strong&gt; — snapshot mtime+bytes unchanged across a full WP lifecycle; &lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;move-task&lt;/code&gt; is an explicit target&lt;/strong&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Claim-liveness from snapshot, not frontmatter&lt;/td&gt;&lt;td&gt;&lt;strong&gt;AC-2&lt;/strong&gt; — a claimed WP with empty frontmatter is correctly detected live&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Done-inference from annotation events&lt;/td&gt;&lt;td&gt;&lt;strong&gt;AC-3&lt;/strong&gt; — &lt;code dir=&quot;auto&quot;&gt;done==total&lt;/code&gt; resolves from &lt;code dir=&quot;auto&quot;&gt;subtask_marked&lt;/code&gt;; lane transitions gate identically&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;No narrative data loss&lt;/td&gt;&lt;td&gt;&lt;strong&gt;AC-4&lt;/strong&gt; — &lt;code dir=&quot;auto&quot;&gt;## Activity Log&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;## History&lt;/code&gt; / review render from events, no content loss (resolves M7)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Stable content hash&lt;/td&gt;&lt;td&gt;&lt;strong&gt;AC-5&lt;/strong&gt; — a full lifecycle produces an invariant hash over the authored spec (churn fix; wired once, no mixed pool)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Idempotent, honest migration&lt;/td&gt;&lt;td&gt;&lt;strong&gt;AC-6&lt;/strong&gt; — deterministic ULID seed-ids; reconstruction contract stated; no unrecoverable loss&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;9-lane FSM unchanged&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;self-transition edges never legal; &lt;code dir=&quot;auto&quot;&gt;validate_transition&lt;/code&gt; still rejects non-lane-changing edges; annotations live outside the matrix&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;Single canonical field-set&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;only &lt;code dir=&quot;auto&quot;&gt;strip_frontmatter.py:MUTABLE_FIELDS&lt;/code&gt; enumerates runtime-mutable fields; no rival list&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;7-explicitly-out-of-scope-later-missions&quot;&gt;7. Explicitly out of scope (later missions)&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;The YAML-authoritative / markdown-derived WP-prompt flip (proposal Parts 1–3)
— this eviction is its &lt;em&gt;prerequisite&lt;/em&gt;, not its delivery.&lt;/li&gt;
&lt;li&gt;Electing the canonical static model (&lt;code dir=&quot;auto&quot;&gt;WorkPackageEntry&lt;/code&gt; vs enrich &lt;code dir=&quot;auto&quot;&gt;WPMetadata&lt;/code&gt;)
— deferred to the schema mission (grounding prefers enriching &lt;code dir=&quot;auto&quot;&gt;WPMetadata&lt;/code&gt;;
proposal B4).&lt;/li&gt;
&lt;li&gt;The semantic-only content-hash slice — shrinks to a small follow-up once
nothing writes runtime state (even the raw-byte hash is then stable); still
co-moves &lt;code dir=&quot;auto&quot;&gt;sync/body_upload.py&lt;/code&gt; TOCTOU with no mixed parity pool (scope §C7).&lt;/li&gt;
&lt;li&gt;The Op-debrief slice (proposal Part 4) — independent, landable now.&lt;/li&gt;
&lt;li&gt;The final WP/Mission aggregate authority election — gated on #1619 / #1666.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;see-also&quot;&gt;See also&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/adr/3.x/2026-07-16-1-wp-runtime-state-authority-event-log-eviction/&quot;&gt;ADR 2026-07-16-1 — WP runtime-state authority&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/status-model/&quot;&gt;Status Model&lt;/a&gt; — the append-only event log this design extends&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/architecture/execution-lanes/&quot;&gt;Execution Lanes&lt;/a&gt;, &lt;a href=&quot;/architecture/runtime-loop/&quot;&gt;Runtime Loop&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
