@nanonets/graft 0.23.0 → 0.24.0

package/dist/trace/shell-scan.js

@@ -0,0 +1,318 @@
+/**
+ * The lexer under `shell.ts`: one pass over a command that finds its
+ * top-level segments the way the shell would. Quotes, `$'…'`, `$(…)`,
+ * `$((…))`, backticks, `${…}`, `(…)` subshells, `{ …; }` groups, `[[ … ]]`,
+ * comments, and loops and ifs (when asked) are opaque; a heredoc body is
+ * skipped as text and, at the top level, belongs to the segment whose line
+ * opened it. Ranges into the original text are returned, so callers can cut
+ * a command without retyping any of it.
+ *
+ * The PreToolUse fast path loads this file through `shell.ts`: it imports
+ * nothing.
+ */
+export const OPEN_KW = new Set(['for', 'while', 'until', 'if', 'case', 'select']);
+const CLOSE_KW = new Set(['done', 'fi', 'esac']);
+const MID_KW = new Set(['do', 'then', 'else', 'elif', '!']);
+const HEREDOC_OPEN = /^<<([-~]?)[ \t]*(?:'([^'\n]*)'|"([^"\n]*)"|\\?([^\s;&|<>()'"`]+))/;
+/**
+ * The one scanner. `compounds`: a loop or an if is one segment (false splits
+ * inside them, to look at what they run).
+ */
+export function scan(s, compounds = true) {
+    const segs = [];
+    const keep = [];
+    const stack = [];
+    const pending = [];
+    let cur = null;
+    let compound = 0;
+    let cmdStart = true;
+    let sawNl = false;
+    let heredoc = false;
+    let newline = false;
+    const close = (sep, nl) => {
+        if (!cur)
+            return;
+        cur.sep = sep;
+        cur.nl = nl;
+        segs.push(cur);
+        cur = null;
+    };
+    for (let i = 0; i < s.length; i++) {
+        const c = s[i];
+        const ctx = stack.length ? stack[stack.length - 1] : '';
+        if (c === '\n' && ctx !== '"' && ctx !== '`') {
+            const atTop = ctx === '' && compound === 0;
+            if (atTop)
+                close(';', true);
+            sawNl = true;
+            cmdStart = true;
+            if (!pending.length)
+                continue;
+            heredoc = true;
+            let j = i + 1;
+            let last = i;
+            for (const h of pending) {
+                const bodyStart = j;
+                let end = s.length;
+                while (j < s.length) {
+                    const nl = s.indexOf('\n', j);
+                    const lineEnd = nl < 0 ? s.length : nl;
+                    const line = s.slice(j, lineEnd);
+                    // <<- strips leading tabs only, as bash and zsh do.
+                    if ((h.strip ? line.replace(/^\t+/, '') : line).replace(/\r$/, '') === h.delim) {
+                        end = lineEnd;
+                        break;
+                    }
+                    j = nl < 0 ? s.length : nl + 1;
+                }
+                if (atTop && h.owner !== null)
+                    (segs[h.owner] ?? cur)?.bodies.push([bodyStart, end]);
+                last = end;
+                j = end + 1;
+            }
+            if (atTop)
+                keep.push([i, last]);
+            pending.length = 0;
+            i = last - 1;
+            continue;
+        }
+        if (c === ' ' || c === '\t' || c === '\r')
+            continue;
+        if (ctx === '') {
+            let sep = null;
+            let len = 1;
+            if (c === '&' && s[i + 1] === '&') {
+                sep = '&&';
+                len = 2;
+            }
+            else if (c === '|' && s[i + 1] === '|') {
+                sep = '||';
+                len = 2;
+            }
+            else if (c === '|' && s[i - 1] !== '>') {
+                sep = '|';
+                len = s[i + 1] === '&' ? 2 : 1;
+            }
+            else if (c === ';') {
+                sep = ';';
+                len = s[i + 1] === ';' ? 2 : 1;
+            }
+            else if (c === '&' && s[i + 1] !== '>' && s[i - 1] !== '>' && s[i - 1] !== '<')
+                sep = '&';
+            if (sep !== null) {
+                if (compound === 0)
+                    close(sep, false);
+                i += len - 1;
+                cmdStart = true;
+                continue;
+            }
+        }
+        if (sawNl)
+            newline = true;
+        if (!cur)
+            cur = { start: i, end: i, sep: '', nl: false, bodies: [], group: null };
+        const seg = cur;
+        const was = cmdStart;
+        cmdStart = false;
+        if (ctx === '"') {
+            if (c === '\\')
+                i++;
+            else if (c === '"')
+                stack.pop();
+            else if (c === '`')
+                stack.push('`');
+            else if (c === '$' && s[i + 1] === '(') {
+                stack.push(s[i + 2] === '(' ? 'A' : '(');
+                i += s[i + 2] === '(' ? 2 : 1;
+            }
+            else if (c === '$' && s[i + 1] === '{') {
+                stack.push('$');
+                i++;
+            }
+            seg.end = i + 1;
+            continue;
+        }
+        if (c === '\\') {
+            i++;
+        }
+        else if (c === "'") {
+            const q = s.indexOf("'", i + 1);
+            i = q < 0 ? s.length - 1 : q;
+        }
+        else if (c === '$' && s[i + 1] === "'") {
+            let j = i + 2;
+            while (j < s.length && s[j] !== "'")
+                j += s[j] === '\\' ? 2 : 1;
+            i = Math.min(j, s.length - 1);
+        }
+        else if (c === '"') {
+            stack.push('"');
+        }
+        else if (c === '`') {
+            if (ctx === '`')
+                stack.pop();
+            else
+                stack.push('`');
+        }
+        else if (c === '$' && s[i + 1] === '(' && s[i + 2] === '(') {
+            stack.push('A');
+            i += 2;
+        }
+        else if (c === '$' && s[i + 1] === '(') {
+            stack.push('(');
+            i++;
+        }
+        else if (c === '$' && s[i + 1] === '{') {
+            stack.push('$');
+            i++;
+        }
+        else if (c === '(') {
+            if (stack.length === 0 && seg.start === i)
+                seg.group = { open: i, close: -1 };
+            stack.push('(');
+            cmdStart = true;
+        }
+        else if (c === ')') {
+            if (ctx === 'A' && s[i + 1] === ')') {
+                stack.pop();
+                i++;
+            }
+            else if (ctx === '(')
+                stack.pop();
+            if (stack.length === 0 && seg.group && seg.group.close < 0)
+                seg.group.close = i;
+        }
+        else if (c === '{' && was && /\s/.test(s[i + 1] ?? '')) {
+            if (stack.length === 0 && seg.start === i)
+                seg.group = { open: i, close: -1 };
+            stack.push('{');
+            cmdStart = true;
+        }
+        else if (c === '}' && (ctx === '$' || (ctx === '{' && /[\s;&]/.test(s[i - 1] ?? '')))) {
+            stack.pop();
+            if (stack.length === 0 && seg.group && seg.group.close < 0)
+                seg.group.close = i;
+        }
+        else if (c === '[' && s[i + 1] === '[' && was && /\s/.test(s[i + 2] ?? '')) {
+            stack.push('[');
+            i++;
+        }
+        else if (c === ']' && s[i + 1] === ']' && ctx === '[') {
+            stack.pop();
+            i++;
+        }
+        else if (c === '#' && (i === 0 || /[\s;&|(]/.test(s[i - 1])) && ctx !== 'A' && ctx !== '$') {
+            const nl = s.indexOf('\n', i);
+            i = (nl < 0 ? s.length : nl) - 1;
+        }
+        else if (c === '<' && s[i + 1] === '<' && s[i + 2] !== '<' && s[i - 1] !== '<' && ctx !== 'A' && ctx !== '[') {
+            const m = HEREDOC_OPEN.exec(s.slice(i));
+            if (m) {
+                pending.push({ delim: m[2] ?? m[3] ?? m[4], strip: m[1] !== '', owner: stack.length === 0 && compound === 0 ? segs.length : null });
+                i += m[0].length - 1;
+            }
+            else
+                i++;
+        }
+        else if (stack.length === 0 && was) {
+            // A keyword only counts where a command starts.
+            const word = /^(?:[a-z]+|!)/.exec(s.slice(i, i + 7))?.[0] ?? '';
+            const kw = word && /^[\s;&|)]|^$/.test(s[i + word.length] ?? '') ? word : '';
+            if (compounds && OPEN_KW.has(kw)) {
+                compound++;
+                cmdStart = true;
+                i += kw.length - 1;
+            }
+            else if (compounds && compound > 0 && CLOSE_KW.has(kw)) {
+                compound--;
+                i += kw.length - 1;
+            }
+            else if (MID_KW.has(kw)) {
+                cmdStart = true;
+                i += kw.length - 1;
+            }
+        }
+        seg.end = Math.min(i + 1, s.length);
+    }
+    close('', false);
+    const last = segs[segs.length - 1];
+    if (last && last.sep !== '&')
+        last.sep = '';
+    return { segs, heredoc, newline, keep };
+}
+/** A piece's head text plus its detached heredoc bodies. */
+export function pieceText(s, p) {
+    return [s.slice(p.start, p.end), ...p.bodies.map(([a, b]) => s.slice(a, b))].join('\n');
+}
+/**
+ * `s` with `ranges` removed, except what `keep` protects (heredoc bodies and
+ * the newline before them), trimmed.
+ */
+export function cut(s, ranges, keep) {
+    const drop = new Uint8Array(s.length);
+    for (const [a, b] of ranges)
+        for (let i = Math.max(0, a); i < Math.min(b, s.length); i++)
+            drop[i] = 1;
+    for (const [a, b] of keep)
+        for (let i = Math.max(0, a); i <= Math.min(b, s.length - 1); i++)
+            drop[i] = 0;
+    let out = '';
+    for (let i = 0; i < s.length; i++)
+        if (!drop[i])
+            out += s[i];
+    return out.trim();
+}
+/** Words of one segment's head, split on unquoted spaces; quotes kept; a `#` comment is not a word. */
+export function words(text) {
+    const out = [];
+    let i = 0;
+    while (i < text.length) {
+        // A backslash-newline joins lines: space between words.
+        while (i < text.length && (/\s/.test(text[i]) || (text[i] === '\\' && text[i + 1] === '\n')))
+            i += text[i] === '\\' ? 2 : 1;
+        if (i >= text.length)
+            break;
+        if (text[i] === "#") {
+            const nl = text.indexOf("\n", i);
+            if (nl < 0)
+                break;
+            i = nl;
+            continue;
+        }
+        const start = i;
+        let depth = 0;
+        for (; i < text.length; i++) {
+            const c = text[i];
+            if (c === '\\' && text[i + 1] === '\n' && depth === 0)
+                break;
+            if (c === '\\') {
+                i++;
+                continue;
+            }
+            if (c === "'") {
+                const q = text.indexOf("'", i + 1);
+                i = q < 0 ? text.length : q;
+                continue;
+            }
+            if (c === '"') {
+                let j = i + 1;
+                while (j < text.length && text[j] !== '"')
+                    j += text[j] === '\\' ? 2 : 1;
+                i = j;
+                continue;
+            }
+            if (c === '(' || c === '{')
+                depth++;
+            else if ((c === ')' || c === '}') && depth > 0)
+                depth--;
+            else if (depth === 0 && /\s/.test(c))
+                break;
+        }
+        out.push(text.slice(start, i));
+    }
+    return out;
+}
+export const unquote = (w) => w.replace(/^(['"])([\s\S]*)\1$/, '$2');
+export const base = (w) => unquote(w).replace(/\/+$/, '').split('/').pop() ?? '';
+export const ASSIGN = /^[A-Za-z_][A-Za-z0-9_]*=/;
+//# sourceMappingURL=shell-scan.js.map

package/dist/trace/shell-scan.js.map

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

package/dist/trace/shell-words.d.ts

@@ -0,0 +1,91 @@
+/**
+ * What a simple command runs, under `shell.ts`: the program word after env
+ * prefixes and wrappers (`time`, `nice`, `nohup`, `command`, `env`, `sudo`,
+ * `timeout`, `script -q /dev/null`), two words for a runner (`git push`,
+ * `npm run`), and every simple command inside subshells, groups and loops.
+ *
+ * Nesting is read to a fixed depth: a command nested deeper than any real
+ * one gets the safe answer (no program, a step) instead of a stack overflow.
+ *
+ * The PreToolUse fast path loads this file through `shell.ts`: its only
+ * import is the lexer, which imports nothing.
+ */
+import type { CallKind } from './types.js';
+import { type Piece } from './shell-scan.js';
+/** Deeper than any real command: past it, a reader gives its safe answer. */
+export declare const MAX_DEPTH = 24;
+export declare const RUNNERS: ReadonlySet<string>;
+/** cd export source . echo printf sleep true false pwd clear set unset alias wait */
+export declare const PLUMBING: ReadonlySet<string>;
+export declare const shellOnly: (prog: string) => boolean;
+/** Flags that take the next word as their value, per runner. */
+export declare const VALUE_FLAGS: Record<string, ReadonlySet<string>>;
+/** The words after `timeout [options] DURATION`, or null when `w` doesn't start that way. One pass over the words. */
+export declare function afterTimeout(w: string[]): string[] | null;
+/** The program words of one simple command: env prefixes and wrappers (time, nice, command, nohup, env, sudo, timeout, script -q /dev/null, !) gone. */
+export declare function programWords(head: string): string[];
+/** `bash -c 'script'` (also sh, zsh, dash, `-lc`, `-ec`): the script, unquoted; else null. */
+export declare function shellScript(w: string[]): string | null;
+/** A top-level `>`, `>>`, `&>`, `N>` or `>|` into a file other than /dev/null (quoted text and comments are not redirects). */
+export declare function writesFile(head: string): boolean;
+/** Interpreters whose program can come inline (`-e`, `-c`) or from a heredoc. */
+export declare const INTERPRETERS: RegExp;
+/**
+ * D51, D58 e: what an interpreter's script does. One line that starts a program is a step
+ * (`node -e "require('./scripts/release.js')"`); any other script is work when it writes files, starts
+ * programs or sends to the network, and a look when it only reads or prints (a GET that prints is a look). A script over several lines
+ * (a heredoc, a multi-line `-e`) is never a step: no one can run it from a skill line.
+ */
+export declare function scriptKind(code: string, prog?: string): CallKind;
+/** The code of `node -e CODE`, `python3 -c CODE`, `perl -ne CODE`, `php -r CODE`, `deno eval CODE` (unquoted); else null. */
+export declare function inlineScript(w: string[]): string | null;
+/** An interpreter fed its program by a heredoc (`python3 - <<'EOF'`, `node <<EOF`), not data for a script file. */
+export declare function heredocInterpreter(w: string[]): string | null;
+/** A loop or if, as the simple commands it runs (headers and closing words gone). */
+export declare function keywordFree(text: string): string[];
+export declare const stripKeywords: (text: string) => string;
+/** The text inside a piece that is a subshell or group. */
+export declare const groupInner: (s: string, p: Piece) => string;
+/** The first segment's program that isn't plumbing (else the first plumbing one). */
+export declare function programOfText(text: string, depth?: number): {
+    prog: string | null;
+    plumbing: boolean;
+};
+/** Every simple command in `cmd`, in order: subshells, groups, loops and ifs opened up; heredoc bodies left out. */
+export declare function simpleCommands(cmd: string, depth?: number): string[];
+/** One simple command with its env prefixes and wrappers (time, nice, command, nohup, env, sudo, timeout, script -q /dev/null, !) dropped. */
+export declare function bareCommand(simple: string): string;
+/** Whether one simple command that carries the text (or reads it from a pipe) leaves it unrun. */
+type Quiet = <T>(head: string, bodies: string[], hitOf: (text: string) => T | null) => boolean;
+/**
+ * D89: where a word the agent may not run (`skills on`) sits in `cmd`.
+ * `hitOf` says whether a piece of text carries it. Returns the hit of the
+ * first simple command that runs it: the program or a word the shell splits
+ * on its own (after `;`, `&&`, `|`, a wrapper, a renamed binary, a
+ * variable), text given to a shell or an interpreter (`sh -c`, `eval`,
+ * `| sh`, `python -c`, a heredoc into a shell), a substitution inside the
+ * quotes, or anything a carrying command pipes into that isn't itself a
+ * text program. Null when it sits only inside quoted arguments of text
+ * programs (grep, rg, ag, git commit/log/grep, echo, printf, sed, awk
+ * patterns, cat) or in a `$(cat <<'EOF' …)` body. `whole` is the answer
+ * when no single command carries it, or past `MAX_DEPTH`. Linear: one scan
+ * per nesting level.
+ */
+export declare function quotedTextHit<T>(cmd: string, hitOf: (text: string) => T | null, whole: T, depth?: number, quiet?: Quiet): T | null;
+/**
+ * D116 item 2: one simple command that only reads the files it names (grep, sed without -i or `e`, cat, a pager,
+ * head, tail, wc, git log/show/diff), with no substitution, no copy to a file and no flag that runs a program.
+ * Given to `quotedTextHit` as its `quiet`, a name sits unrun as such a command's argument or in what it reads.
+ */
+export declare function readsFiles<T>(head: string, bodies: string[], _hitOf: (text: string) => T | null): boolean;
+/**
+ * fix-lab5: one simple command that names a Trail hook script and leaves it unrun, as `quotedTextHit`'s quiet for the
+ * hook-script guard. A read (readsFiles); deleting it or a stale copy (`rm`), an existence test, `node --check`, git
+ * bookkeeping (add, checkout, commit …); code an interpreter is given that only edits text naming it (a python
+ * heredoc that rewrites a source file); a heredoc written to another file (`cat >> notes.md <<EOF`). Never when the
+ * shell substitutes something, a file is written to the hook (`cat > trail-hooks.cjs <<EOF`), or the code loads it or
+ * hands it to a child process. `hookNamed` is how the guard names one (risk.ts HOOK_SCRIPT).
+ */
+export declare function hookUnrun<T>(head: string, bodies: string[], hitOf: (text: string) => T | null, hookNamed: (text: string) => boolean): boolean;
+export {};
+//# sourceMappingURL=shell-words.d.ts.map

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

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