<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/plans/events-domain-move/plan/">
  <id>https://docs.spec-kitty.ai/plans/events-domain-move/plan/</id>
  <title>Events domain move — core-side plan</title>
  <updated>2026-11-01T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/plans/events-domain-move/plan/"/>
  <summary>Core-side inventory, pin/fetch/launcher design and cut-over runbook for moving the Java event services to spec-kitty-events (ADR 2026-10-29-1).</summary>
  <content type="html">&lt;h2 id=&quot;events-domain-move-core-side-plan&quot;&gt;Events domain move: core-side plan&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Status:&lt;/strong&gt; Signed off by the operator, 2026-10-29: the go is given and the issue moves are approved. The freeze gate and the governance records landed first, then the pin, fetch and launcher mechanism (#6590). The cut-over (§4 step 5) is done in #6915: core pins the read service from spec-kitty-events &lt;code dir=&quot;auto&quot;&gt;service-v0.1.0-rc.1&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;pins/read-service.source.yaml&lt;/code&gt;) and the copies are removed.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Decision being executed:&lt;/strong&gt; operator and CEO, 2026-10-29. The Java event services (read: Mission Status Read API; write: Mission Write API / event-log write core) leave core for &lt;code dir=&quot;auto&quot;&gt;spec-kitty/spec-kitty-events&lt;/code&gt;, which becomes the canonical owner of the events domain. Binding: Gradle everywhere; history preserved (the spec-kitty-events side imports with filter-repo); a separate &lt;code dir=&quot;auto&quot;&gt;service-vX.Y.Z&lt;/code&gt; tag line in spec-kitty-events; core pins a service tag plus a sha256 per OS binary; &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt; is frozen in core from now on.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Further operator decisions (2026-10-29, relayed by the spec-kitty-events side):&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Layout in spec-kitty-events: &lt;code dir=&quot;auto&quot;&gt;service/&lt;/code&gt; (from &lt;code dir=&quot;auto&quot;&gt;services/mission-status-api/&lt;/code&gt;, via filter-repo &lt;code dir=&quot;auto&quot;&gt;--path-rename&lt;/code&gt;) plus &lt;code dir=&quot;auto&quot;&gt;contracts/&lt;/code&gt;, both imported with history in one pass.&lt;/li&gt;
&lt;li&gt;Contract bundles ride on &lt;code dir=&quot;auto&quot;&gt;service-v*&lt;/code&gt;. There are two release lines in total: PyPI &lt;code dir=&quot;auto&quot;&gt;v*&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;service-v*&lt;/code&gt;. Core’s &lt;code dir=&quot;auto&quot;&gt;contract-&amp;#x3C;module&gt;-v*&lt;/code&gt; line and &lt;code dir=&quot;auto&quot;&gt;contracts-release.yml&lt;/code&gt; retire at the cut-over.&lt;/li&gt;
&lt;li&gt;Events CI pins a core SHA for the lock-interop peer, the nightly corpus compare and golden regeneration.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Proposed assets per &lt;code dir=&quot;auto&quot;&gt;service-v&amp;#x3C;ver&gt;&lt;/code&gt; release (the spec-kitty-events side):&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;mission-status-api-&amp;#x3C;ver&gt;-{linux-x64,linux-arm64,macos-arm64,windows-x64.exe}&lt;/code&gt;, each with a &lt;code dir=&quot;auto&quot;&gt;.sha256&lt;/code&gt;;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;mission-status-api-&amp;#x3C;ver&gt;.jar&lt;/code&gt; (the JVM fallback);&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;contract-bundles-&amp;#x3C;ver&gt;.tar.gz&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;contract-tools-&amp;#x3C;ver&gt;.tar.gz&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;conformance-fixtures-&amp;#x3C;ver&gt;.tar.gz&lt;/code&gt;, each with a &lt;code dir=&quot;auto&quot;&gt;.sha256&lt;/code&gt;;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;SHA256SUMS&lt;/code&gt; and the SLSA attestation.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;command-cli&lt;/code&gt; follows later under the same scheme.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;1-what-core-holds-today-phase-0-inventory&quot;&gt;1. What core holds today (Phase 0 inventory)&lt;/h2&gt;
&lt;h3 id=&quot;11-the-service-tree&quot;&gt;1.1 The service tree&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;services/mission-status-api/&lt;/code&gt; is a standalone Gradle (Kotlin DSL) build: Spring Boot 4.1.1, GraalVM CE 25.0.2, package &lt;code dir=&quot;auto&quot;&gt;org.speckitty.missionstatus&lt;/code&gt;.
&lt;ul&gt;
&lt;li&gt;Root project &lt;code dir=&quot;auto&quot;&gt;query-service&lt;/code&gt;: the read-only, loopback HTTP read API.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;domain-model&lt;/code&gt;: Mission status types, with no IO.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;event-log&lt;/code&gt;: the JSONL codec, &lt;code dir=&quot;auto&quot;&gt;StatusReducer&lt;/code&gt; (a port of spec-kitty-events &lt;code dir=&quot;auto&quot;&gt;reduce_parsed&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;LedgerLocks&lt;/code&gt; (flock through FFM; interoperates with Python &lt;code dir=&quot;auto&quot;&gt;kernel.locks&lt;/code&gt;) and &lt;code dir=&quot;auto&quot;&gt;TornTailRepair&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;command-cli&lt;/code&gt; (the write deployable) does not exist yet.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;Native targets: linux-x64, linux-arm64, macos-arm64, windows-x64. The release job is wired (tag &lt;code dir=&quot;auto&quot;&gt;mission-status-api-v*&lt;/code&gt;, asset plus &lt;code dir=&quot;auto&quot;&gt;.sha256&lt;/code&gt; per target, SLSA attestation), but &lt;strong&gt;no release has ever been cut&lt;/strong&gt;. Binary size is therefore unknown.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;No Python code launches either service.&lt;/strong&gt; The CLI wheel ships no server (ADR 2026-10-01-2 D-7). Python read paths stay native Python behind one read port (D-5).&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;12-everything-outside-services-that-couples-to-it&quot;&gt;1.2 Everything outside &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt; that couples to it&lt;/h3&gt;
















































































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Area&lt;/th&gt;&lt;th&gt;Files&lt;/th&gt;&lt;th&gt;At cut-over&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Service workflow&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.github/workflows/mission-status-api.yml&lt;/code&gt; (contract-bundle, jvm, native ×4, lock-interop ×3, gate, release, nightly-corpus)&lt;/td&gt;&lt;td&gt;remove; the jobs move to spec-kitty-events&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;CI routing&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;ci-router.yml&lt;/code&gt; (glossary group: torn-tail path; &lt;code dir=&quot;auto&quot;&gt;ci&lt;/code&gt; group: &lt;code dir=&quot;auto&quot;&gt;services/**&lt;/code&gt;; contract_tools: the conformance paths; the &lt;code dir=&quot;auto&quot;&gt;tests (corpus-blocking)&lt;/code&gt; job), &lt;code dir=&quot;auto&quot;&gt;.github/ci-module-registry.yml&lt;/code&gt; (glossary and &lt;code dir=&quot;auto&quot;&gt;ci&lt;/code&gt; roots), &lt;code dir=&quot;auto&quot;&gt;tests/release/ci_retirement_scrub.json&lt;/code&gt;&lt;/td&gt;&lt;td&gt;drop the &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt; roots; repoint the corpus job at fixtures fetched from the pin&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Fleet verdict&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;ci-fleet-verdict.yml&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;workflow_run.workflows&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;scripts/ci/fleet_verdict.py&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;PR_WORKFLOWS&lt;/code&gt;&lt;/td&gt;&lt;td&gt;drop “Mission Status API”&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;CI scripts&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;scripts/ci/mission_status_gate_checks.py&lt;/code&gt; (moves), &lt;code dir=&quot;auto&quot;&gt;mission_status_corpus_compare.py&lt;/code&gt; (Python oracle: stays in core, runs against the pinned binary), &lt;code dir=&quot;auto&quot;&gt;lock_interop_peer.py&lt;/code&gt; (Python peer: stays in core; events CI pins a core ref to run it)&lt;/td&gt;&lt;td&gt;per row&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Ownership and attributes&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;.github/CODEOWNERS&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;/services/mission-status-api/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;/contracts/&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;.gitattributes&lt;/code&gt; (conformance &lt;code dir=&quot;auto&quot;&gt;-text&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;drop&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Python runtime&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/status/write_service_protocol.py&lt;/code&gt; (client shapes), &lt;code dir=&quot;auto&quot;&gt;src/runtime/next/event_bridge.py&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;_internal_runtime/events.py&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;bind_event_bridge&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/events/event_bridge.py&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;LocalFileEventBridge&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;src/kernel/locks.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;src/kernel/event_log_append.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;all stay in core&lt;/strong&gt; (client side)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Service pin tests&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tests/ci/test_mission_status_api_build.py&lt;/code&gt; (~2,900 lines pinning the Gradle files and the workflow), &lt;code dir=&quot;auto&quot;&gt;test_mission_status_gate_checks.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_mission_status_routing.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_lock_interop_peer.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_ci_module_wiring.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_fleet_verdict.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_fleet_main.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_contracts_workflows.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;move to events (build pins) or rewrite against the lockfile (routing, fleet)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Architectural gates&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;test_gate_selection_authority.py:255-263&lt;/code&gt; (a services-only diff selects &lt;code dir=&quot;auto&quot;&gt;ci&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;test_module_shard_registry.py:744&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_no_dead_modules.py&lt;/code&gt; plus &lt;code dir=&quot;auto&quot;&gt;_baselines.yaml&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;dead_symbol_allowlist.yaml&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;write_service_protocol&lt;/code&gt;, until #6195)&lt;/td&gt;&lt;td&gt;update the services case; the dead-symbol entry stays&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Goldens read from &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt; by Python tests&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tests/contract/_mission_status_conformance.py&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;conformance/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;leak-patterns.json&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;_mission_status_artifact_goldens.py&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;test_mission_status_artifact_goldens.py&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;artifact-conformance/golden.json&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;tests/glossary/test_torn_tail_repair_goldens.py&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;torn-tail/repair-cases.json&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;fetch from the pinned fixtures asset (§3.4)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Python oracle on &lt;code dir=&quot;auto&quot;&gt;contracts/&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tests/contract/_mission_status_*.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_mission_status_*.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_mission_write_contract.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;fixtures/mission_write_refusal_parity.yaml&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tests/specify_cli/status/test_write_service_protocol.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;stay; repoint at the pinned &lt;code dir=&quot;auto&quot;&gt;contract-bundles-&amp;#x3C;ver&gt;.tar.gz&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Contracts&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;contracts/{mission-status,mission-write,_shared,fixtures,lint,tools}&lt;/code&gt; with its own Gradle build, &lt;code dir=&quot;auto&quot;&gt;contracts.yml&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;contracts-release.yml&lt;/code&gt; (tags &lt;code dir=&quot;auto&quot;&gt;contract-&amp;#x3C;module&gt;-v*&lt;/code&gt;), plus contract-tool tests (&lt;code dir=&quot;auto&quot;&gt;test_gradle_pin_check.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_tamper_check.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_bundle.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_client_smoke.py&lt;/code&gt;)&lt;/td&gt;&lt;td&gt;&lt;strong&gt;moves (decided)&lt;/strong&gt;: remove from core except &lt;code dir=&quot;auto&quot;&gt;fixtures/fixture_0*.json&lt;/code&gt;; retire &lt;code dir=&quot;auto&quot;&gt;contracts.yml&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;contracts-release.yml&lt;/code&gt;; move the contract-tool tests; acceptance-jvm fetches &lt;code dir=&quot;auto&quot;&gt;install_tools.py&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;gradle_pin_check.py&lt;/code&gt; from the pinned &lt;code dir=&quot;auto&quot;&gt;service-v*&lt;/code&gt; release (Q5, decided)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Packaging&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;pyproject.toml&lt;/code&gt; sdist excludes &lt;code dir=&quot;auto&quot;&gt;services/**&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;contracts/**&lt;/code&gt;; &lt;code dir=&quot;auto&quot;&gt;also_copy&lt;/code&gt; lists &lt;code dir=&quot;auto&quot;&gt;contracts/&lt;/code&gt;; &lt;code dir=&quot;auto&quot;&gt;test_packaging_safety.py:240-254&lt;/code&gt;; &lt;code dir=&quot;auto&quot;&gt;NOTICE:19-25&lt;/code&gt; (Gradle wrapper under &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt;); charter licence line 665&lt;/td&gt;&lt;td&gt;drop the stale excludes and NOTICE entry; the guard keeps asserting that nothing is bundled&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Docs&lt;/td&gt;&lt;td&gt;ADRs 2026-10-01-2, 10-03-1, 10-12-2, 10-13-2, 10-14-1, 10-16-1, 10-22-1, 10-27-1; &lt;code dir=&quot;auto&quot;&gt;docs/architecture/{event-ledger-writers-and-readers,status-model}.md&lt;/code&gt; and the C4 &lt;code dir=&quot;auto&quot;&gt;01_context&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;02_containers&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;00_landscape&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;04_implementation_mapping&lt;/code&gt;; &lt;code dir=&quot;auto&quot;&gt;docs/development/reference/{ci-gate-mechanics,lock-interop-spike,events-in-core}.md&lt;/code&gt;; &lt;code dir=&quot;auto&quot;&gt;docs/plans/4-0-0-milestone-roadmap.md&lt;/code&gt;; CLAUDE.md and AGENTS.md (Team Kitty producer line); charter lines 22-25, 620, 665&lt;/td&gt;&lt;td&gt;pointer edits to the spec-kitty-events docs; history stays&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Not coupled&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;acceptance-jvm/&lt;/code&gt; (its own Gradle build, no &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt; reference), &lt;code dir=&quot;auto&quot;&gt;sonar.yml&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;sonar-project.properties&lt;/code&gt; (scan only acceptance-jvm), the Makefile, &lt;code dir=&quot;auto&quot;&gt;scripts/dev/cloud-session-setup.sh&lt;/code&gt; (Java setup for acceptance-jvm only)&lt;/td&gt;&lt;td&gt;none&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;13-precedents&quot;&gt;1.3 Precedents&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Packs pin&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;packs/*.source.yaml&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;charter.offering.packs.pack_pin&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;pack_fetch&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;scripts/sync_packs.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;make sync-packs&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;.github/actions/sync-packs&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;charter pack vendor&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;hatch_build.py&lt;/code&gt;). It digest-verifies into &lt;code dir=&quot;auto&quot;&gt;${XDG_CACHE_HOME}/spec-kitty/open-packs/&amp;#x3C;sha&gt;/&lt;/code&gt;, re-hashes on every read, and gives a poisoned cache no trust. It fetches a &lt;strong&gt;git subtree&lt;/strong&gt; through &lt;code dir=&quot;auto&quot;&gt;kernel.git.remote&lt;/code&gt;, not a release asset.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Charter service:&lt;/strong&gt; no launcher, fetch or binary code exists in core (#6590 is unbuilt). The planned shape: a CLI-started, read-only, loopback, per-worktree daemon with a token; it fails closed (ADR 2026-10-03-1 Amend. 2026-10-19, spec-kitty-charter ADR-0011).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Write service:&lt;/strong&gt; shapes only (&lt;code dir=&quot;auto&quot;&gt;write_service_protocol.py&lt;/code&gt;, ADR 2026-10-27-1). One daemon per &lt;strong&gt;git common dir&lt;/strong&gt;, endpoint file &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;gcd&gt;/spec-kitty-write-service/endpoint.json&lt;/code&gt;. The launcher (#6676) is unbuilt. ADR 2026-10-22-1 D-5: native image, then JVM jar, else a named refusal; no Python fallback writer.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;2-in-flight-work-that-must-merge-first&quot;&gt;2. In-flight work that must merge first&lt;/h2&gt;
&lt;p&gt;None of the open PRs or pushed branches touches &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt;. The &lt;code dir=&quot;auto&quot;&gt;pr/5529-*&lt;/code&gt; branches are stale; that work already landed. Last &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt; commit on main: #6193, 2026-10-29.&lt;/p&gt;



































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Session / PR&lt;/th&gt;&lt;th&gt;Overlap with the move&lt;/th&gt;&lt;th&gt;Order&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;M5 #6400, PR #6774&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/status/emit.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;event_log_merge.py&lt;/code&gt; (the Python write path that the client cut-over later rewires)&lt;/td&gt;&lt;td&gt;merge before the cut-over PR&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;M3 #6457, PR #6748&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;pyproject.toml&lt;/code&gt;&lt;/td&gt;&lt;td&gt;merge before the cut-over PR (it textually overlaps the sdist-exclude edit)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;M11 #6610, PR #6740&lt;/td&gt;&lt;td&gt;event-log retention (Python); no file overlap&lt;/td&gt;&lt;td&gt;any order&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;M16 #5875 (PR #6775), M6 #6354, M8 #6557, M9 #6510, #6715&lt;/td&gt;&lt;td&gt;none&lt;/td&gt;&lt;td&gt;any order&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Unpushed work in live sessions&lt;/td&gt;&lt;td&gt;unknown from the outside&lt;/td&gt;&lt;td&gt;ask each live session before the cut-over&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;h2 id=&quot;3-design-one-pinned-service-mechanism-serves-6590-6676-and-this-move&quot;&gt;3. Design: one pinned-service mechanism (serves #6590, #6676 and this move)&lt;/h2&gt;
&lt;h3 id=&quot;31-lockfile-one-per-service-pinsservicesourceyaml&quot;&gt;3.1 Lockfile, one per service: &lt;code dir=&quot;auto&quot;&gt;pins/&amp;#x3C;service&gt;.source.yaml&lt;/code&gt;&lt;/h3&gt;
&lt;p&gt;Shaped like &lt;code dir=&quot;auto&quot;&gt;packs/*.source.yaml&lt;/code&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;yaml&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:#919F9F;--1:#5F636F&quot;&gt;# Pin lockfile: which released build of this service core consumes. Bump with&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 style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# `spec-kitty service vendor --service &amp;#x3C;name&gt; --tag &amp;#x3C;tag&gt;`; never edit by hand.&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 style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;service&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;write-service&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;            &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# write-service | read-service | charter-service&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 style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;repository&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;https://github.com/spec-kitty/spec-kitty-events&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 style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;tag&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;service-v0.1.0&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;               &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# immutable release tag; the resolved commit is recorded too&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 style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;commit&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;40-hex&gt;&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 style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;protocol_versions&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: [&lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;1&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;]            &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# must intersect write_service_protocol.SUPPORTED_PROTOCOL_VERSIONS&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 style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;requires_core&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&apos;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;&gt;=4.0.0rc9,&amp;#x3C;5&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&apos;&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 style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;assets&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:&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&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;linux-x64&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:     {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;deployable&gt;-&amp;#x3C;ver&gt;-linux-x64&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;sha256&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;64-hex&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&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&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;linux-arm64&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:   {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;deployable&gt;-&amp;#x3C;ver&gt;-linux-arm64&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;sha256&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;64-hex&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&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&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;macos-arm64&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:   {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;deployable&gt;-&amp;#x3C;ver&gt;-macos-arm64&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;sha256&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;64-hex&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&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&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;windows-x64&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:   {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;deployable&gt;-&amp;#x3C;ver&gt;-windows-x64.exe&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;sha256&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;64-hex&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&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&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;jvm&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:           {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;deployable&gt;-&amp;#x3C;ver&gt;.jar&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;sha256&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;64-hex&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}   &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# D-5 fallback&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 style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;contracts&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:       {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;contract-bundles-&amp;#x3C;ver&gt;.tar.gz&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,            &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;sha256&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;64-hex&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}   &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# oracle tests, write-protocol client&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 style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;fixtures&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:        {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;conformance-fixtures-&amp;#x3C;ver&gt;.tar.gz&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,        &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;sha256&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;64-hex&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}   &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# CI only&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 style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;tools&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;:           {&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;name&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;contract-tools-&amp;#x3C;ver&gt;.tar.gz&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,              &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#111111&quot;&gt;sha256&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;64-hex&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}   &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# acceptance-jvm: install_tools.py, gradle_pin_check.py, pins.json&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h3 id=&quot;32-fetch-and-verify-python-kernel-layer&quot;&gt;3.2 Fetch and verify (Python, &lt;code dir=&quot;auto&quot;&gt;kernel&lt;/code&gt; layer)&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;A new &lt;code dir=&quot;auto&quot;&gt;kernel.service_artifacts&lt;/code&gt; module: &lt;code dir=&quot;auto&quot;&gt;load_service_pin&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;fetch_asset(pin, target, cache_root)&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;verify_asset&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Cache: &lt;code dir=&quot;auto&quot;&gt;${XDG_CACHE_HOME}/spec-kitty/services/&amp;#x3C;service&gt;/&amp;#x3C;tag&gt;/&amp;#x3C;asset&gt;&lt;/code&gt;, re-verified by sha256 on every resolve; a mismatch is deleted and refetched. A binary with no pinned sha256 is never executed.&lt;/li&gt;
&lt;li&gt;Transport: HTTPS GET of the release asset URL. The remote-contact gate (&lt;code dir=&quot;auto&quot;&gt;test_remote_contact_owner.py&lt;/code&gt;) covers git argv only. An HTTP download is new remote contact, so I propose giving it one owner (&lt;code dir=&quot;auto&quot;&gt;kernel.net.release_assets&lt;/code&gt;) and a sibling gate, rather than scattering &lt;code dir=&quot;auto&quot;&gt;urllib&lt;/code&gt; calls.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;make sync-services&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;scripts/sync_services.py --service all [--offline] [--check]&lt;/code&gt;, plus &lt;code dir=&quot;auto&quot;&gt;.github/actions/sync-services&lt;/code&gt; (cache key &lt;code dir=&quot;auto&quot;&gt;hashFiles(&apos;pins/*.source.yaml&apos;)&lt;/code&gt;), mirror the packs tooling one for one.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;spec-kitty service vendor --service &amp;#x3C;s&gt; --tag &amp;#x3C;t&gt; [--check]&lt;/code&gt; bumps a pin by downloading every asset and recording its digest. It is the single documented bump path, and a &lt;code dir=&quot;auto&quot;&gt;packs.yml&lt;/code&gt;-style pin gate catches drift.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;33-launcher-python-specify_cli&quot;&gt;3.3 Launcher (Python, &lt;code dir=&quot;auto&quot;&gt;specify_cli&lt;/code&gt;)&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;One &lt;code dir=&quot;auto&quot;&gt;ServiceLauncher&lt;/code&gt; with a per-service policy:
&lt;ul&gt;
&lt;li&gt;write service: scope = git common dir, endpoint file per ADR 2026-10-27-1, launch-when-down;&lt;/li&gt;
&lt;li&gt;read service: per worktree, loopback, read-only; started by a consumer, not by the CLI write path;&lt;/li&gt;
&lt;li&gt;charter service: per worktree, token (ADR 2026-10-03-1).&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;Resolution order, as ADR D-5: (1) &lt;code dir=&quot;auto&quot;&gt;SPEC_KITTY_&amp;#x3C;SERVICE&gt;_BINARY&lt;/code&gt;, an explicit path, still digest-checked against the pin; (2) the install-provided slot (D-4); (3) the cached native asset for the host target; (4) the JVM jar if a JDK 25 is present; (5) a refusal. The only way to skip the digest check in (1) is the dev-only &lt;code dir=&quot;auto&quot;&gt;--unpinned-dev&lt;/code&gt; bypass of D-5: opt-in flag only, a visible warning on every use, never the default, never used by CI or release paths.&lt;/li&gt;
&lt;li&gt;Fail-closed codes, each with a remedy: &lt;code dir=&quot;auto&quot;&gt;SERVICE_BINARY_MISSING&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;SERVICE_BINARY_DIGEST_MISMATCH&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;SERVICE_UNSUPPORTED_PLATFORM&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;SERVICE_UNHEALTHY&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;SERVICE_VERSION_MISMATCH&lt;/code&gt; (protocol or instance), plus the existing &lt;code dir=&quot;auto&quot;&gt;WRITE_SERVICE_ENDPOINT_*&lt;/code&gt;. &lt;strong&gt;No Python fallback writer.&lt;/strong&gt; Reads keep working with no binary present (2026-10-01-2 D-5).&lt;/li&gt;
&lt;li&gt;Process identity is recorded (pid plus start time plus instance_id), not the pid alone. Stale-daemon recovery follows &lt;code dir=&quot;auto&quot;&gt;service.lock&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;34-shipping-the-binary-to-users-the-open-decision-q1&quot;&gt;3.4 Shipping the binary to users: the open decision (Q1)&lt;/h3&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Option&lt;/th&gt;&lt;th&gt;How&lt;/th&gt;&lt;th&gt;For&lt;/th&gt;&lt;th&gt;Against&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;A. First-run digest-verified fetch&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;Universal &lt;code dir=&quot;auto&quot;&gt;py3-none-any&lt;/code&gt; wheel ships only the pins. The launcher fetches the host asset on first need into the cache and verifies its sha256. &lt;code dir=&quot;auto&quot;&gt;spec-kitty service fetch&lt;/code&gt; pre-fetches; &lt;code dir=&quot;auto&quot;&gt;SPEC_KITTY_SERVICE_ASSET_DIR&lt;/code&gt; serves air-gapped installs.&lt;/td&gt;&lt;td&gt;One mechanism for dev, CI and users. The wheel stays small and pure. No PyPI size risk. Release pipeline unchanged.&lt;/td&gt;&lt;td&gt;Needs network on the first write (offline first-run refuses, with a remedy). Adds a runtime download point (mitigated: the sha256 is pinned in the signed wheel). Proxy and corporate-egress friction.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;B. Platform wheels&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;hatch_build.py&lt;/code&gt; fetches and verifies the host asset at build time and force-includes it. Releases ship per-OS wheels plus an sdist.&lt;/td&gt;&lt;td&gt;Works offline after &lt;code dir=&quot;auto&quot;&gt;pip install&lt;/code&gt;. No runtime download.&lt;/td&gt;&lt;td&gt;Core stops being a pure wheel: 4+ wheels per release and a cibuildwheel-like pipeline. Wheel size grows by every bundled service (write, then charter), and a binary over ~100 MB hits PyPI’s per-file cap. Unsupported platforms get an sdist that must fetch at build time anyway.&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;strong&gt;C. Hybrid&lt;/strong&gt;&lt;/td&gt;&lt;td&gt;A plus an optional companion &lt;code dir=&quot;auto&quot;&gt;spec-kitty-services&lt;/code&gt; platform wheel (the &lt;code dir=&quot;auto&quot;&gt;[native]&lt;/code&gt; extra) that pre-provides the binaries. The launcher prefers the companion, then the cache, then the fetch.&lt;/td&gt;&lt;td&gt;Offline installs supported; the core wheel stays pure.&lt;/td&gt;&lt;td&gt;Two release pipelines; the companion’s size limits still apply.&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;Recommendation: A now, built so C can be added later without changing the launcher&lt;/strong&gt; (the resolution order already has an install-provided slot). The binary size is unknown until the spec-kitty-events side’s first native build. If it comes in under ~60 MB and offline installs matter for 4.0.0 GA, revisit B or C.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Update 2026-10-31:&lt;/strong&gt; option C’s companion is decided: A stays the default, and the optional &lt;code dir=&quot;auto&quot;&gt;spec-kitty-services&lt;/code&gt; companion wheel fills the install slot (ADR 2026-10-29-1, Amendment 2026-10-31; #6904).&lt;/p&gt;
&lt;h2 id=&quot;4-cut-over-runbook-ordered-each-step-gated-on-the-previous&quot;&gt;4. Cut-over runbook (ordered; each step gated on the previous)&lt;/h2&gt;
&lt;ol start=&quot;0&quot;&gt;
&lt;li&gt;&lt;strong&gt;Done in this PR (prep):&lt;/strong&gt; this plan, the ADR, the charter/CLAUDE.md/AGENTS.md amendments, the pin schema.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Freeze (done in this PR; the go was given 2026-10-29):&lt;/strong&gt; the &lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_events_import_frozen.py&lt;/code&gt; gate on the always-on fast roster (fails on any change to &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt;, the moving &lt;code dir=&quot;auto&quot;&gt;contracts/&lt;/code&gt; modules and tools, or &lt;code dir=&quot;auto&quot;&gt;docs/architecture/event-ledger-writers-and-readers.md&lt;/code&gt;, against the git object ids at the freeze; planted-violation non-vacuity tests) plus a CODEOWNERS note. The gate’s exit (removal with &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt; at the cut-over) is tracked by #6117, owner Stijn Dejongh; an operator-approved change re-pins &lt;code dir=&quot;auto&quot;&gt;_FROZEN_OBJECTS&lt;/code&gt; in the same PR and is ported to spec-kitty-events (ADR D-9). Announce on #6409, #6676 and #6117 (comment text drafted for approval).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;All in-flight sessions merged&lt;/strong&gt; (§2); confirm that no live session holds unpushed &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;contracts/&lt;/code&gt; work.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;spec-kitty-events side:&lt;/strong&gt; filter-repo import (&lt;code dir=&quot;auto&quot;&gt;service/&lt;/code&gt; plus &lt;code dir=&quot;auto&quot;&gt;contracts/&lt;/code&gt;), Gradle unification, CI (pinned to the frozen core SHA), and the first &lt;code dir=&quot;auto&quot;&gt;service-v*&lt;/code&gt; pre-release with per-OS assets, the jar, the contract-bundles and conformance-fixtures assets, &lt;code dir=&quot;auto&quot;&gt;SHA256SUMS&lt;/code&gt; and attestation.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Core PR 1 (pre-cut-over, can merge while &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt; still exists):&lt;/strong&gt; the pin mechanism (&lt;code dir=&quot;auto&quot;&gt;kernel.service_artifacts&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;sync-services&lt;/code&gt;, the composite action, &lt;code dir=&quot;auto&quot;&gt;service vendor&lt;/code&gt;), the launcher skeleton with fail-closed codes, and the ADR plus charter/CLAUDE.md amendments. The pins point at A’s pre-release. CI fetches and verifies the pin.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Core PR 2 (cut-over) — done in #6915.&lt;/strong&gt; Drift found against the inventory below, all handled in that PR: the nightly &lt;code dir=&quot;auto&quot;&gt;acceptance-bdd&lt;/code&gt; job, &lt;code dir=&quot;auto&quot;&gt;sonar.yml&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;scripts/dev/cloud-session-setup.sh&lt;/code&gt; ran &lt;code dir=&quot;auto&quot;&gt;contracts/tools/*.py&lt;/code&gt; (now the pinned &lt;code dir=&quot;auto&quot;&gt;contract-tools&lt;/code&gt; extra; the Gradle pin check goes through &lt;code dir=&quot;auto&quot;&gt;scripts/ci/acceptance_jvm_gradle_pin_check.py&lt;/code&gt;, because the released tool’s bare run also scans a &lt;code dir=&quot;auto&quot;&gt;contracts/&lt;/code&gt; subproject core no longer has); the fleet verdict also listed &lt;code dir=&quot;auto&quot;&gt;contracts.yml&lt;/code&gt;; &lt;code dir=&quot;auto&quot;&gt;tests/ci/test_sync_services.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tests/ci/test_contracts_routing.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_scenario_contract.py&lt;/code&gt; and the duplicate-suite allowlist referenced the removed paths; the binary compare lived only in &lt;code dir=&quot;auto&quot;&gt;mission-status-api.yml&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;nightly-corpus&lt;/code&gt; and moved to &lt;code dir=&quot;auto&quot;&gt;ci-nightly.yml&lt;/code&gt; against the pinned binary. Steps as planned:
&lt;ul&gt;
&lt;li&gt;remove &lt;code dir=&quot;auto&quot;&gt;services/&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;mission-status-api.yml&lt;/code&gt;, plus the ci-router, module-registry, fleet-verdict, CODEOWNERS and &lt;code dir=&quot;auto&quot;&gt;.gitattributes&lt;/code&gt; entries;&lt;/li&gt;
&lt;li&gt;move the build-pin tests (or delete them, since A re-homes them) and repoint the goldens tests at the fixtures asset;&lt;/li&gt;
&lt;li&gt;repoint the nightly corpus compare at the pinned binary;&lt;/li&gt;
&lt;li&gt;remove &lt;code dir=&quot;auto&quot;&gt;contracts/&lt;/code&gt; (except &lt;code dir=&quot;auto&quot;&gt;fixtures/fixture_0*.json&lt;/code&gt;), &lt;code dir=&quot;auto&quot;&gt;contracts.yml&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;contracts-release.yml&lt;/code&gt;; repoint acceptance-jvm’s tool use at the fetched contract tools;&lt;/li&gt;
&lt;li&gt;drop the stale NOTICE, pyproject excludes and &lt;code dir=&quot;auto&quot;&gt;also_copy&lt;/code&gt; entries;&lt;/li&gt;
&lt;li&gt;add docs pointers;&lt;/li&gt;
&lt;li&gt;run the packaging guards, &lt;code dir=&quot;auto&quot;&gt;test_pyproject_shape.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_shared_package_boundary.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_gate_selection_authority.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;test_module_shard_registry.py&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;test_ci_module_wiring.py&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Issue moves, on approval:&lt;/strong&gt; listed in §5.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Later (spec-kitty-events side):&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;command-cli&lt;/code&gt; write service released → core bumps the write-service pin → #6195 binds &lt;code dir=&quot;auto&quot;&gt;bind_event_bridge&lt;/code&gt; to the client → the dead-symbol allowlist entry for &lt;code dir=&quot;auto&quot;&gt;write_service_protocol&lt;/code&gt; drains.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;5-issue-retarget-proposals-none-actioned&quot;&gt;5. Issue retarget proposals (none actioned)&lt;/h2&gt;













































&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Issue&lt;/th&gt;&lt;th&gt;Proposal&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;#6117 epic, #6159, #6194–#6199&lt;/td&gt;&lt;td&gt;transfer to spec-kitty-events (Java write core); core keeps a tracking issue for the client bind (#6195’s CLI half)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;#6676&lt;/td&gt;&lt;td&gt;split: native build and per-OS release → events; CLI launcher plus fail-closed codes → core (implemented with §3.3)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;#6409, #957, #5528&lt;/td&gt;&lt;td&gt;transfer to events (read-API routes); #957 and #5528 split if a contract or Python oracle half remains in core&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;#6268&lt;/td&gt;&lt;td&gt;transfer to events (Java reducer port)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;#6609&lt;/td&gt;&lt;td&gt;split: Java reducer → events; the CLI’s Python reducer path stays in core&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;#6185, #5533, #6193, #6675&lt;/td&gt;&lt;td&gt;closed; nothing to move&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;#6608&lt;/td&gt;&lt;td&gt;stays in core as the event-native epic; its Java children move, while its Python children (#6610–#6613, #6438, #6412, #6446) stay&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;#6692&lt;/td&gt;&lt;td&gt;ADR on the Java writer: fold into the new ADR (§6) or close as superseded&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;#6590&lt;/td&gt;&lt;td&gt;stays in core; implemented by the same pin mechanism&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;The spec-kitty-events side owns the events-side list; this is the core-side cross-check.&lt;/p&gt;
&lt;h2 id=&quot;6-adr-and-governance-drafts-done-in-this-pr&quot;&gt;6. ADR and governance drafts (done in this PR)&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;New ADR &lt;code dir=&quot;auto&quot;&gt;docs/adr/4.x/2026-10-29-1-the-events-domain-and-its-java-services-live-in-spec-kitty-events.md&lt;/code&gt;. It amends 2026-10-01-2 (D-7, D-9 to D-12: in-repo becomes external), 2026-10-22-1 (D-5: where the binary comes from), 2026-10-27-1 (the launcher’s binary source), 2026-10-14-1 (the writer’s home), and 3.x 2026-04-25-1 (events = PyPI package &lt;strong&gt;plus&lt;/strong&gt; a pinned service binary). Modelled on the charter precedents.&lt;/li&gt;
&lt;li&gt;Charter “Shared Package Boundaries” amendment, plus CLAUDE.md/AGENTS.md pointer updates (Team Kitty producer line, Shared Package Boundary, Modularity SSOT).&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;7-operator-decisions-2026-10-29&quot;&gt;7. Operator decisions (2026-10-29)&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Q1 shipping:&lt;/strong&gt; option A, first-run digest-verified fetch; the wheel stays pure. The resolution order keeps an install-provided slot, so option C remains possible later.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Q2 contracts:&lt;/strong&gt; move with the services; the bundles ride on &lt;code dir=&quot;auto&quot;&gt;service-v*&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Q3 read service:&lt;/strong&gt; CI-only pin. The CLI never launches it; ADR 2026-10-01-2 D-7 holds.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Q4 freeze gate:&lt;/strong&gt; a small standalone PR once the live mission sessions have merged.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Q5 acceptance-jvm tools:&lt;/strong&gt; fetched from the pinned &lt;code dir=&quot;auto&quot;&gt;service-v*&lt;/code&gt; release, not copied. The spec-kitty-events side publishes them as a separate &lt;code dir=&quot;auto&quot;&gt;contract-tools-&amp;#x3C;ver&gt;.tar.gz&lt;/code&gt; (&lt;code dir=&quot;auto&quot;&gt;contracts/tools/*.py&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;pins.json&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;enum_pins.json&lt;/code&gt;; no fixtures), so &lt;code dir=&quot;auto&quot;&gt;contract-bundles&lt;/code&gt; stays pure contract data.&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
