waterplane 0.0.1 → 0.1.6

package/node_modules/@waterplane/shared/dist/burn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"burn.js","sourceRoot":"","sources":["../src/burn.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,IAAI,GAAG,SAAS,CAAC;AAkBvB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAG,MAAM,CAAC;AAEvC;;6DAE6D;AAC7D,MAAM,UAAU,UAAU,CAAC,CAAgB,EAAE,CAAgB;IAC3D,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,YAAY,CAAC;AACzC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,OAA+B,EAC/B,KAAyB,EACzB,QAAQ,GAAG,EAAE,GAAG,MAAM;IAEtB,MAAM,GAAG,GAAG,CAAC,CAAyC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,MAAM,KAAK,GAAG,CAAC,CAA2C,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnG,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,IAAI,GAAG,GAAwB,IAAI,CAAC;IACpC,IAAI,IAAI,GAAoC,IAAI,CAAC;IACjD,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,2EAA2E;IAC3E,4EAA4E;IAC5E,iDAAiD;IACjD,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,IAAI,CAAC,IAAI,IAAI;YAAE,SAAS;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,QAAQ,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC5E,MAAM,IAAI,GAAG,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,YAAY,CAAC;QACvD,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC;QAChD,IAAI,CAAC,GAAG,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YAC5B,GAAG,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACd,yEAAyE;YACzE,uEAAuE;YACvE,mEAAmE;YACnE,QAAQ,GAAG,GAAG,CAAC;QACjB,CAAC;aAAM,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC5B,QAAQ,GAAG,GAAG,CAAC;QACjB,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACpC,IAAI,GAAG,CAAC,CAAC;QACT,KAAK,GAAG,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAA+B,EAAE,KAAyB;IACvF,OAAO,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAgBD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,MAAM,CAAC;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,OAA+B,EAC/B,GAAW,EACX,OAAsE,EAAE;IAExE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,gBAAgB,CAAC;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,gBAAgB,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC;IAC9C,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IAC1E,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACjB,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,CAAC,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;AAC7F,CAAC;AAOD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,GAAG,IAAI,CAAC;AAIjD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,CAAqB,EACrB,mBAA2B,EAC3B,KAAgB,EAChB,GAAW,EACX,UAAkB;IAElB,IAAI,CAAC,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IACnE,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;IACjD,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,mBAAmB,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC;IAC1F,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,GAAG,UAAU;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;IACrG,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC7F,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,kEAAkE;AAClE,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,+BAA+B;AAC/B,SAAS,OAAO,CAAC,EAAU;IACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;IACjD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;IAC/B,MAAM,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC;IACnB,IAAI,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC;IAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,CAAc,EACd,GAAyD,EACzD,GAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,gCAAgC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IACvH,MAAM,KAAK,GAAG,CAAC,0BAA0B,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAC3J,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;QAChE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;QACjI,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,CAAC,KAAK,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;IAC/G,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC1C,CAAC"}

package/node_modules/@waterplane/shared/dist/chord.d.ts

@@ -0,0 +1,39 @@
+/**
+ * A key with modifiers held, as the bytes a terminal sends for it.
+ *
+ * The phone's key row arms Ctrl / Alt / Shift and combines them with the next
+ * key — one on the row, or a letter from the on-screen keyboard. This is the
+ * one encoding of that combination, xterm's, which is what claude's TUI reads
+ * (its own keybinding table names `ctrl+o`, `meta+p`, `shift+tab`, …):
+ *
+ * - `ctrl+<letter>` → the control byte (`ctrl+o` = 0x0f); `ctrl+[ \ ] ^ _ space`
+ *   their C0 bytes; `ctrl+?` / `ctrl+backspace` DEL / BS.
+ * - `alt+<anything>` → ESC, then the key's own bytes (`alt+p` = `\x1bp`) — the
+ *   "meta sends escape" convention claude's `meta+` bindings rely on.
+ * - `shift+<letter>` → the capital; `shift+tab` → CSI Z.
+ * - modified arrows / Home / End → `CSI 1;<m><final>`, PgUp/PgDn/Delete →
+ *   `CSI <n>;<m>~`, with xterm's `m = 1 + shift + 2·alt + 4·ctrl`.
+ *
+ * A combination a terminal has no bytes for (`ctrl+1`, `ctrl+tab`,
+ * `shift+enter`) is REFUSED with a sentence, never sent as something else.
+ */
+export interface ChordMods {
+    ctrl?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+}
+/**
+ * The key the modifiers land on: one printable character as typed, or a name
+ * for a key that types nothing.
+ */
+export type ChordKey = "tab" | "enter" | "esc" | "backspace" | "delete" | "space" | "up" | "down" | "left" | "right" | "home" | "end" | "pgup" | "pgdn" | (string & {});
+export type ChordResult = {
+    bytes: string;
+} | {
+    refused: string;
+};
+/** `ctrl+alt+shift+o`, the CLI's own spelling, modifiers in that order. */
+export declare function chordName(m: ChordMods, key: ChordKey): string;
+export declare function hasMods(m: ChordMods): boolean;
+/** The bytes for `key` with `m` held, or the sentence why there are none. */
+export declare function chordBytes(m: ChordMods, key: ChordKey): ChordResult;

package/node_modules/@waterplane/shared/dist/chord.js

@@ -0,0 +1,102 @@
+/**
+ * A key with modifiers held, as the bytes a terminal sends for it.
+ *
+ * The phone's key row arms Ctrl / Alt / Shift and combines them with the next
+ * key — one on the row, or a letter from the on-screen keyboard. This is the
+ * one encoding of that combination, xterm's, which is what claude's TUI reads
+ * (its own keybinding table names `ctrl+o`, `meta+p`, `shift+tab`, …):
+ *
+ * - `ctrl+<letter>` → the control byte (`ctrl+o` = 0x0f); `ctrl+[ \ ] ^ _ space`
+ *   their C0 bytes; `ctrl+?` / `ctrl+backspace` DEL / BS.
+ * - `alt+<anything>` → ESC, then the key's own bytes (`alt+p` = `\x1bp`) — the
+ *   "meta sends escape" convention claude's `meta+` bindings rely on.
+ * - `shift+<letter>` → the capital; `shift+tab` → CSI Z.
+ * - modified arrows / Home / End → `CSI 1;<m><final>`, PgUp/PgDn/Delete →
+ *   `CSI <n>;<m>~`, with xterm's `m = 1 + shift + 2·alt + 4·ctrl`.
+ *
+ * A combination a terminal has no bytes for (`ctrl+1`, `ctrl+tab`,
+ * `shift+enter`) is REFUSED with a sentence, never sent as something else.
+ */
+const CURSOR_FINAL = { up: "A", down: "B", right: "C", left: "D", home: "H", end: "F" };
+const TILDE_CODE = { pgup: "5", pgdn: "6", delete: "3" };
+const PLAIN = {
+    tab: "\t", enter: "\r", esc: "\x1b", backspace: "\x7f", space: " ",
+    up: "\x1b[A", down: "\x1b[B", right: "\x1b[C", left: "\x1b[D", home: "\x1b[H", end: "\x1b[F",
+    pgup: "\x1b[5~", pgdn: "\x1b[6~", delete: "\x1b[3~",
+};
+/** C0 bytes for the punctuation ctrl combines with. */
+const CTRL_PUNCT = {
+    "[": "\x1b", "\\": "\x1c", "]": "\x1d", "^": "\x1e", "_": "\x1f", "?": "\x7f", "@": "\x00", " ": "\x00",
+};
+/** `ctrl+alt+shift+o`, the CLI's own spelling, modifiers in that order. */
+export function chordName(m, key) {
+    return [m.ctrl && "ctrl", m.alt && "alt", m.shift && "shift", key === " " ? "space" : key].filter(Boolean).join("+");
+}
+export function hasMods(m) {
+    return !!(m.ctrl || m.alt || m.shift);
+}
+/** The bytes for `key` with `m` held, or the sentence why there are none. */
+export function chordBytes(m, key) {
+    const name = chordName(m, key);
+    const no = (why) => ({ refused: `${name} has no terminal bytes — ${why}` });
+    if (!key)
+        return no("no key");
+    // Cursor keys carry every modifier in the xterm parameter.
+    if (key in CURSOR_FINAL || key in TILDE_CODE) {
+        if (!hasMods(m))
+            return { bytes: PLAIN[key] };
+        const p = 1 + (m.shift ? 1 : 0) + (m.alt ? 2 : 0) + (m.ctrl ? 4 : 0);
+        return { bytes: key in CURSOR_FINAL ? `\x1b[1;${p}${CURSOR_FINAL[key]}` : `\x1b[${TILDE_CODE[key]};${p}~` };
+    }
+    // Alt is a prefix over whatever the rest encodes to.
+    if (m.alt) {
+        const rest = chordBytes({ ctrl: m.ctrl, shift: m.shift }, key);
+        return "bytes" in rest ? { bytes: `\x1b${rest.bytes}` } : no("refused" in rest ? rest.refused.replace(/^.*? — /, "") : "");
+    }
+    const ch = key === "space" ? " " : key;
+    if (m.ctrl) {
+        if (m.shift && key !== "tab") {
+            // ctrl+shift+<letter> is the same control byte in a plain terminal;
+            // claude binds a few (`ctrl+shift+b`) that only a kitty-protocol
+            // terminal can tell apart — sending ctrl+<letter> would be a different key.
+            return no("a plain terminal sends the same byte as without shift");
+        }
+        if (key === "tab")
+            return no("terminals send Tab for it");
+        if (key === "enter")
+            return no("terminals send Return for it");
+        if (key === "backspace")
+            return { bytes: "\x08" };
+        if (key === "esc")
+            return no("terminals send Esc for it");
+        if (ch.length === 1) {
+            const lower = ch.toLowerCase();
+            if (/^[a-z]$/.test(lower))
+                return { bytes: String.fromCharCode(lower.charCodeAt(0) - 96) };
+            if (ch in CTRL_PUNCT)
+                return { bytes: CTRL_PUNCT[ch] };
+            if (ch === "-")
+                return { bytes: "\x1f" }; // ctrl+- is how most keyboards type ctrl+_
+        }
+        return no("ctrl combines only with a letter or [ \\ ] ^ _ ? @ space");
+    }
+    if (m.shift) {
+        if (key === "tab")
+            return { bytes: "\x1b[Z" };
+        if (key === "enter")
+            return no("terminals send Return for it; Alt+Return is claude's newline");
+        if (key === "space")
+            return { bytes: " " };
+        if (key in PLAIN)
+            return { bytes: PLAIN[key] };
+        if (ch.length === 1)
+            return { bytes: ch.toUpperCase() };
+        return no("unknown key");
+    }
+    if (key in PLAIN)
+        return { bytes: PLAIN[key] };
+    if (ch.length === 1)
+        return { bytes: ch };
+    return no("unknown key");
+}
+//# sourceMappingURL=chord.js.map

package/node_modules/@waterplane/shared/dist/chord.js.map

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

package/node_modules/@waterplane/shared/dist/claudeconfig.d.ts

@@ -0,0 +1,18 @@
+export declare function claudeConfigDirOf(o: {
+    configDir?: string | undefined;
+    testHome?: string | undefined;
+    home: string;
+}): string;
+/** `claudeConfigDirOf` over a process environment (the test knob under the
+ *  current brand's prefix, then each legacy one). For callers with no host `env()`. */
+export declare function claudeConfigDirFromEnv(e: Record<string, string | undefined>, home: string): string;
+/**
+ * The longest folder name the CLI writes under `projects/` before it truncates
+ * (read out of the 2.x bundle: `slug.length <= 200 ? slug : slug.slice(0,200) +
+ * "-" + abs(hash(path)).toString(36)`). The hash is NOT re-derived here.
+ * `transcriptDirName` (requirements.ts) is the untruncated slug.
+ */
+export declare const PROJECT_SLUG_MAX = 200;
+/** For a slug the CLI would have truncated: the surviving head plus its `-`, to
+ *  match directory names against. null when the slug is short enough to be exact. */
+export declare function truncatedSlugPrefix(slug: string): string | null;

package/node_modules/@waterplane/shared/dist/claudeconfig.js

@@ -0,0 +1,44 @@
+/**
+ * Where the claude CLI keeps its private state (`projects/`, `sessions/`,
+ * `settings.json`, `commands/`, …) — ONE definition, so no reader hard-codes
+ * `~/.claude`.
+ *
+ * The CLI honours `CLAUDE_CONFIG_DIR`, which REPLACES the whole `~/.claude`
+ * directory (not its parent). Order here: `CLAUDE_CONFIG_DIR` (what the CLI
+ * itself would use, and what a spawned `claude` inherits unchanged), else the
+ * test knob `<PREFIX>CLAUDE_HOME` (a HOME-like root, `.claude` joined on), else
+ * `<home>/.claude`. An empty string is unset, like the CLI's own truthiness
+ * test. Pure: the caller hands over the environment and the home directory.
+ */
+import { envName, legacyEnvNames } from "./brand.js";
+const stripSlash = (p) => (p.length > 1 ? p.replace(/[\\/]+$/, "") : p);
+export function claudeConfigDirOf(o) {
+    if (o.configDir)
+        return o.configDir;
+    return `${stripSlash(o.testHome || o.home)}/.claude`;
+}
+/** `claudeConfigDirOf` over a process environment (the test knob under the
+ *  current brand's prefix, then each legacy one). For callers with no host `env()`. */
+export function claudeConfigDirFromEnv(e, home) {
+    let testHome;
+    for (const n of [envName("CLAUDE_HOME"), ...legacyEnvNames("CLAUDE_HOME")]) {
+        if (e[n]) {
+            testHome = e[n];
+            break;
+        }
+    }
+    return claudeConfigDirOf({ configDir: e.CLAUDE_CONFIG_DIR, testHome, home });
+}
+/**
+ * The longest folder name the CLI writes under `projects/` before it truncates
+ * (read out of the 2.x bundle: `slug.length <= 200 ? slug : slug.slice(0,200) +
+ * "-" + abs(hash(path)).toString(36)`). The hash is NOT re-derived here.
+ * `transcriptDirName` (requirements.ts) is the untruncated slug.
+ */
+export const PROJECT_SLUG_MAX = 200;
+/** For a slug the CLI would have truncated: the surviving head plus its `-`, to
+ *  match directory names against. null when the slug is short enough to be exact. */
+export function truncatedSlugPrefix(slug) {
+    return slug.length > PROJECT_SLUG_MAX ? slug.slice(0, PROJECT_SLUG_MAX) + "-" : null;
+}
+//# sourceMappingURL=claudeconfig.js.map

package/node_modules/@waterplane/shared/dist/claudeconfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeconfig.js","sourceRoot":"","sources":["../src/claudeconfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,UAAU,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAExF,MAAM,UAAU,iBAAiB,CAAC,CAAkF;IAClH,IAAI,CAAC,CAAC,SAAS;QAAE,OAAO,CAAC,CAAC,SAAS,CAAC;IACpC,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;AACvD,CAAC;AAED;uFACuF;AACvF,MAAM,UAAU,sBAAsB,CAAC,CAAqC,EAAE,IAAY;IACxF,IAAI,QAA4B,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;QAC3E,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAAC,MAAM;QAAC,CAAC;IACvC,CAAC;IACD,OAAO,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC;qFACqF;AACrF,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACvF,CAAC"}

package/node_modules/@waterplane/shared/dist/claudeversion.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The newest `claude` build the screen-reading heuristics were last checked
+ * against by a person (what `claude --version` said on the dev desktop).
+ * Bump it when you re-verify; the doctor warns for anything NEWER, never for
+ * older: no minimum is claimed, because the launch flags (`--session-id`,
+ * `--settings`, `--plugin-dir`, `--effort`, `--remote-control`,
+ * `--permission-mode`) have no recorded first-supported version here.
+ */
+export declare const TESTED_CLAUDE_VERSION = "2.1.304";
+/** `2.1.289 (Claude Code)` → [2,1,289]; anything else null (never a guess). */
+export declare function parseClaudeVersion(raw: string | null | undefined): [number, number, number] | null;
+/**
+ * A sentence when the installed `claude` is newer than {@link TESTED_CLAUDE_VERSION},
+ * else null. Unparsable ⇒ null (absent, not a warning about nothing). A warning
+ * only — it never refuses a session.
+ */
+export declare function claudeNewerThanTested(raw: string | null | undefined, tested?: string): string | null;

package/node_modules/@waterplane/shared/dist/claudeversion.js

@@ -0,0 +1,31 @@
+/**
+ * The newest `claude` build the screen-reading heuristics were last checked
+ * against by a person (what `claude --version` said on the dev desktop).
+ * Bump it when you re-verify; the doctor warns for anything NEWER, never for
+ * older: no minimum is claimed, because the launch flags (`--session-id`,
+ * `--settings`, `--plugin-dir`, `--effort`, `--remote-control`,
+ * `--permission-mode`) have no recorded first-supported version here.
+ */
+export const TESTED_CLAUDE_VERSION = "2.1.304";
+/** `2.1.289 (Claude Code)` → [2,1,289]; anything else null (never a guess). */
+export function parseClaudeVersion(raw) {
+    const m = /^\s*v?(\d+)\.(\d+)\.(\d+)/.exec(raw ?? "");
+    return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+}
+/**
+ * A sentence when the installed `claude` is newer than {@link TESTED_CLAUDE_VERSION},
+ * else null. Unparsable ⇒ null (absent, not a warning about nothing). A warning
+ * only — it never refuses a session.
+ */
+export function claudeNewerThanTested(raw, tested = TESTED_CLAUDE_VERSION) {
+    const v = parseClaudeVersion(raw), t = parseClaudeVersion(tested);
+    if (!v || !t)
+        return null;
+    for (let i = 0; i < 3; i++) {
+        if (v[i] === t[i])
+            continue;
+        return v[i] > t[i] ? `claude ${v.join(".")} is newer than ${t.join(".")}, the newest this build was tested with — heuristics may miss; clihealth will show it` : null;
+    }
+    return null;
+}
+//# sourceMappingURL=claudeversion.js.map

package/node_modules/@waterplane/shared/dist/claudeversion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeversion.js","sourceRoot":"","sources":["../src/claudeversion.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,SAAS,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,GAA8B;IAC/D,MAAM,CAAC,GAAG,2BAA2B,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAA8B,EAAE,SAAiB,qBAAqB;IAC1G,MAAM,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,CAAC,CAAC,CAAE;YAAE,SAAS;QAC9B,OAAO,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,uFAAuF,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1K,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/node_modules/@waterplane/shared/dist/clientframe.d.ts

@@ -0,0 +1,12 @@
+import type { ClientMessage } from "./wire/messages.js";
+/**
+ * Is this decoded value shaped like a client frame at all: a non-null,
+ * non-array object with a string `t`? The ONE check the host makes on a
+ * WebSocket frame before dispatch — `decode` is a cast, and `null`, a string
+ * or `{}` off the socket used to throw at `msg.t`.
+ *
+ * It deliberately does NOT check that `t` is a type this end knows: an unknown
+ * `t` is a versioned no-op (`routes/index.ts`), never an error, and each
+ * handler still validates its own fields.
+ */
+export declare function isClientFrame(x: unknown): x is ClientMessage;

package/node_modules/@waterplane/shared/dist/clientframe.js

@@ -0,0 +1,15 @@
+/**
+ * Is this decoded value shaped like a client frame at all: a non-null,
+ * non-array object with a string `t`? The ONE check the host makes on a
+ * WebSocket frame before dispatch — `decode` is a cast, and `null`, a string
+ * or `{}` off the socket used to throw at `msg.t`.
+ *
+ * It deliberately does NOT check that `t` is a type this end knows: an unknown
+ * `t` is a versioned no-op (`routes/index.ts`), never an error, and each
+ * handler still validates its own fields.
+ */
+export function isClientFrame(x) {
+    return typeof x === "object" && x !== null && !Array.isArray(x)
+        && typeof x.t === "string";
+}
+//# sourceMappingURL=clientframe.js.map

package/node_modules/@waterplane/shared/dist/clientframe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientframe.js","sourceRoot":"","sources":["../src/clientframe.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;WAC1D,OAAQ,CAAqB,CAAC,CAAC,KAAK,QAAQ,CAAC;AACpD,CAAC"}

package/node_modules/@waterplane/shared/dist/clihealth/healthcatalog.d.ts

@@ -0,0 +1,52 @@
+import { type HealthThresholds } from "./healththresholds.js";
+/**
+ * How a failing input may be captured.
+ *
+ * This is the redaction rule, and it is declared on the SIGNAL rather than left
+ * to the call site on purpose. A screen and a conversation log carry whatever
+ * the agent happened to print — a file it just read, an environment it just
+ * dumped, the user's own prose — so "remember to sanitize before you record"
+ * is a rule that holds until somebody adds the eleventh call site. `observe()`
+ * applies the mode itself, so a caller that hands prose to a `shape` signal
+ * cannot leak it: the characters never enter the record.
+ *
+ *   • `line`  — the input is TUI CHROME the CLI drew: a dialog footer, a meter
+ *               row, a banner, an option row. Kept as text (redacted, capped),
+ *               because "this line no longer matches" is only actionable if the
+ *               line is kept, and that is the whole point of a sample.
+ *   • `shape` — the input is PROSE somebody wrote: a prompt, a log record, an
+ *               option's description. No characters survive. What is kept is
+ *               the structure (`shapeOf`), which is what the parse was reasoning
+ *               about anyway: how many lines, how long, how wide.
+ */
+export type SampleMode = "line" | "shape";
+export interface CliSignalSpec {
+    id: CliSignalId;
+    /** Verb phrase, used as the subject of the generated sentence. */
+    name: string;
+    /** What breaks in the app when this stops working. */
+    means: string;
+    capture: SampleMode;
+    /** What the app does instead when this misses — named in the readout, because
+     *  a fallback that nobody knows is running becomes the architecture. */
+    fallback?: string;
+    thresholds?: Partial<HealthThresholds>;
+}
+/**
+ * Every point where this app reads something it does not own.
+ *
+ * Declared as a list rather than a bare union for the same reason
+ * `NOTIFICATION_KINDS` is: it is also the ORDER a readout lists them in, and
+ * the set a persisted record is validated against — a signal removed from here
+ * must not keep occupying a row in a file written by an older host.
+ */
+export declare const CLI_SIGNALS: readonly CliSignalSpec[];
+export type CliSignalId = "prompt.box" | "prompt.submit" | "askbox.enrich" | "limit.reset" | "context.meter" | "hook.pipe" | "deliver.echo" | "deliver.submit" | "transcript.jsonl" | "slash.local";
+/** The catalog entry for an id. Synthesized for an id we do not know rather
+ *  than thrown: a record written by a newer host must render as a row, not as
+ *  an exception inside a readout whose whole job is to be reliable. */
+export declare function signalSpec(id: string): CliSignalSpec;
+/** Thresholds in force for one signal — the defaults, with the catalog's own
+ *  overrides on top. One merge point, so a rule read from a comment above is
+ *  the rule the verdict actually uses. */
+export declare function thresholdsFor(id: string): HealthThresholds;

package/node_modules/@waterplane/shared/dist/clihealth/healthcatalog.js

@@ -0,0 +1,137 @@
+// Cut from clihealth.ts (move only): the signal catalog
+// The one door stays `./clihealth.js`; this slice imports its siblings directly, never the barrel.
+import { DEFAULT_THRESHOLDS } from "./healththresholds.js";
+/**
+ * Every point where this app reads something it does not own.
+ *
+ * Declared as a list rather than a bare union for the same reason
+ * `NOTIFICATION_KINDS` is: it is also the ORDER a readout lists them in, and
+ * the set a persisted record is validated against — a signal removed from here
+ * must not keep occupying a row in a file written by an older host.
+ */
+export const CLI_SIGNALS = [
+    {
+        id: "prompt.box",
+        name: "Reading a question box off the screen",
+        means: "The choice-box detector. When it stops matching there is no error and no empty state — a live question simply never reaches the phone, and the session sits blocked in silence.",
+        capture: "line",
+        fallback: "the weaker “something is asking you something” flag",
+    },
+    {
+        id: "prompt.submit",
+        name: "Placing the cursor on a multi-select Submit row",
+        means: "Where the answer keystroke goes on a checkbox box. Without it the app sends a bare Return, which toggles whatever row the cursor happens to be on instead of submitting.",
+        capture: "line",
+        fallback: "a bare Return",
+    },
+    {
+        id: "askbox.enrich",
+        name: "Reading the CLI's own words for a question box",
+        means: "The full question and per-option descriptions, taken from the conversation log rather than the truncated screen. Without it the phone shows one-tap buttons whose explanation is nowhere on the device.",
+        capture: "shape",
+        fallback: "the labels as the terminal cut them",
+    },
+    {
+        id: "limit.reset",
+        name: "Reading when a usage block ends",
+        means: "The reset instant parsed out of the CLI's own block notice. Without it a blocked session has no time to resume at and waits for a blind sweep instead.",
+        capture: "line",
+        fallback: "a periodic re-scan with no scheduled resume",
+        // A usage block is not a daily event, so a day of silence here says nothing
+        // about the parser. Thirty days is long enough to span the gaps and short
+        // enough that a verdict never outlives the CLI version that earned it.
+        thresholds: { forgetMs: 30 * 24 * 3600_000 },
+    },
+    {
+        id: "context.meter",
+        name: "Reading the context-window figure",
+        means: "The context badge. A miss hides a number rather than losing work, which is why it is the one signal here allowed to fail a few more times before it is worth a word.",
+        capture: "line",
+        // Lowest stakes on the board: nothing is lost, a badge is absent. Flagging
+        // it at the same sensitivity as a lost question box would put the two in
+        // the same list and teach the reader to skim it.
+        thresholds: { degradedMisses: 4, brokenMisses: 10 },
+    },
+    {
+        id: "hook.pipe",
+        name: "The CLI's lifecycle hooks",
+        means: "The positive turn-boundary signal. Without it a session falls back to guessing from silence, so turn ends get mushy, the backlog's readiness is a timer, and auto-fire can land mid-task.",
+        capture: "shape",
+        fallback: "silence heuristics",
+    },
+    {
+        id: "deliver.echo",
+        name: "Confirming a prompt reached the composer",
+        means: "The echo probe. When it stops finding text, deliveries come back unconfirmed — which is not a lost prompt but is reported to the user as one, and is the exact signal that ran at 22% for a week.",
+        capture: "shape",
+        fallback: "asking the conversation log later",
+        // Rate-led, deliberately. A run of misses here is ordinary — one busy
+        // session repainting through a fan-out produces several in a row and none
+        // of them mean the probe is broken. What means something is the fraction,
+        // so the streak thresholds are loosened rather than removed: eight in a row
+        // is beyond what a busy screen explains.
+        //
+        // The thresholds are also why a ~30% reading was believed for as long as it
+        // was: it sat just the right side of amber. It was not the probe. The probe
+        // FOUND the text and `deliver.ts` refused to PLACE it, because "within ~11
+        // rows of the bottom of the render" measures a torn repaint rather than the
+        // composer. The rule is structural now — is the text inside the box the CLI
+        // draws to take typing (`echo.ts`'s `composerEcho`, the same one
+        // `settle.ts` asks later) — and the distance test survives only for a
+        // screen with no such box on it.
+        //
+        // And one thing `deliver.ts` deliberately does NOT record here, the "right
+        // rule" rule above again: a composer that ALREADY holds text this app
+        // cannot tell apart from the caller's. Nothing has been typed at that
+        // point, so no echo of our text was ever owed; the probe declining to
+        // credit a stranger's words to this delivery is it working. It fires on a
+        // re-send of a prompt whose first attempt is still in the box, which is the
+        // commonest shape there is, so counting it would have pinned this signal
+        // amber for ever.
+        thresholds: { degradedMisses: 5, brokenMisses: 8 },
+    },
+    {
+        id: "deliver.submit",
+        name: "Confirming a submitted prompt started a turn",
+        means: "Proof the Return was not swallowed. When it fails the app says the text is sitting unsent in a composer — a specific, actionable claim that must not be made about a prompt that is running.",
+        capture: "shape",
+        fallback: "asking the conversation log later",
+        // Two things `deliver.ts` deliberately does NOT record here, both of them
+        // the "right rule" rule above and both of them found on the live host:
+        // interjecting into a session that is already working (the turn started
+        // before the Return did, so there is no turn-start to observe — that is a
+        // fact about how the app is used, not about the CLI), and a hook that lands
+        // during the press-and-look loop (the pipe was alive, the host simply had
+        // not heard from it yet — the proof turning up late is the primary rule
+        // answering). Counting either read 5 of 20 on a path whose sent log says
+        // every one of those deliveries came back `ok`.
+        thresholds: { degradedMisses: 5, brokenMisses: 8 },
+    },
+    {
+        id: "transcript.jsonl",
+        name: "Reading the CLI's conversation log",
+        means: "The reader view, the archive titles, and the evidence that settles an unconfirmable delivery. This is the witness that is not a rendering; without it the app is back to believing screens.",
+        capture: "shape",
+        fallback: "our own record of what we typed",
+    },
+    {
+        id: "slash.local",
+        name: "Delivering a TUI-local command",
+        means: "Commands that open a view instead of running a turn. Get the list wrong in either direction and the app either hammers Return into the view it just opened, or waits for a turn that never starts.",
+        capture: "line",
+    },
+];
+const BY_ID = new Map(CLI_SIGNALS.map((s) => [s.id, s]));
+/** The catalog entry for an id. Synthesized for an id we do not know rather
+ *  than thrown: a record written by a newer host must render as a row, not as
+ *  an exception inside a readout whose whole job is to be reliable. */
+export function signalSpec(id) {
+    return BY_ID.get(id) ?? { id: id, name: id, means: "", capture: "shape" };
+}
+/** Thresholds in force for one signal — the defaults, with the catalog's own
+ *  overrides on top. One merge point, so a rule read from a comment above is
+ *  the rule the verdict actually uses. */
+export function thresholdsFor(id) {
+    return { ...DEFAULT_THRESHOLDS, ...(BY_ID.get(id)?.thresholds ?? {}) };
+}
+//# sourceMappingURL=healthcatalog.js.map

package/node_modules/@waterplane/shared/dist/clihealth/healthcatalog.js.map

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

package/node_modules/@waterplane/shared/dist/clihealth/healthfixture.d.ts

@@ -0,0 +1,58 @@
+/**
+ * How a harvested sample is kept. By default the form its `SampleMode` names:
+ * a `line` signal as a masked GRID (the readers work by row and column, so a
+ * one-line sample is no fixture), a `shape` signal as a SKELETON of the record
+ * it read (keys and event names, never a value) — `deliver.submit`'s is the
+ * `UserPromptSubmit` hook that proved the turn, its prompt gone with every
+ * other value. Two signals need a form of their own:
+ *
+ *   • `echo` — `deliver.echo`'s evidence is the composer holding the person's
+ *     prompt. Kept as the prompt and the grid masked BY THE SAME RULE
+ *     (`maskRow` is character for character), so the echo reader can still
+ *     find one in the other and neither holds a word: the masked prompt, the
+ *     `ECHO_SPLIT` row, the masked grid.
+ *   • `notice` — `limit.reset`'s evidence is the block notice itself, and that
+ *     text must never sit in plain bytes in a file a session might print (it
+ *     would false-positive the detector on a live screen). Kept as a grid with
+ *     the notice rows verbatim, then ROT13'd whole; `decodeFixture` undoes it.
+ *
+ * The fixture lands in a PUBLIC repo, so the bar is higher than for the
+ * health record's own sample, which never leaves this desktop.
+ */
+export declare const FIXTURE_FORMS: Readonly<Record<string, "echo" | "notice">>;
+/** The row between an `echo` fixture's prompt and its grid. */
+export declare const ECHO_SPLIT = "\u2042 screen \u2042";
+/** A capture's file extension: a grid is text, a skeleton JSON. */
+export declare function fixtureExt(id: string): "txt" | "json";
+/** A fixture's text as its reader reads it (a `notice` is stored ROT13'd). */
+export declare function decodeFixture(id: string, text: string): string;
+/** At most this many rows of a grid are kept — the newest, where the CLI draws. */
+export declare const FIXTURE_ROWS = 60;
+/**
+ * A row's words, masked with its layout kept: every letter becomes `x`/`X`,
+ * every digit `0`, so widths, wrapping, punctuation and box glyphs survive and
+ * no word does. An option's leading index (`❯ 2.`) is kept: it is drawn by the
+ * CLI, and the box readers count by it.
+ */
+export declare function maskRow(row: string, protect?: RegExp): string;
+/**
+ * A screen kept for a fixture: the CLI's CHROME verbatim (redacted as the
+ * health sample is), every other row masked (`maskRow`). Which rows are chrome
+ * is the host's knowledge — the footer and the meter row are what its readers
+ * already recognise — so it is handed in.
+ */
+export declare function maskGrid(text: string, keep: (row: string) => boolean, protect?: RegExp): string;
+/**
+ * The structure of a record with its content gone: object keys (an
+ * identifier-shaped key only — a map keyed by file path is content), the kind
+ * of every leaf, the names in `NAME_KEYS`, and an array as its DISTINCT
+ * element shapes. Idempotent, so a skeleton put through again is unchanged.
+ */
+export declare function skeletonOf(v: unknown, key?: string, depth?: number): unknown;
+/**
+ * What a harvested sample of this signal keeps, or null when nothing may be
+ * kept (a shape that is not JSON, an empty screen, an echo with no prompt).
+ * `keep` names the chrome rows of a grid, `protect` the chrome spans inside
+ * any other row.
+ */
+export declare function fixtureSample(id: string, raw: string, keep?: (row: string) => boolean, protect?: RegExp): string | null;