<?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-10-22-1-the-java-write-service-is-the-canonical-event-writer/">
  <id>https://docs.spec-kitty.ai/adr/4.x/2026-10-22-1-the-java-write-service-is-the-canonical-event-writer/</id>
  <title>ADR: the Java write service is the canonical event writer, one resident service per repository</title>
  <updated>2026-10-29T00: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-10-22-1-the-java-write-service-is-the-canonical-event-writer/"/>
  <summary>The command side of the Mission Write API is the one event writer: one resident Java service per repository behind the CLI EventBridge port, a JVM fallback, no Python writer.</summary>
  <content type="html">&lt;h2 id=&quot;the-java-write-service-is-the-canonical-event-writer-one-resident-service-per-repository&quot;&gt;The Java write service is the canonical event writer, one resident service per repository&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Status:&lt;/strong&gt; Accepted (2026-10-22). Operator rulings of 2026-10-22, recorded on #6117, #6185 and #6608. Amended by &lt;a href=&quot;/adr/4.x/2026-10-27-1-the-write-service-protocol-is-loopback-http-with-a-bearer-token/&quot;&gt;ADR 2026-10-27-1&lt;/a&gt; (open question 3, D-3, D-7); see Amendment 2026-10-27. Amended by &lt;a href=&quot;/adr/4.x/2026-10-29-1-the-events-domain-and-its-java-services-live-in-spec-kitty-events/&quot;&gt;ADR 2026-10-29-1&lt;/a&gt; (the events services live in spec-kitty-events); see Amendment 2026-10-29.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;What was ruled and what is derived.&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Ruled by the operator:&lt;/strong&gt; the event writer is a Java service that reuses the read API’s domain models; one service per repository; the CLI decides when and what, the service how and where; a JVM jar fallback for a missing native binary; #6185 folds into #6117’s modules.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Derived:&lt;/strong&gt; every clause marked &lt;em&gt;(derived)&lt;/em&gt; follows from those rulings together with the charter’s single-canonical-authority principle and ADR 2026-10-14-1. Each one comes from the research recommendation on #6608.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Open:&lt;/strong&gt; the open questions at the end carry defaults that hold until the operator rules otherwise.&lt;/li&gt;
&lt;/ul&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;strong&gt;Date:&lt;/strong&gt; 2026-10-22&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;Technical Story:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Epic #6608 (event-native core) and its child epic #6117 (Mission Write API).&lt;/li&gt;
&lt;li&gt;#6185 (the native producer, folded into #6117’s modules).&lt;/li&gt;
&lt;li&gt;The research recommendation on #6608 (2026-10-22).&lt;/li&gt;
&lt;li&gt;The current-state map &lt;a href=&quot;/architecture/event-ledger-writers-and-readers/&quot;&gt;event ledger writers and readers&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;It amends &lt;a href=&quot;/adr/4.x/2026-10-14-1-event-native-core-one-canonical-event-writer/&quot;&gt;ADR 2026-10-14-1&lt;/a&gt; (D-1, D-2, D-5 and the Confirmation) and &lt;a href=&quot;/adr/4.x/2026-10-03-1-charter-read-write-service-strangler/&quot;&gt;ADR 2026-10-03-1&lt;/a&gt; (its “event system” rationale).&lt;/li&gt;
&lt;li&gt;It keeps &lt;a href=&quot;/adr/4.x/2026-10-13-2-the-event-ledger-is-the-publication-seam-default-on-with-local-retention/&quot;&gt;ADR 2026-10-13-2&lt;/a&gt; D-2 and D-3 (the committed ledger is the publication seam; retention) and &lt;a href=&quot;/adr/4.x/2026-10-01-2-mission-status-read-api-and-dashboard-extraction/&quot;&gt;ADR 2026-10-01-2&lt;/a&gt; (the read API, read only) unchanged.&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/adr/2.x/2026-02-09-3-event-log-merge-semantics/&quot;&gt;ADR 2026-02-09-3&lt;/a&gt; is amended the same day by a separate ruling: the ordering is wall clock for 4.0.0, the merge rules are kept, and Lamport-primary ordering is a post-GA direction (#6609). This record does not change the ordering.&lt;/li&gt;
&lt;li&gt;It supersedes three parts of #6117:
&lt;ul&gt;
&lt;li&gt;decision 4’s recommendation of a per-command native binary;&lt;/li&gt;
&lt;li&gt;the per-command description of &lt;code dir=&quot;auto&quot;&gt;command-cli&lt;/code&gt; in decision 12. The module names stand, and &lt;code dir=&quot;auto&quot;&gt;command-cli&lt;/code&gt; becomes the service deployable;&lt;/li&gt;
&lt;li&gt;intended effect 6, “a write needs no running service”.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Reader:&lt;/strong&gt; a maintainer building the write side of the event ledger, or changing how the CLI records a work package transition or a Mission state change.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;context-and-problem-statement&quot;&gt;Context and Problem Statement&lt;/h2&gt;
&lt;p&gt;ADR 2026-10-14-1 decided that core has &lt;strong&gt;one&lt;/strong&gt; canonical event writer, the EventBridge, behind a domain port, and placed it as an adapter inside &lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt;. Nothing implements it yet:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;About fifteen append implementations in more than twelve modules write at least six row shapes.&lt;/li&gt;
&lt;li&gt;Only glossary writes through &lt;code dir=&quot;auto&quot;&gt;spec_kitty_events.persistence.append_event&lt;/code&gt; (see the current-state map).&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Two Java efforts exist on the tracker beside it:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;#6117 (Mission Write API).&lt;/strong&gt; It designs “one Java write core … the command side of a CQRS split; the read API is the query side”. Decision 12 (ruled 2026-10-13) settles its modules: &lt;code dir=&quot;auto&quot;&gt;domain-model&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;event-log&lt;/code&gt; shared, with &lt;code dir=&quot;auto&quot;&gt;query-service&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;command-cli&lt;/code&gt; as the deployables. It ships as a native binary run once per command.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;#6185.&lt;/strong&gt; A standalone native producer (&lt;code dir=&quot;auto&quot;&gt;services/event-producer&lt;/code&gt;), which warns and continues when the binary is missing.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The operator ruled on 2026-10-22, verbatim:&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“having a write service as a Java-based service is the way to go, as it enables many alternate deployment configurations, and makes it easier to reuse the same logical DSO models as the read api uses. If we ever decide to move from a local, file-based ledger to a database / hosted-first solution, the java-service architecture makes more sense.”&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;“Why does it need to be a per-worktree service daemon? Would that not defeat any and all benefits of a backend service? If we can run a GraalVM backend per repository, which writes to the required ledger location / worktrees / filesystem paths, that would make the CLI feel smoorther [sic] and snappier, as well as make ownership even clearer -&gt; CLI controls when to send what. Service controls HOW and WHERE to store it, based on the request context.”&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Further rulings the same day:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;A missing native binary falls back to a &lt;strong&gt;JVM jar&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;#6185 &lt;strong&gt;folds into #6117’s modules&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;#6117 becomes a &lt;strong&gt;child of #6608&lt;/strong&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;What the merged read service offers a write side (the #6608 recommendation):&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Reusable:&lt;/strong&gt; an architecture and a current-state model: &lt;code dir=&quot;auto&quot;&gt;Lane&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;WpState&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;StatusSnapshot&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;StatusReducer&lt;/code&gt;, the hexagonal layout, and a directional ArchUnit rule (query never depends on command).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Missing:&lt;/strong&gt; a write domain.
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;StatusEvent&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;Actor&lt;/code&gt; are lossy read projections.&lt;/li&gt;
&lt;li&gt;There is no encoder that reproduces Python’s &lt;code dir=&quot;auto&quot;&gt;json.dumps(sort_keys=True)&lt;/code&gt; bytes.&lt;/li&gt;
&lt;li&gt;The lane state machine and its guards (&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/status/wp_state.py&lt;/code&gt;) are not ported.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Blockers before any Java writer shares a file with the CLI:&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;Core locks with &lt;code dir=&quot;auto&quot;&gt;fcntl.flock&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;src/kernel/locks.py:222&lt;/code&gt;), which on Linux does not exclude Java’s &lt;code dir=&quot;auto&quot;&gt;fcntl&lt;/code&gt; record locks.&lt;/li&gt;
&lt;li&gt;No &lt;code dir=&quot;auto&quot;&gt;spec-kitty-events&lt;/code&gt; fixture covers a lane-transition row.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;decision-drivers&quot;&gt;Decision Drivers&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Single canonical authority&lt;/strong&gt; (charter): one writer, one implementation of the row format, the lock and the fold.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;No lost history:&lt;/strong&gt; the status log is the sole authority for lane state, and consolidation reads it, so a write either lands or fails loudly.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Reuse:&lt;/strong&gt; the write side shares the read side’s domain models instead of keeping a second set.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Deployment freedom:&lt;/strong&gt; the same use cases can be deployed in more than one configuration, with storage behind a port.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A snappy CLI:&lt;/strong&gt; no process start or JVM warm-up on every transition.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Clear ownership:&lt;/strong&gt; the CLI decides when and what; the service decides how and where.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;considered-options&quot;&gt;Considered Options&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Python in-process EventBridge&lt;/strong&gt; (ADR 2026-10-14-1 as written).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A native binary run once per command&lt;/strong&gt; (#6117 as originally designed).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A resident daemon per worktree&lt;/strong&gt; (the charter service precedent, ADR 2026-10-03-1).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;A resident Java write service per repository, behind the CLI’s EventBridge port&lt;/strong&gt; (chosen).&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;decision-outcome&quot;&gt;Decision Outcome&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Chosen option:&lt;/strong&gt; “A resident Java write service per repository, behind the CLI’s EventBridge port”. It is the only option that:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;gives one writer and one implementation;&lt;/li&gt;
&lt;li&gt;reuses the read side’s models;&lt;/li&gt;
&lt;li&gt;keeps storage swappable;&lt;/li&gt;
&lt;li&gt;avoids a start per transition.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;All lane worktrees of a repository then share one writer.&lt;/p&gt;
&lt;h3 id=&quot;d-1-the-canonical-event-writer-is-the-java-write-service&quot;&gt;D-1: the canonical event writer is the Java write service&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;The command side of the Mission Write API (#6117) is the one module that persists events. Every event log ADR 2026-10-14-1’s Confirmation names is written only by its &lt;code dir=&quot;auto&quot;&gt;event-log&lt;/code&gt; module:
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;status.events.jsonl&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;canonical-events.jsonl&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;run.events.jsonl&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;decisions.events.jsonl&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;mission-events.jsonl&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;kitty-ops/*.jsonl&lt;/code&gt; and the glossary logs.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;The modules are #6117 decision 12’s four: &lt;code dir=&quot;auto&quot;&gt;domain-model&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;event-log&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;query-service&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;command-cli&lt;/code&gt;. &lt;code dir=&quot;auto&quot;&gt;command-cli&lt;/code&gt; is now the write-service deployable (D-2). There is no second Java write build: #6185’s producer folds into these modules, landing in #6193.&lt;/li&gt;
&lt;li&gt;Python keeps no in-process append once a file has moved.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;d-2-one-resident-service-per-repository&quot;&gt;D-2: one resident service per repository&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Unit.&lt;/strong&gt; One write service per repository. Reading “per repository” as “keyed on the git common dir” is &lt;em&gt;(derived)&lt;/em&gt;. Under that reading:
&lt;ul&gt;
&lt;li&gt;every lane worktree, the coordination worktree and the repository root checkout of that repository talk to the same service;&lt;/li&gt;
&lt;li&gt;the service is keyed where core already keeps its write locks (&lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;git-common-dir&gt;/spec-kitty-locks/&lt;/code&gt;).&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Launch.&lt;/strong&gt; The CLI starts it when it is down and reuses it while it runs: the launch-when-down choice of ADR 2026-10-03-1 &lt;em&gt;(derived)&lt;/em&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Reach.&lt;/strong&gt; It is local only and serves write operations only. The transport, token and identity check are open question 3.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Not per worktree.&lt;/strong&gt; A per-worktree daemon would split one repository’s writes across processes and bring back cross-process locking. A per-command binary pays a start on every transition.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;d-3-the-cli-decides-when-and-what-the-service-decides-how-and-where&quot;&gt;D-3: the CLI decides when and what; the service decides how and where&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;The CLI&lt;/strong&gt; owns the domain decision. The run loop and the transition shells call the Python &lt;strong&gt;EventBridge port&lt;/strong&gt;. The port of ADR 2026-10-14-1 D-2 is kept (grown from &lt;code dir=&quot;auto&quot;&gt;RuntimeEventEmitter&lt;/code&gt;); only its adapter changes (amended). The port’s adapter in &lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt; sends a &lt;strong&gt;command&lt;/strong&gt; with its request context: Mission identity, work package, intended transition, actor, evidence, and the caller’s checkout.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The service&lt;/strong&gt; owns how and where:
&lt;ul&gt;
&lt;li&gt;It validates the command against the lane state machine and guards (open question 1).&lt;/li&gt;
&lt;li&gt;It resolves the write location: which partition, worktree and branch.&lt;/li&gt;
&lt;li&gt;It stamps git-derived evidence (&lt;code dir=&quot;auto&quot;&gt;policy_metadata.lane_head&lt;/code&gt;), appends and commits.&lt;/li&gt;
&lt;li&gt;It returns the persisted event or a named refusal.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Write location during the strangler.&lt;/strong&gt; Resolving the location is today the Python placement seam (&lt;code dir=&quot;auto&quot;&gt;mission_runtime&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;PlacementSeam.write_dir&lt;/code&gt;). Until that rule set is ported, the CLI sends the resolved write location in the request context and the service verifies it. Then the resolution moves into the service (open question 2).&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;d-4-git-and-synchronous-consumers-run-inside-the-services-unit-of-work-derived&quot;&gt;D-4: git and synchronous consumers run inside the service’s unit of work &lt;em&gt;(derived)&lt;/em&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;One unit of work.&lt;/strong&gt; The append, the status commit (where the topology commits status) and the cut-on-failure happen in one unit of work inside the service. The &lt;code dir=&quot;auto&quot;&gt;lane_head&lt;/code&gt; probe moves into the service’s &lt;code dir=&quot;auto&quot;&gt;GitPort&lt;/code&gt;. This replaces &lt;code dir=&quot;auto&quot;&gt;BookkeepingTransaction&lt;/code&gt;’s in-process &lt;code dir=&quot;auto&quot;&gt;safe_commit&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;_cut_event_log&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;coordination/transaction.py&lt;/code&gt;). ADR 2026-10-14-1 D-5’s synchronous consumers move here.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Asynchronous consumers&lt;/strong&gt; stay where they are: the produce seam &lt;code dir=&quot;auto&quot;&gt;status/adapters.py&lt;/code&gt;, derived projections and the read API by cursor. They run after the service returns, or read the committed ledger by cursor.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Exclusion.&lt;/strong&gt; The service serializes writes to one repository in process. While Python writers still exist, it also takes the same OS lock files with &lt;code dir=&quot;auto&quot;&gt;flock(2)&lt;/code&gt; semantics (through FFM), not with &lt;code dir=&quot;auto&quot;&gt;FileChannel.lock&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Handover.&lt;/strong&gt; Ownership of a log file is handed over &lt;strong&gt;whole&lt;/strong&gt;, one file at a time. No file has a Python writer and a Java writer in the same release. The #6193 lock-interop spike is the go/no-go for the first handover.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;d-5-native-first-jvm-jar-as-fallback-and-no-python-writer&quot;&gt;D-5: native first, JVM jar as fallback, and no Python writer&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Fallback order&lt;/strong&gt; (ruled: the JVM jar fallback).
&lt;ol&gt;
&lt;li&gt;The service runs from a native image where one ships for the platform. No native image exists yet: #6185 self-reports native feasibility on Linux x86_64, macOS arm64 and Windows x86_64, and the support matrix is set at release.&lt;/li&gt;
&lt;li&gt;Otherwise it runs the same build as a JVM jar on a local JDK.&lt;/li&gt;
&lt;li&gt;&lt;em&gt;(derived)&lt;/em&gt; With neither available, every write refuses with a named error code and a remedy, and nothing is written. Read-only commands keep working.&lt;/li&gt;
&lt;/ol&gt;
&lt;/li&gt;
&lt;li&gt;&lt;em&gt;(derived)&lt;/em&gt; &lt;strong&gt;No Python fallback writer.&lt;/strong&gt; A fallback writer would be a second implementation of the format, lock and fold (charter: single canonical authority; ADR 2026-10-14-1 D-1). #6185’s warn-and-continue &lt;code dir=&quot;auto&quot;&gt;binary-missing&lt;/code&gt; behaviour is rejected, because it silently drops rows from the log that is the sole authority for lane state.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;d-6-storage-is-a-port-only-the-file-adapter-ships-derived-from-the-ruled-alternate-deployments&quot;&gt;D-6: storage is a port; only the file adapter ships &lt;em&gt;(derived from the ruled alternate deployments)&lt;/em&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;EventLogPort&lt;/code&gt; is a storage abstraction from the first Java write, and the only adapter that ships is the local file ledger.&lt;/li&gt;
&lt;li&gt;A database or hosted adapter is &lt;strong&gt;not&lt;/strong&gt; a drop-in replacement under the current decisions:
&lt;ul&gt;
&lt;li&gt;the git-committed ledger is the publication seam (ADR 2026-10-13-2 D-2);&lt;/li&gt;
&lt;li&gt;the read API pulls the committed ledger (ADR 2026-10-01-2 D-6);&lt;/li&gt;
&lt;li&gt;merge semantics are file based (ADR 2026-02-09-3);&lt;/li&gt;
&lt;li&gt;the consolidation gates rely on git ancestry and on &lt;code dir=&quot;auto&quot;&gt;lane_head&lt;/code&gt; stamps.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;Each of those needs its own ADR before such an adapter is built.&lt;/li&gt;
&lt;li&gt;This decision adds no hosted surface to open-core (#6164 stands).&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;d-7-byte-exact-contract-for-every-row-the-service-writes-derived&quot;&gt;D-7: byte-exact contract for every row the service writes &lt;em&gt;(derived)&lt;/em&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Encoder.&lt;/strong&gt; The service encodes rows to the bytes the CLI writes today. That means &lt;code dir=&quot;auto&quot;&gt;store.serialize_event_line&lt;/code&gt;’s &lt;code dir=&quot;auto&quot;&gt;json.dumps(sanitize_event_for_log(row), sort_keys=True)&lt;/code&gt; for status rows, and the &lt;code dir=&quot;auto&quot;&gt;persistence.append_event&lt;/code&gt; bytes for contract rows.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Fixtures.&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;spec-kitty-events&lt;/code&gt; gains a &lt;code dir=&quot;auto&quot;&gt;status_append&lt;/code&gt; fixture family, generated from core’s writer, beside &lt;code dir=&quot;auto&quot;&gt;ledger_append&lt;/code&gt;. Both gate the Java writer byte for byte, through the Java binding of events#92.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Append semantics.&lt;/strong&gt; Which semantics are authoritative is settled in the same step: core’s temp-file-and-replace, or the contract’s single &lt;code dir=&quot;auto&quot;&gt;O_APPEND&lt;/code&gt; write.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;d-8-the-read-service-stays-read-only-and-separate-derived&quot;&gt;D-8: the read service stays read-only and separate &lt;em&gt;(derived)&lt;/em&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;query-service&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;services/mission-status-api/&lt;/code&gt;) keeps its guarantees: loopback-only, never writes, takes no lock, starts no process.&lt;/li&gt;
&lt;li&gt;The write service is its own deployable, sharing &lt;code dir=&quot;auto&quot;&gt;domain-model&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;The read API stays conformance-gated against the Python reducer. #6268 (porting the #4941 approved-departure lift to the Java &lt;code dir=&quot;auto&quot;&gt;StatusReducer&lt;/code&gt;) lands before the shared domain model is used to validate writes.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;consequences&quot;&gt;Consequences&lt;/h3&gt;
&lt;h4 id=&quot;positive&quot;&gt;Positive&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;One writer and one implementation for every event log, across the CLI and any future deployment.&lt;/li&gt;
&lt;li&gt;The read and write sides share one domain model.&lt;/li&gt;
&lt;li&gt;A transition costs a local request to a warm service, not a process start.&lt;/li&gt;
&lt;li&gt;Ownership is explicit: the domain decides, the service persists.&lt;/li&gt;
&lt;li&gt;Storage can change behind one port without touching the CLI.&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;negative&quot;&gt;Negative&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;A JVM toolchain, a native-image platform matrix, a JVM fallback and a port of the git policy sit on the event-writing critical path.&lt;/li&gt;
&lt;li&gt;The CLI’s write path depends on a local service’s lifecycle: launch, identity, token and crash recovery. Its launcher needs the same security review ADR 2026-10-03-1 requires for the charter service.&lt;/li&gt;
&lt;li&gt;“One canonical writer” now spans two languages, so it needs two gates.&lt;/li&gt;
&lt;li&gt;The lane state machine and guards must move, or be kept in parity, across languages.&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;neutral&quot;&gt;Neutral&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;ADR 2026-10-14-1’s D-3, D-3a and D-4 are unchanged. The writer still writes only &lt;code dir=&quot;auto&quot;&gt;spec-kitty-events&lt;/code&gt; contract events, every event carries both version markers, and the internal lifecycle events are retired.&lt;/li&gt;
&lt;li&gt;The read API is unchanged.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;confirmation&quot;&gt;Confirmation&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Python side:&lt;/strong&gt; the multi-file writes gate (#6603) shows no module appends to any event log once that file has moved, with an empty allowlist at the end of the migration.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Java side:&lt;/strong&gt; an ArchUnit rule shows only the &lt;code dir=&quot;auto&quot;&gt;event-log&lt;/code&gt; module opens a ledger for writing.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Bytes:&lt;/strong&gt; the &lt;code dir=&quot;auto&quot;&gt;ledger_append&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;status_append&lt;/code&gt; fixtures pass byte for byte against the Java writer.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;One service per repository:&lt;/strong&gt; two worktrees of one repository reach the same service; a second repository gets its own.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Fail closed:&lt;/strong&gt; with no native image and no JDK, a write refuses with the named code and the log is byte-identical.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Consolidation:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;tests/consolidation/&lt;/code&gt; passes unchanged over logs that mix rows from both writers, at each cut-over step.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;migration-order-each-step-gated-on-the-previous-derived-a-default-the-operator-may-resequence&quot;&gt;Migration order (each step gated on the previous) &lt;em&gt;(derived; a default the operator may resequence)&lt;/em&gt;&lt;/h3&gt;
&lt;ol start=&quot;0&quot;&gt;
&lt;li&gt;&lt;strong&gt;Python EventBridge port&lt;/strong&gt; behind the two existing doors (&lt;code dir=&quot;auto&quot;&gt;status/emit.py&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;_persist_prepared&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;coordination/transaction.py&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;BookkeepingTransaction.append_events&lt;/code&gt;), plus the multi-file writes gate. No behaviour change (#6603).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Extract&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;domain-model&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;event-log&lt;/code&gt; (#6192).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Java binding&lt;/strong&gt; plus the &lt;code dir=&quot;auto&quot;&gt;status_append&lt;/code&gt; fixture family (events#92).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Lock-interop spike&lt;/strong&gt; (go/no-go), then the service writes &lt;strong&gt;one file owned whole&lt;/strong&gt;. The glossary logs are the candidate, since they already use the contract writer (#6193).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The service takes &lt;code dir=&quot;auto&quot;&gt;status.events.jsonl&lt;/code&gt;&lt;/strong&gt;: every row family in one cut, commit and cut inside the service, and the Python appenders deleted in the same release.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;The remaining logs:&lt;/strong&gt; run journal, decisions, Op records and lifecycle (ADR 2026-10-14-1 D-4). Then the &lt;code dir=&quot;auto&quot;&gt;accept&lt;/code&gt; writes, then the consolidation bookkeeping writes.&lt;/li&gt;
&lt;/ol&gt;
&lt;h3 id=&quot;open-questions-each-with-a-default&quot;&gt;Open questions (each with a default)&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Who validates a transition?&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Default:&lt;/strong&gt; the service is authoritative and runs the ported lane state machine and guards, with a parity corpus against &lt;code dir=&quot;auto&quot;&gt;status/wp_state.py&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;The CLI may pre-check only for messages.&lt;/li&gt;
&lt;li&gt;Until the port lands, the service accepts a transition &lt;code dir=&quot;auto&quot;&gt;prepare_transition&lt;/code&gt; has validated and re-checks only &lt;code dir=&quot;auto&quot;&gt;from_lane&lt;/code&gt; continuity against its reducer.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;When does write-location resolution move into the service?&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Default:&lt;/strong&gt; at step 4.&lt;/li&gt;
&lt;li&gt;Before then, the request carries the resolved write location and the service verifies it.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Transport and trust model.&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Default:&lt;/strong&gt; a local socket (a named pipe on Windows) rather than TCP.&lt;/li&gt;
&lt;li&gt;A per-repository token in the git common dir, readable only by the user.&lt;/li&gt;
&lt;li&gt;An identity check before each session, and write operations only.&lt;/li&gt;
&lt;li&gt;A security note precedes step 3.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Idle shutdown.&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Default:&lt;/strong&gt; the service exits after a period with no requests, and the CLI relaunches it on demand.&lt;/li&gt;
&lt;li&gt;A crashed service is detected by the identity check and relaunched. A write is acknowledged only after it is durable: after its commit where the topology commits status, and after the fsynced append where it does not (the flat shell, &lt;code dir=&quot;auto&quot;&gt;status/emit.py&lt;/code&gt;).&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Several clones of one repository.&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Default:&lt;/strong&gt; one service per git common dir, so separate clones get separate services.&lt;/li&gt;
&lt;li&gt;Worktrees of one clone share one.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;amendment-2026-10-27-accepted-loopback-http-transport-rows-during-the-strangler-one-synced-o_append-write&quot;&gt;Amendment 2026-10-27 (Accepted): loopback HTTP transport, rows during the strangler, one synced O_APPEND write&lt;/h2&gt;
&lt;p&gt;&lt;a href=&quot;/adr/4.x/2026-10-27-1-the-write-service-protocol-is-loopback-http-with-a-bearer-token/&quot;&gt;ADR 2026-10-27-1&lt;/a&gt; settles points this record left open, by operator ruling of 2026-10-25 (#6675) and as derived there:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Open question 3 (transport and trust model).&lt;/strong&gt; The default of a local socket is replaced: the service listens on &lt;code dir=&quot;auto&quot;&gt;127.0.0.1&lt;/code&gt; only, on a random port, and the port and a random bearer token are written to a file in the git common dir, owner-only. The identity check before writes is the handshake of ADR 2026-10-27-1 D-4.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;D-3 (the CLI sends a command).&lt;/strong&gt; During the strangler the request carries the rows the CLI built, with their context; the command form, in which the service also stamps &lt;code dir=&quot;auto&quot;&gt;policy_metadata.lane_head&lt;/code&gt; itself, arrives with migration step 4.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;D-7 (append semantics).&lt;/strong&gt; The single &lt;code dir=&quot;auto&quot;&gt;O_APPEND&lt;/code&gt; write of full JSON lines, synced before the acknowledgement, is authoritative; a multi-event operation is one write and one &lt;code dir=&quot;auto&quot;&gt;fsync&lt;/code&gt;. Windows semantics follow the lock-interop spike (#6193).&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Nothing else in this record changes.&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;python-in-process-eventbridge&quot;&gt;Python in-process EventBridge&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Pros:&lt;/strong&gt; the cheapest for 4.0.0; no new runtime.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Cons:&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;The write domain stays in Python while the read domain is Java, so the models are kept twice.&lt;/li&gt;
&lt;li&gt;Storage cannot change without touching the CLI.&lt;/li&gt;
&lt;li&gt;#6117’s and #6185’s Java work becomes a second writer to reconcile later.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;a-native-binary-run-once-per-command&quot;&gt;A native binary run once per command&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Pros:&lt;/strong&gt; nothing resident; works offline; no service lifecycle.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Cons:&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;A process start on every transition.&lt;/li&gt;
&lt;li&gt;No home for alternate deployments.&lt;/li&gt;
&lt;li&gt;Every invocation re-reads and re-folds state.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;a-resident-daemon-per-worktree&quot;&gt;A resident daemon per worktree&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Pros:&lt;/strong&gt; follows the charter-service precedent.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Cons:&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;One repository’s writes are split across processes, so cross-process locking comes back.&lt;/li&gt;
&lt;li&gt;Lane worktrees of one Mission would talk to different writers.&lt;/li&gt;
&lt;li&gt;It defeats the point of a backend service.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;a-resident-java-write-service-per-repository-chosen&quot;&gt;A resident Java write service per repository (chosen)&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Pros:&lt;/strong&gt; one writer per repository; warm state; clear ownership; storage behind a port; shares the read models.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Cons:&lt;/strong&gt; a service lifecycle and a JVM toolchain on the write path; a security-reviewed launcher; a cross-language parity burden during the migration.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;more-information&quot;&gt;More Information&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;The current-state map and gap table: &lt;a href=&quot;/architecture/event-ledger-writers-and-readers/&quot;&gt;event ledger writers and readers&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;Contributor rules: &lt;a href=&quot;/development/reference/events-in-core/&quot;&gt;Events in core&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty-events&lt;/code&gt;: &lt;code dir=&quot;auto&quot;&gt;docs/api/ledger-write-contract.md&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;src/spec_kitty_events/conformance/fixtures/ledger_append/README.md&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;The read service: &lt;code dir=&quot;auto&quot;&gt;services/mission-status-api/README.md&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;amendment-2026-10-29-accepted-the-events-services-live-in-spec-kitty-events&quot;&gt;Amendment 2026-10-29 (Accepted): the events services live in spec-kitty-events&lt;/h2&gt;
&lt;p&gt;&lt;a href=&quot;/adr/4.x/2026-10-29-1-the-events-domain-and-its-java-services-live-in-spec-kitty-events/&quot;&gt;ADR 2026-10-29-1&lt;/a&gt; records the operator and CEO ruling of 2026-10-29 that the events domain’s Java services and contracts move to &lt;code dir=&quot;auto&quot;&gt;spec-kitty-events&lt;/code&gt;, and that core consumes a released, pinned build.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;D-1 (the &lt;code dir=&quot;auto&quot;&gt;event-log&lt;/code&gt; module writes all ledgers) and D-5 (native first, JVM jar fallback).&lt;/strong&gt; The &lt;code dir=&quot;auto&quot;&gt;event-log&lt;/code&gt; module and the &lt;code dir=&quot;auto&quot;&gt;command-cli&lt;/code&gt; deployable live in &lt;code dir=&quot;auto&quot;&gt;spec-kitty-events&lt;/code&gt;. Core takes both the native binary and the jar from a pinned &lt;code dir=&quot;auto&quot;&gt;service-v*&lt;/code&gt; release, executes either only when its sha256 matches the pin, and fetches it on first use. The no-Python-writer rule and the named refusal are unchanged; the refusal codes are listed in 2026-10-29-1 D-5.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Nothing else in this record changes.&lt;/p&gt;
&lt;h2 id=&quot;amendment-2026-11-06-d-6-records-and-step-4a&quot;&gt;Amendment 2026-11-06: D-6 records and step 4a&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Status of this amendment:&lt;/strong&gt; Proposed (2026-11-06), with the five records it names; the rest of this record stays Accepted. Operator ruling 4 of epic &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/issues/7276&quot;&gt;#7276&lt;/a&gt; (DM &lt;code dir=&quot;auto&quot;&gt;01M6QY371KRY5XXQMDQ4WZR1YE&lt;/code&gt;, Mission &lt;code dir=&quot;auto&quot;&gt;lane-worktree-model-hardening-01M6QY1M&lt;/code&gt;): write the ADR set for the Java write service writing coordination status without a coordination worktree; ADRs only, the implementation follows migration step 4. Slice S9, &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/issues/7284&quot;&gt;#7284&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;D-6 applies.&lt;/strong&gt; Committing a coordination Mission’s ledger into git objects, with no coordination worktree, is a new storage adapter of &lt;code dir=&quot;auto&quot;&gt;EventLogPort&lt;/code&gt;, not “the local file ledger”. D-6’s “each of those needs its own ADR before such an adapter is built” therefore binds, and these records discharge it:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;C-1&lt;/strong&gt; &lt;a href=&quot;/adr/4.x/2026-11-06-4-coordination-branch-written-by-commit/&quot;&gt;ADR 2026-11-06-4&lt;/a&gt;: a coordination branch is written by commit, not through a coordination worktree.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;C-2&lt;/strong&gt; &lt;a href=&quot;/adr/4.x/2026-11-06-5-gates-over-worktree-less-coordination/&quot;&gt;ADR 2026-11-06-5&lt;/a&gt;: consolidation gates hold over a coordination branch with no worktree.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;C-3&lt;/strong&gt; &lt;a href=&quot;/adr/4.x/2026-11-06-6-committed-ledger-is-the-coordination-blob/&quot;&gt;ADR 2026-11-06-6&lt;/a&gt;: the committed ledger of a coordination Mission is the blob on its coordination branch.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;events ADR-0007&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;docs/adr/0007-write-service-commits-coordination-status-by-ref.md&lt;/code&gt;: the write service commits coordination status onto the branch ref by compare-and-swap.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;events ADR-0008&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;docs/adr/0008-read-service-reads-coordination-ledger-from-git-objects.md&lt;/code&gt;: the read service reads a coordination ledger from git objects.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The two events records live in &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty-events&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty/spec-kitty-events&lt;/code&gt;&lt;/a&gt;, branch &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; (merged from &lt;code dir=&quot;auto&quot;&gt;issue-7284-coordination-ref-write-adrs&lt;/code&gt;), pull request &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty-events/pull/215&quot;&gt;spec-kitty/spec-kitty-events#215&lt;/a&gt; (placement rule of &lt;a href=&quot;/adr/4.x/2026-10-29-1-the-events-domain-and-its-java-services-live-in-spec-kitty-events/&quot;&gt;ADR 2026-10-29-1&lt;/a&gt; D-1: Java service internals and the &lt;code dir=&quot;auto&quot;&gt;mission-write&lt;/code&gt; contract are decided there).&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Mapping.&lt;/strong&gt; Each D-6 bullet, quoted, maps to exactly one record:&lt;/p&gt;


















































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;D-6 bullet&lt;/th&gt;&lt;th&gt;Record&lt;/th&gt;&lt;th&gt;Confirmation tests named by that record&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;EventLogPort&lt;/code&gt; is a storage abstraction from the first Java write, and the only adapter that ships is the local file ledger.”&lt;/td&gt;&lt;td&gt;events ADR-0007&lt;/td&gt;&lt;td&gt;ADR-0007 Confirmation (&lt;code dir=&quot;auto&quot;&gt;command-cli&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;spec-kitty-events&lt;/code&gt;): one commit per unit and per batch with the prior tip as parent and only the log path changed; the first write commits; index, &lt;code dir=&quot;auto&quot;&gt;HEAD&lt;/code&gt; and working tree unchanged and planted hooks never run; &lt;code dir=&quot;auto&quot;&gt;COORDINATION_REF_MOVED&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;SERVICE_BUSY&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;COORDINATION_BRANCH_DELETED&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;COORDINATION_REF_CHECKED_OUT&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;COORDINATION_LEDGER_UNREADABLE&lt;/code&gt;; replay and &lt;code dir=&quot;auto&quot;&gt;EVENT_ID_CONFLICT&lt;/code&gt;. Today: &lt;code dir=&quot;auto&quot;&gt;OperationsTest&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;contracts/tools/enum_pins.json&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;“A database or hosted adapter is &lt;strong&gt;not&lt;/strong&gt; a drop-in replacement under the current decisions:”&lt;/td&gt;&lt;td&gt;this amendment&lt;/td&gt;&lt;td&gt;Its four sub-bullets are the next four rows, each with its own record.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;“the git-committed ledger is the publication seam (ADR 2026-10-13-2 D-2);”&lt;/td&gt;&lt;td&gt;C-3&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tests/status/test_events_tail_coordination_ref.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tests/status/test_tail_cursor_source_ref.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tests/status/test_read_door_missing_ref_parity.py&lt;/code&gt; (to be written by the step-4 Mission).&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;“the read API pulls the committed ledger (ADR 2026-10-01-2 D-6);”&lt;/td&gt;&lt;td&gt;events ADR-0008&lt;/td&gt;&lt;td&gt;ADR-0008 Confirmation: oracle parity and corpus comparison on the no-worktree fixture; architecture rule 10; the native image answers with no &lt;code dir=&quot;auto&quot;&gt;git&lt;/code&gt; on &lt;code dir=&quot;auto&quot;&gt;PATH&lt;/code&gt;, starting no process and writing no file; one tip per read under a concurrent ref move; named answers for a missing ref and an unsupported ref backend.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;“merge semantics are file based (ADR 2026-02-09-3);”&lt;/td&gt;&lt;td&gt;C-2&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tests/consolidation/test_late_window_reads_pinned_ref.py&lt;/code&gt; (to be written); S10’s &lt;code dir=&quot;auto&quot;&gt;tests/coordination/test_projection_teardown.py&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;tests/consolidation/test_late_teardown_projection.py&lt;/code&gt; on a ref-only coordination branch.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;“the consolidation gates rely on git ancestry and on &lt;code dir=&quot;auto&quot;&gt;lane_head&lt;/code&gt; stamps.”&lt;/td&gt;&lt;td&gt;C-2&lt;/td&gt;&lt;td&gt;Unchanged and green: &lt;code dir=&quot;auto&quot;&gt;tests/consolidation/test_approved_bound.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_approved_bound_residuals.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_wp_attribution.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_wp_evidence.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_claim_integrity_refusal.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tests/specify_cli/lanes/test_for_review_gate_parity.py&lt;/code&gt;; to be written: &lt;code dir=&quot;auto&quot;&gt;tests/consolidation/test_coordination_write_fence.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_rollback_without_coordination_checkout.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_resume_recovery_roles.py&lt;/code&gt;.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;“Each of those needs its own ADR before such an adapter is built.”&lt;/td&gt;&lt;td&gt;this amendment&lt;/td&gt;&lt;td&gt;This table: every bullet above names one record, and each record names its tests.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;“This decision adds no hosted surface to open-core (#6164 stands).”&lt;/td&gt;&lt;td&gt;this amendment&lt;/td&gt;&lt;td&gt;Unchanged: none of the five records adds a hosted surface; the services stay loopback and local.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;C-3 D-2 states the core side of the read API amendment (ADR 2026-10-01-2 D-3, D-6) and points to ADR-0008 for how the read service does it; it is not a second discharge of that bullet. C-1 discharges no D-6 bullet of its own: it is the placement decision every row above relies on, and the step below.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Step 4a.&lt;/strong&gt; The migration order gains:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;4a. Coordination writes by commit; the coordination worktree is retired&lt;/strong&gt; (C-1). The write service serves &lt;code dir=&quot;auto&quot;&gt;writeSurface: coordination_ref_commit&lt;/code&gt; (events ADR-0007); every coordination-partition kind has a rule (C-1 D-3); existing coordination worktrees are drained and removed under the destructive guard (C-1 D-9); the CLI’s five coordination-worktree codes retire (C-1 D-8).&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Steps 4 and 4a ship in one release&lt;/strong&gt; (C-1 D-10). &lt;code dir=&quot;auto&quot;&gt;coordination_ref_commit&lt;/code&gt; goes live only in the release that also ships C-1’s artefact rule (notes, trace, issue matrix, decisions, byproducts; #7266) and the drain and removal of existing coordination worktrees. Step 4 deletes the Python appenders and D-5 forbids a Python fallback writer, so a step 4 without step 4a would leave every existing coordination Mission refused with &lt;code dir=&quot;auto&quot;&gt;COORDINATION_REF_CHECKED_OUT&lt;/code&gt; on every transition.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Open question 2&lt;/strong&gt; (when write-location resolution moves into the service) keeps its default, step 4; for coordination Missions the location the service resolves is &lt;code dir=&quot;auto&quot;&gt;refs/heads/&amp;#x3C;coord&gt;&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;destinationRef&lt;/code&gt; becomes required for that surface (C-1 D-7, amending &lt;a href=&quot;/adr/4.x/2026-10-27-1-the-write-service-protocol-is-loopback-http-with-a-bearer-token/&quot;&gt;ADR 2026-10-27-1&lt;/a&gt; D-3).&lt;/p&gt;
&lt;p&gt;Nothing else in this record changes.&lt;/p&gt;</content>
</entry>
