@sublang/playbook 0.9.0 → 1.3.0

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

@@ -6,13 +6,14 @@ type ReviewSubject = 'commit' | 'changes';
 type AfterReview = 'continueIr' | 'summarizeSpecs' | 'done';
 type ResumableStateId = Exclude<JumpableStateId, 'ready' | 'failed'>;
 type PendingBossQuestion = {
+    questionId: ResumableStateId;
     resumeStateId: ResumableStateId;
     sourceItem: string;
     player: Player;
     question: string;
 };
 export type CaptainInput = {
-    player: Player;
+    stateId: ResumableStateId;
     sourceItem: string;
     prompt: string;
     result: Record<string, string>;
@@ -27,6 +28,9 @@ export type CaptainInput = {
     pendingBossQuestion?: PendingBossQuestion;
     bossReply?: string;
 };
+export type PlayerInput = CaptainInput & {
+    player: Player;
+};
 export type CaptainOutput = {
     guard: string;
     irNumber?: string;
@@ -37,6 +41,7 @@ export type CaptainOutput = {
     question?: string;
     [k: string]: unknown;
 };
+export type PlayerOutput = CaptainOutput;
 export type CodingInput = {
     intent?: string;
     irNumber?: string;
@@ -74,6 +79,7 @@ export type CodingEvent = {
 } | {
     type: 'BOSS_REPLY';
     answer: string;
+    questionId?: ResumableStateId;
 };
 export declare const codingMachine: import("xstate").StateMachine<CodingContext, {
     type: "START_CODING";
@@ -92,11 +98,12 @@ export declare const codingMachine: import("xstate").StateMachine<CodingContext,
 } | {
     type: "BOSS_REPLY";
     answer: string;
+    questionId?: ResumableStateId;
 }, {
-    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<CaptainOutput, CaptainInput, import("xstate").EventObject>> | undefined;
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<CaptainOutput, PlayerInput, import("xstate").EventObject>> | undefined;
 }, {
-    src: "captain";
-    logic: import("xstate").PromiseActorLogic<CaptainOutput, CaptainInput, import("xstate").EventObject>;
+    src: "player";
+    logic: import("xstate").PromiseActorLogic<CaptainOutput, PlayerInput, import("xstate").EventObject>;
     id: string | undefined;
 }, never, never, never, {}, string, CodingInput, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
     states?: {} | undefined;

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

@@ -1,8 +1,8 @@
-import type { CaptainInput, CodingContext, codingMachine } from './code.fsm.js';
+import type { CodingContext, PlayerInput, codingMachine } from './code.fsm.js';
 export interface CaptainStateInfo {
     readonly stateId: string;
     readonly sourceItem: string;
-    readonly getInput: (context: Partial<CodingContext>) => CaptainInput;
+    readonly getInput: (context: Partial<CodingContext>) => PlayerInput;
     readonly transitions: ReadonlyArray<CaptainTransition>;
 }
 export interface CaptainTransition {

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

@@ -5,7 +5,7 @@ export function enumerateCaptainStates(machine) {
     const out = [];
     for (const [stateId, def] of Object.entries(states)) {
         const invoke = def.invoke;
-        if (!invoke || invoke.src !== 'captain' || typeof invoke.input !== 'function') {
+        if (!invoke || invoke.src !== 'player' || typeof invoke.input !== 'function') {
             continue;
         }
         const inputFn = invoke.input;

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

@@ -7,19 +7,19 @@
 // Tasks 3–5. Reaching into `machine.config` is internal but stable
 // in xstate v5: it preserves the literal `createMachine` argument,
 // so `invoke.input` is still the original `({ context }) =>
-// CaptainInput` function and `invoke.onDone` is still the per-arm
+// PlayerInput` function and `invoke.onDone` is still the per-arm
 // array with `guard` / `target` / `actions` keys.
 
 import type {
-  CaptainInput,
   CodingContext,
+  PlayerInput,
   codingMachine,
 } from './code.fsm.js';
 
 export interface CaptainStateInfo {
   readonly stateId: string;
   readonly sourceItem: string;
-  readonly getInput: (context: Partial<CodingContext>) => CaptainInput;
+  readonly getInput: (context: Partial<CodingContext>) => PlayerInput;
   readonly transitions: ReadonlyArray<CaptainTransition>;
 }
 
@@ -76,7 +76,7 @@ export interface RootEventTable {
 
 type RawInvoke = {
   src?: unknown;
-  input?: (args: { context: Partial<CodingContext> }) => CaptainInput;
+  input?: (args: { context: Partial<CodingContext> }) => PlayerInput;
   onDone?: unknown;
 };
 
@@ -101,11 +101,11 @@ export function enumerateCaptainStates(
   const out: CaptainStateInfo[] = [];
   for (const [stateId, def] of Object.entries(states)) {
     const invoke = def.invoke;
-    if (!invoke || invoke.src !== 'captain' || typeof invoke.input !== 'function') {
+    if (!invoke || invoke.src !== 'player' || typeof invoke.input !== 'function') {
       continue;
     }
     const inputFn = invoke.input;
-    const getInput = (context: Partial<CodingContext>): CaptainInput =>
+    const getInput = (context: Partial<CodingContext>): PlayerInput =>
       inputFn({ context });
     const probe = getInput({});
     const transitions = toArmArray(invoke.onDone).map(