<?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-07-2-governed-planning-application-seam/">
  <id>https://docs.spec-kitty.ai/adr/4.x/2026-10-07-2-governed-planning-application-seam/</id>
  <title>ADR: governed planning application seam and status integration</title>
  <updated>2026-10-07T00: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-07-2-governed-planning-application-seam/"/>
  <summary>Close the external planning artifact handoff while preserving native workflow, decision, status and commit authorities.</summary>
  <content type="html">&lt;h2 id=&quot;governed-planning-application-seam-and-status-integration&quot;&gt;Governed planning application seam and status integration&lt;/h2&gt;
&lt;p&gt;Status: Accepted. Date: 2026-10-07.&lt;/p&gt;
&lt;p&gt;The existing external API creates specification and plan scaffolds and finalizes work packages, but its clients still need to materialize and commit the intervening artifacts. Gokitty3’s amended Orchestrator 2 contract explicitly covers that missing design lifecycle. Mainline also has Stijn’s concern-module decomposition and an accepted plan for status-read convergence; this delivery must extend those authorities.&lt;/p&gt;
&lt;p&gt;Use a shared &lt;code dir=&quot;auto&quot;&gt;specify_cli.design&lt;/code&gt; application seam for bounded authored content, registered artifact placement, optimistic content revisions, accepted parent provenance and host commit outcomes. The API concern modules project that service, existing decision services, and the native &lt;code dir=&quot;auto&quot;&gt;next&lt;/code&gt; operation. Submissions never invent phase state. Native validators/finalization own requirements, dependency graphs, ownership, status bootstrap and planning pins; native &lt;code dir=&quot;auto&quot;&gt;next&lt;/code&gt; owns action issuance and completion. Canonical interview questions are shared with the host CLI.&lt;/p&gt;
&lt;p&gt;The existing drift-aware task-finalization predicate moves from the transport into the status public facade and is reused by both design status and authoring guards. A truncated event log that disagrees with a finalized snapshot must refuse; a second reducer would lose that proof. Question constants likewise move into the existing Mission planning application package, with the CLI re-exporting the same objects.&lt;/p&gt;
&lt;figure class=&quot;dk-diagram&quot; role=&quot;group&quot;&gt;&lt;svg xmlns=&quot;http://www.w3.org/2000/svg&quot; id=&quot;m04326539074046736-0&quot; width=&quot;100%&quot; aria-roledescription=&quot;flowchart-v2&quot; class=&quot;flowchart&quot; style=&quot;font-family:arial,sans-serif;font-size:16px;fill:var(--dk-diagram-node-text);max-width:1141.265625px&quot; viewBox=&quot;0 0 1141.266 198&quot;&gt;&lt;marker id=&quot;m04326539074046736-0_flowchart-v2-pointEnd&quot; class=&quot;marker flowchart-v2&quot; markerHeight=&quot;8&quot; markerUnits=&quot;userSpaceOnUse&quot; markerWidth=&quot;8&quot; orient=&quot;auto&quot; refX=&quot;5&quot; refY=&quot;5&quot; viewBox=&quot;0 0 10 10&quot;&gt;&lt;path d=&quot;m0 0 10 5-10 5z&quot; class=&quot;arrowMarkerPath&quot; style=&quot;stroke-width:1;stroke-dasharray:1,0&quot;&gt;&lt;/path&gt;&lt;/marker&gt;&lt;marker id=&quot;m04326539074046736-0_flowchart-v2-pointStart&quot; class=&quot;marker flowchart-v2&quot; markerHeight=&quot;8&quot; markerUnits=&quot;userSpaceOnUse&quot; markerWidth=&quot;8&quot; orient=&quot;auto&quot; refX=&quot;4.5&quot; refY=&quot;5&quot; viewBox=&quot;0 0 10 10&quot;&gt;&lt;path d=&quot;m0 5 10 5V0z&quot; class=&quot;arrowMarkerPath&quot; style=&quot;stroke-width:1;stroke-dasharray:1,0&quot;&gt;&lt;/path&gt;&lt;/marker&gt;&lt;marker id=&quot;m04326539074046736-0_flowchart-v2-pointEnd-margin&quot; class=&quot;marker flowchart-v2&quot; markerHeight=&quot;14&quot; markerUnits=&quot;userSpaceOnUse&quot; markerWidth=&quot;10.5&quot; orient=&quot;auto&quot; refX=&quot;11.5&quot; refY=&quot;7&quot; viewBox=&quot;0 0 11.5 14&quot;&gt;&lt;path d=&quot;m0 0 11.5 7L0 14z&quot; class=&quot;arrowMarkerPath&quot; style=&quot;stroke-width:0;stroke-dasharray:1,0&quot;&gt;&lt;/path&gt;&lt;/marker&gt;&lt;marker id=&quot;m04326539074046736-0_flowchart-v2-pointStart-margin&quot; class=&quot;marker flowchart-v2&quot; markerHeight=&quot;14&quot; markerUnits=&quot;userSpaceOnUse&quot; markerWidth=&quot;11.5&quot; orient=&quot;auto&quot; refX=&quot;1&quot; refY=&quot;7&quot; viewBox=&quot;0 0 11.5 14&quot;&gt;&lt;polygon points=&quot;0,7 11.5,14 11.5,0&quot; class=&quot;arrowMarkerPath&quot; style=&quot;stroke-width:0;stroke-dasharray:1,0&quot;&gt;&lt;/polygon&gt;&lt;/marker&gt;&lt;marker id=&quot;m04326539074046736-0_flowchart-v2-circleEnd&quot; class=&quot;marker flowchart-v2&quot; markerHeight=&quot;11&quot; markerUnits=&quot;userSpaceOnUse&quot; markerWidth=&quot;11&quot; orient=&quot;auto&quot; refX=&quot;11&quot; refY=&quot;5&quot; viewBox=&quot;0 0 10 10&quot;&gt;&lt;circle cx=&quot;5&quot; cy=&quot;5&quot; r=&quot;5&quot; class=&quot;arrowMarkerPath&quot; style=&quot;stroke-width:1;stroke-dasharray:1,0&quot;&gt;&lt;/circle&gt;&lt;/marker&gt;&lt;marker id=&quot;m04326539074046736-0_flowchart-v2-circleStart&quot; class=&quot;marker flowchart-v2&quot; markerHeight=&quot;11&quot; markerUnits=&quot;userSpaceOnUse&quot; markerWidth=&quot;11&quot; orient=&quot;auto&quot; refX=&quot;-1&quot; refY=&quot;5&quot; viewBox=&quot;0 0 10 10&quot;&gt;&lt;circle cx=&quot;5&quot; cy=&quot;5&quot; r=&quot;5&quot; class=&quot;arrowMarkerPath&quot; style=&quot;stroke-width:1;stroke-dasharray:1,0&quot;&gt;&lt;/circle&gt;&lt;/marker&gt;&lt;marker id=&quot;m04326539074046736-0_flowchart-v2-circleEnd-margin&quot; class=&quot;marker flowchart-v2&quot; markerHeight=&quot;14&quot; markerUnits=&quot;userSpaceOnUse&quot; markerWidth=&quot;14&quot; orient=&quot;auto&quot; refX=&quot;12.25&quot; refY=&quot;5&quot; viewBox=&quot;0 0 10 10&quot;&gt;&lt;circle cx=&quot;5&quot; cy=&quot;5&quot; r=&quot;5&quot; class=&quot;arrowMarkerPath&quot; style=&quot;stroke-width:0;stroke-dasharray:1,0&quot;&gt;&lt;/circle&gt;&lt;/marker&gt;&lt;marker id=&quot;m04326539074046736-0_flowchart-v2-circleStart-margin&quot; class=&quot;marker flowchart-v2&quot; markerHeight=&quot;14&quot; markerUnits=&quot;userSpaceOnUse&quot; markerWidth=&quot;14&quot; orient=&quot;auto&quot; refX=&quot;-2&quot; refY=&quot;5&quot; viewBox=&quot;0 0 10 10&quot;&gt;&lt;circle cx=&quot;5&quot; cy=&quot;5&quot; r=&quot;5&quot; class=&quot;arrowMarkerPath&quot; style=&quot;stroke-width:0;stroke-dasharray:1,0&quot;&gt;&lt;/circle&gt;&lt;/marker&gt;&lt;marker id=&quot;m04326539074046736-0_flowchart-v2-crossEnd&quot; class=&quot;marker cross flowchart-v2&quot; markerHeight=&quot;11&quot; markerUnits=&quot;userSpaceOnUse&quot; markerWidth=&quot;11&quot; orient=&quot;auto&quot; refX=&quot;12&quot; refY=&quot;5.2&quot; viewBox=&quot;0 0 11 11&quot;&gt;&lt;path d=&quot;m1 1 9 9m0-9-9 9&quot; class=&quot;arrowMarkerPath&quot; style=&quot;stroke-width:2;stroke-dasharray:1,0&quot;&gt;&lt;/path&gt;&lt;/marker&gt;&lt;marker id=&quot;m04326539074046736-0_flowchart-v2-crossStart&quot; class=&quot;marker cross flowchart-v2&quot; markerHeight=&quot;11&quot; markerUnits=&quot;userSpaceOnUse&quot; markerWidth=&quot;11&quot; orient=&quot;auto&quot; refX=&quot;-1&quot; refY=&quot;5.2&quot; viewBox=&quot;0 0 11 11&quot;&gt;&lt;path d=&quot;m1 1 9 9m0-9-9 9&quot; class=&quot;arrowMarkerPath&quot; style=&quot;stroke-width:2;stroke-dasharray:1,0&quot;&gt;&lt;/path&gt;&lt;/marker&gt;&lt;marker id=&quot;m04326539074046736-0_flowchart-v2-crossEnd-margin&quot; class=&quot;marker cross flowchart-v2&quot; markerHeight=&quot;12&quot; markerUnits=&quot;userSpaceOnUse&quot; markerWidth=&quot;12&quot; orient=&quot;auto&quot; refX=&quot;17.7&quot; refY=&quot;7.5&quot; viewBox=&quot;0 0 15 15&quot;&gt;&lt;path d=&quot;m1 1 13 13M1 14 14 1&quot; class=&quot;arrowMarkerPath&quot; style=&quot;stroke-width:2.5&quot;&gt;&lt;/path&gt;&lt;/marker&gt;&lt;marker id=&quot;m04326539074046736-0_flowchart-v2-crossStart-margin&quot; class=&quot;marker cross flowchart-v2&quot; markerHeight=&quot;12&quot; markerUnits=&quot;userSpaceOnUse&quot; markerWidth=&quot;12&quot; orient=&quot;auto&quot; refX=&quot;-3.5&quot; refY=&quot;7.5&quot; viewBox=&quot;0 0 15 15&quot;&gt;&lt;path d=&quot;m1 1 13 13M1 14 14 1&quot; class=&quot;arrowMarkerPath&quot; style=&quot;stroke-width:2.5;stroke-dasharray:1,0&quot;&gt;&lt;/path&gt;&lt;/marker&gt;&lt;g class=&quot;root&quot;&gt;&lt;g class=&quot;edgePaths&quot;&gt;&lt;path id=&quot;m04326539074046736-0-L_Client_API_0&quot; marker-end=&quot;url(#m04326539074046736-0_flowchart-v2-pointEnd)&quot; d=&quot;M216.516 93h46&quot; class=&quot;edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link&quot; data-edge=&quot;true&quot; data-et=&quot;edge&quot; data-id=&quot;L_Client_API_0&quot; data-look=&quot;classic&quot; data-points=&quot;W3sieCI6MjE2LjUxNTYyNSwieSI6OTN9LHsieCI6MjQxLjUxNTYyNSwieSI6OTN9LHsieCI6MjY2LjUxNTYyNSwieSI6OTN9XQ==&quot;&gt;&lt;/path&gt;&lt;path id=&quot;m04326539074046736-0-L_API_Design_0&quot; marker-end=&quot;url(#m04326539074046736-0_flowchart-v2-pointEnd)&quot; d=&quot;m458.962 66 13.217-5.167c13.217-5.166 39.652-15.5 59.843-20.666S566.161 35 573.135 35h6.974&quot; class=&quot;edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link&quot; data-edge=&quot;true&quot; data-et=&quot;edge&quot; data-id=&quot;L_API_Design_0&quot; data-look=&quot;classic&quot; data-points=&quot;W3sieCI6NDU4Ljk2MTc0NTY4OTY1NTIsInkiOjY2fSx7IngiOjUzOC4yNjU2MjUsInkiOjM1fSx7IngiOjU4NC4xMDkzNzUsInkiOjM1fV0=&quot;&gt;&lt;/path&gt;&lt;path id=&quot;m04326539074046736-0-L_API_Native_0&quot; marker-end=&quot;url(#m04326539074046736-0_flowchart-v2-pointEnd)&quot; d=&quot;m458.962 120 13.217 5.167c13.217 5.166 39.652 15.5 56.369 20.666C545.266 151 552.266 151 555.766 151h3.5&quot; class=&quot;edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link&quot; data-edge=&quot;true&quot; data-et=&quot;edge&quot; data-id=&quot;L_API_Native_0&quot; data-look=&quot;classic&quot; data-points=&quot;W3sieCI6NDU4Ljk2MTc0NTY4OTY1NTIsInkiOjEyMH0seyJ4Ijo1MzguMjY1NjI1LCJ5IjoxNTF9LHsieCI6NTYzLjI2NTYyNSwieSI6MTUxfV0=&quot;&gt;&lt;/path&gt;&lt;path id=&quot;m04326539074046736-0-L_Design_Authority_0&quot; marker-end=&quot;url(#m04326539074046736-0_flowchart-v2-pointEnd)&quot; d=&quot;M802.422 35h7.641c7.64 0 22.921 0 34.104 1.325 11.183 1.326 18.268 3.977 21.81 5.302l3.542 1.326&quot; class=&quot;edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link&quot; data-edge=&quot;true&quot; data-et=&quot;edge&quot; data-id=&quot;L_Design_Authority_0&quot; data-look=&quot;classic&quot; data-points=&quot;W3sieCI6ODAyLjQyMTg3NSwieSI6MzV9LHsieCI6ODQ4LjI2NTYyNSwieSI6MzV9LHsieCI6ODczLjI2NTYyNSwieSI6NDQuMzU0ODM4NzA5Njc3NDE2fV0=&quot;&gt;&lt;/path&gt;&lt;path id=&quot;m04326539074046736-0-L_Native_Authority_0&quot; marker-end=&quot;url(#m04326539074046736-0_flowchart-v2-pointEnd)&quot; d=&quot;M823.266 151h4.166c4.167 0 12.5 0 20.209-1.325 7.709-1.326 14.794-3.977 18.336-5.302l3.542-1.326&quot; class=&quot;edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link&quot; data-edge=&quot;true&quot; data-et=&quot;edge&quot; data-id=&quot;L_Native_Authority_0&quot; data-look=&quot;classic&quot; data-points=&quot;W3sieCI6ODIzLjI2NTYyNSwieSI6MTUxfSx7IngiOjg0OC4yNjU2MjUsInkiOjE1MX0seyJ4Ijo4NzMuMjY1NjI1LCJ5IjoxNDEuNjQ1MTYxMjkwMzIyNn1d&quot;&gt;&lt;/path&gt;&lt;/g&gt;&lt;g class=&quot;edgeLabels&quot;&gt;&lt;g class=&quot;edgeLabel&quot;&gt;&lt;foreignObject width=&quot;0&quot; height=&quot;0&quot; class=&quot;label&quot; data-id=&quot;L_Client_API_0&quot;&gt;&lt;div xmlns=&quot;http://www.w3.org/1999/xhtml&quot; class=&quot;labelBkg&quot; style=&quot;display:table-cell;white-space:nowrap;line-height:1.5;max-width:200px;text-align:center&quot;&gt;&lt;span class=&quot;edgeLabel&quot;&gt;&lt;/span&gt;&lt;/div&gt;&lt;/foreignObject&gt;&lt;/g&gt;&lt;g class=&quot;edgeLabel&quot;&gt;&lt;foreignObject width=&quot;0&quot; height=&quot;0&quot; class=&quot;label&quot; data-id=&quot;L_API_Design_0&quot;&gt;&lt;div xmlns=&quot;http://www.w3.org/1999/xhtml&quot; class=&quot;labelBkg&quot; style=&quot;display:table-cell;white-space:nowrap;line-height:1.5;max-width:200px;text-align:center&quot;&gt;&lt;span class=&quot;edgeLabel&quot;&gt;&lt;/span&gt;&lt;/div&gt;&lt;/foreignObject&gt;&lt;/g&gt;&lt;g class=&quot;edgeLabel&quot;&gt;&lt;foreignObject width=&quot;0&quot; height=&quot;0&quot; class=&quot;label&quot; data-id=&quot;L_API_Native_0&quot;&gt;&lt;div xmlns=&quot;http://www.w3.org/1999/xhtml&quot; class=&quot;labelBkg&quot; style=&quot;display:table-cell;white-space:nowrap;line-height:1.5;max-width:200px;text-align:center&quot;&gt;&lt;span class=&quot;edgeLabel&quot;&gt;&lt;/span&gt;&lt;/div&gt;&lt;/foreignObject&gt;&lt;/g&gt;&lt;g class=&quot;edgeLabel&quot;&gt;&lt;foreignObject width=&quot;0&quot; height=&quot;0&quot; class=&quot;label&quot; data-id=&quot;L_Design_Authority_0&quot;&gt;&lt;div xmlns=&quot;http://www.w3.org/1999/xhtml&quot; class=&quot;labelBkg&quot; style=&quot;display:table-cell;white-space:nowrap;line-height:1.5;max-width:200px;text-align:center&quot;&gt;&lt;span class=&quot;edgeLabel&quot;&gt;&lt;/span&gt;&lt;/div&gt;&lt;/foreignObject&gt;&lt;/g&gt;&lt;g class=&quot;edgeLabel&quot;&gt;&lt;foreignObject width=&quot;0&quot; height=&quot;0&quot; class=&quot;label&quot; data-id=&quot;L_Native_Authority_0&quot;&gt;&lt;div xmlns=&quot;http://www.w3.org/1999/xhtml&quot; class=&quot;labelBkg&quot; style=&quot;display:table-cell;white-space:nowrap;line-height:1.5;max-width:200px;text-align:center&quot;&gt;&lt;span class=&quot;edgeLabel&quot;&gt;&lt;/span&gt;&lt;/div&gt;&lt;/foreignObject&gt;&lt;/g&gt;&lt;/g&gt;&lt;g class=&quot;nodes&quot;&gt;&lt;g id=&quot;m04326539074046736-0-flowchart-Client-0&quot; class=&quot;node default&quot; data-look=&quot;classic&quot; transform=&quot;translate(112.258 93)&quot;&gt;&lt;rect width=&quot;208.516&quot; height=&quot;54&quot; x=&quot;-104.258&quot; y=&quot;-27&quot; class=&quot;basic label-container&quot;&gt;&lt;/rect&gt;&lt;g class=&quot;label&quot; transform=&quot;translate(-74.258 -12)&quot;&gt;&lt;rect&gt;&lt;/rect&gt;&lt;foreignObject width=&quot;148.516&quot; height=&quot;24&quot;&gt;&lt;div xmlns=&quot;http://www.w3.org/1999/xhtml&quot; style=&quot;display:table-cell;white-space:nowrap;line-height:1.5;max-width:200px;text-align:center&quot;&gt;&lt;span class=&quot;nodeLabel&quot;&gt;&lt;p&gt;External orchestrator&lt;/p&gt;&lt;/span&gt;&lt;/div&gt;&lt;/foreignObject&gt;&lt;/g&gt;&lt;/g&gt;&lt;g id=&quot;m04326539074046736-0-flowchart-API-1&quot; class=&quot;node default&quot; data-look=&quot;classic&quot; transform=&quot;translate(389.89 93)&quot;&gt;&lt;rect width=&quot;246.75&quot; height=&quot;54&quot; x=&quot;-123.375&quot; y=&quot;-27&quot; class=&quot;basic label-container&quot;&gt;&lt;/rect&gt;&lt;g class=&quot;label&quot; transform=&quot;translate(-93.375 -12)&quot;&gt;&lt;rect&gt;&lt;/rect&gt;&lt;foreignObject width=&quot;186.75&quot; height=&quot;24&quot;&gt;&lt;div xmlns=&quot;http://www.w3.org/1999/xhtml&quot; style=&quot;display:table-cell;white-space:nowrap;line-height:1.5;max-width:200px;text-align:center&quot;&gt;&lt;span class=&quot;nodeLabel&quot;&gt;&lt;p&gt;Existing Python JSON API&lt;/p&gt;&lt;/span&gt;&lt;/div&gt;&lt;/foreignObject&gt;&lt;/g&gt;&lt;/g&gt;&lt;g id=&quot;m04326539074046736-0-flowchart-Design-3&quot; class=&quot;node default&quot; data-look=&quot;classic&quot; transform=&quot;translate(693.266 35)&quot;&gt;&lt;rect width=&quot;218.313&quot; height=&quot;54&quot; x=&quot;-109.156&quot; y=&quot;-27&quot; class=&quot;basic label-container&quot;&gt;&lt;/rect&gt;&lt;g class=&quot;label&quot; transform=&quot;translate(-79.156 -12)&quot;&gt;&lt;rect&gt;&lt;/rect&gt;&lt;foreignObject width=&quot;158.313&quot; height=&quot;24&quot;&gt;&lt;div xmlns=&quot;http://www.w3.org/1999/xhtml&quot; style=&quot;display:table-cell;white-space:nowrap;line-height:1.5;max-width:200px;text-align:center&quot;&gt;&lt;span class=&quot;nodeLabel&quot;&gt;&lt;p&gt;Shared design service&lt;/p&gt;&lt;/span&gt;&lt;/div&gt;&lt;/foreignObject&gt;&lt;/g&gt;&lt;/g&gt;&lt;g id=&quot;m04326539074046736-0-flowchart-Native-5&quot; class=&quot;node default&quot; data-look=&quot;classic&quot; transform=&quot;translate(693.266 151)&quot;&gt;&lt;rect width=&quot;260&quot; height=&quot;78&quot; x=&quot;-130&quot; y=&quot;-39&quot; class=&quot;basic label-container&quot;&gt;&lt;/rect&gt;&lt;g class=&quot;label&quot; transform=&quot;translate(-100 -24)&quot;&gt;&lt;rect&gt;&lt;/rect&gt;&lt;foreignObject width=&quot;200&quot; height=&quot;48&quot;&gt;&lt;div xmlns=&quot;http://www.w3.org/1999/xhtml&quot; style=&quot;display:table;white-space:break-spaces;line-height:1.5;max-width:200px;text-align:center;width:200px&quot;&gt;&lt;span class=&quot;nodeLabel&quot;&gt;&lt;p&gt;Native next and decision services&lt;/p&gt;&lt;/span&gt;&lt;/div&gt;&lt;/foreignObject&gt;&lt;/g&gt;&lt;/g&gt;&lt;g id=&quot;m04326539074046736-0-flowchart-Authority-7&quot; class=&quot;node default&quot; data-look=&quot;classic&quot; transform=&quot;translate(1003.266 93)&quot;&gt;&lt;rect width=&quot;260&quot; height=&quot;102&quot; x=&quot;-130&quot; y=&quot;-51&quot; class=&quot;basic label-container&quot;&gt;&lt;/rect&gt;&lt;g class=&quot;label&quot; transform=&quot;translate(-100 -36)&quot;&gt;&lt;rect&gt;&lt;/rect&gt;&lt;foreignObject width=&quot;200&quot; height=&quot;72&quot;&gt;&lt;div xmlns=&quot;http://www.w3.org/1999/xhtml&quot; style=&quot;display:table;white-space:break-spaces;line-height:1.5;max-width:200px;text-align:center;width:200px&quot;&gt;&lt;span class=&quot;nodeLabel&quot;&gt;&lt;p&gt;Existing placement, Git commit, validators and status facade&lt;/p&gt;&lt;/span&gt;&lt;/div&gt;&lt;/foreignObject&gt;&lt;/g&gt;&lt;/g&gt;&lt;/g&gt;&lt;/g&gt;&lt;defs&gt;&lt;filter id=&quot;m04326539074046736-0-drop-shadow&quot; width=&quot;130%&quot; height=&quot;130%&quot;&gt;&lt;feDropShadow dx=&quot;4&quot; dy=&quot;4&quot; flood-color=&quot;#000&quot; flood-opacity=&quot;.06&quot; stdDeviation=&quot;0&quot;&gt;&lt;/feDropShadow&gt;&lt;/filter&gt;&lt;/defs&gt;&lt;defs&gt;&lt;filter id=&quot;m04326539074046736-0-drop-shadow-small&quot; width=&quot;150%&quot; height=&quot;150%&quot;&gt;&lt;feDropShadow dx=&quot;2&quot; dy=&quot;2&quot; flood-color=&quot;#000&quot; flood-opacity=&quot;.06&quot; stdDeviation=&quot;0&quot;&gt;&lt;/feDropShadow&gt;&lt;/filter&gt;&lt;/defs&gt;&lt;linearGradient id=&quot;m04326539074046736-0-gradient&quot; x1=&quot;0%&quot; x2=&quot;100%&quot; y1=&quot;0%&quot; y2=&quot;0%&quot; gradientUnits=&quot;objectBoundingBox&quot;&gt;&lt;stop offset=&quot;0%&quot; stop-color=&quot;var(--dk-diagram-node-border)&quot;&gt;&lt;/stop&gt;&lt;stop offset=&quot;100%&quot; stop-color=&quot;hsl(-40.8510638298, 21.038961039%, 74.9019607843%)&quot;&gt;&lt;/stop&gt;&lt;/linearGradient&gt;&lt;/svg&gt;&lt;/figure&gt;
&lt;p&gt;The Python transport remains a compatible extension of its existing versioned envelope. Its delivery profile maps the proposed &lt;code dir=&quot;auto&quot;&gt;spec-kitty.orchestrator/2&lt;/code&gt; semantics to implemented commands. It explicitly excludes GapDB atomic journal transactions, runtime epochs/fences/leases, immutable Go WorkRevision generations, durable operation replay, native asynchronous operations, watches, remote serving and tracker publication.&lt;/p&gt;
&lt;p&gt;Artifact revision means SHA-256 of the exact UTF-8 content or &lt;code dir=&quot;auto&quot;&gt;absent&lt;/code&gt;. A submitted plan names its current specification parent; work packages name their specification/plan/outline parents. Host-owned receipts persist the accepted lineage and context digests so a newly supplied current parent hash cannot conceal stale downstream content. Once native packages are finalized, all design edits through this surface refuse. Native reconciliation remains a separate authority.&lt;/p&gt;
&lt;p&gt;The submission lock serializes cooperative API writers only. Existing CLI/manual writers can be detected by changed content, but do not join a universal atomic journal. Files and Git commit effects precede host-local receipt persistence; failures report materialized/committed or reconciliation-required outcomes honestly. Receipts live in the Git common directory, are shared across linked worktrees, and are not portable to another clone. Missing/corrupt receipts refuse while the separate persistent enabled marker remains present. Both files are trusted host metadata; deleting both or moving to another clone does not preserve this provenance history.&lt;/p&gt;
&lt;h2 id=&quot;status-api-reconciliation&quot;&gt;Status API reconciliation&lt;/h2&gt;
&lt;p&gt;Stijn requested review of Jeroen’s unfinished status interface in &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty-mission-ui&quot;&gt;spec-kitty-mission-ui&lt;/a&gt;. That repository is a Lit/TypeScript no-I/O screen library: hosts own fetch, routing and refresh. Its main tree pins status contract 1.0.0 at &lt;code dir=&quot;auto&quot;&gt;9f41e48&lt;/code&gt;; &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty-mission-ui/pull/8&quot;&gt;PR #8&lt;/a&gt; proposes the WP-detail screen and newer contract pin &lt;code dir=&quot;auto&quot;&gt;b61d1fa&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;The &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/docs/adr/4.x/2026-10-01-2-mission-status-read-api-and-dashboard-extraction.md&quot;&gt;accepted Java service architecture&lt;/a&gt; uses a separate Java/Spring Boot REST/SSE module. No implemented Java service was found in the inspected current mainline or UI repository. Unpublished work may exist.&lt;/p&gt;
&lt;p&gt;Go already implements an in-process &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty-redesign/blob/a6142761bf0b050bb128c44bd937035435474661/internal/productionruntime/progress.go&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;ProgressService&lt;/code&gt;&lt;/a&gt; with Mission/List/Get/Watch and revisioned immutable projections. Reuse its bounded-query, authority-versus-observation, typed-refusal and freshness distinctions. Do not equate its database/projection revision cursors with the UI’s physical JSONL offset/hash cursor. Current Go watch supplies bounded live updates and resnapshot behavior, rather than the full proposed API 2 historical watch/replay guarantee.&lt;/p&gt;
&lt;p&gt;The integration point is the existing planned status read port. &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/issues/5532&quot;&gt;#5532&lt;/a&gt; keeps CLI reads in native Python and reserves switching to Java for a later decision. &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/issues/5631&quot;&gt;#5631&lt;/a&gt; requires its native adapter to resolve topology through MissionExecutionContext. Orchestrator readers and UI projections should consume that port; Java/HTTP/SSE belongs behind an optional adapter with shared contract conformance fixtures. This PR retains the existing native readers and introduces no competing reducer or Java dependency.&lt;/p&gt;
&lt;p&gt;The current &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/contracts/mission-status/schemas/MissionDetail.yaml&quot;&gt;MissionDetail display schema&lt;/a&gt; treats artifact presence as phase completion; &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/blob/main/contracts/mission-status/schemas/MissionHead.yaml&quot;&gt;MissionHead nextAction&lt;/a&gt; is provisional English prose. Those are display projections. Orchestrator completion requires substantive, committed, current content, resolved decisions and canonical gates. Their versioned mapping must retain this distinction. &lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/issues/5776&quot;&gt;#5776&lt;/a&gt; tracks unfinished drift, Ops and project-health additions.&lt;/p&gt;
&lt;h2 id=&quot;consequences-and-proof&quot;&gt;Consequences and proof&lt;/h2&gt;
&lt;p&gt;An external client can discover context, record interviews, create and read authored artifacts, finalize packages and drive native action completion using only the API. The black-box fixture initializes the project before the first call; it never writes mission artifacts or commits Git afterward. Both single-branch and coordination topologies are exercised. Refusal tests pair valid requests with stale parent/target/context, pending or terminal-unresolved interviews, placeholders, invalid graphs/requirements, forbidden paths and finalized edits. Existing external verbs remain compatible.&lt;/p&gt;
&lt;p&gt;Status contract integration is prepared and documented. The unfinished Java service and the broader #5532/#5631 port convergence remain separate tracked work; this PR does not claim to complete them.&lt;/p&gt;
&lt;p&gt;Completion validation reads the native persisted &lt;code dir=&quot;auto&quot;&gt;issued_step_id&lt;/code&gt; through the query service’s read-only context/index/snapshot seam. A pending input may name the upcoming design stage before its prompt is issued; answering that input is issuance, and cannot require completed stage artifacts. Missing live cursors fail closed.&lt;/p&gt;
&lt;h2 id=&quot;residuals&quot;&gt;Residuals&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;The stale and unfinished-content refusal runs only on the orchestrator-api &lt;code dir=&quot;auto&quot;&gt;next&lt;/code&gt; and finalize path. Native &lt;code dir=&quot;auto&quot;&gt;spec-kitty next --result success&lt;/code&gt; and the agent lifecycle commands do not run &lt;code dir=&quot;auto&quot;&gt;validate_stage&lt;/code&gt; for an API-authored Mission. Enforcing it natively is follow-up work.
&lt;ul&gt;
&lt;li&gt;Amendment 2026-10-13 (#5879): native &lt;code dir=&quot;auto&quot;&gt;spec-kitty next --result success&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;agent mission finalize-tasks&lt;/code&gt; now run the same refusal. Native &lt;code dir=&quot;auto&quot;&gt;next&lt;/code&gt; holds &lt;code dir=&quot;auto&quot;&gt;authoring_lock&lt;/code&gt; across the proof and the completion; native finalize runs inside &lt;code dir=&quot;auto&quot;&gt;finalization_scope&lt;/code&gt;. &lt;code dir=&quot;auto&quot;&gt;agent tasks finalize-tasks&lt;/code&gt; is not wrapped.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;authoring_lock&lt;/code&gt; is cooperative. Native status writes and native finalize-tasks do not take it, so &lt;code dir=&quot;auto&quot;&gt;require_unfinalized&lt;/code&gt; can race a native finalize.
&lt;ul&gt;
&lt;li&gt;Amendment 2026-10-13 (#5879): native finalize-tasks and native &lt;code dir=&quot;auto&quot;&gt;next&lt;/code&gt; completion now take the lock for an API-authored Mission. Native status writes (&lt;code dir=&quot;auto&quot;&gt;move-task&lt;/code&gt;) still do not.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
