@nanonets/graft 0.24.1 → 0.25.0

package/dist/init/install-paths.js

@@ -0,0 +1,87 @@
+/**
+ * D120 (2): the repo paths a `trail init` run may write in each checkout (every
+ * host's repo files, so a retracted one counts too, `.trail/README.md`, the
+ * `.gitignore` and `.ignore` lines the graph build adds and `.trail/.gitignore`,
+ * and what it removes: the graft-named copies in a repo moving from graft, and
+ * the layout before 0.23, the shims under `.claude/helpers/` and the skill in
+ * `.claude/skills/`, which claude/init.ts clears away), looked at before it
+ * writes and recorded after (install-record.ts). Kept out of the hook's import
+ * closure.
+ */
+import { lstatSync, readdirSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { claudeTargetsFor, legacyClaudeTargets } from '../claude/init.js';
+import { planInit } from '../hosts/plan.js';
+import { cursorHookShimRelPath, HOSTS } from '../hosts/registry.js';
+import { repoPlace } from '../notes/home.js';
+import { recordInstall, snapInstall } from './install-record.js';
+const SHIMS = ['graft', 'trail'].flatMap((b) => ['hooks', 'statusline'].map((k) => `.claude/helpers/${b}-${k}.cjs`));
+/** The graph build's ignore lines under graft, and under trail the one file that keeps `.trail/cache/` and the status line out of git (#619). */
+const IGNORES = ['.gitignore', '.ignore', '.trail/.gitignore'];
+/** The plain files under a folder init removes whole (graft's old Claude Code skill folder), at most 50, no links followed. */
+function filesUnder(dir, depth = 0, out = []) {
+    if (depth > 3 || out.length >= 50)
+        return out;
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return out;
+    }
+    for (const n of names.slice(0, 50)) {
+        const p = join(dir, n);
+        try {
+            const st = lstatSync(p);
+            if (st.isFile())
+                out.push(p);
+            else if (st.isDirectory())
+                filesUnder(p, depth + 1, out);
+        }
+        catch { /* gone */ }
+        if (out.length >= 50)
+            break;
+    }
+    return out;
+}
+/**
+ * fix-lab5: what a `trail init` removes in a repo moving from graft's names: graft's Claude Code shims and its whole
+ * `.claude/skills/graft/` folder (claude/init.ts), each owned host's graft-named copy (hosts/init.ts), and Cursor's
+ * graft shim. Looked at before init runs, so a deletion is recorded like a write.
+ */
+function graftCopies(target) {
+    const claude = claudeTargetsFor(target, 'graft').map((w) => w.path);
+    const skillDir = join(target, '.claude', 'skills', 'graft');
+    return [...claude, ...filesUnder(skillDir), ...HOSTS.filter((h) => h.kind === 'owned').map((h) => join(target, h.relPath)),
+        join(target, cursorHookShimRelPath('graft'))];
+}
+/** #619: trail's layout before 0.23, which init clears away in a repo it set up then: its repo skill folder and `.mcp.json` server. */
+function oldTrailLayout(target) {
+    return [...legacyClaudeTargets(target, 'trail').map((w) => w.path), ...filesUnder(join(target, '.claude', 'skills', 'trail'))];
+}
+function pathsFor(target, checkout, home) {
+    const writes = planInit(target, { home }).flatMap((p) => p.writes).filter((w) => w.scope === 'repo').map((w) => w.path);
+    return [...writes, ...graftCopies(target), ...oldTrailLayout(target), ...[...SHIMS, ...IGNORES].map((s) => join(target, s)), join(checkout, '.trail', 'README.md')]
+        .map((p) => relative(checkout, p).split(sep).join('/'))
+        .filter((r) => r && !r.startsWith('..'));
+}
+/** One look per checkout, before init writes anything. */
+export function snapInit(targets, home, env = process.env) {
+    const rels = new Map();
+    for (const target of targets) {
+        const place = repoPlace(target, env);
+        if (place.git)
+            rels.set(place.checkout, [...(rels.get(place.checkout) ?? []), ...pathsFor(target, place.checkout, home)]);
+    }
+    return [...rels].map(([checkout, list]) => snapInstall(checkout, list, env));
+}
+/** After the writes. A record that can't be written only means the probe blocks on init's files, as before. */
+export function recordInit(snaps, env = process.env) {
+    for (const s of snaps) {
+        try {
+            recordInstall(s, env);
+        }
+        catch { /* the probe reads no record */ }
+    }
+}
+//# sourceMappingURL=install-paths.js.map

package/dist/init/install-paths.js.map

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

package/dist/init/keep-answer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The person's answer to init's list, and whether the agent showed that
+ * list (design 4.9 steps 3 and 4). Shared by the PreToolUse keep gate and
+ * `trail keep`'s CLI half, so both decide the same way. No imports beyond
+ * node: the gate loads this on the hook's path.
+ *
+ * - `parseKeepAnswer`: whole-message forms only. Numbers joined by spaces,
+ *   commas, `and` or `&`, with `keep`, `just`, `only` or `please` around
+ *   them; `all`; `none`. Anything else ("sure do whats recommended here",
+ *   "the release one") is no answer: Trail needs the numbers the person typed.
+ * - `replyNamesList`: every item is named as `{n}.` followed by its name
+ *   words, in any wording around them, so a list of the agent's own whose
+ *   numbers point at other items is not the list (R22).
+ */
+import type { KeepAnswer } from './types.js';
+/** The answer a typed message gives, or null when it isn't one of the whole-message forms. */
+export declare function parseKeepAnswer(typed: string): KeepAnswer | null;
+/**
+ * Every item of the list is named in `reply` as `{n}.` followed by its name words (4.9 step 3, R22), and no number
+ * of the list is followed by another item's name words without its own (b6 review): "I'd pick 1. no-timeout" after
+ * the real list would point the person's "1" at item 2.
+ */
+export declare function replyNamesList(reply: string, items: Array<{
+    n: number;
+    nameWords: string[];
+}>): boolean;
+export declare function leadWords(line: string): string[];
+/** The command's numbers are within what the person typed (4.9 step 5). */
+export declare function withinAnswer(asked: KeepAnswer, typed: KeepAnswer, listed: number[]): boolean;
+/**
+ * The words `trail keep` gets from the text after it, the way the shell hands them over: redirections dropped, and
+ * everything from the first `;`, `&`, `|`, `)`, quote, backtick or newline on is another command (`| cat`,
+ * `; echo done`, `&& echo ok`), returned as `more`. Shared by the PreToolUse gate and the CLI half (fix-lab5).
+ */
+export declare function keepWords(text: string): {
+    words: string[];
+    more: string;
+};
+/** `trail keep`'s own arguments as an answer: numbers, `all` or `none`; null for anything else. Shell noise in them is read past (keepWords). */
+export declare function keepArgs(args: string[]): KeepAnswer | null;
+/** "1 and 3", "all", "none": the typed answer in words for a deny reason. */
+export declare function answerWords(a: KeepAnswer): string;
+//# sourceMappingURL=keep-answer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keep-answer.d.ts","sourceRoot":"","sources":["../../src/init/keep-answer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAUhE;AAgCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,GAAG,OAAO,CAMvG;AAID,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhD;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAO5F;AAQD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKzE;AAED,iJAAiJ;AACjJ,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG,IAAI,CAO1D;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAKjD"}

package/dist/init/keep-answer.js

@@ -0,0 +1,118 @@
+const NUMS = /^(?:(?:please|keep|just|only)\s+)*(\d{1,2}(?:\s*(?:,|&|\band\b|\s)\s*\d{1,2})*)(?:\s+please)?$/;
+const ALL = /^(?:please\s+)?(?:keep\s+)?all(?:\s+of\s+them)?(?:\s+please)?$/;
+const NONE = /^(?:(?:keep\s+)?(?:none|nothing)|no)$/;
+/** The answer a typed message gives, or null when it isn't one of the whole-message forms. */
+export function parseKeepAnswer(typed) {
+    if (typeof typed !== 'string' || typed.length > 200)
+        return null;
+    const t = typed.toLowerCase().replace(/[‘’]/g, "'").replace(/\s+/g, ' ').trim().replace(/[.!]+$/, '').trim();
+    if (!t)
+        return null;
+    if (NONE.test(t))
+        return { none: true };
+    if (ALL.test(t))
+        return { all: true };
+    const m = NUMS.exec(t);
+    if (!m)
+        return null;
+    const numbers = [...new Set((m[1].match(/\d{1,2}/g) ?? []).map(Number))].filter((n) => n >= 1).sort((a, b) => a - b);
+    return numbers.length ? { numbers } : null;
+}
+/** Words as the list check compares them: lowercase, curly quotes straightened, split like the candidates' lead words. */
+function tokens(text) {
+    return text.toLowerCase().replace(/[‘’]/g, "'").split(/[^a-z0-9'+-]+/).map((w) => w.replace(/^'+|'+$/g, '')).filter(Boolean);
+}
+/** Whether `want` appears in `have` in order (other words may sit between). */
+function inOrder(have, want) {
+    let k = 0;
+    for (const w of have)
+        if (k < want.length && w === want[k].toLowerCase().replace(/^'+|'+$/g, ''))
+            k++;
+    return k === want.length;
+}
+/**
+ * The text after each `{n}.` marker up to the next marker or line end. A marker is a number of one or two digits
+ * and a dot that is not part of a longer number (`1.` yes, `1.2` and `21.` for 1 no).
+ */
+function segments(text) {
+    const out = new Map();
+    for (const line of text.split('\n')) {
+        const marks = [...line.matchAll(/(?:^|[^\w.])(\d{1,2})\.(?!\d)/g)];
+        marks.forEach((m, k) => {
+            const start = m.index + m[0].length;
+            const end = k + 1 < marks.length ? marks[k + 1].index : line.length;
+            const n = Number(m[1]);
+            out.set(n, [...(out.get(n) ?? []), tokens(line.slice(start, end))]);
+        });
+    }
+    return out;
+}
+/**
+ * Every item of the list is named in `reply` as `{n}.` followed by its name words (4.9 step 3, R22), and no number
+ * of the list is followed by another item's name words without its own (b6 review): "I'd pick 1. no-timeout" after
+ * the real list would point the person's "1" at item 2.
+ */
+export function replyNamesList(reply, items) {
+    if (typeof reply !== 'string' || !items.length)
+        return false;
+    const segs = segments(reply);
+    if (!items.every((it) => it.nameWords.length > 0 && (segs.get(it.n) ?? []).some((s) => inOrder(s, it.nameWords))))
+        return false;
+    return items.every((it) => (segs.get(it.n) ?? []).every((s) => inOrder(s, it.nameWords)
+        || !items.some((o) => o.n !== it.n && o.nameWords.length > 0 && inOrder(s, o.nameWords))));
+}
+/** Lead words of a preference's line, as the candidates make them (candidates.ts): the first 4 that aren't stop words. */
+const STOP = new Set(['a', 'an', 'the', 'to', 'of', 'in', 'on', 'for', 'and', 'or', 'it', 'this', 'that', 'is', 'be', 'with', 'please', 'here', 'i', 'you', 'we']);
+export function leadWords(line) {
+    return line.toLowerCase().split(/[^a-z0-9'+-]+/).filter((w) => w && !STOP.has(w)).slice(0, 4);
+}
+/** The command's numbers are within what the person typed (4.9 step 5). */
+export function withinAnswer(asked, typed, listed) {
+    if ('none' in asked)
+        return 'none' in typed;
+    if ('none' in typed)
+        return false;
+    if ('all' in typed)
+        return true;
+    const ok = new Set(typed.numbers);
+    const want = 'all' in asked ? listed : asked.numbers;
+    return want.length > 0 && want.every((n) => ok.has(n));
+}
+/**
+ * A redirection (`2>&1`, `>/dev/null`, `> out.txt`, `&>/dev/null`, `2>>log`, `< /dev/null`): it changes where the
+ * output goes, never what `trail keep` is asked. Linear: one pass, no nested repeats.
+ */
+const REDIRECT = /(^|\s)(?:\d+|&)?(?:>>?|<)(?:&(?:\d+|-)|\s*[^\s;&|<>()`'"]+)?(?=\s|$|[;&|)])/g;
+/**
+ * The words `trail keep` gets from the text after it, the way the shell hands them over: redirections dropped, and
+ * everything from the first `;`, `&`, `|`, `)`, quote, backtick or newline on is another command (`| cat`,
+ * `; echo done`, `&& echo ok`), returned as `more`. Shared by the PreToolUse gate and the CLI half (fix-lab5).
+ */
+export function keepWords(text) {
+    const s = String(text ?? '').slice(0, 4096).replace(REDIRECT, '$1 ');
+    const cut = s.search(/[;&|)`'"\n]/);
+    const head = cut < 0 ? s : s.slice(0, cut);
+    return { words: head.split(/[\s,]+/).filter(Boolean), more: cut < 0 ? '' : s.slice(cut) };
+}
+/** `trail keep`'s own arguments as an answer: numbers, `all` or `none`; null for anything else. Shell noise in them is read past (keepWords). */
+export function keepArgs(args) {
+    const words = keepWords(args.map(String).join(' ')).words.map((w) => w.toLowerCase());
+    if (words.length === 1 && words[0] === 'none')
+        return { none: true };
+    if (words.length === 1 && words[0] === 'all')
+        return { all: true };
+    if (!words.length || !words.every((w) => /^\d{1,2}$/.test(w)))
+        return null;
+    const numbers = [...new Set(words.map(Number))].filter((n) => n >= 1).sort((a, b) => a - b);
+    return numbers.length === words.length ? { numbers } : null;
+}
+/** "1 and 3", "all", "none": the typed answer in words for a deny reason. */
+export function answerWords(a) {
+    if ('none' in a)
+        return 'none';
+    if ('all' in a)
+        return 'all';
+    const n = a.numbers.map(String);
+    return n.length < 2 ? n.join('') : `${n.slice(0, -1).join(', ')} and ${n[n.length - 1]}`;
+}
+//# sourceMappingURL=keep-answer.js.map

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

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

package/dist/init/keep-gate.d.ts

@@ -0,0 +1,30 @@
+import type { PreBashDecision } from '../claude/pre-bash.js';
+import { type InitRecord } from './init-record.js';
+import type { KeepAnswer } from './types.js';
+export { TAIL_BYTES } from './keep-list.js';
+export declare function isKeepCommand(command: string): boolean;
+/** Whether a shell command runs `trail init`. */
+export declare function isInitCommand(command: string): boolean;
+export declare const WAIT = "Wait for the person's answer before running trail keep: show them the list trail init printed, as written, and run trail keep only with the numbers they choose. Don't choose for them.";
+export declare const CUT = "Show the person the list trail init printed: run trail init again without a pipe or redirect, then ask them.";
+export declare const SHOW_LIST = "Show the person the whole list as trail init printed it, numbers and names, then ask which to keep.";
+export declare const NEED_NUMBERS = "Trail needs the numbers the person typed. Ask them which numbers to keep, or none.";
+export declare const NOT_THIS_LIST = "That list isn't the one waiting in this repo: run trail init again, show the person its list as written, then ask them.";
+export declare const CHANGED = "This session changed Trail's own files after the list, so Trail won't keep anything from it. Run trail init again and show the person its list.";
+/**
+ * What `trail keep` asks for in this command, or null when its words aren't numbers, all or none. `trail keep 1 2>&1`
+ * and `trail keep 1 | cat` ask for 1 (fix-lab5); a second `trail keep` asking for something else is no answer.
+ */
+export declare function keepCommandAnswer(command: string): KeepAnswer | null;
+/** `trail keep --help` or `-h`, with or without a redirect or a reader after it: usage only, never denied (B4, P36). Not when another `trail keep` is chained on. */
+export declare function keepHelp(command: string): boolean;
+/** The pending items with their name words; a preference's rebuilt from the person's line, read again by its pointer. */
+export declare function pendingNames(r: InitRecord, env: NodeJS.ProcessEnv): Array<{
+    n: number;
+    nameWords: string[];
+}>;
+/** receipts/<session-id>.keep.json */
+export declare function keepReceiptPath(sessionId: string, env?: NodeJS.ProcessEnv): string;
+/** The decision for a Bash call: deny a `trail keep` the person hasn't answered for, null (and a receipt) to let it run. Never throws. */
+export declare function keepDecision(input: unknown, _dir: string, env?: NodeJS.ProcessEnv, now?: Date): PreBashDecision | null;
+//# sourceMappingURL=keep-gate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keep-gate.d.ts","sourceRoot":"","sources":["../../src/init/keep-gate.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAIpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAQ5C,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,eAAO,MAAM,IAAI,4LAC0K,CAAC;AAC5L,eAAO,MAAM,GAAG,iHAAiH,CAAC;AAClI,eAAO,MAAM,SAAS,wGAAwG,CAAC;AAC/H,eAAO,MAAM,YAAY,uFAAuF,CAAC;AACjH,eAAO,MAAM,aAAa,4HAA4H,CAAC;AACvJ,eAAO,MAAM,OAAO,oJAAoJ,CAAC;AAUzK;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAMpE;AAED,qKAAqK;AACrK,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED,yHAAyH;AACzH,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAO7G;AAKD,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAElF;AAgBD,0IAA0I;AAC1I,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,GAAG,GAAE,IAAiB,GAAG,eAAe,GAAG,IAAI,CA2D/I"}

package/dist/init/keep-gate.js

@@ -0,0 +1,178 @@
+/**
+ * The PreToolUse check for `trail keep` (design 4.9, PreToolUse half): an
+ * agent may keep init's items only with the numbers the person typed after
+ * seeing the list.
+ *
+ * 1. `trail keep --help` / `-h` pass, nothing else checked (B4, P36).
+ * 2. The list (keep-list.ts, R22): the newest clean `trail init` call's own
+ *    result, or this session's handover offset from the init record. A
+ *    `trail init | tail` (or a redirect) is denied with words that say to run
+ *    it plainly. No list: phase 0's wait reason.
+ * 3. The agent's text between the list and the person's next typed line
+ *    names every pending item as `{n}.` and its name words.
+ * 4. That typed line is a whole-message answer (numbers, all, none).
+ * 5. The command's numbers are within it.
+ * 6. On allow it writes the KeepReceipt `trail keep`'s CLI half needs (R23)
+ *    and returns null. The write is idempotent: both registered copies of the
+ *    hook may run it, and the second finds the same receipt there.
+ *
+ * Loaded lazily by `pre-bash.ts` `keepReply`, only for a command that says
+ * `keep`. Fails open (null) on a payload that isn't Claude Code's or a
+ * transcript it can't read; then no receipt is written and the CLI holds.
+ */
+import { createHash } from 'node:crypto';
+import { detectHost } from '../trace/host.js';
+import { readJsonSafe, trailPath, writePrivate } from '../util/private-fs.js';
+import { listInitRecords } from './init-record.js';
+import { answerWords, keepArgs, keepWords, leadWords, parseKeepAnswer, replyNamesList, withinAnswer } from './keep-answer.js';
+import { afterList, findList, typedLine } from './keep-list.js';
+import { prefText } from './prefs.js';
+export { TAIL_BYTES } from './keep-list.js';
+/** `trail <sub> …` however it's spelled: through a path, npx, node on the built file, inside `bash -c "…"`, after env assignments or `cd … &&`, with global options before the subcommand. */
+const run = (sub) => new RegExp(`(?:^|[\\s;&|(\`'"/=])(?:trail|graft|trail-code)(?:\\.[cm]?[jt]s)?['"]?\\s+(?:--?[\\w-]+(?:=\\S+|\\s+(?!${sub}\\b)[^\\s-]\\S*)?\\s+)*${sub}(?=$|[\\s;&|)'"\`])`);
+const KEEP = run('keep');
+const INIT = run('init');
+export function isKeepCommand(command) {
+    return KEEP.test(command);
+}
+/** Whether a shell command runs `trail init`. */
+export function isInitCommand(command) {
+    return INIT.test(command);
+}
+export const WAIT = "Wait for the person's answer before running trail keep: show them the list trail init printed, as written, and run trail keep only with the numbers they choose. Don't choose for them.";
+export const CUT = 'Show the person the list trail init printed: run trail init again without a pipe or redirect, then ask them.';
+export const SHOW_LIST = 'Show the person the whole list as trail init printed it, numbers and names, then ask which to keep.';
+export const NEED_NUMBERS = 'Trail needs the numbers the person typed. Ask them which numbers to keep, or none.';
+export const NOT_THIS_LIST = "That list isn't the one waiting in this repo: run trail init again, show the person its list as written, then ask them.";
+export const CHANGED = "This session changed Trail's own files after the list, so Trail won't keep anything from it. Run trail init again and show the person its list.";
+const typedOnly = (a) => `The person typed ${answerWords(a)}; keep only those.`;
+/** What `trail keep` asks for in this command, or null when its words aren't numbers, all or none. */
+/** Every `trail keep` in the command, as the words each one gets (keepWords: redirections and trailing commands read past). */
+function keepCalls(command) {
+    const all = new RegExp(KEEP.source, 'g');
+    return [...String(command).slice(0, 64 * 1024).matchAll(all)].slice(0, 8).map((m) => keepWords(command.slice(m.index + m[0].length)).words);
+}
+/**
+ * What `trail keep` asks for in this command, or null when its words aren't numbers, all or none. `trail keep 1 2>&1`
+ * and `trail keep 1 | cat` ask for 1 (fix-lab5); a second `trail keep` asking for something else is no answer.
+ */
+export function keepCommandAnswer(command) {
+    const calls = keepCalls(command);
+    if (!calls.length)
+        return null;
+    const answers = calls.map((w) => keepArgs(w));
+    const first = answers[0];
+    return first && answers.every((a) => JSON.stringify(a) === JSON.stringify(first)) ? first : null;
+}
+/** `trail keep --help` or `-h`, with or without a redirect or a reader after it: usage only, never denied (B4, P36). Not when another `trail keep` is chained on. */
+export function keepHelp(command) {
+    const calls = keepCalls(command);
+    return calls.length === 1 && calls[0].length === 1 && /^(?:--help|-h)$/.test(calls[0][0]);
+}
+/** The pending items with their name words; a preference's rebuilt from the person's line, read again by its pointer. */
+export function pendingNames(r, env) {
+    return r.pending.map((p) => {
+        if (p.kind !== 'preference')
+            return { n: p.n, nameWords: p.nameWords };
+        const ref = p.pref?.refs[0];
+        const text = ref ? typedLine(ref, env) : null;
+        return { n: p.n, nameWords: text ? leadWords(prefText(text).slice(0, 120)) : [] };
+    });
+}
+const fileId = (sessionId) => /^[A-Za-z0-9_-][A-Za-z0-9._-]{0,127}$/.test(sessionId) ? sessionId : `h-${createHash('sha256').update(sessionId).digest('hex').slice(0, 16)}`;
+/** receipts/<session-id>.keep.json */
+export function keepReceiptPath(sessionId, env) {
+    return trailPath(env, 'receipts', `${fileId(sessionId)}.keep.json`);
+}
+const sameAnswer = (a, b) => a.session === b.session && a.toolUseId === b.toolUseId && a.list.offset === b.list.offset && a.list.initRunId === b.list.initRunId
+    && a.typed.offset === b.typed.offset && a.typed.lineSha === b.typed.lineSha && a.replySha === b.replySha && JSON.stringify(a.numbers) === JSON.stringify(b.numbers);
+/** Writes the receipt unless the same one, unused, is already there (the other hook copy wrote it). */
+function writeKeepReceipt(r, env) {
+    const path = keepReceiptPath(r.session, env);
+    const cur = readJsonSafe(path);
+    if (cur && cur.usedAt === null && sameAnswer(cur, r))
+        return;
+    writePrivate(path, `${JSON.stringify(r, null, 2)}\n`);
+}
+const deny = (reason) => ({ permissionDecision: 'deny', reason });
+/** The decision for a Bash call: deny a `trail keep` the person hasn't answered for, null (and a receipt) to let it run. Never throws. */
+export function keepDecision(input, _dir, env = process.env, now = new Date()) {
+    try {
+        if (!input || typeof input !== 'object' || Array.isArray(input))
+            return null;
+        const payload = input;
+        const command = payload.tool_input?.command;
+        if (typeof command !== 'string' || !isKeepCommand(command))
+            return null;
+        // Another host's transcript isn't Claude Code's to read.
+        if (detectHost(payload).host !== 'claude')
+            return null;
+        if (keepHelp(command) && !isInitCommand(command))
+            return null;
+        if (isInitCommand(command))
+            return deny(WAIT);
+        const path = payload.transcript_path;
+        const session = typeof payload.session_id === 'string' ? payload.session_id : '';
+        if (typeof path !== 'string' || !path || !session)
+            return null;
+        // Every record on this machine, not the cwd's repo: resolving the repo would load the notes layer on the hook's path.
+        const records = listInitRecords(env);
+        const handed = records.filter((x) => x.record.handover?.session === session && x.record.pending.length && x.record.pendingFrom)
+            .sort((a, b) => b.record.handover.offset - a.record.handover.offset)[0];
+        const found = findList(path, isInitCommand, handed ? { offset: handed.record.handover.offset } : null);
+        if (!found)
+            return null;
+        if (found.cut !== null)
+            return deny(CUT);
+        const list = found.list;
+        if (!list)
+            return deny(WAIT);
+        let record = null;
+        let items = [];
+        if (list.via === 'handover') {
+            record = handed.record;
+            items = pendingNames(record, env);
+        }
+        else {
+            // The record whose waiting list is the one this call printed, newest first.
+            for (const x of records.filter((r) => r.record.pending.length && r.record.pendingFrom).sort((a, b) => String(b.record.shownAt).localeCompare(String(a.record.shownAt)))) {
+                const names = pendingNames(x.record, env);
+                if (replyNamesList(list.text, names)) {
+                    record = x.record;
+                    items = names;
+                    break;
+                }
+            }
+        }
+        if (!record || !record.pendingFrom)
+            return deny(NOT_THIS_LIST);
+        const after = afterList(path, list, env);
+        if (!after)
+            return null;
+        if (after.tampered)
+            return deny(CHANGED);
+        if (!after.typed)
+            return deny(WAIT);
+        if (!replyNamesList(after.reply, items))
+            return deny(SHOW_LIST);
+        const typed = parseKeepAnswer(after.typed.text);
+        if (!typed)
+            return deny(NEED_NUMBERS);
+        const asked = keepCommandAnswer(command);
+        if (!asked)
+            return deny(NEED_NUMBERS);
+        if (!withinAnswer(asked, typed, record.pending.map((p) => p.n)))
+            return deny(typedOnly(typed));
+        writeKeepReceipt({
+            v: 1, kind: 'keep', session, transcriptPath: path, toolUseId: typeof payload.tool_use_id === 'string' ? payload.tool_use_id : '',
+            list: { offset: list.offset, initRunId: record.pendingFrom, via: list.via },
+            typed: { offset: after.typed.offset, lineSha: after.typed.lineSha }, replySha: after.replySha,
+            numbers: 'none' in asked ? 'none' : 'all' in asked ? 'all' : asked.numbers, at: now.toISOString(), verdict: 'live', usedAt: null,
+        }, env);
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=keep-gate.js.map

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

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

package/dist/init/keep-list.d.ts

@@ -0,0 +1,67 @@
+/** How much of the transcript is read: the list is printed moments before the answer. */
+export declare const TAIL_BYTES: number;
+/** Whole lines with their byte offsets, from `from` (a line start) or the last `bytes` of the file; null when unreadable. */
+export declare function linesFrom(path: string, opts: {
+    from?: number;
+    bytes?: number;
+}): Array<{
+    line: string;
+    offset: number;
+}> | null;
+/**
+ * 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 declare function initOnly(command: string): boolean;
+export interface ListAt {
+    via: 'init-call' | 'handover';
+    /** The tool_result line's offset (init call), or the handover's recorded offset. */
+    offset: number;
+    /** The tool result's text (init call); '' for a handover. */
+    text: string;
+}
+/**
+ * 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 declare function findList(path: string, isInit: (command: string) => boolean, handover: {
+    offset: number;
+} | null): {
+    list: ListAt | null;
+    cut: number | null;
+} | null;
+export interface AfterList {
+    /** The agent's text between the list and the person's newest typed line, joined by newlines. */
+    reply: string;
+    replySha: string;
+    typed: {
+        offset: number;
+        lineSha: string;
+        text: string;
+    } | null;
+    /** A call after the list wrote Trail's or the host's files. */
+    tampered: boolean;
+}
+/**
+ * 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 declare function afterList(path: string, list: {
+    offset: number;
+    via: 'init-call' | 'handover';
+}, env?: NodeJS.ProcessEnv): AfterList | null;
+/**
+ * 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 declare function typedLine(ref: {
+    t: string;
+    o: number;
+    s: string;
+}, env?: NodeJS.ProcessEnv): string | null;
+//# sourceMappingURL=keep-list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keep-list.d.ts","sourceRoot":"","sources":["../../src/init/keep-list.ts"],"names":[],"mappings":"AA4BA,yFAAyF;AACzF,eAAO,MAAM,UAAU,QAAkB,CAAC;AAI1C,6HAA6H;AAC7H,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAmC/H;AAcD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIjD;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,WAAW,GAAG,UAAU,CAAC;IAC9B,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,EAAE,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAC9G;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAmCnD;AAED,MAAM,WAAW,SAAS;IACxB,gGAAgG;IAChG,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChE,+DAA+D;IAC/D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,WAAW,GAAG,UAAU,CAAA;CAAE,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,SAAS,GAAG,IAAI,CA0CvJ;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAcvH"}