@sublang/playbook 8.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;
 } | {
@@ -202,7 +209,7 @@ export declare const codingMachine: import("xstate").StateMachine<CodingContext,
 } | {
     type: "resumesIrTask";
     params: unknown;
-}, never, "done" | "failed" | "awaitBossReply" | "ready" | "runFirstPhase" | "reviewFirstCommit" | "runIrTask" | "reviewIrTask", string, CodingInput, {
+}, never, "done" | "failed" | "awaitBossReply" | "ready" | "runFirstPhase" | "reviewFirstCommit" | "runIrTask" | "reviewIrTask" | "reportedReviewFailure", string, CodingInput, {
     readonly status: "complete";
     /** Exact identity of the latest CODE-owned commit. */
     readonly lastCodeCommit: string;
@@ -239,6 +246,9 @@ export declare const codingMachine: import("xstate").StateMachine<CodingContext,
         readonly failed: {
             id: "failed";
         };
+        readonly reportedReviewFailure: {
+            id: "reportedReviewFailure";
+        };
         readonly done: {
             id: "done";
         };

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 = {
@@ -53,6 +51,7 @@ const STATE_DESCRIPTIONS = {
     reviewIrTask: 'The REVIEW playbook is checking the latest task commit.',
     awaitBossReply: 'Waiting for Boss to answer Coder.',
     failed: 'The coding workflow failed and is waiting for a new coding intent.',
+    reportedReviewFailure: 'The coding workflow reported a REVIEW failure and the last code-owned commit.',
     done: 'The coding workflow completed after REVIEW found no unsettled findings.',
 };
 function playbookMeta(stateId, role) {
@@ -86,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') &&
@@ -320,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 {};
@@ -486,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',
@@ -530,14 +550,14 @@ export const codingMachine = machineSetup.createMachine({
                         target: 'runIrTask',
                     },
                     {
-                        target: 'done',
+                        target: 'reportedReviewFailure',
                         actions: 'completeWithInvalidReviewOutput',
                     },
                 ],
                 onError: [
                     {
                         guard: 'authoredReviewFailure',
-                        target: 'done',
+                        target: 'reportedReviewFailure',
                         actions: 'completeWithReviewFailure',
                     },
                     { target: 'failed', actions: 'rememberActorError' },
@@ -574,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',
@@ -619,14 +669,14 @@ export const codingMachine = machineSetup.createMachine({
                         actions: 'completeSuccessfully',
                     },
                     {
-                        target: 'done',
+                        target: 'reportedReviewFailure',
                         actions: 'completeWithInvalidReviewOutput',
                     },
                 ],
                 onError: [
                     {
                         guard: 'authoredReviewFailure',
-                        target: 'done',
+                        target: 'reportedReviewFailure',
                         actions: 'completeWithReviewFailure',
                     },
                     { target: 'failed', actions: 'rememberActorError' },
@@ -670,6 +720,12 @@ export const codingMachine = machineSetup.createMachine({
                 START_CODE: { target: 'runFirstPhase', actions: 'startCoding' },
             },
         },
+        reportedReviewFailure: {
+            id: 'reportedReviewFailure',
+            description: STATE_DESCRIPTIONS.reportedReviewFailure,
+            meta: playbookMeta('reportedReviewFailure'),
+            type: 'final',
+        },
         done: {
             id: 'done',
             description: STATE_DESCRIPTIONS.done,

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');
 
@@ -202,6 +200,8 @@ const STATE_DESCRIPTIONS = {
   reviewIrTask: 'The REVIEW playbook is checking the latest task commit.',
   awaitBossReply: 'Waiting for Boss to answer Coder.',
   failed: 'The coding workflow failed and is waiting for a new coding intent.',
+  reportedReviewFailure:
+    'The coding workflow reported a REVIEW failure and the last code-owned commit.',
   done: 'The coding workflow completed after REVIEW found no unsettled findings.',
 } as const;
 
@@ -244,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
   );
@@ -282,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
   );
 }
@@ -290,7 +278,7 @@ function isMoreTasks({ event }: { event: unknown }): boolean {
 function isFinalTask({ event }: { event: unknown }): boolean {
   return (
     outputGuard(event, 'finalTask') &&
-    commitOutput(event) !== undefined
+    hasCommittedOutput(event)
   );
 }
 
@@ -551,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 {
@@ -724,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',
@@ -768,14 +794,14 @@ export const codingMachine = machineSetup.createMachine({
             target: 'runIrTask',
           },
           {
-            target: 'done',
+            target: 'reportedReviewFailure',
             actions: 'completeWithInvalidReviewOutput',
           },
         ],
         onError: [
           {
             guard: 'authoredReviewFailure',
-            target: 'done',
+            target: 'reportedReviewFailure',
             actions: 'completeWithReviewFailure',
           },
           { target: 'failed', actions: 'rememberActorError' },
@@ -812,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',
@@ -857,14 +913,14 @@ export const codingMachine = machineSetup.createMachine({
             actions: 'completeSuccessfully',
           },
           {
-            target: 'done',
+            target: 'reportedReviewFailure',
             actions: 'completeWithInvalidReviewOutput',
           },
         ],
         onError: [
           {
             guard: 'authoredReviewFailure',
-            target: 'done',
+            target: 'reportedReviewFailure',
             actions: 'completeWithReviewFailure',
           },
           { target: 'failed', actions: 'rememberActorError' },
@@ -908,6 +964,12 @@ export const codingMachine = machineSetup.createMachine({
         START_CODE: { target: 'runFirstPhase', actions: 'startCoding' },
       },
     },
+    reportedReviewFailure: {
+      id: 'reportedReviewFailure',
+      description: STATE_DESCRIPTIONS.reportedReviewFailure,
+      meta: playbookMeta('reportedReviewFailure'),
+      type: 'final',
+    },
     done: {
       id: 'done',
       description: STATE_DESCRIPTIONS.done,

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,8 +8,8 @@
 //                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
-import { RUNTIME_ABI, createXStatePlaybookRuntime, snapshotJsonValue, } from '@sublang/playbook/xstate-runtime';
+// 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']);
 const PLACEHOLDER = /<(#|[A-Za-z_$][A-Za-z0-9_$-]*)>/g;
@@ -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,12 +81,24 @@ function composePlayerPrompt(input, promptIdentity) {
 export const _internal = {
     composePlayerPrompt,
     VERBATIM_PAYLOAD_FIELDS,
+    UNFINISHED_FINAL_STATE_IDS,
 };
 const runtimeSpec = {
     label: 'CODE',
-    compat: { artifactSchema: 2, runtimeAbi: RUNTIME_ABI },
+    // DR-022 / slc/link.md: the declaration carries the value current at link
+    // 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: 3, runtimeAbi: 1 },
     snapshotOptions: snapshotCodeOptions,
-    entryEvent: { type: 'START_CODE', textField: 'callerInput' },
+    entryEvent: {
+        type: 'START_CODE',
+        textField: 'callerInput',
+        // `startCoding` copies the entry text here, so the failure-state retry
+        // reads it back from the persisted machine snapshot and survives a
+        // continued session (DR-034).
+        contextField: 'callerInput',
+    },
     roleStates: {
         runFirstPhase: {
             role: 'coder',
@@ -94,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);