@promptbook/google 0.114.0-49 → 0.114.0-50

package/README.md

@@ -610,7 +610,7 @@ In short: tools like Claude Code, Codex, or GitHub Copilot are the **engines**;
 
 #### How the workflow works
 
-1. `ptbk coder init` prepares the project for the coder workflow, seeds project-owned generic templates in `prompts/templates/`, creates a starter `AGENTS.md` context file, adds helper `npm run coder:*` scripts, ensures `.gitignore` ignores `/.promptbook`, and configures VS Code prompt screenshots in `prompts/screenshots/`.
+1. `ptbk coder init` prepares the project for the coder workflow, seeds project-owned generic templates in `prompts/templates/`, creates a starter `AGENTS.md` context file, adds helper `npm run coder:*` scripts, ensures `.gitignore` ignores `node_modules` and `/.promptbook`, creates missing `.gitattributes` for LF line endings, and configures VS Code prompt screenshots in `prompts/screenshots/`.
 2. `ptbk coder generate-boilerplates` creates prompt files in `prompts/`.
 3. You replace placeholder `@@@` sections with real coding tasks.
 4. `ptbk coder run` sends the next ready `[ ]` prompt to the selected coding agent and immediately marks it as in progress `[^]`, naming the harness, the model and the step which is running.
@@ -681,13 +681,13 @@ ptbk coder find-refactor-candidates --level xhigh
 ptbk coder verify
 ```
 
-`ptbk coder init` also bootstraps a starter `AGENTS.md`, adds `package.json` scripts for the four main coder commands, adds the shared `/.promptbook` temp ignore to `.gitignore`, and configures `.vscode/settings.json` so pasted images from `prompts/*.md` land in `prompts/screenshots/`.
+`ptbk coder init` also bootstraps a starter `AGENTS.md`, adds `package.json` scripts for the four main coder commands, adds `node_modules` and the shared `/.promptbook` temp ignore to `.gitignore`, and configures `.vscode/settings.json` so pasted images from `prompts/*.md` land in `prompts/screenshots/`. It creates a missing `.gitattributes` with `* text=auto eol=lf` and preserves existing attributes.
 
 #### What each command does
 
 | Command                               | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
 | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
-| `ptbk coder init`                     | Creates `prompts/`, `prompts/done/`, the project-generic template files materialized in `prompts/templates/` (currently `common.md`), and a starter `AGENTS.md`; ensures `.env` contains `CODING_AGENT_GIT_NAME`, `CODING_AGENT_GIT_EMAIL`, and `CODING_AGENT_GIT_SIGNING_KEY`; adds helper coder scripts to `package.json`; ensures `.gitignore` contains `/.promptbook`; and configures `.vscode/settings.json` to save pasted prompt images into `prompts/screenshots/`. |
+| `ptbk coder init`                     | Creates `prompts/`, `prompts/done/`, the project-generic template files materialized in `prompts/templates/` (currently `common.md`), and a starter `AGENTS.md`; ensures `.env` contains `CODING_AGENT_GIT_NAME`, `CODING_AGENT_GIT_EMAIL`, and `CODING_AGENT_GIT_SIGNING_KEY`; adds helper coder scripts to `package.json`; ensures `.gitignore` contains `node_modules` and `/.promptbook`; creates missing `.gitattributes` with `* text=auto eol=lf`; and configures `.vscode/settings.json` to save pasted prompt images into `prompts/screenshots/`. |
 | `ptbk coder generate-boilerplates`    | Creates new prompt markdown files with fresh emoji tags so you can quickly fill in coding tasks; `--template` accepts either a built-in alias or a markdown file path relative to the project root.                                                                                                                                                                                                                                                                         |
 | `ptbk coder run`                      | Picks the next ready prompt, can run project checks before coding to stop or repair pre-existing failures, appends optional context, runs it through the selected coding agent, can optionally check each attempt with the project command and feed failing output back for retries, then marks success or failure, commits the result, and pushes only when `--auto-push` is enabled.                                                                                      |
 | `ptbk coder find-refactor-candidates` | Scans the repository for oversized or overpacked files and writes prompt files for likely refactors; `--level <xlow                                                                                                                                                                                                                                                                                                                                                         | low | medium | high | xhigh | extreme>` ranges from a very benevolent scan to a very aggressive sweep. |

package/esm/index.es.js

@@ -16,7 +16,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.114.0-49';
+const PROMPTBOOK_ENGINE_VERSION = '0.114.0-50';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

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

@@ -1,5 +1,6 @@
 import type { Command as Program } from 'commander';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
+import { type ResolvedCoderPromptTemplate } from './boilerplateTemplates';
 /**
  * Initializes `coder add` command for Promptbook CLI utilities
  *
@@ -28,11 +29,13 @@ export type AddCoderPromptResult = {
  *
  * @private internal utility of `coder add` command
  */
-export declare function addCoderPrompt({ projectPath, description, priority, templateOption, }: {
+export declare function addCoderPrompt({ projectPath, description, priority, templateOption, promptTemplate, }: {
     readonly projectPath: string;
     readonly description: string;
     readonly priority: number;
     readonly templateOption?: string;
+    /** Internal authoring workflows may supply their own bounded instructions instead of the feature template. */
+    readonly promptTemplate?: ResolvedCoderPromptTemplate;
 }): Promise<AddCoderPromptResult>;
 /**
  * Prepares a numbered, emoji-tagged prompt for preview without writing the prompt file.
@@ -40,13 +43,15 @@ export declare function addCoderPrompt({ projectPath, description, priority, tem
  *
  * @private internal utility shared by `coder add` and `coder plan`
  */
-export declare function prepareCoderPrompt({ projectPath, description, priority, templateOption, numberOffset, reservedEmojiTag, }: {
+export declare function prepareCoderPrompt({ projectPath, description, priority, templateOption, numberOffset, reservedEmojiTag, promptTemplate: providedPromptTemplate, }: {
     readonly projectPath: string;
     readonly description: string;
     readonly priority: number;
     readonly templateOption?: string;
     readonly numberOffset?: number;
     readonly reservedEmojiTag?: string;
+    /** Shared repair authoring preserves numbering and tags without appending ordinary implementation instructions. */
+    readonly promptTemplate?: ResolvedCoderPromptTemplate;
 }): Promise<AddCoderPromptResult & {
     readonly content: string;
 }>;

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

@@ -0,0 +1,13 @@
+import type { InitializationStatus } from './boilerplateTemplates';
+/**
+ * Project-relative path to the Git attributes initialized by Promptbook Coder.
+ *
+ * @private internal constant of `coder init`
+ */
+export declare const CODER_GITATTRIBUTES_FILE_PATH = ".gitattributes";
+/**
+ * Creates default Git attributes when missing, preserving project-owned attributes.
+ *
+ * @private function of `initializeCoderProjectConfiguration`
+ */
+export declare function ensureCoderGitattributesFile(projectPath: string): Promise<InitializationStatus>;

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

@@ -1,7 +1,7 @@
 import { type PromptRunnerHarnessName } from '../common/promptRunnerCliOptions';
 import type { InitializationStatus } from './boilerplateTemplates';
 /**
- * Ensures `.gitignore` contains Promptbook Coder's local artifacts and every supported harness's local artifacts.
+ * Ensures `.gitignore` covers local dependencies, coder artifacts and every supported harness's local artifacts.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */

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

@@ -0,0 +1,7 @@
+import type { Command as Program } from 'commander';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
+/**
+ * Registers a finite check-repair command with the shared parser, defaults and execution policy.
+ * @private internal CLI command registration
+ */
+export declare function $initializeCoderFixCommand(program: Program): $side_effect;

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

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

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

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

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

@@ -15,6 +15,7 @@ export type CoderInitializationSummary = {
     readonly adamAgentFileDiagnostic?: string;
     readonly envFileStatus: InitializationStatus;
     readonly gitignoreFileStatus: InitializationStatus;
+    readonly gitattributesFileStatus: InitializationStatus;
     readonly packageJsonFileStatus: InitializationStatus;
     readonly vscodeSettingsFileStatus: InitializationStatus;
     readonly addedPackageJsonScriptNames: ReadonlyArray<string>;

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

@@ -11,6 +11,7 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * - find-refactor-candidates: Find files that need refactoring
  * - list: List ready prompts in priority order without running them
  * - run: Run coding prompts with AI agents
+ * - fix: Check and repair the project, then exit without processing the queue
  * - ping: Test one harness and model with a tiny dummy prompt
  * - verify: Verify completed prompts
  * - find-fresh-emoji-tags: Find unused emoji tags

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

@@ -8,7 +8,7 @@ export declare const LEGACY_CODER_CHECK_OPTIONS: readonly [readonly ["--test", "
  * Registers the shared project check command and rejects retired aggregate-test spellings.
  * @private shared CLI registration for Coder execution
  */
-export declare function addCoderCheckOptions(command: Command, isCheckBeforeSupported: boolean): void;
+export declare function addCoderCheckOptions(command: Command, isCheckBeforeSupported: boolean, description?: string): void;
 /**
  * Builds the same actionable migration diagnostic for registered and direct-script entrypoints.
  * @private shared CLI diagnostic for Coder execution

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

@@ -0,0 +1,7 @@
+import type { ProjectInitializationStatus } from './projectInitialization';
+/**
+ * Creates one project text file with default content, preserving any existing file.
+ *
+ * @private internal utility of Promptbook CLI project initialization
+ */
+export declare function ensureProjectTextFile(projectPath: string, relativeFilePath: string, fileContent: string): Promise<ProjectInitializationStatus>;

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

@@ -11,4 +11,6 @@ import type { NormalizedQuestionsCliOptions } from '../questionsCliOptions';
  *
  * @private internal utility of `promptbookCli`
  */
-export declare function $ensureHarnessInstallations(harnessNames: ReadonlyArray<PromptRunnerHarnessName | undefined>, questionsOptions: NormalizedQuestionsCliOptions): Promise<void>;
+export declare function $ensureHarnessInstallations(harnessNames: ReadonlyArray<PromptRunnerHarnessName | undefined>, questionsOptions: NormalizedQuestionsCliOptions, options?: {
+    readonly isRequired?: boolean;
+}): Promise<void>;

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

@@ -3,4 +3,4 @@ import type { RunOptions } from '../../../../scripts/run-codex-prompts/cli/RunOp
  * Validates cross-flag constraints before workspace setup or the run starts.
  * @private shared validation for Coder execution commands
  */
-export declare function validateCoderRunOptions(options: RunOptions): void;
+export declare function validateCoderRunOptions(options: Pick<RunOptions, 'checkCommand' | 'checkBefore' | 'allowDestructiveAutoMigrate' | 'autoMigrate' | 'noCommit' | 'waitForUser' | 'gitChanges' | 'autoPull' | 'dryRun' | 'isIsolated' | 'limit'>): void;

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

@@ -1,3 +1,5 @@
+/// <reference types="node" />
+/// <reference types="node" />
 import type { NormalizedQuestionsCliOptions } from './questionsCliOptions';
 /**
  * Resolved project directory and its enclosing working tree. Project artifacts belong to `projectPath`;
@@ -34,3 +36,13 @@ export declare function $preflightWorkspaceRepository(options: {
     readonly projectDirectory?: string;
     readonly policy: WorkspaceRepositoryPolicy;
 } & Partial<NormalizedQuestionsCliOptions>): Promise<WorkspaceRepositoryContext>;
+/**
+ * Executes Git without a shell, optional index locks, or credential prompts, retaining raw output boundaries.
+ * Drains both output streams without execFile's fixed buffer limit so large repository listings remain complete.
+ * @private shared Git discovery and commit-scope inspection
+ */
+export declare function $runWorkspaceGit(projectPath: string, argumentsList: ReadonlyArray<string>, options?: {
+    readonly env?: Record<string, string>;
+    readonly signal?: AbortSignal;
+    readonly input?: string | Buffer;
+}): Promise<string>;

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/google",
-    "version": "0.114.0-49",
+    "version": "0.114.0-50",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -96,7 +96,7 @@
     "types": "./esm/src/_packages/google.index.d.ts",
     "typings": "./esm/src/_packages/google.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.114.0-49"
+        "@promptbook/core": "0.114.0-50"
     },
     "dependencies": {
         "@ai-sdk/google": "2.0.97",

package/umd/index.umd.js

@@ -23,7 +23,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-49';
+    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-50';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name

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

@@ -1,5 +1,6 @@
 import type { Command as Program } from 'commander';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
+import { type ResolvedCoderPromptTemplate } from './boilerplateTemplates';
 /**
  * Initializes `coder add` command for Promptbook CLI utilities
  *
@@ -28,11 +29,13 @@ export type AddCoderPromptResult = {
  *
  * @private internal utility of `coder add` command
  */
-export declare function addCoderPrompt({ projectPath, description, priority, templateOption, }: {
+export declare function addCoderPrompt({ projectPath, description, priority, templateOption, promptTemplate, }: {
     readonly projectPath: string;
     readonly description: string;
     readonly priority: number;
     readonly templateOption?: string;
+    /** Internal authoring workflows may supply their own bounded instructions instead of the feature template. */
+    readonly promptTemplate?: ResolvedCoderPromptTemplate;
 }): Promise<AddCoderPromptResult>;
 /**
  * Prepares a numbered, emoji-tagged prompt for preview without writing the prompt file.
@@ -40,13 +43,15 @@ export declare function addCoderPrompt({ projectPath, description, priority, tem
  *
  * @private internal utility shared by `coder add` and `coder plan`
  */
-export declare function prepareCoderPrompt({ projectPath, description, priority, templateOption, numberOffset, reservedEmojiTag, }: {
+export declare function prepareCoderPrompt({ projectPath, description, priority, templateOption, numberOffset, reservedEmojiTag, promptTemplate: providedPromptTemplate, }: {
     readonly projectPath: string;
     readonly description: string;
     readonly priority: number;
     readonly templateOption?: string;
     readonly numberOffset?: number;
     readonly reservedEmojiTag?: string;
+    /** Shared repair authoring preserves numbering and tags without appending ordinary implementation instructions. */
+    readonly promptTemplate?: ResolvedCoderPromptTemplate;
 }): Promise<AddCoderPromptResult & {
     readonly content: string;
 }>;

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

@@ -0,0 +1,13 @@
+import type { InitializationStatus } from './boilerplateTemplates';
+/**
+ * Project-relative path to the Git attributes initialized by Promptbook Coder.
+ *
+ * @private internal constant of `coder init`
+ */
+export declare const CODER_GITATTRIBUTES_FILE_PATH = ".gitattributes";
+/**
+ * Creates default Git attributes when missing, preserving project-owned attributes.
+ *
+ * @private function of `initializeCoderProjectConfiguration`
+ */
+export declare function ensureCoderGitattributesFile(projectPath: string): Promise<InitializationStatus>;

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

@@ -1,7 +1,7 @@
 import { type PromptRunnerHarnessName } from '../common/promptRunnerCliOptions';
 import type { InitializationStatus } from './boilerplateTemplates';
 /**
- * Ensures `.gitignore` contains Promptbook Coder's local artifacts and every supported harness's local artifacts.
+ * Ensures `.gitignore` covers local dependencies, coder artifacts and every supported harness's local artifacts.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */

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

@@ -0,0 +1,7 @@
+import type { Command as Program } from 'commander';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
+/**
+ * Registers a finite check-repair command with the shared parser, defaults and execution policy.
+ * @private internal CLI command registration
+ */
+export declare function $initializeCoderFixCommand(program: Program): $side_effect;

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

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

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

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

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

@@ -15,6 +15,7 @@ export type CoderInitializationSummary = {
     readonly adamAgentFileDiagnostic?: string;
     readonly envFileStatus: InitializationStatus;
     readonly gitignoreFileStatus: InitializationStatus;
+    readonly gitattributesFileStatus: InitializationStatus;
     readonly packageJsonFileStatus: InitializationStatus;
     readonly vscodeSettingsFileStatus: InitializationStatus;
     readonly addedPackageJsonScriptNames: ReadonlyArray<string>;

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

@@ -11,6 +11,7 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * - find-refactor-candidates: Find files that need refactoring
  * - list: List ready prompts in priority order without running them
  * - run: Run coding prompts with AI agents
+ * - fix: Check and repair the project, then exit without processing the queue
  * - ping: Test one harness and model with a tiny dummy prompt
  * - verify: Verify completed prompts
  * - find-fresh-emoji-tags: Find unused emoji tags

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

@@ -8,7 +8,7 @@ export declare const LEGACY_CODER_CHECK_OPTIONS: readonly [readonly ["--test", "
  * Registers the shared project check command and rejects retired aggregate-test spellings.
  * @private shared CLI registration for Coder execution
  */
-export declare function addCoderCheckOptions(command: Command, isCheckBeforeSupported: boolean): void;
+export declare function addCoderCheckOptions(command: Command, isCheckBeforeSupported: boolean, description?: string): void;
 /**
  * Builds the same actionable migration diagnostic for registered and direct-script entrypoints.
  * @private shared CLI diagnostic for Coder execution

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

@@ -0,0 +1,7 @@
+import type { ProjectInitializationStatus } from './projectInitialization';
+/**
+ * Creates one project text file with default content, preserving any existing file.
+ *
+ * @private internal utility of Promptbook CLI project initialization
+ */
+export declare function ensureProjectTextFile(projectPath: string, relativeFilePath: string, fileContent: string): Promise<ProjectInitializationStatus>;

package/umd/src/cli/cli-commands/common/harness/$ensureHarnessInstallations.d.ts

@@ -11,4 +11,6 @@ import type { NormalizedQuestionsCliOptions } from '../questionsCliOptions';
  *
  * @private internal utility of `promptbookCli`
  */
-export declare function $ensureHarnessInstallations(harnessNames: ReadonlyArray<PromptRunnerHarnessName | undefined>, questionsOptions: NormalizedQuestionsCliOptions): Promise<void>;
+export declare function $ensureHarnessInstallations(harnessNames: ReadonlyArray<PromptRunnerHarnessName | undefined>, questionsOptions: NormalizedQuestionsCliOptions, options?: {
+    readonly isRequired?: boolean;
+}): Promise<void>;

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

@@ -3,4 +3,4 @@ import type { RunOptions } from '../../../../scripts/run-codex-prompts/cli/RunOp
  * Validates cross-flag constraints before workspace setup or the run starts.
  * @private shared validation for Coder execution commands
  */
-export declare function validateCoderRunOptions(options: RunOptions): void;
+export declare function validateCoderRunOptions(options: Pick<RunOptions, 'checkCommand' | 'checkBefore' | 'allowDestructiveAutoMigrate' | 'autoMigrate' | 'noCommit' | 'waitForUser' | 'gitChanges' | 'autoPull' | 'dryRun' | 'isIsolated' | 'limit'>): void;

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

@@ -1,3 +1,5 @@
+/// <reference types="node" />
+/// <reference types="node" />
 import type { NormalizedQuestionsCliOptions } from './questionsCliOptions';
 /**
  * Resolved project directory and its enclosing working tree. Project artifacts belong to `projectPath`;
@@ -34,3 +36,13 @@ export declare function $preflightWorkspaceRepository(options: {
     readonly projectDirectory?: string;
     readonly policy: WorkspaceRepositoryPolicy;
 } & Partial<NormalizedQuestionsCliOptions>): Promise<WorkspaceRepositoryContext>;
+/**
+ * Executes Git without a shell, optional index locks, or credential prompts, retaining raw output boundaries.
+ * Drains both output streams without execFile's fixed buffer limit so large repository listings remain complete.
+ * @private shared Git discovery and commit-scope inspection
+ */
+export declare function $runWorkspaceGit(projectPath: string, argumentsList: ReadonlyArray<string>, options?: {
+    readonly env?: Record<string, string>;
+    readonly signal?: AbortSignal;
+    readonly input?: string | Buffer;
+}): Promise<string>;

package/umd/src/version.d.ts

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