@jevitate/cli 0.1.0 → 0.2.0

package/dist/demo-aspect-api.d.ts

@@ -0,0 +1,209 @@
+import { type AnnotationChange, type AnnotationDraft, type Journey } from "@jevitate/journey";
+import type { Assertion } from "@jevitate/recording";
+import type { GenerationPort, JudgmentPort } from "@jevitate/ai-core";
+import type { Bounds, SafetyConfig } from "@jevitate/explore";
+import type { BrowserPort, EmulationSpec } from "@jevitate/playwright";
+import type { SiteGateDeps } from "@jevitate/runtime";
+import { type AuthorViaBrowserArgs } from "./explore-author.js";
+import type { AuthorJourneyResult } from "@jevitate/explore";
+import type { CaptureLayer } from "./demo-capture.js";
+import type { BrowserRunOptions } from "./browser-run-options.js";
+import type { ResolvedJourneyEnvironment } from "./environments.js";
+import type { MissionFixtures } from "./mission-fixtures.js";
+/**
+ * #249 — `jevitate demo "<aspect>"`: one request → a reviewed, narrated demo of one aspect of an app.
+ *
+ *  1. Explore and author: goal-directed exploration (`runAuthorJourney`, the `explore-author-journey`
+ *     path) writes a Journey for the aspect, gated by an INDEPENDENT success check (`--success`) —
+ *     Jev drives, code adjudicates. Paid/destructive controls are refused unless the target's
+ *     targets.json `safety` allows them; writes are allowed (there is a success check).
+ *  2. Clean path: the explored path is minimized to its essential steps with the regression-capture
+ *     ddmin (`minimizeRecording`): a step (a detour, a dead end, a repeated attempt) is dropped only
+ *     when the Journey still REPLAYS to its success check without it. The success check is always
+ *     the Journey's last step, so a candidate can never "succeed" by dropping the proof. The
+ *     explored path must replay before minimizing, and the minimized one is replayed once more.
+ *  3. Annotate (#246): a replay drafts each step's objective and expected result (sidecar draft).
+ *  4. Draft demo (#248): video + .vtt + guide narrated with the DRAFT annotations, every output
+ *     marked DRAFT (a watermark on the overlay, in the subtitles and in the guide).
+ *
+ * Everything runs in a scratch store first: the Journey, its annotation draft and the demo record
+ * land in the journeys dir only when every stage succeeded, and the Journey is NEVER promoted here.
+ * `approveDemo` is the one human gate: it re-renders the final (non-DRAFT) demo with the reviewed
+ * annotations and only then applies them and promotes the Journey — an ordinary Journey thereafter.
+ *
+ * Safety: only a named environment, never one flagged `production: true` (refused before anything
+ * runs); every replay has `journey run`'s fail-closed policy; every output is redacted and proven
+ * secret-free by the stages it reuses.
+ */
+/** The demo's inputs were unusable: nothing ran. */
+export declare class DemoAspectArgsError extends Error {
+    readonly code = "E_DEMO_ARGS";
+}
+/** `demo` against an environment flagged `production: true`: refused before anything runs. */
+export declare class DemoProductionEnvironmentError extends Error {
+    readonly code = "E_DEMO_PRODUCTION_ENV";
+}
+/** The Journey id (or its demo draft) already exists: refused, nothing overwritten. */
+export declare class DemoExistsError extends Error {
+    readonly code = "E_DEMO_EXISTS";
+}
+/** `demo approve <id>` for an id with no demo draft. */
+export declare class DemoDraftNotFoundError extends Error {
+    readonly code = "E_DEMO_NOT_FOUND";
+}
+/** The demo draft record is unreadable or not a demo draft. */
+export declare class InvalidDemoDraftError extends Error {
+    readonly code = "E_INVALID_DEMO_DRAFT";
+}
+/** How many minimization replays (beyond the two verification replays) a demo may spend. */
+export declare const DEMO_MINIMIZE_MAX_REPLAYS = 40;
+/** Refuses a missing environment, and one flagged `production: true` (#249). */
+export declare function assertDemoEnvironment(environment: ResolvedJourneyEnvironment | undefined): asserts environment is ResolvedJourneyEnvironment;
+/** `demo-<slug of the aspect>`: a safe Journey id. */
+export declare function demoJourneyId(aspect: string): string;
+/** `<journeys>/.drafts/<id>.demo.json` — beside the Journey's annotation draft (a dot-folder: never listed as a Journey). */
+export declare function demoDraftPath(journeysDir: string, id: string): string;
+/** The demo draft record: what `demo approve` needs besides the Journey and its annotation draft. Never a secret. */
+export interface DemoDraft {
+    readonly kind: "jevitate.demo.draft";
+    readonly version: 1;
+    readonly id: string;
+    readonly aspect: string;
+    /** The environment the demo was made on (approve re-renders there, re-checking it is not production). */
+    readonly env: string;
+    readonly persona?: string;
+    /** The Journey's content hash when drafted (its annotation draft is bound to the same). */
+    readonly journeyHash: string;
+    readonly createdAtIso: string;
+    /** The DRAFT outputs. */
+    readonly draft: {
+        readonly video?: string;
+        readonly subtitles?: string;
+        readonly guide?: string;
+    };
+}
+/** Reads and validates a demo draft record (missing / invalid are typed refusals). */
+export declare function readDemoDraft(journeysDir: string, id: string): Promise<{
+    record: DemoDraft;
+    path: string;
+}>;
+/** The replay-side options every stage shares (as `journey run` takes them). */
+export interface DemoReplayOptions {
+    readonly environment: ResolvedJourneyEnvironment;
+    readonly storageState?: string;
+    readonly browserPortFactory?: () => BrowserPort;
+    /** How Chromium is launched and shown (`--headed` presents the demo; exploration and replays stay headless). */
+    readonly browser?: BrowserRunOptions;
+    readonly emulation?: EmulationSpec;
+    readonly siteGate?: SiteGateDeps;
+    readonly fixtures?: (site: string) => MissionFixtures | undefined;
+    /** Caption time per step (ms). */
+    readonly paceMs?: number;
+    /** Extra screenshot layers (pixel masking, #250/#251). */
+    readonly captureLayers?: readonly CaptureLayer[];
+}
+export interface DemoAspectOptions extends DemoReplayOptions {
+    /** The aspect to demo, in words: the exploration's goal and the Journey's name. */
+    readonly aspect: string;
+    /** The independent success check that proves the aspect was shown (`--success`). */
+    readonly successAssertion: Assertion;
+    /** Its spec as given, for the Journey's success criterion text. */
+    readonly successSpec: string;
+    readonly journeysDir: string;
+    /** Default {@link demoJourneyId}. */
+    readonly id?: string;
+    /** The path exploration starts from on the environment (default `/`). */
+    readonly start?: string;
+    readonly persona?: string;
+    readonly judge: JudgmentPort;
+    readonly gen: GenerationPort;
+    readonly bounds?: Partial<Bounds>;
+    /** The target's targets.json `safety` (paid/destructive allowed only when configured there). */
+    readonly safety?: SafetyConfig;
+    /** Where the draft video/subtitles/guide go (a folder). */
+    readonly outDir: string;
+    /** Default {@link DEMO_MINIMIZE_MAX_REPLAYS}. */
+    readonly maxReplays?: number;
+    readonly now?: () => string;
+    /** Test seam: the authoring step (default: a real browser). */
+    readonly authorImpl?: (args: AuthorViaBrowserArgs) => Promise<AuthorJourneyResult>;
+}
+export interface DemoMinimizeReport {
+    readonly exploredSteps: number;
+    readonly keptSteps: number;
+    /** What was dropped (value-free step descriptions), in explored order. */
+    readonly dropped: string[];
+    /** Replays spent minimizing (the two verification replays not counted). */
+    readonly replays: number;
+    /** The replay budget ran out: the path is verified but may not be minimal. */
+    readonly budgetExhausted: boolean;
+}
+export interface DemoAspectResult {
+    readonly id: string;
+    readonly aspect: string;
+    readonly environment: string;
+    /**
+     * `drafted`: the Journey (unpromoted), its annotation draft and the DRAFT demo are written.
+     * `not-reached`: exploration did not meet the success check. `not-replayable`: the explored or
+     * minimized path did not replay to it. `stale`: the draft demo's replay stopped. Only `drafted` writes.
+     */
+    readonly outcome: "drafted" | "not-reached" | "not-replayable" | "stale";
+    readonly reason?: string;
+    readonly minimize?: DemoMinimizeReport;
+    /** The Journey's steps as the demo narrates them (with the drafted annotations). */
+    readonly steps?: Array<{
+        number: number;
+        step: string;
+        objective?: string;
+        expectedResult?: string;
+    }>;
+    readonly annotations?: {
+        readonly draftPath: string;
+        readonly proposed: AnnotationChange[];
+    };
+    readonly draft?: {
+        readonly video?: string;
+        readonly subtitles?: string;
+        readonly guide?: string;
+    };
+    readonly demoDraftPath?: string;
+    /** The approval command (only for `drafted`). */
+    readonly next?: string;
+}
+/** Runs the #249 pipeline (see the module comment). Refusals throw before anything runs. */
+export declare function demoAspect(opts: DemoAspectOptions): Promise<DemoAspectResult>;
+export interface ApproveDemoOptions extends DemoReplayOptions {
+    readonly journeysDir: string;
+    readonly id: string;
+    /** Where the final video/subtitles/guide go (a folder). */
+    readonly outDir: string;
+}
+export interface ApproveDemoResult {
+    readonly id: string;
+    /** `approved`: promoted, annotated, final demo rendered. `stale`: the final render's replay stopped — nothing promoted. */
+    readonly outcome: "approved" | "stale";
+    readonly reason?: string;
+    readonly environment: string;
+    /** The Journey as approved (steps with their annotations). */
+    readonly steps: NonNullable<DemoAspectResult["steps"]>;
+    /** What approving wrote into the Journey. */
+    readonly changes: AnnotationChange[];
+    readonly promoted: boolean;
+    readonly final?: {
+        readonly video?: string;
+        readonly subtitles?: string;
+        readonly guide?: string;
+    };
+}
+/** Reads what `demo approve <id>` would approve (the Journey, its draft annotations, the record) — refusals are typed. */
+export declare function loadDemoForApproval(journeysDir: string, id: string): Promise<{
+    record: DemoDraft;
+    journey: Journey;
+    annotations: AnnotationDraft;
+}>;
+/**
+ * The one human approval (#249): renders the FINAL demo (no DRAFT marks) with the reviewed
+ * annotations; only when it replays does it apply the annotations, promote the Journey and remove
+ * the demo record. A stale replay promotes nothing (outcome `stale`).
+ */
+export declare function approveDemo(opts: ApproveDemoOptions): Promise<ApproveDemoResult>;

package/dist/demo-aspect-api.js

@@ -0,0 +1,397 @@
+import { existsSync } from "node:fs";
+import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { FsJourneyStore, applyAnnotationDraft, deriveParamSchema, describeStep, flatJourneySteps, } from "@jevitate/journey";
+import { assertNoSecretInPayload } from "@jevitate/ai-core";
+import { minimizeRecording } from "@jevitate/regression";
+import { runAuthorJourney } from "./explore-author.js";
+import { promoteJourney, runJourneyProgrammatically, UnknownJourneyError } from "./journey-api.js";
+import { annotateJourney, annotationDraftPath, approveJourneyAnnotations, journeyContentHash, readAnnotationDraft, StaleAnnotationDraftError, } from "./journey-annotate-api.js";
+import { demoJourney } from "./journey-demo-api.js";
+/**
+ * #249 — `jevitate demo "<aspect>"`: one request → a reviewed, narrated demo of one aspect of an app.
+ *
+ *  1. Explore and author: goal-directed exploration (`runAuthorJourney`, the `explore-author-journey`
+ *     path) writes a Journey for the aspect, gated by an INDEPENDENT success check (`--success`) —
+ *     Jev drives, code adjudicates. Paid/destructive controls are refused unless the target's
+ *     targets.json `safety` allows them; writes are allowed (there is a success check).
+ *  2. Clean path: the explored path is minimized to its essential steps with the regression-capture
+ *     ddmin (`minimizeRecording`): a step (a detour, a dead end, a repeated attempt) is dropped only
+ *     when the Journey still REPLAYS to its success check without it. The success check is always
+ *     the Journey's last step, so a candidate can never "succeed" by dropping the proof. The
+ *     explored path must replay before minimizing, and the minimized one is replayed once more.
+ *  3. Annotate (#246): a replay drafts each step's objective and expected result (sidecar draft).
+ *  4. Draft demo (#248): video + .vtt + guide narrated with the DRAFT annotations, every output
+ *     marked DRAFT (a watermark on the overlay, in the subtitles and in the guide).
+ *
+ * Everything runs in a scratch store first: the Journey, its annotation draft and the demo record
+ * land in the journeys dir only when every stage succeeded, and the Journey is NEVER promoted here.
+ * `approveDemo` is the one human gate: it re-renders the final (non-DRAFT) demo with the reviewed
+ * annotations and only then applies them and promotes the Journey — an ordinary Journey thereafter.
+ *
+ * Safety: only a named environment, never one flagged `production: true` (refused before anything
+ * runs); every replay has `journey run`'s fail-closed policy; every output is redacted and proven
+ * secret-free by the stages it reuses.
+ */
+/** The demo's inputs were unusable: nothing ran. */
+export class DemoAspectArgsError extends Error {
+    code = "E_DEMO_ARGS";
+}
+/** `demo` against an environment flagged `production: true`: refused before anything runs. */
+export class DemoProductionEnvironmentError extends Error {
+    code = "E_DEMO_PRODUCTION_ENV";
+}
+/** The Journey id (or its demo draft) already exists: refused, nothing overwritten. */
+export class DemoExistsError extends Error {
+    code = "E_DEMO_EXISTS";
+}
+/** `demo approve <id>` for an id with no demo draft. */
+export class DemoDraftNotFoundError extends Error {
+    code = "E_DEMO_NOT_FOUND";
+}
+/** The demo draft record is unreadable or not a demo draft. */
+export class InvalidDemoDraftError extends Error {
+    code = "E_INVALID_DEMO_DRAFT";
+}
+/** How many minimization replays (beyond the two verification replays) a demo may spend. */
+export const DEMO_MINIMIZE_MAX_REPLAYS = 40;
+/** Refuses a missing environment, and one flagged `production: true` (#249). */
+export function assertDemoEnvironment(environment) {
+    if (environment === undefined || environment.name === undefined) {
+        throw new DemoAspectArgsError("demo runs only against a named environment: pass --env <name> (from .jevitate/environments.json)");
+    }
+    if (environment.production === true) {
+        throw new DemoProductionEnvironmentError(`environment '${environment.name}' is flagged production: true — demo explores and writes, so it runs only against a non-production environment`);
+    }
+}
+/** `demo-<slug of the aspect>`: a safe Journey id. */
+export function demoJourneyId(aspect) {
+    const slug = aspect
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 48)
+        .replace(/-+$/g, "");
+    return `demo-${slug === "" ? "aspect" : slug}`;
+}
+const DEMO_ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$/;
+/** `<journeys>/.drafts/<id>.demo.json` — beside the Journey's annotation draft (a dot-folder: never listed as a Journey). */
+export function demoDraftPath(journeysDir, id) {
+    return join(journeysDir, ".drafts", `${id}.demo.json`);
+}
+/** Why `v` is not a {@link DemoDraft}, or null when it is. */
+function demoDraftProblem(v) {
+    if (v === null || typeof v !== "object" || Array.isArray(v))
+        return "not an object";
+    const o = v;
+    if (o.kind !== "jevitate.demo.draft")
+        return "kind: expected jevitate.demo.draft";
+    if (o.version !== 1)
+        return "version: expected 1";
+    for (const k of ["id", "aspect", "env", "journeyHash", "createdAtIso"])
+        if (typeof o[k] !== "string" || o[k] === "")
+            return `${k}: expected a string`;
+    if (o.persona !== undefined && typeof o.persona !== "string")
+        return "persona: expected a string";
+    const d = o.draft;
+    if (d === null || typeof d !== "object" || Array.isArray(d))
+        return "draft: expected an object";
+    for (const [k, x] of Object.entries(d)) {
+        if (!["video", "subtitles", "guide"].includes(k))
+            return `draft.${k}: unknown key`;
+        if (typeof x !== "string")
+            return `draft.${k}: expected a path`;
+    }
+    return null;
+}
+/** Reads and validates a demo draft record (missing / invalid are typed refusals). */
+export async function readDemoDraft(journeysDir, id) {
+    const path = demoDraftPath(journeysDir, id);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            throw new DemoDraftNotFoundError(`no demo draft '${id}' (${path}) — make one with \`jevitate demo "<aspect>" --env <name>\``);
+        throw err;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new InvalidDemoDraftError(`${path} is not JSON`);
+    }
+    const problem = demoDraftProblem(parsed);
+    if (problem !== null)
+        throw new InvalidDemoDraftError(`${path} is not a demo draft: ${problem}`);
+    const record = parsed;
+    if (record.id !== id)
+        throw new InvalidDemoDraftError(`${path} is the demo draft for '${record.id}', not '${id}'`);
+    return { record, path };
+}
+/** The replay-only browser: never headed, never recorded (minimizing opens many sessions). */
+function quietBrowser(browser) {
+    if (browser === undefined)
+        return undefined;
+    const { headed: _h, recordVideo: _v, overlay: _o, slowMo: _s, ...launch } = browser;
+    return launch;
+}
+function sameAssertion(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+/** The explored Recording without its final success `assert` (authorJourney always appends it). */
+function withoutSuccessAssert(recording, check) {
+    const pages = recording.pages.map((p) => ({ ...p, steps: [...p.steps] }));
+    const last = pages[pages.length - 1];
+    const tail = last?.steps[last.steps.length - 1]?.step;
+    if (last !== undefined && tail?.kind === "assert" && sameAssertion(tail.check, check)) {
+        last.steps.pop();
+        if (last.steps.length === 0)
+            pages.pop();
+    }
+    return { ...recording, pages };
+}
+/** `recording` + the success check as its last step — the proof every candidate must replay to. */
+function withSuccessAssert(recording, check) {
+    const pages = recording.pages.map((p) => ({ ...p, steps: [...p.steps] }));
+    const last = pages[pages.length - 1];
+    if (last === undefined)
+        return { ...recording, pages: [{ url: "/", steps: [{ step: { kind: "assert", check } }] }] };
+    last.steps.push({ step: { kind: "assert", check } });
+    return { ...recording, pages };
+}
+function stepsOf(journey) {
+    return flatJourneySteps(journey).map((s) => ({
+        number: s.index + 1,
+        step: describeStep(s.recorded.step),
+        ...(s.recorded.objective === undefined ? {} : { objective: s.recorded.objective }),
+        ...(s.recorded.expectedResult === undefined ? {} : { expectedResult: s.recorded.expectedResult }),
+    }));
+}
+function replayOpts(opts) {
+    const b = quietBrowser(opts.browser);
+    return {
+        environment: opts.environment,
+        ...(opts.storageState === undefined ? {} : { storageState: opts.storageState }),
+        ...(opts.browserPortFactory === undefined ? {} : { browserPortFactory: opts.browserPortFactory }),
+        ...(b === undefined ? {} : { browser: b }),
+        ...(opts.emulation === undefined ? {} : { emulation: opts.emulation }),
+        ...(opts.siteGate === undefined ? {} : { siteGate: opts.siteGate }),
+        ...(opts.fixtures === undefined ? {} : { fixtures: opts.fixtures }),
+    };
+}
+/** Runs the #249 pipeline (see the module comment). Refusals throw before anything runs. */
+export async function demoAspect(opts) {
+    assertDemoEnvironment(opts.environment);
+    const env = opts.environment;
+    const aspect = opts.aspect.replace(/\s+/g, " ").trim();
+    if (aspect === "")
+        throw new DemoAspectArgsError("the aspect to demo is empty");
+    const id = opts.id ?? demoJourneyId(aspect);
+    if (!DEMO_ID.test(id))
+        throw new DemoAspectArgsError(`--id must be letters, digits, '.', '_' or '-' (starting with a letter or digit): ${JSON.stringify(id)}`);
+    const start = opts.start ?? "/";
+    if (!start.startsWith("/"))
+        throw new DemoAspectArgsError(`--start must be an app path starting with '/': ${JSON.stringify(start)}`);
+    const store = new FsJourneyStore(opts.journeysDir);
+    if ((await store.get(id)) !== null)
+        throw new DemoExistsError(`journey '${id}' already exists — pick another --id (nothing was changed)`);
+    const recordPath = demoDraftPath(opts.journeysDir, id);
+    if (existsSync(recordPath)) {
+        throw new DemoExistsError(`a demo draft '${id}' is waiting for approval (${recordPath}) — approve it with \`jevitate demo approve ${id}\`, or pick another --id`);
+    }
+    const maxReplays = opts.maxReplays ?? DEMO_MINIMIZE_MAX_REPLAYS;
+    const now = opts.now ?? (() => new Date().toISOString());
+    const base = { id, aspect, environment: env.name ?? env.baseUrl };
+    const work = await mkdtemp(join(tmpdir(), "jevitate-demo-aspect-"));
+    try {
+        // 1. Explore and author (never promoted), into a scratch store.
+        const authored = await runAuthorJourney({
+            url: new URL(start, env.baseUrl).toString(),
+            goal: aspect,
+            successAssertion: opts.successAssertion,
+            allowlist: env.allowedOrigins,
+            journeysDir: join(work, "explored"),
+            journeyId: id,
+            journeyName: aspect,
+            takes: 1,
+            judge: opts.judge,
+            gen: opts.gen,
+            ...(opts.bounds === undefined ? {} : { bounds: opts.bounds }),
+            ...(opts.safety === undefined ? {} : { safety: opts.safety }),
+            ...(opts.browserPortFactory === undefined ? {} : { browserPortFactory: opts.browserPortFactory }),
+            ...(quietBrowser(opts.browser) === undefined ? {} : { browser: quietBrowser(opts.browser) }),
+            ...(opts.storageState === undefined ? {} : { storageState: opts.storageState }),
+            ...(opts.authorImpl === undefined ? {} : { authorImpl: opts.authorImpl }),
+        });
+        if (authored.outcome !== "authored")
+            return { ...base, outcome: "not-reached", reason: authored.reason };
+        const metadata = {
+            ...authored.journey.metadata,
+            promoted: false,
+            goal: aspect,
+            ...(opts.persona === undefined ? {} : { persona: opts.persona }),
+            successCriteria: [{ description: `The success check holds: ${opts.successSpec}`, check: opts.successAssertion }],
+        };
+        // 2. Clean path: every candidate replays in its own scratch store, ending on the success check.
+        const scratch = new FsJourneyStore(join(work, "candidates"));
+        const replayOk = async (recording) => {
+            await scratch.put({ metadata, recording: withSuccessAssert(recording, opts.successAssertion) });
+            const run = await runJourneyProgrammatically({ dir: join(work, "candidates"), id, params: {}, ...replayOpts(opts) });
+            return run.outcome === "ok";
+        };
+        const explored = withoutSuccessAssert(authored.journey.recording, opts.successAssertion);
+        if (!(await replayOk(explored))) {
+            return { ...base, outcome: "not-replayable", reason: "the explored path did not replay to its success check — nothing was written" };
+        }
+        let replays = 0;
+        let budgetExhausted = false;
+        const minimized = await minimizeRecording(explored, async (candidate) => {
+            if (replays >= maxReplays) {
+                budgetExhausted = true;
+                return false;
+            }
+            replays += 1;
+            return replayOk(candidate);
+        });
+        if (!(await replayOk(minimized))) {
+            return { ...base, outcome: "not-replayable", reason: "the minimized path did not replay to its success check — nothing was written" };
+        }
+        const kept = new Set(minimized.pages.flatMap((p) => p.steps));
+        const exploredFlat = explored.pages.flatMap((p) => p.steps);
+        const minimize = {
+            exploredSteps: exploredFlat.length + 1,
+            keptSteps: kept.size + 1,
+            dropped: exploredFlat.filter((s) => !kept.has(s)).map((s) => describeStep(s.step)),
+            replays,
+            budgetExhausted,
+        };
+        const recording = withSuccessAssert(minimized, opts.successAssertion);
+        const journey = { metadata: { ...metadata, params: deriveParamSchema(recording).required, createdAtIso: now() }, recording };
+        // 3. Annotate (#246) and 4. draft the demo (#248) — both against a scratch store holding only this Journey.
+        const stageDir = join(work, "stage");
+        await new FsJourneyStore(stageDir).put(journey);
+        const annotated = await annotateJourney({ dir: stageDir, id, params: {}, gen: opts.gen, now, ...replayOpts(opts) });
+        if (annotated.replay.outcome !== "completed") {
+            return { ...base, outcome: "stale", minimize, reason: `the annotation replay stopped: ${annotated.replay.reason ?? "unknown"} — nothing was written` };
+        }
+        const { draft: annotations } = await readAnnotationDraft(stageDir, id);
+        const demo = await renderDemo(stageDir, id, opts, annotations, true, opts.outDir);
+        if (demo.outcome !== "ok") {
+            return { ...base, outcome: "stale", minimize, reason: `the draft demo's replay stopped${demo.stoppedAtStep === undefined ? "" : ` at step ${demo.stoppedAtStep}`}: ${demo.reason ?? "unknown"} — nothing was written` };
+        }
+        // Every stage succeeded: the Journey (unpromoted), its annotation draft and the demo record land.
+        await store.put(journey);
+        const draftPath = annotationDraftPath(opts.journeysDir, id);
+        await mkdir(dirname(draftPath), { recursive: true, mode: 0o700 });
+        await writeFile(draftPath, `${JSON.stringify(annotations, null, 2)}\n`, { mode: 0o600 });
+        const record = {
+            kind: "jevitate.demo.draft",
+            version: 1,
+            id,
+            aspect,
+            env: base.environment,
+            ...(opts.persona === undefined ? {} : { persona: opts.persona }),
+            journeyHash: annotations.journeyHash,
+            createdAtIso: now(),
+            draft: outputsOf(demo),
+        };
+        assertNoSecretInPayload(record, [], "demo draft record");
+        await writeFile(recordPath, `${JSON.stringify(record, null, 2)}\n`, { mode: 0o600 });
+        return {
+            ...base,
+            outcome: "drafted",
+            minimize,
+            steps: stepsOf(applyAnnotationDraft(journey, annotations).journey),
+            annotations: { draftPath, proposed: annotated.proposed },
+            draft: record.draft,
+            demoDraftPath: recordPath,
+            next: `jevitate demo approve ${id}`,
+        };
+    }
+    finally {
+        await rm(work, { recursive: true, force: true });
+    }
+}
+function outputsOf(demo) {
+    return {
+        ...(demo.video === undefined ? {} : { video: demo.video }),
+        ...(demo.subtitles === undefined ? {} : { subtitles: demo.subtitles }),
+        ...(demo.guide === undefined ? {} : { guide: demo.guide }),
+    };
+}
+/** One demo render (#248) of `id` in `dir`, narrated with `annotations`, into `outDir`. */
+function renderDemo(dir, id, opts, annotations, draft, outDir) {
+    return demoJourney({
+        dir,
+        id,
+        params: {},
+        video: join(outDir, "demo.webm"),
+        guide: join(outDir, "guide.md"),
+        annotations,
+        draft,
+        environment: opts.environment,
+        ...(opts.storageState === undefined ? {} : { storageState: opts.storageState }),
+        ...(opts.browserPortFactory === undefined ? {} : { browserPortFactory: opts.browserPortFactory }),
+        ...(opts.browser === undefined ? {} : { browser: opts.browser }),
+        ...(opts.emulation === undefined ? {} : { emulation: opts.emulation }),
+        ...(opts.siteGate === undefined ? {} : { siteGate: opts.siteGate }),
+        ...(opts.fixtures === undefined ? {} : { fixtures: opts.fixtures }),
+        ...(opts.paceMs === undefined ? {} : { paceMs: opts.paceMs }),
+        ...(opts.captureLayers === undefined ? {} : { captureLayers: opts.captureLayers }),
+    });
+}
+/** Reads what `demo approve <id>` would approve (the Journey, its draft annotations, the record) — refusals are typed. */
+export async function loadDemoForApproval(journeysDir, id) {
+    if (!DEMO_ID.test(id))
+        throw new DemoAspectArgsError(`not a demo id: ${JSON.stringify(id)}`);
+    const { record } = await readDemoDraft(journeysDir, id);
+    const journey = await new FsJourneyStore(journeysDir).get(id);
+    if (journey === null)
+        throw new UnknownJourneyError(`unknown journey '${id}' (its demo draft is at ${demoDraftPath(journeysDir, id)})`);
+    const { draft: annotations, draftPath } = await readAnnotationDraft(journeysDir, id);
+    if (journeyContentHash(journey) !== annotations.journeyHash) {
+        throw new StaleAnnotationDraftError(`journey '${id}' changed after its demo was drafted (${draftPath}) — make the demo again`);
+    }
+    return { record, journey, annotations };
+}
+/**
+ * The one human approval (#249): renders the FINAL demo (no DRAFT marks) with the reviewed
+ * annotations; only when it replays does it apply the annotations, promote the Journey and remove
+ * the demo record. A stale replay promotes nothing (outcome `stale`).
+ */
+export async function approveDemo(opts) {
+    assertDemoEnvironment(opts.environment);
+    const { journey, annotations } = await loadDemoForApproval(opts.journeysDir, opts.id);
+    const environment = opts.environment.name ?? opts.environment.baseUrl;
+    const annotated = applyAnnotationDraft(journey, annotations);
+    const steps = stepsOf(annotated.journey);
+    const demo = await renderDemo(opts.journeysDir, opts.id, opts, annotations, false, opts.outDir);
+    if (demo.outcome !== "ok") {
+        return {
+            id: opts.id,
+            outcome: "stale",
+            reason: `the final demo's replay stopped${demo.stoppedAtStep === undefined ? "" : ` at step ${demo.stoppedAtStep}`}: ${demo.reason ?? "unknown"} — nothing was promoted`,
+            environment,
+            steps,
+            changes: [],
+            promoted: false,
+        };
+    }
+    const applied = await approveJourneyAnnotations(opts.journeysDir, opts.id);
+    await promoteJourney(opts.journeysDir, opts.id);
+    await rm(demoDraftPath(opts.journeysDir, opts.id), { force: true });
+    return {
+        id: opts.id,
+        outcome: "approved",
+        environment,
+        steps,
+        changes: applied.changes,
+        promoted: true,
+        final: outputsOf(demo),
+    };
+}
+//# sourceMappingURL=demo-aspect-api.js.map

package/dist/demo-aspect-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-aspect-api.js","sourceRoot":"","sources":["../src/demo-aspect-api.ts"],"names":[],"mappings":"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"}

package/dist/demo-aspect-cli.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import { type CliDeps } from "./cli-shared.js";
+export declare function registerDemoCommands(program: Command, deps: CliDeps): void;