@sublang/playbook 0.1.3 → 0.4.0

package/{code.fsm.introspect.ts → reference/sdlc/code.playbook/code.fsm.introspect.ts}

@@ -34,6 +34,28 @@ export interface CaptainTransition {
   readonly index: number;
   readonly target: string;
   readonly guard: TransitionGuard;
+  readonly actions: unknown;
+}
+
+export interface AwaitBossReplyInfo {
+  readonly stateId: string;
+  readonly bossReplyTransitions: ReadonlyArray<BossReplyTransition>;
+  readonly transitions: ReadonlyArray<AwaitBossReplyTransition>;
+}
+
+export interface BossReplyTransition {
+  readonly index: number;
+  readonly target: string;
+  readonly guard: TransitionGuard;
+  readonly actions: unknown;
+}
+
+export interface AwaitBossReplyTransition {
+  readonly eventType: string;
+  readonly index: number;
+  readonly target: string;
+  readonly guard: TransitionGuard;
+  readonly actions: unknown;
 }
 
 export type TransitionGuard = (args: {
@@ -46,6 +68,10 @@ export interface RootEventTable {
   readonly continueIr: { readonly target: string };
   readonly summarizeIr: { readonly target: string };
   readonly bossInterruptTargets: ReadonlyArray<string>;
+  readonly bossInterruptTargetDescriptions: ReadonlyArray<{
+    readonly stateId: string;
+    readonly description: string;
+  }>;
 }
 
 type RawInvoke = {
@@ -54,9 +80,14 @@ type RawInvoke = {
   onDone?: unknown;
 };
 
-type RawStateDef = { invoke?: RawInvoke; on?: Record<string, unknown> };
+type RawStateDef = {
+  description?: unknown;
+  invoke?: RawInvoke;
+  on?: Record<string, unknown>;
+};
 
 type RawArm = { target?: unknown; guard?: TransitionGuard };
+type RawArmWithActions = RawArm & { actions?: unknown };
 
 type RawConfig = {
   states?: Record<string, RawStateDef>;
@@ -82,6 +113,7 @@ export function enumerateCaptainStates(
         index,
         target: stripIdPrefix(String(arm.target ?? '')),
         guard: arm.guard ?? alwaysTrue,
+        actions: arm.actions,
       }),
     );
     out.push({
@@ -103,23 +135,58 @@ export function enumerateRootEvents(
     { target?: string }
   >;
   const rootOn = (cfg.on ?? {}) as Record<string, unknown>;
+  const bossInterruptTargets = toArmArray(rootOn.BOSS_INTERRUPT).map((arm) =>
+    stripIdPrefix(String(arm.target ?? '')),
+  );
   return {
     startCoding: { target: stripIdPrefix(String(readyOn.START_CODING?.target ?? '')) },
     continueIr: { target: stripIdPrefix(String(readyOn.CONTINUE_IR?.target ?? '')) },
     summarizeIr: { target: stripIdPrefix(String(readyOn.SUMMARIZE_IR?.target ?? '')) },
-    bossInterruptTargets: toArmArray(rootOn.BOSS_INTERRUPT).map((arm) =>
-      stripIdPrefix(String(arm.target ?? '')),
-    ),
+    bossInterruptTargets,
+    bossInterruptTargetDescriptions: bossInterruptTargets.map((stateId) => {
+      const description = cfg.states?.[stateId]?.description;
+      return {
+        stateId,
+        description: typeof description === 'string' ? description : '',
+      };
+    }),
   };
 }
 
+export function enumerateAwaitBossReply(
+  machine: typeof codingMachine,
+): AwaitBossReplyInfo {
+  const stateId = 'awaitBossReply';
+  const awaitOn = getRawConfig(machine).states?.[stateId]?.on ?? {};
+  const transitions = Object.entries(awaitOn).flatMap(([eventType, value]) =>
+    toArmArray(value).map(
+      (arm, index): AwaitBossReplyTransition => ({
+        eventType,
+        index,
+        target: stripIdPrefix(String(arm.target ?? '')),
+        guard: arm.guard ?? alwaysTrue,
+        actions: arm.actions,
+      }),
+    ),
+  );
+  const bossReplyTransitions = toArmArray(awaitOn.BOSS_REPLY).map(
+    (arm, index): BossReplyTransition => ({
+      index,
+      target: stripIdPrefix(String(arm.target ?? '')),
+      guard: arm.guard ?? alwaysTrue,
+      actions: arm.actions,
+    }),
+  );
+  return { stateId, bossReplyTransitions, transitions };
+}
+
 function getRawConfig(machine: typeof codingMachine): RawConfig {
   return (machine as unknown as { config: RawConfig }).config;
 }
 
-function toArmArray(value: unknown): RawArm[] {
+function toArmArray(value: unknown): RawArmWithActions[] {
   if (value === undefined || value === null) return [];
-  return (Array.isArray(value) ? value : [value]) as RawArm[];
+  return (Array.isArray(value) ? value : [value]) as RawArmWithActions[];
 }
 
 function stripIdPrefix(target: string): string {