@jevitate/cli 0.1.0 → 0.2.0

package/dist/journey-cli.js

@@ -0,0 +1,370 @@
+import { existsSync } from "node:fs";
+import { FsJourneyStore, JourneyRegistry, ParamValidationError } from "@jevitate/journey";
+import { MissingCredentialError } from "@jevitate/ai-core";
+import { safeRunPolicy } from "@jevitate/domain";
+import { makeExploreSelfHealer } from "./self-heal-adapter.js";
+import { ok, fail } from "./envelope.js";
+import { SiteGateRefusedError } from "@jevitate/runtime";
+import { runJourneyProgrammatically, promoteJourney, UnknownJourneyError, JourneyRequiresAuthError } from "./journey-api.js";
+import { parseScreenshotsArg } from "./run-screenshots.js";
+import { withSiteGate } from "./site-gate-cli.js";
+import { registerJourneyAnnotateCommand } from "./journey-annotate-cli.js";
+import { registerJourneyDemoCommand } from "./journey-demo-cli.js";
+import { journeyIntentCoverage } from "./journey-annotate-api.js";
+import { buildMissionFixtures, checkSetupRefs, withFixtureFlags } from "./fixture-cli.js";
+import { FixtureSetupError, FixtureSpecError, UnboundSetupRefError } from "./mission-fixtures.js";
+import { withEngine } from "./engine.js";
+import { publishJourneyToSource, realGhPort, NotPromotedError, NoDeclaredOriginsError } from "./source-api.js";
+import { UnknownSourceError, EmbeddedSecretError, UndeclaredOriginError } from "@jevitate/sources";
+import { environmentFromFlags, isEnvironmentError, withEnvironmentFlags } from "./environments.js";
+import { resolveDbPath, resolveJourneysDir, resolveSourceApiDeps, withBrowserLaunchFlags, browserRunFromFlags, withDemoFlags, withScreenshotsFlag, withEmulationFlags, emulationFromFlags, collectParam, emitJson, environmentSeams, writeRawResult, GatewaySelectionError, buildExploreGateways, } from "./cli-shared.js";
+/** Registers `jevitate journey`: `list|find|run|promote|annotate|demo|publish`. */
+export function registerJourneyCommands(program, deps) {
+    const journey = program.command("journey").description("manage and run promoted Journeys (regression-test replays)");
+    /**
+     * `journey list` = ALL journeys' metadata via the store directly
+     * (promoted AND unpromoted) — a local/dev-facing listing of everything on
+     * disk. `journey find` (below) = promoted-only, via `JourneyRegistry.find`
+     * — the same promoted-only projection external callers (e.g. the
+     * mcp-facade) see. Keeping these distinct means `list` is useful for
+     * authoring/debugging while `find` genuinely reflects what's discoverable.
+     */
+    journey
+        .command("list")
+        .option("--dir <path>", "journeys directory (default: the repo's .jevitate/journeys; outside a repo ~/.jevitate/journeys)")
+        .option("--json", "emit a JSON envelope")
+        .action(async function () {
+        const { dir, json } = this.opts();
+        try {
+            const store = new FsJourneyStore(resolveJourneysDir(deps, dir));
+            const metas = await store.list();
+            const envelope = ok(metas);
+            if (json) {
+                emitJson(program, envelope);
+            }
+            else {
+                const out = program.configureOutput().writeOut;
+                if (metas.length === 0) {
+                    out?.("no journeys yet — record one with `jevitate record` (see jevitate record --help)\n");
+                }
+                else {
+                    for (const m of metas) {
+                        out?.(`${m.id}\t${m.name}${m.promoted ? "" : " (unpromoted)"}\n`);
+                    }
+                }
+                process.exitCode = 0;
+            }
+        }
+        catch (err) {
+            emitJson(program, fail("E_JOURNEY_LIST", String(err)));
+        }
+    });
+    // RULING 5: uses `JourneyRegistry.find` (from `@jevitate/journey`) directly —
+    // NEVER `@jevitate/mcp-facade`'s `findCapabilities` — Slice 1 forbids the CLI
+    // depending on `@jevitate/mcp-facade`. `JourneyRegistry.find` is already
+    // promoted-only, so this is the same promoted-only view without the
+    // forbidden dependency.
+    journey
+        .command("find <query>")
+        .option("--dir <path>", "journeys directory (default: the repo's .jevitate/journeys; outside a repo ~/.jevitate/journeys)")
+        .option("--json", "emit a JSON envelope")
+        .action(async function (query) {
+        const { dir, json } = this.opts();
+        try {
+            const store = new FsJourneyStore(resolveJourneysDir(deps, dir));
+            const registry = new JourneyRegistry(store);
+            const metas = await registry.find(query);
+            const capabilities = metas.map((m) => ({
+                id: m.id,
+                name: m.name,
+                description: m.description,
+                params: m.params,
+            }));
+            const envelope = ok(capabilities);
+            if (json) {
+                emitJson(program, envelope);
+            }
+            else {
+                const out = program.configureOutput().writeOut;
+                for (const c of capabilities) {
+                    out?.(`${c.id}\t${c.name}\tparams=[${c.params.join(", ")}]\n`);
+                }
+                process.exitCode = 0;
+            }
+        }
+        catch (err) {
+            emitJson(program, fail("E_JOURNEY_FIND", String(err)));
+        }
+    });
+    withScreenshotsFlag(withEnvironmentFlags(withDemoFlags(withBrowserLaunchFlags(withEmulationFlags(withFixtureFlags(journey.command("run <id>")))), { recordVideo: true })))
+        .option("--dir <path>", "journeys directory (default: the repo's .jevitate/journeys; outside a repo ~/.jevitate/journeys)")
+        .option("--param <kv>", "param as key=value (repeatable)", collectParam, {})
+        .option("--storage-state <file>", "Playwright storageState JSON to start the session authenticated (#118: required when the journey declares metadata.requiresAuth); must exist")
+        // Ticket #7 (additive): opt a run into scoped self-healing. Default
+        // `fail-closed` preserves Slice 1 behavior exactly (no healer wired). A
+        // write/irreversible step NEVER auto-heals in any mode (enforced by the
+        // runtime's write floor). `hybrid`/`full` need an AI gateway, selected
+        // with --real/--fake-ai (mirrors `explore`); requesting a heal mode
+        // without one fails CLOSED, never a silent unhealed run.
+        .option("--self-heal <mode>", "self-heal policy mode: fail-closed | hybrid | full", "fail-closed")
+        .option("--real", "use live Jev + OpenRouter gateways for self-heal (requires keys)", false)
+        .option("--fake-ai", "use deterministic fake gateways for self-heal (pipeline smoke only)", false)
+        .option("--json", "emit a JSON envelope")
+        .action(async function (id) {
+        const { env: envName, baseUrl } = this.opts();
+        // #247: --env/--base-url choose where the Journey runs (unknown env / bad file → 64, nothing opened).
+        let environment;
+        try {
+            environment = environmentFromFlags({ ...(envName === undefined ? {} : { env: envName }), ...(baseUrl === undefined ? {} : { baseUrl }) }, environmentSeams(deps));
+        }
+        catch (err) {
+            if (!isEnvironmentError(err))
+                throw err;
+            emitJson(program, fail(err.code, err.message));
+            return;
+        }
+        const ownFixtureFlags = this.opts();
+        // The environment's fixtures/hooks apply when the flags name none (hooks still need --allow-shell-hooks).
+        const fixtureFlags = {
+            ...ownFixtureFlags,
+            ...(ownFixtureFlags.before === undefined && environment?.hooks?.before !== undefined ? { before: environment.hooks.before } : {}),
+            ...(ownFixtureFlags.after === undefined && environment?.hooks?.after !== undefined ? { after: environment.hooks.after } : {}),
+        };
+        const { dir, param, storageState: storageStateFlag, selfHeal, real, fakeAi, json, screenshots: _screenshots, ...emulationFlags } = this.opts();
+        // --storage-state wins; else the environment's own session (~/.jevitate/targets.json[<origin>]).
+        const storageState = storageStateFlag ?? environment?.storageState;
+        if (storageState !== undefined && !existsSync(storageState)) {
+            emitJson(program, fail("E_JOURNEY_RUN_ARGS", `storage state not found: ${storageState}`));
+            return;
+        }
+        // #245: demo mode, resolved (a headed run without a display refused) before any browser opens.
+        let browser;
+        try {
+            browser = browserRunFromFlags(this.opts(), deps.explore?.env ?? process.env);
+        }
+        catch (err) {
+            emitJson(program, fail("E_JOURNEY_RUN_ARGS", err instanceof Error ? err.message : String(err)));
+            return;
+        }
+        // #251: an unusable --screenshots value is a usage error (64), before any browser opens.
+        let screenshots;
+        try {
+            screenshots = parseScreenshotsArg(this.opts().screenshots);
+        }
+        catch (err) {
+            emitJson(program, fail("E_JOURNEY_RUN_ARGS", err instanceof Error ? err.message : String(err)));
+            return;
+        }
+        let journeyRunEmulation;
+        try {
+            journeyRunEmulation = emulationFromFlags(emulationFlags);
+        }
+        catch (err) {
+            emitJson(program, fail("E_JOURNEY_RUN_ARGS", err instanceof Error ? err.message : String(err)));
+            return;
+        }
+        if (selfHeal !== "fail-closed" && selfHeal !== "hybrid" && selfHeal !== "full") {
+            emitJson(program, fail("E_SELF_HEAL_MODE", `--self-heal must be one of fail-closed | hybrid | full (got '${selfHeal}')`));
+            return;
+        }
+        const selfHealMode = selfHeal;
+        // When a heal mode is requested, build the SelfHealer HERE (this action
+        // owns `deps` + the credential preflight); a missing/unselected gateway
+        // fails CLOSED before any browser launch, rather than silently running
+        // with no healer. fail-closed needs no gateway (identical to today).
+        let selfHealer;
+        let policy = safeRunPolicy();
+        // #163: a self-healing run makes model calls — their usage (and full cost) lands on its result.
+        let healUsage;
+        if (selfHealMode !== "fail-closed") {
+            let judge;
+            let gen;
+            try {
+                ({ judge, gen, usage: healUsage } = await buildExploreGateways(deps, { real: real ?? false, fakeAi: fakeAi ?? false }));
+            }
+            catch (err) {
+                if (err instanceof MissingCredentialError || err instanceof GatewaySelectionError) {
+                    emitJson(program, fail("E_AI_SETUP_REQUIRED", err.message));
+                }
+                else {
+                    emitJson(program, fail("E_JOURNEY_RUN", String(err instanceof Error ? err.message : err)));
+                }
+                return;
+            }
+            selfHealer = makeExploreSelfHealer(judge, gen);
+            policy = { ...policy, selfHeal: { mode: selfHealMode } };
+        }
+        try {
+            // `runJourneyProgrammatically` validates params UP FRONT (before any
+            // browser launch). The default policy stays `safeRunPolicy()`
+            // (fail-closed secret mode) — only `selfHeal.mode` is threaded from
+            // the flag; a `--secret-mode` override is a later slice's concern.
+            const result = await withSiteGate(resolveDbPath(deps), (siteGate) => runJourneyProgrammatically({
+                ...(siteGate === undefined ? {} : { siteGate }),
+                dir: resolveJourneysDir(deps, dir),
+                id,
+                params: param,
+                policy,
+                selfHealer,
+                browserPortFactory: deps.explore?.browserPortFactory,
+                ...(browser === undefined ? {} : { browser }),
+                ...(journeyRunEmulation === undefined ? {} : { emulation: journeyRunEmulation }),
+                ...(screenshots === undefined ? {} : { screenshots }),
+                ...(storageState !== undefined ? { storageState } : {}),
+                ...(environment === undefined ? {} : { environment }),
+                // #140: fixture HTTP steps may only reach the journey's own site (authenticated from --storage-state);
+                // #247: under an environment, its allowed origins.
+                fixtures: (site) => {
+                    const fx = buildMissionFixtures(fixtureFlags, {
+                        allowlist: environment === undefined ? [site] : environment.allowedOrigins,
+                        baseUrl: site,
+                        ...(storageState !== undefined ? { storageState } : {}),
+                        ...(environment?.fixtures === undefined ? {} : { targetFixtures: environment.fixtures }),
+                    });
+                    checkSetupRefs({ "--param": Object.values(param) }, fx);
+                    return fx;
+                },
+            })).then((r) => withEngine(healUsage === undefined ? r : { ...r, usage: healUsage.snapshot() }));
+            // #246 (informational, never failing): how many steps say why — `journey annotate` drafts the rest.
+            const intent = await journeyIntentCoverage(resolveJourneysDir(deps, dir), id);
+            if (intent !== undefined && intent.withoutObjective > 0 && !json) {
+                program.configureOutput().writeErr?.(`note: ${intent.withoutObjective} of ${intent.steps} step(s) have no objective — draft them with \`jevitate journey annotate ${id}\`\n`);
+            }
+            const envelope = ok(intent === undefined ? result : { ...result, intent });
+            if (json) {
+                emitJson(program, envelope);
+                // "ok" and "healed" (a recovered run) are both successes; only
+                // "quarantined" is a non-zero exit.
+                if (result.outcome === "quarantined")
+                    process.exitCode = 1;
+            }
+            else {
+                writeRawResult(program, envelope.data);
+                process.exitCode = result.outcome === "quarantined" ? 1 : 0;
+            }
+        }
+        catch (err) {
+            if (err instanceof SiteGateRefusedError || isEnvironmentError(err)) {
+                emitJson(program, fail(err.code, err.message));
+            }
+            else if (err instanceof UnknownJourneyError) {
+                emitJson(program, fail("E_UNKNOWN_JOURNEY", String(err.message)));
+            }
+            else if (err instanceof JourneyRequiresAuthError) {
+                emitJson(program, fail("E_JOURNEY_REQUIRES_AUTH", String(err.message)));
+            }
+            else if (err instanceof FixtureSetupError) {
+                // Never run on unknown state: inconclusive, a configuration error (exit 2).
+                emitJson(program, ok(withEngine({ outcome: "inconclusive", reason: err.message, failure: { kind: "configuration", message: err.message }, attribution: "configuration" })));
+                process.exitCode = 2;
+            }
+            else if (err instanceof FixtureSpecError || err instanceof UnboundSetupRefError) {
+                emitJson(program, fail(err.code, err.message));
+            }
+            else if (err instanceof ParamValidationError) {
+                emitJson(program, fail("E_INVALID_PARAMS", String(err.message)));
+            }
+            else {
+                emitJson(program, fail("E_JOURNEY_RUN", String(err)));
+            }
+        }
+    });
+    // #124 — promote a local Journey so it becomes discoverable/runnable (journey
+    // find / MCP find_capabilities / run_journey), mirroring `mission target
+    // promote`'s human-approval-gate semantics: promoting is a deliberate,
+    // explicit act, never automatic (an authored Journey's `metadata.promoted`
+    // always starts `false` — see `explore-author-journey`/`jevitate record`).
+    journey
+        .command("promote <id>")
+        .description("promote a local Journey (human-approval gate) so it becomes discoverable/runnable")
+        .option("--dir <path>", "journeys directory (default: the repo's .jevitate/journeys; outside a repo ~/.jevitate/journeys)")
+        .option("--json", "emit a JSON envelope")
+        .action(async function (id) {
+        const { dir, json } = this.opts();
+        try {
+            const journeyResult = await promoteJourney(resolveJourneysDir(deps, dir), id);
+            const envelope = ok(journeyResult.metadata);
+            if (json) {
+                emitJson(program, envelope);
+            }
+            else {
+                program.configureOutput().writeOut?.(`promoted journey '${journeyResult.metadata.id}'\n`);
+                process.exitCode = 0;
+            }
+        }
+        catch (err) {
+            if (err instanceof UnknownJourneyError) {
+                emitJson(program, fail("E_UNKNOWN_JOURNEY", String(err.message)));
+            }
+            else {
+                emitJson(program, fail("E_JOURNEY_PROMOTE", String(err instanceof Error ? err.message : err)));
+            }
+        }
+    });
+    // #246 — draft a Journey's intent on playback; `--approve` is the human gate that writes it.
+    registerJourneyAnnotateCommand(journey, program, deps);
+    // #248 — replay a Journey as a narrated demo: video + subtitles and/or a step-by-step guide.
+    registerJourneyDemoCommand(journey, program, deps);
+    // #19 — publish a promoted local Journey to a registered distributed source.
+    // Preserves every publish-side guard in `@jevitate/sources` (promoted-only,
+    // secret-references-only, declared-origin coverage); writes onto a NEW
+    // `publish/<id>` branch and degrades gracefully when `gh` is absent.
+    journey
+        .command("publish <id>")
+        .requiredOption("--to <source>", "registered source name to publish into")
+        .option("--dir <path>", "journeys directory (default: the repo's .jevitate/journeys; outside a repo ~/.jevitate/journeys)")
+        .option("--declare-origin <origin>", "origin this Journey is authorized for (repeatable; default: derived from navigate steps)", (v, prev) => [...prev, v], [])
+        .option("--as <id>", "publish under a different id than the local one")
+        .option("--json", "emit a JSON envelope")
+        .action(async function (id) {
+        const { to, dir, declareOrigin, as: asId, json } = this.opts();
+        try {
+            const apiDeps = resolveSourceApiDeps(deps);
+            const gh = deps.sources?.gh ?? realGhPort;
+            const result = await publishJourneyToSource({ ...apiDeps, gh }, {
+                journeysDir: resolveJourneysDir(deps, dir),
+                id,
+                toSource: to,
+                declareOrigins: declareOrigin,
+                asId,
+            });
+            const envelope = ok(result);
+            if (json) {
+                emitJson(program, envelope);
+            }
+            else {
+                const out = program.configureOutput().writeOut;
+                out?.(`published '${id}' to '${to}' on branch ${result.branch}\n`);
+                if (result.prUrl)
+                    out?.(`PR: ${result.prUrl}\n`);
+                else if (result.instructions)
+                    out?.(`${result.instructions}\n`);
+                process.exitCode = 0;
+            }
+        }
+        catch (err) {
+            if (err instanceof UnknownSourceError) {
+                emitJson(program, fail("E_JOURNEY_PUBLISH_UNKNOWN_SOURCE", err.message));
+            }
+            else if (err instanceof UnknownJourneyError) {
+                emitJson(program, fail("E_JOURNEY_PUBLISH_UNKNOWN_JOURNEY", err.message));
+            }
+            else if (err instanceof NotPromotedError) {
+                emitJson(program, fail("E_JOURNEY_PUBLISH_NOT_PROMOTED", err.message));
+            }
+            else if (err instanceof NoDeclaredOriginsError) {
+                emitJson(program, fail("E_JOURNEY_PUBLISH_NO_ORIGINS", err.message));
+            }
+            else if (err instanceof EmbeddedSecretError) {
+                emitJson(program, fail("E_JOURNEY_PUBLISH_SECRET", err.message));
+            }
+            else if (err instanceof UndeclaredOriginError) {
+                emitJson(program, fail("E_JOURNEY_PUBLISH_ORIGIN", err.message));
+            }
+            else {
+                emitJson(program, fail("E_JOURNEY_PUBLISH", String(err instanceof Error ? err.message : err)));
+            }
+        }
+    });
+}
+//# sourceMappingURL=journey-cli.js.map

package/dist/journey-cli.js.map

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

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

@@ -0,0 +1,112 @@
+import { type AnnotationDraft, type Journey } from "@jevitate/journey";
+import { type CaptureLayer } from "./demo-capture.js";
+import { type RunJourneyProgrammaticallyOptions } from "./journey-api.js";
+/**
+ * #248 — `jevitate journey demo <id>`: replay a Journey as a narrated demo. The overlay (#245) shows
+ * the Journey's goal as a title card, each step's objective as the caption (else its label, else a
+ * value-free description) with its target highlighted and a `pace` pause, then an outcome card. The
+ * outputs are made from the SAME replay: a video (Playwright recordVideo, WebM) with WebVTT subtitles
+ * timed to the captions, and a Markdown guide (goal, preconditions, per step its objective, expected
+ * result and a screenshot with the overlay hidden).
+ *
+ * The replay is `runJourneyProgrammatically` — the same fail-closed policy (paid/destructive steps
+ * refused), site policy, fixtures and environment (#247) as `journey run`; a demo never heals. A
+ * Journey that no longer replays is STALE: nothing is written and the command exits non-zero, so a
+ * CI job regenerating demos catches it. Every caption, cue and guide line is redacted with the run's
+ * secret parameters, and the written text is proven secret-free before it lands; the secret
+ * parameters are also masked in PIXELS — video and screenshots — by the display-only mask layer
+ * (#250/#251, `demo-capture.ts`), proven at every screenshot.
+ */
+/** How long each caption is shown before its step acts (`--pace`, ms). */
+export declare const DEMO_DEFAULT_PACE_MS = 1500;
+/** `--pace` bounds (ms). */
+export declare const DEMO_MAX_PACE_MS = 60000;
+/** A demo's inputs were unusable (an output path of the wrong kind): nothing ran. */
+export declare class DemoArgsError extends Error {
+    readonly code = "E_JOURNEY_DEMO_ARGS";
+}
+/** The replay completed but a promised output could not be produced (no video file, a missing screenshot). */
+export declare class DemoOutputError extends Error {
+    readonly code = "E_JOURNEY_DEMO_OUTPUT";
+}
+export interface DemoJourneyOptions extends Omit<RunJourneyProgrammaticallyOptions, "interpreter" | "policy" | "selfHealer"> {
+    /** The video to write (`.webm`); its subtitles go beside it as `.vtt`. Absent: no video. */
+    video?: string;
+    /** The Markdown guide to write (`.md`); screenshots go in `<name>.assets/` beside it. Absent: no guide. */
+    guide?: string;
+    /** Caption time per step before it acts (ms). Default {@link DEMO_DEFAULT_PACE_MS}. */
+    paceMs?: number;
+    /** Extra screenshot layers (e.g. pixel masking, #250/#251); the overlay is always hidden. */
+    captureLayers?: readonly CaptureLayer[];
+    /**
+     * #249: a reviewed-but-unapproved annotation draft (#246) whose goal / criteria / objectives /
+     * expected results narrate this demo. Applied in memory only — the stored Journey is untouched.
+     */
+    annotations?: AnnotationDraft;
+    /** #249: an unapproved demo — a `DRAFT` watermark on the overlay, and every output marked DRAFT. */
+    draft?: boolean;
+}
+/** #249: the mark every output of an unapproved demo carries. */
+export declare const DEMO_DRAFT_MARK = "DRAFT";
+export interface DemoStep {
+    /** 1-based. */
+    readonly number: number;
+    /** What the overlay and the subtitle said (redacted). */
+    readonly caption: string;
+    readonly expectedResult?: string;
+    /** The subtitle cue, ms from the start of the video. */
+    readonly cue: {
+        readonly startMs: number;
+        readonly endMs: number;
+    };
+    /** The step's screenshot in the guide's assets folder (a guide was asked for). */
+    readonly screenshot?: string;
+}
+export interface DemoJourneyResult {
+    readonly id: string;
+    /** `stale`: the Journey no longer replays — nothing was written. */
+    readonly outcome: "ok" | "stale";
+    /** Why a stale demo stopped (redacted). */
+    readonly reason?: string;
+    /** The 1-based step a stale demo stopped at, when known. */
+    readonly stoppedAtStep?: number;
+    readonly totalSteps: number;
+    /** The steps the replay reached, in order. */
+    readonly steps: DemoStep[];
+    readonly video?: string;
+    readonly subtitles?: string;
+    readonly guide?: string;
+    /** #251 `--screenshots`: the replay's masked screenshots and their `index.md`. */
+    readonly screenshotPaths?: string[];
+    readonly screenshotIndex?: string;
+    readonly screenshotsSkipped?: Array<{
+        readonly step: number;
+        readonly reason: string;
+    }>;
+}
+/** A WebVTT timestamp: `HH:MM:SS.mmm`. */
+export declare function vttTime(ms: number): string;
+/**
+ * The WebVTT subtitles: one cue per step (`step-N`), in order; the goal as a leading NOTE. A draft
+ * (#249) says so in a NOTE and at the start of every cue.
+ */
+export declare function demoSubtitles(title: string, steps: readonly DemoStep[], draft?: boolean): string;
+/**
+ * The Markdown guide (all text already redacted); `assets` is the screenshots folder's name. A draft
+ * (#249) carries `DRAFT` in its title and a watermark line under it.
+ */
+export declare function demoGuide(journey: Journey, title: string, steps: readonly DemoStep[], assets: string, redact: (s: string) => string, draft?: boolean): string;
+/** The title card is on screen at least this long (ms), whatever `--pace` is. */
+export declare const TITLE_CARD_MIN_MS = 1200;
+/** How long the title card waits for the recorder's first frame (ms) before going on regardless. */
+export declare const FIRST_FRAME_WAIT_MS = 5000;
+/** `<dir>/<name>.assets` for `<dir>/<name>.md`. */
+export declare function guideAssetsDir(guide: string): string;
+/** `<video without .webm>.vtt`. */
+export declare function subtitlesPathFor(video: string): string;
+/**
+ * Replays the Journey as a narrated demo and writes the asked-for outputs (see the module comment).
+ * Throws `UnknownJourneyError` / `DemoArgsError` before any browser opens, and every refusal
+ * `runJourneyProgrammatically` has; returns `outcome: "stale"` (writing nothing) when the replay stops.
+ */
+export declare function demoJourney(opts: DemoJourneyOptions): Promise<DemoJourneyResult>;