wotann 0.5.0

package/dist/cli/first-run-success.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-run-success.d.ts","sourceRoot":"","sources":["../../src/cli/first-run-success.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIpE;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEN;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,CAAC,gBAAgB,CAAC,CAAC;AAItF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GAAG,SAAS,MAAM,EAAE,CAYpB;AAID;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,qEACmC,CAAC;AAIrE;;;;;;;;;;;;;;GAcG;AACH,wBAAuB,kBAAkB,CAAC,IAAI,EAAE;IAC9C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B,GAAG,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC,CA6CjD"}

package/dist/cli/first-run-success.js

@@ -0,0 +1,124 @@
+/**
+ * First-run success screen — V9 Tier 6 T6.6.
+ *
+ * After the onboarding wizard (T6.2) finishes configuring a provider,
+ * the user sees a success screen that does ONE thing and then gets
+ * out of the way: kick off a real roundtrip against the new provider
+ * so they see a streaming response within seconds. This is the
+ * load-bearing "time-to-first-token" moment V9 T6 exit criterion
+ * targets (<90s p50 from `wotann init` to streamed output).
+ *
+ * This module is HEADLESS — it's the logic layer that the TUI calls
+ * into. It:
+ *   1. Formats the success banner (lines of text + the provider
+ *      summary).
+ *   2. Runs a best-effort 1-shot query to prove the wire works
+ *      end-to-end.
+ *   3. Returns structured events the TUI renders (success message
+ *      with duration + token count, or a clear "couldn't reach
+ *      provider" error the wizard can route through).
+ *
+ * The actual Ink/React rendering lives elsewhere (T6.2 scope). By
+ * splitting the logic into a pure module, the first-run flow can
+ * also be exercised by integration tests without spinning up a
+ * terminal.
+ *
+ * WOTANN quality bars:
+ *  - QB #6 honest failures: every outcome is a concrete event type
+ *    ("success" with metrics OR "roundtrip-failed" with reason) —
+ *    never a silent best-effort.
+ *  - QB #7 per-call state: no module-level caches; takes the query
+ *    runner as a dependency so the caller chooses which runtime /
+ *    provider / model to use.
+ *  - QB #13 env guard: accepts all inputs as params. No `process.*`
+ *    reads.
+ */
+// ── Banner ────────────────────────────────────────────────────────────────
+/**
+ * Format the success banner lines. Separated from the streaming
+ * logic so the TUI can render the header immediately — no "blank
+ * screen while we warm up" dead time.
+ */
+export function buildBanner(args) {
+    return [
+        "╔══════════════════════════════════════════════════════════╗",
+        "║                   WOTANN is ready.                       ║",
+        "╚══════════════════════════════════════════════════════════╝",
+        "",
+        `Provider:  ${args.selectedRung.label}`,
+        `Cost:      ${args.selectedRung.costNote}`,
+        `Model:     ${args.modelLabel}`,
+        "",
+        "Sending a test prompt to confirm the wire works...",
+    ];
+}
+// ── First prompt ──────────────────────────────────────────────────────────
+/**
+ * Default prompt for the first-run roundtrip. Chosen to be short
+ * (fast first-token), unambiguous (deterministic enough that an
+ * empty/malformed response is clearly a bug), and warm (sets the
+ * user's expectation that WOTANN is a conversational agent, not a
+ * one-shot tool).
+ */
+export const DEFAULT_FIRST_PROMPT = "In one sentence, tell me you're ready to help with coding tasks.";
+// ── Roundtrip driver ──────────────────────────────────────────────────────
+/**
+ * Async generator that drives the first-run success flow. Yields
+ * events in order so the TUI renders them with standard `for await`.
+ * Callers own the query runner (see `FirstRunQueryRunner`) — the
+ * generator is transport-agnostic.
+ *
+ * Invariants:
+ *  - Banner event ALWAYS fires first (even when the query runner
+ *    throws immediately — the user sees the success screen).
+ *  - On success: banner → roundtrip-started → N×chunks → done.
+ *  - On failure: banner → roundtrip-started → failed.
+ *  - Total text + token count are aggregated lazily per chunk so a
+ *    runner that emits `tokensUsed` on only the final chunk still
+ *    produces a meaningful summary.
+ */
+export async function* runFirstRunSuccess(args) {
+    const prompt = args.prompt ?? DEFAULT_FIRST_PROMPT;
+    const now = args.now ?? Date.now;
+    yield {
+        type: "banner",
+        lines: buildBanner({
+            selectedRung: args.selectedRung,
+            modelLabel: args.modelLabel,
+        }),
+    };
+    yield {
+        type: "roundtrip-started",
+        provider: args.selectedRung.label,
+        model: args.modelLabel,
+        prompt,
+    };
+    const start = now();
+    let fullText = "";
+    let tokensUsed = 0;
+    try {
+        for await (const chunk of args.runner(prompt)) {
+            if (typeof chunk.text === "string" && chunk.text.length > 0) {
+                fullText += chunk.text;
+                yield { type: "roundtrip-chunk", text: chunk.text };
+            }
+            if (typeof chunk.tokensUsed === "number" && chunk.tokensUsed > 0) {
+                tokensUsed = chunk.tokensUsed; // providers often emit cumulative count on the final chunk
+            }
+        }
+        yield {
+            type: "roundtrip-done",
+            durationMs: now() - start,
+            tokensUsed,
+            fullText,
+        };
+    }
+    catch (err) {
+        yield {
+            type: "roundtrip-failed",
+            reason: err instanceof Error ? err.message : String(err),
+            durationMs: now() - start,
+        };
+    }
+}
+//# sourceMappingURL=first-run-success.js.map

package/dist/cli/first-run-success.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-run-success.js","sourceRoot":"","sources":["../../src/cli/first-run-success.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAyDH,6EAA6E;AAE7E;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAG3B;IACC,OAAO;QACL,8DAA8D;QAC9D,8DAA8D;QAC9D,8DAA8D;QAC9D,EAAE;QACF,cAAc,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE;QACvC,cAAc,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE;QAC1C,cAAc,IAAI,CAAC,UAAU,EAAE;QAC/B,EAAE;QACF,oDAAoD;KACrD,CAAC;AACJ,CAAC;AAED,6EAA6E;AAE7E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B,kEAAkE,CAAC;AAErE,6EAA6E;AAE7E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,kBAAkB,CAAC,IAUzC;IACC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IAEjC,MAAM;QACJ,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,WAAW,CAAC;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;KACH,CAAC;IAEF,MAAM;QACJ,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK;QACjC,KAAK,EAAE,IAAI,CAAC,UAAU;QACtB,MAAM;KACP,CAAC;IAEF,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;IACpB,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9C,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5D,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC;gBACvB,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YACtD,CAAC;YACD,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;gBACjE,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,2DAA2D;YAC5F,CAAC;QACH,CAAC;QACD,MAAM;YACJ,IAAI,EAAE,gBAAgB;YACtB,UAAU,EAAE,GAAG,EAAE,GAAG,KAAK;YACzB,UAAU;YACV,QAAQ;SACT,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM;YACJ,IAAI,EAAE,kBAAkB;YACxB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACxD,UAAU,EAAE,GAAG,EAAE,GAAG,KAAK;SAC1B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/cli/fork.d.ts

@@ -0,0 +1,80 @@
+/**
+ * `wotann fork` — V9 Tier 14.7.
+ *
+ * Fork a recorded trajectory at a chosen seq boundary. Produces a
+ * NEW trajectory file containing frames [0..atSeq] so users can
+ * branch off a past decision without losing the original. The
+ * original file is never modified — fork writes only the output.
+ *
+ *     wotann fork traj.json --at 42 --out ./fork-42.json
+ *     wotann fork traj.json --at-kind response --out ./before-last.json
+ *
+ * ── Companion: `wotann replay` ───────────────────────────────────────
+ * `src/cli/replay.ts` is the read-only replayer. Fork is the mutator
+ * that produces new trajectory files for replay + divergence analysis.
+ *
+ * ── Determinism ──────────────────────────────────────────────────────
+ * The forked trajectory's `id` is derived from the source `id` plus
+ * the split seq so callers get a deterministic new id (replay of
+ * the same fork twice produces byte-identical output when the clock
+ * is injected). The `startedAt` copies the source; `endedAt` is
+ * recomputed to the last kept frame's timestamp.
+ *
+ * ── WOTANN quality bars ──────────────────────────────────────────────
+ *  - QB #6 honest failures: every branch returns `{ok, ...}` or
+ *    `{ok: false, error}`. Never throws on normal invalid input.
+ *  - QB #7 per-call state: pure async function.
+ *  - QB #13 env guard: path + seq are explicit arguments.
+ */
+import { type FrameKind, type Trajectory } from "../autopilot/trajectory-recorder.js";
+export interface ForkOptions {
+    readonly trajectoryPath: string;
+    readonly outputPath: string;
+    /**
+     * Fork at this seq, inclusive (frames with seq <= at survive).
+     * Mutually exclusive with `atKind`; if both set, `at` wins.
+     */
+    readonly at?: number;
+    /**
+     * Fork at the LAST frame of the given kind. Useful to split off
+     * "the trajectory up through the most recent response". Mutually
+     * exclusive with `at`.
+     */
+    readonly atKind?: FrameKind;
+    /**
+     * Optional metadata to merge into the forked trajectory — callers
+     * typically stamp a `forkedFrom` / `reason` field for auditability.
+     */
+    readonly extraMetadata?: Readonly<Record<string, unknown>>;
+    /**
+     * Optional injection for the loader/saver so tests skip disk.
+     */
+    readonly loader?: (path: string) => Promise<Trajectory>;
+    readonly saver?: (path: string, trajectory: Trajectory) => Promise<void>;
+}
+export interface ForkOutcome {
+    readonly ok: true;
+    readonly forkedTrajectoryId: string;
+    readonly sourceTrajectoryId: string;
+    readonly keptFrameCount: number;
+    readonly splitSeq: number;
+    readonly outputPath: string;
+}
+export interface ForkFailure {
+    readonly ok: false;
+    readonly error: string;
+}
+export type ForkResult = ForkOutcome | ForkFailure;
+/**
+ * Resolve the effective split seq given the input options + a
+ * concrete trajectory. Returns the seq to keep inclusive of, OR null
+ * when the options don't resolve (e.g. `atKind` with no matching frame).
+ */
+export declare function resolveSplitSeq(trajectory: Trajectory, options: Pick<ForkOptions, "at" | "atKind">): number | null;
+/**
+ * Truncate a trajectory at `atSeq`, returning a NEW immutable copy.
+ * Never mutates the input.
+ */
+export declare function truncateTrajectory(source: Trajectory, atSeq: number, extraMetadata?: Readonly<Record<string, unknown>>): Trajectory;
+export declare function runFork(options: ForkOptions): Promise<ForkResult>;
+//# sourceMappingURL=fork.d.ts.map

package/dist/cli/fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../src/cli/fork.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,UAAU,EAEhB,MAAM,qCAAqC,CAAC;AAI7C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAInD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,QAAQ,CAAC,GAC1C,MAAM,GAAG,IAAI,CAef;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAChD,UAAU,CAqBZ;AAID,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAiDvE"}

package/dist/cli/fork.js

@@ -0,0 +1,127 @@
+/**
+ * `wotann fork` — V9 Tier 14.7.
+ *
+ * Fork a recorded trajectory at a chosen seq boundary. Produces a
+ * NEW trajectory file containing frames [0..atSeq] so users can
+ * branch off a past decision without losing the original. The
+ * original file is never modified — fork writes only the output.
+ *
+ *     wotann fork traj.json --at 42 --out ./fork-42.json
+ *     wotann fork traj.json --at-kind response --out ./before-last.json
+ *
+ * ── Companion: `wotann replay` ───────────────────────────────────────
+ * `src/cli/replay.ts` is the read-only replayer. Fork is the mutator
+ * that produces new trajectory files for replay + divergence analysis.
+ *
+ * ── Determinism ──────────────────────────────────────────────────────
+ * The forked trajectory's `id` is derived from the source `id` plus
+ * the split seq so callers get a deterministic new id (replay of
+ * the same fork twice produces byte-identical output when the clock
+ * is injected). The `startedAt` copies the source; `endedAt` is
+ * recomputed to the last kept frame's timestamp.
+ *
+ * ── WOTANN quality bars ──────────────────────────────────────────────
+ *  - QB #6 honest failures: every branch returns `{ok, ...}` or
+ *    `{ok: false, error}`. Never throws on normal invalid input.
+ *  - QB #7 per-call state: pure async function.
+ *  - QB #13 env guard: path + seq are explicit arguments.
+ */
+import { loadTrajectory, saveTrajectory, } from "../autopilot/trajectory-recorder.js";
+// ═══ Pure split logic ════════════════════════════════════════════════════
+/**
+ * Resolve the effective split seq given the input options + a
+ * concrete trajectory. Returns the seq to keep inclusive of, OR null
+ * when the options don't resolve (e.g. `atKind` with no matching frame).
+ */
+export function resolveSplitSeq(trajectory, options) {
+    if (typeof options.at === "number") {
+        return Math.floor(options.at);
+    }
+    if (options.atKind) {
+        let last = null;
+        for (const frame of trajectory.frames) {
+            if (frame.kind === options.atKind)
+                last = frame.seq;
+        }
+        return last;
+    }
+    // No split — fork the whole thing.
+    return trajectory.frames.length > 0
+        ? (trajectory.frames[trajectory.frames.length - 1]?.seq ?? 0)
+        : 0;
+}
+/**
+ * Truncate a trajectory at `atSeq`, returning a NEW immutable copy.
+ * Never mutates the input.
+ */
+export function truncateTrajectory(source, atSeq, extraMetadata) {
+    const keptFrames = [];
+    for (const frame of source.frames) {
+        if (frame.seq <= atSeq)
+            keptFrames.push(frame);
+    }
+    const forkId = `${source.id}@fork-${atSeq}`;
+    const lastKept = keptFrames[keptFrames.length - 1];
+    const mergedMetadata = {
+        ...(source.metadata ?? {}),
+        ...(extraMetadata ?? {}),
+        forkedFrom: source.id,
+        splitSeq: atSeq,
+    };
+    const result = {
+        id: forkId,
+        startedAt: source.startedAt,
+        frames: keptFrames,
+        ...(lastKept ? { endedAt: lastKept.timestamp } : {}),
+        metadata: mergedMetadata,
+    };
+    return result;
+}
+// ═══ Public API ══════════════════════════════════════════════════════════
+export async function runFork(options) {
+    if (typeof options.at === "number" && options.atKind) {
+        return {
+            ok: false,
+            error: "fork: pass either --at or --at-kind, not both",
+        };
+    }
+    if (!options.outputPath || options.outputPath.length === 0) {
+        return { ok: false, error: "fork: outputPath is required" };
+    }
+    const loader = options.loader ?? loadTrajectory;
+    const saver = options.saver ?? saveTrajectory;
+    let source;
+    try {
+        source = await loader(options.trajectoryPath);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { ok: false, error: `load failed: ${msg}` };
+    }
+    const splitSeq = resolveSplitSeq(source, options);
+    if (splitSeq === null) {
+        return {
+            ok: false,
+            error: options.atKind
+                ? `no frame of kind "${options.atKind}" found in trajectory ${source.id}`
+                : `could not resolve split seq for trajectory ${source.id}`,
+        };
+    }
+    const forked = truncateTrajectory(source, splitSeq, options.extraMetadata);
+    try {
+        await saver(options.outputPath, forked);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { ok: false, error: `save failed: ${msg}` };
+    }
+    return {
+        ok: true,
+        forkedTrajectoryId: forked.id,
+        sourceTrajectoryId: source.id,
+        keptFrameCount: forked.frames.length,
+        splitSeq,
+        outputPath: options.outputPath,
+    };
+}
+//# sourceMappingURL=fork.js.map

package/dist/cli/fork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.js","sourceRoot":"","sources":["../../src/cli/fork.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EACL,cAAc,EACd,cAAc,GAIf,MAAM,qCAAqC,CAAC;AA8C7C,4EAA4E;AAE5E;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAsB,EACtB,OAA2C;IAE3C,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,IAAI,IAAI,GAAkB,IAAI,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM;gBAAE,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,mCAAmC;IACnC,OAAO,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACjC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAkB,EAClB,KAAa,EACb,aAAiD;IAEjD,MAAM,UAAU,GAAsB,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK;YAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnD,MAAM,cAAc,GAA4B;QAC9C,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC1B,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC,EAAE;QACrB,QAAQ,EAAE,KAAK;KAChB,CAAC;IACF,MAAM,MAAM,GAAe;QACzB,EAAE,EAAE,MAAM;QACV,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,UAAU;QAClB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,QAAQ,EAAE,cAAc;KACzB,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4EAA4E;AAE5E,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAoB;IAChD,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACrD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,+CAA+C;SACvD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC;IAC9D,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;IAE9C,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,GAAG,EAAE,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,OAAO,CAAC,MAAM;gBACnB,CAAC,CAAC,qBAAqB,OAAO,CAAC,MAAM,yBAAyB,MAAM,CAAC,EAAE,EAAE;gBACzE,CAAC,CAAC,8CAA8C,MAAM,CAAC,EAAE,EAAE;SAC9D,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3E,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,GAAG,EAAE,EAAE,CAAC;IACrD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,kBAAkB,EAAE,MAAM,CAAC,EAAE;QAC7B,kBAAkB,EAAE,MAAM,CAAC,EAAE;QAC7B,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;QACpC,QAAQ;QACR,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;AACJ,CAAC"}

package/dist/cli/hooks-browser.d.ts

@@ -0,0 +1,142 @@
+/**
+ * /hooks browser — introspection surface for HookEngine fires
+ * (Port from codex commits 93d53f65, d5547948, 8f3c06cc).
+ *
+ * Background: WOTANN's `HookResult.contextPrefix` channel runs hooks
+ * but offers no "what just fired" surface. Users see hook effects
+ * (rejections, modified prompts) but can't audit the order or
+ * payload sizes. codex's `/hooks` browser TUI showed the user every
+ * fire in real time and let them toggle individual hooks live.
+ *
+ * This module provides the storage and toggle primitives. The actual
+ * CLI rendering is wired into `wotann hooks list` / `wotann hooks
+ * toggle` in src/index.ts.
+ *
+ * Design constraints:
+ *   - QB#3 honest stub: when no hooks have fired, listFiredHooks
+ *     returns []. When the enablement file is missing, every hook
+ *     is treated as ENABLED — opt-out, not opt-in.
+ *   - QB#7 per-call: every read goes to disk. No module-global
+ *     cache of enablement state. Multiple concurrent callers see a
+ *     consistent view because writes are atomic via tmp+rename.
+ *   - File mode 0o600 (matches ~/.claude/credentials.json pattern).
+ */
+import { dirname } from "node:path";
+/**
+ * One row in the fire-history. Captured at the call site (the hook
+ * engine pushes into this log via `recordHookFire` below). Ordered
+ * append-only so `listFiredHooks` is just a tail.
+ */
+export interface HookFireRecord {
+    readonly sessionId: string;
+    readonly hookName: string;
+    readonly event: string;
+    readonly timestamp: number;
+    /** Length of the contextPrefix this fire returned (0 if none). */
+    readonly contextPrefixLength: number;
+    /** Error message if the hook threw — omitted on success. */
+    readonly error?: string;
+}
+/**
+ * Map of hook-name -> enabled. Absent entries mean enabled (opt-out).
+ */
+export type HookEnablementMap = Readonly<Record<string, boolean>>;
+/**
+ * Result of a toggle. Returned to CLI so it can render the new state.
+ */
+export interface ToggleResult {
+    readonly hookName: string;
+    readonly enabled: boolean;
+    readonly persistedTo: string;
+}
+/**
+ * Resolve the directory holding hook-browser state. Override-able
+ * through the `home` arg so tests can stub without touching $HOME.
+ */
+export declare function resolveHookBrowserDir(home?: string): string;
+/**
+ * Append a fire record. Newline-delimited JSON so the file can grow
+ * append-only without a rewrite. The CLI tails the last N lines.
+ *
+ * Failures (e.g. read-only filesystem) are silently ignored — fire
+ * history is observability, never load-bearing. Throwing here would
+ * crash the agent.
+ */
+export declare function recordHookFire(record: HookFireRecord, options?: {
+    readonly home?: string;
+}): Promise<void>;
+/**
+ * Read the most recent N fire records for a session. Defaults to
+ * the last 50 — enough for an interactive listing without reading
+ * a 100MB log file in production.
+ *
+ * Returns `[]` (honest empty) if the file doesn't exist or contains
+ * only invalid lines. Never throws on malformed JSONL — corrupt
+ * records are skipped with no visible error.
+ */
+export declare function listFiredHooks(sessionId: string, options?: {
+    readonly limit?: number;
+    readonly home?: string;
+}): Promise<ReadonlyArray<HookFireRecord>>;
+/**
+ * Load the enablement map. Returns an empty map if the file is
+ * missing or corrupt — caller treats absent keys as enabled.
+ *
+ * Per QB#7: this reads from disk every call. The file is small
+ * (one boolean per hook) so the cost is dominated by a single
+ * read syscall. Caching would create staleness across processes.
+ */
+export declare function getHookEnablementState(options?: {
+    readonly home?: string;
+}): Promise<HookEnablementMap>;
+/**
+ * Convenience: is THIS hook enabled? Treats unknown / absent as
+ * enabled (opt-out semantics).
+ */
+export declare function isHookEnabled(hookName: string, options?: {
+    readonly home?: string;
+}): Promise<boolean>;
+/**
+ * Atomically toggle a hook's enabled flag. Writes via tmp+rename so
+ * a concurrent reader either sees the old map or the new map, never
+ * a partial JSON.
+ *
+ * The file is written with mode 0o600 (owner-only) — toggling hooks
+ * is a security-sensitive operation (e.g. disabling secret-scanner)
+ * and the file should not be world-readable.
+ */
+export declare function toggleHookEnablement(name: string, enabled: boolean, options?: {
+    readonly home?: string;
+}): Promise<ToggleResult>;
+/**
+ * Convenience for tests: clear the fire log so a test scenario
+ * starts from a known empty state. Production code never calls this.
+ */
+export declare function clearHookFireLog(options?: {
+    readonly home?: string;
+}): Promise<void>;
+/**
+ * Path accessor exposed for the CLI so the `wotann hooks list` and
+ * `wotann hooks toggle` subcommands can show users where state is
+ * persisted. Useful for debugging "why isn't my toggle taking?"
+ */
+export declare function describeHookBrowserPaths(options?: {
+    readonly home?: string;
+}): {
+    readonly enablement: string;
+    readonly fires: string;
+    readonly directory: string;
+};
+/**
+ * Reserved for future use: ensure the parent directory for the
+ * fires log exists so callers in cold-start scenarios don't fail
+ * on the first append. Kept exported so the CLI can pre-warm.
+ */
+export declare function ensureHookBrowserReady(options?: {
+    readonly home?: string;
+}): Promise<void>;
+/**
+ * Re-export to make it explicit which directory holds the state.
+ */
+export { dirname };
+//# sourceMappingURL=hooks-browser.d.ts.map

package/dist/cli/hooks-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-browser.d.ts","sourceRoot":"","sources":["../../src/cli/hooks-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAE,OAAO,EAAQ,MAAM,WAAW,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAOD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAEtE;AAcD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CA4CxC;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,CAAC,EAAE;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwB7B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAAC,YAAY,CAAC,CAgBvB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ1F;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAQA;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAShG;AAED;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,CAAC"}