@nanonets/graft 0.24.0 → 0.25.0

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

@@ -0,0 +1,64 @@
+import type { FoldResult } from '../trace/runs.js';
+import type { PreBashDecision } from '../claude/pre-bash.js';
+import type { CompiledSkill, Receipt } from './types.js';
+import type { RunSheet } from '../trace/types.js';
+import type { TraceEvent } from '../trace/claude.js';
+import { type HostDialect } from '../trace/dialect.js';
+import { type GateCtx } from '../trace/skill-session.js';
+import type { SkillSessionState } from '../trace/types.js';
+export { parseSkillsAdd, parseSkillsLesson, SAVE_GATE_RE, SKILLS_ADD_RE, SKILLS_LESSON_RE, type SkillsAddCmd, type SkillsLessonCmd } from './save-parse.js';
+export { DENY, verifySave, type SaveVerdict } from './save-verify.js';
+/** 3.3 step 3, after the gate: a deny, or null after writing the receipt (live or held). */
+export declare function checkSkillsAdd(input: any, ctx: GateCtx, st: SkillSessionState, fold: FoldResult | null): PreBashDecision | null;
+/** 3.3 step 3 from the gate's ctx on: the subagent and no-person denies, then the locked check. */
+export declare function saveGateFor(input: any, ctx: GateCtx): PreBashDecision | null;
+/** 3.3 step 3 whole, for `preBashSkills`: the gate, then `saveGateFor`. Skills off or no session: null (the CLI holds). Throws: null. */
+export declare function saveGate(input: any, dir: string, env?: NodeJS.ProcessEnv, now?: Date): PreBashDecision | null;
+/**
+ * 1b (3.3 step 2): the save gate for either save, `skills add` (this file) or `skills lesson` (lesson-gate.ts, loaded
+ * only for a lesson command); phase 2's `skills update` (update-gate.ts, loaded only for an update command). b7's `preBashSkills` calls this for a command matching SAVE_GATE_RE.
+ */
+export declare function saveOrLessonGate(input: any, dir: string, env?: NodeJS.ProcessEnv, now?: Date): Promise<PreBashDecision | null>;
+/**
+ * The GateCtx the CLI half rebuilds from a receipt (session, transcript, host, tier), with fold and learn as the
+ * receipt's tier allows. D93: its checkout and repo key are the run's (the sheet's checkout, else the receipt's,
+ * when it is still a checkout of the run's repo), never the CLI's own folder: a session that started above the repo
+ * runs `trail skills add` up there. verifySave still checks the run is this session's.
+ */
+export declare function ctxFromReceipt(r: Receipt, sheet: RunSheet, env?: NodeJS.ProcessEnv, now?: Date): GateCtx;
+/** The whole lines in the transcript's last 4 MB, newest last, as parsed objects ([] when unreadable). */
+export declare function tailEntries(tx: string): Array<Record<string, any>>;
+export type ToolCall = Extract<TraceEvent, {
+    kind: 'tool_call';
+}>;
+/**
+ * The main session's tool calls in the transcript's last 4 MB, oldest first, as the host's dialect reads them (4.16):
+ * Claude's tool_use blocks (subagent lines left out), Codex's function calls.
+ */
+export declare function tailCalls(tx: string, dialect: HostDialect, env: NodeJS.ProcessEnv): ToolCall[];
+/** The command a Bash call ran, or null for any other tool. */
+export declare const bashCommand: (c: ToolCall) => string | null;
+/** A write to Trail's files or the transcript among the tail's tool calls, whatever the session's cursor says. */
+export declare function tamperInTail(calls: ToolCall[], tx: string, env: NodeJS.ProcessEnv): string | null;
+/** 4.9 CLI step 5's two lines. */
+export declare function savedLines(c: CompiledSkill, n: number, endedAt: string, asked: Receipt['asked'], now: Date): [string, string];
+/** 4.9 CLI step 6's two lines. `transcript`: the receipt named a file other than the session's own (held as no-yes). */
+export declare function heldLines(name: string, why: 'no-yes' | 'host' | 'transcript', host: string): [string, string];
+export interface CliAddResult {
+    exit: 0 | 1;
+    lines: string[];
+    /** For `skill_saved` telemetry, sent by cli-skills.ts (this module loads no telemetry). */
+    saved?: {
+        from: 'asked' | 'repeated' | 'repaired';
+        scope: 'personal';
+    };
+    held?: 'no-yes' | 'host';
+    /** Phase 2: the save was moment 5's split, for `skill_changed{split}`. */
+    changed?: 'split';
+}
+/**
+ * 4.9 CLI half, minus printing: what `trail skills add` prints and its exit code. cli-skills.ts only prints.
+ * `_cwd`, the folder the CLI runs in, is not read (D93): the checkout is the run's.
+ */
+export declare function cliAdd(name: string, runId: string, env?: NodeJS.ProcessEnv, now?: Date, _cwd?: string): CliAddResult;
+//# sourceMappingURL=save-gate.d.ts.map

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

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

package/dist/skills/save-gate.js

@@ -0,0 +1,354 @@
+/**
+ * The save gate (design 3.3 step 3, 4.9): the trust boundary of learned
+ * skills. An agent can never keep a skill without the person's typed yes.
+ *
+ * Two halves decide the same way (`verifySave`). PreToolUse sees the agent's
+ * `trail skills add`, denies it or writes a receipt and lets it run. The CLI
+ * (`trail skills add`, `cliAdd`) never trusts that receipt: it re-decides
+ * from the transcript under the session lock, and anything that doesn't
+ * match (no receipt, a used or stale one, one the transcript doesn't back,
+ * a different verdict) is held for the person to keep in their own
+ * terminal, never saved. A held item never reaches the agent.
+ *
+ * Nothing here loads the CLI, the graph, ask, the cloud or telemetry: the
+ * CLI half returns what was saved for `cli-skills.ts` to report.
+ */
+import { createHash } from 'node:crypto';
+import { closeSync, fstatSync, openSync, readSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { CLAUDE_DIALECT, dialectFor } from '../trace/dialect.js';
+import { skillsGate, withSkillSession } from '../trace/skill-session.js';
+import { readRunSheet } from '../trace/runs.js';
+import { tamperOf } from '../trace/tamper.js';
+import { runCheckout } from './run-checkout.js';
+import { trailHome } from '../notes/trail-home.js';
+import { flatLine } from '../notes/flatten.js';
+import { localDate, skillsOn } from './settings.js';
+import { askedWords, monthDay, goodName } from './compile-words.js';
+import { compileRun, refusalWords } from './compile.js';
+import { dropHeld, saveHeld, savePersonal } from './store.js';
+import { findReceipt, markReceiptUsed, receiptTranscriptOk, receiptTranscriptRead, typedLineStillThere, writeReceipt } from './receipts.js';
+import { parseSkillsAdd, SKILLS_ADD_RE, SKILLS_LESSON_RE, SKILLS_UPDATE_RE } from './save-parse.js';
+import { DENY, isSplitOffer, tamperDeny, verifySave } from './save-verify.js';
+import { heldRunId, nameTaken, readSkillsStateSafe } from './save-store.js';
+import { hookError } from '../claude/skills-hook-util.js';
+import { codexSandboxRefusal } from './codex-sandbox.js';
+import { stepLearnings } from './follow-learnings.js';
+export { parseSkillsAdd, parseSkillsLesson, SAVE_GATE_RE, SKILLS_ADD_RE, SKILLS_LESSON_RE } from './save-parse.js';
+export { DENY, verifySave } from './save-verify.js';
+/** 3.3 step 3, after the gate: a deny, or null after writing the receipt (live or held). */
+export function checkSkillsAdd(input, ctx, st, fold) {
+    const command = input?.tool_input?.command;
+    if (typeof command !== 'string' || !SKILLS_ADD_RE.test(command))
+        return null;
+    let v;
+    try {
+        v = verifySave(parseSkillsAdd(command), ctx, st, fold, ctx.env);
+    }
+    catch (e) {
+        // A store that can't be read safely (a planted link, a busy lock) refuses, never lets the add through.
+        return { permissionDecision: 'deny', reason: notSaved(e) };
+    }
+    if (v.deny)
+        return { permissionDecision: 'deny', reason: v.deny };
+    const r = {
+        v: 1, session: ctx.sessionId, transcriptPath: ctx.transcriptPath ?? '', toolUseId: typeof input?.tool_use_id === 'string' ? input.tool_use_id : '',
+        runId: parseSkillsAdd(command).runId, name: v.compiled.name, at: ctx.now.toISOString(), host: ctx.host, tier: ctx.tier,
+        consent: v.consent, offerId: v.offerId, typed: v.typed, typedYes: v.consent === 'offer-yes', typedSave: v.consent === 'asked',
+        asked: v.consent === 'asked' ? st.saveRequest?.scope ?? null : null, stepsTotal: v.stepsTotal, stepsVerified: v.stepsVerified,
+        verdict: v.verdict, ...(v.heldWhy ? { heldWhy: v.heldWhy } : {}), checkout: v.checkout ?? '', usedAt: null,
+    };
+    writeReceipt(r, ctx.env);
+    return null;
+}
+/** 3.3 step 3 from the gate's ctx on: the subagent and no-person denies, then the locked check. */
+export function saveGateFor(input, ctx) {
+    if (ctx.subagent)
+        return { permissionDecision: 'deny', reason: DENY.subagent };
+    if (!ctx.fold)
+        return { permissionDecision: 'deny', reason: DENY.noPerson };
+    const r = withSkillSession(ctx, { catchUp: true, waitMs: 300 }, (st, fold) => checkSkillsAdd(input, ctx, st, fold));
+    return r === undefined ? { permissionDecision: 'deny', reason: DENY.busy } : r;
+}
+/** 3.3 step 3 whole, for `preBashSkills`: the gate, then `saveGateFor`. Skills off or no session: null (the CLI holds). Throws: null. */
+export function saveGate(input, dir, env = process.env, now) {
+    try {
+        const g = skillsGate(input, dir, env, now);
+        return g.ok ? saveGateFor(input, g.ctx) : null;
+    }
+    catch (e) {
+        // 0 rule 5: the add runs, and the CLI holds it (no receipt); one line in hook-errors.log.
+        hookError('pre-bash', e, env);
+        return null;
+    }
+}
+/**
+ * 1b (3.3 step 2): the save gate for either save, `skills add` (this file) or `skills lesson` (lesson-gate.ts, loaded
+ * only for a lesson command); phase 2's `skills update` (update-gate.ts, loaded only for an update command). b7's `preBashSkills` calls this for a command matching SAVE_GATE_RE.
+ */
+export async function saveOrLessonGate(input, dir, env = process.env, now) {
+    const cmd = typeof input?.tool_input?.command === 'string' ? input.tool_input.command : '';
+    // Phase 2 (4.11): an update, loaded only for an update command. One that also adds or keeps a lesson is denied there.
+    if (SKILLS_UPDATE_RE.test(cmd)) {
+        const { updateGate } = await import('./update-gate.js');
+        return updateGate(input, dir, env, now);
+    }
+    if (SKILLS_LESSON_RE.test(cmd) && !SKILLS_ADD_RE.test(cmd)) {
+        const { lessonGate } = await import('./lesson-gate.js');
+        return lessonGate(input, dir, env, now);
+    }
+    return saveGate(input, dir, env, now);
+}
+/**
+ * The GateCtx the CLI half rebuilds from a receipt (session, transcript, host, tier), with fold and learn as the
+ * receipt's tier allows. D93: its checkout and repo key are the run's (the sheet's checkout, else the receipt's,
+ * when it is still a checkout of the run's repo), never the CLI's own folder: a session that started above the repo
+ * runs `trail skills add` up there. verifySave still checks the run is this session's.
+ */
+export function ctxFromReceipt(r, sheet, env = process.env, now = new Date()) {
+    const a = r.tier === 'A';
+    const checkout = runCheckout(sheet, env, r.checkout);
+    return {
+        sessionId: r.session, sessionHash: createHash('sha256').update(r.session).digest('hex').slice(0, 12), host: r.host, tier: r.tier,
+        entry: 'interactive', permissionMode: null, subagent: false, fold: true, learn: a, learnOff: a ? null : 'host', dir: checkout,
+        checkout, repoKey: sheet.repoKey, transcriptPath: r.transcriptPath || null, env, now,
+    };
+}
+const TAIL_BYTES = 4 * 1024 * 1024;
+/** The whole lines in the transcript's last 4 MB, newest last, as parsed objects ([] when unreadable). */
+export function tailEntries(tx) {
+    let fd;
+    try {
+        fd = openSync(tx, 'r');
+    }
+    catch {
+        return [];
+    }
+    try {
+        const size = fstatSync(fd).size;
+        const from = Math.max(0, size - TAIL_BYTES);
+        const buf = Buffer.alloc(size - from);
+        const n = readSync(fd, buf, 0, buf.length, from);
+        let text = buf.subarray(0, n).toString('utf8');
+        if (from > 0)
+            text = text.slice(text.indexOf('\n') + 1);
+        return text.split('\n').flatMap((l) => {
+            try {
+                const v = JSON.parse(l);
+                return v && typeof v === 'object' && !Array.isArray(v) ? [v] : [];
+            }
+            catch {
+                return [];
+            }
+        });
+    }
+    catch {
+        return [];
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/**
+ * The main session's tool calls in the transcript's last 4 MB, oldest first, as the host's dialect reads them (4.16):
+ * Claude's tool_use blocks (subagent lines left out), Codex's function calls.
+ */
+export function tailCalls(tx, dialect, env) {
+    const memo = dialect.tailMemo?.(tx, env) ?? {};
+    return tailEntries(tx).flatMap((e) => dialect.lineEvents(e, memo, undefined, env).filter((ev) => ev.kind === 'tool_call'));
+}
+/** The command a Bash call ran, or null for any other tool. */
+export const bashCommand = (c) => {
+    const i = c.input;
+    return c.name === 'Bash' && typeof i?.command === 'string' ? i.command : null;
+};
+/** CLI step 3: the transcript shows the main session's agent running exactly this add, with the receipt's tool_use id. */
+function addInTranscript(r, cmd, calls) {
+    if (!r.toolUseId)
+        return false;
+    return calls.some((c) => {
+        const raw = c.id === r.toolUseId ? bashCommand(c) : null;
+        const a = raw === null ? null : parseSkillsAdd(raw);
+        return a !== null && !a.flags.length && a.name === cmd.name && a.runId === cmd.runId;
+    });
+}
+/** A write to Trail's files or the transcript among the tail's tool calls, whatever the session's cursor says. */
+export function tamperInTail(calls, tx, env) {
+    const ctx = { trailHome: trailHome(env), transcriptPath: tx, home: env.HOME };
+    for (const c of calls) {
+        const hit = tamperOf(String(c.name ?? ''), c.input, bashCommand(c), { ...ctx, folder: c.cwd ?? null });
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+const HOSTS = { claude: 'Claude Code', cursor: 'Cursor', copilot: 'GitHub Copilot', codex: 'Codex', gemini: 'Gemini CLI' };
+const steps = (n) => `${n} step${n === 1 ? '' : 's'}`;
+/** `at HH:MM today` (local, the run's end) or `on <Mon D>`. */
+function whenRan(endedAt, now) {
+    const d = new Date(endedAt);
+    if (Number.isNaN(d.getTime()))
+        return 'earlier';
+    if (localDate(d) !== localDate(now))
+        return `on ${monthDay(endedAt)}`;
+    return `at ${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')} today`;
+}
+/** 4.9 CLI step 5's two lines. */
+export function savedLines(c, n, endedAt, asked, now) {
+    const name = flatLine(c.name, 60);
+    const every = c.meta.applies === 'every repo';
+    const where = every ? 'just for you, in every repo' : 'just for you in this repo';
+    const first = flatLine((c.meta.asks ?? '').split(',')[0]?.trim() ?? '', 80);
+    // fix-lab5: "you ask for integration tests", never "you ask to integration tests".
+    const ask = first ? askedWords([first]) : 'to do this job';
+    const when = whenRan(endedAt, now);
+    // D118 c: steps and a check that is not itself a step are named apart ("1 step and its check", never "2 steps").
+    const apart = !!c.check && !c.checkIsStep && n >= 1;
+    const count = apart ? `${steps(n - 1)} and its check` : steps(n);
+    const later = asked === 'repo' ? ' Saving it for the whole repo comes later, so for now it\'s just yours.'
+        : asked === 'team' ? ' Saving it for the team comes later, so for now it\'s just yours.' : '';
+    // Part 7: steps that follow the person's learnings rather than the run, said in the same one line.
+    const follow = c.followed ? ` ${flatLine(c.followed, 400)}` : '';
+    return [
+        `✓ saved ${name}, ${where} · ${count}, each one ran here ${when}${follow ? ` ·${follow}` : ''}`,
+        `Tell the person what Trail kept: Saved ${name}, ${where}: ${count}, each one ran here ${when}.${follow} Next time you ask ${ask}, I start from them.${later} See them: trail skills show ${name} · undo: trail forget ${name}`,
+    ];
+}
+/** Why a receipt that names a file other than the session's own transcript is held (g7, D74), in the host's name (c7). */
+const transcriptWhy = (host) => `Trail couldn't find this conversation where ${HOSTS[host] ?? 'your agent'} keeps it, so it can't check that you said yes`;
+/** 4.9 CLI step 6's two lines. `transcript`: the receipt named a file other than the session's own (held as no-yes). */
+export function heldLines(name, why, host) {
+    const n = flatLine(name, 60);
+    const because = why === 'host' ? `it came from ${HOSTS[host] ?? 'another tool'}, where Trail can't check which steps ran`
+        : why === 'transcript' ? transcriptWhy(host) : "you didn't say yes to keeping it";
+    return [`· not kept: ${because}`, `Tell the person why Trail didn't keep it: I didn't keep ${n} as a skill, because ${because}. If you want it, run this in your own terminal: trail skills keep ${n}`];
+}
+const fail = (line) => ({ exit: 1, lines: [line] });
+/** g4's words for a store another trail command holds (`underStoreLock`). */
+const STORE_BUSY = 'trail: the skill store is busy (another trail command is changing it). Try again.';
+/** A store error (busy, a planted link) as the refusal line: nothing was saved. */
+function notSaved(e) {
+    const msg = flatLine(e instanceof Error ? e.message : String(e), 200).replace(/^trail:\s*/, '');
+    return `trail · not saved: ${msg || 'the skill store could not be written'}`;
+}
+/** No receipt the transcript backs: compile the run as an asked save and hold it for the person. */
+function holdUnbacked(cmd, env, now, why = 'no-yes') {
+    const sheet = readRunSheet(cmd.runId, env);
+    if (!goodName(cmd.name))
+        return fail(DENY.name);
+    const keptAs = Object.values(readSkillsStateSafe(env)).find((s) => s.runId === cmd.runId && s.status !== 'retired');
+    if (keptAs)
+        return fail(`trail · not saved: that run is already kept as the skill ${flatLine(keptAs.name, 60)}.`);
+    // D93: the run's own checkout, never the folder the CLI runs in.
+    const root = runCheckout(sheet, env);
+    const scope = { repoKeys: [sheet.repoKey], checkout: root, env };
+    const where = nameTaken(cmd.name, scope);
+    if (where !== null && where !== 'held')
+        return fail(`trail · not saved: the name ${cmd.name} is taken. Use another: trail skills add <other> --run ${flatLine(cmd.runId, 40)}`);
+    const c = compileRun(sheet, {
+        repoRoot: root, home: env.HOME || homedir(), platform: process.platform, now,
+        readSheet: (id) => readRunSheet(id, env), name: cmd.name, moment: 'asked', applies: sheet.repoKey, taken: (n) => n !== cmd.name && nameTaken(n, scope) !== null,
+        learnings: stepLearnings({ repoKeys: [sheet.repoKey], checkout: root, env }),
+    });
+    if (!c.ok)
+        return fail(`trail · not saved: ${refusalWords(c.reason, c.detail)}.`);
+    try {
+        // D93: held by the session whose run it is (no receipt says more), so that session's own starts don't show it.
+        saveHeld(c.skill, 'no-yes', { host: sheet.host, job: sheet.job, repoKey: sheet.repoKey, session: sheet.session }, env, now);
+    }
+    catch (e) {
+        return fail(notSaved(e));
+    }
+    return { exit: 0, lines: heldLines(c.skill.name, why, sheet.host), held: 'no-yes' };
+}
+const sameTyped = (a, b) => (a === null ? b === null : b !== null && a.offset === b.offset && a.lineSha === b.lineSha);
+/**
+ * 4.9 CLI half, minus printing: what `trail skills add` prints and its exit code. cli-skills.ts only prints.
+ * `_cwd`, the folder the CLI runs in, is not read (D93): the checkout is the run's.
+ */
+export function cliAdd(name, runId, env = process.env, now = new Date(), _cwd = process.cwd()) {
+    if (!skillsOn(env))
+        return fail('Skills are off. Turn them on with: trail skills on');
+    const sheet = readRunSheet(runId, env);
+    if (!sheet)
+        return fail(`no run called ${flatLine(runId, 40)} (runs are kept 7 days)`);
+    const cmd = { name, runId, flags: [] };
+    const found = findReceipt(runId, name, now, env);
+    // 4.17, R21: Codex's sandbox may refuse ~/.trail. Nothing changes and the receipt stays unused for the person's run.
+    const sandboxed = found ? codexSandboxRefusal(found.host, `trail skills add ${name} --run ${runId}`, env) : null;
+    if (sandboxed)
+        return fail(sandboxed);
+    // The receipt is read only when it names the session's own transcript, where the host keeps it (D74), and that file
+    // is the one the hooks read for the session (its cursor's inode): never a copy at a path the agent picked.
+    const r = found && receiptTranscriptOk(found, env) && receiptTranscriptRead(found, env) ? found : null;
+    if (found && !r) {
+        const held = holdUnbacked(cmd, env, now, 'transcript');
+        markReceiptUsed(found, now, env);
+        return held;
+    }
+    const calls = r ? tailCalls(r.transcriptPath, dialectFor(r.host) ?? CLAUDE_DIALECT, env) : [];
+    if (!r || !addInTranscript(r, cmd, calls))
+        return holdUnbacked(cmd, env, now);
+    const tampered = tamperInTail(calls, r.transcriptPath, env);
+    if (tampered) {
+        markReceiptUsed(r, now, env);
+        return fail(tamperDeny(tampered));
+    }
+    const ctx = ctxFromReceipt(r, sheet, env, now);
+    let out;
+    try {
+        out = withSkillSession(ctx, { catchUp: true, waitMs: 1000 }, (st, fold) => {
+            const v = verifySave(cmd, ctx, st, fold, env);
+            if (v.deny)
+                return { deny: v.deny };
+            const backed = st.host === r.host && st.tier === r.tier && v.verdict === r.verdict && v.consent === r.consent && sameTyped(v.typed, r.typed)
+                && (r.typed === null || typedLineStillThere(r.transcriptPath, r.typed));
+            if (!backed || v.verdict !== 'live')
+                return { held: v, why: backed && v.heldWhy ? v.heldWhy : 'no-yes' };
+            // Live: the consent is spent with the save, under the same lock. A save that throws (a busy state, a
+            // planted link) is undone by the store, and the session state is put back as it was, consent unspent.
+            // R14: a yes to a moment-3 offer saves from 'repaired' (skill_saved{from:'repaired'}); any other offer's from 'repeated'.
+            const from = v.consent === 'asked' ? 'asked' : st.pendingOffer?.moment === 'repaired' ? 'repaired' : 'repeated';
+            const split = v.consent === 'offer-yes' && isSplitOffer(st.pendingOffer);
+            if (v.consent === 'offer-yes')
+                st.pendingOffer = null;
+            else
+                st.saveRequest = null;
+            if (heldRunId(name, env) === runId) {
+                // D65, D70: the held copy of this run goes first. A store too busy to drop it refuses the save, so the
+                // held copy never stays beside the saved skill; the throw puts the consent back for a retry.
+                dropHeld(name, env);
+                if (heldRunId(name, env) === runId)
+                    throw new Error(STORE_BUSY);
+            }
+            savePersonal(v.compiled, { from, runId, consent: v.consent, stepsVerified: v.stepsVerified, env, now });
+            return { live: v, from, split };
+        });
+    }
+    catch (e) {
+        return fail(notSaved(e));
+    }
+    if (out === undefined)
+        return fail(DENY.busy);
+    if ('deny' in out) {
+        markReceiptUsed(r, now, env);
+        return fail(out.deny);
+    }
+    if ('held' in out) {
+        try {
+            saveHeld(out.held.compiled, out.why, { host: r.host, job: sheet.job, repoKey: sheet.repoKey, session: ctx.sessionHash }, env, now);
+        }
+        catch (e) {
+            return fail(notSaved(e));
+        }
+        markReceiptUsed(r, now, env);
+        return { exit: 0, lines: heldLines(out.held.compiled.name, out.why, r.host), held: out.why };
+    }
+    markReceiptUsed(r, now, env);
+    const v = out.live;
+    return {
+        exit: 0, lines: savedLines(v.compiled, v.stepsVerified, sheet.endedAt, r.asked, now),
+        saved: { from: out.from, scope: 'personal' }, ...(out.split ? { changed: 'split' } : {}),
+    };
+}
+//# sourceMappingURL=save-gate.js.map

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

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