@sublang/playbook 7.0.0 → 9.0.0

package/reference/sdlc/captain.playbook/captain.playbook.js

@@ -31,9 +31,9 @@
 //                deterministic entry mapping, the controller captain-call
 //                strategy with its single corrective re-ask (CAPPLAY-18),
 //                controller-port submission, and status formatting.
-// Compat:        spec.compat = { artifactSchema: 1, runtimeAbi: 1 }
+// Compat:        spec.compat = { artifactSchema: 2, runtimeAbi: 1 }
 //                (DR-022; checked at construction by the loading engine).
-import { createXStatePlaybookRuntime, defaultComposeCaptainPrompt, normalizeError, normalizeErrorCompact, parseJudgeJson, snapshotJsonValue, RUNTIME_ABI, } from '../../../src/xstate-runtime.js';
+import { createXStatePlaybookRuntime, defaultComposeCaptainPrompt, normalizeError, normalizeErrorCompact, parseJudgeJson, snapshotJsonValue, } from '../../../src/xstate-runtime.js';
 import { captainMachine, } from './captain.fsm.js';
 function assertNonEmptyString(value, label) {
     if (typeof value !== 'string' || value.trim().length === 0) {
@@ -516,11 +516,15 @@ export const _internal = {
 // describe/apply control surface — lives in @sublang/playbook/xstate-runtime.
 const runtimeSpec = {
     label: 'CAPTAIN',
-    compat: { artifactSchema: 1, 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: 2, runtimeAbi: 1 },
     snapshotOptions: snapshotCaptainOptions,
     machineInput: (options) => ({ enabledPlaybooks: options.enabledPlaybooks }),
     classifyBossText: (text, ports, signal, snapshotOrState, boundary, options) => classifyControllerTurn(text, ports, signal, snapshotOrState, boundary, options),
-    playerStates: {},
+    roleStates: {},
     classificationStatus: () => undefined,
     captainStrategy: controllerCaptainStrategy,
     // CAPPLAY-10 / PBRT-52: the Captain's own ControlView context projection —
@@ -543,8 +547,15 @@ const runtimeSpec = {
     ],
     statusesForState,
 };
-const createCaptainPlaybookRuntime = createXStatePlaybookRuntime(captainMachine, runtimeSpec);
+// DR-022's compat check fails fast at factory construction. The Captain is
+// statically imported by the shell and both CLI front ends, so constructing
+// here at module evaluation would turn a future compat mismatch into an
+// uncaught ESM-load error that takes even `--help` down; constructing on
+// the first runtime request keeps the failure inside the caught
+// host-construction boundary that owes the Boss a setup diagnostic.
+let createCaptainPlaybookRuntime;
 export function createPlaybookRuntime(options) {
+    createCaptainPlaybookRuntime ??= createXStatePlaybookRuntime(captainMachine, runtimeSpec);
     return createCaptainPlaybookRuntime(options);
 }
 const factory = createPlaybookRuntime;

package/reference/sdlc/captain.playbook/captain.playbook.ts

@@ -31,7 +31,7 @@
 //                deterministic entry mapping, the controller captain-call
 //                strategy with its single corrective re-ask (CAPPLAY-18),
 //                controller-port submission, and status formatting.
-// Compat:        spec.compat = { artifactSchema: 1, runtimeAbi: 1 }
+// Compat:        spec.compat = { artifactSchema: 2, runtimeAbi: 1 }
 //                (DR-022; checked at construction by the loading engine).
 
 import {
@@ -41,7 +41,6 @@ import {
   normalizeErrorCompact,
   parseJudgeJson,
   snapshotJsonValue,
-  RUNTIME_ABI,
   type PlaybookActorOutput,
   type PlaybookCaptainInput,
   type ScheduledStatus,
@@ -798,7 +797,11 @@ export const _internal = {
 // describe/apply control surface — lives in @sublang/playbook/xstate-runtime.
 const runtimeSpec: XStatePlaybookRuntimeSpec<ValidatedCaptainOptions> = {
   label: 'CAPTAIN',
-  compat: { artifactSchema: 1, 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: 2, runtimeAbi: 1 },
   snapshotOptions: snapshotCaptainOptions,
   machineInput: (options) => ({ enabledPlaybooks: options.enabledPlaybooks }),
   classifyBossText: (text, ports, signal, snapshotOrState, boundary, options) =>
@@ -810,7 +813,7 @@ const runtimeSpec: XStatePlaybookRuntimeSpec<ValidatedCaptainOptions> = {
       boundary,
       options,
     ) as Promise<import('xstate').EventObject | undefined>,
-  playerStates: {},
+  roleStates: {},
   classificationStatus: () => undefined,
   captainStrategy: controllerCaptainStrategy,
   // CAPPLAY-10 / PBRT-52: the Captain's own ControlView context projection —
@@ -834,12 +837,23 @@ const runtimeSpec: XStatePlaybookRuntimeSpec<ValidatedCaptainOptions> = {
   statusesForState,
 };
 
-const createCaptainPlaybookRuntime: PlaybookRuntimeFactory<ValidatedCaptainOptions> =
-  createXStatePlaybookRuntime(captainMachine, runtimeSpec);
+// DR-022's compat check fails fast at factory construction. The Captain is
+// statically imported by the shell and both CLI front ends, so constructing
+// here at module evaluation would turn a future compat mismatch into an
+// uncaught ESM-load error that takes even `--help` down; constructing on
+// the first runtime request keeps the failure inside the caught
+// host-construction boundary that owes the Boss a setup diagnostic.
+let createCaptainPlaybookRuntime:
+  | PlaybookRuntimeFactory<ValidatedCaptainOptions>
+  | undefined;
 
 export function createPlaybookRuntime(
   options: PlaybookRuntimeOptions,
 ): PlaybookRuntime {
+  createCaptainPlaybookRuntime ??= createXStatePlaybookRuntime(
+    captainMachine,
+    runtimeSpec,
+  );
   return createCaptainPlaybookRuntime(options);
 }
 

package/reference/sdlc/code.md

@@ -4,7 +4,7 @@
 
 # Code
 
-Players:
+Roles:
 
 - Coder