@sublang/playbook 7.0.0 → 9.0.0

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

@@ -43,24 +43,17 @@ export function validateCodeOptions(optionSlice) {
     }
     return Object.freeze({});
 }
-function playerIdentity(players, id) {
-    const player = players.find((entry) => entry.id === id);
-    return player?.model ?? player?.adapter;
-}
-export function createCodeRuntimeOptions({ captainOptions, players, }) {
-    validateCodeOptions(captainOptions);
-    const coderPlayer = playerIdentity(players, 'coder');
-    return coderPlayer === undefined ? {} : { coderPlayer };
-}
 export const codePlaybookRegistryEntry = {
     id: 'code',
     command: 'code',
     intent: 'implement a coding intent in reviewed, one-commit phases, using an intent record when needed',
+    artifactSchema: 2,
     requiredRoleIds: ['coder'],
+    concurrentRoleSets: [],
     summaryPolicy: codeSummaryPolicy,
     validateOptions: validateCodeOptions,
     createRuntime(options) {
-        return createPlaybookRuntime(createCodeRuntimeOptions(options));
+        return createPlaybookRuntime(options);
     },
 };
 export default codePlaybookRegistryEntry;

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

@@ -2,7 +2,6 @@
 // SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
 
 import createPlaybookRuntime, {
-  type CodePlaybookOptions,
   type PlaybookRuntime,
 } from './code.playbook.js';
 
@@ -15,27 +14,18 @@ export interface PlaybookSummaryPolicy {
   ): string;
 }
 
-export interface RegistryPlayer {
-  id: string;
-  adapter?: string;
-  model?: string;
-}
-
-export interface CreateCodeRuntimeOptions {
-  captainOptions: unknown;
-  players: readonly RegistryPlayer[];
-}
-
 export type CodeOptions = Readonly<Record<string, never>>;
 
 export interface CodePlaybookRegistryEntry {
   id: 'code';
   command: 'code';
   intent: string;
+  artifactSchema: 2;
   requiredRoleIds: readonly ['coder'];
+  concurrentRoleSets: readonly [];
   summaryPolicy: PlaybookSummaryPolicy;
-  validateOptions(captainOptions: unknown): CodeOptions;
-  createRuntime(options: CreateCodeRuntimeOptions): PlaybookRuntime;
+  validateOptions(optionSlice: unknown): CodeOptions;
+  createRuntime(options: CodeOptions): PlaybookRuntime;
 }
 
 // REVIEW owns and labels its real review rounds. CODE's two suspended wrapper
@@ -96,33 +86,18 @@ export function validateCodeOptions(optionSlice: unknown): CodeOptions {
   return Object.freeze({});
 }
 
-function playerIdentity(
-  players: readonly RegistryPlayer[],
-  id: string,
-): string | undefined {
-  const player = players.find((entry) => entry.id === id);
-  return player?.model ?? player?.adapter;
-}
-
-export function createCodeRuntimeOptions({
-  captainOptions,
-  players,
-}: CreateCodeRuntimeOptions): CodePlaybookOptions {
-  validateCodeOptions(captainOptions);
-  const coderPlayer = playerIdentity(players, 'coder');
-  return coderPlayer === undefined ? {} : { coderPlayer };
-}
-
 export const codePlaybookRegistryEntry: CodePlaybookRegistryEntry = {
   id: 'code',
   command: 'code',
   intent:
     'implement a coding intent in reviewed, one-commit phases, using an intent record when needed',
+  artifactSchema: 2,
   requiredRoleIds: ['coder'],
+  concurrentRoleSets: [],
   summaryPolicy: codeSummaryPolicy,
   validateOptions: validateCodeOptions,
   createRuntime(options) {
-    return createPlaybookRuntime(createCodeRuntimeOptions(options));
+    return createPlaybookRuntime(options);
   },
 };
 

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

@@ -1,11 +1,26 @@
-import type { Captain, CaptainSession } from '@sublang/cligent/tmux-play';
+import { type Captain, type CaptainSession, type TuningSelection } from '@sublang/cligent/tmux-play';
+import type { Effort, PermissionPolicy } from '@sublang/cligent';
 import type { JsonValue, PlaybookRuntime, PlaybookRuntimeSnapshot } 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;
-    players: readonly RegistryPlayer[];
+import type { PlaybookSummaryPolicy } from './code.registry.js';
+interface SessionAgent {
+    readonly adapter: string;
+    readonly model: TuningSelection;
+    readonly effort: TuningSelection<Effort>;
+    readonly instruction?: string;
+    readonly permissions?: PermissionPolicy;
 }
+interface PlayerLedgerEntry {
+    readonly adapter: string;
+    readonly instruction?: string;
+    readonly permissions?: PermissionPolicy;
+    resumeToken?: string;
+}
+type DeepReadonly<T> = T extends (...args: never[]) => unknown ? T : T extends readonly (infer Element)[] ? readonly DeepReadonly<Element>[] : T extends object ? {
+    readonly [Key in keyof T]: DeepReadonly<T[Key]>;
+} : T;
+type SnapshotAgentEnvelope = DeepReadonly<Omit<SessionAgent, 'model' | 'effort'>>;
+type PlayerLedgerSnapshotEntry = DeepReadonly<PlayerLedgerEntry>;
 export interface PlaybookCaptainDeps {
     loadModule?: (specifier: string) => Promise<unknown>;
     createSessionId?: () => string;
@@ -22,16 +37,22 @@ export interface PlaybookCaptainRegistryEntry {
     id: string;
     command: string;
     intent: string;
+    artifactSchema: 2;
     requiredRoleIds: readonly string[];
+    concurrentRoleSets: readonly (readonly string[])[];
     summaryPolicy?: PlaybookSummaryPolicy;
-    validateOptions(captainOptions: unknown): unknown;
-    createRuntime(options: CreatePlaybookRuntimeOptions): PlaybookRuntime;
+    validateOptions(optionSlice: unknown): unknown;
+    createRuntime(options: unknown): PlaybookRuntime;
 }
 type PlaybookCaptainConversationSnapshot = {
     readonly kind: 'unopened';
 } | {
     readonly kind: 'pinned';
     readonly token: string;
+} | {
+    readonly kind: 'needsCatchUp';
+    readonly resume: string | false;
+    readonly afterJournalSeq: number;
 } | {
     readonly kind: 'needsSeeding';
 };
@@ -48,15 +69,19 @@ interface PlaybookCaptainFrameSnapshot {
     readonly depth: number;
     readonly parentSessionId?: string;
     readonly parentCallId?: string;
-    readonly runtime: PlaybookRuntimeSnapshot;
+    readonly options: JsonValue;
+    readonly roleBindings: Readonly<Record<string, string>>;
+    readonly runtime: DeepReadonly<PlaybookRuntimeSnapshot>;
 }
 interface PlaybookCaptainShellSnapshotFields {
-    readonly schemaVersion: 1;
+    readonly schemaVersion: 3;
     readonly captain: {
         readonly sessionId: string;
-        readonly runtime: PlaybookRuntimeSnapshot;
+        readonly runtime: DeepReadonly<PlaybookRuntimeSnapshot>;
+        readonly agent: SnapshotAgentEnvelope;
         readonly conversation: PlaybookCaptainConversationSnapshot;
     };
+    readonly playerSessions: Readonly<Record<string, PlayerLedgerSnapshotEntry>>;
     /** Every Captain and engagement UUID issued during this logical session. */
     readonly issuedSessionIds: readonly string[];
     readonly sequences: {
@@ -71,28 +96,28 @@ interface PlaybookCaptainShellSnapshotFields {
  * Complete JSON-safe durable state for one Captain shell between Boss turns.
  * The discriminated mode keeps chat snapshots free of stale engagement data.
  */
-export type PlaybookCaptainShellSnapshot = PlaybookCaptainShellSnapshotFields & ({
+type PlaybookCaptainShellSnapshotValue = PlaybookCaptainShellSnapshotFields & ({
     readonly mode: 'chat';
     readonly frames?: never;
-    readonly rootPlayerResumeTokens?: never;
     readonly pendingBossQuestions?: never;
     readonly lastError?: never;
 } | {
     readonly mode: 'engaged.parked';
     /** Root-to-leaf engagement order. */
     readonly frames: readonly PlaybookCaptainFrameSnapshot[];
-    /** Root-owned continuation, keyed by effective host-player id. */
-    readonly rootPlayerResumeTokens: Readonly<Record<string, string>>;
     readonly pendingBossQuestions?: JsonValue;
     readonly lastError?: {
         readonly name: string;
         readonly message: string;
     };
 });
+export type PlaybookCaptainShellSnapshot = DeepReadonly<PlaybookCaptainShellSnapshotValue>;
 /** tmux and headless front ends share this one durable Captain shell API. */
 export interface PlaybookCaptainShell extends Captain {
     exportSnapshot(): PlaybookCaptainShellSnapshot | undefined;
     restore(session: CaptainSession, snapshot: PlaybookCaptainShellSnapshot): Promise<void>;
 }
+/** Validate, detach, and freeze one untrusted shell snapshot. */
+export declare function assertPlaybookCaptainShellSnapshot(value: unknown): PlaybookCaptainShellSnapshot;
 export declare function createPlaybookCaptainShell(options: unknown, deps?: PlaybookCaptainDeps): PlaybookCaptainShell;
 export default createPlaybookCaptainShell;