@nanonets/graft 0.24.1 → 0.25.0

package/dist/init/keep-list.js

@@ -0,0 +1,232 @@
+/**
+ * Where init's list is in a session's transcript, and what followed it
+ * (design 4.9 steps 2 to 4, R22): shared by the PreToolUse keep gate, which
+ * finds it, and `trail keep`'s CLI half, which reads it again from the
+ * receipt's offset and must see the same.
+ *
+ * A list is either the tool_result of a Bash call that only runs
+ * `trail init` (no pipe, no redirect, nothing but Trail), holding
+ * RELAY_LINE and KEEP_LINE; or, for the session the record handed the list
+ * to at its start, the transcript from the recorded offset. A RELAY_LINE in
+ * any other result (an `echo`, a `cat` of a saved copy) is not a list. After
+ * the list: the agent's text up to the first line the person typed, that
+ * line, and whether any call since the list wrote Trail's or the host's
+ * files (1a's tamper check).
+ *
+ * Reads at most the transcript's last 8 MB (the gate) or 8 MB from the list
+ * (the CLI), as whole lines with their byte offsets; never a FIFO.
+ */
+import { createHash } from 'node:crypto';
+import { closeSync, fstatSync, readSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { isTypedByPerson, typedText } from '../trace/claude.js';
+import { leadingCds, onlyTrail, simpleCommands } from '../trace/shell.js';
+import { tamperOf } from '../trace/tamper.js';
+import { trailHome } from '../notes/trail-home.js';
+import { claudeTranscript, openPlain } from './plain-file.js';
+import { KEEP_LINE, RELAY_LINE } from './relay.js';
+/** How much of the transcript is read: the list is printed moments before the answer. */
+export const TAIL_BYTES = 8 * 1024 * 1024;
+const sha256 = (s) => createHash('sha256').update(s, 'utf8').digest('hex');
+/** Whole lines with their byte offsets, from `from` (a line start) or the last `bytes` of the file; null when unreadable. */
+export function linesFrom(path, opts) {
+    let fd;
+    try {
+        fd = openPlain(path, { follow: true });
+    }
+    catch {
+        return null;
+    }
+    try {
+        const size = fstatSync(fd).size;
+        const bytes = opts.bytes ?? TAIL_BYTES;
+        const start = opts.from !== undefined ? opts.from : Math.max(0, size - bytes);
+        if (!Number.isSafeInteger(start) || start < 0 || start > size)
+            return null;
+        const end = Math.min(size, start + bytes);
+        const buf = Buffer.allocUnsafe(end - start);
+        const got = readSync(fd, buf, 0, buf.length, start);
+        const out = [];
+        let at = 0;
+        // A window that opens mid-line starts at the next whole one; a list offset must be a line start.
+        if (start > 0 && opts.from === undefined) {
+            const nl = buf.indexOf(0x0a);
+            if (nl < 0 || nl >= got)
+                return [];
+            at = nl + 1;
+        }
+        while (at < got) {
+            const nl = buf.indexOf(0x0a, at);
+            if (nl < 0 || nl >= got)
+                break;
+            out.push({ line: buf.toString('utf8', at, nl), offset: start + at });
+            at = nl + 1;
+        }
+        return out;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+const contentOf = (e) => {
+    const c = e.message?.content;
+    return Array.isArray(c) ? c : [];
+};
+const resultText = (part) => {
+    const c = part.content;
+    if (typeof c === 'string')
+        return c;
+    if (Array.isArray(c))
+        return c.map((x) => (x && typeof x === 'object' && typeof x.text === 'string' ? x.text : '')).join('\n');
+    return '';
+};
+/**
+ * A Bash command that only runs `trail init`: Trail's own (1a's `onlyTrail`), with no pipe that could cut its list,
+ * and nothing else beside it but leading `cd`s (b6 review): `trail init; echo …`, `echo …; trail init --help` or
+ * `trail init && cat saved.txt` would put text of the agent's own in the same result as the list.
+ */
+export function initOnly(command) {
+    // `onlyTrail` knows `npx @trailhq/trail-code` and `npx @nanonets/graft` itself; stripping `npx` first made those
+    // `@trailhq/trail-code init`, which is no program, so an npx init was never a list (b6 review).
+    return !/(?:^|[^|])\|(?!\|)/.test(command) && onlyTrail(command) && simpleCommands(leadingCds(command).rest).length === 1;
+}
+/**
+ * The newest list in the transcript's tail: a clean `trail init` call's result, or this session's handover offset.
+ * `cut` when the newest `trail init` call is newer than any list and its output is not a list (a pipe, a redirect,
+ * another command with it). Null when there is none, or the transcript can't be read.
+ */
+export function findList(path, isInit, handover) {
+    const lines = linesFrom(path, {});
+    if (!lines)
+        return null;
+    const calls = new Map();
+    let list = handover ? { via: 'handover', offset: handover.offset, text: '' } : null;
+    let cut = null;
+    for (const { line, offset } of lines) {
+        const use = line.includes('"tool_use"') && /\binit\b/.test(line);
+        const result = line.includes('"tool_result"');
+        if (!use && !result)
+            continue;
+        let e;
+        try {
+            e = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (!e || typeof e !== 'object' || e.isSidechain === true)
+            continue;
+        for (const raw of contentOf(e)) {
+            const part = raw;
+            if (!part || typeof part !== 'object')
+                continue;
+            if (e.type === 'assistant' && part.type === 'tool_use' && part.name === 'Bash') {
+                const command = part.input?.command;
+                if (typeof command === 'string' && isInit(command) && typeof part.id === 'string')
+                    calls.set(part.id, initOnly(command));
+            }
+            else if (e.type === 'user' && part.type === 'tool_result' && typeof part.tool_use_id === 'string' && calls.has(part.tool_use_id)) {
+                const text = resultText(part);
+                const clean = calls.get(part.tool_use_id);
+                if (clean && text.includes(RELAY_LINE) && text.includes(KEEP_LINE)) {
+                    if (!list || offset > list.offset)
+                        list = { via: 'init-call', offset, text };
+                    cut = null;
+                }
+                else if (!list || offset > list.offset)
+                    cut = offset;
+            }
+        }
+    }
+    if (cut !== null && list && list.offset > cut)
+        cut = null;
+    return { list, cut };
+}
+/**
+ * What follows the list: read from its offset (an init call's result line is skipped). The answer is the person's
+ * newest typed line after the list (b6 review): the relay itself invites "Show one in full", so a first line that asks
+ * to see an item must not lock the list; a later change of mind ("actually none") wins over earlier numbers. The
+ * reply is the agent's text from the list up to that line.
+ */
+export function afterList(path, list, env = process.env) {
+    const lines = linesFrom(path, { from: list.offset });
+    if (!lines)
+        return null;
+    const reply = [];
+    let typed = null;
+    /** How many reply parts came before the newest typed line. */
+    let upTo = 0;
+    let tampered = false;
+    const ctx = { trailHome: trailHome(env), transcriptPath: path, home: env.HOME || homedir() };
+    for (const [k, { line, offset }] of lines.entries()) {
+        if (k === 0 && list.via === 'init-call')
+            continue;
+        let e;
+        try {
+            e = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (!e || typeof e !== 'object' || e.isSidechain === true)
+            continue;
+        if (e.type === 'assistant') {
+            for (const raw of contentOf(e)) {
+                const part = raw;
+                if (!part || typeof part !== 'object')
+                    continue;
+                if (part.type === 'text' && typeof part.text === 'string')
+                    reply.push(part.text);
+                if (part.type === 'tool_use') {
+                    const input = part.input && typeof part.input === 'object' ? part.input : {};
+                    const name = String(part.name ?? '');
+                    const raw2 = name === 'Bash' && typeof input.command === 'string' ? input.command : null;
+                    try {
+                        if (tamperOf(name, input, raw2, { ...ctx, folder: typeof e.cwd === 'string' ? e.cwd : null }))
+                            tampered = true;
+                    }
+                    catch { /* unreadable call: not counted */ }
+                }
+            }
+        }
+        else if (isTypedByPerson(e, env)) {
+            // b7 (J02 leg C): a handed-over list is in the session's start context, so the person types first and the agent
+            // shows the list in its reply; a typed line before any reply text is not the answer to the list.
+            if (list.via === 'handover' && !reply.some((t) => t.trim()))
+                continue;
+            typed = { offset, lineSha: sha256(line), text: typedText(e, env) };
+            upTo = reply.length;
+        }
+    }
+    const text = reply.slice(0, upTo).join('\n');
+    return { reply: text, replySha: sha256(text), typed, tampered };
+}
+/**
+ * The person's line a pointer names, read again: replay-runs' `typedAt` rules (a transcript in Claude Code's projects
+ * folder reached with no link, the line at the offset with the same sha, a line the person typed), in this light
+ * file so the hook's keep check never loads the replay and compile (R11). Null otherwise.
+ */
+export function typedLine(ref, env = process.env) {
+    try {
+        if (!Number.isSafeInteger(ref.o) || ref.o < 0 || !/^[0-9a-f]{64}$/.test(ref.s) || !claudeTranscript(ref.t, env))
+            return null;
+        const [first] = linesFrom(ref.t, { from: ref.o, bytes: 2 * 1024 * 1024 }) ?? [];
+        if (!first || first.offset !== ref.o)
+            return null;
+        if (ref.o > 0) {
+            const [prev] = linesFrom(ref.t, { from: ref.o - 1, bytes: 1 }) ?? [];
+            if (prev === undefined || prev.line !== '')
+                return null;
+        }
+        if (sha256(first.line) !== ref.s)
+            return null;
+        return typedText(JSON.parse(first.line), env) || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=keep-list.js.map

package/dist/init/keep-list.js.map

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

package/dist/init/keep.d.ts

@@ -0,0 +1,52 @@
+import { type ReviewFinding } from '../notes/pr-reviews.js';
+import type { InitItem } from './types.js';
+export { leadWords, parseKeepAnswer, replyNamesList } from './keep-answer.js';
+export interface KeepResult {
+    kept: InitItem[];
+    notKept: InitItem[];
+    refused: Array<{
+        item: InitItem;
+        why: string;
+    }>;
+    /** Part 7: kept preferences that only repeat a step of a skill kept with them, kept as a lesson on that skill instead. */
+    folded?: Array<{
+        item: InitItem;
+        skill: string;
+    }>;
+}
+/** Where a keep writes: the checkout (phase 0's notes) and its repo key; the run it answers; PR-review findings in memory. */
+export interface KeepPlace {
+    dir: string;
+    repoKey: string;
+    runId?: string | null;
+    reviews?: Map<string, ReviewFinding>;
+}
+/** The person's line for a preference, whole, read again now; null when it changed or is gone. */
+export declare function prefLine(item: Pick<InitItem, 'pref'>, env: NodeJS.ProcessEnv): string | null;
+/** A preference's title: its line, or over 120 characters cut after the last whole word that fits, with an ellipsis. */
+export declare function prefTitle(line: string): string;
+/**
+ * Writes what the person picked: skills (savePersonal, consent 'init'), guardrails and preferences (every-repo.ts,
+ * or writeNote for one repo), PR-review findings (phase 0). `all` is every item shown; on 'tty' and 'keep' the
+ * shown items not kept are closed (a refused one is neither: it can come back), on 'yes' they stay pending.
+ */
+export declare function keepItems(picked: InitItem[], all: InitItem[], how: 'tty' | 'yes' | 'keep', env?: NodeJS.ProcessEnv, now?: Date, place?: KeepPlace): KeepResult;
+export declare const KEEP_USAGE = "trail keep <numbers> keeps items from the list trail init printed, after the person typed their numbers: trail keep 1 3, trail keep all, or trail keep none";
+export declare const KEEP_HELD = "Nothing kept: Trail couldn't find the person's answer after the list.";
+export declare const KEEP_AT_TTY = "Pick in your terminal: trail init --look-back";
+export declare const KEEP_NOTHING_WAITS = "Nothing waits for an answer in this repo: run trail init to look back at your past sessions.";
+/** A relayed item as keep needs it, rebuilt from the record: the person's line read again for a preference's title. */
+/**
+ * The CLI half of `trail keep` (4.9). Always needs a KeepReceipt (R23): the PreToolUse half wrote it after it found
+ * the list, the agent's reply naming every item, and the person's typed numbers. Here everything is read again from
+ * the transcript, and only what still agrees is kept.
+ */
+export declare function keepCommand(args: string[], env: NodeJS.ProcessEnv, now?: Date, opts?: {
+    dir?: string;
+    tty?: boolean;
+    onFound?: () => void;
+}): {
+    code: 0 | 1;
+    lines: string[];
+};
+//# sourceMappingURL=keep.d.ts.map

package/dist/init/keep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep.d.ts","sourceRoot":"","sources":["../../src/init/keep.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA0BhF,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,EAAE,CAAC;IAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,0HAA0H;IAC1H,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,8HAA8H;AAC9H,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACtC;AAYD,kGAAkG;AAClG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAK5F;AAGD,wHAAwH;AACxH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C;AAiFD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,GAAG,GAAE,IAAiB,EACtJ,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,CAmE/B;AAUD,eAAO,MAAM,UAAU,gKAAgK,CAAC;AACxL,eAAO,MAAM,SAAS,0EAA0E,CAAC;AACjG,eAAO,MAAM,WAAW,kDAAkD,CAAC;AAC3E,eAAO,MAAM,kBAAkB,iGAAiG,CAAC;AAwDjI,uHAAuH;AACvH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,EACxF,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAAO,GAAG;IAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CA0CpG"}