@promptbook/cli 0.111.0-7 → 0.112.0-12

package/esm/scripts/find-fresh-emoji-tag/find-fresh-emoji-tag.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Finds fresh emoji tags that are not yet used in the codebase.
+ *
+ * @public exported from `@promptbook/cli`
+ */
+export declare function findFreshEmojiTag(): Promise<void>;
+/**
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/scripts/find-fresh-emoji-tag/utils/$shuffleItems.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shuffles an array of items randomly and returns a new array
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic
+ * Note: This function does NOT mutate the original array
+ * Warning: This function is NOT cryptographically secure (it uses Math.random internally)
+ *
+ * @param items - An array of items to be shuffled.
+ * @returns A new array containing the shuffled items.
+ * @throws No exceptions are thrown by this function.
+ */
+export declare function $shuffleItems<TItem>(...items: ReadonlyArray<TItem>): ReadonlyArray<TItem>;
+/**
+ * TODO: [🧠][👵] Figure out something between rotateItems and shuffleItems which is more generic and receives a ruleset how to reordeto the array in some general way
+ */

package/esm/scripts/find-fresh-emoji-tag/utils/emojis.d.ts

@@ -0,0 +1,21 @@
+import type { string_char_emoji } from '../../../src/types/typeAliasEmoji';
+/**
+ * All possible emoji chars like "🍆", "🍡", "🍤"...
+ * Note: this will be needed to update annually - now updated at 2022-01-19
+ *
+ * @see https://getemoji.com/
+ */
+export declare const EMOJIS_IN_CATEGORIES: Record<string, ReadonlyArray<string_char_emoji>>;
+/**
+ * All possible emoji chars like "🍆", "🍡", "🍤", "🇨🇼", "🧑🏿‍❤️‍💋‍🧑🏻"...
+ */
+export declare const EMOJIS: Set<string_char_emoji>;
+/**
+ * Emojis which are single pictograms like "🍆", "🍡", "🍤"...
+ */
+export declare const EMOJIS_OF_SINGLE_PICTOGRAM: Set<string_char_emoji>;
+/**
+ * TODO: [💴] DRY - just one version of emojis.ts
+ * TODO: Mirror from Collboard or some common package
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/scripts/find-refactor-candidates/find-refactor-candidates.constants.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Root folders that contain source-like files for scanning.
+ */
+export declare const SOURCE_ROOTS: ReadonlyArray<string>;
+/**
+ * File extensions treated as source code.
+ */
+export declare const SOURCE_FILE_EXTENSIONS: ReadonlyArray<string>;
+/**
+ * Glob patterns that should be ignored when scanning for source files.
+ */
+export declare const SOURCE_FILE_IGNORE_GLOBS: ReadonlyArray<string>;
+/**
+ * Default maximum line count for source files.
+ */
+export declare const DEFAULT_MAX_LINE_COUNT = 2000;
+/**
+ * Per-extension line count limits.
+ */
+export declare const LINE_COUNT_LIMITS_BY_EXTENSION: Readonly<Record<string, number>>;
+/**
+ * Glob patterns that are exempt from line-count checks.
+ */
+export declare const LINE_COUNT_EXEMPT_GLOBS: ReadonlyArray<string>;
+/**
+ * Maximum number of entities before a file is flagged.
+ */
+export declare const MAX_ENTITIES_PER_FILE = 20;
+/**
+ * File extensions eligible for entity counting.
+ */
+export declare const ENTITY_COUNT_EXTENSIONS: ReadonlyArray<string>;
+/**
+ * Markers that identify generated files which should be skipped.
+ */
+export declare const GENERATED_CODE_MARKERS: ReadonlyArray<string>;
+/**
+ * Name of the prompts directory.
+ */
+export declare const PROMPTS_DIR_NAME = "prompts";
+/**
+ * Step size used for prompt numbering.
+ */
+export declare const PROMPT_NUMBER_STEP = 10;
+/**
+ * Prefix used for generated prompt slugs.
+ */
+export declare const PROMPT_SLUG_PREFIX = "refactor";
+/**
+ * Label used to mark the target file in generated prompts.
+ */
+export declare const PROMPT_TARGET_LABEL = "Target file";
+/**
+ * Maximum length for generated prompt slugs.
+ */
+export declare const PROMPT_SLUG_MAX_LENGTH = 80;
+/**
+ * Note: [?] Code in this file should never be published in any package
+ */

package/esm/scripts/find-refactor-candidates/find-refactor-candidates.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Orchestrates scanning for refactor candidates and generating prompts.
+ *
+ * @public exported from `@promptbook/cli`
+ */
+export declare function findRefactorCandidates(): Promise<void>;
+/**
+ * Note: [?] Code in this file should never be published in any package
+ */

package/esm/scripts/run-codex-prompts/cli/parseRunOptions.d.ts

@@ -0,0 +1,5 @@
+import type { RunOptions } from './RunOptions';
+/**
+ * Parses CLI arguments into runner options.
+ */
+export declare function parseRunOptions(args: string[]): RunOptions;

package/esm/scripts/run-codex-prompts/common/ProgressiveBackoff.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Default progressive delays used for rate-limit retries:
+ * 1 minute, 2 minutes, 5 minutes, 10 minutes, and 30 minutes.
+ */
+export declare const DEFAULT_PROGRESSIVE_BACKOFF_DELAYS_MS: readonly number[];
+/**
+ * Options for one progressive backoff counter.
+ */
+export type ProgressiveBackoffOptions = {
+    delaysMs?: readonly number[];
+    maxDelayMs?: number;
+    jitterRatio?: number;
+    random?: () => number;
+};
+/**
+ * Stateful progressive backoff counter with optional jitter and capped maximum delay.
+ */
+export declare class ProgressiveBackoff {
+    private readonly delaysMs;
+    private readonly maxDelayMs;
+    private readonly jitterRatio;
+    private readonly random;
+    private failuresSinceSuccess;
+    /**
+     * Creates one progressive backoff counter.
+     */
+    constructor(options?: ProgressiveBackoffOptions);
+    /**
+     * Number of consecutive failures since the last successful reset.
+     */
+    get retryCount(): number;
+    /**
+     * Returns the next delay and advances the backoff counter by one failed attempt.
+     */
+    nextDelayMs(): number;
+    /**
+     * Resets backoff state after one successful call.
+     */
+    reset(): void;
+    /**
+     * Resolves the non-jittered delay for the given retry index.
+     */
+    private resolveBaseDelayMs;
+}

package/esm/scripts/run-codex-prompts/common/cliProgressDisplay.d.ts

@@ -0,0 +1,41 @@
+import moment from 'moment';
+import type { PromptStats } from '../prompts/types/PromptStats';
+/**
+ * Compact CLI progress display that stays pinned at the top of the terminal.
+ */
+export declare class CliProgressDisplay {
+    private readonly startTime;
+    private stats;
+    /**
+     * Initial number of completed prompts when the session started.
+     * Used to calculate session progress.
+     */
+    private initialDone;
+    private readonly isInteractive;
+    private isHeaderReserved;
+    private interval;
+    /**
+     * Creates a new display that uses the provided start time when computing estimates.
+     */
+    constructor(startTime: moment.Moment);
+    /**
+     * Updates the progress statistics shown in the header.
+     */
+    update(stats: PromptStats): void;
+    /**
+     * Stops the automatic refresh cycle and renders the final header once more.
+     */
+    stop(): void;
+    /**
+     * Repaint the header without disturbing the current cursor position.
+     */
+    private render;
+    /**
+     * Reserves a terminal line so subsequent output stays below the sticky header.
+     */
+    private reserveHeaderLine;
+    /**
+     * Builds the coloured progress text padded to the terminal width.
+     */
+    private buildProgressLine;
+}

package/esm/scripts/run-codex-prompts/common/createCodingContext.d.ts

@@ -0,0 +1,5 @@
+import { string_prompt } from '../../../src/types/typeAliases';
+/**
+ * [✨] Builds the common coding context appended to runner prompts.
+ */
+export declare function createCodingContext(): string_prompt;

package/esm/scripts/run-codex-prompts/common/formatCommitMessageForDisplay.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Formats commit message lines for console display.
+ */
+export declare function formatCommitMessageForDisplay(message: string): string;

package/esm/scripts/run-codex-prompts/common/formatUsagePrice.d.ts

@@ -0,0 +1,10 @@
+import type { Usage } from '../../../src/execution/Usage';
+/**
+ * Formats usage price for display in checkbox.
+ * Examples:
+ *   - "$0.12" (certain)
+ *   - "~$3.05" (uncertain)
+ *   - "$0.00" (zero cost)
+ *   - "<$0.01" (tiny non-zero cost)
+ */
+export declare function formatUsagePrice(usage: Usage): string;

package/esm/scripts/run-codex-prompts/common/normalizeLineEndingsInChangedFiles.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Snapshot of file hashes for files that were already dirty before a coding round started.
+ */
+export type ChangedFilesSnapshot = {
+    readonly changedFileHashes: ReadonlyMap<string, string>;
+};
+/**
+ * Options for normalizing line endings in files changed during one coding round.
+ */
+export type NormalizeLineEndingsInChangedFilesOptions = {
+    readonly projectPath: string;
+    readonly snapshot: ChangedFilesSnapshot;
+};
+/**
+ * Summary of one line-ending normalization pass.
+ */
+export type NormalizeLineEndingsInChangedFilesResult = {
+    readonly scannedFiles: number;
+    readonly normalizedFiles: number;
+    readonly skippedBinaryFiles: number;
+};
+/**
+ * Captures hashes for files that are dirty before a coding round starts.
+ */
+export declare function captureChangedFilesSnapshot(projectPath: string): Promise<ChangedFilesSnapshot>;
+/**
+ * Normalizes CRLF to LF only in files that changed since the captured snapshot.
+ */
+export declare function normalizeLineEndingsInFilesChangedSinceSnapshot(options: NormalizeLineEndingsInChangedFilesOptions): Promise<NormalizeLineEndingsInChangedFilesResult>;

package/esm/scripts/run-codex-prompts/common/printCommitMessage.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Prints the formatted commit message preview.
+ */
+export declare function printCommitMessage(message: string): void;

package/esm/scripts/run-codex-prompts/common/runGoScript/$runGoScript.d.ts

@@ -0,0 +1,5 @@
+import type { RunGoScriptOptions } from './RunGoScriptOptions';
+/**
+ * Creates a temporary script file, runs it, and then deletes it.
+ */
+export declare function $runGoScript(options: RunGoScriptOptions): Promise<void>;

package/esm/scripts/run-codex-prompts/common/runGoScript/$runGoScriptUntilMarkerIdle.d.ts

@@ -0,0 +1,6 @@
+import type { RunGoScriptUntilMarkerIdleOptions } from './RunGoScriptUntilMarkerIdleOptions';
+/**
+ * Creates a temporary script file, runs it, waits for a completion marker and idle time, and then deletes it.
+ * Returns the captured output for post-processing.
+ */
+export declare function $runGoScriptUntilMarkerIdle(options: RunGoScriptUntilMarkerIdleOptions): Promise<string>;

package/esm/scripts/run-codex-prompts/common/runGoScript/$runGoScriptWithOutput.d.ts

@@ -0,0 +1,5 @@
+import type { RunGoScriptOptions } from './RunGoScriptOptions';
+/**
+ * Creates a temporary script file, runs it, captures output, and then deletes it.
+ */
+export declare function $runGoScriptWithOutput(options: RunGoScriptOptions): Promise<string>;

package/esm/scripts/run-codex-prompts/common/runGoScript/runScriptUntilMarkerIdle.d.ts

@@ -0,0 +1,6 @@
+import type { RunScriptUntilMarkerIdleOptions } from './RunScriptUntilMarkerIdleOptions';
+/**
+ * Runs a script until a completion marker is observed and output is idle for a set timeout.
+ * Returns the captured output.
+ */
+export declare function runScriptUntilMarkerIdle(options: RunScriptUntilMarkerIdleOptions): Promise<string>;

package/esm/scripts/run-codex-prompts/common/runGoScript/toPosixPath.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Converts a file path to POSIX format.
+ */
+export declare function toPosixPath(filePath: string): string;

package/esm/scripts/run-codex-prompts/common/runGoScript/withTempScript.d.ts

@@ -0,0 +1,5 @@
+import type { RunGoScriptOptions } from './RunGoScriptOptions';
+/**
+ * Creates a temporary script file, runs a handler, and ensures cleanup.
+ */
+export declare function withTempScript<T>(options: RunGoScriptOptions, handler: (scriptPath: string) => Promise<T>): Promise<T>;

package/esm/scripts/run-codex-prompts/common/waitForEnter.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Waits for the user to press Enter before continuing.
+ */
+export declare function waitForEnter(prompt: string): Promise<void>;

package/esm/scripts/run-codex-prompts/common/waitForPause.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Listens for the "p" key to pause and resume.
+ */
+export declare function listenForPause(): void;
+/**
+ * If the execution is paused, it will wait until it is resumed.
+ */
+export declare function checkPause(): Promise<void>;

package/esm/scripts/run-codex-prompts/git/agentGitIdentity.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Git identity details that must drive commits created by the coding agent.
+ */
+export type AgentGitIdentity = {
+    readonly name: string;
+    readonly email: string;
+    readonly signingKey: string;
+};
+/**
+ * Reads the required agent identity values from the environment and remembers them for the lifetime of the script.
+ */
+export declare function getAgentGitIdentity(): AgentGitIdentity;
+/**
+ * Builds the environment overrides that ensure git commits use the agent identity instead of the primary user.
+ */
+export declare function buildAgentGitEnv(identity?: AgentGitIdentity): Record<string, string>;
+/**
+ * Produces the git commit flag that enforces signing with the configured agent key.
+ */
+export declare function buildAgentGitSigningFlag(identity?: AgentGitIdentity): string;

package/esm/scripts/run-codex-prompts/git/commitChanges.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Commits staged changes with the provided message using the configured agent identity and signing key.
+ */
+export declare function commitChanges(message: string): Promise<void>;

package/esm/scripts/run-codex-prompts/git/ensureWorkingTreeClean.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Ensures the git working tree is clean before running the prompt.
+ */
+export declare function ensureWorkingTreeClean(): Promise<void>;

package/esm/scripts/run-codex-prompts/main/runCodexPrompts.d.ts

@@ -0,0 +1,8 @@
+import type { RunOptions } from '../cli/RunOptions';
+/**
+ * Main entry point for running prompts with the selected agent.
+ *
+ * @param providedOptions - Optional pre-parsed options. If not provided, will parse from process.argv
+ * @public exported from `@promptbook/cli`
+ */
+export declare function runCodexPrompts(providedOptions?: RunOptions): Promise<void>;

package/esm/scripts/run-codex-prompts/migrations/detectDestructiveSqlStatements.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Heuristic rule names used to classify potentially destructive SQL statements.
+ */
+export declare const DESTRUCTIVE_SQL_RULE: {
+    readonly DROP_TABLE: "DROP_TABLE";
+    readonly DROP_COLUMN: "DROP_COLUMN";
+    readonly TRUNCATE: "TRUNCATE";
+    readonly DELETE_WITHOUT_WHERE: "DELETE_WITHOUT_WHERE";
+};
+/**
+ * One heuristic rule key identifying a destructive SQL pattern.
+ */
+export type DestructiveSqlRule = (typeof DESTRUCTIVE_SQL_RULE)[keyof typeof DESTRUCTIVE_SQL_RULE];
+/**
+ * One destructive SQL match detected in a migration statement.
+ */
+export type DestructiveSqlStatementMatch = {
+    /**
+     * Matched destructive SQL rule key.
+     */
+    readonly rule: DestructiveSqlRule;
+    /**
+     * SQL statement that matched the heuristic rule.
+     */
+    readonly statement: string;
+};
+/**
+ * Detects potentially destructive SQL statements using regex-based heuristics.
+ *
+ * This is intentionally conservative and can produce false positives.
+ *
+ * @param sql SQL migration file content.
+ * @returns List of destructive statement matches.
+ */
+export declare function detectDestructiveSqlStatements(sql: string): Array<DestructiveSqlStatementMatch>;

package/esm/scripts/run-codex-prompts/migrations/runAutoMigrateTestingServers.d.ts

@@ -0,0 +1,22 @@
+import { type DatabaseMigrationLogger } from '../../../apps/agents-server/src/database/runDatabaseMigrations';
+/**
+ * Options controlling testing-server auto-migration after one completed coding prompt.
+ */
+export type RunAutoMigrateTestingServersOptions = {
+    /**
+     * When true, runs migration even if destructive migration heuristics detect risky SQL.
+     */
+    readonly allowDestructiveAutoMigrate: boolean;
+    /**
+     * Logger used for migration progress output.
+     */
+    readonly logger?: DatabaseMigrationLogger;
+};
+/**
+ * Runs testing-server migration flow with destructive-SQL guardrail.
+ *
+ * Calls are serialized in-process and also rely on shared DB advisory lock in migration runner.
+ *
+ * @param options Auto-migration options.
+ */
+export declare function runAutoMigrateTestingServers(options: RunAutoMigrateTestingServersOptions): Promise<void>;

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Builds the prompt text sent to the agent runner.
+ */
+export declare function buildCodexPrompt(file: PromptFile, section: PromptSection): string;

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Builds the commit message from the prompt content.
+ */
+export declare function buildCommitMessage(file: PromptFile, section: PromptSection): string;

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Builds a display label using the prompt line number for easier navigation.
+ */
+export declare function buildPromptLabelForDisplay(file: PromptFile, section: PromptSection): string;

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Extracts prompt lines without the status marker.
+ */
+export declare function buildPromptLinesWithoutStatus(file: PromptFile, section: PromptSection): string[];

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Extracts a short summary line from a prompt section.
+ */
+export declare function buildPromptSummary(file: PromptFile, section: PromptSection): string;

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Builds the script path for a prompt section.
+ */
+export declare function buildScriptPath(file: PromptFile, section: PromptSection): string;

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSelection } from './types/PromptSelection';
+/**
+ * Selects the next runnable prompt based on priority.
+ */
+export declare function findNextTodoPrompt(files: PromptFile[], minimumPriority?: number): PromptSelection | undefined;

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

@@ -0,0 +1,4 @@
+/**
+ * Formats runner details for prompt status lines.
+ */
+export declare function formatRunnerSignature(runnerName: string | undefined, modelName: string | undefined): string;

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

@@ -0,0 +1,8 @@
+import type { UpcomingTask } from './types/UpcomingTask';
+/**
+ * Groups upcoming tasks by priority, high to low.
+ */
+export declare function groupUpcomingTasksByPriority(tasks: UpcomingTask[]): Array<{
+    priority: number;
+    tasks: UpcomingTask[];
+}>;

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

@@ -0,0 +1,5 @@
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Checks whether a prompt section meets the minimum priority threshold.
+ */
+export declare function hasSufficientPriority(section: PromptSection, minimumPriority: number): boolean;

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Checks whether a prompt section still needs authoring (contains "@@@").
+ */
+export declare function isPromptToBeWritten(file: PromptFile, section: PromptSection): boolean;

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSelection } from './types/PromptSelection';
+/**
+ * Lists todo prompts that still contain authoring placeholders.
+ */
+export declare function listPromptsToBeWritten(files: PromptFile[], minimumPriority?: number): PromptSelection[];

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSelection } from './types/PromptSelection';
+/**
+ * Lists todo prompts that are ready to run (no authoring placeholders).
+ */
+export declare function listRunnablePrompts(files: PromptFile[], minimumPriority?: number): PromptSelection[];

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSelection } from './types/PromptSelection';
+/**
+ * Lists todo prompts across all files.
+ */
+export declare function listTodoPrompts(files: PromptFile[]): PromptSelection[];

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { UpcomingTask } from './types/UpcomingTask';
+/**
+ * Lists upcoming tasks that are ready to run (no authoring placeholders).
+ */
+export declare function listUpcomingTasks(files: PromptFile[], minimumPriority?: number): UpcomingTask[];

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

@@ -0,0 +1,5 @@
+import type { PromptFile } from './types/PromptFile';
+/**
+ * Loads and parses prompt files from the prompts directory.
+ */
+export declare function loadPromptFiles(promptsDir: string): Promise<PromptFile[]>;

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

@@ -0,0 +1,8 @@
+import moment from 'moment';
+import type { Usage } from '../../../src/execution/Usage';
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Marks a prompt section as done and records usage pricing and runner details.
+ */
+export declare function markPromptDone(file: PromptFile, section: PromptSection, usage: Usage, runnerName: string | undefined, modelName: string | undefined, promptExecutionStartedDate: moment.Moment): void;

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

@@ -0,0 +1,7 @@
+import moment from 'moment';
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Marks a prompt section as failed and records runner details.
+ */
+export declare function markPromptFailed(file: PromptFile, section: PromptSection, runnerName: string | undefined, modelName: string | undefined, promptExecutionStartedDate: moment.Moment): void;

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

@@ -0,0 +1,5 @@
+import type { PromptFile } from './types/PromptFile';
+/**
+ * Parses a prompt markdown file into sections and metadata.
+ */
+export declare function parsePromptFile(filePath: string, content: string): PromptFile;

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Prints a summary of the prompt that will run next.
+ */
+export declare function printPromptStartSummary(file: PromptFile, section: PromptSection): void;

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

@@ -0,0 +1,5 @@
+import type { PromptFile } from './types/PromptFile';
+/**
+ * Prints the list of prompts that still need to be written.
+ */
+export declare function printPromptsToBeWritten(files: PromptFile[], minimumPriority?: number): void;

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

@@ -0,0 +1,5 @@
+import type { PromptStats } from './types/PromptStats';
+/**
+ * Prints the summary stats line.
+ */
+export declare function printStats(stats: PromptStats, minimumPriority?: number): void;

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

@@ -0,0 +1,5 @@
+import type { UpcomingTask } from './types/UpcomingTask';
+/**
+ * Prints upcoming tasks grouped by priority.
+ */
+export declare function printUpcomingTasks(tasks: UpcomingTask[]): void;

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

@@ -0,0 +1,6 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptStats } from './types/PromptStats';
+/**
+ * Summarizes prompt stats for the runner output.
+ */
+export declare function summarizePrompts(files: PromptFile[], minimumPriority?: number): PromptStats;

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

@@ -0,0 +1,4 @@
+/**
+ * Trims leading and trailing empty lines.
+ */
+export declare function trimEmptyEdges(lines: string[]): string[];