waterplane 0.0.1 → 0.1.11

package/packages/host/dist/archive.js

@@ -0,0 +1,318 @@
+/**
+ * The conversation ARCHIVE: every conversation the `claude` CLI ever wrote for a
+ * repo, listed straight off disk.
+ *
+ * Closing a session was never a delete — the PTY dies, the tmux session dies,
+ * and the conversation log stays in `~/.claude/projects/<slug>/<uuid>.jsonl`,
+ * reopenable with `--resume <uuid>`. What was missing is the ROUTE BACK: the
+ * only records of which conversations those were are the reopen stack and the
+ * recent list, and both are shortlists with a cap. One bulk close of a busy repo
+ * retires more sessions than either can hold, and everything past the edge is
+ * still on disk and unreachable from the phone.
+ *
+ * So this module reads the truth instead of remembering it. No bookkeeping to
+ * keep in sync, no cap, nothing to lose in a restart — the listing is a
+ * `readdir` plus a `stat`, and a row is resumable because the filename IS the
+ * conversation id. `sessions.json` / `closed.json` stay as the fast shortlist.
+ *
+ * Cost discipline: a repo here has thousands of logs, so a TITLE (the first user
+ * prompt) is read only for the page actually being returned — a bounded head
+ * read, not a parse — and memoized by conversation id, which is safe because a
+ * conversation's first prompt never changes once written. A text QUERY is the
+ * one path that must title everything to filter it; that first sweep warms the
+ * same cache, so it is paid once per repo per boot.
+ */
+import { closeSync, openSync, readSync, readdirSync, rmSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { isConversationId } from "@waterplane/shared";
+import { walk } from "./backends/derive.js";
+import { claudeProjectDir, logMtime, parseTranscript, promptLabel, promptOf, toolDetails, transcriptPath } from "./transcript.js";
+/** Bytes read from the head of a log to find its first prompt. A conversation
+ *  opens with a handful of records; a system-reminder block is the only thing
+ *  that makes that long, and it is bounded too. */
+const HEAD_BYTES = 96 * 1024;
+/** Rows returned when a caller names no limit. */
+const PAGE = 60;
+const TITLE_CAP = 200;
+/** id → first-prompt one-liner. A conversation's first prompt is immutable, so
+ *  this never needs invalidating; it is dropped whole with the process. */
+const titles = new Map();
+/** Read the first `HEAD_BYTES` of a file as text. Partial trailing line included
+ *  — the JSON parse below rejects it. */
+function head(path) {
+    let fd = null;
+    try {
+        fd = openSync(path, "r");
+        const buf = Buffer.allocUnsafe(HEAD_BYTES);
+        const n = readSync(fd, buf, 0, HEAD_BYTES, 0);
+        return buf.subarray(0, n).toString("utf8");
+    }
+    catch {
+        return "";
+    }
+    finally {
+        if (fd != null)
+            try {
+                closeSync(fd);
+            }
+            catch { /* already gone */ }
+    }
+}
+/**
+ * The label for one conversation: its first real user prompt, one line.
+ *
+ * Empty when the log holds no prompt yet — a session that was opened and closed
+ * without being typed into. The caller shows that as "(no prompt)" rather than
+ * inventing a name from the uuid, because a row you cannot recognise is worse
+ * than a row that admits it has nothing to show.
+ */
+function titleOf(id, path) {
+    const cached = titles.get(id);
+    if (cached != null)
+        return cached;
+    let out = "";
+    for (const raw of head(path).split("\n")) {
+        const ln = raw.trim();
+        if (!ln)
+            continue;
+        let rec;
+        try {
+            rec = JSON.parse(ln);
+        }
+        catch {
+            continue;
+        } // truncated tail of the window
+        const text = promptOf(rec);
+        if (text) {
+            out = promptLabel(text, TITLE_CAP);
+            break;
+        }
+    }
+    titles.set(id, out);
+    return out;
+}
+/** Every conversation log for a directory, newest first, as id + stat only. */
+function statAll(cwd) {
+    const dir = claudeProjectDir(cwd);
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return [];
+    } // no conversations here yet
+    const out = [];
+    for (const name of names) {
+        if (!name.endsWith(".jsonl"))
+            continue;
+        const path = join(dir, name);
+        try {
+            const st = statSync(path);
+            if (!st.isFile())
+                continue;
+            out.push({ id: name.slice(0, -".jsonl".length), path, mtime: st.mtimeMs, size: st.size });
+        }
+        catch { /* vanished between readdir and stat */ }
+    }
+    out.sort((a, b) => b.mtime - a.mtime);
+    return out;
+}
+/**
+ * One page's bounds, from whatever a query string handed over. A value that is not a finite
+ * number (`?offset=x` is `NaN`) is the DEFAULT, never carried on: `Math.max(1, NaN)` is `NaN`,
+ * and a `NaN` limit slices an empty page that reads as "no conversations here" (review R9).
+ */
+export function pageBounds(offset, limit) {
+    const num = (v) => {
+        const n = typeof v === "number" ? v : typeof v === "string" && v.trim() ? Number(v) : NaN;
+        return Number.isFinite(n) ? Math.floor(n) : null;
+    };
+    const o = num(offset), l = num(limit);
+    return { offset: Math.max(0, o ?? 0), limit: Math.max(1, Math.min(500, l && l > 0 ? l : PAGE)) };
+}
+/**
+ * Conversation id -> the session's tab name, where this host still knows one: a live session's
+ * first, then the newest closed row's. Keyed by the conversation id each row carries — claude's
+ * `claudeSessionId` and another backend's own `backendSessionId` — so a plugin's rows get the name
+ * claude's do. Never derived here: a conversation with no recorded name stays without one.
+ */
+export function conversationTabNames(live, closed) {
+    const out = new Map();
+    for (const rows of [live, closed]) {
+        for (const r of rows) {
+            if (!r.tabTitle)
+                continue;
+            for (const id of [r.claudeSessionId, r.backendSessionId])
+                if (id && !out.has(id))
+                    out.set(id, r.tabTitle);
+        }
+    }
+    return out;
+}
+/**
+ * One page of a repo's archive.
+ *
+ * `q` filters on the title, which means titling every log — the expensive path,
+ * and the reason the un-filtered listing exists at all. It also matches a row's
+ * `name` and its bookmark's note. `bookmarked` cuts to the conversations
+ * `bookmarks` names BEFORE the query (cheap: a bookmarked repo has a handful).
+ * `total` is the count AFTER filtering, so the UI can say "N of M" honestly.
+ *
+ * `bookmarks` and `names` are the caller's (the bookmark store, and the tab
+ * names the session roster still knows); this module remembers neither. A
+ * bookmark whose log is gone is never listed — the listing is what is on disk.
+ */
+export function listArchive(cwd, opts = {}) {
+    const all = statAll(cwd);
+    const q = (opts.q ?? "").trim().toLowerCase();
+    const { offset, limit } = pageBounds(opts.offset, opts.limit);
+    const marks = opts.bookmarks ?? new Map();
+    const nameOf = (id) => opts.names?.get(id) || marks.get(id)?.name || undefined;
+    let rows = all;
+    if (opts.bookmarked)
+        rows = rows.filter((r) => marks.has(r.id));
+    if (q) {
+        rows = rows.filter((r) => titleOf(r.id, r.path).toLowerCase().includes(q) || r.id.includes(q)
+            || (nameOf(r.id) ?? "").toLowerCase().includes(q) || (marks.get(r.id)?.note ?? "").toLowerCase().includes(q));
+    }
+    const page = rows.slice(offset, offset + limit).map((r) => {
+        const name = nameOf(r.id);
+        const bookmark = marks.get(r.id);
+        return {
+            id: r.id,
+            cwd,
+            title: titleOf(r.id, r.path),
+            mtime: r.mtime,
+            size: r.size,
+            ...(name ? { name } : {}),
+            ...(bookmark ? { bookmark } : {}),
+        };
+    });
+    return { cwd, total: rows.length, offset, rows: page, scanned: all.length, ...(opts.bookmarked ? { bookmarked: true } : {}) };
+}
+/** Does this directory hold a log for `id`? Bare ids only. */
+export function archivedExists(cwd, id) {
+    if (!isConversationId(id))
+        return false;
+    try {
+        return statSync(transcriptPath(cwd, id)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The reader's document for one ARCHIVED conversation, straight off its log —
+ * no session, no `claude` spawned, no tokens. The same parser the live reader
+ * uses (`parseTranscript`), so the phone draws it with the same view. `since`
+ * answers `"unchanged"` from the log's mtime, as `/api/transcript` does.
+ * Null for a bad id or a log that is not there; the path is `transcriptPath`
+ * of a bare id, never anything the caller spelled.
+ */
+export function archivedTranscript(cwd, id, since = 0, detail = "lite") {
+    if (!archivedExists(cwd, id))
+        return null;
+    const path = transcriptPath(cwd, id);
+    const mtime = logMtime(path);
+    if (since && mtime != null && mtime <= since)
+        return "unchanged";
+    const parsed = parseTranscript(path, cwd, detail);
+    return parsed ? { sessionId: id, claudeSessionId: id, source: "jsonl", ...parsed } : null;
+}
+/** The tool inputs/results a `lite` archived document withheld, for one turn. */
+export function archivedToolDetails(cwd, id, turnId) {
+    if (!archivedExists(cwd, id) || !turnId)
+        return null;
+    return toolDetails(transcriptPath(cwd, id), cwd, turnId);
+}
+/**
+ * Delete one conversation log for good.
+ *
+ * The one genuinely destructive act in this file, and the only way to lose a
+ * conversation in this app — hence a separate verb from closing a session, and a
+ * confirm on the client. Refuses an id that is not a bare uuid-ish filename
+ * (`transcriptPath` would otherwise happily take `../../…`), and never touches
+ * anything outside the CLI's project directory for this cwd.
+ */
+export function deleteArchived(cwd, id) {
+    if (!isConversationId(id))
+        return { ok: false, error: "bad id" };
+    const path = transcriptPath(cwd, id);
+    try {
+        if (!statSync(path).isFile())
+            return { ok: false, error: "not a conversation" };
+    }
+    catch {
+        return { ok: false, error: "no such conversation" };
+    }
+    try {
+        rmSync(path, { force: true });
+    }
+    catch {
+        return { ok: false, error: "delete failed" };
+    }
+    titles.delete(id);
+    return { ok: true };
+}
+async function sourceList(d, cwd) {
+    return walk(d, "conversations", async (p) => {
+        if (p.source !== true)
+            return null;
+        return (await d.sources.conversations.list(cwd)) ?? null;
+    });
+}
+/** One page of a PLUGIN backend's conversations for `cwd`, in `listArchive`'s shape. Null where the
+ *  backend lists none (the caller falls back to claude's `listArchive`, or says so). */
+export async function listConversations(d, cwd, opts = {}) {
+    const all = await sourceList(d, cwd);
+    if (!all)
+        return null;
+    const q = (opts.q ?? "").trim().toLowerCase();
+    const { offset, limit } = pageBounds(opts.offset, opts.limit);
+    const marks = opts.bookmarks ?? new Map();
+    const titleFor = (c) => promptLabel((c.title || c.firstPrompt || "").trim(), TITLE_CAP);
+    const nameOf = (id) => opts.names?.get(id) || marks.get(id)?.name || undefined;
+    let rows = [...all].sort((a, b) => b.updatedAt - a.updatedAt);
+    if (opts.bookmarked)
+        rows = rows.filter((r) => marks.has(r.id));
+    if (q) {
+        rows = rows.filter((r) => titleFor(r).toLowerCase().includes(q) || (r.firstPrompt ?? "").toLowerCase().includes(q)
+            || r.id.toLowerCase().includes(q) || (nameOf(r.id) ?? "").toLowerCase().includes(q)
+            || (marks.get(r.id)?.note ?? "").toLowerCase().includes(q));
+    }
+    const page = rows.slice(offset, offset + limit).map((r) => {
+        const name = nameOf(r.id);
+        const bookmark = marks.get(r.id);
+        return { id: r.id, cwd, title: titleFor(r), mtime: r.updatedAt, size: 0, ...(name ? { name } : {}), ...(bookmark ? { bookmark } : {}) };
+    });
+    return { cwd, total: rows.length, offset, rows: page, scanned: all.length, ...(opts.bookmarked ? { bookmarked: true } : {}) };
+}
+/** Does the backend list a conversation `id` for `cwd`? False where it lists none. */
+export async function conversationExists(d, cwd, id) {
+    const all = await sourceList(d, cwd);
+    return !!all?.some((c) => c.id === id);
+}
+/** Delete one conversation through the backend's own `remove`. A backend without one cannot — said
+ *  in words, nothing touched. Same verb and same phone confirm as `deleteArchived`. */
+export async function deleteConversation(d, cwd, id) {
+    const src = d.sources?.conversations;
+    if (!src?.remove)
+        return { ok: false, error: "this backend cannot delete a conversation from here" };
+    if (!(await conversationExists(d, cwd, id)))
+        return { ok: false, error: "no such conversation" };
+    try {
+        const r = await src.remove(cwd, id);
+        return r.ok ? { ok: true } : { ok: false, error: r.reason || "delete failed" };
+    }
+    catch {
+        return { ok: false, error: "delete failed" };
+    }
+}
+/** The refusal for "pick a conversation to resume" on a backend that lists none, else null. */
+export function pickRefusal(d) {
+    const providers = Array.isArray(d.facts?.conversations) ? d.facts.conversations : [];
+    const lists = providers.some((p) => p.store === "claude-jsonl"
+        || (p.source === true && !!d.sources?.conversations));
+    return lists ? null : "this backend does not keep a list of conversations this host can show, so there is nothing to pick from. Continue the latest one or start a fresh session.";
+}
+//# sourceMappingURL=archive.js.map

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

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

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

@@ -0,0 +1,38 @@
+import { familyKey, type ArtifactPolicy, type BuildArtifact } from "@waterplane/shared";
+/** This repo's policy (the defaults when there is no file — the feature is on
+ *  by default, see `DEFAULT_ARTIFACT_POLICY`). */
+export declare function artifactPolicy(repoDir: string): ArtifactPolicy;
+/** Persist a repo's policy; returns what was actually written. */
+export declare function saveArtifactPolicy(repoDir: string, p: ArtifactPolicy): ArtifactPolicy;
+/**
+ * The project's own version, if it says one anywhere this can read cheaply.
+ *
+ * Four manifests, in the order that answers first for the repos here: Flutter
+ * (`pubspec.yaml`), node (`package.json`), Gradle (`versionName` + optional
+ * `versionCode`, both android modules and the root), and Cargo. Everything is
+ * a plain regex over at most a few KB — nothing is executed, and a manifest
+ * that does not parse is simply not an answer.
+ *
+ * Absent is a normal outcome, not a failure: the name falls back to the git
+ * sha, and then to the clock.
+ */
+export declare function projectVersion(repoDir: string): string | undefined;
+/** The commit this was built from, short, `-dirty` when the tree was not clean.
+ *  A repo that is not a git checkout simply has no sha to offer. */
+export declare function gitStamp(repoDir: string): string | undefined;
+/**
+ * Collect, name, fold and prune what a run produced.
+ *
+ * Returns the artifact list the run should REPORT — which is the point as much
+ * as the disk changes are: after this, "the build produced this" and "this is
+ * what the phone is offered" are the same list, with one entry per artifact
+ * rather than one per path the same bytes happen to sit at.
+ *
+ * `say` receives one line per action, already newline-terminated for a PTY, and
+ * it is the only account of this a person gets — a file that appears in the
+ * outbox and an older one that stops existing must both be sentences somebody
+ * can read afterwards.
+ */
+export declare function collectArtifacts(repoDir: string, artifacts: BuildArtifact[], policy: ArtifactPolicy, say: (line: string) => void, now?: Date): BuildArtifact[];
+/** Re-exported so a caller does not have to know which module owns which half. */
+export { familyKey };