@promptbook/cli 0.114.0-2 → 0.114.0-20

package/src/book-components/Chat/utils/timeoutToolCallPresentation.ts

@@ -2,12 +2,37 @@ import type { TODO_any } from '../../../utils/organization/TODO_any';
 import { formatToolCallDateTime } from './formatToolCallDateTime';
 import { formatToolCallTranslationTemplate } from './formatToolCallTranslationTemplate';
 
+/**
+ * Tool name of one scheduled wake-up, used by every producer of timeout chips.
+ *
+ * @private internal timeout-chat constant
+ */
+export const SET_TIMEOUT_TOOL_CALL_NAME = 'set_timeout';
+
+/**
+ * Tool name of one re-planned wake-up, used by every producer of timeout chips.
+ *
+ * @private internal timeout-chat constant
+ */
+export const UPDATE_TIMEOUT_TOOL_CALL_NAME = 'update_timeout';
+
+/**
+ * Tool name of one cancelled wake-up, used by every producer of timeout chips.
+ *
+ * @private internal timeout-chat constant
+ */
+export const CANCEL_TIMEOUT_TOOL_CALL_NAME = 'cancel_timeout';
+
 /**
  * Tool names handled by timeout-specific chat presentation.
  *
  * @private internal timeout-chat constant
  */
-const TIMEOUT_TOOL_NAMES = ['set_timeout', 'cancel_timeout'] as const;
+const TIMEOUT_TOOL_NAMES = [
+    SET_TIMEOUT_TOOL_CALL_NAME,
+    UPDATE_TIMEOUT_TOOL_CALL_NAME,
+    CANCEL_TIMEOUT_TOOL_CALL_NAME,
+] as const;
 
 /**
  * Milliseconds in one second.
@@ -412,9 +437,15 @@ function formatTimeoutDurationCompact(milliseconds: number): string {
 /**
  * Converts timeout duration into natural language sentence fragments.
  *
- * @private internal timeout-chat helper
+ * Shared by every timeout surface: the chat chips, the goal-chat planned messages of the Agents
+ * Server, and the planned-message prompt section of the agent-folder runner.
+ *
+ * @param milliseconds - Duration or repeat interval in milliseconds.
+ * @returns Label such as `5 minutes` or `1 hour 30 minutes`.
+ *
+ * @private internal utility of `<Chat/>` and the Agents Server planned messages
  */
-function formatTimeoutDurationHuman(milliseconds: number): string {
+export function formatTimeoutDurationHuman(milliseconds: number): string {
     const normalizedMilliseconds = Math.max(0, Math.floor(milliseconds));
     const totalSeconds = Math.max(1, Math.floor(normalizedMilliseconds / SECOND_IN_MILLISECONDS));
 

package/src/cli/cli-commands/agents-server/buildAgentsServer/createAgentsServerRuntimeEnvironment.ts

@@ -22,6 +22,14 @@ export const PTBK_AGENTS_SERVER_BUILD_WORKER_COUNT_ENV = 'PTBK_AGENTS_SERVER_BUI
  */
 export const PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION_ENV = 'PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION';
 
+/**
+ * Environment variable that disables throwaway webpack filesystem caches for CLI-owned production builds.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export const PTBK_AGENTS_SERVER_DISABLE_WEBPACK_FILESYSTEM_CACHE_ENV =
+    'PTBK_AGENTS_SERVER_DISABLE_WEBPACK_FILESYSTEM_CACHE';
+
 /**
  * Conservative Next.js build worker count used by CLI-owned Agents Server production builds.
  *
@@ -41,6 +49,7 @@ export function createAgentsServerRuntimeEnvironment(
     nodeModulesPath: string,
     options: {
         readonly isNextValidationIgnored?: boolean;
+        readonly isWebpackFilesystemCacheDisabled?: boolean;
     } = {},
 ): NodeJS.ProcessEnv {
     return {
@@ -54,6 +63,11 @@ export function createAgentsServerRuntimeEnvironment(
                   [PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION_ENV]: 'true',
               }
             : {}),
+        ...(options.isWebpackFilesystemCacheDisabled
+            ? {
+                  [PTBK_AGENTS_SERVER_DISABLE_WEBPACK_FILESYSTEM_CACHE_ENV]: 'true',
+              }
+            : {}),
     };
 }
 

package/src/cli/cli-commands/agents-server/buildAgentsServer/ensureAgentsServerBuild.ts

@@ -30,6 +30,7 @@ export async function ensureAgentsServerBuild(
     });
     const buildEnvironment = createAgentsServerRuntimeEnvironment(environment, preparedRuntime.nodeModulesPath, {
         isNextValidationIgnored: preparedRuntime.isAppPathMaterialized,
+        isWebpackFilesystemCacheDisabled: true,
     });
 
     if (

package/src/cli/cli-commands/agents-server/startAgentsServer/createLocalAgentRunOptions.ts

@@ -17,7 +17,7 @@ export function createLocalAgentRunOptions(
         noUi: options.noUi,
         thinkingLevel: options.thinkingLevel,
         noCommit: true,
-        ignoreGitChanges: true,
+        gitChanges: 'ignore',
         normalizeLineEndings: false,
         allowCredits: options.allowCredits,
         autoPush: false,

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

@@ -0,0 +1,35 @@
+/**
+ * Supported values of the `--git-changes` option, which decides what happens with a dirty working tree.
+ *
+ * - `fail` — refuse to start while the working tree has uncommitted changes
+ * - `ignore` — start anyway and leave the uncommitted changes where they are
+ * - `continue` — resume the single prompt which was left in the middle of its implementation
+ *
+ * @private internal shared utility of `ptbk coder run`
+ */
+export const GIT_CHANGES_MODE_VALUES = ['fail', 'ignore', 'continue'] as const;
+
+/**
+ * Behavior requested for a working tree which has uncommitted changes.
+ *
+ * @private internal shared utility of `ptbk coder run`
+ */
+export type GitChangesMode = (typeof GIT_CHANGES_MODE_VALUES)[number];
+
+/**
+ * Mode applied when `--git-changes` is not used at all.
+ *
+ * @private internal shared utility of `ptbk coder run`
+ */
+export const DEFAULT_GIT_CHANGES_MODE: GitChangesMode = 'fail';
+
+/**
+ * Checks whether a value is a supported `--git-changes` mode.
+ *
+ * @private internal shared utility of `ptbk coder run`
+ */
+export function isGitChangesMode(value: string): value is GitChangesMode {
+    return GIT_CHANGES_MODE_VALUES.includes(value as GitChangesMode);
+}
+
+// Note: [🟡] Code for CLI command [run](src/cli/cli-commands/coder/run.ts) should never be published outside of `@promptbook/cli`

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

@@ -4,12 +4,18 @@ import type {
 } from 'commander';
 import { mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
-import prompts from 'prompts';
 import { spaceTrim } from 'spacetrim';
 import { NotAllowed } from '../../../errors/NotAllowed';
 import { ParseError } from '../../../errors/ParseError';
 import { normalizeToKebabCase } from '../../../utils/normalization/normalize-to-kebab-case';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
+import { loadPromptsModule } from '../../common/loadPromptsModule';
+import type { CoderGitSyncCliOptions } from '../common/coderGitSyncCliOptions';
+import {
+    addCoderGitSyncOptions,
+    CODER_GIT_SYNC_DESCRIPTION,
+    normalizeCoderGitSyncCliOptions,
+} from '../common/coderGitSyncCliOptions';
 import { handleActionErrors } from '../common/handleActionErrors';
 import {
     buildCoderPromptSection,
@@ -49,15 +55,19 @@ const FALLBACK_PROMPT_SLUG = 'prompt';
 export function $initializeCoderAddCommand(program: Program): $side_effect {
     const command = program.command('add');
     command.description(
-        spaceTrim(`
-            Add one ready-to-run prompt file to the queue
+        spaceTrim(
+            (block) => `
+                Add one ready-to-run prompt file to the queue
 
-            Provide the description as an argument, pipe it through stdin, or run without arguments to type it interactively:
-            - \`ptbk coder add "some new feature"\`
-            - \`ptbk coder add --priority 1 "some new feature"\`
-            - \`ptbk coder add <<EOF ... EOF\`
-            - \`ptbk coder add\`
-        `),
+                Provide the description as an argument, pipe it through stdin, or run without arguments to type it interactively:
+                - \`ptbk coder add "some new feature"\`
+                - \`ptbk coder add --priority 1 "some new feature"\`
+                - \`ptbk coder add <<EOF ... EOF\`
+                - \`ptbk coder add\`
+
+                ${block(CODER_GIT_SYNC_DESCRIPTION)}
+            `,
+        ),
     );
 
     command.argument('[description]', 'Plain-language description of the feature or task to implement');
@@ -77,22 +87,39 @@ export function $initializeCoderAddCommand(program: Program): $side_effect {
                 .join(', ')}) or a markdown file path relative to the current project root.
         `),
     );
+    addCoderGitSyncOptions(command);
 
     command.action(
         handleActionErrors(async (descriptionArgument: string | undefined, cliOptions) => {
             const { priority, template: templateOption } = cliOptions as {
                 readonly priority: number;
                 readonly template?: string;
-            };
+            } & CoderGitSyncCliOptions;
+
+            const gitSync = normalizeCoderGitSyncCliOptions(cliOptions as CoderGitSyncCliOptions);
+            const projectPath = process.cwd();
 
             const description = await resolveCoderPromptDescription(descriptionArgument);
 
-            await addCoderPrompt({
-                projectPath: process.cwd(),
+            // Note: Import the git synchronization dynamically to keep the CLI fast for runs without `--commit`
+            const { $commitCoderChanges, $startCoderGitSync } = await import(
+                '../../../../scripts/run-codex-prompts/git/coderGitSync'
+            );
+
+            const commitScope = await $startCoderGitSync({ gitSync, projectPath });
+
+            const { /* filePath,*/ emojiTag } = await addCoderPrompt({
+                projectPath,
                 description,
                 priority,
                 templateOption,
             });
+
+            await $commitCoderChanges({
+                gitSync,
+                commitScope,
+                commitMessage: `${emojiTag} Add prompt`,
+            });
         }),
     );
 }
@@ -216,6 +243,7 @@ async function resolveCoderPromptDescription(descriptionArgument: string | undef
         return standardInputDescription;
     }
 
+    const { default: prompts } = await loadPromptsModule();
     const response = await prompts({
         type: 'text',
         name: 'description',

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

@@ -0,0 +1,139 @@
+import { spaceTrim } from 'spacetrim';
+import { NotAllowed } from '../../../errors/NotAllowed';
+
+/**
+ * Separator between the number of generated files and the number of prompts in each of them,
+ * for example `10*7`.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+const BOILERPLATE_COUNT_SEPARATOR = '*';
+
+/**
+ * Pattern of the `--count` option value, either `N` or `N*M`.
+ */
+const BOILERPLATE_COUNT_PATTERN = /^(?<filesCount>\d+)(?:\s*\*\s*(?<promptsPerFileCount>\d+))?$/u;
+
+/**
+ * How many prompt boilerplate files are generated and how many prompts each of them contains.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export type BoilerplateCount = {
+    /**
+     * Number of generated prompt boilerplate files.
+     */
+    readonly filesCount: number;
+
+    /**
+     * Number of prompts written into each generated file.
+     *
+     * Note: More than one prompt per file is an advanced option - each prompt is one separate
+     *       coding task separated by `---`, with all prompts in the file sharing its fresh emoji tag.
+     */
+    readonly promptsPerFileCount: number;
+};
+
+/**
+ * Number of prompt boilerplate files and prompts per file used when `--count` is not provided.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export const DEFAULT_BOILERPLATE_COUNT: BoilerplateCount = {
+    filesCount: 5,
+    promptsPerFileCount: 1,
+};
+
+/**
+ * Formats one boilerplate count back into the `N*M` notation of the `--count` option.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export function formatBoilerplateCount({ filesCount, promptsPerFileCount }: BoilerplateCount): string {
+    return `${filesCount}${BOILERPLATE_COUNT_SEPARATOR}${promptsPerFileCount}`;
+}
+
+/**
+ * Default value of the `--count` option rendered in the `N*M` notation, for example `5*1`.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export const DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE = formatBoilerplateCount(DEFAULT_BOILERPLATE_COUNT);
+
+/**
+ * Description of the `--count` option shared by all commands which generate prompt boilerplates.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export const BOILERPLATE_COUNT_OPTION_DESCRIPTION = spaceTrim(`
+    Number of generated prompt boilerplate files, optionally with the number of prompts in each of them.
+
+    Use \`N\` (or \`N*1\`) for N files with one prompt each,
+    or the advanced \`N*M\` notation for N files with M prompts each, for example \`10*7\`.
+`);
+
+/**
+ * Parses the `--count` option value into the number of files and the number of prompts in each of them.
+ *
+ * Both notations are supported:
+ * - `N` and `N*1` => N files with one prompt each
+ * - `N*M` => N files with M prompts each
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export function parseBoilerplateCount(countOption: string): BoilerplateCount {
+    const normalizedCountOption = countOption.trim();
+    const match = BOILERPLATE_COUNT_PATTERN.exec(normalizedCountOption);
+
+    if (match === null) {
+        throw new NotAllowed(
+            spaceTrim(`
+                Invalid value for \`--count\`: \`${countOption}\`.
+
+                Use either \`N\` for N files with one prompt each,
+                or the advanced \`N*M\` notation for N files with M prompts each:
+
+                - \`--count 5\`
+                - \`--count 5*1\`
+                - \`--count 10*7\`
+            `),
+        );
+    }
+
+    const filesCount = Number(match.groups?.filesCount);
+    const promptsPerFileCount =
+        match.groups?.promptsPerFileCount === undefined
+            ? DEFAULT_BOILERPLATE_COUNT.promptsPerFileCount
+            : Number(match.groups.promptsPerFileCount);
+
+    assertsPositiveBoilerplateCountPart(filesCount, countOption, 'number of generated files');
+    assertsPositiveBoilerplateCountPart(promptsPerFileCount, countOption, 'number of prompts in each file');
+
+    return { filesCount, promptsPerFileCount };
+}
+
+/**
+ * Asserts that one part of the `--count` option value is a positive integer.
+ *
+ * @private internal utility of `parseBoilerplateCount`
+ */
+function assertsPositiveBoilerplateCountPart(
+    countPart: number,
+    countOption: string,
+    countPartDescription: string,
+): void {
+    if (Number.isInteger(countPart) && countPart > 0) {
+        return;
+    }
+
+    throw new NotAllowed(
+        spaceTrim(`
+            Invalid value for \`--count\`: \`${countOption}\`.
+
+            The ${countPartDescription} must be **a positive integer**, for example \`--count 10*7\`.
+        `),
+    );
+}
+
+// Note: [🟡] Code for coder boilerplate count [boilerplateCount](src/cli/cli-commands/coder/boilerplateCount.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/coder/boilerplateTemplates.ts

@@ -124,24 +124,12 @@ const DEFAULT_CODER_PROMPT_TEMPLATE_DEFINITIONS = [
             -   @@@
             -   Keep in mind the DRY _(don't repeat yourself)_ principle.
             -   Do a proper analysis of the current functionality before you start implementing.
-            -   Add the changes into the [changelog](changelog/_current-preversion.md)
+            -   Add the changes into the [changelog](CHANGELOG.md)
+            -   Update the [README](README.md) if needed.
+            -   Update the [AGENTS.md](AGENTS.md) for the next job to be done if it makes sense.
         `),
         isDefaultProjectTemplate: true,
     },
-    {
-        id: 'agents-server',
-        relativeFilePath: join(PROMPTS_TEMPLATES_DIRECTORY_PATH, 'agents-server.md'),
-        slugPrefix: 'agents-server',
-        content: spaceTrim(`
-            -   @@@
-            -   Keep in mind the DRY _(don't repeat yourself)_ principle.
-            -   Do a proper analysis of the current functionality before you start implementing.
-            -   You are working with the [Agents Server](apps/agents-server)
-            -   If you need to do the database migration, do it
-            -   Add the changes into the [changelog](changelog/_current-preversion.md)
-        `),
-        isDefaultProjectTemplate: false,
-    },
 ] as const satisfies ReadonlyArray<CoderPromptTemplateDefinition>;
 
 /**

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 one unique emoji tag per file
+
+                ${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,41 +57,59 @@ 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();
+
+            // Note: Import the git synchronization dynamically to keep the CLI fast for runs without `--commit`
+            const { $commitCoderChanges, $startCoderGitSync } = await import(
+                '../../../../scripts/run-codex-prompts/git/coderGitSync'
+            );
 
-            const filesCount = parseFilesCount(countOption);
+            const commitScope = await $startCoderGitSync({ gitSync, projectPath });
 
             await generatePromptBoilerplate({
-                projectPath: process.cwd(),
-                filesCount,
+                projectPath,
+                boilerplateCount,
                 templateOption,
             });
 
+            await $commitCoderChanges({
+                gitSync,
+                commitScope,
+                commitMessage: `Prompts ${formatBoilerplateCount(boilerplateCount)}`,
+            });
+
             return process.exit(0);
         }),
     );
 }
 
 /**
- * Generates boilerplate prompt files with unique emoji tags.
+ * Generates boilerplate prompt files with one unique emoji tag per file.
  *
  * @private internal function of `generatePromptBoilerplate` command
  */
 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,7 +134,9 @@ export async function generatePromptBoilerplate({
         colors.blue(`Highest existing number for ${promptNumbering.datePrefix} found: ${highestNumberFormatted}`),
     );
 
+    const promptsCount = filesCount * promptsPerFileCount;
     const { availableCount, selectedEmojis } = await getFreshPromptEmojiTags({
+        // Note: Each generated file reserves one fresh emoji tag shared by all of its prompt sections
         count: filesCount,
         rootDir: projectPath,
     });
@@ -117,7 +154,7 @@ 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 emojiTag = formatPromptEmojiTag(selectedEmojis[i]!);
         const filename = buildPromptFilename(
             promptNumbering.datePrefix,
             number,
@@ -125,39 +162,19 @@ export async function generatePromptBoilerplate({
         );
         const filepath = join(PROMPTS_DIRECTORY_PATH, filename);
         const absoluteFilepath = join(projectPath, filepath);
-        const emojiTag = formatPromptEmojiTag(emoji);
-        const one = buildCoderPromptSection({
-            statusLine: '[-]',
+        const content = buildBoilerplatePromptFileContent({
             emojiTag,
+            promptsPerFileCount,
             title,
             body: promptTemplate.content,
         });
-        const content = spaceTrim(
-            (block) => `
-
-                ${block(one)}
-
-                ---
-
-                ${block(one)}
-
-                ---
-
-                ${block(one)}
-
-                ---
-
-                ${block(one)}
-
-            `,
-        );
 
         filesToCreate.push({
             filepath,
             absoluteFilepath,
             filename,
             content,
-            emoji,
+            emojiTag,
             number,
         });
     }
@@ -167,26 +184,43 @@ 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.emojiTag}`));
     }
 
-    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 prompt.
+ *
+ * Multiple prompts in one file share the file emoji tag and 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({
+    emojiTag,
+    promptsPerFileCount,
+    title,
+    body,
+}: {
+    readonly emojiTag: string;
+    readonly promptsPerFileCount: number;
+    readonly title: string;
+    readonly body: string;
+}): string {
+    return Array.from({ length: promptsPerFileCount }, () =>
+        buildCoderPromptSection({
+            statusLine: '[-]',
+            emojiTag,
+            title,
+            body,
+        }),
+    ).join('\n\n---\n\n');
 }
 
 /**

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

@@ -1,13 +1,16 @@
+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:add': 'ptbk coder add --template ./prompts/templates/common.md',
+    // Note: Using NPX because `ptbk` can be installed globally or locally, and NPX will resolve it correctly in either case.
+    'coder:generate-boilerplates': `npx ptbk coder generate-boilerplates --count ${DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE} --template ./prompts/templates/common.md`,
+    'coder:add': 'npx 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',
+        'npx 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',
     // 'coder:find-refactor-candidates': 'npx ptbk coder find-refactor-candidates',
-    'coder:verify': 'ptbk coder verify',
+    'coder:verify': 'npx ptbk coder verify',
 } as const satisfies Readonly<Record<string, string>>;
 
 /**