waterplane 0.0.1 → 0.1.6

package/packages/host/dist/capture.d.ts

@@ -0,0 +1,116 @@
+/**
+ * The verified capture loop — "show me what that screen looks like right now,
+ * and say how much the picture can be trusted".
+ *
+ * A capture is a BUILD with a picture at the end of it, and this file is
+ * `builds.ts` with one extra half bolted on. The targets live per repo in
+ * `<repoDir>/<state dir>/capture.json`, the sibling of `builds.json`; a run IS an
+ * intent (so `runId` is the intent id, the row is on disk before the tap
+ * returns, and a restart accounts for it); the frames land in `.claude/outbox/`
+ * through the same `newOutboxPath` every other artifact uses, which is why they
+ * flow through the gallery, the badge, thumbnails and the download button with
+ * no new plumbing at either end.
+ *
+ * The extra half is the CLAIM. Everything below exists to keep one rule:
+ *
+ * ── verify → settle → diff → emit ──────────────────────────────────────────
+ *
+ *   VERIFY — ask the running thing what is on its screen (`oracle()`). The word
+ *     "verified" is reserved for that reading: `verified:anchor` and nothing
+ *     else. A backend with no oracle — `capture/window.ts`, a grab of somebody
+ *     else's window — can never reach it, however good the picture is.
+ *   SETTLE — sample until two consecutive frames agree. `settleMs` is a CAP on
+ *     how long that is worth waiting, NEVER a sleep: a fixed sleep is both too
+ *     long for a static page and too short for a slow one, and it produces a
+ *     frame nobody can say anything about. One frame with nothing to compare it
+ *     against is `unverified`, on every backend.
+ *   DIFF — in watch mode, a new frame is only worth a FILE if it differs. This
+ *     is token hygiene, not disk hygiene: every frame in the outbox is a frame
+ *     an agent may be handed on some later turn, and 60 near-identical
+ *     screenshots of one screen is a context bill nobody chose to pay.
+ *   EMIT — write the PNG and the sidecar. Including for a FAILED run: a frame
+ *     of a red error overlay is the failure's evidence, and deleting it leaves
+ *     somebody on a phone with a verdict and nothing to look at.
+ *
+ * ── Degrade to absent, never to a wrong number ─────────────────────────────
+ *
+ * `sharp` is banned repo-wide and node has no image decoder, so every pixel
+ * measurement is a subprocess that may not exist (`capture/pixels.ts`). With no
+ * ImageMagick there is no `score`, no blank check and no measured `changedPct`
+ * — the sidecar leaves them ABSENT and the verdict prints `n/a`. In watch mode
+ * the diff GATE degrades the other way, to "emit every frame, capped, and SAY
+ * that is what happened", because a gate that silently emits nothing is a
+ * feature that looks broken.
+ *
+ * ── Capture never starts a dev server ──────────────────────────────────────
+ *
+ * Nothing applies itself. A url that does not answer is a refusal in words
+ * naming the Build sheet as the way to start one.
+ */
+import { EventEmitter } from "node:events";
+import type { CaptureRun, CaptureTarget, Intent } from "@waterplane/shared";
+import type { ExecutorResult, IntentManager } from "./intents/manager.js";
+export { diffRecord, shouldEmit, verdictLine, verificationLevel } from "./capture/captureverdict.js";
+export type { EmitInput, VerdictInput, VerificationInput } from "./capture/captureverdict.js";
+export { classifyOverlay, cleanTarget, probeCaptureBackends } from "./capture/captureconfig.js";
+export type { CleanTargetResult } from "./capture/captureconfig.js";
+export { intentToCaptureRun } from "./capture/capturehelpers.js";
+export interface CaptureEvents {
+    output: (runId: string, chunk: string) => void;
+}
+export declare class CaptureManager extends EventEmitter {
+    private intents;
+    private output;
+    private canceled;
+    private live;
+    constructor(intents: IntentManager);
+    private configPath;
+    /** The raw rows as they are on disk, so a refusal can quote the one that is wrong. */
+    private readRaw;
+    /** A repo's configured capture targets (empty if none/unreadable). */
+    list(repoDir: string): CaptureTarget[];
+    /** Persist a repo's whole target list; returns the cleaned list actually written. */
+    save(repoDir: string, targets: CaptureTarget[]): CaptureTarget[];
+    /** This repo's runs, newest first — rendered from the rows that are them. */
+    runsFor(repoDir: string): CaptureRun[];
+    getOutput(runId: string): string;
+    /**
+     * Resolve one target and its working dir, or answer the sentence saying why
+     * not. Shared by `run()` (so a refusal reaches the phone while there is still
+     * a socket to tell) and `execute()` (so a config edited in between is caught
+     * rather than run from a stale snapshot).
+     */
+    private resolveTarget;
+    /**
+     * Run one configured target now.
+     *
+     * Everything knowable synchronously is refused synchronously — unknown
+     * target, unknown backend (naming the known ids), a working dir outside the
+     * repo, a half-configured target — because a refusal minutes later inside an
+     * executor reaches a phone that has moved on.
+     */
+    run(repoDir: string, targetId: string, watch?: boolean): CaptureRun | {
+        error: string;
+    };
+    /**
+     * Call a run off — null when it was called off, and otherwise the SENTENCE
+     * saying why it could not be.
+     *
+     * `this.live` only knows about runs THIS process is executing right now, and
+     * it used to be the whole answer: anything else got `false`, which the route
+     * worded as "that capture has already finished". That is untrue of a row that
+     * has been posted and is still waiting its turn — a cancel for it was
+     * silently dropped and the run then went ahead. So a run that is not live is
+     * handed to the intent store, which is where a not-yet-started row lives and
+     * which can genuinely settle it `canceled`.
+     *
+     * A live run is flagged rather than killed: the loop checks between frames,
+     * so a watch run stops at a frame boundary rather than mid-write.
+     */
+    cancel(runId: string): string | null;
+    /** The executor. Resolves when the frames are written and the sidecar is on disk. */
+    execute(i: Intent): Promise<ExecutorResult>;
+    /** verify → settle → diff → emit, once per pass — `capture/capturepass.ts`. */
+    private capture;
+    private append;
+}

package/packages/host/dist/capture.js

@@ -0,0 +1,295 @@
+/**
+ * The verified capture loop — "show me what that screen looks like right now,
+ * and say how much the picture can be trusted".
+ *
+ * A capture is a BUILD with a picture at the end of it, and this file is
+ * `builds.ts` with one extra half bolted on. The targets live per repo in
+ * `<repoDir>/<state dir>/capture.json`, the sibling of `builds.json`; a run IS an
+ * intent (so `runId` is the intent id, the row is on disk before the tap
+ * returns, and a restart accounts for it); the frames land in `.claude/outbox/`
+ * through the same `newOutboxPath` every other artifact uses, which is why they
+ * flow through the gallery, the badge, thumbnails and the download button with
+ * no new plumbing at either end.
+ *
+ * The extra half is the CLAIM. Everything below exists to keep one rule:
+ *
+ * ── verify → settle → diff → emit ──────────────────────────────────────────
+ *
+ *   VERIFY — ask the running thing what is on its screen (`oracle()`). The word
+ *     "verified" is reserved for that reading: `verified:anchor` and nothing
+ *     else. A backend with no oracle — `capture/window.ts`, a grab of somebody
+ *     else's window — can never reach it, however good the picture is.
+ *   SETTLE — sample until two consecutive frames agree. `settleMs` is a CAP on
+ *     how long that is worth waiting, NEVER a sleep: a fixed sleep is both too
+ *     long for a static page and too short for a slow one, and it produces a
+ *     frame nobody can say anything about. One frame with nothing to compare it
+ *     against is `unverified`, on every backend.
+ *   DIFF — in watch mode, a new frame is only worth a FILE if it differs. This
+ *     is token hygiene, not disk hygiene: every frame in the outbox is a frame
+ *     an agent may be handed on some later turn, and 60 near-identical
+ *     screenshots of one screen is a context bill nobody chose to pay.
+ *   EMIT — write the PNG and the sidecar. Including for a FAILED run: a frame
+ *     of a red error overlay is the failure's evidence, and deleting it leaves
+ *     somebody on a phone with a verdict and nothing to look at.
+ *
+ * ── Degrade to absent, never to a wrong number ─────────────────────────────
+ *
+ * `sharp` is banned repo-wide and node has no image decoder, so every pixel
+ * measurement is a subprocess that may not exist (`capture/pixels.ts`). With no
+ * ImageMagick there is no `score`, no blank check and no measured `changedPct`
+ * — the sidecar leaves them ABSENT and the verdict prints `n/a`. In watch mode
+ * the diff GATE degrades the other way, to "emit every frame, capped, and SAY
+ * that is what happened", because a gate that silently emits nothing is a
+ * feature that looks broken.
+ *
+ * ── Capture never starts a dev server ──────────────────────────────────────
+ *
+ * Nothing applies itself. A url that does not answer is a refusal in words
+ * naming the Build sheet as the way to start one.
+ */
+import { EventEmitter } from "node:events";
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+import { BRAND, isCaptureRow } from "@waterplane/shared";
+import { repoStateDir } from "./branddirs.js";
+import { contained } from "./paths.js";
+import { BACKENDS, ENABLED, MAX_RUNS, OFF_TEXT, OUT_RING } from "./capture/capturekit.js";
+import { cleanTarget, probeCaptureBackends } from "./capture/captureconfig.js";
+import { intentToCaptureRun, withLease } from "./capture/capturehelpers.js";
+import { runCapturePass } from "./capture/capturepass.js";
+import { writeJsonAtomic } from "./jsonstore.js";
+// The slices, re-exported so no importer changes (`capture/capture*.ts`).
+export { diffRecord, shouldEmit, verdictLine, verificationLevel } from "./capture/captureverdict.js";
+export { classifyOverlay, cleanTarget, probeCaptureBackends } from "./capture/captureconfig.js";
+export { intentToCaptureRun } from "./capture/capturehelpers.js";
+export class CaptureManager extends EventEmitter {
+    intents;
+    output = new Map();
+    canceled = new Set();
+    live = new Set();
+    constructor(intents) {
+        super();
+        this.intents = intents;
+    }
+    configPath(repoDir) { return join(repoStateDir(repoDir), "capture.json"); }
+    /** The raw rows as they are on disk, so a refusal can quote the one that is wrong. */
+    readRaw(repoDir) {
+        try {
+            const doc = JSON.parse(readFileSync(this.configPath(repoDir), "utf8"));
+            const arr = Array.isArray(doc) ? doc : doc?.targets;
+            return Array.isArray(arr) ? arr : [];
+        }
+        catch {
+            return []; // no file / bad json → no targets
+        }
+    }
+    /** A repo's configured capture targets (empty if none/unreadable). */
+    list(repoDir) {
+        const out = [];
+        this.readRaw(repoDir).forEach((v, i) => {
+            const c = cleanTarget(v, i);
+            if (c.ok)
+                out.push(c.target);
+        });
+        return out;
+    }
+    /** Persist a repo's whole target list; returns the cleaned list actually written. */
+    save(repoDir, targets) {
+        const clean = [];
+        (Array.isArray(targets) ? targets : []).forEach((v, i) => {
+            const c = cleanTarget(v, i);
+            if (c.ok)
+                clean.push(c.target);
+        });
+        try {
+            const path = this.configPath(repoDir);
+            mkdirSync(dirname(path), { recursive: true });
+            writeJsonAtomic(path, { version: 1, targets: clean }, { space: 2 });
+        }
+        catch { /* best-effort, exactly like builds.ts */ }
+        return clean;
+    }
+    /** This repo's runs, newest first — rendered from the rows that are them. */
+    runsFor(repoDir) {
+        return this.intents.list()
+            .filter((i) => isCaptureRow(i) && i.cwd === repoDir)
+            .slice(0, MAX_RUNS)
+            .map(intentToCaptureRun);
+    }
+    getOutput(runId) { return this.output.get(runId) ?? ""; }
+    /**
+     * Resolve one target and its working dir, or answer the sentence saying why
+     * not. Shared by `run()` (so a refusal reaches the phone while there is still
+     * a socket to tell) and `execute()` (so a config edited in between is caught
+     * rather than run from a stale snapshot).
+     */
+    resolveTarget(repoDir, targetId) {
+        const raw = this.readRaw(repoDir);
+        for (let i = 0; i < raw.length; i++) {
+            const row = raw[i];
+            if (!row || typeof row !== "object" || row.id !== targetId)
+                continue;
+            const c = cleanTarget(row, i);
+            if (!c.ok)
+                return { error: c.reason };
+            const root = resolve(repoDir);
+            let cwd = root;
+            if (c.target.dir) {
+                const full = contained(root, c.target.dir);
+                if (full === null)
+                    return { error: `"${c.target.dir}" is outside this repo.` };
+                if (!existsSync(full))
+                    return { error: `working dir "${c.target.dir}" does not exist in this repo.` };
+                cwd = full;
+            }
+            return { target: c.target, cwd };
+        }
+        return { error: `there is no capture target "${targetId}" in ${basename(dirname(this.configPath(repoDir)))}/capture.json any more.` };
+    }
+    /**
+     * Run one configured target now.
+     *
+     * Everything knowable synchronously is refused synchronously — unknown
+     * target, unknown backend (naming the known ids), a working dir outside the
+     * repo, a half-configured target — because a refusal minutes later inside an
+     * executor reaches a phone that has moved on.
+     */
+    run(repoDir, targetId, watch) {
+        if (!ENABLED)
+            return { error: OFF_TEXT };
+        const r = this.resolveTarget(repoDir, targetId);
+        if ("error" in r)
+            return { error: r.error };
+        const bad = BACKENDS[r.target.backend].validate(r.target);
+        if (bad)
+            return { error: bad };
+        const runId = "cr_" + randomUUID().slice(0, 8);
+        const payload = {
+            kind: "capture",
+            targetId: r.target.id,
+            name: r.target.name,
+            backend: r.target.backend,
+            watch: watch === true ? true : undefined,
+        };
+        const posted = this.intents.post({
+            id: runId,
+            cwd: repoDir,
+            payload,
+            target: { kind: "shell" },
+            trigger: { kind: "now" },
+            title: r.target.name,
+        });
+        if (!posted.ok || !posted.intent)
+            return { error: posted.reason || "could not be written down" };
+        return intentToCaptureRun(posted.intent);
+    }
+    /**
+     * Call a run off — null when it was called off, and otherwise the SENTENCE
+     * saying why it could not be.
+     *
+     * `this.live` only knows about runs THIS process is executing right now, and
+     * it used to be the whole answer: anything else got `false`, which the route
+     * worded as "that capture has already finished". That is untrue of a row that
+     * has been posted and is still waiting its turn — a cancel for it was
+     * silently dropped and the run then went ahead. So a run that is not live is
+     * handed to the intent store, which is where a not-yet-started row lives and
+     * which can genuinely settle it `canceled`.
+     *
+     * A live run is flagged rather than killed: the loop checks between frames,
+     * so a watch run stops at a frame boundary rather than mid-write.
+     */
+    cancel(runId) {
+        if (this.live.has(runId)) {
+            this.canceled.add(runId);
+            return null;
+        }
+        const row = this.intents.get(runId);
+        if (!row)
+            return "there is no capture run by that id any more.";
+        if (row.state === "done" || row.state === "failed")
+            return "that capture has already finished.";
+        if (row.state === "canceled")
+            return "that capture was already called off.";
+        if (this.intents.cancel(runId, "capture called off from the phone"))
+            return null;
+        // `starting`/`running` but not in `live`: the executor belongs to a process
+        // that is gone (a restart mid-run). Nothing here can reach it.
+        return "that capture is already under way and cannot be called off from here.";
+    }
+    /** The executor. Resolves when the frames are written and the sidecar is on disk. */
+    async execute(i) {
+        const p = i.payload.kind === "capture" ? i.payload : null;
+        if (!p)
+            return { ok: false, detail: "that row is not a capture" };
+        if (!ENABLED)
+            return { ok: false, detail: OFF_TEXT };
+        const runId = i.id;
+        this.output.set(runId, "");
+        this.canceled.delete(runId);
+        this.live.add(runId);
+        const log = (line) => {
+            const chunk = `${line}\r\n`;
+            this.append(runId, chunk);
+            this.emit("output", runId, chunk);
+        };
+        try {
+            const r = this.resolveTarget(i.cwd, p.targetId);
+            if ("error" in r) {
+                log(`[capture] ${r.error}`);
+                return { ok: false, detail: r.error };
+            }
+            const backend = BACKENDS[r.target.backend];
+            const bad = backend.validate(r.target);
+            if (bad) {
+                log(`[capture] ${bad}`);
+                return { ok: false, detail: bad };
+            }
+            // Through the CACHE, not `backend.probe()` directly: a cold ciqkit probe
+            // shells out to python, and asking it again per run — moments after the
+            // sheet that started the run already asked — pays for the same answer
+            // twice. `probeCaptureBackends` is the one place the 30 s TTL lives.
+            const avail = (await probeCaptureBackends(r.cwd)).find((b) => b.id === r.target.backend);
+            if (!avail || !avail.available) {
+                const why = avail?.reason ?? `the ${r.target.backend} backend is not available here.`;
+                log(`[capture] ${why}`);
+                return { ok: false, detail: why };
+            }
+            let tmpDir;
+            try {
+                tmpDir = mkdtempSync(join(tmpdir(), `${BRAND.slug}-capture-${runId}-`));
+            }
+            catch (e) {
+                return { ok: false, detail: `no scratch dir for the frames: ${String(e?.message ?? e)}` };
+            }
+            try {
+                return await withLease(backend.leaseKey(r.target), () => this.capture(i, r.target, backend, r.cwd, tmpDir, !!p.watch, log));
+            }
+            finally {
+                try {
+                    rmSync(tmpDir, { recursive: true, force: true });
+                }
+                catch { /* best-effort */ }
+            }
+        }
+        catch (e) {
+            const why = String(e?.message ?? e);
+            log(`[capture] ${why}`);
+            return { ok: false, detail: why };
+        }
+        finally {
+            this.live.delete(runId);
+            this.canceled.delete(runId);
+        }
+    }
+    /** verify → settle → diff → emit, once per pass — `capture/capturepass.ts`. */
+    capture(i, target, backend, cwd, tmpDir, watch, log) {
+        return runCapturePass(this.canceled, i, target, backend, cwd, tmpDir, watch, log);
+    }
+    append(runId, chunk) {
+        const cur = (this.output.get(runId) ?? "") + chunk;
+        this.output.set(runId, cur.length > OUT_RING ? cur.slice(-OUT_RING) : cur);
+    }
+}
+//# sourceMappingURL=capture.js.map

package/packages/host/dist/capture.js.map

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

package/packages/host/dist/claudebin.d.ts

@@ -0,0 +1,32 @@
+export type ClaudeBinSource = "env" | "path" | "found";
+export interface ClaudeBinResult {
+    bin: string;
+    source: ClaudeBinSource;
+    /** Every location checked, in order (empty when the knob or PATH decided). */
+    tried: string[];
+    /** Under WSL, nothing on the Linux side, but Claude is installed on Windows: that path. Never used as `bin`. */
+    windowsSide?: string;
+    /** Nothing resolved: no knob, not on PATH, no candidate exists. `bin` is then the bare `claude` fallback, which will not spawn. */
+    missing?: true;
+}
+export interface ClaudeBinFacts {
+    /** The `WATERPLANE_CLAUDE_BIN` knob. */
+    knob?: string;
+    /** Process env (`npm_config_prefix`, `APPDATA`, `USERPROFILE`). */
+    env?: Record<string, string | undefined>;
+    platform: NodeJS.Platform;
+    home: string;
+    exists: (p: string) => boolean;
+    /** Is this command name resolvable through PATH. */
+    onPath: (name: string) => boolean;
+    /** Directory entries, [] when unreadable. */
+    readdir?: (p: string) => string[];
+    wsl?: boolean;
+}
+export declare function findClaudeBin(f: ClaudeBinFacts): ClaudeBinResult;
+/** `/home/me/x` → `~/x`. */
+export declare const tilde: (s: string, home: string) => string;
+/** The real machine's PATH, scanned synchronously. */
+export declare function pathHas(name: string, platform: NodeJS.Platform): boolean;
+/** Resolved once per process from the real machine (the knob is read live by `claudeBin()`, not here). */
+export declare function claudeBinResolution(): ClaudeBinResult;

package/packages/host/dist/claudebin.js

@@ -0,0 +1,113 @@
+/**
+ * Where the `claude` binary is — found, so the person does not have to.
+ *
+ * A first install had Claude Code installed but not on PATH (the native
+ * installer drops it in `~/.local/bin`, which a fresh shell may not list), and a
+ * launchd/systemd service starts with a minimal PATH on top of that. The host
+ * said "make sure it's on PATH" — a chore it can do itself. Order: the knob
+ * (`WATERPLANE_CLAUDE_BIN`), then `claude` on PATH, then the usual install
+ * locations, then plain `claude` (unchanged behaviour) with what was tried.
+ *
+ * Pure: every fact is injected (`exists`, `onPath`, `readdir`), so tests never
+ * touch the real filesystem. Synchronous checks only — no child process.
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { homedir, release } from "node:os";
+import path from "node:path";
+import { isWsl } from "./doctorwsl.js";
+const verDesc = (a, b) => {
+    const n = (s) => s.replace(/^v/, "").split(".").map((x) => Number(x) || 0);
+    const [x, y] = [n(a), n(b)];
+    for (let i = 0; i < 3; i++)
+        if ((y[i] ?? 0) !== (x[i] ?? 0))
+            return (y[i] ?? 0) - (x[i] ?? 0);
+    return 0;
+};
+export function findClaudeBin(f) {
+    if (f.knob)
+        return { bin: f.knob, source: "env", tried: [] };
+    if (f.onPath("claude"))
+        return { bin: "claude", source: "path", tried: [] };
+    const win = f.platform === "win32";
+    const p = win ? path.win32 : path.posix;
+    const env = f.env ?? {};
+    const ls = f.readdir ?? (() => []);
+    const cands = [];
+    if (win) {
+        if (env.APPDATA)
+            cands.push(p.join(env.APPDATA, "npm", "claude.cmd"));
+        cands.push(p.join(env.USERPROFILE || f.home, ".local", "bin", "claude.exe"));
+    }
+    else {
+        cands.push(p.join(f.home, ".local", "bin", "claude"), p.join(f.home, ".claude", "local", "claude"), "/opt/homebrew/bin/claude", "/usr/local/bin/claude", p.join(f.home, ".npm-global", "bin", "claude"));
+        if (env.npm_config_prefix)
+            cands.push(p.join(env.npm_config_prefix, "bin", "claude"));
+        cands.push(p.join(f.home, ".volta", "bin", "claude"), p.join(f.home, ".bun", "bin", "claude"));
+        const nvm = p.join(f.home, ".nvm", "versions", "node");
+        for (const v of [...ls(nvm)].sort(verDesc))
+            cands.push(p.join(nvm, v, "bin", "claude"));
+        const fnm = p.join(f.home, ".local", "share", "fnm", "node-versions");
+        for (const v of [...ls(fnm)].sort(verDesc))
+            cands.push(p.join(fnm, v, "installation", "bin", "claude"));
+    }
+    const tried = [];
+    for (const c of cands) {
+        tried.push(c);
+        if (f.exists(c))
+            return { bin: c, source: "found", tried };
+    }
+    const out = { bin: "claude", source: "path", tried, missing: true };
+    if (f.wsl && !win) {
+        for (const u of ls("/mnt/c/Users")) {
+            for (const rel of ["AppData/Roaming/npm/claude.cmd", ".local/bin/claude.exe"]) {
+                const w = `/mnt/c/Users/${u}/${rel}`;
+                if (f.exists(w)) {
+                    out.windowsSide = w;
+                    return out;
+                }
+            }
+        }
+    }
+    return out;
+}
+/** `/home/me/x` → `~/x`. */
+export const tilde = (s, home) => home && (s === home || s.startsWith(home + "/") || s.startsWith(home + "\\")) ? "~" + s.slice(home.length) : s;
+/** The real machine's PATH, scanned synchronously. */
+export function pathHas(name, platform) {
+    const win = platform === "win32";
+    const dirs = (process.env.PATH ?? "").split(win ? ";" : ":").filter(Boolean);
+    const names = win ? [`${name}.exe`, `${name}.cmd`, name] : [name];
+    return dirs.some((d) => names.some((n) => existsSync(path.join(d, n))));
+}
+const safeLs = (p) => { try {
+    return readdirSync(p);
+}
+catch {
+    return [];
+} };
+const safeRead = (p) => { try {
+    return readFileSync(p, "utf8");
+}
+catch {
+    return null;
+} };
+let cached = null;
+/** Resolved once per process from the real machine (the knob is read live by `claudeBin()`, not here). */
+export function claudeBinResolution() {
+    // A miss is never cached: installing claude and retrying must work without a host restart. Nor is
+    // a hit trusted blindly: a package-manager upgrade unlinks the command for minutes, so the cached
+    // answer is re-checked (one stat or PATH scan) and re-resolved when it has gone.
+    if (cached && !cached.missing && (cached.bin.includes("/") ? existsSync(cached.bin) : pathHas(cached.bin, process.platform)))
+        return cached;
+    cached = findClaudeBin({
+        env: process.env,
+        platform: process.platform,
+        home: homedir(),
+        exists: existsSync,
+        onPath: (n) => pathHas(n, process.platform),
+        readdir: safeLs,
+        wsl: process.platform === "linux" && isWsl(safeRead("/proc/version"), release()),
+    });
+    return cached;
+}
+//# sourceMappingURL=claudebin.js.map

package/packages/host/dist/claudebin.js.map

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

package/packages/host/dist/claudeconfig.d.ts

@@ -0,0 +1,23 @@
+export declare function claudeConfigDir(): string;
+/**
+ * Where the claude CLI stores a directory's conversations:
+ * `<config dir>/projects/<slug>/<conversation-uuid>.jsonl`, slug = cwd with every
+ * non-alphanumeric replaced by `-`.
+ *
+ * A slug past 200 chars is NOT that: the CLI keeps the first 200 and appends
+ * `-<hash of the full path>` (read out of the 2.x bundle; the hash is not
+ * re-derived here, so a wrong guess of it cannot happen). For such a path the
+ * folder is found by its surviving head, and ACCEPTED only when exactly one
+ * candidate holds a log naming this very cwd — two long worktrees can share
+ * their first 200 chars, and the wrong sibling is a wrong file. Nothing found
+ * (yet) or ambiguous answers the untruncated path, which does not exist, so a
+ * reader finds nothing and says so.
+ *
+ * The CLI slugs its REALPATH: a session started in `/tmp/x` (or under macOS's
+ * `/var` → `/private/var`, or a symlinked checkout) writes to
+ * `-private-tmp-x`. So when the folder for the path as given does not exist,
+ * the resolved path's is tried — found by the real-CLI smoke on 2.1.304, whose
+ * scratch repo under `/var/folders` had every log reader that builds its path
+ * from the cwd (the `AskUserQuestion` enrichment among them) reading nothing.
+ */
+export declare function claudeProjectDir(cwd: string): string;