@sublang/playbook 13.0.0 → 13.1.0

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

@@ -137,9 +137,9 @@ export type DevEvent =
     };
 
 const PLAN_ANALYSIS_PROMPT = [
-  '> <development-request>',
-  '> <discussion-context>',
-  '> <run-results>',
+  '> Original request: <development-request>',
+  '> Prior discussion: <discussion-context>',
+  '> Run results: <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.',
@@ -590,11 +590,11 @@ function archivedExchanges(
   ];
 }
 
-function quotedRelay(values: readonly string[]): string {
+function quotedRelay(values: readonly (readonly [string, string])[]): string {
   return values
-    .filter((value) => value.length > 0)
-    .map((value) =>
-      value
+    .filter(([, value]) => value.length > 0)
+    .map(([label, value]) =>
+      `${label}: ${value}`
         .split('\n')
         .map((line) => `> ${line}`)
         .join('\n'),
@@ -602,11 +602,11 @@ function quotedRelay(values: readonly string[]): string {
     .join('\n');
 }
 
-function planningRelayValues(context: DevContext): readonly string[] {
+function planningRelayValues(context: DevContext): readonly (readonly [string, string])[] {
   return [
-    context.developmentRequest ?? '',
-    renderDiscussionContext(context.discussionExchanges),
-    context.planningResult ?? '',
+    ['Original request', context.developmentRequest ?? ''],
+    ['Prior discussion', renderDiscussionContext(context.discussionExchanges)],
+    ['Planning result', context.planningResult ?? ''],
   ];
 }
 
@@ -621,8 +621,8 @@ function decideCallText(context: DevContext): string {
 function codeAfterDecideCallText(context: DevContext): string {
   return quotedRelay([
     ...planningRelayValues(context),
-    context.decideCommit ?? '',
-    context.evaluatedRevision ?? '',
+    ['DECIDE commit', context.decideCommit ?? ''],
+    ['Evaluated revision', context.evaluatedRevision ?? ''],
   ]);
 }
 

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

@@ -16,9 +16,9 @@ It coordinates existing playbooks and owns no repository commit itself.
 
 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>
+> > Original request: <development-request>
+> > Prior discussion: <discussion-context>
+> > Run results: <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.
@@ -40,7 +40,7 @@ Results:
 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.
+- Needs Boss reply uses the standard Boss-question suspension with Analyst's complete response; after Boss replies, `dev` resumes with the answer in the same Analyst conversation; the previous question is included only when that conversation must start fresh.
 - 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.
 
@@ -50,9 +50,9 @@ Workflow outcomes:
 
 When the accepted planning result selects `code`, Captain shall call playbook `code`:
 
-> > <development-request>
-> > <discussion-context>
-> > <planning-result>
+> > Original request: <development-request>
+> > Prior discussion: <discussion-context>
+> > Planning result: <planning-result>
 
 Workflow outcomes:
 - `code` success completes `dev` with the successful `code` result.
@@ -64,9 +64,9 @@ Workflow outcomes:
 
 When the accepted planning result selects `decide then code`, Captain shall call playbook `decide`:
 
-> > <development-request>
-> > <discussion-context>
-> > <planning-result>
+> > Original request: <development-request>
+> > Prior discussion: <discussion-context>
+> > Planning result: <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.
@@ -78,11 +78,11 @@ Workflow outcomes:
 
 When `decide` succeeds, Captain shall call playbook `code`:
 
-> > <development-request>
-> > <discussion-context>
-> > <planning-result>
-> > <decide-commit>
-> > <evaluated-revision>
+> > Original request: <development-request>
+> > Prior discussion: <discussion-context>
+> > Planning result: <planning-result>
+> > DECIDE commit: <decide-commit>
+> > Evaluated revision: <evaluated-revision>
 
 Workflow outcomes:
 - `code` success completes `dev` with the successful `code` result.

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

@@ -11,7 +11,7 @@ export type DevPlaybookHostCapabilities = PlaybookHostConstructionCapabilities &
  * 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;
+declare function composePlayerPrompt(input: PlayerInput, resuming?: boolean): string;
 export declare const _internal: {
     composePlayerPrompt: typeof composePlayerPrompt;
     VERBATIM_PAYLOAD_FIELDS: ReadonlySet<string>;

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

@@ -11,11 +11,10 @@
 //                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 { createXStatePlaybookRuntime, composePlayerContinuation, 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',
 ]);
@@ -54,13 +53,13 @@ function quotedContinuation(value) {
  * override additionally keeps a multiline value inside that quote and drops
  * the optional relays that have no value yet.
  */
-function composePlayerPrompt(input) {
+function composePlayerPrompt(input, resuming = false) {
     const fields = input;
     const template = input.prompt
         .split('\n')
-        .filter((line) => !(line === '> <discussion-context>' &&
+        .filter((line) => !(line === '> Prior discussion: <discussion-context>' &&
         input.discussionContext.length === 0) &&
-        !(line === '> <run-results>' && input.runResults.length === 0))
+        !(line === '> Run results: <run-results>' && input.runResults.length === 0))
         .join('\n');
     const body = template.replace(PLACEHOLDER, (match, token, offset, source) => {
         const value = fields[placeholderField(token)];
@@ -68,18 +67,9 @@ function composePlayerPrompt(input) {
             return match;
         const lineStart = source.lastIndexOf('\n', offset - 1) + 1;
         const literal = source.slice(lineStart, offset);
-        return literal === '> ' ? quotedContinuation(value) : value;
+        return literal.startsWith('> ') ? 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');
+    return composePlayerContinuation(input, body, resuming);
 }
 export const _internal = {
     composePlayerPrompt,
@@ -133,7 +123,7 @@ const runtimeSpec = {
             },
         },
     },
-    composePlayerPrompt: (input) => composePlayerPrompt(input),
+    composePlayerPrompt: (input, _identity, resuming) => composePlayerPrompt(input, resuming),
     verbatimPayloadFields: VERBATIM_PAYLOAD_FIELDS,
     controlContextFields: [],
     unfinishedFinalStateIds: UNFINISHED_FINAL_STATE_IDS,

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

@@ -14,6 +14,7 @@
 
 import {
   createXStatePlaybookRuntime,
+  composePlayerContinuation,
   snapshotJsonValue,
   type PlaybookPlayerInput,
   type XStatePlaybookRuntimeFactory,
@@ -85,8 +86,6 @@ export type DevPlaybookHostCapabilities =
 
 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',
@@ -133,17 +132,17 @@ function quotedContinuation(value: string): string {
  * override additionally keeps a multiline value inside that quote and drops
  * the optional relays that have no value yet.
  */
-function composePlayerPrompt(input: PlayerInput): string {
+function composePlayerPrompt(input: PlayerInput, resuming = false): string {
   const fields = input as unknown as Record<string, unknown>;
   const template = input.prompt
     .split('\n')
     .filter(
       (line) =>
         !(
-          line === '> <discussion-context>' &&
+          line === '> Prior discussion: <discussion-context>' &&
           input.discussionContext.length === 0
         ) &&
-        !(line === '> <run-results>' && input.runResults.length === 0),
+        !(line === '> Run results: <run-results>' && input.runResults.length === 0),
     )
     .join('\n');
   const body = template.replace(
@@ -153,21 +152,10 @@ function composePlayerPrompt(input: PlayerInput): string {
       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;
+      return literal.startsWith('> ') ? 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');
+  return composePlayerContinuation(input, body, resuming);
 }
 
 export const _internal = {
@@ -224,8 +212,8 @@ const runtimeSpec = {
       },
     },
   },
-  composePlayerPrompt: (input: PlaybookPlayerInput) =>
-    composePlayerPrompt(input as PlayerInput),
+  composePlayerPrompt: (input: PlaybookPlayerInput, _identity, resuming) =>
+    composePlayerPrompt(input as PlayerInput, resuming),
   verbatimPayloadFields: VERBATIM_PAYLOAD_FIELDS,
   controlContextFields: [],
   unfinishedFinalStateIds: UNFINISHED_FINAL_STATE_IDS,

package/reference/sdlc/review.md

@@ -27,6 +27,10 @@ Keep to the original intent and follow what it asks.
 When the scope names commits, read each commit message for its context and rationale; otherwise use repository history and commit messages wherever they help establish that context.
 ```
 
+Captain shall append the caller’s input in quotes (`>`):
+
+> Original request: <caller-input>
+
 After every review-fix commit, Captain shall give Reviewer the following instruction:
 
 ```markdown
@@ -35,6 +39,12 @@ Keep to the original intent and follow what it asks.
 Read the latest review-fix commit's message and see Coder's feedback below.
 ```
 
+Captain shall append the round’s context in quotes (`>`):
+
+> Original request: <caller-input>
+> Latest commit: <latest-commit>
+> Coder output: <coder-output>
+
 When Coder rejects every finding and makes no commit, Captain shall give Reviewer the following instruction:
 
 ```markdown
@@ -42,6 +52,11 @@ No new commit was made because Coder rejected every finding.
 See Coder's feedback below.
 ```
 
+Captain shall append the round’s context in quotes (`>`):
+
+> Original request: <caller-input>
+> Coder output: <coder-output>
+
 At the start of *every* review round, Captain shall relay to Reviewer the original intent, the review scope and context, the exact repository revision being evaluated, any Coder feedback from the preceding round, and any relevant run results, in quotes (`>`) after the instruction.
 
 At the start of *every* review round, Captain shall append the following instruction to the end of the prompt:
@@ -70,6 +85,9 @@ No review transition shall depend on numbering or any fixed presentation format
 
 When Reviewer raises or keeps any finding, Captain shall relay the original intent, the review scope and context, the exact repository revision being evaluated, the Reviewer's findings, and any relevant run results to Coder, in quotes (`>`), along with the following prompt:
 
+> Original request: <caller-input>
+> Reviewer findings: <reviewer-output>
+
 ```markdown
 For each review item, accept or reject it.
 Before deciding, understand the full picture and think systematically about the underlying design.

package/reference/sdlc/review.playbook/review.fsm.js

@@ -27,7 +27,7 @@ const INITIAL_REVIEW_PROMPT = [
     'Keep to the original intent and follow what it asks.',
     'When the scope names commits, read each commit message for its context and rationale; otherwise use repository history and commit messages wherever they help establish that context.',
     '',
-    '> <caller-input>',
+    '> Original request: <caller-input>',
     '',
     SHARED_REVIEW_INSTRUCTION,
 ].join('\n');
@@ -36,9 +36,9 @@ const POST_COMMIT_REVIEW_PROMPT = [
     'Keep to the original intent and follow what it asks.',
     "Read the latest review-fix commit's message and see Coder's feedback below.",
     '',
-    '> <caller-input>',
-    '> <latest-commit>',
-    '> <coder-output>',
+    '> Original request: <caller-input>',
+    '> Latest commit: <latest-commit>',
+    '> Coder output: <coder-output>',
     '',
     SHARED_REVIEW_INSTRUCTION,
 ].join('\n');
@@ -46,14 +46,14 @@ const REBUTTAL_REVIEW_PROMPT = [
     'No new commit was made because Coder rejected every finding.',
     "See Coder's feedback below.",
     '',
-    '> <caller-input>',
-    '> <coder-output>',
+    '> Original request: <caller-input>',
+    '> Coder output: <coder-output>',
     '',
     SHARED_REVIEW_INSTRUCTION,
 ].join('\n');
 const CODER_DISPOSITION_PROMPT = [
-    '> <caller-input>',
-    '> <reviewer-output>',
+    '> Original request: <caller-input>',
+    '> Reviewer findings: <reviewer-output>',
     '',
     'For each review item, accept or reject it.',
     'Before deciding, understand the full picture and think systematically about the underlying design.',

package/reference/sdlc/review.playbook/review.fsm.ts

@@ -113,7 +113,7 @@ const INITIAL_REVIEW_PROMPT = [
   'Keep to the original intent and follow what it asks.',
   'When the scope names commits, read each commit message for its context and rationale; otherwise use repository history and commit messages wherever they help establish that context.',
   '',
-  '> <caller-input>',
+  '> Original request: <caller-input>',
   '',
   SHARED_REVIEW_INSTRUCTION,
 ].join('\n');
@@ -123,9 +123,9 @@ const POST_COMMIT_REVIEW_PROMPT = [
   'Keep to the original intent and follow what it asks.',
   "Read the latest review-fix commit's message and see Coder's feedback below.",
   '',
-  '> <caller-input>',
-  '> <latest-commit>',
-  '> <coder-output>',
+  '> Original request: <caller-input>',
+  '> Latest commit: <latest-commit>',
+  '> Coder output: <coder-output>',
   '',
   SHARED_REVIEW_INSTRUCTION,
 ].join('\n');
@@ -134,15 +134,15 @@ const REBUTTAL_REVIEW_PROMPT = [
   'No new commit was made because Coder rejected every finding.',
   "See Coder's feedback below.",
   '',
-  '> <caller-input>',
-  '> <coder-output>',
+  '> Original request: <caller-input>',
+  '> Coder output: <coder-output>',
   '',
   SHARED_REVIEW_INSTRUCTION,
 ].join('\n');
 
 const CODER_DISPOSITION_PROMPT = [
-  '> <caller-input>',
-  '> <reviewer-output>',
+  '> Original request: <caller-input>',
+  '> Reviewer findings: <reviewer-output>',
   '',
   'For each review item, accept or reject it.',
   'Before deciding, understand the full picture and think systematically about the underlying design.',

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

@@ -23,7 +23,7 @@ When the caller starts a review, Captain shall relay the complete caller input t
 > Keep to the original intent and follow what it asks.
 > When the scope names commits, read each commit message for its context and rationale; otherwise use repository history and commit messages wherever they help establish that context.
 >
-> > <caller-input>
+> > Original request: <caller-input>
 >
 > Understand the full picture and think systematically about the underlying design.
 > Continue to identify issues or improvements, if any, without duplication.
@@ -50,8 +50,8 @@ Results:
 
 When Reviewer raises or keeps any finding, Captain shall relay the caller input and Reviewer's findings to Coder with the disposition prompt:
 
-> > <caller-input>
-> > <reviewer-output>
+> > Original request: <caller-input>
+> > Reviewer findings: <reviewer-output>
 >
 > For each review item, accept or reject it.
 > Before deciding, understand the full picture and think systematically about the underlying design.
@@ -82,9 +82,9 @@ When Coder makes a review-fix commit, Captain shall relay the caller input, the
 > Keep to the original intent and follow what it asks.
 > Read the latest review-fix commit's message and see Coder's feedback below.
 >
-> > <caller-input>
-> > <latest-commit>
-> > <coder-output>
+> > Original request: <caller-input>
+> > Latest commit: <latest-commit>
+> > Coder output: <coder-output>
 >
 > Understand the full picture and think systematically about the underlying design.
 > Continue to identify issues or improvements, if any, without duplication.
@@ -114,8 +114,8 @@ When Coder rejects every finding and makes no commit, Captain shall relay the ca
 > No new commit was made because Coder rejected every finding.
 > See Coder's feedback below.
 >
-> > <caller-input>
-> > <coder-output>
+> > Original request: <caller-input>
+> > Coder output: <coder-output>
 >
 > Understand the full picture and think systematically about the underlying design.
 > Continue to identify issues or improvements, if any, without duplication.

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

@@ -6,7 +6,7 @@ export type { CaptainCallOptions, CaptainResult, JsonValue, NormalizedError, Pla
 export type ReviewPlaybookOptions = ReviewInput;
 export type ReviewPlaybookHostCapabilities = PlaybookHostConstructionCapabilities & XStatePlaybookRuntimeConstruction<ReviewPlaybookOptions, object>['hostCapabilities'];
 /** Keep every line of a relayed runtime value inside its authored quote. */
-declare function composePlayerPrompt(input: PlayerInput, promptIdentity: XStatePromptIdentity): string;
+declare function composePlayerPrompt(input: PlayerInput, promptIdentity: XStatePromptIdentity, resuming?: boolean): string;
 export declare const _internal: {
     composePlayerPrompt: typeof composePlayerPrompt;
     VERBATIM_PAYLOAD_FIELDS: ReadonlySet<string>;

package/reference/sdlc/review.playbook/review.playbook.js

@@ -10,10 +10,9 @@
 //                carried verbatim; latestCommit is receipt-owned effect
 //                evidence, never taken from either player's prose
 // Compat:        artifact schema 3 / runtime ABI 1
-import { createXStatePlaybookRuntime, snapshotJsonValue, } from '@sublang/playbook/xstate-runtime';
+import { createXStatePlaybookRuntime, composePlayerContinuation, snapshotJsonValue, } from '@sublang/playbook/xstate-runtime';
 import { reviewMachine, } from './review.fsm.js';
 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([
     'reviewerOutput',
     'coderOutput',
@@ -41,7 +40,7 @@ function quotedContinuation(value) {
     return value.replaceAll('\n', '\n> ');
 }
 /** Keep every line of a relayed runtime value inside its authored quote. */
-function composePlayerPrompt(input, promptIdentity) {
+function composePlayerPrompt(input, promptIdentity, resuming = false) {
     const fields = input;
     const body = input.prompt.replace(PLACEHOLDER, (match, token, offset, source) => {
         const value = token === 'coder-llm'
@@ -52,20 +51,11 @@ function composePlayerPrompt(input, promptIdentity) {
         if (typeof value !== 'string')
             return match;
         const lineStart = source.lastIndexOf('\n', offset - 1) + 1;
-        return source.slice(lineStart, offset) === '> '
+        return source.slice(lineStart, offset).startsWith('> ')
             ? 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');
+    return composePlayerContinuation(input, body, resuming);
 }
 export const _internal = {
     composePlayerPrompt,
@@ -175,7 +165,7 @@ const runtimeSpec = {
             },
         },
     },
-    composePlayerPrompt: (input, promptIdentity) => composePlayerPrompt(input, promptIdentity),
+    composePlayerPrompt: (input, promptIdentity, resuming) => composePlayerPrompt(input, promptIdentity, resuming),
     verbatimPayloadFields: VERBATIM_PAYLOAD_FIELDS,
     controlContextFields: [],
     unfinishedFinalStateIds: UNFINISHED_FINAL_STATE_IDS,

package/reference/sdlc/review.playbook/review.playbook.ts

@@ -13,6 +13,7 @@
 
 import {
   createXStatePlaybookRuntime,
+  composePlayerContinuation,
   snapshotJsonValue,
   type PlaybookPlayerInput,
   type XStatePlaybookRuntimeFactory,
@@ -84,8 +85,6 @@ export type ReviewPlaybookHostCapabilities =
     XStatePlaybookRuntimeConstruction<ReviewPlaybookOptions, object>['hostCapabilities'];
 
 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([
   'reviewerOutput',
@@ -124,6 +123,7 @@ function quotedContinuation(value: string): string {
 function composePlayerPrompt(
   input: PlayerInput,
   promptIdentity: XStatePromptIdentity,
+  resuming = false,
 ): string {
   const fields = input as unknown as Record<string, unknown>;
   const body = input.prompt.replace(
@@ -137,23 +137,12 @@ function composePlayerPrompt(
             : fields[placeholderField(token)];
       if (typeof value !== 'string') return match;
       const lineStart = source.lastIndexOf('\n', offset - 1) + 1;
-      return source.slice(lineStart, offset) === '> '
+      return source.slice(lineStart, offset).startsWith('> ')
         ? 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');
+  return composePlayerContinuation(input, body, resuming);
 }
 
 export const _internal = {
@@ -271,7 +260,8 @@ const runtimeSpec = {
   composePlayerPrompt: (
     input: PlaybookPlayerInput,
     promptIdentity: XStatePromptIdentity,
-  ) => composePlayerPrompt(input as PlayerInput, promptIdentity),
+    resuming?: boolean,
+  ) => composePlayerPrompt(input as PlayerInput, promptIdentity, resuming),
   verbatimPayloadFields: VERBATIM_PAYLOAD_FIELDS,
   controlContextFields: [],
   unfinishedFinalStateIds: UNFINISHED_FINAL_STATE_IDS,

package/slc/link.md

@@ -489,6 +489,7 @@ interface PlaybookPorts {
 
 interface PlayerCallOptions {
   resume: string | false;
+  freshPrompt?: string;
 }
 
 interface CaptainCallOptions {
@@ -865,30 +866,17 @@ Those blocks are outside the domain prompt body.
 The composer shall not inject a player-visible Boss-question instruction.
 Boss-question detection is adjudicator-facing: it comes from the state's `needsBossReply` result description, not from extra prompt text.
 
-When `PlayerInput` carries both `pendingBossQuestion` and `bossReply`, the
-composer shall prepend the continuation preamble and labelled Q&A blocks before
-ordinary structured blocks and before the domain prompt body:
-
-```text
-You previously paused this task to ask Boss a question; Boss has now replied. Continue the same task using the reply below.
-
-Boss question:
-<pendingBossQuestion.question>
-
-Boss reply:
-<bossReply>
-
-```
-
-The continuation preamble is framework text supplied by the runtime.
-It is not part of the GEARS blockquote and shall not appear in `invoke.input.prompt`.
-The composer shall retain the blank line after the Boss reply before the next
-structured block or domain prompt, producing exactly two newline characters at
-that boundary.
-When implementing the prefix as an array joined with `"\n"`, the array needs
-two trailing empty strings after `bossReply`; one trailing empty string emits
-only one newline and is nonconformant. Equivalently, append `"\n\n"` exactly
-once before the following block or domain body.
+When `PlayerInput` carries both `pendingBossQuestion` and `bossReply`, the composer receives an optional third `resuming` boolean after `promptIdentity`; absent means fresh.
+The shared `composePlayerContinuation(input, body, resuming)` helper prefixes the verbatim Boss reply and, only for a fresh conversation, the pending question labeled `Your previous question:`.
+A resumed call omits that question; a fresh call includes it before `Boss reply:`.
+Both retain the authored task body exactly once, with two newlines between blocks.
+These framework blocks never enter `invoke.input.prompt` or persisted FSM context.
+
+The runtime chooses the compact prompt only after selecting a conversation token and carries the complete prompt as optional `PlayerCallOptions.freshPrompt`.
+A host starting fresh after a definite pre-execution token rejection uses `freshPrompt`, when supplied, instead of the compact prompt.
+Without that option, the given prompt remains complete.
+Traces and host observations record the respective prompts actually sent.
+Old composers may ignore the optional argument and retain their full prompt.
 
 ## Captain prompt composition
 

package/src/runtime.d.ts

@@ -6,6 +6,8 @@ export interface PlayerResult {
 }
 export interface PlayerCallOptions {
     resume: string | false;
+    /** Complete task and clarification context if the host must start fresh. */
+    freshPrompt?: string;
 }
 export interface PlayerSessionStore {
     select(roleId: string): string | false;

package/src/runtime.ts

@@ -17,6 +17,8 @@ export interface PlayerResult {
 
 export interface PlayerCallOptions {
   resume: string | false;
+  /** Complete task and clarification context if the host must start fresh. */
+  freshPrompt?: string;
 }
 
 // DR-032: a composing host may supply one frame-local role view of the