@yaag/cli 0.8.1 → 0.8.3

package/assets/types/runtime/cassette/index.d.ts

@@ -12,4 +12,4 @@ export { replayMismatch } from "./replay-divergence.ts";
 export { replayTransport } from "./replay-transport.ts";
 export { programIdentityWarning } from "./resume-identity.ts";
 export { resumeTransport } from "./resume-transport.ts";
-export { type ProgramIdentity, publishRunCheckpoint, type RunCheckpointResult, resolveRunIdentity, writeRecordingDiagnostic, } from "./run-checkpoint.ts";
+export { type ProgramIdentity, prepareRecordDestination, publishRunCheckpoint, type RunCheckpointResult, resolveRunIdentity, writeRecordingDiagnostic, } from "./run-checkpoint.ts";

package/assets/types/runtime/cassette/run-checkpoint.d.ts

@@ -22,7 +22,8 @@ export interface RunCheckpointOptions {
  * What one publication attempt did. `published` covers both a written artifact
  * and a Run that keeps none. `displaced` carries the error that must become the
  * Run's outcome. `lost` reports a Checkpoint the Run asked for and did not get,
- * while a primary program error keeps the outcome.
+ * while the Run keeps its own outcome — a completed result, or a primary
+ * program error (ADR-0021 amendment).
  */
 export type RunCheckpointResult = {
     readonly kind: "published";
@@ -40,10 +41,21 @@ export type RunCheckpointResult = {
  */
 export declare function publishRunCheckpoint(options: RunCheckpointOptions): Promise<RunCheckpointResult>;
 /**
- * Creates the checkpoint directory a Run owns. An explicit `--record` path keeps
- * today's rule that its directory must already exist.
+ * Creates the directory the Run's artifact goes into. A `--record` path names
+ * where the artifact goes, so yaag creates the chain that path implies rather
+ * than refusing. ADR-0021 makes `--record` fix the destination path only, and a
+ * path yaag can make is a destination yaag makes. The checkpoint directory yaag owns stays
+ * private; a user-named `--record` directory takes the process umask, because it
+ * lives in the user's own tree.
  */
 export declare function ensureCheckpointDirectory(record: string | undefined, destination: string): Promise<void>;
+/**
+ * Makes the directory chain of the `--record` path at Run start, and rejects the
+ * Run before the first spawn when that chain cannot exist. It does not prove the
+ * destination writable: an existing directory that refuses a write, or a name
+ * already taken, still fails later, at publication.
+ */
+export declare function prepareRecordDestination(record: string): Promise<void>;
 /** Which program a Run executes: a file on disk, or inline source text (ADR-0033). */
 export interface ProgramIdentity {
     readonly programFile?: string;

package/assets/types/runtime/errors.d.ts

@@ -30,7 +30,7 @@ export interface ModelResolutionOutcome {
     readonly modelErrors: readonly ModelError[];
 }
 /** Why an Ask, spawn, or Run failed. Programs may branch on this; most won't. */
-export type YaagErrorCode = "AGENT_FAILED" | "AGENT_DIED" | "AGENT_BUSY" | "ASK_TIMEOUT" | "ASK_LIMIT" | "ASK_STALLED" | "ASK_INVALID_OUTPUT" | "ARGS_INVALID" | "CONFIG_INVALID" | "OPTIONS_CONFLICT" | "REPLAY_DIVERGED" | "RESUME_REFUSED" | "RUN_CLOSED" | "RUN_STOPPED" | "WORKTREE_REFUSED" | "MODEL_RESOLUTION_FAILED" | "SPAWN_FAILED";
+export type YaagErrorCode = "AGENT_FAILED" | "AGENT_DIED" | "AGENT_BUSY" | "ASK_TIMEOUT" | "ASK_LIMIT" | "ASK_STALLED" | "ASK_INVALID_OUTPUT" | "ARGS_INVALID" | "CONFIG_INVALID" | "OPTIONS_CONFLICT" | "RECORD_PATH_UNUSABLE" | "REPLAY_DIVERGED" | "RESUME_REFUSED" | "RUN_CLOSED" | "RUN_STOPPED" | "WORKTREE_REFUSED" | "MODEL_RESOLUTION_FAILED" | "SPAWN_FAILED";
 /** The single error class of the runtime (ADR-0003). */
 export declare class YaagError extends Error {
     readonly code: YaagErrorCode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaag/cli",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "publishConfig": {
     "access": "public"
   },
@@ -21,8 +21,8 @@
   },
   "dependencies": {
     "@earendil-works/pi-tui": "^0.84.0",
-    "@yaag/runtime": "0.8.1",
-    "@yaag/tui": "0.8.1",
+    "@yaag/runtime": "0.8.3",
+    "@yaag/tui": "0.8.3",
     "typebox": "1.3.7"
   }
 }