@promptbook/documents 0.114.0-49 → 0.114.0-50

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/documents",
-    "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/documents.index.d.ts",
     "typings": "./esm/src/_packages/documents.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.114.0-49"
+        "@promptbook/core": "0.114.0-50"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -26,7 +26,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
@@ -1553,8 +1553,9 @@
                         resolve(spacetrim.spaceTrim(output.join('\n')));
                     }
                 };
+                // `exit` can arrive before the stdout/stderr pipes finish. Git metadata and hook diagnostics
+                // must be complete before a following repository inspection uses the command's result.
                 commandProcess.on('close', finishWithCode);
-                commandProcess.on('exit', finishWithCode);
                 commandProcess.on('disconnect', () => {
                     // Note: Unexpected disconnection should always result in rejection
                     reject(new Error(`Command "${humanReadableCommand}" disconnected`));