@nanonets/graft 0.23.1 → 0.24.1

package/dist/skills/runblock.js

@@ -0,0 +1,222 @@
+/**
+ * What a skill brings back (design 4.15, spec 11): the run block a job or
+ * name cue injects, the check line a status question gets, the injection
+ * recorded for either, and the one line the person sees.
+ *
+ * The block is past tense and attributed ("fits", "last worked Oct 14",
+ * "what worked was step 5"), never an order: the agent starts from the
+ * steps because they worked here before. At most 1,200 characters. Every
+ * value is flattened to one line and every line after the header starts
+ * with two spaces, so nothing in a skill file can open a `[trail]` line.
+ *
+ * A step that can't be undone is said once, after its group: where the
+ * host can ask the person, Claude Code will ask before the group's first
+ * step and the agent waits for that; where it can't (headless, permissions
+ * skipped, another host), the agent shows the person the command instead
+ * of running it (D17). The words never tell the agent not to ask and never
+ * say what one yes covers (D101): an agent read those as a bypass.
+ */
+import { randomBytes } from 'node:crypto';
+import { nameOf } from './recall.js';
+import { flatLine } from '../notes/flatten.js';
+import { monthDay } from './compile-words.js';
+import { fillParams } from './params.js';
+import { gatedGroups, gatedKind } from './risk.js';
+import { neverSave } from './never-save.js';
+import { checkFamilyOf } from '../trace/checks.js';
+import { commandKind } from '../trace/shell.js';
+import { beforeYouStart } from './skillmd.js';
+import { probePassWords } from './probes.js';
+import { isGuardrailLesson, lessonLines, lessonRefused, readLessons } from './lessons.js';
+import { goneAnchors, outOfDateLine } from './anchors.js';
+import { WIDE_SCAN_MS } from './anchors-wide.js';
+export { runProbes, probePassWords, readyProbes, PROBE_BUDGET_MS } from './probes.js';
+export const RUN_BLOCK_MAX = 1200;
+/** A command or value on one line, never cut (a cut command would be wrong; an overlong block becomes the pointer). */
+const flat = (t) => flatLine(t, 4000);
+const prose = (t, max = 200) => flatLine(t, max);
+/** 'Oct 14' for a local date (`2026-10-14`) or an ISO time, in local time. */
+export function dayWords(d) {
+    if (!d)
+        return 'an earlier day';
+    const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(d);
+    return m ? monthDay(new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3])).toISOString()) : monthDay(d);
+}
+const OWNER = { personal: 'yours', repo: "the repo's", team: "the team's" };
+/** 'last worked Oct 14', or 'saved Oct 14' for a skill that never checked out. */
+function whenWords(c) {
+    return c.state?.lastWorked ? `last worked ${dayWords(c.state.lastWorked)}` : `saved ${dayWords(c.state?.addedAt ?? null)}`;
+}
+const listWords = (ns) => (ns.length === 2 ? `${ns[0]} and ${ns[1]}` : `${ns.slice(0, -1).join(', ')} and ${ns[ns.length - 1]}`);
+function gatedNote(steps, canAsk) {
+    const one = steps.length === 1;
+    const which = one ? `step ${steps[0]}` : `steps ${listWords(steps)}`;
+    // D101: never "don't ask", never what one yes covers (that stays in pre-bash-skills' gate logic).
+    // D118 a: a step whose ask was denied is not run again that turn (the lab's agent retried a push three times).
+    if (!canAsk) {
+        return one
+            ? `    This session can't ask the person, so don't run ${which} (it can't be undone), not even after a yes in chat; show them the command to run themselves.`
+            : `    This session can't ask the person, so don't run ${which} (they can't be undone), not even after a yes in chat; show them the commands to run themselves.`;
+    }
+    const retry = ` If they say no, don't retry this turn; ask them to run ${one ? 'it' : 'them'}.`;
+    return one
+        ? `    Claude Code will ask the person before ${which} (it can't be undone); wait for that.${retry}`
+        : `    Claude Code will ask the person before step ${steps[0]} (${which} can't be undone); wait for that.${retry}`;
+}
+/** What a tests or query check shows by default: "step n passing" already says it. */
+const PLAIN_SHOWS = new Set(['the tests pass', 'rows come back']);
+function checkText(c, values) {
+    const s = c.skill;
+    if (!s.check)
+        return null;
+    const shows = s.checkShows ? prose(fillParams(s.checkShows, values)) : s.meta['check-tool'] ? 'READY' : null;
+    return { text: flat(fillParams(s.check, values)), shows };
+}
+/** 1b: a personal skill's lessons from its own folder (4.16); none for a skill that isn't in one. */
+function lessonsOf(c) {
+    return c.ref.scope === 'personal' && c.ref.dir ? readLessons(c.ref.dir) : [];
+}
+/** 1b: the anchors gone where the candidate was found (4.18; local file reads only). Phase 2 (4.13): a job cue's block may scan the CLI (its own 150 ms); a compaction's (SessionStart) reads only the cache. */
+function goneOf(c, scan, until) {
+    return c.here ? goneAnchors(c.skill, c.here.checkout, c.here.env ?? process.env, { scan, deadline: Math.min(until ?? Infinity, Date.now() + WIDE_SCAN_MS) }) : [];
+}
+/**
+ * canAsk: interactive entry, permission_mode in hostFacts.askModes, host claude (4.15 step 5).
+ * 1b: `lessons` (default: the skill folder's) end the block, guardrail-kind first (4.16); `gone` (default: the
+ * anchors gone where the candidate was found) opens it with the out-of-date line (4.18). Both count toward 1,200:
+ * lessons are the second thing cut, oldest first; guardrail-kind lessons and the out-of-date line never are.
+ */
+export function runBlock(c, ctx) {
+    const s = c.skill;
+    const name = nameOf(c);
+    const ood = outOfDateLine(name, ctx.gone ?? goneOf(c, ctx.header === 'job', ctx.anchorDeadline));
+    const opening = ood ? [`[trail] ${ood}`] : [];
+    // A lesson is information the person kept (J07), filled like the steps; one edited by hand to skip the ask, or to
+    // hold a refused or gated command, is left out (D88, D101, 4.14 step 3: lessonRefused).
+    const kept = (ctx.lessons ?? lessonsOf(c)).map((l) => ({ ...l, text: fillParams(l.text, ctx.values) })).filter((l) => !lessonRefused(l.text));
+    const guardLines = lessonLines(kept.filter(isGuardrailLesson)).map((l) => `  ${l}`);
+    const lessonRest = lessonLines(kept.filter((l) => !isGuardrailLesson(l))).map((l) => `  ${l}`);
+    const owner = `${OWNER[c.ref.scope] ?? 'yours'}, v${prose(s.meta.version || '1', 12)}, ${whenWords(c)}`;
+    const header = ctx.header === 'compact'
+        ? `[trail] You were partway through skill ${name} when the conversation was compacted. Its steps (${owner}):`
+        : `[trail] Skill ${name} fits (${owner}).${ctx.lastFail ? ` Last time step ${ctx.lastFail.step} failed; watch its output.` : ''} Start from these exact steps, in order:`;
+    const failed = ctx.probes.filter((p) => !p.ok).map((p) => `  ready: ${prose(p.why ?? p.probe)}.${p.fix ? ` ${prose(p.fix)}` : ''}`);
+    const passedWords = ctx.probes.filter((p) => p.ok).map((p) => probePassWords(p.probe)).filter((w) => !!w);
+    const passed = passedWords.length ? `  ready: ${passedWords.join(', ')}` : null;
+    // D116 item 5: what the person does first (a login the run fed keystrokes into, kept out of the steps).
+    const before = beforeYouStart(s.meta).map((l) => `  before you start: ${prose(l)}.`);
+    const checkFirst = String(s.meta['check-first'] ?? '').split(' ; ').map((x) => x.trim()).filter(Boolean).map((x) => `  check first: ${flat(x)}`);
+    const groups = gatedGroups(s.steps);
+    const steps = [];
+    for (const st of s.steps) {
+        const note = st.wait ? ' (a wait: run it in the background if it may take over 2 minutes)' : st.bg ? ' (in the background)' : '';
+        steps.push(`  ${st.n} ${flat(fillParams(st.cmd, ctx.values))}${note}`);
+        const g = groups.find((x) => x.steps[x.steps.length - 1] === st.n);
+        if (g)
+            steps.push(gatedNote(g.steps, ctx.canAsk));
+    }
+    const chk = checkText(c, ctx.values);
+    let check = null;
+    if (chk) {
+        const asStep = [...s.steps].reverse().find((x) => x.cmd === s.check);
+        if (asStep && !s.meta['check-tool']) {
+            check = chk.shows && !PLAIN_SHOWS.has(chk.shows) ? `  check: step ${asStep.n} passing is the check (it should show ${chk.shows}).` : `  check: step ${asStep.n} passing is the check.`;
+        }
+        else
+            check = `  check: ${chk.text}${chk.shows ? ` (it should show ${chk.shows})` : ''}`;
+    }
+    // A line edited by hand to hold a command the risk rules refuse is left out.
+    const fails = s.ifFails.filter((l) => !neverSave(l)).slice(0, 2).map((l) => `  If it fails: ${prose(l)}`);
+    const notes = ctx.notes.map((n) => `  ${prose(n)}`);
+    const footer = `  If a step fails, fix that step and say so. End with "Used skill ${name}".`;
+    const build = (o) => [
+        ...opening, header, ...failed, ...(o.passed && passed ? [passed] : []), ...before, ...checkFirst, ...steps, ...(check ? [check] : []),
+        ...fails.slice(0, o.fails), ...(o.notes ? notes : []), footer, ...guardLines, ...lessonRest.slice(lessonRest.length - o.lessons),
+    ].join('\n');
+    const all = lessonRest.length;
+    for (const o of [
+        { notes: true, fails: 2, passed: true, lessons: all }, { notes: false, fails: 2, passed: true, lessons: all },
+        ...Array.from({ length: all }, (_, i) => ({ notes: false, fails: 2, passed: true, lessons: all - 1 - i })),
+        { notes: false, fails: 1, passed: true, lessons: 0 }, { notes: false, fails: 1, passed: false, lessons: 0 },
+    ]) {
+        const block = build(o);
+        if (block.length <= RUN_BLOCK_MAX)
+            return block;
+    }
+    return [...opening, `[trail] Skill ${name} fits this ask, but its steps are too long to show here. Run trail skills show ${name} and start from them.`].join('\n');
+}
+/** A GET with curl or wget: no other method, no body, no upload. */
+const HTTP_GET = /^(?:curl|wget)\s/;
+const HTTP_WRITES = /\s(?:-X\s*(?!GET\b)\w|--request\s*(?!GET\b)\w|-d\b|--data\b|--data-\w+|-F\b|--form\b|-T\b|--upload-file\b|--post-\w+|--method=(?!GET\b))/i;
+/**
+ * D116 item 1: the check is a step that only reads (a status, a view, a log, a GET, a tests or query run), so a
+ * status question may run it. A push (it is the step that moved the branch), anything gated, or a command
+ * that changes things is not: that skill gets no check line.
+ */
+export function readOnlyCheck(s) {
+    const cmd = String(s.check ?? '').trim();
+    if (!cmd)
+        return false;
+    if (s.meta['check-tool'])
+        return true;
+    if (gatedKind(cmd) || s.steps.some((x) => x.cmd === s.check && x.gated))
+        return false;
+    const fam = checkFamilyOf(cmd, s.meta.job ?? null);
+    if (fam)
+        return fam !== 'push';
+    if (HTTP_GET.test(cmd))
+        return !HTTP_WRITES.test(` ${cmd}`);
+    return commandKind(cmd) === 'look';
+}
+/** The check line for a status question; '' when the skill has no check, or none that only reads (D116 item 1). */
+export function checkLine(c, values) {
+    if (!readOnlyCheck(c.skill))
+        return '';
+    const chk = checkText(c, values);
+    const name = nameOf(c);
+    if (!chk)
+        return '';
+    return `[trail] To check ${name}: ${chk.text}${chk.shows ? ` (it should show ${chk.shows})` : ''}. Answer from what it shows; don't run any other step.`;
+}
+/** D106: a check that shows a `{version}` param, filled with a literal version: what credit expects it to show. */
+function checkVersionOf(c, values) {
+    const name = /^\{([A-Za-z_]\w*)\}$/.exec(String(c.skill.checkShows ?? '').trim())?.[1];
+    const v = name && c.skill.params.some((p) => p.name === name && p.shape === 'version') ? values[name] : undefined;
+    const m = v === undefined ? null : /^v?(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)$/.exec(v.trim());
+    return m ? { checkVersion: m[1] } : {};
+}
+/** The SkillInjection recorded for a block or check line (live: true for job, name and compact cues). */
+export function injectionFor(c, values, cue, epoch, now = new Date()) {
+    const s = c.skill;
+    const block = cue !== 'check';
+    const tool = s.meta['check-tool'];
+    return {
+        injId: `i-${randomBytes(3).toString('hex')}`,
+        skillId: c.ref.id || s.meta.trail,
+        name: c.ref.name || s.name,
+        epoch,
+        at: now.toISOString(),
+        cue,
+        params: { ...values },
+        steps: block ? s.steps.map((st) => fillParams(st.cmd, values)) : [],
+        gated: block ? s.steps.filter((st) => st.gated).map((st) => ({ step: st.n, kind: st.gated })) : [],
+        check: s.check ? fillParams(s.check, values) : null,
+        ...(tool ? { checkTool: tool } : {}),
+        ...checkVersionOf(c, values),
+        runId: null,
+        live: block,
+        // 1b (R30): the asks phrase a job cue fired on, by its sha only.
+        ...(cue === 'job' && typeof c.phraseSha === 'string' && /^[0-9a-f]{8}$/.test(c.phraseSha) ? { phraseSha: c.phraseSha } : {}),
+    };
+}
+/** g4's open issue 4 (D71 d): the ready probes that failed for a block ride on its injection, for the use line (never counted against the skill). */
+export function withReadyFailed(inj, probes) {
+    const failed = probes.filter((p) => !p.ok).map((p) => p.probe);
+    return failed.length ? { ...inj, readyFailed: failed } : inj;
+}
+/** 'trail: using skill <name> (v<n>, worked <Mon D>)'. */
+export function useNotice(c) {
+    const when = c.state?.lastWorked ? `worked ${dayWords(c.state.lastWorked)}` : `saved ${dayWords(c.state?.addedAt ?? null)}`;
+    return `trail: using skill ${nameOf(c)} (v${prose(c.skill.meta.version || '1', 12)}, ${when})`;
+}
+//# sourceMappingURL=runblock.js.map

package/dist/skills/runblock.js.map

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

package/dist/skills/save-parse.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Reading a `trail skills add` command (design 4.9 step 1), whatever runs it:
+ * `trail`, `graft`, `npx @trailhq/trail-code`, `node .../trail.js`,
+ * `bash -c "..."`, `eval`, an alias or xargs. `skills add` anywhere in the
+ * command is an add; it must read as exactly `skills add <name> --run <id>`,
+ * once. Re-exported from `save-gate.ts`, where the design names it.
+ *
+ * Phase 2 (4.11): `trail skills update <name> --offer <id>`, read stricter
+ * still: nothing chained and no root options, since its gate writes a file.
+ */
+export interface SkillsAddCmd {
+    name: string;
+    runId: string;
+    flags: string[];
+}
+/** /\bskills\s+add\b/: anywhere in the command, whatever binary, wrapper or path runs it. */
+export declare const SKILLS_ADD_RE: RegExp;
+/** null when the command doesn't parse as `<anything> skills add <name> --run <id>`, or adds more than once. */
+export declare function parseSkillsAdd(command: string): SkillsAddCmd | null;
+export interface SkillsLessonCmd {
+    skill: string | null;
+    offerId: string;
+    flags: string[];
+}
+/** /\bskills\s+lesson\b/: anywhere in the command, whatever runs it (the lesson gate, R12's twin of SKILLS_ADD_RE). */
+export declare const SKILLS_LESSON_RE: RegExp;
+/** Every save the gate guards: a skill's add, a lesson's keep, and (phase 2) a skill's update. */
+export declare const SAVE_GATE_RE: RegExp;
+/** null when the command doesn't parse as `<anything> skills lesson [<skill>] --offer <id>`, or keeps more than one. */
+export declare function parseSkillsLesson(command: string): SkillsLessonCmd | null;
+export interface SkillsUpdateCmd {
+    name: string;
+    offerId: string;
+}
+/** /\bskills\s+update\b/: anywhere in the command, whatever runs it. */
+export declare const SKILLS_UPDATE_RE: RegExp;
+/**
+ * null unless the command is exactly one `<trail> skills update <name> --offer <o-id>`, Trail's own and nothing
+ * else (1a's `onlyTrail`, one simple command after any leading cds, no pipe), with no other add, lesson or update.
+ */
+export declare function parseSkillsUpdate(command: string): SkillsUpdateCmd | null;
+//# sourceMappingURL=save-parse.d.ts.map

package/dist/skills/save-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-parse.d.ts","sourceRoot":"","sources":["../../src/skills/save-parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE;AAE9E,6FAA6F;AAC7F,eAAO,MAAM,aAAa,QAAqB,CAAC;AAgDhD,gHAAgH;AAChH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA0BnE;AAID,MAAM,WAAW,eAAe;IAAG,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE;AAE3F,uHAAuH;AACvH,eAAO,MAAM,gBAAgB,QAAwB,CAAC;AAEtD,kGAAkG;AAClG,eAAO,MAAM,YAAY,QAAuC,CAAC;AAEjE,wHAAwH;AACxH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA0BzE;AAID,MAAM,WAAW,eAAe;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAElE,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,QAAwB,CAAC;AAWtD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAmBzE"}

package/dist/skills/save-parse.js

@@ -0,0 +1,172 @@
+/**
+ * Reading a `trail skills add` command (design 4.9 step 1), whatever runs it:
+ * `trail`, `graft`, `npx @trailhq/trail-code`, `node .../trail.js`,
+ * `bash -c "..."`, `eval`, an alias or xargs. `skills add` anywhere in the
+ * command is an add; it must read as exactly `skills add <name> --run <id>`,
+ * once. Re-exported from `save-gate.ts`, where the design names it.
+ *
+ * Phase 2 (4.11): `trail skills update <name> --offer <id>`, read stricter
+ * still: nothing chained and no root options, since its gate writes a file.
+ */
+import { leadingCds, onlyTrail, simpleCommands } from '../trace/shell.js';
+/** /\bskills\s+add\b/: anywhere in the command, whatever binary, wrapper or path runs it. */
+export const SKILLS_ADD_RE = /\bskills\s+add\b/;
+const ALL_ADDS = /\bskills\s+add\b/g;
+/** Where the add's own words end, outside quotes: the next command, a redirect, a comment, a subshell's end. */
+const STOP = new Set([';', '&', '|', ')', '<', '>', '\n', '\r', '`']);
+/** The words after `skills add`, up to the end of that command. A quote never closed ends it (the close of `bash -c "..."`). */
+function tailWords(tail) {
+    const out = [];
+    let cur = '';
+    let has = false;
+    const flush = () => {
+        if (has)
+            out.push(cur);
+        cur = '';
+        has = false;
+    };
+    for (let i = 0; i < tail.length; i++) {
+        const ch = tail[i];
+        if (ch === '"' || ch === "'") {
+            const end = tail.indexOf(ch, i + 1);
+            if (end < 0)
+                break;
+            cur += tail.slice(i + 1, end);
+            has = true;
+            i = end;
+            continue;
+        }
+        if (ch === '\\' && i + 1 < tail.length && tail[i + 1] !== '\n') {
+            cur += tail[i + 1];
+            has = true;
+            i++;
+            continue;
+        }
+        if (STOP.has(ch)) {
+            // `2>&1`: digits right before a redirect are the redirect's, not a word.
+            if ((ch === '>' || ch === '<') && /^\d+$/.test(cur))
+                has = false;
+            break;
+        }
+        if (ch === '#' && !has)
+            break;
+        if (ch === ' ' || ch === '\t') {
+            flush();
+            continue;
+        }
+        cur += ch;
+        has = true;
+    }
+    flush();
+    return out;
+}
+/** null when the command doesn't parse as `<anything> skills add <name> --run <id>`, or adds more than once. */
+export function parseSkillsAdd(command) {
+    const text = String(command ?? '');
+    const hits = [...text.matchAll(ALL_ADDS)];
+    if (hits.length !== 1)
+        return null;
+    const words = tailWords(text.slice(hits[0].index + hits[0][0].length));
+    let name = null;
+    let runId = null;
+    const flags = [];
+    for (let i = 0; i < words.length; i++) {
+        const w = words[i];
+        if (w === '--run' && runId === null && i + 1 < words.length) {
+            runId = words[++i];
+            continue;
+        }
+        if (w.startsWith('--run=') && runId === null) {
+            runId = w.slice(6);
+            continue;
+        }
+        if (!w.startsWith('-') && name === null) {
+            name = w;
+            continue;
+        }
+        flags.push(w);
+    }
+    if (name === null || runId === null || !runId)
+        return null;
+    return { name, runId, flags };
+}
+/** /\bskills\s+lesson\b/: anywhere in the command, whatever runs it (the lesson gate, R12's twin of SKILLS_ADD_RE). */
+export const SKILLS_LESSON_RE = /\bskills\s+lesson\b/;
+const ALL_LESSONS = /\bskills\s+lesson\b/g;
+/** Every save the gate guards: a skill's add, a lesson's keep, and (phase 2) a skill's update. */
+export const SAVE_GATE_RE = /\bskills\s+(?:add|lesson|update)\b/;
+/** null when the command doesn't parse as `<anything> skills lesson [<skill>] --offer <id>`, or keeps more than one. */
+export function parseSkillsLesson(command) {
+    const text = String(command ?? '');
+    const hits = [...text.matchAll(ALL_LESSONS)];
+    if (hits.length !== 1 || [...text.matchAll(ALL_ADDS)].length)
+        return null;
+    const words = tailWords(text.slice(hits[0].index + hits[0][0].length));
+    let skill = null;
+    let offerId = null;
+    const flags = [];
+    for (let i = 0; i < words.length; i++) {
+        const w = words[i];
+        if (w === '--offer' && offerId === null && i + 1 < words.length) {
+            offerId = words[++i];
+            continue;
+        }
+        if (w.startsWith('--offer=') && offerId === null) {
+            offerId = w.slice(8);
+            continue;
+        }
+        if (!w.startsWith('-') && skill === null && offerId === null) {
+            skill = w;
+            continue;
+        }
+        flags.push(w);
+    }
+    if (!offerId)
+        return null;
+    return { skill, offerId, flags };
+}
+/** /\bskills\s+update\b/: anywhere in the command, whatever runs it. */
+export const SKILLS_UPDATE_RE = /\bskills\s+update\b/;
+const ALL_UPDATES = /\bskills\s+update\b/g;
+/** Past this the command is not read (D89). */
+const UPDATE_MAX = 64 * 1024;
+/** What comes right before `skills update`: a Trail binary, nothing between it and `skills` (no root option). */
+const TRAIL_BIN = /(?:^|[\s/"'(])(?:trail|graft|trail-code|@trailhq\/trail-code|@nanonets\/graft|(?:trail|graft)\.js)\s+$/;
+const SKILL_NAME = /^[a-z0-9][a-z0-9-]{0,63}$/;
+const OFFER_ID = /^o-[0-9a-f]{6}$/;
+/** A pipe (not `||`): its other side could cut or rewrite what the update prints. */
+const PIPE = /(?:^|[^|])\|(?!\|)/;
+/**
+ * null unless the command is exactly one `<trail> skills update <name> --offer <o-id>`, Trail's own and nothing
+ * else (1a's `onlyTrail`, one simple command after any leading cds, no pipe), with no other add, lesson or update.
+ */
+export function parseSkillsUpdate(command) {
+    const text = String(command ?? '');
+    if (text.length > UPDATE_MAX)
+        return null;
+    const hits = [...text.matchAll(ALL_UPDATES)];
+    if (hits.length !== 1 || SKILLS_ADD_RE.test(text) || SKILLS_LESSON_RE.test(text))
+        return null;
+    if (!TRAIL_BIN.test(text.slice(Math.max(0, hits[0].index - 200), hits[0].index)))
+        return null;
+    if (PIPE.test(text) || !onlyTrail(text) || simpleCommands(leadingCds(text).rest).length !== 1)
+        return null;
+    const words = tailWords(text.slice(hits[0].index + hits[0][0].length));
+    let name = null;
+    let offerId = null;
+    for (let i = 0; i < words.length; i++) {
+        const w = words[i];
+        if (w === '--offer' && offerId === null && i + 1 < words.length)
+            offerId = words[++i];
+        else if (w.startsWith('--offer=') && offerId === null)
+            offerId = w.slice(8);
+        else if (!w.startsWith('-') && name === null)
+            name = w;
+        else
+            return null;
+    }
+    if (!name || !offerId || !SKILL_NAME.test(name) || !OFFER_ID.test(offerId))
+        return null;
+    return { name, offerId };
+}
+//# sourceMappingURL=save-parse.js.map

package/dist/skills/save-parse.js.map

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

package/dist/skills/save-store.d.ts

@@ -0,0 +1,12 @@
+/**
+ * What the save gate reads from the skill store (g4), without changing it:
+ * where a name is taken, which runs are already kept, and the run a held
+ * item was kept from (D65: a live save for the same run replaces it).
+ */
+import type { SkillState } from './types.js';
+export { nameTaken } from './store.js';
+/** The skills state's entries; {} when it can't be read. */
+export declare function readSkillsStateSafe(env?: NodeJS.ProcessEnv): Record<string, SkillState>;
+/** The run id a held item of this name was kept from (`HeldItem.runId`); null when there is none or it doesn't say. */
+export declare function heldRunId(name: string, env?: NodeJS.ProcessEnv): string | null;
+//# sourceMappingURL=save-store.d.ts.map

package/dist/skills/save-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-store.d.ts","sourceRoot":"","sources":["../../src/skills/save-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAMvF;AAED,uHAAuH;AACvH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAM9E"}

package/dist/skills/save-store.js

@@ -0,0 +1,22 @@
+import { allHeld } from './store-held.js';
+import { readSkillsState } from './state.js';
+export { nameTaken } from './store.js';
+/** The skills state's entries; {} when it can't be read. */
+export function readSkillsStateSafe(env) {
+    try {
+        return readSkillsState(env).skills;
+    }
+    catch {
+        return {};
+    }
+}
+/** The run id a held item of this name was kept from (`HeldItem.runId`); null when there is none or it doesn't say. */
+export function heldRunId(name, env) {
+    try {
+        return allHeld(env).find((h) => h.name === name)?.runId ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=save-store.js.map

package/dist/skills/save-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-store.js","sourceRoot":"","sources":["../../src/skills/save-store.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,GAAuB;IACzD,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAuB;IAC7D,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/skills/settings.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `~/.trail/settings.json`: learned skills on or off (off by default), offers
+ * on or off (everywhere or per repo), pauses after two nos, skills a person
+ * turned off, and the governor's cache.
+ *
+ * Who may change what is fixed: only the person's own commands (the setters,
+ * imported only by `skills/cli-skills.ts`) turn skills and offers on or off;
+ * only the offer bookkeeping (`skills/offers.ts`) writes pauses and the
+ * governor. `trail init`, upgrades and `trail connect` never write this file.
+ * A test pins who imports what.
+ *
+ * A missing or broken file reads as the defaults. Keys a later version adds
+ * are kept on every write.
+ */
+import type { TrailSkillSettings } from './types.js';
+export { isTestHome, labInteractive } from './host-facts.js';
+export declare const DEFAULT_SETTINGS: TrailSkillSettings;
+/** Defaults on a missing or bad file; unknown keys are kept on every write. */
+export declare function readSettings(env?: NodeJS.ProcessEnv): TrailSkillSettings;
+/** TRAIL_TEST_NOW (ISO) in a test home only; else new Date(). */
+export declare function trailNow(env?: NodeJS.ProcessEnv): Date;
+/** The local calendar date `YYYY-MM-DD` of a time: days (pauses, session-days, last worked) are the person's days. */
+export declare function localDate(at: Date | string): string;
+/** onSince = now when it turns on. */
+export declare function setSkills(on: boolean, env?: NodeJS.ProcessEnv, now?: Date): TrailSkillSettings;
+/** here: adds or removes that repo key in offRepos; a global off sets offersOffAt. */
+export declare function setOffers(on: boolean, here: string | null, env?: NodeJS.ProcessEnv, now?: Date): TrailSkillSettings;
+export declare function setSkillOff(name: string, off: boolean, env?: NodeJS.ProcessEnv): TrailSkillSettings;
+export declare function pauseRepo(repoKey: string, until: Date, env?: NodeJS.ProcessEnv): TrailSkillSettings;
+export declare function noteGovernor(lastNine: Array<'yes' | 'no' | 'none'>, saidAt: string | null, env?: NodeJS.ProcessEnv): TrailSkillSettings;
+export declare function skillsOn(env?: NodeJS.ProcessEnv): boolean;
+export declare function offersHere(repoKey: string, now?: Date, env?: NodeJS.ProcessEnv): {
+    ok: true;
+} | {
+    ok: false;
+    why: 'off' | 'off-here' | 'paused';
+};
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/skills/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE7D,eAAO,MAAM,gBAAgB,EAAE,kBAIP,CAAC;AAmCzB,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAExE;AAiBD,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAOnE;AAED,sHAAsH;AACtH,wBAAgB,SAAS,CAAC,EAAE,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAInD;AAID,sCAAsC;AACtC,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,kBAAkB,CAK1G;AAED,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,kBAAkB,CAW/H;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAKnG;AAID,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAInG;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAKvI;AAED,wBAAgB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAEzD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAA;CAAE,CAO7J"}