memhook 0.2.2 → 0.4.0

package/dist/src/skillsCmd.js

@@ -0,0 +1,273 @@
+/**
+ * `memhook skills install|uninstall|list` — copy the bundled companion skills
+ * (/wrap, /curate, /relay) into `~/.claude/skills/<name>/`.
+ *
+ * This is the I/O shell around the pure planner in src/skills.ts (same split as
+ * init.ts ↔ install.ts). All reads/writes/backups live here; the plan logic is
+ * pure and unit-tested. These are INTERACTIVE, user-invoked commands — not the
+ * hook path — so they may use the TTY and exit non-zero on user error
+ * (docs/SPECIFICATION.md §9). The one safety rule: never clobber a skill the
+ * user has edited without `--force`, and always back up before overwriting.
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, rmdirSync, unlinkSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createInterface } from "node:readline/promises";
+import { makeAnsi } from "./ansi.js";
+import { backupPath, stampNow } from "./backup.js";
+import { COMPANION_SKILLS, SKILL_FILES, diffSkill, planInstall, planUninstall, } from "./skills.js";
+/**
+ * Directory holding the bundled skill sources. The module lives at `src/` in
+ * dev/tests and `dist/src/` once published, so the relative depth to the
+ * package-root `skills/` differs — walk up from the module dir until we find a
+ * `skills/wrap/SKILL.md`, which is unambiguous in either layout.
+ */
+export function bundledSkillsDir() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 6; i++) {
+        const candidate = join(dir, "skills");
+        if (existsSync(join(candidate, "wrap", "SKILL.md")))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Fallback: best guess relative to the published layout (dist/src → root).
+    return fileURLToPath(new URL("../../skills/", import.meta.url));
+}
+function skillDir(home, name) {
+    return join(home, ".claude", "skills", name);
+}
+/** Read a skill's bundled files. Throws if a shipped file is missing (a packaging bug). */
+function readSources(sourceDir, name) {
+    const dir = join(sourceDir, name);
+    const out = {};
+    for (const rel of SKILL_FILES[name])
+        out[rel] = readFileSync(join(dir, rel), "utf8");
+    return out;
+}
+/** Read what's installed for a skill; a missing/unreadable file maps to `null`. */
+function readInstalled(home, name) {
+    const dir = skillDir(home, name);
+    const out = {};
+    for (const rel of SKILL_FILES[name]) {
+        try {
+            out[rel] = readFileSync(join(dir, rel), "utf8");
+        }
+        catch {
+            out[rel] = null;
+        }
+    }
+    return out;
+}
+/**
+ * Install (copy) the requested skills, backing up any file an `--force`
+ * overwrite would replace. Pure-of-prompts: callers handle confirmation + I/O
+ * reporting. Returns one result per requested skill.
+ */
+export function installCompanionSkills(opts = {}) {
+    const home = opts.home ?? homedir();
+    const sourceDir = opts.sourceDir ?? bundledSkillsDir();
+    const names = opts.names ?? [...COMPANION_SKILLS];
+    const force = opts.force ?? false;
+    const dryRun = opts.dryRun ?? false;
+    const stamp = stampNow();
+    const results = [];
+    for (const name of names) {
+        const source = readSources(sourceDir, name);
+        const installed = readInstalled(home, name);
+        const plan = planInstall(name, source, installed, { force });
+        const backedUp = [];
+        let applied = false;
+        if (!dryRun && (plan.action === "install" || plan.action === "overwrite")) {
+            const dir = skillDir(home, name);
+            for (const rel of plan.writes) {
+                const dest = join(dir, rel);
+                if (plan.action === "overwrite" && installed[rel] != null) {
+                    const bak = backupPath(dest, stamp);
+                    try {
+                        copyFileSync(dest, bak);
+                        backedUp.push(bak);
+                    }
+                    catch {
+                        /* best-effort backup; never abort the install on a backup miss */
+                    }
+                }
+                mkdirSync(dirname(dest), { recursive: true });
+                writeFileSync(dest, source[rel], "utf8");
+            }
+            applied = true;
+        }
+        results.push({ plan, applied, backedUp });
+    }
+    return results;
+}
+function makeIo(env) {
+    const ansi = makeAnsi({ isTTY: Boolean(process.stdout.isTTY), env });
+    return { out: (s) => process.stdout.write(s + "\n"), ansi };
+}
+const STATUS_LABEL = {
+    absent: "not installed",
+    identical: "installed (up to date)",
+    differs: "installed (differs from shipped)",
+};
+export async function runSkills(opts) {
+    const env = opts.env ?? process.env;
+    const io = makeIo(env);
+    const { ansi } = io;
+    const home = opts.home ?? homedir();
+    const sourceDir = opts.sourceDir ?? bundledSkillsDir();
+    const names = opts.names && opts.names.length > 0 ? opts.names : [...COMPANION_SKILLS];
+    const interactive = !opts.yes && Boolean(process.stdin.isTTY) && !opts.dryRun;
+    if (opts.subcommand === "list") {
+        io.out(ansi.bold("memhook companion skills"));
+        for (const name of names) {
+            const status = diffSkill(readSources(sourceDir, name), readInstalled(home, name));
+            const dot = status === "identical"
+                ? ansi.green("●")
+                : status === "differs"
+                    ? ansi.yellow("●")
+                    : ansi.dim("○");
+            io.out(`  ${dot} /${name} ${ansi.dim(`— ${STATUS_LABEL[status]}`)}`);
+            io.out(`      ${ansi.dim(skillDir(home, name))}`);
+        }
+        io.out(ansi.dim("\nInstall with `memhook skills install`. Invoke as /wrap, /curate, /relay."));
+        return 0;
+    }
+    if (opts.subcommand === "uninstall") {
+        const plans = names.map((name) => planUninstall(name, readSources(sourceDir, name), readInstalled(home, name)));
+        const toRemove = plans.filter((p) => p.present);
+        io.out(ansi.bold("memhook skills uninstall") + ansi.dim(" — remove bundled companion skills\n"));
+        if (toRemove.length === 0) {
+            io.out(ansi.dim("No memhook companion skills found. Nothing to do."));
+            return 0;
+        }
+        io.out(ansi.bold("Plan"));
+        for (const p of plans) {
+            if (p.present) {
+                io.out(`  ${ansi.red("-")} /${p.name} ${ansi.dim(`(${p.removes.length} file(s))`)}`);
+            }
+            else {
+                io.out(`  ${ansi.dim("·")} /${p.name} ${ansi.dim("(not installed — skip)")}`);
+            }
+        }
+        if (opts.dryRun) {
+            io.out(ansi.dim("\n(dry run — nothing removed)"));
+            return 0;
+        }
+        if (interactive && !(await confirm(ansi, "[y/N]", false))) {
+            io.out(ansi.dim("Aborted. Nothing removed."));
+            return 0;
+        }
+        const stamp = stampNow();
+        const skillsRoot = join(home, ".claude", "skills");
+        let removed = 0;
+        for (const p of toRemove) {
+            const dir = skillDir(home, p.name);
+            const source = readSources(sourceDir, p.name);
+            for (const rel of p.removes) {
+                const target = join(dir, rel);
+                // Back up only a file the user edited (differs from shipped), and place
+                // the backup OUTSIDE the skill dir so the dir can be cleanly removed. A
+                // pristine shipped file is just deleted — it's recoverable by reinstall.
+                let content = null;
+                try {
+                    content = readFileSync(target, "utf8");
+                }
+                catch {
+                    /* already gone */
+                }
+                if (content !== null && content !== source[rel]) {
+                    const bak = join(skillsRoot, `${p.name}.${rel.replace(/[\\/]/g, "_")}.bak-${stamp}`);
+                    try {
+                        copyFileSync(target, bak);
+                    }
+                    catch {
+                        /* best-effort backup */
+                    }
+                }
+                try {
+                    unlinkSync(target);
+                    removed++;
+                }
+                catch {
+                    /* already gone */
+                }
+            }
+            try {
+                rmdirSync(dir); // only succeeds if the dir is now empty — leaves user files alone
+            }
+            catch {
+                /* non-empty or missing — fine */
+            }
+        }
+        io.out(`${ansi.green("✓")} removed ${removed} file(s) from ${toRemove.length} skill(s)`);
+        io.out(ansi.dim("Restart Claude Code to drop the skills from the menu."));
+        return 0;
+    }
+    // install
+    io.out(ansi.bold("memhook skills install") + ansi.dim(" — copy /wrap, /curate, /relay\n"));
+    const preview = installCompanionSkills({
+        home,
+        sourceDir,
+        names,
+        force: opts.force,
+        dryRun: true,
+    });
+    const willWrite = preview.filter((r) => r.plan.action === "install" || r.plan.action === "overwrite");
+    const blocked = preview.filter((r) => r.plan.action === "blocked");
+    io.out(ansi.bold("Plan"));
+    for (const r of preview) {
+        const { name, action, status } = r.plan;
+        if (action === "install")
+            io.out(`  ${ansi.green("+")} /${name} ${ansi.dim("(new)")}`);
+        else if (action === "overwrite")
+            io.out(`  ${ansi.yellow("~")} /${name} ${ansi.dim("(overwrite — backup first)")}`);
+        else if (action === "skip")
+            io.out(`  ${ansi.dim("·")} /${name} ${ansi.dim("(up to date — skip)")}`);
+        else
+            io.out(`  ${ansi.yellow("!")} /${name} ${ansi.dim(`(${STATUS_LABEL[status]} — use --force to overwrite)`)}`);
+    }
+    if (willWrite.length === 0) {
+        if (blocked.length > 0) {
+            io.out(ansi.dim(`\n${blocked.length} skill(s) differ from shipped. Re-run with --force to overwrite (a backup is made first).`));
+        }
+        else {
+            io.out(ansi.dim("\nAll skills are already up to date. Nothing to do."));
+        }
+        return 0;
+    }
+    if (opts.dryRun) {
+        io.out(ansi.dim("\n(dry run — nothing written)"));
+        return 0;
+    }
+    if (interactive && !(await confirm(ansi, "[Y/n]", true))) {
+        io.out(ansi.dim("Aborted. Nothing written."));
+        return 0;
+    }
+    const results = installCompanionSkills({ home, sourceDir, names, force: opts.force });
+    const applied = results.filter((r) => r.applied);
+    io.out(`${ansi.green("✓")} installed ${applied.length} skill(s) into ${skillDir(home, "<name>")}`);
+    if (blocked.length > 0) {
+        io.out(ansi.dim(`  ${blocked.length} skill(s) left untouched (differ from shipped — use --force).`));
+    }
+    io.out(ansi.dim("Restart Claude Code, then use /wrap, /curate, /relay."));
+    return 0;
+}
+async function confirm(ansi, hint, defaultYes) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const a = (await rl.question(`\n${ansi.bold("Proceed?")} ${ansi.dim(hint)} `))
+            .trim()
+            .toLowerCase();
+        if (a === "")
+            return defaultYes;
+        return a === "y" || a === "yes";
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=skillsCmd.js.map

package/dist/src/skillsCmd.js.map

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

package/dist/src/tail.d.ts

@@ -0,0 +1,76 @@
+/**
+ * `memhook tail` — a pretty, live view of the JSONL routing log.
+ *
+ * This is the human-facing twin of `tail -f ~/.claude/logs/memhook.log | jq`:
+ * it reads the SAME frozen log the router writes (docs/SPECIFICATION.md §14 —
+ * "the memhook tail TUI parses it"), and renders each routing decision as a
+ * colourised row. It only ever READS the log, so it can never affect the hook.
+ *
+ * No TUI framework, no dependency: the layout is plain column padding + the
+ * `src/ansi.ts` styler, which degrades to clean text when stdout is not a TTY
+ * (so `memhook tail --no-follow > report.txt` is well-behaved).
+ *
+ * Pure rendering (`parseLogLine`, `formatRow`, the stats reducer) is split from
+ * the follow-loop shell so the formatting is unit-tested without a terminal.
+ */
+import { type Ansi } from "./ansi.js";
+export interface LogRow {
+    ts: string;
+    promptPreview: string;
+    selected: string[];
+    latencyMs: number;
+    tokensIn: number;
+    tokensOut: number;
+    status: string;
+    /** Provider model recorded for the entry (added v0.3); null on older lines. */
+    model: string | null;
+}
+/** Parse one JSONL line into a `LogRow`, or null if it isn't a usable entry. */
+export declare function parseLogLine(line: string): LogRow | null;
+/** HH:MM:SS from an ISO timestamp, or the raw value clipped if unparseable. */
+export declare function formatTime(ts: string): string;
+/** Compact latency: "142ms" under a second, "2.0s" above. */
+export declare function formatLatency(ms: number): string;
+/** Right-most column: which model handled the entry (mirrors the mockup). */
+export declare function modelCell(row: LogRow): string;
+/**
+ * Render one log row to one or two lines: the primary row (time · status ·
+ * prompt · latency · model) plus, when memories were injected, a dim secondary
+ * line listing them — the whole reason memhook exists is to see WHICH memories
+ * were picked.
+ */
+export declare function formatRow(row: LogRow, ansi: Ansi, columns?: number): string;
+export interface Stats {
+    count: number;
+    byStatus: Record<string, number>;
+    latencies: number[];
+}
+export declare function emptyStats(): Stats;
+export declare function accumulate(stats: Stats, row: LogRow): void;
+export interface StatsSummary {
+    count: number;
+    cachePct: number;
+    okPct: number;
+    p50: number;
+    p95: number;
+}
+export declare function summarize(stats: Stats): StatsSummary;
+export interface HeaderInfo {
+    version: string;
+    provider: string;
+    model: string;
+    logPath: string;
+    follow: boolean;
+}
+export declare function formatHeader(info: HeaderInfo, ansi: Ansi, columns?: number): string;
+export declare function formatFooter(stats: Stats, ansi: Ansi, columns?: number): string;
+/** Last `n` non-empty lines of `text`. */
+export declare function tailLines(text: string, n: number): string[];
+export interface TailOptions {
+    file?: string | undefined;
+    lines: number;
+    noFollow: boolean;
+    status?: string[] | undefined;
+}
+export declare function runTail(opts: TailOptions, env?: NodeJS.ProcessEnv): Promise<number>;
+//# sourceMappingURL=tail.d.ts.map

package/dist/src/tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.d.ts","sourceRoot":"","sources":["../../src/tail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAwC,KAAK,IAAI,EAAkB,MAAM,WAAW,CAAC;AAI5F,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAMD,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBxD;AA6BD,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM7C;AAKD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,SAAK,GAAG,MAAM,CAuBvE;AAID,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,UAAU,IAAI,KAAK,CAElC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAM1D;AAQD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAYpD;AAQD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,SAAK,GAAG,MAAM,CAY/E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,SAAK,GAAG,MAAM,CAW3E;AAID,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAG3D;AAQD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC/B;AAoBD,wBAAsB,OAAO,CAC3B,IAAI,EAAE,WAAW,EACjB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,MAAM,CAAC,CA4EjB"}

package/dist/src/tail.js

@@ -0,0 +1,280 @@
+/**
+ * `memhook tail` — a pretty, live view of the JSONL routing log.
+ *
+ * This is the human-facing twin of `tail -f ~/.claude/logs/memhook.log | jq`:
+ * it reads the SAME frozen log the router writes (docs/SPECIFICATION.md §14 —
+ * "the memhook tail TUI parses it"), and renders each routing decision as a
+ * colourised row. It only ever READS the log, so it can never affect the hook.
+ *
+ * No TUI framework, no dependency: the layout is plain column padding + the
+ * `src/ansi.ts` styler, which degrades to clean text when stdout is not a TTY
+ * (so `memhook tail --no-follow > report.txt` is well-behaved).
+ *
+ * Pure rendering (`parseLogLine`, `formatRow`, the stats reducer) is split from
+ * the follow-loop shell so the formatting is unit-tested without a terminal.
+ */
+import { existsSync, openSync, readSync, closeSync, readFileSync, statSync } from "node:fs";
+import { loadConfig } from "./config.js";
+import { MEMHOOK_VERSION } from "./version.js";
+import { makeAnsi, padStart, padEnd, truncate } from "./ansi.js";
+function asInt(v) {
+    return typeof v === "number" && Number.isFinite(v) ? Math.floor(v) : 0;
+}
+/** Parse one JSONL line into a `LogRow`, or null if it isn't a usable entry. */
+export function parseLogLine(line) {
+    let obj;
+    try {
+        obj = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    if (typeof obj !== "object" || obj === null || Array.isArray(obj))
+        return null;
+    const o = obj;
+    if (typeof o["status"] !== "string")
+        return null;
+    const selected = Array.isArray(o["selected"])
+        ? o["selected"].filter((x) => typeof x === "string")
+        : [];
+    return {
+        ts: typeof o["ts"] === "string" ? o["ts"] : "",
+        promptPreview: typeof o["prompt_preview"] === "string" ? o["prompt_preview"] : "",
+        selected,
+        latencyMs: asInt(o["latency_ms"]),
+        tokensIn: asInt(o["tokens_in"]),
+        tokensOut: asInt(o["tokens_out"]),
+        status: o["status"],
+        model: typeof o["model"] === "string" ? o["model"] : null,
+    };
+}
+const STATUS_STYLE = {
+    ok: { label: "ok", color: "green" },
+    cache_hit: { label: "cache", color: "cyan" },
+    pre_filter_skip: { label: "skip", color: "gray" },
+    empty_selection: { label: "empty", color: "yellow" },
+    all_unfound: { label: "unfound", color: "yellow" },
+    no_catalog: { label: "no catalog", color: "red" },
+    no_api_key: { label: "no key", color: "red" },
+    api_no_response: { label: "api err", color: "red" },
+    api_no_content: { label: "api err", color: "red" },
+    parse_invalid: { label: "bad json", color: "red" },
+    provider_init_failed: { label: "init err", color: "red" },
+};
+function styleFor(status) {
+    return STATUS_STYLE[status] ?? { label: status, color: "gray" };
+}
+const STATUS_W = Math.max(...Object.values(STATUS_STYLE).map((s) => s.label.length));
+/** HH:MM:SS from an ISO timestamp, or the raw value clipped if unparseable. */
+export function formatTime(ts) {
+    const m = ts.match(/T(\d{2}:\d{2}:\d{2})/);
+    return m?.[1] ?? truncate(ts, 8).padEnd(8);
+}
+/** Compact latency: "142ms" under a second, "2.0s" above. */
+export function formatLatency(ms) {
+    if (ms <= 0)
+        return "0ms";
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+/** Right-most column: which model handled the entry (mirrors the mockup). */
+export function modelCell(row) {
+    if (row.status === "pre_filter_skip")
+        return "dropped";
+    if (row.status === "cache_hit")
+        return "—";
+    // Statuses that never reached the provider have no model to show.
+    if (row.status === "no_catalog" || row.status === "no_api_key")
+        return "—";
+    return row.model ?? "—";
+}
+const LAT_W = 6;
+const MODEL_W = 18;
+/**
+ * Render one log row to one or two lines: the primary row (time · status ·
+ * prompt · latency · model) plus, when memories were injected, a dim secondary
+ * line listing them — the whole reason memhook exists is to see WHICH memories
+ * were picked.
+ */
+export function formatRow(row, ansi, columns = 80) {
+    const st = styleFor(row.status);
+    const time = ansi.dim(formatTime(row.ts));
+    const status = ansi.style(st.color, padEnd(st.label, STATUS_W));
+    const latency = ansi.dim(padStart(formatLatency(row.latencyMs), LAT_W));
+    const model = ansi.dim(truncate(modelCell(row), MODEL_W));
+    // Prompt preview fills the space left between the fixed columns. The budget
+    // is constant per row (5 two-col gaps + time + status + latency + a reserved
+    // model column) so latency and model line up vertically across every row —
+    // the preview never borrows from the model column's width.
+    const fixed = 2 * 5 + 8 + STATUS_W + LAT_W + MODEL_W;
+    const previewW = Math.max(12, columns - fixed);
+    const preview = row.promptPreview
+        ? ansi.style("white", `"${truncate(row.promptPreview, previewW - 2)}"`)
+        : ansi.dim('""');
+    const main = `  ${time}  ${status}  ${padEnd(preview, previewW)}  ${latency}  ${model}`;
+    if (row.selected.length === 0)
+        return main;
+    const trimmed = row.selected.map((f) => f.replace(/\.md$/, ""));
+    const files = ansi.dim(`     ↳ ${truncate(trimmed.join(" · "), Math.max(20, columns - 8))}`);
+    return `${main}\n${files}`;
+}
+export function emptyStats() {
+    return { count: 0, byStatus: {}, latencies: [] };
+}
+export function accumulate(stats, row) {
+    stats.count++;
+    stats.byStatus[row.status] = (stats.byStatus[row.status] ?? 0) + 1;
+    // Percentiles only over rows that actually called the provider (skips/cache
+    // hits sit near 0ms and would flatten the distribution).
+    if (row.latencyMs > 0)
+        stats.latencies.push(row.latencyMs);
+}
+function percentile(sorted, p) {
+    if (sorted.length === 0)
+        return 0;
+    const idx = Math.min(sorted.length - 1, Math.ceil((p / 100) * sorted.length) - 1);
+    return sorted[Math.max(0, idx)] ?? 0;
+}
+export function summarize(stats) {
+    const ok = stats.byStatus["ok"] ?? 0;
+    const cache = stats.byStatus["cache_hit"] ?? 0;
+    const delivered = ok + cache;
+    const sorted = [...stats.latencies].sort((a, b) => a - b);
+    return {
+        count: stats.count,
+        cachePct: delivered > 0 ? Math.round((cache / delivered) * 100) : 0,
+        okPct: stats.count > 0 ? Math.round((delivered / stats.count) * 100) : 0,
+        p50: percentile(sorted, 50),
+        p95: percentile(sorted, 95),
+    };
+}
+// ── header / footer ──────────────────────────────────────────────────────────
+function divider(ansi, columns) {
+    return ansi.dim("  " + "─".repeat(Math.max(10, Math.min(columns - 2, 72))));
+}
+export function formatHeader(info, ansi, columns = 80) {
+    const live = info.follow ? ansi.green("● live") : ansi.dim("○ snapshot");
+    const title = ansi.bold("memhook");
+    const who = ansi.dim(`${info.provider} · ${info.model}`);
+    const ver = ansi.dim(`v${info.version}`);
+    const lines = [
+        `  ${title}  ${live}    ${who}    ${ver}`,
+        ansi.dim(`  ${info.logPath}`),
+        divider(ansi, columns),
+    ];
+    if (info.follow)
+        lines.push(ansi.dim("  ⌃C to quit"));
+    return lines.join("\n");
+}
+export function formatFooter(stats, ansi, columns = 80) {
+    const s = summarize(stats);
+    const noun = s.count === 1 ? "prompt" : "prompts";
+    const parts = [
+        ansi.bold(`${s.count} ${noun}`),
+        `${s.cachePct}% cache`,
+        `${s.okPct}% delivered`,
+        `p50 ${s.p50}ms`,
+        `p95 ${s.p95}ms`,
+    ];
+    return `${divider(ansi, columns)}\n  ${parts.join(ansi.dim(" · "))}`;
+}
+// ── pure helpers shared with the follow loop ────────────────────────────────
+/** Last `n` non-empty lines of `text`. */
+export function tailLines(text, n) {
+    const lines = text.split("\n").filter((l) => l.trim() !== "");
+    return n >= lines.length ? lines : lines.slice(lines.length - n);
+}
+function passesFilter(row, filter) {
+    return filter === null || filter.has(row.status);
+}
+const POLL_MS = 300;
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+/** Read `len` bytes at `offset` from `path` as utf8 (best-effort). */
+function readChunk(path, offset, len) {
+    const fd = openSync(path, "r");
+    try {
+        const buf = Buffer.alloc(len);
+        const read = readSync(fd, buf, 0, len, offset);
+        return buf.toString("utf8", 0, read);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+export async function runTail(opts, env = process.env) {
+    const config = loadConfig(env);
+    const logPath = opts.file ?? config.logging.jsonlPath;
+    const ansi = makeAnsi({ isTTY: Boolean(process.stdout.isTTY), env });
+    const columns = process.stdout.columns ?? 80;
+    const filter = opts.status && opts.status.length > 0 ? new Set(opts.status) : null;
+    const out = (s) => void process.stdout.write(s + "\n");
+    out(formatHeader({
+        version: MEMHOOK_VERSION,
+        provider: config.provider.type,
+        model: config.provider.model,
+        logPath,
+        follow: !opts.noFollow,
+    }, ansi, columns));
+    const stats = emptyStats();
+    const render = (line) => {
+        const row = parseLogLine(line);
+        if (!row)
+            return;
+        accumulate(stats, row);
+        if (passesFilter(row, filter))
+            out(formatRow(row, ansi, columns));
+    };
+    // Initial tail of the existing log.
+    if (existsSync(logPath)) {
+        for (const line of tailLines(readFileSync(logPath, "utf8"), opts.lines))
+            render(line);
+    }
+    if (opts.noFollow) {
+        out(formatFooter(stats, ansi, columns));
+        return 0;
+    }
+    // Follow by polling (robust + cross-platform; fs.watch semantics vary by OS).
+    let stop = false;
+    const stopped = new Promise((resolve) => {
+        process.once("SIGINT", () => {
+            stop = true;
+            resolve();
+        });
+    });
+    if (!existsSync(logPath))
+        out(ansi.dim("  waiting for the first prompt…"));
+    let offset = existsSync(logPath) ? statSync(logPath).size : 0;
+    let buffer = "";
+    while (!stop) {
+        await Promise.race([sleep(POLL_MS), stopped]);
+        if (stop)
+            break;
+        try {
+            if (!existsSync(logPath))
+                continue;
+            const size = statSync(logPath).size;
+            if (size < offset) {
+                offset = 0; // truncated / rotated
+                buffer = "";
+            }
+            if (size > offset) {
+                buffer += readChunk(logPath, offset, size - offset);
+                offset = size;
+                const parts = buffer.split("\n");
+                buffer = parts.pop() ?? "";
+                for (const line of parts)
+                    if (line.trim() !== "")
+                        render(line);
+            }
+        }
+        catch {
+            // Transient (file rotated out from under us) — retry next tick.
+        }
+    }
+    out("\n" + formatFooter(stats, ansi, columns));
+    return 0;
+}
+//# sourceMappingURL=tail.js.map