@promptbook/cli 0.114.0-2 → 0.114.0-4

package/src/cli/cli-commands/coder/generate-boilerplates.ts

@@ -6,7 +6,20 @@ import { mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { spaceTrim } from 'spacetrim';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
+import type { CoderGitSyncCliOptions } from '../common/coderGitSyncCliOptions';
+import {
+    addCoderGitSyncOptions,
+    CODER_GIT_SYNC_DESCRIPTION,
+    normalizeCoderGitSyncCliOptions,
+} from '../common/coderGitSyncCliOptions';
 import { handleActionErrors } from '../common/handleActionErrors';
+import type { BoilerplateCount } from './boilerplateCount';
+import {
+    BOILERPLATE_COUNT_OPTION_DESCRIPTION,
+    DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE,
+    formatBoilerplateCount,
+    parseBoilerplateCount,
+} from './boilerplateCount';
 import {
     buildCoderPromptSection,
     getDefaultCoderPromptTemplateDefinitions,
@@ -24,12 +37,16 @@ import {
 export function $initializeCoderGenerateBoilerplatesCommand(program: Program): $side_effect {
     const command = program.command('generate-boilerplates');
     command.description(
-        spaceTrim(`
-            Generate prompt boilerplate files with unique emoji tags
-        `),
+        spaceTrim(
+            (block) => `
+                Generate prompt boilerplate files with unique emoji tags
+
+                ${block(CODER_GIT_SYNC_DESCRIPTION)}
+            `,
+        ),
     );
 
-    command.option('--count <count>', `Number of prompt boilerplate files to generate`, '5');
+    command.option('--count <count>', BOILERPLATE_COUNT_OPTION_DESCRIPTION, DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE);
     command.option(
         '--template <template>',
         spaceTrim(`
@@ -40,22 +57,38 @@ export function $initializeCoderGenerateBoilerplatesCommand(program: Program): $
                 .join(', ')}) or a markdown file path relative to the current project root.
         `),
     );
+    addCoderGitSyncOptions(command);
 
     command.action(
         handleActionErrors(async (cliOptions) => {
             const { count: countOption, template: templateOption } = cliOptions as {
                 readonly count: string;
                 readonly template?: string;
-            };
+            } & CoderGitSyncCliOptions;
+
+            const boilerplateCount = parseBoilerplateCount(countOption);
+            const gitSync = normalizeCoderGitSyncCliOptions(cliOptions as CoderGitSyncCliOptions);
+            const projectPath = process.cwd();
 
-            const filesCount = parseFilesCount(countOption);
+            // Note: Import the git synchronization dynamically to keep the CLI fast for runs without `--commit`
+            const { $commitCoderChanges, $pullCoderChanges } = await import(
+                '../../../../scripts/run-codex-prompts/git/coderGitSync'
+            );
+
+            await $pullCoderChanges({ gitSync, projectPath });
 
             await generatePromptBoilerplate({
-                projectPath: process.cwd(),
-                filesCount,
+                projectPath,
+                boilerplateCount,
                 templateOption,
             });
 
+            await $commitCoderChanges({
+                gitSync,
+                projectPath,
+                commitMessage: `Prompts ${formatBoilerplateCount(boilerplateCount)}`,
+            });
+
             return process.exit(0);
         }),
     );
@@ -68,13 +101,15 @@ export function $initializeCoderGenerateBoilerplatesCommand(program: Program): $
  */
 export async function generatePromptBoilerplate({
     projectPath,
-    filesCount,
+    boilerplateCount,
     templateOption,
 }: {
     readonly projectPath: string;
-    readonly filesCount: number;
+    readonly boilerplateCount: BoilerplateCount;
     readonly templateOption?: string;
 }): Promise<void> {
+    const { filesCount, promptsPerFileCount } = boilerplateCount;
+
     // Note: Import these dynamically to avoid circular dependencies and keep CLI fast
     const { buildPromptFilename, getPromptNumbering } = await import(
         '../../../../scripts/utils/prompts/getPromptNumbering'
@@ -99,8 +134,10 @@ export async function generatePromptBoilerplate({
         colors.blue(`Highest existing number for ${promptNumbering.datePrefix} found: ${highestNumberFormatted}`),
     );
 
+    // Note: Every single generated prompt is one separate coding task, so each of them reserves its own fresh emoji tag
+    const promptsCount = filesCount * promptsPerFileCount;
     const { availableCount, selectedEmojis } = await getFreshPromptEmojiTags({
-        count: filesCount,
+        count: promptsCount,
         rootDir: projectPath,
     });
 
@@ -117,7 +154,9 @@ export async function generatePromptBoilerplate({
     for (let i = 0; i < filesCount; i++) {
         const number = promptNumbering.startNumber + i * promptNumbering.step;
         const title = titles[i % titles.length]!;
-        const emoji = selectedEmojis[i]!;
+        const emojiTags = selectedEmojis
+            .slice(i * promptsPerFileCount, (i + 1) * promptsPerFileCount)
+            .map((emoji) => formatPromptEmojiTag(emoji));
         const filename = buildPromptFilename(
             promptNumbering.datePrefix,
             number,
@@ -125,39 +164,18 @@ export async function generatePromptBoilerplate({
         );
         const filepath = join(PROMPTS_DIRECTORY_PATH, filename);
         const absoluteFilepath = join(projectPath, filepath);
-        const emojiTag = formatPromptEmojiTag(emoji);
-        const one = buildCoderPromptSection({
-            statusLine: '[-]',
-            emojiTag,
+        const content = buildBoilerplatePromptFileContent({
+            emojiTags,
             title,
             body: promptTemplate.content,
         });
-        const content = spaceTrim(
-            (block) => `
-
-                ${block(one)}
-
-                ---
-
-                ${block(one)}
-
-                ---
-
-                ${block(one)}
-
-                ---
-
-                ${block(one)}
-
-            `,
-        );
 
         filesToCreate.push({
             filepath,
             absoluteFilepath,
             filename,
             content,
-            emoji,
+            emojiTags,
             number,
         });
     }
@@ -167,26 +185,42 @@ export async function generatePromptBoilerplate({
 
     for (const file of filesToCreate) {
         writeFileSync(file.absoluteFilepath, file.content, 'utf-8');
-        console.info(colors.green(`✓ Created: ${file.filename} with ${formatPromptEmojiTag(file.emoji!)}`));
+        console.info(colors.green(`✓ Created: ${file.filename} with ${file.emojiTags.join(' ')}`));
     }
 
-    console.info(colors.bgGreen(` Successfully created ${filesToCreate.length} prompt boilerplate files! `));
+    console.info(
+        colors.bgGreen(
+            ` Successfully created ${promptsCount} prompts in ${filesToCreate.length} prompt boilerplate files! `,
+        ),
+    );
 }
 
 /**
- * Parses and validates the count of boilerplate files to create.
+ * Builds the markdown content of one generated prompt file with one prompt section per emoji tag.
+ *
+ * Multiple prompts in one file are separated by the `---` separator, exactly like the prompt runner expects them.
  *
  * @private internal utility of `generatePromptBoilerplate` command
  */
-function parseFilesCount(countOption: string): number {
-    const filesCount = Number(countOption);
-
-    if (!Number.isFinite(filesCount) || filesCount <= 0) {
-        console.info(colors.yellow(`Invalid --count '${countOption}'. Falling back to default 5.`));
-        return 5;
-    }
-
-    return Math.floor(filesCount);
+function buildBoilerplatePromptFileContent({
+    emojiTags,
+    title,
+    body,
+}: {
+    readonly emojiTags: ReadonlyArray<string>;
+    readonly title: string;
+    readonly body: string;
+}): string {
+    return emojiTags
+        .map((emojiTag) =>
+            buildCoderPromptSection({
+                statusLine: '[-]',
+                emojiTag,
+                title,
+                body,
+            }),
+        )
+        .join('\n\n---\n\n');
 }
 
 /**

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

@@ -1,8 +1,10 @@
+import { DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE } from './boilerplateCount';
+
 /**
  * Default npm scripts initialized by `ptbk coder init`.
  */
 const DEFAULT_CODER_PACKAGE_JSON_SCRIPTS = {
-    'coder:generate-boilerplates': 'ptbk coder generate-boilerplates --template ./prompts/templates/common.md',
+    'coder:generate-boilerplates': `ptbk coder generate-boilerplates --count ${DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE} --template ./prompts/templates/common.md`,
     'coder:add': 'ptbk coder add --template ./prompts/templates/common.md',
     'coder:run':
         'ptbk coder run --harness openai-codex --model gpt-5.6-terra --thinking-level max --agent agents/developer.book --context AGENTS.md --test-before yes-and-fix',

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

@@ -3,12 +3,19 @@ import type {
 } from 'commander';
 import { spaceTrim } from 'spacetrim';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
+import type { CoderGitSyncCliOptions } from '../common/coderGitSyncCliOptions';
+import {
+    addCoderGitSyncOptions,
+    CODER_GIT_SYNC_DESCRIPTION,
+    normalizeCoderGitSyncCliOptions,
+} from '../common/coderGitSyncCliOptions';
 import { handleActionErrors } from '../common/handleActionErrors';
 import { $ensureHarnessInstallations } from '../common/harness/$ensureHarnessInstallations';
 import { getHarnessDefinition } from '../common/harness/HarnessDefinition';
 import type { PromptRunnerHarnessName } from '../common/promptRunnerCliOptions';
 import { AGENT_CODING_FILE_PATH } from './agentCodingFile';
 import { AGENTS_FILE_PATH } from './agentsFile';
+import { DEFAULT_BOILERPLATE_COUNT } from './boilerplateCount';
 import { getDefaultCoderProjectPromptTemplateDefinitions } from './boilerplateTemplates';
 import { CODER_DEVELOPER_AGENT_FILE_PATH } from './ensureCoderDeveloperAgentFile';
 import { formatDisplayPath } from './formatDisplayPath';
@@ -61,16 +68,36 @@ export function $initializeCoderInitCommand(program: Program): $side_effect {
 
                 Checks that the coding harnesses are installed globally and up to date:
                 ${block(listCheckedHarnessLabels())}
+
+                ${block(CODER_GIT_SYNC_DESCRIPTION)}
             `,
         ),
     );
 
+    addCoderGitSyncOptions(command);
+
     command.action(
-        handleActionErrors(async () => {
+        handleActionErrors(async (cliOptions) => {
+            const gitSync = normalizeCoderGitSyncCliOptions(cliOptions as CoderGitSyncCliOptions);
             const projectPath = process.cwd();
+
+            // Note: Import the git synchronization dynamically to keep the CLI fast for runs without `--commit`
+            const { $commitCoderChanges, $pullCoderChanges } = await import(
+                '../../../../scripts/run-codex-prompts/git/coderGitSync'
+            );
+
+            await $pullCoderChanges({ gitSync, projectPath });
+
             const summary = await initializeCoderProjectConfiguration(projectPath);
             printInitializationSummary(summary);
-            await generatePromptBoilerplate({ projectPath, filesCount: 5 });
+            await generatePromptBoilerplate({ projectPath, boilerplateCount: DEFAULT_BOILERPLATE_COUNT });
+
+            await $commitCoderChanges({
+                gitSync,
+                projectPath,
+                commitMessage: 'Initialize Promptbook Coder',
+            });
+
             await $ensureHarnessInstallations(CODER_INIT_CHECKED_HARNESS_NAMES);
         }),
     );

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

@@ -2,10 +2,9 @@ import type {
     Command as Program /* <- Note: [🔸] Using Program because Command is misleading name */,
 } from 'commander';
 import { spaceTrim } from 'spacetrim';
-import { NotAllowed } from '../../../errors/NotAllowed';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
-import { $ensureHarnessInstallations } from '../common/harness/$ensureHarnessInstallations';
 import { handleActionErrors } from '../common/handleActionErrors';
+import { $ensureHarnessInstallations } from '../common/harness/$ensureHarnessInstallations';
 import type { PromptRunnerSelectionCliOptions } from '../common/promptRunnerCliOptions';
 import {
     addPromptRunnerRuntimeOptions,
@@ -15,12 +14,9 @@ import {
 } from '../common/promptRunnerCliOptions';
 
 /**
- * Initializes `coder ping` command for Promptbook CLI utilities.
- *
- * The command makes one small, isolated harness/model call, prints its result
- * and reports how long the harness/model turn took.
+ * Initializes `coder ping` command for Promptbook CLI utilities
  *
- * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI.
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
  *
  * @private internal function of `promptbookCli`
  */
@@ -28,15 +24,16 @@ export function $initializeCoderPingCommand(program: Program): $side_effect {
     const command = program.command('ping');
     command.description(
         spaceTrim(`
-            Test one harness and model connection with a small disposable task
+            Send one tiny dummy prompt to a harness and model to measure and warm them up
 
             ${PROMPT_RUNNER_DESCRIPTION}
 
             Features:
-            - Runs the dummy task in a temporary directory outside the current project
-            - Prints the result returned by the selected harness and model
-            - Reports the elapsed harness/model response time in milliseconds
-            - Can be used to start consuming an applicable harness/model quota before a longer run
+            - Verifies that the selected harness, model, thinking level and authentication really work
+            - Reports the answer of the harness, the response time and the reported usage
+            - Starts the hourly/weekly quota window before you need it, so it is already refreshing when you do
+            - Leaves the project exactly as it was — nothing is read, written, changed or committed
+            - Use --no-ui to stream the raw harness output instead of only the compact result
         `),
     );
 
@@ -45,50 +42,31 @@ export function $initializeCoderPingCommand(program: Program): $side_effect {
 
     command.action(
         handleActionErrors(async (cliOptions) => {
-            const normalizedOptions = normalizePromptRunnerSelectionCliOptions(
+            const runnerOptions = normalizePromptRunnerSelectionCliOptions(
                 cliOptions as PromptRunnerSelectionCliOptions,
                 { isAgentRequired: true },
             );
 
-            const agentName = normalizedOptions.agentName;
-            if (!agentName) {
-                throw new NotAllowed(
-                    spaceTrim(`
-                        A harness is required for \`ptbk coder ping\`.
+            await $ensureHarnessInstallations([runnerOptions.agentName]);
 
-                        Pass one with \`--harness <harness-name>\`.
-                    `),
-                );
-            }
-
-            await $ensureHarnessInstallations([agentName]);
+            // Note: Import the ping dynamically to avoid loading heavy dependencies until needed
+            const { pingCoderHarness } = await import('../../../../scripts/run-codex-prompts/ping/pingCoderHarness');
+            const { printCoderPingResult } = await import(
+                '../../../../scripts/run-codex-prompts/ping/printCoderPingResult'
+            );
 
-            // Note: Import the runner-backed implementation dynamically to avoid loading heavy dependencies until needed.
-            const { runCoderPing } = await import('../../../../scripts/run-agent-chat/runCoderPing');
-            const pingResult = await runCoderPing({
-                agentName,
-                model: normalizedOptions.model,
-                thinkingLevel: normalizedOptions.thinkingLevel,
-                isUiDisabled: normalizedOptions.noUi,
-                isCreditsAllowed: normalizedOptions.allowCredits,
+            const result = await pingCoderHarness({
+                agentName: runnerOptions.agentName,
+                model: runnerOptions.model,
+                thinkingLevel: runnerOptions.thinkingLevel,
+                allowCredits: runnerOptions.allowCredits,
+                shouldPrintLiveOutput: runnerOptions.noUi,
             });
 
-            printCoderPingResult(pingResult);
+            printCoderPingResult(result);
         }),
     );
 }
 
-/**
- * Prints the result and duration of one completed coder ping.
- */
-function printCoderPingResult(pingResult: { readonly result: string; readonly elapsedTimeMs: number }): void {
-    console.info(
-        spaceTrim(`
-            Result: ${pingResult.result}
-            Time: ${pingResult.elapsedTimeMs.toFixed(0)} ms
-        `),
-    );
-}
-
 // Note: [🟡] Code for CLI command [ping](src/cli/cli-commands/coder/ping.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

@@ -4,6 +4,12 @@ import type {
 } from 'commander';
 import { spaceTrim } from 'spacetrim';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
+import type { CoderGitSyncCliOptions } from '../common/coderGitSyncCliOptions';
+import {
+    addCoderGitSyncOptions,
+    CODER_GIT_SYNC_DESCRIPTION,
+    normalizeCoderGitSyncCliOptions,
+} from '../common/coderGitSyncCliOptions';
 import { handleActionErrors } from '../common/handleActionErrors';
 
 /**
@@ -16,17 +22,23 @@ import { handleActionErrors } from '../common/handleActionErrors';
 export function $initializeCoderVerifyCommand(program: Program): $side_effect {
     const command = program.command('verify');
     command.description(
-        spaceTrim(`
-            Interactive verification helper for completed prompts
+        spaceTrim(
+            (block) => `
+                Interactive verification helper for completed prompts
 
-            Features:
-            - Displays list of prompt files with status counts
-            - Guides through verification of completed prompts marked [x]
-            - Archives verified prompt files to prompts/done/ directory
-            - Auto-appends repair prompts for incomplete work
-            - Processes files with all-done prompts first
-            - Supports ignoring matching prompt candidates for one verification run
-        `),
+                Features:
+                - Displays list of prompt files with status counts
+                - Guides through verification of completed prompts marked [x]
+                - Archives verified prompt files to prompts/done/ directory
+                - Auto-appends repair prompts for incomplete work
+                - Processes files with all-done prompts first
+                - Supports ignoring matching prompt candidates for one verification run
+
+                ${block(CODER_GIT_SYNC_DESCRIPTION)}
+
+                Note: The git synchronization is applied around each single verification, not once per run.
+            `,
+        ),
     );
 
     command.option('--reverse', 'Process prompt files in reverse order', false);
@@ -36,19 +48,22 @@ export function $initializeCoderVerifyCommand(program: Program): $side_effect {
         collectStringOption,
         [],
     );
+    addCoderGitSyncOptions(command);
 
     command.action(
         handleActionErrors(async (cliOptions) => {
             const { reverse, ignore } = cliOptions as {
                 readonly reverse: boolean;
                 readonly ignore: ReadonlyArray<string>;
-            };
+            } & CoderGitSyncCliOptions;
+
+            const gitSync = normalizeCoderGitSyncCliOptions(cliOptions as CoderGitSyncCliOptions);
 
             // 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({ reverse, ignore });
+                await verifyPrompts({ reverse, ignore, gitSync });
             } catch (error) {
                 console.error(colors.bgRed('Prompt verification failed:'), error);
                 return process.exit(1);

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

@@ -23,8 +23,8 @@ import { $initializeCoderVerifyCommand } from './coder/verify';
  * - add: Add one ready-to-run prompt file to the queue
  * - generate-boilerplates: Generate prompt boilerplate files
  * - find-refactor-candidates: Find files that need refactoring
- * - ping: Test one harness and model connection with a disposable task
  * - run: Run coding prompts with AI agents
+ * - ping: Test one harness and model with a tiny dummy prompt
  * - verify: Verify completed prompts
  * - find-fresh-emoji-tags: Find unused emoji tags
  *
@@ -44,8 +44,8 @@ export function $initializeCoderCommand(program: Program): $side_effect {
             - generate-boilerplates: Generate prompt boilerplate files
             - find-refactor-candidates: Find files that need refactoring
             - find-unwritten: List prompt sections that still need to be authored
-            - ping: Test one harness and model connection with a disposable task
             - run: Run coding prompts with AI agents
+            - ping: Test the connection, response time and quota of one harness and model
             - server: Start a long-running coder server with a kanban web UI
             - verify: Verify completed prompts
             - find-fresh-emoji-tags: Find unused emoji tags
@@ -58,8 +58,8 @@ export function $initializeCoderCommand(program: Program): $side_effect {
     $initializeCoderGenerateBoilerplatesCommand(coderCommand);
     $initializeCoderFindRefactorCandidatesCommand(coderCommand);
     $initializeCoderFindUnwrittenCommand(coderCommand);
-    $initializeCoderPingCommand(coderCommand);
     $initializeCoderRunCommand(coderCommand);
+    $initializeCoderPingCommand(coderCommand);
     $initializeCoderServerCommand(coderCommand);
     $initializeCoderVerifyCommand(coderCommand);
     $initializeCoderFindFreshEmojiTagCommand(coderCommand);

package/src/cli/cli-commands/common/coderGitSyncCliOptions.ts

@@ -0,0 +1,78 @@
+import type {
+    Command as Program /* <- Note: [🔸] Using Program because Command is misleading name */,
+} from 'commander';
+import { spaceTrim } from 'spacetrim';
+import type { CoderGitSyncOptions } from '../../../../scripts/run-codex-prompts/git/coderGitSync';
+import { NotAllowed } from '../../../errors/NotAllowed';
+
+export type { CoderGitSyncOptions };
+
+/**
+ * Commander option bag for the shared `ptbk coder` git synchronization flags.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type CoderGitSyncCliOptions = {
+    readonly commit: boolean;
+    readonly autoPush: boolean;
+    readonly autoPull: boolean;
+};
+
+/**
+ * Description block shared by the `ptbk coder` commands which can synchronize their changes with git.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export const CODER_GIT_SYNC_DESCRIPTION = spaceTrim(`
+    Git synchronization:
+    - --auto-pull pulls the latest changes before this command changes anything
+    - --commit commits the changes made by this command
+    - --auto-push pushes the created commit to the remote repository
+`);
+
+/**
+ * Registers the shared `--commit`, `--auto-push` and `--auto-pull` flags on a `ptbk coder` command.
+ *
+ * Note: Unlike `ptbk coder run`, which commits by default and opts out through `--no-commit`,
+ *       these commands never touch git unless the flags are used explicitly.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export function addCoderGitSyncOptions(command: Program): void {
+    command.option('--commit', 'Commit the changes made by this command with the coding-agent git identity', false);
+    command.option('--auto-push', 'Automatically git push the created commit, requires --commit', false);
+    command.option(
+        '--auto-pull',
+        'Automatically git pull the latest changes before this command changes anything',
+        false,
+    );
+}
+
+/**
+ * Converts the Commander git synchronization flags into normalized git synchronization options.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export function normalizeCoderGitSyncCliOptions(cliOptions: CoderGitSyncCliOptions): CoderGitSyncOptions {
+    if (cliOptions.autoPush && !cliOptions.commit) {
+        throw new NotAllowed(
+            spaceTrim(`
+                Flag \`--auto-push\` can be used only together with \`--commit\`.
+
+                **There is nothing to push when the changes are not committed.**
+
+                Actionable hint:
+                - Add \`--commit\`, for example \`ptbk coder init --commit --auto-push\`.
+            `),
+        );
+    }
+
+    return {
+        isCommitEnabled: cliOptions.commit,
+        isAutoPushEnabled: cliOptions.autoPush,
+        isAutoPullEnabled: cliOptions.autoPull,
+    };
+}
+
+// Note: [🟡] Code for CLI git synchronization options [coderGitSyncCliOptions](src/cli/cli-commands/common/coderGitSyncCliOptions.ts) should never be published outside of `@promptbook/cli`
+// Note: [💞] Ignore a discrepancy between file name and exported helper names

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

@@ -1,7 +1,6 @@
 import colors from 'colors';
 import { writeFile } from 'fs/promises';
 import { join } from 'path';
-import prompts from 'prompts';
 import { spaceTrim } from 'spacetrim';
 import { getAllCommitmentsToolFunctionsForNode } from '../../../commitments/_common/getAllCommitmentsToolFunctionsForNode';
 import { DEFAULT_MAX_EXECUTION_ATTEMPTS } from '../../../config';
@@ -24,6 +23,7 @@ import { JavascriptExecutionTools } from '../../../scripting/javascript/Javascri
 import { isFileExisting } from '../../../utils/files/isFileExisting';
 import { $getCompiledBook } from '../../../wizard/$getCompiledBook';
 import { $provideLlmToolsForCli } from '../../common/$provideLlmToolsForCli';
+import { loadPromptsModule } from '../../common/loadPromptsModule';
 import type { RunCommandCliOptions } from './runCommandAction';
 
 /**
@@ -156,6 +156,7 @@ async function resolveRunPipelineSource(pipelineSource?: string): Promise<string
         return pipelineSource;
     }
 
+    const { default: prompts } = await loadPromptsModule();
     const response = await prompts({
         type: 'text',
         name: 'pipelineSource',

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

@@ -1,10 +1,10 @@
 import colors from 'colors';
-import prompts from 'prompts';
 import { spaceTrim } from 'spacetrim';
 import type { PipelineJson } from '../../../pipeline/PipelineJson/PipelineJson';
 import type { string_parameter_name, string_parameter_value } from '../../../types/string_name';
 import { countLines } from '../../../utils/expectation-counters/countLines';
 import type { TODO_any } from '../../../utils/organization/TODO_any';
+import { loadPromptsModule } from '../../common/loadPromptsModule';
 
 /**
  * Resolves all missing input parameters while keeping the current interactive and non-interactive behavior.
@@ -24,6 +24,7 @@ export async function resolveRunInputParameters(options: {
         return process.exit(1);
     }
 
+    const { default: prompts } = await loadPromptsModule();
     const response = await prompts(questions as TODO_any);
     //                     <- TODO: [🧠][🍼] Change behavior according to the formfactor
 

package/src/cli/cli-commands/runInteractiveChatbot.ts

@@ -1,11 +1,11 @@
 import colors from 'colors';
-import prompts from 'prompts';
 import { spaceTrim } from 'spacetrim';
 import { forTime } from 'waitasecond';
 import { assertsError } from '../../errors/assertsError';
 import type { PipelineExecutor } from '../../execution/PipelineExecutor';
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 import { just } from '../../utils/organization/just';
+import { loadPromptsModule } from '../common/loadPromptsModule';
 
 /**
  * Options for running the interactive chatbot
@@ -90,6 +90,7 @@ export async function runInteractiveChatbot(options: RunInteractiveChatbotOption
                 console.info(colors.gray(`---`));
             }
 
+            const { default: prompts } = await loadPromptsModule();
             const response = await prompts({
                 type: 'text',
                 name: 'userMessage',