@promptbook/cli 0.114.0-30 → 0.114.0-32

package/esm/scripts/run-codex-prompts/prompts/findFirstNonEmptyLineIndex.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Finds the first non-empty line within the inclusive bounds.
+ *
+ * @private internal utility of prompt parsing and status writing
+ */
+export declare function findFirstNonEmptyLineIndex(lines: readonly string[], startLine: number, endLine: number): number | undefined;

package/esm/scripts/run-codex-prompts/prompts/writePromptStatusLine.d.ts

@@ -3,7 +3,8 @@ import type { PromptSection } from './types/PromptSection';
 /**
  * Rewrites the status line of one prompt section while preserving its indentation.
  *
- * Only a todo `[ ]` or an in-progress `[^]` status line is rewritten, so an already finalized
- * `[x]`, `[!]` or `[-]` status is never overwritten by accident.
+ * An unmarked prompt is implicitly a todo, so its first live status line is inserted immediately before its content.
+ * Only a todo `[ ]` or an in-progress `[^]` status line is otherwise rewritten, so an already finalized `[x]`, `[!]`
+ * or `[-]` status is never overwritten by accident.
  */
 export declare function writePromptStatusLine(file: PromptFile, section: PromptSection, replacementStatusLine: string): void;

package/esm/src/cli/cli-commands/coder/$ensureCoderHarnessGitignoreRules.d.ts

@@ -0,0 +1,9 @@
+import type { PromptRunnerHarnessName } from '../common/promptRunnerCliOptions';
+/**
+ * Offers to add missing project-local ignore rules for the selected coding harness.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it may ask the user and update `.gitignore`.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function $ensureCoderHarnessGitignoreRules(projectPath: string, harnessName: PromptRunnerHarnessName | undefined): Promise<void>;

package/esm/src/cli/cli-commands/coder/$ensureCoderHarnessGitignoreRules.test.d.ts

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

package/esm/src/cli/cli-commands/coder/ensureCoderGitignoreFile.d.ts

@@ -1,7 +1,20 @@
+import { type PromptRunnerHarnessName } from '../common/promptRunnerCliOptions';
 import type { InitializationStatus } from './boilerplateTemplates';
 /**
- * Ensures `.gitignore` contains the standalone Promptbook temp entry.
+ * Ensures `.gitignore` contains Promptbook Coder's local artifacts and every supported harness's local artifacts.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */
 export declare function ensureCoderGitignoreFile(projectPath: string): Promise<InitializationStatus>;
+/**
+ * Lists missing project-local ignore rules for the selected harnesses.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function getMissingCoderHarnessGitignoreRules(projectPath: string, harnessNames: ReadonlyArray<PromptRunnerHarnessName>): Promise<ReadonlyArray<string>>;
+/**
+ * Adds the given Promptbook Coder rules to a project's `.gitignore` file.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function ensureCoderGitignoreRules(projectPath: string, rules: ReadonlyArray<string>): Promise<InitializationStatus>;

package/esm/src/cli/cli-commands/coder/server.test.d.ts

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

package/esm/src/cli/cli-commands/common/$askForConfirmation.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Asks the user in the terminal to confirm one optional change.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it reads the answer from stdin.
+ *
+ * @returns `true` when the user confirms, `false` when the user declines or the terminal is not interactive.
+ * @private internal utility of `promptbookCli`
+ */
+export declare function $askForConfirmation(question: string): Promise<boolean>;

package/esm/src/cli/cli-commands/common/harness/HarnessDefinition.d.ts

@@ -45,6 +45,10 @@ export type HarnessDefinition = {
      * Extra environment variables required by the global npm installation of this harness.
      */
     readonly npmInstallEnvironment?: Readonly<Record<string, string>>;
+    /**
+     * Project-local files or directories which this harness can create and which should not be committed.
+     */
+    readonly projectGitignoreRules: ReadonlyArray<string>;
     /**
      * How a standalone installation of this harness is recognized and updated.
      *
@@ -64,3 +68,9 @@ export declare const HARNESS_DEFINITIONS: Readonly<Record<PromptRunnerHarnessNam
  * @private internal utility of `promptbookCli`
  */
 export declare function getHarnessDefinition(harnessName: PromptRunnerHarnessName): HarnessDefinition;
+/**
+ * Lists the unique project ignore rules required by the selected harnesses, in selection order.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function getHarnessProjectGitignoreRules(harnessNames: ReadonlyArray<PromptRunnerHarnessName>): ReadonlyArray<string>;

package/esm/src/cli/cli-commands/common/projectInitialization.d.ts

@@ -50,6 +50,12 @@ export declare function ensureProjectEnvFile<TEnvVariable extends ProjectEnvVari
  * @private internal utility of Promptbook CLI project initialization
  */
 export declare function ensureProjectGitignoreFile({ projectPath, blockHeader, rules, }: EnsureProjectGitignoreFileOptions): Promise<ProjectInitializationStatus>;
+/**
+ * Lists the ignore rules which are not yet present in a project's `.gitignore` file.
+ *
+ * @private internal utility of Promptbook CLI project initialization
+ */
+export declare function getMissingProjectGitignoreRules(projectPath: string, rules: ReadonlyArray<string>): Promise<ReadonlyArray<string>>;
 /**
  * Reads one text file when it exists, otherwise returns `undefined`.
  *

package/esm/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-29`).
+ * It follows semantic versioning (e.g., `0.114.0-31`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.114.0-30",
+    "version": "0.114.0-32",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

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

@@ -0,0 +1,51 @@
+import colors from 'colors';
+import type { PromptRunnerHarnessName } from '../common/promptRunnerCliOptions';
+import { $askForConfirmation } from '../common/$askForConfirmation';
+import { getHarnessDefinition } from '../common/harness/HarnessDefinition';
+import { ensureCoderGitignoreRules, getMissingCoderHarnessGitignoreRules } from './ensureCoderGitignoreFile';
+
+/**
+ * Offers to add missing project-local ignore rules for the selected coding harness.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it may ask the user and update `.gitignore`.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export async function $ensureCoderHarnessGitignoreRules(
+    projectPath: string,
+    harnessName: PromptRunnerHarnessName | undefined,
+): Promise<void> {
+    if (harnessName === undefined) {
+        return;
+    }
+
+    const missingRules = await getMissingCoderHarnessGitignoreRules(projectPath, [harnessName]);
+
+    if (missingRules.length === 0) {
+        return;
+    }
+
+    const { label } = getHarnessDefinition(harnessName);
+    const formattedRules = formatGitignoreRules(missingRules);
+    const entryLabel = missingRules.length === 1 ? 'entry' : 'entries';
+    const isAdditionApproved = await $askForConfirmation(
+        `Add the missing ${label} ignore ${entryLabel} ${formattedRules} to \`.gitignore\` now?`,
+    );
+
+    if (!isAdditionApproved) {
+        console.info(colors.gray(`Skipped, add ${formattedRules} to \`.gitignore\` manually.`));
+        return;
+    }
+
+    await ensureCoderGitignoreRules(projectPath, missingRules);
+    console.info(colors.gray(`✔ Added ${formattedRules} to \`.gitignore\`.`));
+}
+
+/**
+ * Formats one or more `.gitignore` rules for a terminal confirmation message.
+ */
+function formatGitignoreRules(rules: ReadonlyArray<string>): string {
+    return rules.map((rule) => `\`${rule}\``).join(', ');
+}
+
+// Note: [🟡] Code for coder harness gitignore prompts [$ensureCoderHarnessGitignoreRules](src/cli/cli-commands/coder/$ensureCoderHarnessGitignoreRules.ts) should never be published outside of `@promptbook/cli`

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

@@ -1,6 +1,8 @@
 import { getPromptbookTemporaryGitignoreRule } from '../../../utils/filesystem/promptbookTemporaryPath';
+import { PROMPT_RUNNER_HARNESS_NAMES, type PromptRunnerHarnessName } from '../common/promptRunnerCliOptions';
+import { getHarnessProjectGitignoreRules } from '../common/harness/HarnessDefinition';
 import type { InitializationStatus } from './boilerplateTemplates';
-import { ensureProjectGitignoreFile } from '../common/projectInitialization';
+import { ensureProjectGitignoreFile, getMissingProjectGitignoreRules } from '../common/projectInitialization';
 
 /**
  * Promptbook temporary root directory that should stay out of version control.
@@ -18,15 +20,47 @@ const CODER_ENV_GITIGNORE_RULE = '.env';
 const CODER_GITIGNORE_HEADER = '# Promptbook Coder';
 
 /**
- * Ensures `.gitignore` contains the standalone Promptbook temp entry.
+ * Coder-owned local artifacts which every initialized project should ignore.
+ */
+const CODER_GITIGNORE_RULES = [PROMPTBOOK_TEMP_GITIGNORE_RULE, CODER_ENV_GITIGNORE_RULE] as const;
+
+/**
+ * Ensures `.gitignore` contains Promptbook Coder's local artifacts and every supported harness's local artifacts.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */
 export async function ensureCoderGitignoreFile(projectPath: string): Promise<InitializationStatus> {
+    return ensureCoderGitignoreRules(projectPath, [
+        ...CODER_GITIGNORE_RULES,
+        ...getHarnessProjectGitignoreRules(PROMPT_RUNNER_HARNESS_NAMES),
+    ]);
+}
+
+/**
+ * Lists missing project-local ignore rules for the selected harnesses.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export async function getMissingCoderHarnessGitignoreRules(
+    projectPath: string,
+    harnessNames: ReadonlyArray<PromptRunnerHarnessName>,
+): Promise<ReadonlyArray<string>> {
+    return getMissingProjectGitignoreRules(projectPath, getHarnessProjectGitignoreRules(harnessNames));
+}
+
+/**
+ * Adds the given Promptbook Coder rules to a project's `.gitignore` file.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export async function ensureCoderGitignoreRules(
+    projectPath: string,
+    rules: ReadonlyArray<string>,
+): Promise<InitializationStatus> {
     return ensureProjectGitignoreFile({
         projectPath,
         blockHeader: CODER_GITIGNORE_HEADER,
-        rules: [PROMPTBOOK_TEMP_GITIGNORE_RULE, CODER_ENV_GITIGNORE_RULE],
+        rules,
     });
 }
 

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

@@ -62,7 +62,7 @@ export function $initializeCoderInitCommand(program: Program): $side_effect {
                 - ${CODER_DEVELOPER_AGENT_FILE_PATH}
                 - ${AGENTS_FILE_PATH}
                 - ${AGENT_CODING_FILE_PATH}
-                - .gitignore
+                - .gitignore with local artifacts from every supported harness
                 - package.json
                 - .vscode/settings.json
 

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

@@ -18,6 +18,7 @@ import {
     PROMPT_RUNNER_DESCRIPTION,
 } from '../common/promptRunnerCliOptions';
 import { parseOptionalPeriodDuration } from './waitOptions';
+import { $ensureCoderHarnessGitignoreRules } from './$ensureCoderHarnessGitignoreRules';
 
 /**
  * Initializes `coder ping` command for Promptbook CLI utilities
@@ -39,7 +40,7 @@ export function $initializeCoderPingCommand(program: Program): $side_effect {
             - 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
             - Optional --period keeps the quota window refreshing by pinging once per period until stopped
-            - Leaves the project exactly as it was — nothing is read, written, changed or committed
+            - Makes no coding changes or commits; if the selected harness has missing local ignore rules, offers to add them to .gitignore
             - Checks that the selected harness is installed and up to date unless --no-harness-update is used
             - Use --no-ui to stream the raw harness output instead of only the compact result
         `),
@@ -74,6 +75,7 @@ export function $initializeCoderPingCommand(program: Program): $side_effect {
             const periodMs = parseOptionalPeriodDuration('--period', periodValue);
 
             await $ensureHarnessInstallations([runnerOptions.agentName], isHarnessUpdateCheckEnabled);
+            await $ensureCoderHarnessGitignoreRules(process.cwd(), runnerOptions.agentName);
 
             const pingOptions = {
                 agentName: runnerOptions.agentName,

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

@@ -29,6 +29,7 @@ import {
     type TestBeforeMode,
 } from '../../../../scripts/run-codex-prompts/testing/TestBeforeMode';
 import { DEFAULT_WAIT_AFTER_ERROR_MS, parseOptionalWaitDuration } from './waitOptions';
+import { $ensureCoderHarnessGitignoreRules } from './$ensureCoderHarnessGitignoreRules';
 
 /**
  * Initializes `coder run` command for Promptbook CLI utilities
@@ -56,6 +57,7 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
             - 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 and up to date before the first prompt unless --no-harness-update 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
@@ -223,6 +225,7 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
             }
 
             await $ensureHarnessInstallations([runnerOptions.agentName], isHarnessUpdateCheckEnabled);
+            await $ensureCoderHarnessGitignoreRules(process.cwd(), runnerOptions.agentName);
 
             const waitAfterPrompt = parseOptionalWaitDuration(waitAfterPromptValue, 0);
             const waitBetweenPrompts = parseOptionalWaitDuration(waitBetweenPromptsValue, 0);

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

@@ -25,6 +25,7 @@ import {
     PROMPT_RUNNER_DESCRIPTION,
 } from '../common/promptRunnerCliOptions';
 import { DEFAULT_WAIT_AFTER_ERROR_MS, parseOptionalWaitDuration } from './waitOptions';
+import { $ensureCoderHarnessGitignoreRules } from './$ensureCoderHarnessGitignoreRules';
 
 /**
  * Default port used by `ptbk coder server`.
@@ -54,6 +55,7 @@ export function $initializeCoderServerCommand(program: Program): $side_effect {
             Features:
             - Runs the same prompt processing as \`ptbk coder run\`
             - Checks that the selected harness is installed and up to date on startup unless --no-harness-update 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)
@@ -184,6 +186,7 @@ export function $initializeCoderServerCommand(program: Program): $side_effect {
             );
 
             await $ensureHarnessInstallations([runnerOptions.agentName], isHarnessUpdateCheckEnabled);
+            await $ensureCoderHarnessGitignoreRules(process.cwd(), runnerOptions.agentName);
 
             // [1] Parse the wait options and --no-auto (same logic as `coder run`)
             const waitForUser = !auto;

package/src/cli/cli-commands/common/$askForConfirmation.ts

@@ -0,0 +1,31 @@
+import colors from 'colors';
+import { createInterface } from 'readline';
+
+/**
+ * Asks the user in the terminal to confirm one optional change.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it reads the answer from stdin.
+ *
+ * @returns `true` when the user confirms, `false` when the user declines or the terminal is not interactive.
+ * @private internal utility of `promptbookCli`
+ */
+export async function $askForConfirmation(question: string): Promise<boolean> {
+    if (!process.stdin.isTTY) {
+        // Note: In non-interactive environments like CI there is nobody who could confirm the change.
+        return false;
+    }
+
+    const readlineInterface = createInterface({ input: process.stdin, output: process.stdout });
+
+    try {
+        const answer = await new Promise<string>((resolve) => {
+            readlineInterface.question(colors.cyan(`${question} [y/N] `), resolve);
+        });
+
+        return ['y', 'yes'].includes(answer.trim().toLowerCase());
+    } finally {
+        readlineInterface.close();
+    }
+}
+
+// Note: [🟡] Code for CLI confirmations [$askForConfirmation](src/cli/cli-commands/common/$askForConfirmation.ts) should never be published outside of `@promptbook/cli`

package/src/cli/cli-commands/common/harness/HarnessDefinition.ts

@@ -55,6 +55,11 @@ export type HarnessDefinition = {
      */
     readonly npmInstallEnvironment?: Readonly<Record<string, string>>;
 
+    /**
+     * Project-local files or directories which this harness can create and which should not be committed.
+     */
+    readonly projectGitignoreRules: ReadonlyArray<string>;
+
     /**
      * How a standalone installation of this harness is recognized and updated.
      *
@@ -74,6 +79,7 @@ export const HARNESS_DEFINITIONS: Readonly<Record<PromptRunnerHarnessName, Harne
         label: 'OpenAI Codex',
         commandName: 'codex',
         npmPackageName: '@openai/codex',
+        projectGitignoreRules: ['.codex'],
         // Note: The official standalone installer keeps its package in `~/.codex` and links it onto the `PATH`
         standaloneInstallation: {
             directoryNames: ['.codex'],
@@ -85,6 +91,7 @@ export const HARNESS_DEFINITIONS: Readonly<Record<PromptRunnerHarnessName, Harne
         label: 'GitHub Copilot',
         commandName: 'copilot',
         npmPackageName: '@github/copilot',
+        projectGitignoreRules: ['.github/copilot/settings.local.json'],
         // Note: The GitHub Copilot CLI downloads its native binary in a postinstall script
         npmInstallEnvironment: { npm_config_ignore_scripts: 'false' },
     },
@@ -93,30 +100,35 @@ export const HARNESS_DEFINITIONS: Readonly<Record<PromptRunnerHarnessName, Harne
         label: 'Cline',
         commandName: 'cline',
         npmPackageName: 'cline',
+        projectGitignoreRules: ['.cline'],
     },
     'claude-code': {
         harnessName: 'claude-code',
         label: 'Claude Code',
         commandName: 'claude',
         npmPackageName: '@anthropic-ai/claude-code',
+        projectGitignoreRules: ['.claude'],
     },
     opencode: {
         harnessName: 'opencode',
         label: 'Opencode',
         commandName: 'opencode',
         npmPackageName: 'opencode-ai',
+        projectGitignoreRules: ['.opencode'],
     },
     gemini: {
         harnessName: 'gemini',
         label: 'Gemini CLI',
         commandName: 'gemini',
         npmPackageName: '@google/gemini-cli',
+        projectGitignoreRules: ['.gemini'],
     },
     'qwen-code': {
         harnessName: 'qwen-code',
         label: 'Qwen Code',
         commandName: 'qwen',
         npmPackageName: '@qwen-code/qwen-code',
+        projectGitignoreRules: ['.qwen'],
     },
 };
 
@@ -140,3 +152,16 @@ export function getHarnessDefinition(harnessName: PromptRunnerHarnessName): Harn
 
     return definition;
 }
+
+/**
+ * Lists the unique project ignore rules required by the selected harnesses, in selection order.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export function getHarnessProjectGitignoreRules(
+    harnessNames: ReadonlyArray<PromptRunnerHarnessName>,
+): ReadonlyArray<string> {
+    return Array.from(
+        new Set(harnessNames.flatMap((harnessName) => getHarnessDefinition(harnessName).projectGitignoreRules)),
+    );
+}

package/src/cli/cli-commands/common/npm/$askForNpmPackageInstallationApproval.ts

@@ -1,5 +1,4 @@
-import colors from 'colors';
-import { createInterface } from 'readline';
+import { $askForConfirmation } from '../$askForConfirmation';
 
 /**
  * Asks the user in the terminal whether an npm package should be installed or updated now.
@@ -10,22 +9,7 @@ import { createInterface } from 'readline';
  * @private internal utility of `promptbookCli`
  */
 export async function $askForNpmPackageInstallationApproval(question: string): Promise<boolean> {
-    if (!process.stdin.isTTY) {
-        // Note: In non-interactive environments like CI there is nobody who could confirm the installation
-        return false;
-    }
-
-    const readlineInterface = createInterface({ input: process.stdin, output: process.stdout });
-
-    try {
-        const answer = await new Promise<string>((resolve) => {
-            readlineInterface.question(colors.cyan(`${question} [y/N] `), resolve);
-        });
-
-        return ['y', 'yes'].includes(answer.trim().toLowerCase());
-    } finally {
-        readlineInterface.close();
-    }
+    return $askForConfirmation(question);
 }
 
 // Note: [🟡] Code for CLI npm package installation approval [$askForNpmPackageInstallationApproval](src/cli/cli-commands/common/npm/$askForNpmPackageInstallationApproval.ts) should never be published outside of `@promptbook/cli`

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

@@ -113,7 +113,7 @@ export async function ensureProjectGitignoreFile({
 }: EnsureProjectGitignoreFileOptions): Promise<ProjectInitializationStatus> {
     const gitignorePath = join(projectPath, GITIGNORE_FILE_PATH);
     const currentGitignoreContent = await readTextFileIfExists(gitignorePath);
-    const missingRules = rules.filter((rule) => !hasGitignoreRule(currentGitignoreContent || '', rule));
+    const missingRules = getMissingGitignoreRules(currentGitignoreContent || '', rules);
 
     if (currentGitignoreContent !== undefined && missingRules.length === 0) {
         return 'unchanged';
@@ -132,6 +132,21 @@ export async function ensureProjectGitignoreFile({
     return currentGitignoreContent === undefined ? 'created' : 'updated';
 }
 
+/**
+ * Lists the ignore rules which are not yet present in a project's `.gitignore` file.
+ *
+ * @private internal utility of Promptbook CLI project initialization
+ */
+export async function getMissingProjectGitignoreRules(
+    projectPath: string,
+    rules: ReadonlyArray<string>,
+): Promise<ReadonlyArray<string>> {
+    const gitignorePath = join(projectPath, GITIGNORE_FILE_PATH);
+    const currentGitignoreContent = (await readTextFileIfExists(gitignorePath)) || '';
+
+    return getMissingGitignoreRules(currentGitignoreContent, rules);
+}
+
 /**
  * Reads one text file when it exists, otherwise returns `undefined`.
  *
@@ -191,9 +206,17 @@ function parseEnvVariableNames(envContent: string): Set<string> {
  * Detects whether `.gitignore` already covers one exact rule.
  */
 function hasGitignoreRule(gitignoreContent: string, rule: string): boolean {
-    const normalizedRulePattern = rule.startsWith('/') ? `/?${escapeRegExp(rule.slice(1))}` : escapeRegExp(rule);
+    const normalizedRule = rule.startsWith('/') ? rule.slice(1) : rule;
+    const normalizedRulePattern = `/?${escapeRegExp(normalizedRule)}`;
     return new RegExp(`(^|[\\r\\n])${normalizedRulePattern}(?:[\\r\\n]|$)`, 'u').test(gitignoreContent);
 }
 
+/**
+ * Finds the unique rules which are not covered by existing `.gitignore` content.
+ */
+function getMissingGitignoreRules(gitignoreContent: string, rules: ReadonlyArray<string>): ReadonlyArray<string> {
+    return Array.from(new Set(rules)).filter((rule) => !hasGitignoreRule(gitignoreContent, rule));
+}
+
 // Note: [🟡] Code for CLI project initialization [projectInitialization](src/cli/cli-commands/common/projectInitialization.ts) should never be published outside of `@promptbook/cli`
 // Note: [💞] Ignore a discrepancy between file name and entity name