@promptbook/cli 0.112.0-43 → 0.112.0-44

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

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

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

@@ -1,6 +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.
+ * Creates a temporary script file, runs it, waits for a completion marker and idle time, and defers cleanup when a round tracker is provided.
  * 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

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

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

@@ -0,0 +1,35 @@
+/**
+ * Kind of temporary artifact created during one coder prompt round.
+ */
+export type PromptRoundArtifactKind = 'runner-script' | 'test-script' | 'runtime-log';
+/**
+ * Final outcome of one coder prompt round.
+ */
+export type PromptRoundOutcome = 'success' | 'failure';
+/**
+ * Tracks temporary prompt-round artifacts and deletes only those not preserved for the final round outcome.
+ */
+export declare class PromptRoundArtifacts {
+    private readonly preservedArtifactKindsByOutcome;
+    private readonly trackedArtifacts;
+    /**
+     * Creates a new prompt-round artifact tracker.
+     */
+    constructor(preservedArtifactKindsByOutcome: Record<PromptRoundOutcome, ReadonlySet<PromptRoundArtifactKind>>);
+    /**
+     * Registers one temporary artifact for round-final cleanup.
+     */
+    track(path: string, kind: PromptRoundArtifactKind): void;
+    /**
+     * Cleans up all tracked artifacts that should not survive the final round outcome.
+     */
+    cleanup(outcome: PromptRoundOutcome): Promise<void>;
+}
+/**
+ * Creates the default artifact-retention policy used by `ptbk coder run`.
+ */
+export declare function createCoderRunPromptRoundArtifacts(isPreserveLogs: boolean): PromptRoundArtifacts;
+/**
+ * Derives the tracked artifact kind from one temporary shell path.
+ */
+export declare function getPromptRoundArtifactKindFromScriptPath(scriptPath: string): PromptRoundArtifactKind;

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

@@ -0,0 +1,4 @@
+/**
+ * Builds the temporary live runtime log path for one prompt script and its sibling test script.
+ */
+export declare function buildScriptLogPath(scriptPath: string): string;

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

@@ -0,0 +1,5 @@
+import type { RunGoScriptOptions } from './RunGoScriptOptions';
+/**
+ * Runs one temporary bash script, optionally mirroring its raw input/output into a live runtime log file.
+ */
+export declare function runBashScriptWithOutput(options: RunGoScriptOptions): Promise<string>;

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

@@ -0,0 +1,28 @@
+/**
+ * Environment variable read by the shell wrapper to tee live output into the temporary runtime log file.
+ */
+export declare const PTBK_CODER_LOG_FILE_ENV_NAME = "PTBK_CODER_LOG_FILE";
+/**
+ * Shapes one bash invocation that optionally mirrors live script output into a temporary log file.
+ */
+export declare function buildLoggedBashExecution(scriptPath: string, logPath?: string): {
+    args: string[];
+    env?: Record<string, string>;
+};
+/**
+ * Appends one execution-start section with the raw script input before the shell begins producing output.
+ */
+export declare function appendScriptExecutionLogStart({ scriptPath, scriptContent, logPath, }: {
+    scriptPath: string;
+    scriptContent: string;
+    logPath?: string;
+}): Promise<void>;
+/**
+ * Appends one execution-finish section after the shell settles.
+ */
+export declare function appendScriptExecutionLogFinish({ scriptPath, logPath, status, details, }: {
+    scriptPath: string;
+    logPath?: string;
+    status: string;
+    details?: unknown;
+}): Promise<void>;

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

@@ -0,0 +1,5 @@
+import type { PromptRoundArtifacts } from './PromptRoundArtifacts';
+/**
+ * Runs one prompt-processing round with a dedicated temporary runtime log file and optionally defers cleanup to the round tracker.
+ */
+export declare function withPromptRuntimeLog<T>(scriptPath: string, handler: (logPath: string) => Promise<T>, promptRoundArtifacts?: PromptRoundArtifacts): Promise<T>;

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

@@ -1,5 +1,5 @@
 import type { RunGoScriptOptions } from './RunGoScriptOptions';
 /**
- * Creates a temporary script file, runs a handler, and ensures cleanup.
+ * Creates a temporary script file, runs a handler, and either cleans it up immediately or defers cleanup to the round tracker.
  */
 export declare function withTempScript<T>(options: RunGoScriptOptions, handler: (scriptPath: string) => Promise<T>): Promise<T>;

package/esm/scripts/run-codex-prompts/testing/runPromptTestCommand.d.ts

@@ -5,6 +5,7 @@ type RunPromptTestCommandOptions = {
     command: string;
     projectPath: string;
     scriptPath: string;
+    logPath?: string;
 };
 /**
  * Runs the configured verification command inside the project root and returns its output.

package/esm/src/book-2.0/agent-source/AgentBasicInformation.d.ts

@@ -66,7 +66,8 @@ export type AgentBasicInformation = {
     permanentId?: string_agent_permanent_id;
     /**
      * Optional description of the agent
-     * This is the line starting with "PERSONA"
+     * This is derived from the last `GOAL` / `GOALS` commitment,
+     * falling back to deprecated `PERSONA` / `PERSONAE` for backward compatibility.
      */
     personaDescription: string | null;
     /**

package/esm/src/book-2.0/agent-source/TeammateProfileResolver.d.ts

@@ -9,7 +9,8 @@ export type TeammateProfile = {
      */
     readonly agentName: string;
     /**
-     * Short description of what the agent does, from its PERSONA commitment.
+     * Short profile text for what the agent does, from the last GOAL commitment
+     * or deprecated PERSONA fallback.
      */
     readonly personaDescription: string | null;
 };

package/esm/src/commitments/PERSONA/PERSONA.d.ts

@@ -29,6 +29,13 @@ export declare class PersonaCommitmentDefinition extends BaseCommitmentDefinitio
      * Short one-line description of PERSONA.
      */
     get description(): string;
+    /**
+     * Optional UI/docs-only deprecation metadata.
+     */
+    get deprecation(): {
+        readonly message: "Use `GOAL` for agent profile text and inheritance-safe rewrites.";
+        readonly replacedBy: readonly ["GOAL"];
+    };
     /**
      * Icon for this commitment.
      */

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.112.0-42`).
+ * It follows semantic versioning (e.g., `0.112.0-43`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.112.0-43",
+    "version": "0.112.0-44",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,