otacon 0.1.0

package/dist/daemon/threads.js

@@ -0,0 +1,153 @@
+// Per-session thread persistence: .otacon/<id>/threads.json holds every
+// comment and question thread so the review UI's rail can render the whole
+// conversation on any load (DESIGN.md §9, §12) — the event queue drains, so
+// it cannot be the rail's source. Same storage posture as the rest of the
+// daemon: atomic writes, corrupt files quarantined and rebuilt empty, never
+// fatal (DECISIONS.md "Threads: one threads.json per session").
+import { existsSync } from "node:fs";
+import { relocateAnchor } from "./anchor.js";
+import { segmentPlan } from "./diff.js";
+import { quarantineCorruptFile, readJsonOr, stringify, writeFileAtomic } from "./store.js";
+function isAnchor(raw) {
+    if (raw === null)
+        return true;
+    const anchor = raw;
+    return typeof anchor === "object" && typeof anchor.section === "string";
+}
+function isThread(raw) {
+    const thread = raw;
+    if (typeof thread !== "object" || thread === null)
+        return false;
+    if (typeof thread.id !== "string" || typeof thread.body !== "string")
+        return false;
+    if (typeof thread.createdAt !== "string" || !isAnchor(thread.anchor))
+        return false;
+    if (thread.anchorState !== undefined && thread.anchorState !== "orphaned")
+        return false;
+    if (thread.kind === "comment") {
+        if (typeof thread.batch !== "string")
+            return false;
+        const { resolution } = thread;
+        if (resolution === undefined)
+            return true;
+        return (typeof resolution === "object" &&
+            resolution !== null &&
+            typeof resolution.body === "string" &&
+            typeof resolution.revision === "number" &&
+            typeof resolution.resolvedAt === "string");
+    }
+    if (thread.kind === "question") {
+        if (thread.replyTo !== undefined && typeof thread.replyTo !== "string")
+            return false;
+        const { answer } = thread;
+        if (answer === undefined)
+            return true;
+        return (typeof answer === "object" &&
+            answer !== null &&
+            typeof answer.body === "string" &&
+            typeof answer.answeredAt === "string");
+    }
+    return false;
+}
+// Every element is validated, not just the envelope: a JSON-valid file with a
+// corrupt element would otherwise flow a non-Thread into answerQuestion (500)
+// and the rail (render crash) — exactly the "never fatal" failures quarantine
+// exists to absorb.
+function parseThreads(raw) {
+    const file = raw;
+    const valid = typeof file === "object" &&
+        file !== null &&
+        file.version === 1 &&
+        Array.isArray(file.threads) &&
+        file.threads.every(isThread);
+    return valid ? file : undefined;
+}
+/** All threads, oldest first. Missing file = no threads yet; corrupt = quarantined, []. */
+export function readThreads(path) {
+    if (!existsSync(path))
+        return [];
+    const file = parseThreads(readJsonOr(path));
+    if (!file) {
+        quarantineCorruptFile(path, "threads file");
+        return [];
+    }
+    return file.threads;
+}
+/** Durably append new threads (a comment batch's items, or one question). */
+export function appendThreads(path, threads) {
+    const file = { version: 1, threads: [...readThreads(path), ...threads] };
+    writeFileAtomic(path, stringify(file));
+}
+/**
+ * Record the agent's answer on a question thread; returns the updated thread,
+ * or undefined when no question with that id exists (comment ids included —
+ * comments are resolved via resubmit, never answered). Re-answering
+ * overwrites: at-least-once delivery means the agent may legitimately answer
+ * the same question twice, and the newer text is the better one.
+ */
+export function answerQuestion(path, id, body) {
+    const threads = readThreads(path);
+    const thread = threads.find((t) => t.id === id && t.kind === "question");
+    if (!thread)
+        return undefined;
+    const answer = { body, answeredAt: new Date().toISOString() };
+    thread.answer = answer;
+    writeFileAtomic(path, stringify({ version: 1, threads }));
+    return { ...thread, answer };
+}
+/**
+ * Apply an accepted revision to the threads file, in one read + one atomic
+ * write: record the resolution replies on their comment threads (lint L5 has
+ * already vouched for them; re-resolving overwrites — at-least-once), then
+ * re-locate every thread's anchor in the new plan (DESIGN.md §4) — lost or
+ * ambiguous quotes turn anchorState "orphaned", re-found ones recover.
+ * Returns the threads that changed, for the daemon's SSE `thread` upserts.
+ */
+export function applyRevisionToThreads(path, opts) {
+    const threads = readThreads(path);
+    if (threads.length === 0)
+        return [];
+    const changed = new Map();
+    const resolvedAt = new Date().toISOString();
+    // Segment the new plan once for the whole pass (lazily — a rail of
+    // whole-plan threads never needs it), not per anchored thread.
+    let units;
+    for (const thread of threads) {
+        if (thread.kind === "comment" && opts.replies[thread.id] !== undefined) {
+            thread.resolution = {
+                body: opts.replies[thread.id],
+                revision: opts.revision,
+                resolvedAt,
+            };
+            changed.set(thread.id, thread);
+        }
+        if (thread.anchor === null)
+            continue; // whole-plan threads have no place to lose
+        const result = relocateAnchor(thread.anchor, opts.plan, (units ??= segmentPlan(opts.plan)));
+        if (result.state === "orphaned") {
+            if (thread.anchorState !== "orphaned") {
+                thread.anchorState = "orphaned";
+                changed.set(thread.id, thread);
+            }
+        }
+        else {
+            const moved = JSON.stringify(result.anchor) !== JSON.stringify(thread.anchor);
+            if (thread.anchorState === "orphaned" || moved) {
+                delete thread.anchorState;
+                thread.anchor = result.anchor;
+                changed.set(thread.id, thread);
+            }
+        }
+    }
+    if (changed.size > 0) {
+        writeFileAtomic(path, stringify({ version: 1, threads }));
+    }
+    return [...changed.values()];
+}
+/** Comment threads with their resolved state — the daemon's L5 context input. */
+export function commentThreadStates(path) {
+    return readThreads(path)
+        .filter((t) => t.kind === "comment")
+        .map((t) => ({ id: t.id, resolved: t.resolution !== undefined }));
+}
+//# sourceMappingURL=threads.js.map

package/dist/daemon/threads.js.map

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

package/dist/daemon/transcript.js

@@ -0,0 +1,89 @@
+// Per-session grill transcript: .otacon/<id>/transcript.json holds every
+// agent question and the user's answer (DESIGN.md §8) — distinct from
+// user-question threads (threads.json), because the Interview panel and the
+// threads rail are different surfaces with different lifecycles, and the
+// transcript ships with the approved artifact while threads stay review
+// exhaust. Same storage posture as the rest of the daemon: atomic writes,
+// corrupt files quarantined and rebuilt empty, never fatal.
+import { existsSync } from "node:fs";
+import { quarantineCorruptFile, readJsonOr, stringify, writeFileAtomic } from "./store.js";
+function isAnswer(raw) {
+    const answer = raw;
+    if (typeof answer !== "object" || answer === null)
+        return false;
+    if (typeof answer.answeredAt !== "string")
+        return false;
+    if (answer.choice !== undefined && typeof answer.choice !== "string")
+        return false;
+    if (answer.choices !== undefined &&
+        !(Array.isArray(answer.choices) && answer.choices.every((c) => typeof c === "string"))) {
+        return false;
+    }
+    return answer.text === undefined || typeof answer.text === "string";
+}
+// Every entry is validated, not just the envelope (same argument as
+// threads.ts): a JSON-valid file with a corrupt entry would otherwise flow a
+// non-entry into the answers endpoint (500) and the Interview panel.
+function isEntry(raw) {
+    const entry = raw;
+    if (typeof entry !== "object" || entry === null)
+        return false;
+    if (typeof entry.id !== "string" || typeof entry.question !== "string")
+        return false;
+    if (typeof entry.askedAt !== "string")
+        return false;
+    if (entry.options !== undefined &&
+        !(Array.isArray(entry.options) && entry.options.every((o) => typeof o === "string"))) {
+        return false;
+    }
+    if (entry.recommend !== undefined && typeof entry.recommend !== "string")
+        return false;
+    if (entry.multi !== undefined && typeof entry.multi !== "boolean")
+        return false;
+    return entry.answer === undefined || isAnswer(entry.answer);
+}
+function parseTranscript(raw) {
+    const file = raw;
+    const valid = typeof file === "object" &&
+        file !== null &&
+        file.version === 1 &&
+        Array.isArray(file.entries) &&
+        file.entries.every(isEntry);
+    return valid ? file : undefined;
+}
+/** All entries, oldest first. Missing file = no transcript yet; corrupt = quarantined, []. */
+export function readTranscript(path) {
+    if (!existsSync(path))
+        return [];
+    const file = parseTranscript(readJsonOr(path));
+    if (!file) {
+        quarantineCorruptFile(path, "grill transcript");
+        return [];
+    }
+    return file.entries;
+}
+/** Durably append one asked question (otacon ask). */
+export function appendEntry(path, entry) {
+    appendEntries(path, [entry]);
+}
+/** Durably append a batch of asked questions in one write (otacon ask --batch). */
+export function appendEntries(path, entries) {
+    const file = { version: 1, entries: [...readTranscript(path), ...entries] };
+    writeFileAtomic(path, stringify(file));
+}
+/**
+ * Record the user's answer on a transcript entry; returns the updated entry,
+ * or undefined when no question with that id exists. Re-answering overwrites
+ * — at-least-once delivery makes a duplicate answer legitimate, and the newer
+ * one wins (same posture as threads.ts answerQuestion).
+ */
+export function answerEntry(path, id, answer) {
+    const entries = readTranscript(path);
+    const entry = entries.find((e) => e.id === id);
+    if (!entry)
+        return undefined;
+    entry.answer = answer;
+    writeFileAtomic(path, stringify({ version: 1, entries }));
+    return { ...entry };
+}
+//# sourceMappingURL=transcript.js.map

package/dist/daemon/transcript.js.map

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

package/dist/daemon/ui.js

@@ -0,0 +1,175 @@
+// The daemon's browser-facing surface: the built SPA (static files from
+// dist/ui) and the SSE streams the UI watches (DESIGN.md §6, §10). Static
+// serving is hand-rolled because @hono/node-server's serveStatic resolves
+// roots against process.cwd(), which is meaningless for a daemon spawned from
+// any repo (DECISIONS.md "Daemon serves the built SPA from dist/ui").
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+const HEARTBEAT_MS = 25_000;
+/** Vite's output is flat hashed names — no slashes means no traversal. */
+const ASSET_NAME = /^[A-Za-z0-9_.-]+$/;
+const CONTENT_TYPES = {
+    ".html": "text/html; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".map": "application/json",
+    ".json": "application/json",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".ico": "image/x-icon",
+    ".txt": "text/plain; charset=utf-8",
+    ".woff2": "font/woff2",
+};
+/**
+ * dist/daemon/ui.js → ../ui = dist/ui; a source-tree run under bun falls back
+ * to <root>/dist/ui. The `assets/` guard is load-bearing: since ui/ moved under
+ * src/ui/ (commit fac1349), the `../ui/` candidate also matches src/ui/ in a
+ * source run — but that dir holds only the Vite *dev* template (a `/main.tsx`
+ * script tag the daemon can't serve), not a build. Requiring a sibling
+ * `assets/` dir disqualifies the source template across every layout (published
+ * package, repo dist/, source run) so only a real build is ever served.
+ */
+function resolveBuiltUiDir() {
+    for (const candidate of ["../ui/", "../../dist/ui/"]) {
+        const dir = fileURLToPath(new URL(candidate, import.meta.url));
+        if (isBuiltUiDir(dir))
+            return dir;
+    }
+    return undefined;
+}
+/**
+ * True only for a real Vite build: both `index.html` and a sibling `assets/`
+ * dir. The source `src/ui/` holds the dev template (index.html, no assets/), so
+ * this predicate is what keeps a source run from serving it (see
+ * resolveBuiltUiDir). Exported for the regression test.
+ */
+export function isBuiltUiDir(dir) {
+    return existsSync(join(dir, "index.html")) && existsSync(join(dir, "assets"));
+}
+const encoder = new TextEncoder();
+function frame(event, data) {
+    return encoder.encode(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+}
+/**
+ * One SSE response: a `snapshot` frame immediately (so subscribers never race
+ * a separate fetch), then every published UiEvent — optionally filtered to one
+ * session — plus a comment heartbeat that keeps idle proxies from severing the
+ * stream. No event ids: a reconnect re-syncs from the fresh snapshot.
+ */
+function sse(c, deps, snapshot, onlySession) {
+    // Materializes node-server's lazy AbortController so client disconnects
+    // abort the signal (same trick as the events long-poll in app.ts).
+    const signal = c.req.raw.signal;
+    let cleanup;
+    const dispose = () => {
+        cleanup?.();
+        cleanup = undefined;
+    };
+    const stream = new ReadableStream({
+        start(controller) {
+            // Built before any resource exists: if snapshot() throws (a session read
+            // gone wrong), the error propagates out of sse() into app.onError with
+            // no subscription or heartbeat left behind to leak.
+            const snapshotFrame = frame("snapshot", snapshot());
+            const close = () => {
+                dispose();
+                try {
+                    controller.close();
+                }
+                catch {
+                    // already closed or cancelled
+                }
+            };
+            const send = (chunk) => {
+                try {
+                    controller.enqueue(chunk);
+                }
+                catch {
+                    close(); // reader vanished mid-enqueue
+                }
+            };
+            const unsubscribe = deps.notifier.subscribe((event) => {
+                if (onlySession !== undefined && event.session !== onlySession)
+                    return;
+                send(frame(event.type, event.data));
+                // `removed` is terminal for a single-session stream: the session left
+                // the registry, so nothing can ever be published for it again. End the
+                // response server-side too — otherwise a client that ignores the frame
+                // pins this connection (subscription + heartbeat) forever. The index
+                // stream stays open: other sessions keep flowing.
+                if (onlySession !== undefined && event.type === "removed")
+                    close();
+            });
+            const heartbeat = setInterval(() => send(encoder.encode(": hb\n\n")), deps.heartbeatMs ?? HEARTBEAT_MS);
+            heartbeat.unref?.(); // never holds the process open
+            const onAbort = () => close();
+            cleanup = () => {
+                unsubscribe();
+                clearInterval(heartbeat);
+                signal.removeEventListener("abort", onAbort);
+            };
+            send(snapshotFrame);
+            if (signal.aborted)
+                close();
+            else
+                signal.addEventListener("abort", onAbort);
+        },
+        cancel() {
+            dispose();
+        },
+    });
+    return new Response(stream, {
+        headers: {
+            "content-type": "text/event-stream; charset=utf-8",
+            "cache-control": "no-cache, no-transform",
+            connection: "keep-alive",
+        },
+    });
+}
+export function registerUiRoutes(app, deps) {
+    const uiDir = deps.uiDir === undefined ? resolveBuiltUiDir() : deps.uiDir;
+    // The SPA shell. /s/:id always answers 200 — a static shell cannot know
+    // session ids, so unknown sessions render a client-side not-found state.
+    const shell = (c) => {
+        if (uiDir == null) {
+            return c.text("otacon: web UI is not built — run `bun run build` (output: dist/ui)\n", 503);
+        }
+        return c.html(readFileSync(join(uiDir, "index.html"), "utf8"), 200, {
+            "cache-control": "no-cache",
+        });
+    };
+    app.get("/", shell);
+    app.get("/s/:id", shell);
+    app.get("/assets/*", (c) => {
+        const name = c.req.path.slice("/assets/".length);
+        const type = CONTENT_TYPES[name.slice(name.lastIndexOf("."))];
+        const path = uiDir != null && ASSET_NAME.test(name) && type !== undefined
+            ? join(uiDir, "assets", name)
+            : undefined;
+        if (path === undefined || !existsSync(path))
+            return c.text("not found\n", 404);
+        // Vite asset names are content-hashed: immutable forever.
+        return new Response(new Uint8Array(readFileSync(path)), {
+            headers: { "content-type": type, "cache-control": "public, max-age=31536000, immutable" },
+        });
+    });
+    app.get("/api/stream", (c) => sse(c, deps, () => ({ sessions: deps.listSummaries() })));
+    app.get("/api/sessions/:id/stream", (c) => {
+        const id = c.req.param("id");
+        if (!deps.getSummary(id)) {
+            return c.json({ error: { code: "E_NOT_FOUND", message: `unknown session: ${id}` } }, 404);
+        }
+        // Threads, transcript, and the activity feed ride the snapshot so the rail,
+        // the Interview panel, and the activity log never race a separate fetch
+        // against `thread`/`grill`/`activity` frames (same argument as
+        // snapshot-first itself).
+        return sse(c, deps, () => ({
+            session: deps.getSummary(id),
+            threads: deps.getThreads(id),
+            transcript: deps.getTranscript(id),
+            activity: deps.getActivity(id),
+        }), id);
+    });
+}
+//# sourceMappingURL=ui.js.map

package/dist/daemon/ui.js.map

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

package/dist/shared/config.js

@@ -0,0 +1,93 @@
+import { readFileSync } from "node:fs";
+import { globalConfigPath, repoConfigPath } from "./paths.js";
+export const DEFAULT_CONFIG = {
+    budgets: {
+        summaryLines: 5,
+        contractLines: 12,
+        impactLines: 10,
+        decisionEntryLines: 3,
+        phaseGoalLines: 3,
+        phaseVerificationLines: 3,
+        gwtMaxScenarios: 6,
+        risksMaxItems: 5,
+        riskEntryLines: 2,
+        maxFencesPerReadSection: 1,
+        maxVisualsPerReadSection: 2,
+        detailsSoftCapLines: 80,
+    },
+    activity: {
+        cap: 20,
+        noteMaxChars: 200,
+    },
+    notifications: { desktop: true },
+};
+function readJsonFile(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Overlay one config file's `<section>` (all positive-number keys); invalid
+ * values are ignored with a notice. Both `budgets` and `activity` are flat
+ * maps of positive numbers, so they share this merge.
+ */
+function mergeSection(base, raw, section, source) {
+    if (typeof raw !== "object" || raw === null)
+        return base;
+    const obj = raw[section];
+    if (typeof obj !== "object" || obj === null)
+        return base;
+    const merged = { ...base };
+    for (const key of Object.keys(base)) {
+        const value = obj[key];
+        if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+            merged[key] = value;
+        }
+        else if (value !== undefined) {
+            process.stderr.write(`otacon: ignoring invalid ${section}.${String(key)} in ${source}\n`);
+        }
+    }
+    return merged;
+}
+/** Overlay one config file's notifications; a non-boolean is ignored with a notice. */
+function mergeNotifications(base, raw, source) {
+    if (typeof raw !== "object" || raw === null)
+        return base;
+    const notifications = raw.notifications;
+    if (typeof notifications !== "object" || notifications === null)
+        return base;
+    const merged = { ...base };
+    for (const key of Object.keys(base)) {
+        const value = notifications[key];
+        if (typeof value === "boolean") {
+            merged[key] = value;
+        }
+        else if (value !== undefined) {
+            process.stderr.write(`otacon: ignoring invalid notifications.${key} in ${source}\n`);
+        }
+    }
+    return merged;
+}
+/**
+ * defaults ← $OTACON_HOME/config.json ← <repo>/otacon.config.json.
+ * Loaded fresh on every use so tuning takes effect immediately. Each file is
+ * overlaid section by section (budgets, activity, notifications).
+ */
+export function loadConfig(repoRoot) {
+    const overlay = (source, into) => {
+        const raw = readJsonFile(source);
+        return {
+            budgets: mergeSection(into.budgets, raw, "budgets", source),
+            activity: mergeSection(into.activity, raw, "activity", source),
+            notifications: mergeNotifications(into.notifications, raw, source),
+        };
+    };
+    let config = overlay(globalConfigPath(), DEFAULT_CONFIG);
+    if (repoRoot)
+        config = overlay(repoConfigPath(repoRoot), config);
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/shared/config.js.map

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

package/dist/shared/gwt.js

@@ -0,0 +1,69 @@
+// The behavioral-assertion grammar (DESIGN.md §4, §9): a ```gwt fence inside a
+// phase's Verification holds one or more Given/When/Then scenarios that double
+// as the human's Test-Driven Review approve checklist. This tokenizer is the
+// single source of truth for what a scenario *is*, shared by the daemon linter
+// (shape + budget validation, rules.ts) and the UI scenario cards
+// (scenario-card.tsx) so the two can never disagree about the grammar — unlike
+// the line grammar, which is deliberately ported (DECISIONS.md), this construct
+// is new, so one shared parser is the simpler, drift-proof choice. Purely
+// structural: it tokenizes and flags well-formedness; the *verdicts* (empty,
+// malformed, over budget) are the linter's (rules.ts).
+// A step line: a leading keyword (case-insensitive) plus the rest as text.
+// `And`/`But` continue whichever clause is open.
+const STEP_RE = /^(given|when|then|and|but)\b\s*(.*)$/i;
+const RANK = { given: 0, when: 1, then: 2 };
+/** Tokenize one scenario's non-blank lines into a `GwtScenario`. */
+function parseScenario(lines) {
+    const scenario = { given: [], when: [], then: [], valid: true };
+    let clause = null;
+    let maxRank = -1;
+    for (const line of lines) {
+        const match = STEP_RE.exec(line.trim());
+        if (!match) {
+            scenario.valid = false; // a line that isn't a Given/When/Then/And/But step
+            continue;
+        }
+        const keyword = match[1].toLowerCase();
+        const text = match[2].trim();
+        if (keyword === "given" || keyword === "when" || keyword === "then") {
+            // Scenarios read top-down: a keyword may not regress (When then Given).
+            if (RANK[keyword] < maxRank)
+                scenario.valid = false;
+            maxRank = Math.max(maxRank, RANK[keyword]);
+            clause = keyword;
+        }
+        else if (clause === null) {
+            scenario.valid = false; // a dangling And/But with no clause to continue
+            continue;
+        }
+        if (clause)
+            scenario[clause].push(text);
+    }
+    if (scenario.given.length === 0 || scenario.when.length === 0 || scenario.then.length === 0) {
+        scenario.valid = false;
+    }
+    return scenario;
+}
+/**
+ * Parse a ```gwt fence body into scenarios. Scenarios are separated by one or
+ * more blank lines; empty groups (leading/trailing blanks) are dropped.
+ */
+export function parseGwt(body) {
+    const groups = [];
+    let current = [];
+    for (const line of body.split("\n")) {
+        if (line.trim() === "") {
+            if (current.length > 0) {
+                groups.push(current);
+                current = [];
+            }
+        }
+        else {
+            current.push(line);
+        }
+    }
+    if (current.length > 0)
+        groups.push(current);
+    return { scenarios: groups.map(parseScenario) };
+}
+//# sourceMappingURL=gwt.js.map

package/dist/shared/gwt.js.map

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