@promptbook/cli 0.114.0-5 → 0.114.0-50

package/src/cli/cli-commands/coder/run.ts

@@ -1,15 +1,23 @@
-import colors from 'colors';
-import {
-    Command as Program /* <- Note: [🔸] Using Program because Command is misleading name */,
-    Option,
-} from 'commander';
+import { Command as Program /* <- Note: [🔸] Using Program because Command is misleading name */ } from 'commander';
 import { spaceTrim } from 'spacetrim';
 import { assertsError } from '../../../errors/assertsError';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
-import { createNonNegativeIntegerOptionParser } from '../common/createNonNegativeIntegerOptionParser';
 import { createPositiveIntegerOptionParser } from '../common/createPositiveIntegerOptionParser';
+import { $assertSufficientFreeDiskSpace } from '../common/disk-space/$assertSufficientFreeDiskSpace';
+import { validateCoderRunOptions } from '../common/validateCoderRunOptions';
+import { $preflightWorkspaceRepository } from '../common/workspaceRepository';
+import { addWorkspaceRepositoryOptions } from '../common/workspaceRepositoryCliOptions';
+import { normalizeProjectCliOptions } from '../common/projectCliOptions';
 import { handleActionErrors } from '../common/handleActionErrors';
 import { $ensureHarnessInstallations } from '../common/harness/$ensureHarnessInstallations';
+import {
+    addQuestionsOption,
+    assertUserConfirmationIsAllowed,
+    normalizeQuestionsCliOptions,
+    QUESTIONS_DESCRIPTION,
+    type QuestionsCliOptions,
+} from '../common/questionsCliOptions';
+import { $ensurePromptbookCliInstallations } from '../common/promptbook-cli/$ensurePromptbookCliInstallations';
 import type { PromptRunnerCliOptions } from '../common/promptRunnerCliOptions';
 import {
     addPromptRunnerExecutionOptions,
@@ -17,12 +25,17 @@ import {
     normalizePromptRunnerCliOptions,
     PROMPT_RUNNER_DESCRIPTION,
 } from '../common/promptRunnerCliOptions';
+import { addPromptPriorityOptions } from '../common/promptPriorityCliOptions';
 import {
-    DEFAULT_CODER_TEST_COMMAND,
-    TEST_BEFORE_MODE_VALUES,
-    type TestBeforeMode,
-} from '../../../../scripts/run-codex-prompts/testing/TestBeforeMode';
+    resolveCoderCheckCommand,
+    type CheckBeforeMode,
+} from '../../../../scripts/run-codex-prompts/checks/CheckBeforeMode';
+import { addCoderCheckOptions, normalizeCheckCommandOption } from '../common/coderCheckCliOptions';
 import { DEFAULT_WAIT_AFTER_ERROR_MS, parseOptionalWaitDuration } from './waitOptions';
+import { $ensureCoderHarnessGitignoreRules } from './$ensureCoderHarnessGitignoreRules';
+import { withCoderWorkspaceLock } from '../../../../scripts/run-codex-prompts/common/withCoderWorkspaceLock';
+import { addCoderExecutionOptions, type CoderAgentCliOptions } from './agentCliOptions';
+import { printCoderRunFailure } from './printCoderRunFailure';
 
 /**
  * Initializes `coder run` command for Promptbook CLI utilities
@@ -34,51 +47,48 @@ import { DEFAULT_WAIT_AFTER_ERROR_MS, parseOptionalWaitDuration } from './waitOp
 export function $initializeCoderRunCommand(program: Program): $side_effect {
     const command = program.command('run');
     command.description(
-        spaceTrim(`
-            Execute coding prompts through selected AI agent
+        spaceTrim(
+            (block) => `
+            Execute coding prompts with the project's Developer Book through the selected harness
 
-            ${PROMPT_RUNNER_DESCRIPTION}
+            ${block(PROMPT_RUNNER_DESCRIPTION)}
+
+            ${block(QUESTIONS_DESCRIPTION)}
 
             Features:
+            - Resolves FROM, IMPORT and TEAM by agent name, book-relative path, project path or URL
+            - Creates a missing .core/adam.book beside the selected agent for default inheritance
             - Automatically stages and commits changes with agent identity unless --no-commit is used
+            - Commits only the prompt file and the files the coding agent has changed, leaving unrelated changes alone
+            - Refuses to start on a dirty working tree unless --git-changes says what should happen with the changes
+            - Optional --git-changes continue resumes the single prompt an interrupted coder left in the [^] status
             - Optional post-commit git push with explicit --auto-push opt-in
             - Optional pre-prompt git pull with explicit --auto-pull opt-in
             - Optional --isolate runs every prompt in its own temporary git worktree and merges it back when verified
+            - Saves the run trace of every round into prompts/traces/, named after its prompt file
             - Optional --preserve-logs keeps temp prompt/log artifacts after successful rounds
             - Optional --no-ui keeps plain streaming console output for logging and debugging
-            - Checks that the selected harness is installed globally and up to date before the first prompt
+            - The dashboard starts in Normal output; press O to toggle Raw output without restarting the task
+            - Refuses to start on a nearly full disk and pauses the run when the free disk space becomes critical, unless --no-questions is used
+            - Checks that the selected harness is installed and up to date before the first prompt unless --no-questions is used
+            - Offers to add missing project-local ignore rules for the selected harness
+            - In interactive mode, checks local and global Promptbook CLI installations and offers to update them
             - Supports GPG signing of commits
-            - Optional pre-coding test run that can stop or repair pre-existing failures
-            - Optional post-prompt verification with test-feedback retries
-            - Progress tracking and interactive P/S/X terminal controls
+            - Optional pre-coding check run that can stop or repair pre-existing failures
+            - Optional post-prompt checks with check-feedback retries
+            - Persists implementation and check-produced changes in separate commits, including failed checks
+            - Records task completion only after passing checks and required local persistence
+            - Progress tracking and interactive P/S/X terminal controls; O changes only the dashboard output view
             - Dry-run mode to preview prompts
-        `),
+        `,
+        ),
     );
 
     command.option('--dry-run', 'Print unwritten prompts without executing', false);
     addPromptRunnerSelectionOptions(command);
-    command.option(
-        '--agent <agent-book-path>',
-        'Path to a .book file whose compiled system message is prepended to each coding prompt',
-    );
-    command.option(
-        '--context <context-or-file>',
-        'Append extra instructions either inline or from a file path relative to the current project',
-    );
-    command.option(
-        '--test <test-command...>',
-        'Run a verification command after each prompt; quote it when the command itself contains top-level flags',
-    );
-    command.addOption(
-        new Option(
-            '--test-before <mode>',
-            `Run tests before coding: ${TEST_BEFORE_MODE_VALUES.join(
-                ', ',
-            )} (defaults to no; uses npm test when --test is omitted)`,
-        )
-            .choices([...TEST_BEFORE_MODE_VALUES])
-            .default('no'),
-    );
+    addQuestionsOption(command);
+    addCoderExecutionOptions(command);
+    addCoderCheckOptions(command, true);
     command.option(
         '--preserve-logs',
         'Keep generated temp prompt/log artifacts after successful rounds for debugging and analytics',
@@ -90,25 +100,12 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
         spaceTrim(`
             Implement each prompt in its own temporary git worktree with its own isolated environment.
             A verified task is merged back into the branch the coder runs on and the worktree is deleted.
+            Fast-forward integration preserves separate implementation, check and finalization commits.
             A task that cannot be merged is marked as failed and its worktree is kept for a manual merge.
         `),
         false,
     );
-    command.option(
-        '--priority <minimum-priority>',
-        'Alias for --min-priority; filter prompts by minimum priority level',
-        createNonNegativeIntegerOptionParser('--priority'),
-    );
-    command.option(
-        '--min-priority <minimum-priority>',
-        'Filter prompts by minimum priority level',
-        createNonNegativeIntegerOptionParser('--min-priority'),
-    );
-    command.option(
-        '--max-priority <maximum-priority>',
-        'Filter prompts by maximum priority level',
-        createNonNegativeIntegerOptionParser('--max-priority'),
-    );
+    addPromptPriorityOptions(command);
     command.option(
         '--limit <run-count>',
         'Stop after processing this many prompt runs',
@@ -150,14 +147,17 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
         'Allow auto-migrate even when heuristic SQL safety check flags destructive pending migrations',
     );
 
+    addWorkspaceRepositoryOptions(command);
+
     command.action(
         handleActionErrors(async (cliOptions) => {
+            const projectOptions = normalizeProjectCliOptions(cliOptions);
             const {
                 dryRun,
                 agent,
                 context,
-                test,
-                testBefore,
+                check,
+                checkBefore,
                 preserveLogs,
                 isolate: isIsolated,
                 priority,
@@ -174,8 +174,8 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
                 readonly dryRun: boolean;
                 readonly agent?: string;
                 readonly context?: string;
-                readonly test?: string | string[];
-                readonly testBefore: TestBeforeMode;
+                readonly check?: string | string[];
+                readonly checkBefore: CheckBeforeMode;
                 readonly preserveLogs: boolean;
                 readonly isolate: boolean;
                 readonly priority?: number;
@@ -188,15 +188,14 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
                 readonly auto: boolean;
                 readonly autoMigrate: boolean;
                 readonly allowDestructiveAutoMigrate: boolean;
-            } & PromptRunnerCliOptions;
+            } & PromptRunnerCliOptions &
+                CoderAgentCliOptions;
 
-            const configuredTestCommand = normalizeCommandOptionValue(test);
-            const testCommand = configuredTestCommand ?? (testBefore === 'no' ? undefined : DEFAULT_CODER_TEST_COMMAND);
+            const checkCommand = resolveCoderCheckCommand(normalizeCheckCommandOption(check), checkBefore);
             const runnerOptions = normalizePromptRunnerCliOptions(cliOptions as PromptRunnerCliOptions, {
                 isAgentRequired: !dryRun,
             });
-
-            await $ensureHarnessInstallations([runnerOptions.agentName]);
+            const questionsOptions = normalizeQuestionsCliOptions(cliOptions as QuestionsCliOptions);
 
             // [1] Parse the wait options and --no-auto:
             //   default: run automatically through the queue (no waiting between prompts)
@@ -205,6 +204,9 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
             //   --wait-between-prompts: pace from start of one prompt to start of next
             //   --wait-after-error: wait before retrying after an error (default 10m)
             const waitForUser = !auto;
+
+            assertUserConfirmationIsAllowed({ ...questionsOptions, isWaitingForUser: waitForUser });
+
             const waitAfterPrompt = parseOptionalWaitDuration(waitAfterPromptValue, 0);
             const waitBetweenPrompts = parseOptionalWaitDuration(waitBetweenPromptsValue, 0);
             const waitAfterError = parseOptionalWaitDuration(waitAfterErrorValue, DEFAULT_WAIT_AFTER_ERROR_MS);
@@ -217,13 +219,13 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
                 waitBetweenPrompts,
                 waitAfterError,
                 noCommit: runnerOptions.noCommit,
-                ignoreGitChanges: runnerOptions.ignoreGitChanges,
+                gitChanges: runnerOptions.gitChanges,
                 agentName: runnerOptions.agentName,
                 model: runnerOptions.model,
                 agent,
                 context,
-                testCommand,
-                testBefore,
+                checkCommand,
+                checkBefore,
                 preserveLogs,
                 isIsolated,
                 noUi: runnerOptions.noUi,
@@ -238,18 +240,54 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
                 allowDestructiveAutoMigrate,
                 autoPush: runnerOptions.autoPush,
                 autoPull: runnerOptions.autoPull,
+                isAskingQuestionsEnabled: questionsOptions.isAskingQuestionsEnabled,
             };
 
+            validateCoderRunOptions(runOptions);
+            const workspace = await $preflightWorkspaceRepository({
+                ...projectOptions,
+                policy: dryRun ? 'read-only' : 'mutate',
+                ...questionsOptions,
+            });
+
+            const { resolveCoderProjectContext } = await import(
+                '../../../../scripts/run-codex-prompts/common/resolveCoderProjectContext'
+            );
+            const projectContext = await resolveCoderProjectContext({
+                projectPath: workspace.projectPath,
+                agent,
+                context,
+            });
+
+            if (!dryRun) {
+                // Check disk space before installations and repository writes; previews require no setup.
+                await $assertSufficientFreeDiskSpace(workspace.projectPath);
+
+                const isCliUpdated = await withCoderWorkspaceLock(workspace, async () => {
+                    if (await $ensurePromptbookCliInstallations(questionsOptions, workspace.projectPath)) {
+                        return true;
+                    }
+                    await $ensureHarnessInstallations([runnerOptions.agentName], questionsOptions);
+                    await $ensureCoderHarnessGitignoreRules(
+                        workspace.projectPath,
+                        runnerOptions.agentName,
+                        questionsOptions,
+                    );
+                    return false;
+                });
+                if (isCliUpdated) {
+                    return process.exit(0);
+                }
+            }
+
             // Note: Import the function dynamically to avoid loading heavy dependencies until needed
             const { runCodexPrompts } = await import('../../../../scripts/run-codex-prompts/main/runCodexPrompts');
 
             try {
-                // Override process.argv to pass options to the legacy parseRunOptions if needed
-                await runCodexPrompts(runOptions);
+                await runCodexPrompts({ ...runOptions, workspace, projectContext });
             } catch (error) {
                 assertsError(error);
-                console.error(colors.bgRed(`${error.name}`));
-                console.error(colors.red(error.stack || error.message));
+                printCoderRunFailure(error);
                 return process.exit(1);
             }
 
@@ -258,24 +296,5 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
     );
 }
 
-/**
- * Joins one Commander option that may be parsed either as a single string or a variadic token array.
- *
- * @private internal utility of `coder run` command
- */
-function normalizeCommandOptionValue(value: string | string[] | undefined): string | undefined {
-    if (value === undefined) {
-        return undefined;
-    }
-
-    const parts = Array.isArray(value) ? value : [value];
-    const normalizedValue = parts
-        .map((part) => part.trim())
-        .filter(Boolean)
-        .join(' ')
-        .trim();
-    return normalizedValue === '' ? undefined : normalizedValue;
-}
-
 // Note: [🟡] Code for CLI command [run](src/cli/cli-commands/coder/run.ts) should never be published outside of `@promptbook/cli`
 // Note: [💞] Ignore a discrepancy between file name and entity name

package/src/cli/cli-commands/coder/server.ts

@@ -1,17 +1,28 @@
-import colors from 'colors';
 import {
     Command as Program /* <- Note: [🔸] Using Program because Command is misleading name */,
     Option,
 } from 'commander';
 import { spaceTrim } from 'spacetrim';
+import { addCoderCheckOptions, normalizeCheckCommandOption } from '../common/coderCheckCliOptions';
 import { NETWORK_LIMITS } from '../../../constants';
 import { assertsError } from '../../../errors/assertsError';
 import { NotAllowed } from '../../../errors/NotAllowed';
 import type { number_port } from '../../../types/number_positive';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
-import { createNonNegativeIntegerOptionParser } from '../common/createNonNegativeIntegerOptionParser';
+import { $assertSufficientFreeDiskSpace } from '../common/disk-space/$assertSufficientFreeDiskSpace';
+import { validateCoderRunOptions } from '../common/validateCoderRunOptions';
+import { $preflightWorkspaceRepository } from '../common/workspaceRepository';
+import { addWorkspaceRepositoryOptions } from '../common/workspaceRepositoryCliOptions';
+import { normalizeProjectCliOptions } from '../common/projectCliOptions';
 import { handleActionErrors } from '../common/handleActionErrors';
 import { $ensureHarnessInstallations } from '../common/harness/$ensureHarnessInstallations';
+import {
+    addQuestionsOption,
+    assertUserConfirmationIsAllowed,
+    normalizeQuestionsCliOptions,
+    QUESTIONS_DESCRIPTION,
+    type QuestionsCliOptions,
+} from '../common/questionsCliOptions';
 import type { PromptRunnerCliOptions } from '../common/promptRunnerCliOptions';
 import {
     addPromptRunnerExecutionOptions,
@@ -19,7 +30,12 @@ import {
     normalizePromptRunnerCliOptions,
     PROMPT_RUNNER_DESCRIPTION,
 } from '../common/promptRunnerCliOptions';
+import { addPromptPriorityOptions } from '../common/promptPriorityCliOptions';
 import { DEFAULT_WAIT_AFTER_ERROR_MS, parseOptionalWaitDuration } from './waitOptions';
+import { $ensureCoderHarnessGitignoreRules } from './$ensureCoderHarnessGitignoreRules';
+import { withCoderWorkspaceLock } from '../../../../scripts/run-codex-prompts/common/withCoderWorkspaceLock';
+import { addCoderExecutionOptions, type CoderAgentCliOptions } from './agentCliOptions';
+import { printCoderRunFailure } from './printCoderRunFailure';
 
 /**
  * Default port used by `ptbk coder server`.
@@ -41,20 +57,26 @@ const DEFAULT_CODER_SERVER_PORT = '4441';
 export function $initializeCoderServerCommand(program: Program): $side_effect {
     const command = program.command('server');
     command.description(
-        spaceTrim(`
-            Start a coder server that watches for prompts and serves a kanban web UI
+        spaceTrim(
+            (block) => `
+                Start a coder server that watches for prompts and serves a kanban web UI
 
-            ${PROMPT_RUNNER_DESCRIPTION}
+                ${block(PROMPT_RUNNER_DESCRIPTION)}
 
-            Features:
-            - Runs the same prompt processing as \`ptbk coder run\`
-            - Checks that the selected harness is installed globally and up to date on startup
-            - Does not exit when all prompts are done; polls for new prompt files instead
-            - Serves a kanban board at http://localhost:<port> for visual progress tracking
-            - Allows editing prompt files directly from the browser (Trello-style)
-            - Play / pause button in the browser stays in sync with the CLI pause state
-            - Terminal controls match \`ptbk coder run\`: P pause/resume, S skip waiting, X end after current prompt
-        `),
+                ${block(QUESTIONS_DESCRIPTION)}
+
+                Features:
+                - Runs the same prompt processing and Developer Book default as \`ptbk coder run\`
+                - Refuses to start on a nearly full disk and pauses the run when the free disk space becomes critical, unless --no-questions is used
+                - Checks that the selected harness is installed and up to date on startup unless --no-questions is used
+                - Offers to add missing project-local ignore rules for the selected harness
+                - Does not exit when all prompts are done; polls for new prompt files instead
+                - Serves a kanban board at http://localhost:<port> for visual progress tracking
+                - Allows editing prompt files directly from the browser (Trello-style)
+                - Play / pause button in the browser stays in sync with the CLI pause state
+                - Terminal controls match \`ptbk coder run\`: P pause/resume, S skip waiting, X end after current prompt
+            `,
+        ),
     );
 
     command.addOption(
@@ -64,39 +86,16 @@ export function $initializeCoderServerCommand(program: Program): $side_effect {
     );
     command.option('--dry-run', 'Print unwritten prompts without executing', false);
     addPromptRunnerSelectionOptions(command);
-    command.option(
-        '--agent <agent-book-path>',
-        'Path to a .book file whose compiled system message is prepended to each coding prompt',
-    );
-    command.option(
-        '--context <context-or-file>',
-        'Append extra instructions either inline or from a file path relative to the current project',
-    );
-    command.option(
-        '--test <test-command...>',
-        'Run a verification command after each prompt; quote it when the command itself contains top-level flags',
-    );
+    addQuestionsOption(command);
+    addCoderExecutionOptions(command);
+    addCoderCheckOptions(command, false);
     command.option(
         '--preserve-logs',
         'Keep generated temp prompt/log artifacts after successful rounds for debugging and analytics',
         false,
     );
     addPromptRunnerExecutionOptions(command);
-    command.option(
-        '--priority <minimum-priority>',
-        'Alias for --min-priority; filter prompts by minimum priority level',
-        createNonNegativeIntegerOptionParser('--priority'),
-    );
-    command.option(
-        '--min-priority <minimum-priority>',
-        'Filter prompts by minimum priority level',
-        createNonNegativeIntegerOptionParser('--min-priority'),
-    );
-    command.option(
-        '--max-priority <maximum-priority>',
-        'Filter prompts by maximum priority level',
-        createNonNegativeIntegerOptionParser('--max-priority'),
-    );
+    addPromptPriorityOptions(command);
     command.option(
         '--wait-after-prompt <duration>',
         spaceTrim(`
@@ -132,14 +131,17 @@ export function $initializeCoderServerCommand(program: Program): $side_effect {
         'Allow auto-migrate even when heuristic SQL safety check flags destructive pending migrations',
     );
 
+    addWorkspaceRepositoryOptions(command);
+
     command.action(
         handleActionErrors(async (cliOptions) => {
+            const projectOptions = normalizeProjectCliOptions(cliOptions);
             const {
                 port: rawPort,
                 dryRun,
                 agent,
                 context,
-                test,
+                check,
                 preserveLogs,
                 priority,
                 minPriority: minimumPriority,
@@ -155,7 +157,7 @@ export function $initializeCoderServerCommand(program: Program): $side_effect {
                 readonly dryRun: boolean;
                 readonly agent?: string;
                 readonly context?: string;
-                readonly test?: string | string[];
+                readonly check?: string | string[];
                 readonly preserveLogs: boolean;
                 readonly priority?: number;
                 readonly minPriority?: number;
@@ -166,18 +168,21 @@ export function $initializeCoderServerCommand(program: Program): $side_effect {
                 readonly auto: boolean;
                 readonly autoMigrate: boolean;
                 readonly allowDestructiveAutoMigrate: boolean;
-            } & PromptRunnerCliOptions;
+            } & PromptRunnerCliOptions &
+                CoderAgentCliOptions;
 
             const port = parseCoderServerPort(rawPort);
-            const testCommand = normalizeCommandOptionValue(test);
+            const checkCommand = normalizeCheckCommandOption(check);
             const runnerOptions = normalizePromptRunnerCliOptions(cliOptions as PromptRunnerCliOptions, {
                 isAgentRequired: !dryRun,
             });
-
-            await $ensureHarnessInstallations([runnerOptions.agentName]);
+            const questionsOptions = normalizeQuestionsCliOptions(cliOptions as QuestionsCliOptions);
 
             // [1] Parse the wait options and --no-auto (same logic as `coder run`)
             const waitForUser = !auto;
+
+            assertUserConfirmationIsAllowed({ ...questionsOptions, isWaitingForUser: waitForUser });
+
             const waitAfterPrompt = parseOptionalWaitDuration(waitAfterPromptValue, 0);
             const waitBetweenPrompts = parseOptionalWaitDuration(waitBetweenPromptsValue, 0);
             const waitAfterError = parseOptionalWaitDuration(waitAfterErrorValue, DEFAULT_WAIT_AFTER_ERROR_MS);
@@ -190,12 +195,12 @@ export function $initializeCoderServerCommand(program: Program): $side_effect {
                 waitBetweenPrompts,
                 waitAfterError,
                 noCommit: runnerOptions.noCommit,
-                ignoreGitChanges: runnerOptions.ignoreGitChanges,
+                gitChanges: runnerOptions.gitChanges,
                 agentName: runnerOptions.agentName,
                 model: runnerOptions.model,
                 agent,
                 context,
-                testCommand,
+                checkCommand,
                 preserveLogs,
                 noUi: runnerOptions.noUi,
                 thinkingLevel: runnerOptions.thinkingLevel,
@@ -208,19 +213,49 @@ export function $initializeCoderServerCommand(program: Program): $side_effect {
                 allowDestructiveAutoMigrate,
                 autoPush: runnerOptions.autoPush,
                 autoPull: runnerOptions.autoPull,
+                isAskingQuestionsEnabled: questionsOptions.isAskingQuestionsEnabled,
             };
 
+            validateCoderRunOptions(runOptions);
+            const workspace = await $preflightWorkspaceRepository({
+                ...projectOptions,
+                policy: dryRun ? 'read-only' : 'mutate',
+                ...questionsOptions,
+            });
+
+            const { resolveCoderProjectContext } = await import(
+                '../../../../scripts/run-codex-prompts/common/resolveCoderProjectContext'
+            );
+            const projectContext = await resolveCoderProjectContext({
+                projectPath: workspace.projectPath,
+                agent,
+                context,
+            });
+
+            if (!dryRun) {
+                // Check disk space before installations and repository writes; previews require no setup.
+                await $assertSufficientFreeDiskSpace(workspace.projectPath);
+
+                await withCoderWorkspaceLock(workspace, async () => {
+                    await $ensureHarnessInstallations([runnerOptions.agentName], questionsOptions);
+                    await $ensureCoderHarnessGitignoreRules(
+                        workspace.projectPath,
+                        runnerOptions.agentName,
+                        questionsOptions,
+                    );
+                });
+            }
+
             // Note: Import dynamically to avoid loading heavy dependencies until needed
             const { runCodexPromptsServer } = await import(
                 '../../../../scripts/run-codex-prompts/main/runCodexPromptsServer'
             );
 
             try {
-                await runCodexPromptsServer(runOptions);
+                await runCodexPromptsServer({ ...runOptions, workspace, projectContext });
             } catch (error) {
                 assertsError(error);
-                console.error(colors.bgRed(`${error.name}`));
-                console.error(colors.red(error.stack || error.message));
+                printCoderRunFailure(error);
                 return process.exit(1);
             }
 
@@ -250,24 +285,5 @@ function parseCoderServerPort(rawPort: string): number_port {
     return port as number_port;
 }
 
-/**
- * Joins one Commander option that may be parsed either as a single string or a variadic token array.
- *
- * @private internal utility of `coder server` command
- */
-function normalizeCommandOptionValue(value: string | string[] | undefined): string | undefined {
-    if (value === undefined) {
-        return undefined;
-    }
-
-    const parts = Array.isArray(value) ? value : [value];
-    const normalizedValue = parts
-        .map((part) => part.trim())
-        .filter(Boolean)
-        .join(' ')
-        .trim();
-    return normalizedValue === '' ? undefined : normalizedValue;
-}
-
 // Note: [🟡] Code for CLI command [server](src/cli/cli-commands/coder/server.ts) should never be published outside of `@promptbook/cli`
 // Note: [💞] Ignore a discrepancy between file name and entity name

package/src/cli/cli-commands/coder/verify.ts

@@ -1,4 +1,5 @@
 import colors from 'colors';
+import { NotAllowed } from '../../../errors/NotAllowed';
 import {
     Command as Program /* <- Note: [🔸] Using Program because Command is misleading name */,
     Option,
@@ -17,6 +18,9 @@ import {
     CODER_GIT_SYNC_DESCRIPTION,
     normalizeCoderGitSyncCliOptions,
 } from '../common/coderGitSyncCliOptions';
+import { $preflightWorkspaceRepository } from '../common/workspaceRepository';
+import { addWorkspaceRepositoryOptions } from '../common/workspaceRepositoryCliOptions';
+import { normalizeProjectCliOptions } from '../common/projectCliOptions';
 import { handleActionErrors } from '../common/handleActionErrors';
 
 /**
@@ -74,8 +78,11 @@ export function $initializeCoderVerifyCommand(program: Program): $side_effect {
     );
     addCoderGitSyncOptions(command);
 
+    addWorkspaceRepositoryOptions(command);
+
     command.action(
         handleActionErrors(async (cliOptions) => {
+            const projectOptions = normalizeProjectCliOptions(cliOptions);
             const { order, ignore } = cliOptions as {
                 readonly order: VerifyPromptsOrder;
                 readonly ignore: ReadonlyArray<string>;
@@ -83,11 +90,24 @@ export function $initializeCoderVerifyCommand(program: Program): $side_effect {
 
             const gitSync = normalizeCoderGitSyncCliOptions(cliOptions as CoderGitSyncCliOptions);
 
+            const workspace = await $preflightWorkspaceRepository({
+                ...projectOptions,
+                policy: 'mutate',
+                isAskingQuestionsEnabled: cliOptions.questions,
+            });
+            if (cliOptions.questions === false) {
+                throw new NotAllowed(
+                    spaceTrim(
+                        '`ptbk coder verify` requires answers before changing PRD statuses or archiving files. Run it without `--no-questions` in an interactive terminal.',
+                    ),
+                );
+            }
+
             // Note: Import the main function dynamically to avoid loading heavy dependencies until needed
             const { verifyPrompts } = await import('../../../../scripts/verify-prompts/verify-prompts');
 
             try {
-                await verifyPrompts({ order, ignore, gitSync });
+                await verifyPrompts({ order, ignore, gitSync, workspace });
             } catch (error) {
                 console.error(colors.bgRed('Prompt verification failed:'), error);
                 return process.exit(1);