@sublang/playbook 11.0.0 → 12.0.0

package/reference/sdlc/dev.playbook/dev.gears.md

@@ -0,0 +1,91 @@
+<!-- SPDX-License-Identifier: Apache-2.0 -->
+<!-- SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai> -->
+
+# DEV: Development Planning Workflow
+
+Roles:
+
+- Analyst
+
+`dev` is an optional repository-aware planner for a development request that needs more analysis before choosing a development path.
+It coordinates existing playbooks and owns no repository commit itself.
+
+## Analyst
+
+### DEV-1
+
+At the start of `dev` and after each Boss reply, Captain shall relay the development request, relevant discussion context, and any relevant run results to Analyst in quotes (`>`), along with the planning instruction:
+
+> > <development-request>
+> > <discussion-context>
+> > <run-results>
+>
+> Inspect the request and the relevant repository and specs only as needed to determine the smallest sound next step.
+> Do not change files or commit while planning or discussing the request.
+>
+> - If useful analysis or clarification should be discussed before any repository work, give Boss the useful response and ask one material question that advances the decision.
+> - If the discussion has concluded after a Boss reply and no repository work should follow, choose `discussion complete`.
+> - If implementation can proceed under the existing decisions, choose `code`.
+> - If implementation first requires a new or amended durable decision that the existing specs do not settle, choose `decide then code`.
+>
+> A question or exploratory discussion is not by itself authorization to create a durable decision or implement changes.
+> Do not choose `decide then code` merely because the work is large.
+> Consult @specs/map.md for relevant context and @specs/meta.md for spec requirements, if needed.
+
+Results:
+- `discussionComplete`: Analyst concluded the discussion after a Boss reply, with no repository work to follow.
+- `code`: Analyst determined implementation can proceed under the existing decisions. Output shall include `planningResult: <verbatim final text>`.
+- `decideThenCode`: Analyst determined implementation first requires a new or amended durable decision that the existing specs do not settle. Output shall include `planningResult: <verbatim final text>`.
+
+Workflow outcomes:
+- The planning result has four semantic outcomes: needs Boss reply, discussion complete, code, and decide then code.
+- Each outcome requires affirmative support in Analyst's result; absence of a reason to choose another outcome is not support, and no outcome depends on a fixed presentation format of Analyst's reply.
+- Needs Boss reply uses the standard Boss-question suspension with Analyst's complete response; after Boss replies, `dev` resumes with the question and answer in the same Analyst conversation.
+- Discussion complete is available only after a Boss reply, when any useful analysis has already been presented through needs Boss reply; it completes `dev` without a child call or repository change.
+- `dev` acts on the accepted outcome itself and does not return to the session Captain for another routing decision.
+
+## Nested development paths
+
+### DEV-2
+
+When the accepted planning result selects `code`, Captain shall call playbook `code`:
+
+> > <development-request>
+> > <discussion-context>
+> > <planning-result>
+
+Workflow outcomes:
+- `code` success completes `dev` with the successful `code` result.
+- An authored `code` abort or failure, or a terminal `code` result that does not prove the success required for the selected path, terminates `dev` with that canonical result relayed and no later child call.
+- Any other nested-call error parks `dev` as failed and retains the control-plane error.
+- `dev` consumes commit identities only from each child's canonical structured result, never from player prose.
+
+### DEV-3
+
+When the accepted planning result selects `decide then code`, Captain shall call playbook `decide`:
+
+> > <development-request>
+> > <discussion-context>
+> > <planning-result>
+
+Workflow outcomes:
+- `decide` success provides the `decide`-owned commit and the exact evaluated repository revision from `decide`'s canonical structured result and continues with the `code` call.
+- An authored `decide` abort or failure, or a terminal `decide` result that does not prove that success, terminates `dev` with that canonical result relayed and no later child call.
+- Any other nested-call error parks `dev` as failed and retains the control-plane error.
+- `dev` does not separately call `review` for the design scope already reviewed by `decide`.
+
+### DEV-4
+
+When `decide` succeeds, Captain shall call playbook `code`:
+
+> > <development-request>
+> > <discussion-context>
+> > <planning-result>
+> > <decide-commit>
+> > <evaluated-revision>
+
+Workflow outcomes:
+- `code` success completes `dev` with the successful `code` result.
+- An authored `code` abort or failure, or a terminal `code` result that does not prove the success required for the selected path, terminates `dev` with that canonical result relayed and no later child call.
+- Any other nested-call error parks `dev` as failed and retains the control-plane error.
+- `dev` consumes commit identities only from each child's canonical structured result, never from player prose.

package/reference/sdlc/dev.playbook/dev.playbook.d.ts

@@ -0,0 +1,21 @@
+import { type XStatePlaybookRuntimeFactory, type XStatePlaybookRuntimeConstruction } from '@sublang/playbook/xstate-runtime';
+import { type DevInput, type PlayerInput } from './dev.fsm.js';
+import type { PlaybookHostConstructionCapabilities } from '../code.playbook/playbook-captain.js';
+import type { CaptainCallOptions, CaptainResult, JsonValue, NormalizedError, PlayerCallOptions, PlaybookCallRequest, PlaybookCallResult, PlaybookCallStart, PlaybookControlReceipt, PlaybookControlView, PlaybookPendingCall, PlaybookPorts, PlaybookRunResult, PlaybookRuntime, PlaybookRuntimeFactory, PlaybookRuntimeSnapshot, PlaybookSession, PlaybookState, PlaybookStateValue, PlaybookTraceEvent, PlaybookTraceType, PlayerResult, PlayerSessionStore } from '@sublang/playbook/runtime';
+export type { CaptainCallOptions, CaptainResult, JsonValue, NormalizedError, PlayerCallOptions, PlaybookCallRequest, PlaybookCallResult, PlaybookCallStart, PlaybookControlReceipt, PlaybookControlView, PlaybookPendingCall, PlaybookPorts, PlaybookRunResult, PlaybookRuntime, PlaybookRuntimeFactory, PlaybookRuntimeSnapshot, PlaybookSession, PlaybookState, PlaybookStateValue, PlaybookTraceEvent, PlaybookTraceType, PlayerResult, PlayerSessionStore, };
+export type DevPlaybookOptions = DevInput;
+export type DevPlaybookHostCapabilities = PlaybookHostConstructionCapabilities & XStatePlaybookRuntimeConstruction<DevPlaybookOptions, object>['hostCapabilities'];
+/**
+ * Preserve authored Markdown quote markers around every line of relayed
+ * runtime text. The generic composer preserves the marker itself; DEV's
+ * override additionally keeps a multiline value inside that quote and drops
+ * the optional relays that have no value yet.
+ */
+declare function composePlayerPrompt(input: PlayerInput): string;
+export declare const _internal: {
+    composePlayerPrompt: typeof composePlayerPrompt;
+    VERBATIM_PAYLOAD_FIELDS: ReadonlySet<string>;
+    UNFINISHED_FINAL_STATE_IDS: ReadonlySet<string>;
+};
+declare const createPlaybookRuntime: XStatePlaybookRuntimeFactory<XStatePlaybookRuntimeConstruction<DevPlaybookOptions, DevPlaybookHostCapabilities>, 3>;
+export default createPlaybookRuntime;

package/reference/sdlc/dev.playbook/dev.playbook.js

@@ -0,0 +1,143 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+//
+// Generated by slc/link.md (FSM-to-Runtime linker).
+// Source FSM:    ./dev.fsm.ts
+// Role metadata: Analyst→analyst (canonical local role)
+// Boss event:    deterministic START_DEV entry; exact Boss text becomes
+//                developmentRequest; pending Analyst questions retain
+//                BOSS_REPLY
+// Adjudication:  LLM judge for the one Analyst state; planningResult is
+//                carried verbatim
+// Nested calls:  literal code and decide targets through the shared bridge
+// Compat:        artifact schema 3 / runtime ABI 1
+import { createXStatePlaybookRuntime, snapshotJsonValue, } from '@sublang/playbook/xstate-runtime';
+import { devMachine, } from './dev.fsm.js';
+const OPTION_KEYS = new Set(['runResults']);
+const PLACEHOLDER = /<(#|[A-Za-z_$][A-Za-z0-9_$-]*)>/g;
+const CONTINUATION_PREAMBLE = 'You previously paused this task to ask Boss a question; Boss has now replied. Continue the same task using the reply below.';
+const VERBATIM_PAYLOAD_FIELDS = new Set([
+    'planningResult',
+]);
+const UNFINISHED_FINAL_STATE_IDS = new Set([
+    'reportedChildFailure',
+]);
+function snapshotDevOptions(value) {
+    const captured = snapshotJsonValue(value, 'DEV runtime options');
+    if (captured === null ||
+        typeof captured !== 'object' ||
+        Array.isArray(captured)) {
+        throw new TypeError('DEV runtime options must be an object');
+    }
+    const record = captured;
+    for (const [key, option] of Object.entries(record)) {
+        if (!OPTION_KEYS.has(key)) {
+            throw new TypeError(`DEV runtime options.${key} is not declared`);
+        }
+        if (typeof option !== 'string') {
+            throw new TypeError(`DEV runtime options.${key} must be a string`);
+        }
+    }
+    return captured;
+}
+function placeholderField(token) {
+    if (token === '#')
+        return 'irNumber';
+    return token.replace(/-([A-Za-z0-9_$])/g, (_match, next) => next.toUpperCase());
+}
+function quotedContinuation(value) {
+    return value.replaceAll('\n', '\n> ');
+}
+/**
+ * Preserve authored Markdown quote markers around every line of relayed
+ * runtime text. The generic composer preserves the marker itself; DEV's
+ * override additionally keeps a multiline value inside that quote and drops
+ * the optional relays that have no value yet.
+ */
+function composePlayerPrompt(input) {
+    const fields = input;
+    const template = input.prompt
+        .split('\n')
+        .filter((line) => !(line === '> <discussion-context>' &&
+        input.discussionContext.length === 0) &&
+        !(line === '> <run-results>' && input.runResults.length === 0))
+        .join('\n');
+    const body = template.replace(PLACEHOLDER, (match, token, offset, source) => {
+        const value = fields[placeholderField(token)];
+        if (typeof value !== 'string')
+            return match;
+        const lineStart = source.lastIndexOf('\n', offset - 1) + 1;
+        const literal = source.slice(lineStart, offset);
+        return literal === '> ' ? quotedContinuation(value) : value;
+    });
+    if (input.pendingBossQuestion === undefined ||
+        input.bossReply === undefined) {
+        return body;
+    }
+    return [
+        CONTINUATION_PREAMBLE,
+        `Boss question:\n${input.pendingBossQuestion.question}`,
+        `Boss reply:\n${input.bossReply}`,
+        body,
+    ].join('\n\n');
+}
+export const _internal = {
+    composePlayerPrompt,
+    VERBATIM_PAYLOAD_FIELDS,
+    UNFINISHED_FINAL_STATE_IDS,
+};
+const runtimeSpec = {
+    label: 'DEV',
+    // 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: 3, runtimeAbi: 1 },
+    snapshotOptions: snapshotDevOptions,
+    entryEvent: {
+        type: 'START_DEV',
+        textField: 'developmentRequest',
+        // `startDev` copies the entry text here, so the failure-state retry
+        // reads it back from the persisted machine snapshot and survives a
+        // continued session (DR-034).
+        contextField: 'developmentRequest',
+    },
+    roleStates: {
+        planAnalysis: {
+            role: 'analyst',
+            label: 'Analyst is analyzing the development request to choose the smallest sound next step.',
+        },
+    },
+    // DR-044: DEV owns no repository commit — every Analyst outcome is
+    // governed with the `unchanged` repository disposition, so planning that
+    // mutates the repository fails authority instead of being adopted.
+    outcomeAuthority: {
+        governedPlayerStates: {
+            planAnalysis: {
+                discussionComplete: {
+                    fields: {},
+                    repositoryDisposition: 'unchanged',
+                },
+                code: {
+                    fields: { planningResult: 'presentation' },
+                    repositoryDisposition: 'unchanged',
+                },
+                decideThenCode: {
+                    fields: { planningResult: 'presentation' },
+                    repositoryDisposition: 'unchanged',
+                },
+                needsBossReply: {
+                    fields: { question: 'presentation' },
+                    repositoryDisposition: 'unchanged',
+                },
+            },
+        },
+    },
+    composePlayerPrompt: (input) => composePlayerPrompt(input),
+    verbatimPayloadFields: VERBATIM_PAYLOAD_FIELDS,
+    controlContextFields: [],
+    unfinishedFinalStateIds: UNFINISHED_FINAL_STATE_IDS,
+    transitionEventFields: ['developmentRequest', 'answer', 'questionId'],
+};
+const createPlaybookRuntime = createXStatePlaybookRuntime(devMachine, runtimeSpec);
+export default createPlaybookRuntime;

package/reference/sdlc/dev.playbook/dev.playbook.ts

@@ -0,0 +1,246 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+//
+// Generated by slc/link.md (FSM-to-Runtime linker).
+// Source FSM:    ./dev.fsm.ts
+// Role metadata: Analyst→analyst (canonical local role)
+// Boss event:    deterministic START_DEV entry; exact Boss text becomes
+//                developmentRequest; pending Analyst questions retain
+//                BOSS_REPLY
+// Adjudication:  LLM judge for the one Analyst state; planningResult is
+//                carried verbatim
+// Nested calls:  literal code and decide targets through the shared bridge
+// Compat:        artifact schema 3 / runtime ABI 1
+
+import {
+  createXStatePlaybookRuntime,
+  snapshotJsonValue,
+  type PlaybookPlayerInput,
+  type XStatePlaybookRuntimeFactory,
+  type XStatePlaybookRuntimeConstruction,
+  type XStatePlaybookRuntimeSpecV3,
+} from '@sublang/playbook/xstate-runtime';
+import {
+  devMachine,
+  type DevInput,
+  type PlayerInput,
+} from './dev.fsm.js';
+import type { PlaybookHostConstructionCapabilities } from '../code.playbook/playbook-captain.js';
+import type {
+  CaptainCallOptions,
+  CaptainResult,
+  JsonValue,
+  NormalizedError,
+  PlayerCallOptions,
+  PlaybookCallRequest,
+  PlaybookCallResult,
+  PlaybookCallStart,
+  PlaybookControlReceipt,
+  PlaybookControlView,
+  PlaybookPendingCall,
+  PlaybookPorts,
+  PlaybookRunResult,
+  PlaybookRuntime,
+  PlaybookRuntimeFactory,
+  PlaybookRuntimeSnapshot,
+  PlaybookSession,
+  PlaybookState,
+  PlaybookStateValue,
+  PlaybookTraceEvent,
+  PlaybookTraceType,
+  PlayerResult,
+  PlayerSessionStore,
+} from '@sublang/playbook/runtime';
+
+export type {
+  CaptainCallOptions,
+  CaptainResult,
+  JsonValue,
+  NormalizedError,
+  PlayerCallOptions,
+  PlaybookCallRequest,
+  PlaybookCallResult,
+  PlaybookCallStart,
+  PlaybookControlReceipt,
+  PlaybookControlView,
+  PlaybookPendingCall,
+  PlaybookPorts,
+  PlaybookRunResult,
+  PlaybookRuntime,
+  PlaybookRuntimeFactory,
+  PlaybookRuntimeSnapshot,
+  PlaybookSession,
+  PlaybookState,
+  PlaybookStateValue,
+  PlaybookTraceEvent,
+  PlaybookTraceType,
+  PlayerResult,
+  PlayerSessionStore,
+};
+
+export type DevPlaybookOptions = DevInput;
+export type DevPlaybookHostCapabilities =
+  PlaybookHostConstructionCapabilities &
+    XStatePlaybookRuntimeConstruction<DevPlaybookOptions, object>['hostCapabilities'];
+
+const OPTION_KEYS = new Set(['runResults']);
+const PLACEHOLDER = /<(#|[A-Za-z_$][A-Za-z0-9_$-]*)>/g;
+const CONTINUATION_PREAMBLE =
+  'You previously paused this task to ask Boss a question; Boss has now replied. Continue the same task using the reply below.';
+
+const VERBATIM_PAYLOAD_FIELDS: ReadonlySet<string> = new Set([
+  'planningResult',
+]);
+const UNFINISHED_FINAL_STATE_IDS: ReadonlySet<string> = new Set([
+  'reportedChildFailure',
+]);
+
+function snapshotDevOptions(value: unknown): DevPlaybookOptions {
+  const captured = snapshotJsonValue(value, 'DEV runtime options');
+  if (
+    captured === null ||
+    typeof captured !== 'object' ||
+    Array.isArray(captured)
+  ) {
+    throw new TypeError('DEV runtime options must be an object');
+  }
+  const record = captured as Readonly<Record<string, JsonValue>>;
+  for (const [key, option] of Object.entries(record)) {
+    if (!OPTION_KEYS.has(key)) {
+      throw new TypeError(`DEV runtime options.${key} is not declared`);
+    }
+    if (typeof option !== 'string') {
+      throw new TypeError(`DEV runtime options.${key} must be a string`);
+    }
+  }
+  return captured as unknown as DevPlaybookOptions;
+}
+
+function placeholderField(token: string): string {
+  if (token === '#') return 'irNumber';
+  return token.replace(/-([A-Za-z0-9_$])/g, (_match, next: string) =>
+    next.toUpperCase(),
+  );
+}
+
+function quotedContinuation(value: string): string {
+  return value.replaceAll('\n', '\n> ');
+}
+
+/**
+ * Preserve authored Markdown quote markers around every line of relayed
+ * runtime text. The generic composer preserves the marker itself; DEV's
+ * override additionally keeps a multiline value inside that quote and drops
+ * the optional relays that have no value yet.
+ */
+function composePlayerPrompt(input: PlayerInput): string {
+  const fields = input as unknown as Record<string, unknown>;
+  const template = input.prompt
+    .split('\n')
+    .filter(
+      (line) =>
+        !(
+          line === '> <discussion-context>' &&
+          input.discussionContext.length === 0
+        ) &&
+        !(line === '> <run-results>' && input.runResults.length === 0),
+    )
+    .join('\n');
+  const body = template.replace(
+    PLACEHOLDER,
+    (match: string, token: string, offset: number, source: string) => {
+      const value = fields[placeholderField(token)];
+      if (typeof value !== 'string') return match;
+      const lineStart = source.lastIndexOf('\n', offset - 1) + 1;
+      const literal = source.slice(lineStart, offset);
+      return literal === '> ' ? quotedContinuation(value) : value;
+    },
+  );
+  if (
+    input.pendingBossQuestion === undefined ||
+    input.bossReply === undefined
+  ) {
+    return body;
+  }
+  return [
+    CONTINUATION_PREAMBLE,
+    `Boss question:\n${input.pendingBossQuestion.question}`,
+    `Boss reply:\n${input.bossReply}`,
+    body,
+  ].join('\n\n');
+}
+
+export const _internal = {
+  composePlayerPrompt,
+  VERBATIM_PAYLOAD_FIELDS,
+  UNFINISHED_FINAL_STATE_IDS,
+};
+
+const runtimeSpec = {
+  label: 'DEV',
+  // 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: 3, runtimeAbi: 1 },
+  snapshotOptions: snapshotDevOptions,
+  entryEvent: {
+    type: 'START_DEV',
+    textField: 'developmentRequest',
+    // `startDev` copies the entry text here, so the failure-state retry
+    // reads it back from the persisted machine snapshot and survives a
+    // continued session (DR-034).
+    contextField: 'developmentRequest',
+  },
+  roleStates: {
+    planAnalysis: {
+      role: 'analyst',
+      label:
+        'Analyst is analyzing the development request to choose the smallest sound next step.',
+    },
+  },
+  // DR-044: DEV owns no repository commit — every Analyst outcome is
+  // governed with the `unchanged` repository disposition, so planning that
+  // mutates the repository fails authority instead of being adopted.
+  outcomeAuthority: {
+    governedPlayerStates: {
+      planAnalysis: {
+        discussionComplete: {
+          fields: {},
+          repositoryDisposition: 'unchanged',
+        },
+        code: {
+          fields: { planningResult: 'presentation' },
+          repositoryDisposition: 'unchanged',
+        },
+        decideThenCode: {
+          fields: { planningResult: 'presentation' },
+          repositoryDisposition: 'unchanged',
+        },
+        needsBossReply: {
+          fields: { question: 'presentation' },
+          repositoryDisposition: 'unchanged',
+        },
+      },
+    },
+  },
+  composePlayerPrompt: (input: PlaybookPlayerInput) =>
+    composePlayerPrompt(input as PlayerInput),
+  verbatimPayloadFields: VERBATIM_PAYLOAD_FIELDS,
+  controlContextFields: [],
+  unfinishedFinalStateIds: UNFINISHED_FINAL_STATE_IDS,
+  transitionEventFields: ['developmentRequest', 'answer', 'questionId'],
+} satisfies XStatePlaybookRuntimeSpecV3<DevPlaybookOptions>;
+
+const createPlaybookRuntime: XStatePlaybookRuntimeFactory<
+  XStatePlaybookRuntimeConstruction<
+    DevPlaybookOptions,
+    DevPlaybookHostCapabilities
+  >,
+  3
+> = createXStatePlaybookRuntime<
+  DevPlaybookOptions,
+  DevPlaybookHostCapabilities
+>(devMachine, runtimeSpec);
+
+export default createPlaybookRuntime;

package/reference/sdlc/dev.playbook/dev.registry.d.ts

@@ -0,0 +1,40 @@
+import { type DevPlaybookHostCapabilities, type PlaybookRuntime } from './dev.playbook.js';
+export interface PlaybookSummaryPolicy {
+    stateCountLabels: Readonly<Record<string, string>>;
+    copyPasteGuardNames: readonly string[];
+    savedCountsLine(counts: {
+        interruptions: number;
+        copyPastes: number;
+    }, rounds: number): string;
+}
+export type DevOptions = Readonly<Record<string, never>>;
+export interface DevPlaybookRegistryEntry {
+    id: 'dev';
+    command: 'dev';
+    intent: string;
+    artifactSchema: 3;
+    runtimeProfile: {
+        readonly kind: 'shared-factory';
+        readonly compat: {
+            readonly artifactSchema: 3;
+            readonly runtimeAbi: number;
+        };
+    };
+    requiredRoleIds: readonly ['analyst'];
+    concurrentRoleSets: readonly [];
+    summaryPolicy: PlaybookSummaryPolicy;
+    validateOptions(optionSlice: unknown): DevOptions;
+    createRuntime(options: DevOptions, hostCapabilities: DevPlaybookHostCapabilities): PlaybookRuntime;
+}
+export declare const devStateCountLabels: {
+    readonly planAnalysis: "planning round";
+};
+export declare const devCopyPasteGuardNames: readonly ["code", "decideThenCode"];
+export declare function devSavedCountsLine(counts: {
+    interruptions: number;
+    copyPastes: number;
+}, rounds: number): string;
+export declare const devSummaryPolicy: PlaybookSummaryPolicy;
+export declare function validateDevOptions(optionSlice: unknown): DevOptions;
+export declare const devPlaybookRegistryEntry: DevPlaybookRegistryEntry;
+export default devPlaybookRegistryEntry;

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

@@ -0,0 +1,64 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+import createPlaybookRuntime from './dev.playbook.js';
+// CODE and DECIDE own and label the rounds of the paths DEV starts. DEV's
+// suspended call states only delegate to those children and must not
+// double-count their rounds; only the Analyst planning rounds are DEV's own.
+export const devStateCountLabels = {
+    planAnalysis: 'planning round',
+};
+export const devCopyPasteGuardNames = ['code', 'decideThenCode'];
+function countNoun(count, singular, plural = `${singular}s`) {
+    return `${count} ${count === 1 ? singular : plural}`;
+}
+export function devSavedCountsLine(counts, rounds) {
+    return [
+        'Saved you',
+        countNoun(counts.interruptions, 'interruption'),
+        'and',
+        countNoun(counts.copyPastes, 'copy-paste'),
+        'across',
+        countNoun(rounds, 'round'),
+        'of planning.',
+    ].join(' ');
+}
+export const devSummaryPolicy = {
+    stateCountLabels: devStateCountLabels,
+    copyPasteGuardNames: devCopyPasteGuardNames,
+    savedCountsLine: devSavedCountsLine,
+};
+export function validateDevOptions(optionSlice) {
+    if (optionSlice === undefined)
+        return Object.freeze({});
+    if (optionSlice === null ||
+        typeof optionSlice !== 'object' ||
+        Array.isArray(optionSlice)) {
+        throw new Error('captain.options.playbooks.dev.options must be an object');
+    }
+    const keys = Object.keys(optionSlice);
+    if (keys.length > 0) {
+        throw new Error(`Unknown config field captain.options.playbooks.dev.options.${keys[0]}`);
+    }
+    return Object.freeze({});
+}
+export const devPlaybookRegistryEntry = {
+    id: 'dev',
+    command: 'dev',
+    intent: 'analyze a development request that needs planning before choosing direct implementation or a durable decision first',
+    artifactSchema: 3,
+    runtimeProfile: Object.freeze({
+        kind: 'shared-factory',
+        compat: createPlaybookRuntime.compat,
+    }),
+    requiredRoleIds: ['analyst'],
+    concurrentRoleSets: [],
+    summaryPolicy: devSummaryPolicy,
+    validateOptions: validateDevOptions,
+    createRuntime(options, hostCapabilities) {
+        return createPlaybookRuntime({
+            configuredOptions: options,
+            hostCapabilities,
+        });
+    },
+};
+export default devPlaybookRegistryEntry;