@sublang/playbook 9.0.0 → 10.0.0

package/reference/sdlc/code.playbook/code.fsm.d.ts

@@ -122,6 +122,13 @@ export declare const codingMachine: import("xstate").StateMachine<CodingContext,
     logic: import("xstate").PromiseActorLogic<PlayerOutput, PlayerInput, import("xstate").EventObject>;
     id: string | undefined;
 }, {
+    type: "playbook.acceptedOutcome";
+    params: {
+        readonly source: string;
+        readonly target: string;
+        readonly acceptedOutcome: string;
+    };
+} | {
     type: "rememberActorError";
     params: import("xstate").NonReducibleUnknown;
 } | {

package/reference/sdlc/code.playbook/code.fsm.js

@@ -17,7 +17,6 @@ const FIRST_PHASE_PROMPT = [
     'Do not re-run tests or builds whose inputs have not changed since any previous reported run.',
     "Make the phase's minimal changes and then one new commit, following @specs/packages/git.md; never amend an existing commit.",
     'Make the commit message explain concisely what changed and why, including relevant verification.',
-    'Report it as exactly one final-response line beginning `Commit: `, followed only by the exact commit identity.',
     'Coder is <coder-llm>; format the model token in conventional human form.',
 ].join('\n');
 const IR_TASK_PROMPT = [
@@ -32,7 +31,6 @@ const IR_TASK_PROMPT = [
     'Do not re-run tests or builds whose inputs have not changed since any previous reported run.',
     "Make the phase's minimal changes and then one new commit, following @specs/packages/git.md; never amend an existing commit.",
     'Make the commit message explain concisely what changed and why, including relevant verification.',
-    'Report it as exactly one final-response line beginning `Commit: `, followed only by the exact commit identity.',
     'Coder is <coder-llm>; format the model token in conventional human form.',
 ].join('\n');
 const FIRST_PHASE_RESULTS = {
@@ -87,38 +85,28 @@ function outputString(event, field) {
     const value = playerOutput(event)?.[field];
     return isNonEmptyString(value) ? value : undefined;
 }
-function commitOutput(event) {
-    const coderOutput = outputString(event, 'coderOutput');
-    const latestCommit = outputString(event, 'latestCommit');
-    const commitLines = coderOutput
-        ?.split('\n')
-        .filter((line) => line.startsWith('Commit: '));
-    if (coderOutput === undefined ||
-        latestCommit === undefined ||
-        commitLines?.length !== 1 ||
-        commitLines[0] !== `Commit: ${latestCommit}`) {
-        return undefined;
-    }
-    return { coderOutput, latestCommit };
+function hasCommittedOutput(event) {
+    return (outputString(event, 'coderOutput') !== undefined &&
+        outputString(event, 'latestCommit') !== undefined);
 }
 function isDirectCommit({ event }) {
     return (outputGuard(event, 'directCommit') &&
-        commitOutput(event) !== undefined);
+        hasCommittedOutput(event));
 }
 function isIrCommit({ event }) {
     return (outputGuard(event, 'irCommit') &&
-        commitOutput(event) !== undefined &&
+        hasCommittedOutput(event) &&
         outputString(event, 'irNumber') !== undefined &&
         outputString(event, 'irTask') !== undefined);
 }
 function isMoreTasks({ event }) {
     return (outputGuard(event, 'moreTasks') &&
-        commitOutput(event) !== undefined &&
+        hasCommittedOutput(event) &&
         outputString(event, 'irTask') !== undefined);
 }
 function isFinalTask({ event }) {
     return (outputGuard(event, 'finalTask') &&
-        commitOutput(event) !== undefined);
+        hasCommittedOutput(event));
 }
 function needsBossReply({ event }) {
     return (outputGuard(event, 'needsBossReply') &&
@@ -321,6 +309,7 @@ const machineSetup = setup({
             (event.questionId === undefined || event.questionId === 'runIrTask'),
     },
     actions: {
+        'playbook.acceptedOutcome': (_args, _params) => undefined,
         startCoding: assign(({ context, event }) => {
             if (event.type !== 'START_CODE')
                 return {};
@@ -487,17 +476,47 @@ export const codingMachine = machineSetup.createMachine({
                     {
                         guard: 'isDirectCommit',
                         target: 'reviewFirstCommit',
-                        actions: 'rememberDirectCommit',
+                        actions: [
+                            {
+                                type: 'playbook.acceptedOutcome',
+                                params: {
+                                    source: 'runFirstPhase',
+                                    target: 'reviewFirstCommit',
+                                    acceptedOutcome: 'directCommit',
+                                },
+                            },
+                            'rememberDirectCommit',
+                        ],
                     },
                     {
                         guard: 'isIrCommit',
                         target: 'reviewFirstCommit',
-                        actions: 'rememberIrCommit',
+                        actions: [
+                            {
+                                type: 'playbook.acceptedOutcome',
+                                params: {
+                                    source: 'runFirstPhase',
+                                    target: 'reviewFirstCommit',
+                                    acceptedOutcome: 'irCommit',
+                                },
+                            },
+                            'rememberIrCommit',
+                        ],
                     },
                     {
                         guard: 'needsBossReply',
                         target: 'awaitBossReply',
-                        actions: 'rememberPendingQuestion',
+                        actions: [
+                            {
+                                type: 'playbook.acceptedOutcome',
+                                params: {
+                                    source: 'runFirstPhase',
+                                    target: 'awaitBossReply',
+                                    acceptedOutcome: 'needsBossReply',
+                                },
+                            },
+                            'rememberPendingQuestion',
+                        ],
                     },
                     {
                         target: 'failed',
@@ -575,17 +594,47 @@ export const codingMachine = machineSetup.createMachine({
                     {
                         guard: 'isMoreTasks',
                         target: 'reviewIrTask',
-                        actions: 'rememberMoreTasks',
+                        actions: [
+                            {
+                                type: 'playbook.acceptedOutcome',
+                                params: {
+                                    source: 'runIrTask',
+                                    target: 'reviewIrTask',
+                                    acceptedOutcome: 'moreTasks',
+                                },
+                            },
+                            'rememberMoreTasks',
+                        ],
                     },
                     {
                         guard: 'isFinalTask',
                         target: 'reviewIrTask',
-                        actions: 'rememberFinalTask',
+                        actions: [
+                            {
+                                type: 'playbook.acceptedOutcome',
+                                params: {
+                                    source: 'runIrTask',
+                                    target: 'reviewIrTask',
+                                    acceptedOutcome: 'finalTask',
+                                },
+                            },
+                            'rememberFinalTask',
+                        ],
                     },
                     {
                         guard: 'needsBossReply',
                         target: 'awaitBossReply',
-                        actions: 'rememberPendingQuestion',
+                        actions: [
+                            {
+                                type: 'playbook.acceptedOutcome',
+                                params: {
+                                    source: 'runIrTask',
+                                    target: 'awaitBossReply',
+                                    acceptedOutcome: 'needsBossReply',
+                                },
+                            },
+                            'rememberPendingQuestion',
+                        ],
                     },
                     {
                         target: 'failed',

package/reference/sdlc/code.playbook/code.fsm.ts

@@ -154,7 +154,6 @@ const FIRST_PHASE_PROMPT = [
   'Do not re-run tests or builds whose inputs have not changed since any previous reported run.',
   "Make the phase's minimal changes and then one new commit, following @specs/packages/git.md; never amend an existing commit.",
   'Make the commit message explain concisely what changed and why, including relevant verification.',
-  'Report it as exactly one final-response line beginning `Commit: `, followed only by the exact commit identity.',
   'Coder is <coder-llm>; format the model token in conventional human form.',
 ].join('\n');
 
@@ -170,7 +169,6 @@ const IR_TASK_PROMPT = [
   'Do not re-run tests or builds whose inputs have not changed since any previous reported run.',
   "Make the phase's minimal changes and then one new commit, following @specs/packages/git.md; never amend an existing commit.",
   'Make the commit message explain concisely what changed and why, including relevant verification.',
-  'Report it as exactly one final-response line beginning `Commit: `, followed only by the exact commit identity.',
   'Coder is <coder-llm>; format the model token in conventional human form.',
 ].join('\n');
 
@@ -246,36 +244,24 @@ function outputString(event: unknown, field: string): string | undefined {
   return isNonEmptyString(value) ? value : undefined;
 }
 
-function commitOutput(
-  event: unknown,
-): { readonly coderOutput: string; readonly latestCommit: string } | undefined {
-  const coderOutput = outputString(event, 'coderOutput');
-  const latestCommit = outputString(event, 'latestCommit');
-  const commitLines = coderOutput
-    ?.split('\n')
-    .filter((line) => line.startsWith('Commit: '));
-  if (
-    coderOutput === undefined ||
-    latestCommit === undefined ||
-    commitLines?.length !== 1 ||
-    commitLines[0] !== `Commit: ${latestCommit}`
-  ) {
-    return undefined;
-  }
-  return { coderOutput, latestCommit };
+function hasCommittedOutput(event: unknown): boolean {
+  return (
+    outputString(event, 'coderOutput') !== undefined &&
+    outputString(event, 'latestCommit') !== undefined
+  );
 }
 
 function isDirectCommit({ event }: { event: unknown }): boolean {
   return (
     outputGuard(event, 'directCommit') &&
-    commitOutput(event) !== undefined
+    hasCommittedOutput(event)
   );
 }
 
 function isIrCommit({ event }: { event: unknown }): boolean {
   return (
     outputGuard(event, 'irCommit') &&
-    commitOutput(event) !== undefined &&
+    hasCommittedOutput(event) &&
     outputString(event, 'irNumber') !== undefined &&
     outputString(event, 'irTask') !== undefined
   );
@@ -284,7 +270,7 @@ function isIrCommit({ event }: { event: unknown }): boolean {
 function isMoreTasks({ event }: { event: unknown }): boolean {
   return (
     outputGuard(event, 'moreTasks') &&
-    commitOutput(event) !== undefined &&
+    hasCommittedOutput(event) &&
     outputString(event, 'irTask') !== undefined
   );
 }
@@ -292,7 +278,7 @@ function isMoreTasks({ event }: { event: unknown }): boolean {
 function isFinalTask({ event }: { event: unknown }): boolean {
   return (
     outputGuard(event, 'finalTask') &&
-    commitOutput(event) !== undefined
+    hasCommittedOutput(event)
   );
 }
 
@@ -553,6 +539,14 @@ const machineSetup = setup({
       (event.questionId === undefined || event.questionId === 'runIrTask'),
   },
   actions: {
+    'playbook.acceptedOutcome': (
+      _args,
+      _params: {
+        readonly source: string;
+        readonly target: string;
+        readonly acceptedOutcome: string;
+      },
+    ) => undefined,
     startCoding: assign(({ context, event }) => {
       if (event.type !== 'START_CODE') return {};
       return {
@@ -726,17 +720,47 @@ export const codingMachine = machineSetup.createMachine({
           {
             guard: 'isDirectCommit',
             target: 'reviewFirstCommit',
-            actions: 'rememberDirectCommit',
+            actions: [
+              {
+                type: 'playbook.acceptedOutcome',
+                params: {
+                  source: 'runFirstPhase',
+                  target: 'reviewFirstCommit',
+                  acceptedOutcome: 'directCommit',
+                },
+              },
+              'rememberDirectCommit',
+            ],
           },
           {
             guard: 'isIrCommit',
             target: 'reviewFirstCommit',
-            actions: 'rememberIrCommit',
+            actions: [
+              {
+                type: 'playbook.acceptedOutcome',
+                params: {
+                  source: 'runFirstPhase',
+                  target: 'reviewFirstCommit',
+                  acceptedOutcome: 'irCommit',
+                },
+              },
+              'rememberIrCommit',
+            ],
           },
           {
             guard: 'needsBossReply',
             target: 'awaitBossReply',
-            actions: 'rememberPendingQuestion',
+            actions: [
+              {
+                type: 'playbook.acceptedOutcome',
+                params: {
+                  source: 'runFirstPhase',
+                  target: 'awaitBossReply',
+                  acceptedOutcome: 'needsBossReply',
+                },
+              },
+              'rememberPendingQuestion',
+            ],
           },
           {
             target: 'failed',
@@ -814,17 +838,47 @@ export const codingMachine = machineSetup.createMachine({
           {
             guard: 'isMoreTasks',
             target: 'reviewIrTask',
-            actions: 'rememberMoreTasks',
+            actions: [
+              {
+                type: 'playbook.acceptedOutcome',
+                params: {
+                  source: 'runIrTask',
+                  target: 'reviewIrTask',
+                  acceptedOutcome: 'moreTasks',
+                },
+              },
+              'rememberMoreTasks',
+            ],
           },
           {
             guard: 'isFinalTask',
             target: 'reviewIrTask',
-            actions: 'rememberFinalTask',
+            actions: [
+              {
+                type: 'playbook.acceptedOutcome',
+                params: {
+                  source: 'runIrTask',
+                  target: 'reviewIrTask',
+                  acceptedOutcome: 'finalTask',
+                },
+              },
+              'rememberFinalTask',
+            ],
           },
           {
             guard: 'needsBossReply',
             target: 'awaitBossReply',
-            actions: 'rememberPendingQuestion',
+            actions: [
+              {
+                type: 'playbook.acceptedOutcome',
+                params: {
+                  source: 'runIrTask',
+                  target: 'awaitBossReply',
+                  acceptedOutcome: 'needsBossReply',
+                },
+              },
+              'rememberPendingQuestion',
+            ],
           },
           {
             target: 'failed',

package/reference/sdlc/code.playbook/code.gears.md

@@ -26,7 +26,6 @@ When the first coding phase begins, Captain shall prompt Coder:
 > Do not re-run tests or builds whose inputs have not changed since any previous reported run.
 > Make the phase's minimal changes and then one new commit, following @specs/packages/git.md; never amend an existing commit.
 > Make the commit message explain concisely what changed and why, including relevant verification.
-> Report it as exactly one final-response line beginning `Commit: `, followed only by the exact commit identity.
 > Coder is <coder-llm>; format the model token in conventional human form.
 
 Results:
@@ -61,7 +60,6 @@ When a reviewed IR has a next unfinished task, Captain shall prompt Coder:
 > Do not re-run tests or builds whose inputs have not changed since any previous reported run.
 > Make the phase's minimal changes and then one new commit, following @specs/packages/git.md; never amend an existing commit.
 > Make the commit message explain concisely what changed and why, including relevant verification.
-> Report it as exactly one final-response line beginning `Commit: `, followed only by the exact commit identity.
 > Coder is <coder-llm>; format the model token in conventional human form.
 
 Results:

package/reference/sdlc/code.playbook/code.playbook.d.ts

@@ -1,8 +1,10 @@
-import { type XStatePromptIdentity } from '@sublang/playbook/xstate-runtime';
+import { type XStatePlaybookRuntimeFactory, type XStatePlaybookRuntimeConstruction, type XStatePromptIdentity } from '@sublang/playbook/xstate-runtime';
 import { type CodingInput, type PlayerInput } from './code.fsm.js';
+import type { PlaybookHostConstructionCapabilities } from './playbook-captain.js';
 import type { CaptainCallOptions, CaptainResult, JsonValue, NormalizedError, PlayerCallOptions, PlaybookCallRequest, PlaybookCallResult, PlaybookCallStart, PlaybookControlReceipt, PlaybookControlView, PlaybookPendingCall, PlaybookPorts, PlaybookRunResult, PlaybookRuntime, PlaybookRuntimeFactory, PlaybookRuntimeSnapshot, PlaybookSession, PlaybookState, PlaybookStateValue, PlaybookTraceEvent, PlaybookTraceType, PlayerResult, PlayerSessionStore } from '@sublang/playbook/runtime';
 export type { CaptainCallOptions, CaptainResult, JsonValue, NormalizedError, PlayerCallOptions, PlaybookCallRequest, PlaybookCallResult, PlaybookCallStart, PlaybookControlReceipt, PlaybookControlView, PlaybookPendingCall, PlaybookPorts, PlaybookRunResult, PlaybookRuntime, PlaybookRuntimeFactory, PlaybookRuntimeSnapshot, PlaybookSession, PlaybookState, PlaybookStateValue, PlaybookTraceEvent, PlaybookTraceType, PlayerResult, PlayerSessionStore, };
 export type CodePlaybookOptions = CodingInput;
+export type CodePlaybookHostCapabilities = PlaybookHostConstructionCapabilities & XStatePlaybookRuntimeConstruction<CodePlaybookOptions, object>['hostCapabilities'];
 /**
  * Preserve authored Markdown quote markers around every line of relayed
  * runtime text. The generic composer preserves the marker itself; CODE's
@@ -12,6 +14,7 @@ declare function composePlayerPrompt(input: PlayerInput, promptIdentity: XStateP
 export declare const _internal: {
     composePlayerPrompt: typeof composePlayerPrompt;
     VERBATIM_PAYLOAD_FIELDS: ReadonlySet<string>;
+    UNFINISHED_FINAL_STATE_IDS: ReadonlySet<string>;
 };
-declare const createPlaybookRuntime: PlaybookRuntimeFactory<CodePlaybookOptions>;
+declare const createPlaybookRuntime: XStatePlaybookRuntimeFactory<XStatePlaybookRuntimeConstruction<CodePlaybookOptions, CodePlaybookHostCapabilities>, 3>;
 export default createPlaybookRuntime;

package/reference/sdlc/code.playbook/code.playbook.js

@@ -8,7 +8,7 @@
 //                callerInput; pending Coder questions retain BOSS_REPLY
 // Adjudication:  LLM judge per player state; coderOutput is carried verbatim
 // Nested call:   literal review target through the shared bridge
-// Compat:        artifact schema 2 / runtime ABI 1
+// Compat:        artifact schema 3 / runtime ABI 1
 import { createXStatePlaybookRuntime, snapshotJsonValue, } from '@sublang/playbook/xstate-runtime';
 import { codingMachine, } from './code.fsm.js';
 const OPTION_KEYS = new Set(['runResults']);
@@ -17,6 +17,9 @@ const CONTINUATION_PREAMBLE = 'You previously paused this task to ask Boss a que
 const VERBATIM_PAYLOAD_FIELDS = new Set([
     'coderOutput',
 ]);
+const UNFINISHED_FINAL_STATE_IDS = new Set([
+    'reportedReviewFailure',
+]);
 function snapshotCodeOptions(value) {
     const captured = snapshotJsonValue(value, 'CODE runtime options');
     if (captured === null ||
@@ -78,6 +81,7 @@ function composePlayerPrompt(input, promptIdentity) {
 export const _internal = {
     composePlayerPrompt,
     VERBATIM_PAYLOAD_FIELDS,
+    UNFINISHED_FINAL_STATE_IDS,
 };
 const runtimeSpec = {
     label: 'CODE',
@@ -85,7 +89,7 @@ const runtimeSpec = {
     // time — a literal, never the loading engine's RUNTIME_ABI self-report,
     // which would follow whatever engine loads the module and make the
     // factory's skew check compare that engine with itself.
-    compat: { artifactSchema: 2, runtimeAbi: 1 },
+    compat: { artifactSchema: 3, runtimeAbi: 1 },
     snapshotOptions: snapshotCodeOptions,
     entryEvent: {
         type: 'START_CODE',
@@ -105,9 +109,57 @@ const runtimeSpec = {
             label: 'Coder is implementing exactly one unfinished intent-record task.',
         },
     },
+    outcomeAuthority: {
+        governedPlayerStates: {
+            runFirstPhase: {
+                directCommit: {
+                    fields: {
+                        coderOutput: 'presentation',
+                        latestCommit: 'effect',
+                    },
+                    repositoryDisposition: 'one-descendant-commit',
+                },
+                irCommit: {
+                    fields: {
+                        coderOutput: 'presentation',
+                        latestCommit: 'effect',
+                        irNumber: 'semantic',
+                        irTask: 'semantic',
+                    },
+                    repositoryDisposition: 'one-descendant-commit',
+                },
+                needsBossReply: {
+                    fields: { question: 'presentation' },
+                    repositoryDisposition: 'deferred',
+                },
+            },
+            runIrTask: {
+                moreTasks: {
+                    fields: {
+                        coderOutput: 'presentation',
+                        latestCommit: 'effect',
+                        irTask: 'semantic',
+                    },
+                    repositoryDisposition: 'one-descendant-commit',
+                },
+                finalTask: {
+                    fields: {
+                        coderOutput: 'presentation',
+                        latestCommit: 'effect',
+                    },
+                    repositoryDisposition: 'one-descendant-commit',
+                },
+                needsBossReply: {
+                    fields: { question: 'presentation' },
+                    repositoryDisposition: 'deferred',
+                },
+            },
+        },
+    },
     composePlayerPrompt: (input, promptIdentity) => composePlayerPrompt(input, promptIdentity),
     verbatimPayloadFields: VERBATIM_PAYLOAD_FIELDS,
     controlContextFields: ['phase'],
+    unfinishedFinalStateIds: UNFINISHED_FINAL_STATE_IDS,
     transitionEventFields: ['callerInput', 'answer', 'questionId'],
 };
 const createPlaybookRuntime = createXStatePlaybookRuntime(codingMachine, runtimeSpec);

package/reference/sdlc/code.playbook/code.playbook.ts

@@ -8,20 +8,23 @@
 //                callerInput; pending Coder questions retain BOSS_REPLY
 // Adjudication:  LLM judge per player state; coderOutput is carried verbatim
 // Nested call:   literal review target through the shared bridge
-// Compat:        artifact schema 2 / runtime ABI 1
+// Compat:        artifact schema 3 / runtime ABI 1
 
 import {
   createXStatePlaybookRuntime,
   snapshotJsonValue,
   type PlaybookPlayerInput,
+  type XStatePlaybookRuntimeFactory,
+  type XStatePlaybookRuntimeConstruction,
   type XStatePromptIdentity,
-  type XStatePlaybookRuntimeSpec,
+  type XStatePlaybookRuntimeSpecV3,
 } from '@sublang/playbook/xstate-runtime';
 import {
   codingMachine,
   type CodingInput,
   type PlayerInput,
 } from './code.fsm.js';
+import type { PlaybookHostConstructionCapabilities } from './playbook-captain.js';
 import type {
   CaptainCallOptions,
   CaptainResult,
@@ -75,6 +78,9 @@ export type {
 };
 
 export type CodePlaybookOptions = CodingInput;
+export type CodePlaybookHostCapabilities =
+  PlaybookHostConstructionCapabilities &
+    XStatePlaybookRuntimeConstruction<CodePlaybookOptions, object>['hostCapabilities'];
 
 const OPTION_KEYS = new Set(['runResults']);
 const PLACEHOLDER = /<(#|[A-Za-z_$][A-Za-z0-9_$-]*)>/g;
@@ -84,6 +90,9 @@ const CONTINUATION_PREAMBLE =
 const VERBATIM_PAYLOAD_FIELDS: ReadonlySet<string> = new Set([
   'coderOutput',
 ]);
+const UNFINISHED_FINAL_STATE_IDS: ReadonlySet<string> = new Set([
+  'reportedReviewFailure',
+]);
 
 function snapshotCodeOptions(value: unknown): CodePlaybookOptions {
   const captured = snapshotJsonValue(value, 'CODE runtime options');
@@ -163,6 +172,7 @@ function composePlayerPrompt(
 export const _internal = {
   composePlayerPrompt,
   VERBATIM_PAYLOAD_FIELDS,
+  UNFINISHED_FINAL_STATE_IDS,
 };
 
 const runtimeSpec = {
@@ -171,7 +181,7 @@ const runtimeSpec = {
   // time — a literal, never the loading engine's RUNTIME_ABI self-report,
   // which would follow whatever engine loads the module and make the
   // factory's skew check compare that engine with itself.
-  compat: { artifactSchema: 2, runtimeAbi: 1 },
+  compat: { artifactSchema: 3, runtimeAbi: 1 },
   snapshotOptions: snapshotCodeOptions,
   entryEvent: {
     type: 'START_CODE',
@@ -192,16 +202,75 @@ const runtimeSpec = {
       label: 'Coder is implementing exactly one unfinished intent-record task.',
     },
   },
+  outcomeAuthority: {
+    governedPlayerStates: {
+      runFirstPhase: {
+        directCommit: {
+          fields: {
+            coderOutput: 'presentation',
+            latestCommit: 'effect',
+          },
+          repositoryDisposition: 'one-descendant-commit',
+        },
+        irCommit: {
+          fields: {
+            coderOutput: 'presentation',
+            latestCommit: 'effect',
+            irNumber: 'semantic',
+            irTask: 'semantic',
+          },
+          repositoryDisposition: 'one-descendant-commit',
+        },
+        needsBossReply: {
+          fields: { question: 'presentation' },
+          repositoryDisposition: 'deferred',
+        },
+      },
+      runIrTask: {
+        moreTasks: {
+          fields: {
+            coderOutput: 'presentation',
+            latestCommit: 'effect',
+            irTask: 'semantic',
+          },
+          repositoryDisposition: 'one-descendant-commit',
+        },
+        finalTask: {
+          fields: {
+            coderOutput: 'presentation',
+            latestCommit: 'effect',
+          },
+          repositoryDisposition: 'one-descendant-commit',
+        },
+        needsBossReply: {
+          fields: { question: 'presentation' },
+          repositoryDisposition: 'deferred',
+        },
+      },
+    },
+  },
   composePlayerPrompt: (
     input: PlaybookPlayerInput,
     promptIdentity: XStatePromptIdentity,
   ) => composePlayerPrompt(input as PlayerInput, promptIdentity),
   verbatimPayloadFields: VERBATIM_PAYLOAD_FIELDS,
   controlContextFields: ['phase'],
+  unfinishedFinalStateIds: UNFINISHED_FINAL_STATE_IDS,
   transitionEventFields: ['callerInput', 'answer', 'questionId'],
-} satisfies XStatePlaybookRuntimeSpec<CodePlaybookOptions>;
+} satisfies XStatePlaybookRuntimeSpecV3<CodePlaybookOptions>;
 
-const createPlaybookRuntime: PlaybookRuntimeFactory<CodePlaybookOptions> =
-  createXStatePlaybookRuntime(codingMachine, runtimeSpec);
+const createPlaybookRuntime: XStatePlaybookRuntimeFactory<
+  XStatePlaybookRuntimeConstruction<
+    CodePlaybookOptions,
+    CodePlaybookHostCapabilities
+  >,
+  3
+> = createXStatePlaybookRuntime<
+  CodePlaybookOptions,
+  CodePlaybookHostCapabilities
+>(
+  codingMachine,
+  runtimeSpec,
+);
 
 export default createPlaybookRuntime;

package/reference/sdlc/code.playbook/code.registry.d.ts

@@ -1,4 +1,4 @@
-import { type PlaybookRuntime } from './code.playbook.js';
+import { type CodePlaybookHostCapabilities, type PlaybookRuntime } from './code.playbook.js';
 export interface PlaybookSummaryPolicy {
     stateCountLabels: Readonly<Record<string, string>>;
     copyPasteGuardNames: readonly string[];
@@ -12,12 +12,19 @@ export interface CodePlaybookRegistryEntry {
     id: 'code';
     command: 'code';
     intent: string;
-    artifactSchema: 2;
+    artifactSchema: 3;
+    runtimeProfile: {
+        readonly kind: 'shared-factory';
+        readonly compat: {
+            readonly artifactSchema: 3;
+            readonly runtimeAbi: number;
+        };
+    };
     requiredRoleIds: readonly ['coder'];
     concurrentRoleSets: readonly [];
     summaryPolicy: PlaybookSummaryPolicy;
     validateOptions(optionSlice: unknown): CodeOptions;
-    createRuntime(options: CodeOptions): PlaybookRuntime;
+    createRuntime(options: CodeOptions, hostCapabilities: CodePlaybookHostCapabilities): PlaybookRuntime;
 }
 export declare const codeStateCountLabels: {};
 export declare const codeCopyPasteGuardNames: readonly ["directCommit", "irCommit", "moreTasks", "finalTask"];