@nanonets/graft 0.23.1 → 0.24.1

package/dist/skills/person.js.map

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

package/dist/skills/probe-clean.d.ts

@@ -0,0 +1,9 @@
+type Git = (args: string[], cwd: string, timeoutMs: number) => {
+    code: number | null;
+    out: string;
+    timedOut: boolean;
+};
+/** Whether every change `git status --porcelain` printed is a path init wrote here and nobody changed since. */
+export declare function onlyTrailChanges(out: string, checkout: string, git: Git, timeoutMs: number, env?: NodeJS.ProcessEnv): boolean;
+export {};
+//# sourceMappingURL=probe-clean.d.ts.map

package/dist/skills/probe-clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-clean.d.ts","sourceRoot":"","sources":["../../src/skills/probe-clean.ts"],"names":[],"mappings":"AAcA,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAYvH,gHAAgH;AAChH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAiB1I"}

package/dist/skills/probe-clean.js

@@ -0,0 +1,48 @@
+/**
+ * D120 (2), replacing D116 item 4's pattern: the clean-tree ready probe leaves
+ * out exactly the paths `trail init` recorded writing in this checkout (its
+ * install record, src/init/install-record.ts), and only while each still holds
+ * what init wrote. So a repo whose wiring isn't committed yet doesn't open every
+ * run block with "Uncommitted changes here", and any later edit to one of those
+ * files, the person's own settings changes included, blocks again. Anything
+ * init never wrote blocks, in `.trail/` too. No record: nothing is left out.
+ * Read only: `git status --porcelain` output, one more `git status` per
+ * untracked folder (to list its files the way git sees them), the record, and
+ * the hashes of the files it names.
+ */
+import { initLeftIt, readInstallRecord } from '../init/install-record.js';
+/** The paths of `git status --porcelain` lines (both sides of a rename, quotes left on: such a path is never init's). */
+function statusPaths(out) {
+    const paths = [];
+    for (const line of out.split('\n')) {
+        if (line.length < 4)
+            continue;
+        paths.push(...line.slice(3).split(' -> '));
+    }
+    return paths;
+}
+/** Whether every change `git status --porcelain` printed is a path init wrote here and nobody changed since. */
+export function onlyTrailChanges(out, checkout, git, timeoutMs, env = process.env) {
+    const paths = statusPaths(out);
+    if (!paths.length)
+        return false;
+    const files = readInstallRecord(checkout, env);
+    if (!files)
+        return false;
+    for (const p of paths) {
+        if (!p.endsWith('/')) {
+            if (!initLeftIt(files, checkout, p))
+                return false;
+            continue;
+        }
+        // An untracked folder is shown whole: list its files as git sees them (ignored ones left out).
+        const inside = git(['status', '--porcelain', '--untracked-files=all', '--', p], checkout, timeoutMs);
+        if (inside.timedOut || inside.code !== 0)
+            return false;
+        const rels = statusPaths(inside.out);
+        if (!rels.length || rels.length > 64 || rels.some((r) => !initLeftIt(files, checkout, r)))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=probe-clean.js.map

package/dist/skills/probe-clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-clean.js","sourceRoot":"","sources":["../../src/skills/probe-clean.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAI1E,yHAAyH;AACzH,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,QAAgB,EAAE,GAAQ,EAAE,SAAiB,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC/H,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;YAClD,SAAS;QACX,CAAC;QACD,+FAA+F;QAC/F,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACrG,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACvD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAC1G,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/skills/probes.d.ts

@@ -0,0 +1,26 @@
+import type { ParsedSkill } from './types.js';
+export interface ProbeResult {
+    probe: string;
+    ok: boolean;
+    why?: string;
+    fix?: string;
+}
+/** What runs git for a probe; tests stub it. `code` null when it didn't finish. */
+export type ProbeGit = (args: string[], cwd: string, timeoutMs: number) => {
+    code: number | null;
+    out: string;
+    timedOut: boolean;
+};
+export interface ProbeOpts {
+    /** At most 300; the prompt hook passes what its deadline leaves. */
+    budgetMs?: number;
+    git?: ProbeGit;
+}
+export declare const PROBE_BUDGET_MS = 300;
+/** The probes of a skill's `ready` line, in order. */
+export declare function readyProbes(s: Pick<ParsedSkill, 'meta'>): string[];
+/** A passed probe in words, for the run block's ready line; null for a form that never runs. */
+export declare function probePassWords(probe: string): string | null;
+/** Allowlisted local probes only, without a shell, 300 ms total, cached 10 min in <home>/state/probes.json keyed by checkout+probe. */
+export declare function runProbes(s: ParsedSkill, checkout: string, now?: Date, env?: NodeJS.ProcessEnv, opts?: ProbeOpts): ProbeResult[];
+//# sourceMappingURL=probes.d.ts.map

package/dist/skills/probes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probes.d.ts","sourceRoot":"","sources":["../../src/skills/probes.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,MAAM,WAAW,WAAW;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE;AAEvF,mFAAmF;AACnF,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AACnI,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAED,eAAO,MAAM,eAAe,MAAM,CAAC;AAgCnC,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAElE;AAID,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU3D;AA6GD,uIAAuI;AACvI,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,GAAE,SAAc,GAAG,WAAW,EAAE,CA4B7J"}

package/dist/skills/probes.js

@@ -0,0 +1,225 @@
+/**
+ * Ready probes (design 4.15, 4.5 step 11, spec 11): before a run block goes
+ * in, the hook checks what the skill needs locally, so the block can say
+ * "Uncommitted changes here" or "This checkout is on fix/x, not beta" up
+ * front instead of the agent finding out at step 4.
+ *
+ * Only these forms ever run, each without a shell:
+ *   command -v NAME                       a PATH lookup, nothing executed
+ *   test -[SfdeE] PATH, [ -S PATH ]       a stat
+ *   git status --porcelain                passes on empty output, or only trail init's own files (D116)
+ *   git rev-parse --verify REF
+ *   git rev-parse --abbrev-ref HEAD = B   passes when the branch is B
+ * Anything else in a skill's `ready` line is never run, whoever wrote it:
+ * a SKILL.md can be edited by hand. Git runs with optional locks and the
+ * fsmonitor off, so a probe never writes the repo and starts nothing else.
+ * Nothing here touches the network (`check-first` lines are the agent's).
+ *
+ * 300 ms in all. A probe not done in time is left out, never reported
+ * failed. Results are cached 10 minutes in `state/probes.json`, keyed by a
+ * hash of checkout and probe.
+ */
+import { execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { accessSync, constants, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { isAbsolute, join, resolve } from 'node:path';
+import { flatLine } from '../notes/flatten.js';
+import { readJsonSafe, trailPath, writePrivate } from '../util/private-fs.js';
+import { onlyTrailChanges } from './probe-clean.js';
+import { pathDirs, programFiles } from '../trace/guard-fast.js';
+export const PROBE_BUDGET_MS = 300;
+const GIT_MS = 150;
+const CACHE_MS = 10 * 60_000;
+const MAX_PROBES = 6;
+const NAME = /^[A-Za-z0-9._+-]+$/;
+const PATH_TOKEN = /^(?:\$HOME\/|\$\{HOME\}\/|~\/)?[A-Za-z0-9._@%+,:=/-]+$/;
+const REF = /^(?!-)[A-Za-z0-9._/@^~-]+$/;
+const BRANCH = /^(?!-)[A-Za-z0-9._/-]+$/;
+/** The allowlisted form of a probe, or null: never run. */
+function formOf(probe) {
+    const p = probe.trim().replace(/\s+/g, ' ');
+    let m = /^command -v (\S+)$/.exec(p);
+    if (m)
+        return NAME.test(m[1]) ? { kind: 'which', name: m[1] } : null;
+    m = /^test -([SfdeE]) (\S+)$/.exec(p) ?? /^\[ -([SfdeE]) (\S+) \]$/.exec(p);
+    if (m)
+        return PATH_TOKEN.test(m[2]) && !m[2].includes('..') ? { kind: 'stat', flag: m[1], path: m[2] } : null;
+    if (p === 'git status --porcelain')
+        return { kind: 'clean' };
+    m = /^git rev-parse --verify (\S+)$/.exec(p);
+    if (m)
+        return REF.test(m[1]) ? { kind: 'verify', ref: m[1] } : null;
+    m = /^git rev-parse --abbrev-ref HEAD = (\S+)$/.exec(p);
+    if (m)
+        return BRANCH.test(m[1]) ? { kind: 'branch', branch: m[1] } : null;
+    return null;
+}
+/** The probes of a skill's `ready` line, in order. */
+export function readyProbes(s) {
+    return String(s.meta.ready ?? '').split(' ; ').map((x) => x.trim()).filter(Boolean).slice(0, MAX_PROBES);
+}
+const shown = (t) => flatLine(t, 80);
+/** A passed probe in words, for the run block's ready line; null for a form that never runs. */
+export function probePassWords(probe) {
+    const f = formOf(probe);
+    if (!f)
+        return null;
+    switch (f.kind) {
+        case 'which': return `${shown(f.name)} installed`;
+        case 'stat': return `${shown(f.path)} there`;
+        case 'clean': return 'no uncommitted changes';
+        case 'verify': return `${shown(f.ref)} exists`;
+        case 'branch': return `on ${shown(f.branch)}`;
+    }
+}
+function socketWords(path) {
+    if (/\.colima\b/i.test(path))
+        return { why: "Colima's socket isn't there", fix: 'Start it first: colima start' };
+    if (/docker/i.test(path))
+        return { why: "Docker's socket isn't there", fix: 'Start Docker first, or ask the person.' };
+    return { why: `${shown(path)} isn't there`, fix: 'Start what it belongs to first, or ask the person.' };
+}
+const defaultGit = (args, cwd, timeoutMs) => {
+    try {
+        const out = execFileSync('git', ['--no-optional-locks', '-c', 'core.fsmonitor=false', ...args], {
+            cwd, timeout: timeoutMs, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], maxBuffer: 1 << 20,
+            env: { ...process.env, GIT_OPTIONAL_LOCKS: '0', GIT_TERMINAL_PROMPT: '0' },
+        });
+        return { code: 0, out, timedOut: false };
+    }
+    catch (e) {
+        const timedOut = e?.code === 'ETIMEDOUT' || e?.signal === 'SIGTERM';
+        return { code: timedOut ? null : typeof e?.status === 'number' ? e.status : null, out: String(e?.stdout ?? ''), timedOut };
+    }
+};
+function statOf(path) {
+    try {
+        return statSync(path);
+    }
+    catch {
+        return null;
+    }
+}
+/** A path token with $HOME and ~ expanded; relative to the checkout. null when it can't be placed. */
+function placed(token, checkout, env) {
+    const home = env.HOME || homedir();
+    const t = token.replace(/^(?:\$HOME|\$\{HOME\}|~)\//, `${home}/`);
+    if (isAbsolute(t))
+        return t;
+    return checkout ? resolve(checkout, t) : null;
+}
+/** On PATH: an executable file of that name, or on Windows git.exe, npm.cmd and the like (PATHEXT; no exec bit there). */
+function which(name, env) {
+    const names = programFiles(name, env);
+    for (const dir of pathDirs(env)) {
+        for (const n of names) {
+            const p = join(dir, n);
+            if (!statOf(p)?.isFile())
+                continue;
+            try {
+                accessSync(p, constants.X_OK);
+                return true;
+            }
+            catch { /* not executable: look further */ }
+        }
+    }
+    return false;
+}
+/** One probe: a result, or null when it was left out (no time, no checkout, an answer git couldn't give). */
+function runOne(probe, f, checkout, env, gitRun, left) {
+    switch (f.kind) {
+        case 'which':
+            return which(f.name, env) ? { probe, ok: true }
+                : { probe, ok: false, why: `${shown(f.name)} isn't installed here`, fix: "Tell the person; don't install it for them." };
+        case 'stat': {
+            const p = placed(f.path, checkout, env);
+            if (!p)
+                return null;
+            const st = statOf(p);
+            const ok = !!st && (f.flag === 'S' ? st.isSocket() : f.flag === 'f' ? st.isFile() : f.flag === 'd' ? st.isDirectory() : true);
+            if (ok)
+                return { probe, ok: true };
+            return f.flag === 'S' ? { probe, ok: false, ...socketWords(f.path) } : { probe, ok: false, why: `${shown(f.path)} isn't there`, fix: 'Tell the person before going on.' };
+        }
+        default: {
+            if (!checkout)
+                return null;
+            const ms = Math.min(GIT_MS, left());
+            if (ms <= 0)
+                return null;
+            const args = f.kind === 'clean' ? ['status', '--porcelain'] : f.kind === 'verify' ? ['rev-parse', '--verify', '--quiet', f.ref] : ['rev-parse', '--abbrev-ref', 'HEAD'];
+            const r = gitRun(args, checkout, ms);
+            if (r.timedOut || r.code === null)
+                return null;
+            if (f.kind === 'clean') {
+                if (r.code !== 0)
+                    return null;
+                // D120 (2): the paths `trail init` recorded writing here, still as it left them, are not the person's.
+                const clean = r.out.trim() === '' || onlyTrailChanges(r.out, checkout, gitRun, Math.max(1, Math.min(GIT_MS, left())), env);
+                return clean ? { probe, ok: true } : { probe, ok: false, why: 'Uncommitted changes here', fix: "Tell the person; don't commit or stash for them." };
+            }
+            if (f.kind === 'verify') {
+                if (r.code === 0)
+                    return { probe, ok: true };
+                return r.code === 1 ? { probe, ok: false, why: `${shown(f.ref)} isn't here`, fix: 'Fetch it first, or ask the person.' } : null;
+            }
+            if (r.code !== 0)
+                return null;
+            const cur = r.out.trim();
+            if (cur === f.branch)
+                return { probe, ok: true };
+            return { probe, ok: false, why: `This checkout is on ${cur === 'HEAD' ? 'a detached commit' : shown(cur)}, not ${shown(f.branch)}`, fix: 'Ask the person before switching.' };
+        }
+    }
+}
+const cachePath = (env) => trailPath(env, 'state', 'probes.json');
+const cacheKey = (checkout, probe) => createHash('sha256').update(`${checkout}\0${probe}`).digest('hex').slice(0, 24);
+function readCache(env) {
+    const raw = readJsonSafe(cachePath(env));
+    const entries = raw && typeof raw === 'object' && raw.entries && typeof raw.entries === 'object' && !Array.isArray(raw.entries) ? raw.entries : {};
+    return { v: 1, entries };
+}
+const fresh = (e, now) => {
+    const at = e ? Date.parse(e.at) : NaN;
+    return !Number.isNaN(at) && now.getTime() - at < CACHE_MS && at - now.getTime() < 60_000;
+};
+/** Allowlisted local probes only, without a shell, 300 ms total, cached 10 min in <home>/state/probes.json keyed by checkout+probe. */
+export function runProbes(s, checkout, now = new Date(), env = process.env, opts = {}) {
+    const budget = Math.max(0, Math.min(PROBE_BUDGET_MS, opts.budgetMs ?? PROBE_BUDGET_MS));
+    const deadline = Date.now() + budget;
+    const left = () => deadline - Date.now();
+    const probes = readyProbes(s).map((p) => ({ probe: p, form: formOf(p) })).filter((x) => x.form !== null);
+    if (!probes.length)
+        return [];
+    const cache = readCache(env);
+    const out = [];
+    let changed = false;
+    for (const { probe, form } of probes) {
+        const key = cacheKey(checkout, probe);
+        const hit = cache.entries[key];
+        if (hit && fresh(hit, now)) {
+            out.push({ probe, ok: hit.ok, ...(hit.why ? { why: hit.why } : {}), ...(hit.fix ? { fix: hit.fix } : {}) });
+            continue;
+        }
+        if (left() <= 0)
+            continue;
+        const r = runOne(probe, form, checkout, env, opts.git ?? defaultGit, left);
+        if (!r)
+            continue;
+        out.push(r);
+        cache.entries[key] = { at: now.toISOString(), ok: r.ok, ...(r.why ? { why: r.why } : {}), ...(r.fix ? { fix: r.fix } : {}) };
+        changed = true;
+    }
+    if (changed) {
+        for (const [k, e] of Object.entries(cache.entries))
+            if (!fresh(e, now))
+                delete cache.entries[k];
+        try {
+            writePrivate(cachePath(env), JSON.stringify(cache));
+        }
+        catch { /* the next prompt probes again */ }
+    }
+    return out;
+}
+//# sourceMappingURL=probes.js.map

package/dist/skills/probes.js.map

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

package/dist/skills/ran-less.d.ts

@@ -0,0 +1,5 @@
+/** Whether `ran` did less than `step`: see the header. Reads only the simple commands running the step's own (program and verb). */
+export declare function doesLess(step: string, ran: string): boolean;
+/** A call that can't be a step of its own for a fold: it hides its failure, or only rehearsed (`--dry-run`, `-n`). */
+export declare function onlyRehearsed(ran: string): boolean;
+//# sourceMappingURL=ran-less.d.ts.map

package/dist/skills/ran-less.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ran-less.d.ts","sourceRoot":"","sources":["../../src/skills/ran-less.ts"],"names":[],"mappings":"AA4BA,oIAAoI;AACpI,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAY3D;AAED,sHAAsH;AACtH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOlD"}

package/dist/skills/ran-less.js

@@ -0,0 +1,51 @@
+/**
+ * D138 (2): a call that ran a skill's step but made it do less is not that step for credit: it added a flag that
+ * stops the work (`--dry-run`, `-n`, a `-qn` bundle, `--no-...`) the step lacked, or a trailing `; exit 0`,
+ * `|| true`, `|| :` (or `|| exit 0`) that hides the step's failure. Output-only `--no-` flags (colour, progress,
+ * pager, fund, audit, update notices) change nothing the step does, so they still count. Pure.
+ */
+import { simpleCommands } from '../trace/shell.js';
+import { unquote, words } from '../trace/shell-scan.js';
+const LESS = /^(?:--dry-?run|-n|--no-[\w-]+)$/i;
+const OUTPUT_ONLY = /^--no-(?:colou?rs?|progress|pager|fund|audit|update-notifier|emoji|spin(?:ner)?|banner)$/i;
+const HIDES_FAILURE = /(?:;\s*exit\s+0|\|\|\s*(?:true|:|exit\s+0))\s*;?\s*$/;
+/** The do-less flags in one simple command: `--x=y` as `--x`, a short bundle letter by letter. */
+function lessIn(simple) {
+    return words(simple).map((w) => unquote(w)).flatMap((w) => {
+        const f = /^-[A-Za-z]{2,}$/.test(w) ? [...w.slice(1)].map((c) => `-${c}`) : w.startsWith('-') ? [w.split('=')[0]] : [];
+        return f.filter((x) => LESS.test(x) && !OUTPUT_ONLY.test(x));
+    });
+}
+/** What a simple command runs: its program and first word that isn't a flag (`npm run`, `git push`), env assignments off. */
+function head(simple) {
+    const ws = words(simple).map((w) => unquote(w)).filter((w) => !/^[A-Za-z_]\w*=/.test(w));
+    const verb = ws.slice(1).find((w) => !w.startsWith('-'));
+    return ws.length ? `${ws[0]} ${verb ?? ''}` : '';
+}
+/** Whether `ran` did less than `step`: see the header. Reads only the simple commands running the step's own (program and verb). */
+export function doesLess(step, ran) {
+    try {
+        const s = String(step ?? '').trim();
+        const r = String(ran ?? '').trim();
+        if (HIDES_FAILURE.test(r) && !HIDES_FAILURE.test(s))
+            return true;
+        const stepParts = simpleCommands(s);
+        const progs = new Set(stepParts.map(head).filter(Boolean));
+        const had = new Set(stepParts.flatMap(lessIn));
+        return simpleCommands(r).filter((x) => progs.has(head(x))).flatMap(lessIn).some((f) => !had.has(f));
+    }
+    catch {
+        return false;
+    }
+}
+/** A call that can't be a step of its own for a fold: it hides its failure, or only rehearsed (`--dry-run`, `-n`). */
+export function onlyRehearsed(ran) {
+    try {
+        const r = String(ran ?? '').trim();
+        return HIDES_FAILURE.test(r) || simpleCommands(r).flatMap(lessIn).some((f) => !/^--no-/i.test(f));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=ran-less.js.map

package/dist/skills/ran-less.js.map

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

package/dist/skills/recall.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Bringing skills back (design 4.6, 4.7, spec 11): which skill, if any, a
+ * typed prompt asks for, and the one line a session starts with.
+ *
+ * The cue matcher reads only the person's own words (`askText`: no pasted
+ * code, quoted lines or very long lines) and picks at most one skill:
+ *  - a name cue: the prompt names the skill;
+ *  - a job cue: the prompt is the skill's job (its class of ask, or one of
+ *    the asks it was saved with, word for word with at most one word between);
+ *  - a check cue: a status question ("is it live?") about the skill used
+ *    most recently here, answered with its check line only.
+ * Any other status or history question, a problem report, or an ask of
+ * more than 25 words matches nothing (up to 60 when it names the skill's
+ * place and its job verb, D71 a). Only candidate and active skills in
+ * scope are candidates: held items, retired, needs-fix and skills the person
+ * turned off never are.
+ *
+ * Only the words go into the match; nothing typed is stored.
+ */
+import type { PromptParams } from '../trace/types.js';
+import type { ParsedSkill, SkillRef, SkillState } from './types.js';
+import { type ScopeCtx } from './store.js';
+export interface NormPrompt {
+    raw: string;
+    words: string[];
+    content: string[];
+    params: PromptParams;
+    status: boolean;
+    problem: boolean;
+    wordCount: number;
+}
+/**
+ * 1b: `here` is where candidatesHere found it (the checkout and env), so the block can check its anchors at
+ * injection (4.18); `phraseSha` is set on the candidate a job cue picked by one of its asks phrases (R30).
+ */
+export interface Candidate {
+    ref: SkillRef;
+    skill: ParsedSkill;
+    state: SkillState | null;
+    here?: {
+        checkout: string;
+        env?: NodeJS.ProcessEnv;
+    };
+    phraseSha?: string | null;
+}
+/** 1b: `phraseSha` is the asks phrase a job cue hit (8 hex, R30), null otherwise; the same value rides on `cand`. */
+export interface CueResult {
+    kind: 'job' | 'name' | 'check';
+    cand: Candidate;
+    score: number;
+    values: Record<string, string>;
+    notes: string[];
+    phraseSha?: string | null;
+}
+/** 4.6: the ask's words, its shape values as params and placeholders, its content words, and its kind. */
+export declare function normalizePrompt(typed: string): NormPrompt;
+/**
+ * Where a phrase hits the prompt's words: every phrase word in order, with at most one extra word in total
+ * between them. The indexes of the words it covered, or null. Greedy is exact here: taking the next word when it
+ * matches never costs the one skip.
+ */
+export declare function phraseHit(words: string[], phrase: string[]): number[] | null;
+/** 4.6 job cue for one skill: its class matched, an ask hit word for word, and how much of the prompt the asks cover. */
+export declare function scoreJobCue(np: NormPrompt, s: ParsedSkill): {
+    score: number;
+    hits: number;
+    classMatch: boolean;
+    exact: boolean;
+    phrase: string | null;
+};
+/**
+ * D118 b: the cue's values with the run's own bound ones under this prompt's: a version (or sha, PR, ...) an
+ * earlier ask of the same run named holds for the run's life, across turns and re-sent blocks; one this prompt
+ * names wins.
+ */
+export declare function withRunParams(cue: CueResult, runParams: Record<string, unknown>, np: NormPrompt): CueResult;
+/** 4.6. Ignores once-per-epoch: the caller decides between a block and a re-arm (3.2 step 8). */
+export declare function matchCue(np: NormPrompt, cands: Candidate[], lastUsed: {
+    id: string;
+    at: string;
+} | null, now?: Date): CueResult | null;
+/**
+ * The risk rules again at recall time, on what a block would show: a SKILL.md can be edited by hand after Trail
+ * wrote it, so a step, the check or a check-first line the rules refuse (a download piped into a shell, `rm -rf ~`,
+ * sudo, a credential file, Trail itself) keeps the whole skill out. `values`: the block's values, filled in first
+ * (a param default can be edited too). The reason in words ("step 3 runs sudo"), or null.
+ */
+export declare function refusedAtRecall(s: ParsedSkill, values?: Record<string, string>): string | null;
+/**
+ * A skill the index line names as not used: needs-fix by its record, or refused at recall (`why`). 1b:
+ * `correctedStep`, for a skill corrected twice, is the step both corrected uses ended at, else null (4.17).
+ */
+export type NotUsed = Candidate & {
+    why?: string;
+    correctedStep?: number | null;
+};
+/** Candidate and active skills in scope; needs-fix ones, and ones the risk rules refuse now, come back separately for the index line. */
+export declare function candidatesHere(ctx: ScopeCtx): {
+    cands: Candidate[];
+    needsFix: NotUsed[];
+    adopted: string[];
+};
+/** The name a skill goes by in anything Trail says or an agent runs: its folder's, never a name edited into the file. */
+export declare const nameOf: (c: Pick<Candidate, "ref" | "skill">) => string;
+/**
+ * Why a needs-fix skill isn't used, in the index's words (4.17, J14a): 1a's failed words as they are; two
+ * corrections as `step {n} was corrected on {d1} and {d2}`, or `corrected on {d1} and {d2}` when they touched no
+ * one step.
+ */
+export declare function needsFixWords(c: NotUsed): string | undefined;
+/**
+ * The SessionStart index line (4.7), '' when none. 1b (4.18, 4.19): with `now`, a skill unused for 60 days is left
+ * out (its cues still fire); `gone` says which listed skills may be out of date (checked for the 5 listed only).
+ */
+export declare function indexLine(cands: Candidate[], needsFix: NotUsed[], opts?: {
+    now?: Date;
+    gone?: (c: Candidate) => boolean;
+}): string;
+//# sourceMappingURL=recall.d.ts.map

package/dist/skills/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/skills/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAS,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK3E,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOlE,MAAM,WAAW,UAAU;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC3J;;;GAGG;AACH,MAAM,WAAW,SAAS;IAAG,GAAG,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AAC3K,qHAAqH;AACrH,MAAM,WAAW,SAAS;IAAG,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AAqBzK,0GAA0G;AAC1G,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAiBzD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAe5E;AAgDD,yHAAyH;AACzH,wBAAgB,WAAW,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CA4BvJ;AAyCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,UAAU,GAAG,SAAS,CAG3G;AAED,iGAAiG;AACjG,wBAAgB,QAAQ,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAAE,GAAG,GAAE,IAAiB,GAAG,SAAS,GAAG,IAAI,CAkClJ;AAKD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM,GAAG,IAAI,CAclG;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAalF,yIAAyI;AACzI,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAmC5G;AAQD,yHAAyH;AACzH,eAAO,MAAM,MAAM,GAAI,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,OAAO,CAAC,WAA6C,CAAC;AASxG;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAM5D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,OAAO,CAAA;CAAO,GAAG,MAAM,CAmBtI"}