@promptbook/cli 0.114.0-48 → 0.114.0-49

package/umd/scripts/run-codex-prompts/checks/CheckBeforeMode.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Modes supported by `ptbk coder run --check-before`.
+ */
+export declare const CHECK_BEFORE_MODE_VALUES: readonly ["no", "yes-and-fail", "yes-and-fix"];
+/**
+ * Behavior requested for the pre-coding check run.
+ */
+export type CheckBeforeMode = (typeof CHECK_BEFORE_MODE_VALUES)[number];
+/**
+ * Default check command used when a pre-coding mode is enabled without an explicit `--check` command.
+ */
+export declare const DEFAULT_CODER_CHECK_COMMAND = "npm run check";
+/**
+ * Resolves the shared command without enabling checks when both command and preflight mode are absent.
+ */
+export declare function resolveCoderCheckCommand(checkCommand?: string, checkBefore?: CheckBeforeMode): string | undefined;
+/**
+ * Checks whether a value is a supported `--check-before` mode.
+ */
+export declare function isCheckBeforeMode(value: string): value is CheckBeforeMode;

package/umd/scripts/run-codex-prompts/checks/checkRepairInstructions.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Shared constraints for initial repair PRDs and post-prompt check feedback.
+ */
+export declare const CHECK_REPAIR_INSTRUCTIONS: string;

package/umd/scripts/run-codex-prompts/checks/createCheckBeforeRepairPrompt.d.ts

@@ -0,0 +1,9 @@
+import type { PromptSelection } from '../prompts/types/PromptSelection';
+/**
+ * Creates the one queue prompt used to repair a pre-existing project check failure.
+ */
+export declare function createCheckBeforeRepairPrompt(options: {
+    readonly projectPath: string;
+    readonly checkCommand: string;
+    readonly checkOutput: string;
+}): Promise<PromptSelection>;

package/umd/scripts/run-codex-prompts/checks/limitCheckOutput.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Limits check output while keeping the end of the output, where check tools usually print the failure summary.
+ */
+export declare function limitCheckOutput(checkOutput: string): string;

package/umd/scripts/run-codex-prompts/checks/projectCheck.d.ts

@@ -0,0 +1,26 @@
+import { NotAllowed } from '../../../src/errors/NotAllowed';
+/**
+ * Failing setup placeholder used only when initialization finds no usable project validation scripts.
+ */
+export declare const CHECK_SETUP_PLACEHOLDER_COMMAND = "node -e \"console.error('Configure package.json scripts.check with project validation commands before running Coder.'); process.exit(1)\"";
+/**
+ * A missing or unconfigured project check needs project-owner setup, rather than model repair retries.
+ */
+export declare class CoderCheckSetupError extends NotAllowed {
+    /** Creates an actionable project check setup error. */
+    constructor(details: string);
+}
+/**
+ * Detects the generated setup placeholder and the conventional npm unconfigured-test placeholder.
+ */
+export declare function isCheckSetupRequired(command: string): boolean;
+/**
+ * Inspects root project check references before an initial check or repair loop can start.
+ * Flags and shell composition do not bypass setup validation; execution still uses the existing shell runner.
+ */
+export declare function assertProjectCheckIsConfigured(command: string | undefined, projectPath: string): Promise<void>;
+/**
+ * Validates the project-owned check definition without running commands or changing its scope.
+ * Initialization and execution use this same setup diagnostic for missing leaves and recursive callers.
+ */
+export declare function assertProjectCheckScriptsAreConfigured(scripts: Readonly<Record<string, unknown>>, name?: string): void;

package/umd/scripts/run-codex-prompts/checks/projectScriptReferences.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Reads conventional npm/pnpm/yarn script references for configuration inspection.
+ * Commands are still executed verbatim by the existing shell runner; this helper neither parses nor rewrites shells.
+ * Options selecting other workspaces remain opaque so their scripts are not mistaken for root validation.
+ * Inspection stops at the first directory change; quoted examples do not change the inspected workspace.
+ */
+export declare function projectScriptReferences(command: string): string[];

package/umd/scripts/run-codex-prompts/checks/runCheckBefore.d.ts

@@ -0,0 +1,26 @@
+import type { WaitForCoderRunPauseCheckpoint } from '../common/CoderRunPauseCheckpoint';
+import { runPromptCheckCommand } from './runPromptCheckCommand';
+/**
+ * Result of the check command executed before coding starts.
+ */
+export type CheckBeforeResult = {
+    /**
+     * Whether the check command completed successfully.
+     */
+    readonly isPassed: boolean;
+    /**
+     * Combined output produced by the check command.
+     */
+    readonly checkOutput: string;
+};
+/**
+ * Runs the configured check command before the first coding prompt.
+ */
+export declare function runCheckBefore(options: {
+    readonly checkCommand: string;
+    readonly projectPath: string;
+    readonly waitForPauseCheckpoint?: WaitForCoderRunPauseCheckpoint;
+    readonly runPromptCheckCommandExecutor?: typeof runPromptCheckCommand;
+    /** Optional cancellation forwarded to the shared command runner. */
+    readonly signal?: AbortSignal;
+}): Promise<CheckBeforeResult>;

package/umd/scripts/run-codex-prompts/checks/runPromptCheckCommand.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Options for running one check command after a coding attempt.
+ */
+export type RunPromptCheckCommandOptions = {
+    command: string;
+    projectPath: string;
+    scriptPath: string;
+    logPath?: string;
+    preserveArtifactsOnSuccess?: boolean;
+    /** Cancels the same shared shell runner used for other Coder processes. */
+    signal?: AbortSignal;
+};
+/**
+ * Runs the configured check command inside the project root and returns its output.
+ */
+export declare function runPromptCheckCommand(options: RunPromptCheckCommandOptions): Promise<string>;

package/umd/scripts/run-codex-prompts/{testing/runPromptWithTestFeedback.d.ts → checks/runPromptWithCheckFeedback.d.ts}

@@ -3,29 +3,29 @@ import { type OnCoderRunStepStarted } from '../common/createCoderRunStepTracker'
 import type { PromptRunOptions } from '../runners/types/PromptRunOptions';
 import type { PromptRunResult } from '../runners/types/PromptRunResult';
 import type { PromptRunner } from '../runners/types/PromptRunner';
-import { runPromptTestCommand } from './runPromptTestCommand';
+import { runPromptCheckCommand } from './runPromptCheckCommand';
 /**
- * Options for running one prompt with optional verification feedback retries.
+ * Options for running one prompt with optional check feedback retries.
  */
-type RunPromptWithTestFeedbackOptions = PromptRunOptions & {
+type RunPromptWithCheckFeedbackOptions = PromptRunOptions & {
     runner: PromptRunner;
     promptLabel: string;
-    testCommand?: string;
+    checkCommand?: string;
     onAttemptStarted?: (attemptCount: number) => void;
     /**
-     * Notified right before each implementation, testing and fixing step starts, so the caller can
+     * Notified right before each implementation, checking and fixing step starts, so the caller can
      * record the in-progress state of the prompt.
      */
     onStepStarted?: OnCoderRunStepStarted;
-    runPromptTestCommandExecutor?: typeof runPromptTestCommand;
+    runPromptCheckCommandExecutor?: typeof runPromptCheckCommand;
 };
 /**
  * Successful prompt execution result enriched with the number of attempts it took and its per-step usage breakdown.
  */
-export type RunPromptWithTestFeedbackResult = PromptRunResult & {
+export type RunPromptWithCheckFeedbackResult = PromptRunResult & {
     attemptCount: number;
     /**
-     * Ordered steps performed while producing this result (implementation, testing and fixing), each carrying
+     * Ordered steps performed while producing this result (implementation, checking and fixing), each carrying
      * its own price and duration so the finished prompt can report usage step by step.
      */
     steps: ReadonlyArray<CoderRunStep>;
@@ -33,5 +33,5 @@ export type RunPromptWithTestFeedbackResult = PromptRunResult & {
 /**
  * Runs one coding prompt and, when configured, verifies it with a shell command that can feed failures back.
  */
-export declare function runPromptWithTestFeedback(options: RunPromptWithTestFeedbackOptions): Promise<RunPromptWithTestFeedbackResult>;
+export declare function runPromptWithCheckFeedback(options: RunPromptWithCheckFeedbackOptions): Promise<RunPromptWithCheckFeedbackResult>;
 export {};

package/umd/scripts/run-codex-prompts/common/resolveCoderContext.d.ts

@@ -1,4 +1,4 @@
 /**
- * Resolves optional coding context provided inline or via a file path.
+ * Resolves project AGENTS.md on omission; explicit text, files and intentional empty values replace it.
  */
 export declare function resolveCoderContext(contextReference: string | undefined, currentWorkingDirectory: string): Promise<string | undefined>;

package/umd/scripts/run-codex-prompts/common/resolveCoderProjectContext.d.ts

@@ -0,0 +1,17 @@
+import { type ResolvedCoderAgentBook } from './resolveCoderAgent';
+/** Read-only inputs resolved once before installations, Book initialization or execution. */
+export type ResolvedCoderProjectContext = {
+    readonly projectPath: string;
+    readonly agentBook?: ResolvedCoderAgentBook;
+    readonly context?: string;
+};
+/**
+ * Resolves single-agent execution/authoring defaults without compiling Books or creating artifacts.
+ * Execution previews use the same identity and routing. Utilities and all-agent discovery resolve
+ * only the project directory and must not call this service to manufacture a primary-agent filter.
+ */
+export declare function resolveCoderProjectContext(options: {
+    readonly projectPath: string;
+    readonly agent?: string;
+    readonly context?: string;
+}): Promise<ResolvedCoderProjectContext>;

package/umd/scripts/run-codex-prompts/common/resolveInlineOrFileText.d.ts

@@ -6,6 +6,8 @@ type ResolveInlineOrFileTextOptions = {
     readonly currentWorkingDirectory: string;
     readonly contextLabel: string;
     readonly optionName: string;
+    /** Reject missing values that unambiguously look like paths instead of sending them as prose. */
+    readonly isMissingFileAnError?: boolean;
 };
 /**
  * Resolves optional CLI text provided inline or via a file path.

package/umd/scripts/run-codex-prompts/common/runGoScript/quoteBashArgument.d.ts

@@ -0,0 +1,2 @@
+/** Quotes one literal argument, including spaces and shell metacharacters, for a generated Bash script. */
+export declare function quoteBashArgument(value: string): string;

package/umd/scripts/run-codex-prompts/isolation/mapProjectReferenceToWorktree.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Rebinds an absolute reference inside a project/repository to its worktree copy. Relative references
+ * already resolve against the execution project; explicit references outside that checkout remain explicit.
+ */
+export declare function mapProjectReferenceToWorktree(reference: string | undefined, originalProjectPath: string, worktreeProjectPath: string): string | undefined;

package/umd/scripts/run-codex-prompts/main/runPromptRound.d.ts

@@ -27,10 +27,12 @@ export type RunPromptRoundOptions = {
      * when the round is isolated through `--isolate`.
      */
     projectPath?: string;
+    /** Explicit durable artifact location when a temporary execution worktree will be deleted. */
+    artifactsProjectPath?: string;
 };
 /**
  * Runs one prompt round from prompt construction through commit or failure logging.
  *
  * @private function of runCodexPrompts
  */
-export declare function runPromptRound({ options, runner, runnerMetadata, nextPrompt, promptLabel, resolvedCoderContext, resolvedAgentSystemMessage, isRichUiEnabled, progressDisplay, uiHandle, waitForRequestedPause, projectPath, }: RunPromptRoundOptions): Promise<void>;
+export declare function runPromptRound({ options, runner, runnerMetadata, nextPrompt, promptLabel, resolvedCoderContext, resolvedAgentSystemMessage, isRichUiEnabled, progressDisplay, uiHandle, waitForRequestedPause, projectPath, artifactsProjectPath, }: RunPromptRoundOptions): Promise<void>;

package/umd/scripts/run-codex-prompts/prompts/buildPromptLabel.d.ts

@@ -3,4 +3,4 @@ import type { PromptSection } from './types/PromptSection';
 /**
  * Builds a label that identifies the prompt section by index.
  */
-export declare function buildPromptLabel(file: PromptFile, section: PromptSection): string;
+export declare function buildPromptLabel(file: PromptFile, section: PromptSection, projectPath?: string): string;

package/umd/scripts/run-codex-prompts/prompts/buildPromptLabelForDisplay.d.ts

@@ -3,4 +3,4 @@ import type { PromptSection } from './types/PromptSection';
 /**
  * Builds a display label using the prompt line number for easier navigation.
  */
-export declare function buildPromptLabelForDisplay(file: PromptFile, section: PromptSection): string;
+export declare function buildPromptLabelForDisplay(file: PromptFile, section: PromptSection, projectPath?: string): string;

package/umd/scripts/run-codex-prompts/prompts/buildPromptRunTraceContent.d.ts

@@ -30,12 +30,14 @@ export type PromptRunTraceOutcome = {
  * Everything one run trace says about the prompt round it describes.
  */
 export type BuildPromptRunTraceContentOptions = FormatRunnerSignatureOptions & {
+    /** Selected execution project used for trace links, including in temporary worktrees. */
+    readonly projectPath?: string;
     readonly file: PromptFile;
     readonly section: PromptSection;
     /**
      * Verification command the round ran after each coding attempt, when one is configured.
      */
-    readonly testCommand?: string;
+    readonly checkCommand?: string;
     /**
      * How many coding attempts the round has taken.
      */

package/umd/scripts/run-codex-prompts/prompts/formatCoderRunSteps.d.ts

@@ -3,10 +3,10 @@ import type { CoderRunStep, CoderRunStepKind } from '../common/CoderRunStep';
  * Formats the per-step usage breakdown recorded for one prompt.
  *
  * Produces a `; `-separated summary such as
- * `Implementation $8.01 6 hours; Testing 1 hour; Fixing $3.14 2 hours` where each coding step carries its
+ * `Implementation $8.01 6 hours; Checking 1 hour; Fixing $3.14 2 hours` where each coding step carries its
  * price and duration and each verification step carries only its duration.
  *
  * @param steps - Steps which have already finished
- * @param inProgressStepKind - Step which has started but has not finished yet, appended as `Testing in progress`
+ * @param inProgressStepKind - Step which has started but has not finished yet, appended as `Checking in progress`
  */
 export declare function formatCoderRunSteps(steps: ReadonlyArray<CoderRunStep>, inProgressStepKind?: CoderRunStepKind): string;

package/umd/scripts/run-codex-prompts/prompts/listUpcomingTasks.d.ts

@@ -5,4 +5,4 @@ import type { PriorityFilter } from './priorityFilter';
 /**
  * Lists upcoming tasks that are ready to run (no authoring placeholders).
  */
-export declare function listUpcomingTasks(files: PromptFile[], priorityFilter?: PriorityFilter, promptRunnerIdentity?: PromptRunnerIdentity): UpcomingTask[];
+export declare function listUpcomingTasks(files: PromptFile[], priorityFilter?: PriorityFilter, promptRunnerIdentity?: PromptRunnerIdentity, projectPath?: string): UpcomingTask[];

package/umd/scripts/run-codex-prompts/prompts/printPromptsToBeWritten.d.ts

@@ -3,4 +3,4 @@ import type { PromptFile } from './types/PromptFile';
 /**
  * Prints the list of prompts that still need to be written.
  */
-export declare function printPromptsToBeWritten(files: PromptFile[], priorityFilter?: PriorityFilter): void;
+export declare function printPromptsToBeWritten(files: PromptFile[], priorityFilter?: PriorityFilter, projectPath?: string): void;

package/umd/scripts/run-codex-prompts/server/buildCoderServerPromptResponse.d.ts

@@ -40,6 +40,8 @@ export type CoderServerPromptFileResponse = {
  * Input for converting parsed prompt files into the browser API shape.
  */
 export type BuildCoderServerPromptFileResponsesOptions = {
+    /** Resolved project directory shared by the queue, runner and HTTP server. */
+    readonly projectPath?: string;
     readonly promptFiles: readonly PromptFile[];
     readonly finishedPromptFiles: readonly PromptFile[];
     readonly priorityFilter: PriorityFilter;

package/umd/scripts/run-codex-prompts/team/createCoderTeamPromptRunner.d.ts

@@ -4,6 +4,6 @@ import { type CoderTeamEvent } from './CoderTeamRuntime';
  * Adds a scoped consultation transport around an existing adapter. Both primary and advisers keep exactly
  * that adapter's permissions and authentication. Only the enclosing Coder round owns tests, queues and Git operations.
  */
-export declare function createCoderTeamPromptRunner(runner: PromptRunner, agentBookReference?: string): PromptRunner;
+export declare function createCoderTeamPromptRunner(runner: PromptRunner, agentBookReference?: string, originalProjectPath?: string, originalRepositoryRoot?: string | undefined): PromptRunner;
 /** Appends attributed machine-readable events to the existing runtime log consumed by run traces. */
 export declare function appendCoderTeamEvent(logPath: string | undefined, event: CoderTeamEvent): Promise<void>;

package/umd/scripts/run-codex-prompts/ui/CoderRunUiState.d.ts

@@ -31,7 +31,7 @@ export type CoderRunConfig = {
     readonly serverUrl?: string;
     readonly priorityFilter?: PriorityFilter;
     readonly limit?: number;
-    readonly testCommand?: string;
+    readonly checkCommand?: string;
 };
 /**
  * Re-exported shared progress snapshot type used by the coder run UI.

package/umd/src/cli/cli-commands/coder/agentCliOptions.d.ts

@@ -20,3 +20,8 @@ export declare const CODER_AGENT_OPTION_DESCRIPTION = "Book agent providing pers
  * @private internal utility of `ptbk coder`
  */
 export declare function addCoderAgentOption(command: Program, defaultRole?: CoderAgentRole): void;
+/**
+ * Registers the shared optional persona and context for single-agent execution or authoring.
+ * @private internal CLI registration helper
+ */
+export declare function addCoderExecutionOptions(command: Program): void;

package/umd/src/cli/cli-commands/coder/coderAgentRole.d.ts

@@ -14,3 +14,8 @@ export declare const CODER_DEFAULT_AGENT_BOOK_PATHS: {
  * @private internal type of `ptbk coder`
  */
 export type CoderAgentRole = keyof typeof CODER_DEFAULT_AGENT_BOOK_PATHS;
+/**
+ * Shared persona for optional single-agent execution and authoring; capabilities belong to the command.
+ * @private internal constant of project CLI commands
+ */
+export declare const DEFAULT_CODER_AGENT_ROLE: CoderAgentRole;

package/umd/src/cli/cli-commands/coder/coderReferencedArtifacts.d.ts

@@ -25,9 +25,9 @@ export type EnsuredCoderReferencedArtifact = {
     readonly diagnostic?: string;
 };
 /**
- * Initializes artifacts referenced by freshly added scripts. Default Books are ensured separately.
+ * Initializes essential context and artifacts referenced by freshly added scripts. Books are ensured separately.
  *
- * For artifacts other than role Books, an existing project script does not cause default files to be created.
+ * AGENTS.md is essential even when every script already exists or uses implicit defaults.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */

package/umd/src/cli/cli-commands/coder/ensureCoderPackageJsonFile.d.ts

@@ -1,9 +1,10 @@
 import type { MergedStringRecordJsonFile } from './mergeStringRecordJsonFile';
+import { type PreparedCoderPackageJsonScripts } from './prepareCoderPackageJsonScripts';
 /**
  * Ensures `package.json` contains the standalone Promptbook coder helper scripts.
  *
- * Scripts which the project already defines are kept as they are, only missing ones are added.
+ * Project definitions are preserved; missing scripts and narrowly recognized generated migrations are applied.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */
-export declare function ensureCoderPackageJsonFile(projectPath: string): Promise<MergedStringRecordJsonFile>;
+export declare function ensureCoderPackageJsonFile(projectPath: string): Promise<MergedStringRecordJsonFile & Omit<PreparedCoderPackageJsonScripts, 'scripts'>>;

package/umd/src/cli/cli-commands/coder/ensureCoderPackageJsonFile.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/cli/cli-commands/coder/findLegacyCoderCheckCallers.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Finds external project callers conservatively; it never rewrites their shell expressions.
+ * @private migration safety check for the Coder initializer
+ */
+export declare function findLegacyCoderCheckCallers(projectPath: string, legacyNames: ReadonlyArray<string>): Promise<Readonly<Record<string, ReadonlyArray<string>>>>;

package/umd/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.d.ts

@@ -20,6 +20,12 @@ export type CoderInitializationSummary = {
     readonly addedPackageJsonScriptNames: ReadonlyArray<string>;
     readonly referencedArtifactStatuses: ReadonlyArray<EnsuredCoderReferencedArtifact>;
     readonly initializedEnvVariableNames: ReadonlyArray<string>;
+    /** Actual preserved or generated scope of the project check. */
+    readonly checkScriptSummary: string;
+    /** Manual steps needed for custom or conflicting legacy entries. */
+    readonly migrationInstructions: ReadonlyArray<string>;
+    /** Whether validation is configured rather than still requiring setup. */
+    readonly isCheckConfigured: boolean;
 };
 /**
  * Creates or updates all coder configuration artifacts required in the current project.

package/umd/src/cli/cli-commands/coder/mergeStringRecordJsonFile.d.ts

@@ -8,6 +8,8 @@ type MergeStringRecordJsonFileOptions = {
     readonly fieldPath: string;
     readonly nextEntries: Readonly<Record<string, string>>;
     readonly ensureParentDirectoryPath?: string;
+    /** Optional narrowly scoped migration of existing entries before missing defaults are added. */
+    readonly transformExistingEntries?: (entries: Readonly<Record<string, string>>) => Readonly<Record<string, string>> | Promise<Readonly<Record<string, string>>>;
 };
 /**
  * Result of one additive string-record merge into a JSON file.
@@ -27,10 +29,10 @@ export type MergedStringRecordJsonFile = {
 /**
  * Ensures one JSON object field contains the provided string-record entries.
  *
- * Entries which the project already defines are **never** overridden - only missing keys are added,
- * so hand-tuned scripts and settings survive every repeated `ptbk coder init`.
+ * Entries are additive unless a caller explicitly supplies a scoped migration callback.
+ * Hand-tuned scripts and settings survive repeated `ptbk coder init`; migrations recognize generated entries only.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */
-export declare function mergeStringRecordJsonFile({ projectPath, relativeFilePath, fieldPath, nextEntries, ensureParentDirectoryPath, }: MergeStringRecordJsonFileOptions): Promise<MergedStringRecordJsonFile>;
+export declare function mergeStringRecordJsonFile({ projectPath, relativeFilePath, fieldPath, nextEntries, ensureParentDirectoryPath, transformExistingEntries, }: MergeStringRecordJsonFileOptions): Promise<MergedStringRecordJsonFile>;
 export {};

package/umd/src/cli/cli-commands/coder/planning/runPlanningSession.d.ts

@@ -1,3 +1,4 @@
+import { type ResolvedCoderProjectContext } from '../../../../../scripts/run-codex-prompts/common/resolveCoderProjectContext';
 import type { NormalizedPromptRunnerSelectionCliOptions } from '../../common/promptRunnerCliOptions';
 import { runPlanningHarness } from './runPlanningHarness';
 /**
@@ -16,6 +17,8 @@ export type PlanningSessionIo = {
 export declare function runPlanningSession(options: NormalizedPromptRunnerSelectionCliOptions & {
     readonly projectPath: string;
     readonly agent?: string;
+    readonly context?: string;
+    readonly projectContext?: ResolvedCoderProjectContext;
     readonly template?: string;
     readonly preexistingChangedPaths?: ReadonlySet<string>;
 }, io: PlanningSessionIo, harness?: typeof runPlanningHarness): Promise<ReadonlyMap<string, string>>;

package/umd/src/cli/cli-commands/coder/prepareCoderPackageJsonScripts.d.ts

@@ -0,0 +1,12 @@
+/** Result of preparing project-owned checks and migrating recognized generated callers. @private internal initializer result */
+export type PreparedCoderPackageJsonScripts = {
+    readonly scripts: Readonly<Record<string, string>>;
+    readonly checkScriptSummary: string;
+    readonly migrationInstructions: ReadonlyArray<string>;
+    readonly isCheckConfigured: boolean;
+};
+/**
+ * Preserves project scripts, creates one canonical check, and migrates only exact generated caller forms.
+ * @private shared package-script preparation for Coder initialization
+ */
+export declare function prepareCoderPackageJsonScripts(existing: Readonly<Record<string, string>>, externalCallers?: Readonly<Record<string, ReadonlyArray<string>>>): PreparedCoderPackageJsonScripts;

package/umd/src/cli/cli-commands/coder.d.ts

@@ -6,7 +6,7 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * The coder command provides utilities for automated coding:
  * - init: Initialize coder configuration in current project
  * - add: Add one ready-to-run prompt file to the queue
- * - plan: Discuss features with Planner and author reviewed PRDs
+ * - plan: Discuss features with Developer and author reviewed PRDs
  * - generate-boilerplates: Generate prompt boilerplate files
  * - find-refactor-candidates: Find files that need refactoring
  * - list: List ready prompts in priority order without running them

package/umd/src/cli/cli-commands/common/coderCheckCliOptions.d.ts

@@ -0,0 +1,21 @@
+import { Command } from 'commander';
+/**
+ * Retired aggregate option spellings and their canonical replacements, used only for migration diagnostics.
+ * @private shared CLI migration definitions for Coder execution
+ */
+export declare const LEGACY_CODER_CHECK_OPTIONS: readonly [readonly ["--test", "--check"], readonly ["--test-before", "--check-before"]];
+/**
+ * Registers the shared project check command and rejects retired aggregate-test spellings.
+ * @private shared CLI registration for Coder execution
+ */
+export declare function addCoderCheckOptions(command: Command, isCheckBeforeSupported: boolean): void;
+/**
+ * Builds the same actionable migration diagnostic for registered and direct-script entrypoints.
+ * @private shared CLI diagnostic for Coder execution
+ */
+export declare function formatLegacyCoderCheckOptionError(legacyFlag: string, replacementFlag: string): string;
+/**
+ * Normalizes shell command tokens without parsing a quoted command again or losing spaced argument boundaries.
+ * @private shared command normalization for Coder execution
+ */
+export declare function normalizeCheckCommandOption(value: string | ReadonlyArray<string> | undefined): string | undefined;

package/umd/src/cli/cli-commands/common/coderCheckCliOptions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/cli/cli-commands/common/projectCliOptions.d.ts

@@ -0,0 +1,30 @@
+import type { Command } from 'commander';
+/**
+ * Optional project selection shared by workspace actions, independently of Book and harness selection.
+ * @private internal CLI options
+ */
+export type ProjectCliOptions = {
+    readonly path?: string;
+};
+/**
+ * Registers project selection without capturing a directory during command registration.
+ * @private internal CLI registration helper
+ */
+export declare function addProjectPathOption(command: Command): void;
+/**
+ * Registers additional context independently of primary-agent selection.
+ * @private internal CLI registration helper
+ */
+export declare function addProjectContextOption(command: Command): void;
+/**
+ * Captures an invocation's directory at action time. No process-global state is changed.
+ * @private internal CLI normalization helper
+ */
+export declare function normalizeProjectCliOptions(options: ProjectCliOptions, invocationDirectory?: string): {
+    readonly projectDirectory: string;
+};
+/**
+ * Validates the selected directory before any setup writes, without selecting an enclosing Git root.
+ * @private shared project resolution for CLI services
+ */
+export declare function resolveProjectDirectory(projectDirectory: string): Promise<string>;

package/umd/src/cli/cli-commands/common/projectCliOptions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/cli/cli-commands/common/promptbook-cli/$checkPromptbookCliInstallations.d.ts

@@ -6,4 +6,4 @@ import type { PromptbookCliInstallationStatus } from './PromptbookCliInstallatio
  *
  * @private internal utility of `promptbookCli`
  */
-export declare function $checkPromptbookCliInstallations(): Promise<ReadonlyArray<PromptbookCliInstallationStatus>>;
+export declare function $checkPromptbookCliInstallations(projectPath?: string): Promise<ReadonlyArray<PromptbookCliInstallationStatus>>;

package/umd/src/cli/cli-commands/common/promptbook-cli/$ensurePromptbookCliInstallations.d.ts

@@ -12,4 +12,4 @@ import type { NormalizedQuestionsCliOptions } from '../questionsCliOptions';
  * @returns `true` when at least one installation was updated and the current coder run should stop
  * @private internal utility of `promptbookCli`
  */
-export declare function $ensurePromptbookCliInstallations(questionsOptions: NormalizedQuestionsCliOptions): Promise<boolean>;
+export declare function $ensurePromptbookCliInstallations(questionsOptions: NormalizedQuestionsCliOptions, projectPath?: string): Promise<boolean>;

package/umd/src/cli/cli-commands/common/promptbook-cli/$resolvePromptbookCliInstallations.d.ts

@@ -9,4 +9,4 @@ import { type PromptbookCliInstallation } from './PromptbookCliInstallation';
  *
  * @private internal utility of `promptbookCli`
  */
-export declare function $resolvePromptbookCliInstallations(): Promise<ReadonlyArray<PromptbookCliInstallation>>;
+export declare function $resolvePromptbookCliInstallations(projectPath?: string): Promise<ReadonlyArray<PromptbookCliInstallation>>;

package/umd/src/cli/cli-commands/common/promptbook-cli/$updatePromptbookCliInstallation.d.ts

@@ -7,4 +7,4 @@ import type { PromptbookCliInstallationStatus } from './PromptbookCliInstallatio
  * @returns `true` when the package update succeeds, `false` when it fails
  * @private internal utility of `promptbookCli`
  */
-export declare function $updatePromptbookCliInstallation(status: PromptbookCliInstallationStatus): Promise<boolean>;
+export declare function $updatePromptbookCliInstallation(status: PromptbookCliInstallationStatus, projectPath?: string): Promise<boolean>;

package/umd/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.114.0-47`).
+ * It follows semantic versioning (e.g., `0.114.0-48`).
  *
  * @generated
  */

package/esm/scripts/run-codex-prompts/testing/TestBeforeMode.d.ts

@@ -1,16 +0,0 @@
-/**
- * Modes supported by `ptbk coder run --test-before`.
- */
-export declare const TEST_BEFORE_MODE_VALUES: readonly ["no", "yes-and-fail", "yes-and-fix"];
-/**
- * Behavior requested for the pre-coding verification run.
- */
-export type TestBeforeMode = (typeof TEST_BEFORE_MODE_VALUES)[number];
-/**
- * Default verification command used when a pre-coding mode is enabled without an explicit `--test` command.
- */
-export declare const DEFAULT_CODER_TEST_COMMAND = "npm test";
-/**
- * Checks whether a value is a supported `--test-before` mode.
- */
-export declare function isTestBeforeMode(value: string): value is TestBeforeMode;

package/esm/scripts/run-codex-prompts/testing/createTestBeforeRepairPrompt.d.ts

@@ -1,9 +0,0 @@
-import type { PromptSelection } from '../prompts/types/PromptSelection';
-/**
- * Creates the one queue prompt used to repair a pre-existing test failure.
- */
-export declare function createTestBeforeRepairPrompt(options: {
-    readonly projectPath: string;
-    readonly testCommand: string;
-    readonly testOutput: string;
-}): Promise<PromptSelection>;

package/esm/scripts/run-codex-prompts/testing/limitTestOutput.d.ts

@@ -1,4 +0,0 @@
-/**
- * Limits test output while keeping the end of the output, where test runners usually print the failure summary.
- */
-export declare function limitTestOutput(testOutput: string): string;

package/esm/scripts/run-codex-prompts/testing/runPromptTestCommand.d.ts

@@ -1,14 +0,0 @@
-/**
- * Options for running one verification command after a coding attempt.
- */
-export type RunPromptTestCommandOptions = {
-    command: string;
-    projectPath: string;
-    scriptPath: string;
-    logPath?: string;
-    preserveArtifactsOnSuccess?: boolean;
-};
-/**
- * Runs the configured verification command inside the project root and returns its output.
- */
-export declare function runPromptTestCommand(options: RunPromptTestCommandOptions): Promise<string>;