@nanonets/graft 0.23.1 → 0.24.1

package/dist/trace/shell.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Reading a shell command the way the shell does, without running anything.
+ *
+ * Agents write commit messages in `"$(cat <<'EOF' ... EOF)"`, wrap commands
+ * in `(cd x && ...)`, poll in `for` loops and pipe everything through
+ * `| tail`. A plain split on `;` or `|` turns a word inside a quote, a
+ * substitution or a heredoc body into a "step", so this reads top-level
+ * segments only: quotes, `$'…'`, `$(…)`, backticks, `(…)` subshells, `{…}`
+ * groups, `[[…]]`, loops and ifs are opaque, and a heredoc body belongs to the
+ * segment whose line opened it.
+ *
+ * The PreToolUse fast path loads this file: its imports are the lexer,
+ * `shell-scan.ts`, and the program-word layer on it, `shell-words.ts`; the
+ * lexer imports nothing.
+ *
+ * Every reader here is linear in the command's length (a skill's step is
+ * matched against each command the agent runs, in the PreToolUse hook) and
+ * reads nesting only to a fixed depth.
+ */
+import type { CallKind } from './types.js';
+import { PLUMBING, RUNNERS, bareCommand, heredocInterpreter, hookUnrun, inlineScript, quotedTextHit, readsFiles, scriptKind, simpleCommands } from './shell-words.js';
+export { PLUMBING, RUNNERS, bareCommand, heredocInterpreter, hookUnrun, inlineScript, quotedTextHit, readsFiles, scriptKind, simpleCommands };
+export interface Segment {
+    text: string;
+    sep: '&&' | '||' | ';' | '|' | '&' | '';
+}
+/**
+ * Top-level segments. Opaque: '…', "…", $'…', $(…), `…`, a (…) subshell, a {…} group, and a heredoc
+ * body (the lines after `<<[-~]?\s*['"]?WORD['"]?` up to the line that is exactly WORD), which belongs to
+ * the segment whose line opened it. Each segment keeps the separator after it; a trailing `&` gives '&'.
+ */
+export declare function splitTop(cmd: string): Segment[];
+/** Any heredoc, or a newline outside quotes and heredoc bodies (a `\`-continued line is not one). */
+export declare function isMultiLine(cmd: string): boolean;
+/** `A=1 B=2 cmd` -> { env: ['A=1','B=2'], rest: 'cmd' }. */
+export declare function envPrefix(cmd: string): {
+    env: string[];
+    rest: string;
+};
+/**
+ * Every leading `cd X &&` / `cd X;` segment in order (`cd X || exit 1` on its own line is one too), and
+ * `(cd X && rest)` when the subshell is the whole command.
+ */
+export declare function leadingCds(cmd: string, depth?: number): {
+    cds: string[];
+    rest: string;
+};
+/** Drops a leading `sleep N;` / `sleep N &&`. A sleep inside a subshell or pipe stays. */
+export declare function stripLeadingSleep(cmd: string): string;
+/** Drops a leading `timeout N ` / `gtimeout N ` (also right after env prefixes). */
+export declare function stripTimeout(cmd: string): string;
+/** Drops trailing `| tail…`, `| head…`, `| less`, `| more`, `| cat` segments and the `2>&1` that fed them. */
+export declare function stripOutputFilters(cmd: string): string;
+/** Drops a last segment that is only `echo …` or `printf …` after `&&`, `;` or `||`. */
+export declare function stripTrailingEcho(cmd: string): string;
+/**
+ * The first segment's program after env prefixes, leading cds, `time`, `nice`, `command`, and a
+ * `script -q /dev/null` wrapper; two words for RUNNERS (`git push`, `gh pr`, `npm run`, `npx vitest`).
+ * Never a word from inside quotes or a heredoc body.
+ */
+export declare function programOf(cmd: string): string | null;
+/** Read-only exploration (4.1 kinds). */
+export declare function isLookOnly(cmd: string): boolean;
+/** Changes the work itself rather than running the job (4.1 kinds). */
+export declare function isWork(cmd: string): boolean;
+/** plumbing, work, look or step from the command alone (4.1; the fold also counts read-only check families as look). */
+export declare function commandKind(cmd: string): CallKind;
+/**
+ * Any part of the command runs Trail: trail, graft, npx @trailhq/trail-code, npx @nanonets/graft,
+ * node …/dist/bin/(trail|graft).js. For "a skill never runs Trail" (4.11). The fold's "Trail's own
+ * command, ignored" (4.1) is `onlyTrail`: `trail x; rm ~/.trail/y` runs Trail and is not only Trail.
+ */
+export declare function isTrailCommand(cmd: string): boolean;
+/**
+ * The whole command is Trail's own (4.1 "ignored entirely", and the tamper check's exemption): it runs
+ * Trail, and everything else in it only reads or sets up the shell. Not when any part writes a file
+ * (a redirect, cp, tee), runs code inside a word (`$( )`, backticks), runs another program, or changes
+ * which `trail` runs (PATH, an alias, a function, a path to a `trail`).
+ */
+export declare function onlyTrail(cmd: string): boolean;
+/** For comparisons: output filters, trailing echo, leading cds, leading sleep and timeout stripped; quotes removed; spaces collapsed. */
+export declare function normalizeCommand(cmd: string): string;
+/**
+ * A step matches a command that ran when, after normalizeCommand on both, the step (params filled from
+ * `values` where known, other {params} as \S+) matches at the start of the ran command or right after a
+ * top-level `&& ` or `; `. Env prefixes are compared too, unless `ignoreEnv`.
+ */
+export declare function stepMatches(step: string, ran: string, values?: Record<string, string>, ignoreEnv?: boolean): boolean;
+/** Absolute path tokens: under repoRoot become repo-relative (`./x` or `x`); under home become `$HOME/…`; `~/` becomes `$HOME/`. */
+export declare function relativizePaths(cmd: string, repoRoot: string, home: string): string;
+//# sourceMappingURL=shell.d.ts.map

package/dist/trace/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/trace/shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EACM,QAAQ,EAAE,OAAO,EAA6B,WAAW,EAAc,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAC7H,aAAa,EAAE,UAAU,EAAE,UAAU,EAA0B,cAAc,EAC9E,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AAE9I,MAAM,WAAW,OAAO;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAA;CAAE;AAElF;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE,CAG/C;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGhD;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAUtE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA+BlF;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUhD;AAED,8GAA8G;AAC9G,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAatD;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASrD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIpD;AAmFD,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG/C;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED,wHAAwH;AACxH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAEjD;AA8BD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGnD;AAyCD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAcD,yIAAyI;AACzI,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAID;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAyBtH;AAED,oIAAoI;AACpI,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASnF"}

package/dist/trace/shell.js

@@ -0,0 +1,435 @@
+import { ASSIGN, OPEN_KW, base, cut, pieceText, scan, unquote, words } from './shell-scan.js';
+import { MAX_DEPTH, PLUMBING, RUNNERS, VALUE_FLAGS, afterTimeout, bareCommand, groupInner, heredocInterpreter, hookUnrun, inlineScript, programOfText, programWords, quotedTextHit, readsFiles, scriptKind, shellOnly, shellScript, simpleCommands, stripKeywords, writesFile, } from './shell-words.js';
+export { PLUMBING, RUNNERS, bareCommand, heredocInterpreter, hookUnrun, inlineScript, quotedTextHit, readsFiles, scriptKind, simpleCommands };
+/**
+ * Top-level segments. Opaque: '…', "…", $'…', $(…), `…`, a (…) subshell, a {…} group, and a heredoc
+ * body (the lines after `<<[-~]?\s*['"]?WORD['"]?` up to the line that is exactly WORD), which belongs to
+ * the segment whose line opened it. Each segment keeps the separator after it; a trailing `&` gives '&'.
+ */
+export function splitTop(cmd) {
+    const s = String(cmd ?? '');
+    return scan(s).segs.map((p) => ({ text: pieceText(s, p), sep: p.sep }));
+}
+/** Any heredoc, or a newline outside quotes and heredoc bodies (a `\`-continued line is not one). */
+export function isMultiLine(cmd) {
+    const r = scan(String(cmd ?? ''));
+    return r.heredoc || r.newline;
+}
+/** `A=1 B=2 cmd` -> { env: ['A=1','B=2'], rest: 'cmd' }. */
+export function envPrefix(cmd) {
+    const s = String(cmd ?? '').trimStart();
+    const env = [];
+    let at = 0;
+    for (const w of words(s)) {
+        if (!ASSIGN.test(w))
+            break;
+        env.push(w);
+        at = s.indexOf(w, at) + w.length;
+    }
+    return { env, rest: env.length ? s.slice(at).trim() : s.trim() };
+}
+/**
+ * Every leading `cd X &&` / `cd X;` segment in order (`cd X || exit 1` on its own line is one too), and
+ * `(cd X && rest)` when the subshell is the whole command.
+ */
+export function leadingCds(cmd, depth = 0) {
+    const s = String(cmd ?? '').trim();
+    const { segs } = scan(s);
+    const cds = [];
+    let k = 0;
+    for (; k < segs.length; k++) {
+        const p = segs[k];
+        const w = words(s.slice(p.start, p.end));
+        if (w[0] !== 'cd' || w.length > 2 || p.bodies.length)
+            break;
+        let end = k;
+        if (p.sep === '||') {
+            const q = segs[k + 1];
+            const e = q ? words(s.slice(q.start, q.end)) : [];
+            if (!q || q.bodies.length || q.group || !/^(?:exit|return)$/.test(e[0] ?? '') || e.length > 2)
+                break;
+            end = k + 1;
+        }
+        const sep = segs[end].sep;
+        if (end < segs.length - 1 && sep !== '&&' && sep !== ';')
+            break;
+        if (end === segs.length - 1 && sep !== '')
+            break;
+        cds.push(w[1] === undefined ? '~' : unquote(w[1]));
+        k = end;
+    }
+    if (k === segs.length && k > 0)
+        return { cds, rest: '' };
+    const rest = k ? s.slice(segs[k].start).trim() : s;
+    const only = scan(rest).segs;
+    const g = only.length === 1 ? only[0].group : null;
+    if (g && rest[g.open] === '(' && g.close === rest.length - 1 && depth < MAX_DEPTH && /^\s*cd\b/.test(rest.slice(g.open + 1))) {
+        const inner = leadingCds(rest.slice(g.open + 1, g.close), depth + 1);
+        if (inner.cds.length)
+            return { cds: [...cds, ...inner.cds], rest: inner.rest };
+    }
+    return { cds, rest };
+}
+/** Drops a leading `sleep N;` / `sleep N &&`. A sleep inside a subshell or pipe stays. */
+export function stripLeadingSleep(cmd) {
+    const s = String(cmd ?? '').trim();
+    const { segs } = scan(s);
+    let k = 0;
+    for (; k < segs.length - 1; k++) {
+        const p = segs[k];
+        if (p.sep !== ';' && p.sep !== '&&')
+            break;
+        const w = words(s.slice(p.start, p.end));
+        if (w[0] !== 'sleep' || w.length !== 2)
+            break;
+    }
+    return k ? s.slice(segs[k].start).trim() : s;
+}
+/** Drops a leading `timeout N ` / `gtimeout N ` (also right after env prefixes). */
+export function stripTimeout(cmd) {
+    const s = String(cmd ?? '').trim();
+    const { env, rest } = envPrefix(s);
+    const w = words(rest);
+    const after = afterTimeout(w);
+    if (!after?.length)
+        return s;
+    // Cut the original text where the command after the duration starts, so its spacing and quotes stay as typed.
+    let at = 0;
+    for (const word of w.slice(0, w.length - after.length))
+        at = rest.indexOf(word, at) + word.length;
+    return [...env, rest.slice(at).trim()].join(' ').trim();
+}
+/** Drops trailing `| tail…`, `| head…`, `| less`, `| more`, `| cat` segments and the `2>&1` that fed them. */
+export function stripOutputFilters(cmd) {
+    let s = String(cmd ?? '').trim();
+    for (;;) {
+        const { segs, keep } = scan(s);
+        let k = segs.length;
+        while (k > 1 && segs[k - 2].sep === '|' && /^(?:tail|head|less|more|cat)$/.test(words(s.slice(segs[k - 1].start, segs[k - 1].end))[0] ?? ''))
+            k--;
+        if (k === segs.length)
+            return s;
+        const prev = segs[k - 1];
+        const head = s.slice(prev.start, prev.end);
+        const redirect = /\s*2>&1\s*$/.exec(head);
+        const from = redirect ? prev.start + redirect.index : prev.end;
+        s = cut(s, [[from, segs[segs.length - 1].end]], keep);
+    }
+}
+/** Drops a last segment that is only `echo …` or `printf …` after `&&`, `;` or `||`. */
+export function stripTrailingEcho(cmd) {
+    const s = String(cmd ?? '').trim();
+    const { segs, keep } = scan(s);
+    if (segs.length < 2)
+        return s;
+    const prev = segs[segs.length - 2];
+    const last = segs[segs.length - 1];
+    if (prev.sep !== '&&' && prev.sep !== ';' && prev.sep !== '||')
+        return s;
+    if (!/^(?:echo|printf)$/.test(words(s.slice(last.start, last.end))[0] ?? '') || last.bodies.length)
+        return s;
+    return cut(s, [[prev.end, last.end]], keep);
+}
+/**
+ * The first segment's program after env prefixes, leading cds, `time`, `nice`, `command`, and a
+ * `script -q /dev/null` wrapper; two words for RUNNERS (`git push`, `gh pr`, `npm run`, `npx vitest`).
+ * Never a word from inside quotes or a heredoc body.
+ */
+export function programOf(cmd) {
+    const s = String(cmd ?? '').trim();
+    if (!s)
+        return null;
+    return programOfText(leadingCds(s).rest || s).prog;
+}
+/** `find` actions that change files or run commands: such a find is not a look. */
+const FIND_ACTS = /^-(?:delete|exec|execdir|ok|okdir|fprint0?|fprintf|fls)$/;
+/**
+ * Commands that only report on the machine, reshape text, read an API or print a version or help: they
+ * run, but change nothing, so they are looks (on the program words, wrappers gone; a file redirect still
+ * makes them work).
+ */
+const INFO = /^(?:date|uname|hostname|sw_vers|whoami|id|uptime|nproc|ps|pgrep|lsof|vm_stat|printenv|sysctl|seq|tr|sort(?![^|;&]*\s-\w*o)|uniq|cut|awk|column|paste|comm|nl|diff|cmp|basename|dirname|realpath|readlink|od|xxd|strings|xargs echo|git (?:rev-list|for-each-ref|name-rev|ls-tree)|docker (?:ps|images|inspect|logs|version|context (?:ls|inspect|show))|colima (?:status|list|ls)|kubectl (?:get|describe|logs)|npm config get|git config --get|brew (?:list|info)|open(?!\s+-[aAbe]\b)|gh (?:repo|release) (?:list|view)|gh api(?![^|;&]*\s(?:-X|--method|-f|-F|--field|--raw-field|--input)\b))(?:\s|$)|^(?:npx(?:\s+-[\w-]+)*\s+)?[\w.@/+-]+(?: [\w-]+)? (?:--version|-v|-V|version|--help|-h|help)(?:\s+\d?>>?&?\s*[^\s&>]\S*)*$/;
+/**
+ * A segment's kind on its own: plumbing, work, look or step. A top-level redirect into a file turns
+ * a look or plumbing segment into work: `grep x a > ~/.trail/y` writes a file, and the tamper check
+ * (4.1) trusts that a look only reads.
+ */
+function segKind(s, p, depth) {
+    if (p.group)
+        return kindOf(groupInner(s, p), depth + 1);
+    const head = s.slice(p.start, p.end);
+    // D51, D58 e: an interpreter's heredoc program is read for what it does; it is never a step.
+    const prog = p.bodies.length ? heredocInterpreter(programWords(head)) : null;
+    if (prog)
+        return scriptKind(p.bodies.map(([a, b]) => s.slice(a, b)).join('\n'), prog) === 'look' && !writesFile(head) ? 'look' : 'work';
+    const k = readKind(head, depth);
+    return (k === 'look' || k === 'plumbing') && writesFile(head) ? 'work' : k;
+}
+function readKind(head, depth) {
+    const w = programWords(head);
+    const prog = base(w[0] ?? '');
+    if (OPEN_KW.has(w[0] ?? '')) {
+        const inner = stripKeywords(head);
+        if (inner !== head)
+            return kindOf(inner, depth + 1);
+    }
+    if (!w.length || shellOnly(prog))
+        return 'plumbing';
+    if (INFO.test(w.join(' ').replace(/^docker(?:\s+(?:--context|-c|--host|-H)[ =]\S+)+/, 'docker')))
+        return 'look';
+    const sub = w.slice(1).filter((a) => !a.startsWith('-'));
+    const flags = w.slice(1).filter((a) => a.startsWith('-'));
+    if (prog === 'git') {
+        const g = w.slice(1).filter((a, i, all) => !a.startsWith('-') && !VALUE_FLAGS.git.has(all[i - 1] ?? ''));
+        const verb = g[0];
+        if ((verb === 'worktree' || verb === 'stash') && /^(?:list|show)$/.test(g[1] ?? ''))
+            return 'look';
+        if (verb === 'tag' && (g.length === 1 || flags.some((f) => /^(?:-l|--list|--contains|--points-at)$/.test(f))))
+            return 'look';
+        if (verb && /^(?:add|commit|stash|restore|rm|mv|apply|am)$/.test(verb))
+            return 'work';
+        if (verb === 'checkout' && w.includes('--'))
+            return 'work';
+        if (verb && /^(?:status|log|diff|show|ls-files|blame|describe|reflog|shortlog)$/.test(verb))
+            return flags.some((f) => /^--output\b/.test(f)) ? 'step' : 'look';
+        if (verb === 'rev-parse' && !w.includes('--verify'))
+            return 'look';
+        if (verb === 'remote' && g.length === 1)
+            return 'look';
+        if (verb === 'branch' && g.length === 1 && !flags.some((f) => /^-(?:[dDmMcCfu]|-delete|-move|-copy|-force|-set-upstream-to|-unset-upstream|-edit-description)/.test(f)))
+            return 'look';
+        return 'step';
+    }
+    if (prog === 'gh') {
+        if (/^(?:pr (?:view|list|diff)|run list|issue (?:view|list)|repo view)$/.test(sub.slice(0, 2).join(' ')))
+            return 'look';
+        return 'step';
+    }
+    if (prog === 'npm' && sub[0] === 'ls')
+        return 'look';
+    if (prog === 'perl' && flags.some((f) => /^-\w*i/.test(f)))
+        return 'work';
+    // D51, D58 e: `node -e`, `python3 -c`: a step only when it is one line that starts a program.
+    const code = inlineScript(w);
+    if (code !== null)
+        return scriptKind(code, prog);
+    if (prog === 'sed')
+        return flags.some((f) => /^-[a-zA-Z]*i/.test(f) || f === '--in-place') ? 'work' : flags.includes('-n') ? 'look' : 'step';
+    if (prog === 'perl')
+        return flags.some((f) => /^-\w*i/.test(f)) ? 'work' : 'step';
+    if (prog === 'rm')
+        return flags.some((f) => /^-\w*[rR]|^--recursive/.test(f)) ? 'step' : 'work';
+    if (prog === 'tee')
+        return sub.length ? 'work' : 'plumbing';
+    if (/^(?:patch|mkdir|touch|cp|mv|chmod|ln)$/.test(prog))
+        return 'work';
+    if (prog === 'command')
+        return w[1] === '-v' || w[1] === '-V' ? 'look' : 'step';
+    if (prog === 'find' && w.some((a) => FIND_ACTS.test(a)))
+        return 'step';
+    if (prog === 'tree' && flags.some((f) => /^-o/.test(f)))
+        return 'step';
+    if (/^(?:ls|cat|head|tail|grep|egrep|rg|find|wc|pwd|which|less|more|tree|stat|file|du|df|jq|test|\[)$/.test(prog))
+        return 'look';
+    return 'step';
+}
+/** What a whole command is: plumbing when every segment is; work when it only edits or commits; look when it only reads. */
+function kindOf(cmd, depth = 0) {
+    if (depth > MAX_DEPTH)
+        return 'step';
+    const s = String(cmd ?? '');
+    const { segs } = scan(s);
+    const kinds = segs.map((p) => segKind(s, p, depth));
+    if (kinds.every((k) => k === 'plumbing'))
+        return 'plumbing';
+    if (kinds.includes('step'))
+        return 'step';
+    return kinds.includes('work') ? 'work' : 'look';
+}
+/** Read-only exploration (4.1 kinds). */
+export function isLookOnly(cmd) {
+    const k = kindOf(cmd);
+    return k === 'look' || k === 'plumbing';
+}
+/** Changes the work itself rather than running the job (4.1 kinds). */
+export function isWork(cmd) {
+    return kindOf(cmd) === 'work';
+}
+/** plumbing, work, look or step from the command alone (4.1; the fold also counts read-only check families as look). */
+export function commandKind(cmd) {
+    return kindOf(cmd);
+}
+const TRAIL_BIN = /^(?:trail|graft|trail-code)$/;
+const TRAIL_PKG = /^(?:@trailhq\/trail-code|@nanonets\/graft|trail-code)(?:@\S*)?$/;
+const TRAIL_SCRIPT = /(?:^|\/)dist\/bin\/(?:trail|graft)\.js$|(?:^|\/)(?:trail|graft)-hooks\.cjs$/;
+/** Trail's own program in one simple command (not through `sh -c`). `bare`: only `trail`/`graft` found on PATH, not a path to one. */
+function trailProgram(w, bare) {
+    const p = w[0];
+    if (!p)
+        return false;
+    if (bare ? TRAIL_BIN.test(p) : TRAIL_BIN.test(base(p)) || TRAIL_SCRIPT.test(p))
+        return true;
+    const args = w.slice(1).filter((a) => !a.startsWith('-'));
+    if (p === 'npx' || p === 'bunx' || p === 'pnpx')
+        return TRAIL_PKG.test(args[0] ?? '');
+    if ((p === 'pnpm' || p === 'yarn') && args[0] === 'dlx')
+        return TRAIL_PKG.test(args[1] ?? '');
+    if (p === 'npm' && args[0] === 'exec')
+        return TRAIL_PKG.test(args[1] ?? '');
+    if (base(p) === 'node')
+        return TRAIL_SCRIPT.test(args[0] ?? '');
+    return false;
+}
+function trailSegment(text, depth) {
+    const raw = programWords(text);
+    const script = shellScript(raw);
+    return script !== null ? isTrailAt(script, depth + 1) : trailProgram(raw.map(unquote), false);
+}
+function isTrailAt(s, depth) {
+    if (depth > MAX_DEPTH)
+        return false;
+    return scan(s, false).segs.some((p) => (p.group ? isTrailAt(groupInner(s, p), depth + 1) : trailSegment(s.slice(p.start, p.end), depth)));
+}
+/**
+ * Any part of the command runs Trail: trail, graft, npx @trailhq/trail-code, npx @nanonets/graft,
+ * node …/dist/bin/(trail|graft).js. For "a skill never runs Trail" (4.11). The fold's "Trail's own
+ * command, ignored" (4.1) is `onlyTrail`: `trail x; rm ~/.trail/y` runs Trail and is not only Trail.
+ */
+export function isTrailCommand(cmd) {
+    const s = String(cmd ?? '');
+    return isTrailAt(s, 0) || TRAIL_INSIDE.test(s);
+}
+/** Trail run inside a word: `$(trail …)`, `<(trail …)`. Not backticks: `graft` in backticks is far more often a quoted word in a commit message. */
+const TRAIL_INSIDE = /(?:\$\(|[<>]\()\s*(?:trail|graft|trail-code|npx\s+(?:@trailhq\/trail-code|@nanonets\/graft))\b/;
+/** Code that runs inside a word: `$( )`, backticks, `<( )`, `>( )`, outside single quotes (and anywhere in a command with a heredoc). */
+function runsInside(s) {
+    let dq = false;
+    for (let i = 0; i < s.length; i++) {
+        const c = s[i];
+        if (c === '\\') {
+            i++;
+            continue;
+        }
+        if (c === '`' || (c === '$' && s[i + 1] === '('))
+            return true;
+        if (dq) {
+            if (c === '"')
+                dq = false;
+            continue;
+        }
+        if (c === '"')
+            dq = true;
+        else if (c === "'") {
+            if (s[i - 1] === '$')
+                while (i + 1 < s.length && s[i + 1] !== "'")
+                    i += s[i + 1] === '\\' ? 2 : 1;
+            else
+                while (i + 1 < s.length && s[i + 1] !== "'")
+                    i++;
+            i++;
+        }
+        else if ((c === '<' || c === '>') && s[i + 1] === '(')
+            return true;
+    }
+    return scan(s).heredoc && /`|\$\(/.test(s);
+}
+/** Lines that change what a later `trail` runs: PATH, an alias, a function. */
+const REDEFINES = /\bPATH\+?=|^(?:alias|unalias|hash|function)$|^[\w.-]+\(\)/;
+function onlyTrailAt(s, depth) {
+    if (depth > MAX_DEPTH || !s.trim() || runsInside(s))
+        return false;
+    let trail = false;
+    for (const simple of simpleCommands(s)) {
+        if (writesFile(simple) || words(simple).some((x) => REDEFINES.test(x)))
+            return false;
+        const raw = programWords(simple);
+        const script = shellScript(raw);
+        if (script !== null) {
+            if (!onlyTrailAt(script, depth + 1))
+                return false;
+            trail = true;
+        }
+        else if (trailProgram(raw.map(unquote), true))
+            trail = true;
+        else if (!['look', 'plumbing'].includes(kindOf(simple, depth + 1)))
+            return false;
+    }
+    return trail;
+}
+/**
+ * The whole command is Trail's own (4.1 "ignored entirely", and the tamper check's exemption): it runs
+ * Trail, and everything else in it only reads or sets up the shell. Not when any part writes a file
+ * (a redirect, cp, tee), runs code inside a word (`$( )`, backticks), runs another program, or changes
+ * which `trail` runs (PATH, an alias, a function, a path to a `trail`).
+ */
+export function onlyTrail(cmd) {
+    return onlyTrailAt(String(cmd ?? ''), 0);
+}
+/** The strips, repeated until nothing changes. */
+function stripped(cmd) {
+    let s = String(cmd ?? '').trim();
+    for (let n = 0; n < 20; n++) {
+        const next = stripTimeout(stripLeadingSleep(leadingCds(stripTrailingEcho(stripOutputFilters(s))).rest));
+        if (next === s)
+            break;
+        s = next;
+    }
+    return s;
+}
+const flatten = (s) => s.replace(/['"]/g, '').replace(/\s+/g, ' ').trim();
+/** For comparisons: output filters, trailing echo, leading cds, leading sleep and timeout stripped; quotes removed; spaces collapsed. */
+export function normalizeCommand(cmd) {
+    return flatten(stripped(cmd));
+}
+const escapeRe = (t) => t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+/**
+ * A step matches a command that ran when, after normalizeCommand on both, the step (params filled from
+ * `values` where known, other {params} as \S+) matches at the start of the ran command or right after a
+ * top-level `&& ` or `; `. Env prefixes are compared too, unless `ignoreEnv`.
+ */
+export function stepMatches(step, ran, values = {}, ignoreEnv = false) {
+    const core = stripped(step);
+    let want = flatten(core);
+    if (ignoreEnv)
+        want = envPrefix(want).rest;
+    if (!want)
+        return false;
+    // An unknown {param} is one token, never an operator: `{b}` can't swallow `&&`.
+    const re = new RegExp(`^${want.split(/(\{[A-Za-z_][\w]*\})/).map((part) => {
+        const name = /^\{([A-Za-z_]\w*)\}$/.exec(part)?.[1];
+        if (!name)
+            return escapeRe(part);
+        const v = values[name];
+        return v === undefined ? '[^\\s;&|<>]+' : escapeRe(flatten(v));
+    }).join('')}(?=$|[\\s;&|])`);
+    // The step spans `width` top-level segments, so a match from segment k reads only k..k+width-1:
+    // linear in the command, where re-reading every tail was quadratic (a 7 KB script took 8 s).
+    const width = Math.max(1, scan(core).segs.length);
+    const s = stripped(ran);
+    const { segs } = scan(s);
+    for (let k = 0; k < segs.length; k++) {
+        if (k > 0 && segs[k - 1].sep !== '&&' && segs[k - 1].sep !== ';')
+            continue;
+        const last = segs[Math.min(k + width, segs.length) - 1];
+        let tail = flatten(stripTimeout(stripLeadingSleep(leadingCds(s.slice(segs[k].start, last.end)).rest)));
+        if (ignoreEnv)
+            tail = envPrefix(tail).rest;
+        if (re.test(tail))
+            return true;
+    }
+    return false;
+}
+/** Absolute path tokens: under repoRoot become repo-relative (`./x` or `x`); under home become `$HOME/…`; `~/` becomes `$HOME/`. */
+export function relativizePaths(cmd, repoRoot, home) {
+    const before = String.raw `(^|[\s'"=:(,]|(?<=:)//)`;
+    const after = String.raw `(?=$|[/\s'"),;:&|])`;
+    let s = String(cmd ?? '');
+    const root = repoRoot.replace(/\/+$/, '');
+    const h = home.replace(/\/+$/, '');
+    if (root)
+        s = s.replace(new RegExp(`${before}${escapeRe(root)}${after}(/?)`, 'g'), (_m, pre, slash) => `${pre}.${slash}`);
+    if (h)
+        s = s.replace(new RegExp(`${before}${escapeRe(h)}${after}`, 'g'), (_m, pre) => `${pre}$HOME`);
+    return s.replace(/(^|[\s'"=:(,])~(?=\/|$|\s)/g, '$1$HOME');
+}
+//# sourceMappingURL=shell.js.map

package/dist/trace/shell.js.map

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

package/dist/trace/skill-session.d.ts

@@ -0,0 +1,64 @@
+import type { TraceEvent } from './claude.js';
+import { type FoldResult } from './runs.js';
+import type { CodexMeta, RunState, SkillInjection, SkillSessionState } from './types.js';
+export { housekeeping } from './housekeeping.js';
+export type SkipWhy = 'no-hooks' | 'off' | 'no-session';
+export type LearnOffWhy = 'host' | 'headless' | 'ci' | 'subagent' | 'scratch' | 'ephemeral';
+export interface GateCtx {
+    sessionId: string;
+    sessionHash: string;
+    host: string;
+    tier: 'A' | 'B' | 'C' | 'D';
+    entry: 'interactive' | 'headless';
+    permissionMode: string | null;
+    subagent: boolean;
+    /** Runs are folded and run sheets written: interactive, top level, not CI, not scratch, any host (4.1). */
+    fold: boolean;
+    /** fold and tier A: pool days, offers, credit, live saves (0 rule 2). */
+    learn: boolean;
+    learnOff: LearnOffWhy | null;
+    dir: string;
+    /** The checkout root of the payload's cwd; '' when it is not inside git. */
+    checkout: string;
+    repoKey: string;
+    transcriptPath: string | null;
+    env: NodeJS.ProcessEnv;
+    now: Date;
+    /** Codex only (4.17): the rollout's first line, read by the gate; the session keeps it in `st.codex.meta`. */
+    codexMeta?: CodexMeta | null;
+}
+/** 3.0. */
+export declare function skillsGate(input: any, dir: string, env?: NodeJS.ProcessEnv, now?: Date): {
+    ok: true;
+    ctx: GateCtx;
+} | {
+    ok: false;
+    why: SkipWhy;
+};
+/**
+ * Locked read-modify-write of the `skills` key of sessions/<id>.json (lock wait default 200 ms).
+ * With catchUp (ctx.fold only): takePostMarks, then the host dialect's readNewEvents(transcript, sessionStatePath(id))
+ * (4.16; a host with no dialect keeps 1a's reader, so J24's Cursor and Copilot payloads still fold and are held)
+ * then foldEvents, inside the
+ * same lock (the `trace` cursor lives in the same file); then, for every run the fold closed with
+ * stepCalls > 0 and sheet 'none', writeRunSheet(run, checkedSuccess(run, null)), then its calls are emptied.
+ * Returns undefined when the lock timed out: the caller fails open.
+ *
+ * `fn` still sees the closed runs' calls (in `fold.closed`); they are emptied before the state is written. When `fn`
+ * throws, the folded state is written as it was before `fn`, so the cursor that moved and the state agree.
+ * `prepare` runs on the state first, before the catch-up: the Codex prompt hook records the prompt's keyed hash
+ * there, so a typed line already in the rollout counts in this same read (P30).
+ */
+export declare function withSkillSession<T>(ctx: GateCtx, opts: {
+    catchUp: boolean;
+    waitMs?: number;
+    prepare?: (st: SkillSessionState) => void;
+}, fn: (st: SkillSessionState, fold: (FoldResult & {
+    events: TraceEvent[];
+}) | null) => T): T | undefined;
+/** Unlocked read (`trail skills`). A new state when none. */
+export declare function loadSkillSession(ctx: GateCtx): SkillSessionState;
+export declare function currentRun(st: SkillSessionState): RunState | null;
+export declare function injectedThisEpoch(st: SkillSessionState): SkillInjection[];
+export declare function liveInjections(st: SkillSessionState): SkillInjection[];
+//# sourceMappingURL=skill-session.d.ts.map

package/dist/trace/skill-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-session.d.ts","sourceRoot":"","sources":["../../src/trace/skill-session.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,OAAO,EAA2E,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACrH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEzF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,YAAY,CAAC;AACxD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAC5F,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC5B,KAAK,EAAE,aAAa,GAAG,UAAU,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,2GAA2G;IAC3G,IAAI,EAAE,OAAO,CAAC;IACd,yEAAyE;IACzE,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,EAAE,IAAI,CAAC;IACV,8GAA8G;IAC9G,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CAC9B;AAaD,WAAW;AACX,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAoD9J;AA0ED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,IAAI,CAAA;CAAE,EACtI,EAAE,EAAE,CAAC,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,UAAU,GAAG;IAAE,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CA8BvG;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAEhE;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,iBAAiB,GAAG,QAAQ,GAAG,IAAI,CAGjE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAEzE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAEtE"}