@promptbook/types 0.114.0-41 → 0.114.0-47

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

@@ -0,0 +1,30 @@
+import type { Usage } from '../../../../execution/Usage';
+import type { NormalizedPromptRunnerSelectionCliOptions } from '../../common/promptRunnerCliOptions';
+/**
+ * Parameters for one tool-restricted inference. Repository reads and PRD writes are host operations.
+ * @private internal type of `coder plan`
+ */
+export type PlanningHarnessOptions = NormalizedPromptRunnerSelectionCliOptions & {
+    readonly workspacePath: string;
+    readonly prompt: string;
+    readonly signal: AbortSignal;
+    /** Reports available usage from this inference once, including turns whose final answer is malformed. */
+    readonly onUsage?: (usage: Usage) => void;
+};
+/**
+ * Rejects harnesses without a planning execution policy before any Git sync or process launch.
+ * @private internal utility of `coder plan`
+ */
+export declare function assertPlanningHarnessSupported(harness: string | undefined): void;
+/**
+ * Constructs a fail-closed Codex invocation. User config, rules, project config discovery, native shell,
+ * connectors, hooks and delegation cannot expand the planning tool set. Read-only sandboxing also denies patches.
+ * Older Codex versions that do not support these switches fail instead of using the implementation runner.
+ * @private internal utility of `coder plan`
+ */
+export declare function buildPlanningHarnessArguments(options: PlanningHarnessOptions): string[];
+/**
+ * Runs a bounded inference with no shell interpolation and consumes only its final JSON answer.
+ * @private internal utility of `coder plan`
+ */
+export declare function runPlanningHarness(options: PlanningHarnessOptions): Promise<string>;

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

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

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

@@ -0,0 +1,21 @@
+import type { NormalizedPromptRunnerSelectionCliOptions } from '../../common/promptRunnerCliOptions';
+import { runPlanningHarness } from './runPlanningHarness';
+/**
+ * Terminal interface also used by deterministic conversation fixtures.
+ * @private internal type of `coder plan`
+ */
+export type PlanningSessionIo = {
+    readonly readMessage: () => Promise<string | undefined>;
+    readonly write: (message: string) => void;
+    readonly signal: AbortSignal;
+};
+/**
+ * Runs one multi-topic planning conversation; only explicit save commands cross the PRD write boundary.
+ * @private internal utility of `coder plan`
+ */
+export declare function runPlanningSession(options: NormalizedPromptRunnerSelectionCliOptions & {
+    readonly projectPath: string;
+    readonly agent?: string;
+    readonly template?: string;
+    readonly preexistingChangedPaths?: ReadonlySet<string>;
+}, io: PlanningSessionIo, harness?: typeof runPlanningHarness): Promise<ReadonlyMap<string, string>>;

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

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

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

@@ -0,0 +1,7 @@
+import type { PlanningChange } from './preparePlanningChanges';
+/**
+ * Validates the entire batch before writing, stages outside the queue, then atomically replaces each file.
+ * The synchronous commit region cannot be interrupted by a SIGINT callback halfway through a save.
+ * @private internal execution boundary of `coder plan`
+ */
+export declare function savePlanningChanges(projectPath: string, workspacePath: string, changes: ReadonlyArray<PlanningChange>, isDraft: boolean): string[];

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

@@ -1,7 +1,8 @@
+import type { WorkspaceRepositoryContext } from '../common/workspaceRepository';
 import type { CoderInitializationSummary } from './initializeCoderProjectConfiguration';
 /**
  * Prints a readable summary of what was initialized for the user.
  *
  * @private function of `coder init` command
  */
-export declare function printInitializationSummary(summary: CoderInitializationSummary): void;
+export declare function printInitializationSummary(summary: CoderInitializationSummary, workspace?: WorkspaceRepositoryContext): void;

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

@@ -0,0 +1,13 @@
+/**
+ * Project-relative location of the offline guide, reserved from prompt discovery.
+ *
+ * @private internal constant of `coder init`
+ */
+export declare const PROMPTS_README_FILE_PATH: string;
+/**
+ * Maintained project-independent guide, bundled as text in the published CLI.
+ * Keep examples executable against the parser and command registry in the accompanying tests.
+ *
+ * @private internal template of `coder init`
+ */
+export declare const PROMPTS_README_TEMPLATE: string;

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

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

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

@@ -0,0 +1,8 @@
+import type { string_book } from '../../../book-2.0/agent-source/string_book';
+/**
+ * Reads a project-owned Book before initialization, refusing unsafe edits while preserving its original bytes.
+ * Unknown commitments remain supported, as in the normal Book parser.
+ *
+ * @private internal utility of `coder init`
+ */
+export declare function readCoderAgentBook(filePath: string): Promise<string_book>;

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

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

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

@@ -6,6 +6,7 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * The coder command provides utilities for automated coding:
  * - init: Initialize coder configuration in current project
  * - add: Add one ready-to-run prompt file to the queue
+ * - plan: Discuss features with Planner and author reviewed PRDs
  * - generate-boilerplates: Generate prompt boilerplate files
  * - find-refactor-candidates: Find files that need refactoring
  * - list: List ready prompts in priority order without running them

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

@@ -19,6 +19,8 @@ export type LocalAgentBook = {
 export declare class LocalAgentBookCollection {
     private readonly agentDirectoryPath;
     private readonly currentWorkingDirectory;
+    private readonly isInitializationAllowed;
+    private readonly signal?;
     private readonly booksByUrl;
     private readonly booksByName;
     /** Stable default ancestor selected from the initial repository scan. */
@@ -26,7 +28,7 @@ export declare class LocalAgentBookCollection {
     /** Files initialized by this collection, for the coder's normal commit handling. */
     readonly createdAgentBookPaths: string[];
     /** Creates a collection rooted at the primary book's directory. */
-    constructor(agentDirectoryPath: string, currentWorkingDirectory: string);
+    constructor(agentDirectoryPath: string, currentWorkingDirectory: string, isInitializationAllowed?: boolean, signal?: AbortSignal | undefined);
     /** Discovers nested books, including the hidden `.core` directory. */
     initialize(): Promise<void>;
     /** Identifies the default ancestor without creating an unused book for FROM null/void. */
@@ -38,7 +40,7 @@ export declare class LocalAgentBookCollection {
     /** Reads a local book once, canonicalizing symlinks so aliases cannot bypass cycle detection. */
     readBook(filePath: string): Promise<LocalAgentBook>;
     /** Loads a referenced remote book, while keeping local identifiers entirely inside the collection. */
-    getBook(url: string): Promise<LocalAgentBook>;
+    getBook(url: string, signal?: AbortSignal | undefined): Promise<LocalAgentBook>;
     /** Adds a book under its normalized first-line name and preserves the display name for TEAM. */
     private registerBook;
     /** Walks real directories in deterministic order without following directory symlink loops. */

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

@@ -21,7 +21,7 @@ export declare const CODER_GIT_SYNC_DESCRIPTION: string;
  * 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.
+ *       these commands only mutate Git when the flags are used explicitly. Workspace detection always runs.
  *
  * @private internal utility of `promptbookCli`
  */

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

@@ -6,8 +6,12 @@ import type { string_book } from '../../../book-2.0/agent-source/string_book';
  * @private internal type of CLI agent resolution
  */
 export type ResolvedLocalAgentSource = {
+    /** Canonical identity used to bound recursive TEAM consultations. */
+    readonly agentUrl: string;
     readonly agentSource: string_book;
     readonly agentReferenceResolver: AgentReferenceResolver;
+    /** Resolves another Book in this collection, retaining its own inheritance and reference locations. */
+    readonly resolveAgentSource: (url: string, signal?: AbortSignal) => Promise<ResolvedLocalAgentSource>;
     /** Newly created books which the coder may include in its initialization commit. */
     readonly createdAgentBookPaths: ReadonlyArray<string>;
 };
@@ -16,4 +20,7 @@ export type ResolvedLocalAgentSource = {
  *
  * @private internal utility of CLI agent resolution
  */
-export declare function resolveLocalAgentSource(agentBookPath: string, currentWorkingDirectory: string): Promise<ResolvedLocalAgentSource>;
+export declare function resolveLocalAgentSource(agentBookPath: string, currentWorkingDirectory: string, options?: {
+    readonly isInitializationAllowed?: boolean;
+    readonly signal?: AbortSignal;
+}): Promise<ResolvedLocalAgentSource>;

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

@@ -0,0 +1,6 @@
+import type { RunOptions } from '../../../../scripts/run-codex-prompts/cli/RunOptions';
+/**
+ * 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;

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

@@ -0,0 +1,36 @@
+import type { NormalizedQuestionsCliOptions } from './questionsCliOptions';
+/**
+ * Resolved project directory and its enclosing working tree. Project artifacts belong to `projectPath`;
+ * Git paths and synchronization belong to `repositoryRoot`, which may be an enclosing monorepo.
+ *
+ * @private shared workspace context for Coder and workspace server commands
+ */
+export type WorkspaceRepositoryContext = {
+    readonly projectPath: string;
+    readonly repositoryRoot?: string;
+    readonly gitDirectory?: string;
+    readonly repositoryStatus: 'missing' | 'reused' | 'initialized';
+};
+/**
+ * Command policy is separate from discovery: previews never initialize; explicit init needs no confirmation.
+ *
+ * @private shared workspace policy for Coder and workspace server commands
+ */
+export type WorkspaceRepositoryPolicy = 'initialize' | 'mutate' | 'read-only';
+/**
+ * Resolves the requested project once and discovers Git using Git itself, without requiring `HEAD`.
+ * Broken metadata, bare repositories, ownership errors and unavailable Git are failures, not missing repositories.
+ *
+ * @private shared workspace discovery for CLI commands
+ */
+export declare function $resolveWorkspaceRepository(projectDirectory?: string): Promise<WorkspaceRepositoryContext>;
+/**
+ * Checks the shared prerequisite before any project writes, Git synchronization, installation or startup.
+ * Only an affirmative interactive answer or an explicit initializer authorizes `git init`.
+ *
+ * @private shared workspace preflight for Coder and workspace server commands
+ */
+export declare function $preflightWorkspaceRepository(options: {
+    readonly projectDirectory?: string;
+    readonly policy: WorkspaceRepositoryPolicy;
+} & Partial<NormalizedQuestionsCliOptions>): Promise<WorkspaceRepositoryContext>;

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

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

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

@@ -0,0 +1,11 @@
+import type { Command } from 'commander';
+/**
+ * Shared explanation of the workspace prerequisite, independent of commit and synchronization settings.
+ * @private internal CLI help text
+ */
+export declare const WORKSPACE_REPOSITORY_DESCRIPTION: string;
+/**
+ * Adds shared Git help and the questions switch to every workspace command without duplicating existing options.
+ * @private internal registration helper for workspace CLI commands
+ */
+export declare function addWorkspaceRepositoryOptions(command: Command): void;

package/umd/src/commitments/TEAM/TEAM.test.d.ts

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

package/umd/src/conversion/archive/loadJsZipModule.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Loads the ZIP archive library (`jszip`) on demand
+ *
+ * Note: [🐌] Loaded lazily to keep the startup of the `ptbk` CLI utility fast
+ *
+ * @private internal utility of `loadArchive` and `saveArchive`
+ */
+export declare const loadJsZipModule: () => Promise<{
+    default: typeof import('jszip');
+}>;

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