@sublang/playbook 4.0.0 → 5.0.0

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

@@ -665,6 +665,23 @@ const runtimeSpec = {
     extractRequiredFields,
     verbatimPayloadFields: VERBATIM_PAYLOAD_FIELDS,
     resumableStateIds: registeredResumableStateIds,
+    // PBRT-52: CODE's own ControlView context projection. Exactly the four
+    // closed-vocabulary classification members the FSM assigns itself, which
+    // are what a controller needs to see to describe or steer a CODE
+    // engagement. Everything else in `CodingContext` is deliberately absent:
+    // `coderPlayer` / `reviewerPlayer` / `committerPlayer` are the resolved
+    // host player roster, `intent` is an option value, and `irNumber`,
+    // `taskDescription`, `reviews`, `challenges`, and `lastResult` all carry
+    // player-authored text — all of which a session-Captain prompt must
+    // exclude, or may carry only as fenced quotes
+    // (CAPTAIN-9). A member added to `CodingContext`
+    // later stays private until it is named here.
+    controlContextFields: [
+        'workflow',
+        'changeOrigin',
+        'reviewSubject',
+        'afterReview',
+    ],
     classifyBossText: (text, ports, signal, snapshotOrState, boundary) => classifyBossText(text, ports, signal, snapshotOrState, boundary),
     classificationStatus: (event) => formatClassification(event.type),
     statusesForState,

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

@@ -936,6 +936,23 @@ const runtimeSpec: XStatePlaybookRuntimeSpec<CodePlaybookOptions> = {
   extractRequiredFields,
   verbatimPayloadFields: VERBATIM_PAYLOAD_FIELDS,
   resumableStateIds: registeredResumableStateIds,
+  // PBRT-52: CODE's own ControlView context projection. Exactly the four
+  // closed-vocabulary classification members the FSM assigns itself, which
+  // are what a controller needs to see to describe or steer a CODE
+  // engagement. Everything else in `CodingContext` is deliberately absent:
+  // `coderPlayer` / `reviewerPlayer` / `committerPlayer` are the resolved
+  // host player roster, `intent` is an option value, and `irNumber`,
+  // `taskDescription`, `reviews`, `challenges`, and `lastResult` all carry
+  // player-authored text — all of which a session-Captain prompt must
+  // exclude, or may carry only as fenced quotes
+  // (CAPTAIN-9). A member added to `CodingContext`
+  // later stays private until it is named here.
+  controlContextFields: [
+    'workflow',
+    'changeOrigin',
+    'reviewSubject',
+    'afterReview',
+  ],
   classifyBossText: (text, ports, signal, snapshotOrState, boundary) =>
     classifyBossText(text, ports, signal, snapshotOrState, boundary),
   classificationStatus: (event) => formatClassification(event.type),

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

@@ -1,5 +1,6 @@
 import type { Captain } from '@sublang/cligent/tmux-play';
 import type { PlaybookRuntime } from '@sublang/playbook/runtime';
+import { type CaptainControllerPort } from '../captain.playbook/captain.playbook.js';
 import type { PlaybookSummaryPolicy, RegistryPlayer } from './code.registry.js';
 export interface CreatePlaybookRuntimeOptions {
     captainOptions: unknown;
@@ -14,6 +15,7 @@ export interface PlaybookCaptainDeps {
             readonly command: string;
             readonly intent: string;
         }[];
+        readonly controller: CaptainControllerPort;
     }) => PlaybookRuntime;
 }
 export interface PlaybookCaptainRegistryEntry {