@nanonets/graft 0.24.0 → 0.25.0

package/dist/init/install-record.js

@@ -0,0 +1,144 @@
+/**
+ * D120 (2): the install record, `<trail home>/state/installed/<checkout hash>.json`:
+ * the repo paths `trail init` wrote in one checkout, each with the sha256 of what
+ * it wrote (null for a file it deleted). The clean-tree ready probe ignores a
+ * dirty path only while it is in this record and still holds those bytes, so any
+ * later edit blocks again.
+ *
+ * A path counts as init's when init changed it and it was clean in git just
+ * before (or the last record already had it, unchanged since). A path the person
+ * had dirty before init stays theirs, whatever init then wrote into it. Links,
+ * FIFOs and files over 1 MB are never recorded or vouched for.
+ */
+import { spawnSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { closeSync, fstatSync, lstatSync, readSync, realpathSync } from 'node:fs';
+import { join } from 'node:path';
+import { trailPath, writePrivate } from '../util/private-fs.js';
+import { openPlain, readPlain } from './plain-file.js';
+const MAX_FILE = 1024 * 1024;
+const MAX_PATHS = 200;
+const REL = /^(?!\/)(?!.*(?:^|\/)\.\.?(?:\/|$))[\w.@+-]+(?:\/[\w.@+-]+)*$/;
+const SHA = /^[0-9a-f]{64}$/;
+function real(checkout) {
+    try {
+        return realpathSync.native(checkout);
+    }
+    catch {
+        return checkout;
+    }
+}
+export function installRecordPath(checkout, env) {
+    const key = createHash('sha256').update(real(checkout)).digest('hex').slice(0, 16);
+    return trailPath(env, 'state', 'installed', `${key}.json`);
+}
+/** The sha256 of a plain file's bytes; null when nothing is there; false for a link, a FIFO, a folder or a big file. */
+export function fileSha(path) {
+    try {
+        if (!lstatSync(path).isFile())
+            return false;
+    }
+    catch {
+        return null;
+    }
+    let fd = -1;
+    try {
+        fd = openPlain(path);
+        const size = fstatSync(fd).size;
+        if (size > MAX_FILE)
+            return false;
+        const buf = Buffer.alloc(size);
+        let off = 0;
+        while (off < size) {
+            const n = readSync(fd, buf, off, size - off, off);
+            if (n <= 0)
+                break;
+            off += n;
+        }
+        return createHash('sha256').update(buf.subarray(0, off)).digest('hex');
+    }
+    catch {
+        return false;
+    }
+    finally {
+        if (fd >= 0)
+            closeSync(fd);
+    }
+}
+/** The record for this checkout, or null when there is none or it names another checkout. */
+export function readInstallRecord(checkout, env) {
+    let raw;
+    try {
+        const text = readPlain(installRecordPath(checkout, env), MAX_FILE);
+        if (text === null)
+            return null;
+        raw = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    const r = raw;
+    if (!r || r.v !== 1 || r.checkout !== real(checkout) || !r.files || typeof r.files !== 'object' || Array.isArray(r.files))
+        return null;
+    const out = {};
+    for (const [rel, sha] of Object.entries(r.files).slice(0, MAX_PATHS)) {
+        if (REL.test(rel) && (sha === null || (typeof sha === 'string' && SHA.test(sha))))
+            out[rel] = sha;
+    }
+    return out;
+}
+/** Whether `rel` is a path init recorded here that still holds what init left (absent, for one it deleted). */
+export function initLeftIt(files, checkout, rel) {
+    if (!files || !Object.hasOwn(files, rel) || !REL.test(rel))
+        return false;
+    return fileSha(join(checkout, rel)) === files[rel];
+}
+/** The paths of `git status --porcelain -z` (a rename's both sides), for the paths asked about. */
+function dirtyPaths(checkout, rels, env) {
+    if (!rels.length)
+        return new Set();
+    const r = spawnSync('git', ['status', '--porcelain', '-z', '--untracked-files=all', '--', ...rels], {
+        cwd: checkout, encoding: 'utf8', timeout: 10_000, env: { ...env, GIT_OPTIONAL_LOCKS: '0', GIT_TERMINAL_PROMPT: '0' },
+    });
+    if (r.status !== 0 || typeof r.stdout !== 'string')
+        return null;
+    const out = new Set();
+    const parts = r.stdout.split('\0');
+    for (let i = 0; i < parts.length; i++) {
+        const p = parts[i];
+        if (p.length < 4)
+            continue;
+        out.add(p.slice(3));
+        if (p[0] === 'R' || p[0] === 'C')
+            out.add(parts[++i] ?? '');
+    }
+    return out;
+}
+/** Before init writes: what each path holds, which were dirty already, and the last record. */
+export function snapInstall(checkout, rels, env = process.env) {
+    const list = [...new Set(rels.filter((r) => REL.test(r)))].slice(0, MAX_PATHS);
+    const dirty = dirtyPaths(checkout, list, env);
+    const before = new Map(list.map((rel) => [rel, fileSha(join(checkout, rel))]));
+    // When git can't say, every path counts as dirty: nothing is vouched for that the probe couldn't check either.
+    return { checkout, rels: list, before, dirty: dirty ?? new Set(list), prior: readInstallRecord(checkout, env) };
+}
+/** After init wrote: record the paths it made its own, and return them. */
+export function recordInstall(snap, env = process.env) {
+    const files = {};
+    for (const rel of snap.rels) {
+        const before = snap.before.get(rel);
+        const after = fileSha(join(snap.checkout, rel));
+        if (before === false || after === false)
+            continue;
+        const vouched = !!snap.prior && Object.hasOwn(snap.prior, rel) && snap.prior[rel] === before;
+        if (vouched || (before !== after && !snap.dirty.has(rel)))
+            files[rel] = after ?? null;
+    }
+    // Nothing init wrote, and nothing there before: no record at all.
+    const kept = Object.keys(files);
+    if (!kept.length && !snap.prior)
+        return kept;
+    writePrivate(installRecordPath(snap.checkout, env), `${JSON.stringify({ v: 1, checkout: real(snap.checkout), files }, null, 2)}\n`);
+    return kept;
+}
+//# sourceMappingURL=install-record.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-record.js","sourceRoot":"","sources":["../../src/init/install-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;AAC7B,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,GAAG,GAAG,8DAA8D,CAAC;AAC3E,MAAM,GAAG,GAAG,gBAAgB,CAAC;AAa7B,SAAS,IAAI,CAAC,QAAgB;IAC5B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,GAAuB;IACzE,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnF,OAAO,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,wHAAwH;AACxH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE;YAAE,OAAO,KAAK,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACZ,IAAI,CAAC;QACH,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;QAChC,IAAI,IAAI,GAAG,QAAQ;YAAE,OAAO,KAAK,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,OAAO,GAAG,GAAG,IAAI,EAAE,CAAC;YAClB,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC;gBAAE,MAAM;YAClB,GAAG,IAAI,CAAC,CAAC;QACX,CAAC;QACD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,IAAI,EAAE,IAAI,CAAC;YAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,GAAuB;IACzE,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;QACnE,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/B,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,CAAC,GAAG,GAA2D,CAAC;IACtE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvI,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;QAChG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACpG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,UAAU,CAAC,KAA0B,EAAE,QAAgB,EAAE,GAAW;IAClF,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACzE,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,mGAAmG;AACnG,SAAS,UAAU,CAAC,QAAgB,EAAE,IAAc,EAAE,GAAsB;IAC1E,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IACnC,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE;QAClG,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE;KACrH,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAChE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC3B,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,IAAc,EAAE,MAAyB,OAAO,CAAC,GAAG;IAChG,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAU,CAAC,CAAC,CAAC;IACxF,+GAA+G;IAC/G,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;AAClH,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,aAAa,CAAC,IAAiB,EAAE,MAAyB,OAAO,CAAC,GAAG;IACnF,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;QAChD,IAAI,MAAM,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK;YAAE,SAAS;QAClD,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC;QAC7F,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC;IACxF,CAAC;IACD,kEAAkE;IAClE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAC7C,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACpI,OAAO,IAAI,CAAC;AACd,CAAC"}

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