@nanonets/graft 0.24.1 → 0.25.0

package/dist/skills/cli-skills-report.d.ts

@@ -0,0 +1,86 @@
+/**
+ * What `trail skills` prints (design 2.10): each skill with its scope in
+ * words, status, uses and last good use; held items with how to keep them;
+ * the jobs Trail is counting; the offers line (and the governor line, once);
+ * the skills line. `--json` is the same facts as one object. Every line names
+ * the command that changes it. Reading only, except the governor line, which
+ * records that it was said (offers.ts).
+ */
+import type { JobClass } from '../trace/types.js';
+import type { SkillStatus } from './types.js';
+import { type HeldItem } from './store.js';
+import { type ErrorRow, type GuardrailRow, type SkillExtras } from './cli-skills-report-1b.js';
+export interface SkillRow {
+    name: string;
+    id: string;
+    scope: 'personal';
+    applies: string | null;
+    status: SkillStatus;
+    version: string | null;
+    uses: number;
+    checkedUses: number;
+    lastWorked: string | null;
+    addedAt: string | null;
+    source: {
+        commands: number;
+        failed: number;
+    } | null;
+    statusWhy: string | null;
+    off: boolean;
+    /** Refused at recall now (a step edited by hand that the risk rules refuse): why, in words. Not used while set. */
+    refused: string | null;
+}
+/** A skill's row with 1b's facts (2.12). */
+export type SkillRow1b = SkillRow & SkillExtras;
+export interface HeldRow {
+    name: string;
+    why: HeldItem['why'];
+    host: string;
+    repo: string;
+    at: string;
+    shownAt: string | null;
+}
+export interface WatchRow {
+    job: JobClass;
+    repo: string;
+    sessionDays: number;
+    need: number;
+}
+export interface SkillsReport {
+    skills: SkillRow1b[];
+    held: HeldRow[];
+    watching: WatchRow[];
+    offers: {
+        on: boolean;
+        offSince: string | null;
+        offIn: string[];
+        perSession: 1;
+        perWeek: 3;
+        thisWeek: number;
+        kept: number;
+    };
+    governor: string | null;
+    settings: {
+        skills: 'on' | 'off';
+        onSince: string | null;
+    };
+    /** 1b (2.12): the guardrails kept, the catalog errors in this repo over 30 days, every lesson that holds here. */
+    guardrails: GuardrailRow[];
+    errorsHere: ErrorRow[];
+    lessons: number;
+    /** Phase 2 (4.14): the weekly value line for this repo, on top; null when there is none. */
+    value?: string | null;
+}
+/** `Oct 29` for an ISO time or a local `YYYY-MM-DD` day (read as that local day, not UTC midnight). */
+export declare function dayWords(d: string): string;
+/** Where a skill applies, in words: `yours, in webshop` or `yours, in every repo`. */
+export declare function whereWords(applies: string | null): string;
+/** The status part of a skill's line (2.10). */
+export declare function statusWords(r: SkillRow): string;
+/** One held item's line. */
+export declare function heldWords(h: Pick<HeldRow, 'name' | 'why' | 'host'>): string;
+/** The facts `trail skills` prints, `cwd` the folder it runs in. Says the governor line at most once per time it turns on (records it). */
+export declare function skillsReport(env: NodeJS.ProcessEnv, now: Date, cwd?: string): SkillsReport;
+/** The report as the lines 2.10 shows. */
+export declare function reportLines(r: SkillsReport): string[];
+//# sourceMappingURL=cli-skills-report.d.ts.map

package/dist/skills/cli-skills-report.d.ts.map

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

package/dist/skills/cli-skills-report.js

@@ -0,0 +1,121 @@
+import { OFFER_FAMILIES } from '../trace/jobs.js';
+import { watching } from '../trace/pool.js';
+import { flatLine } from '../notes/flatten.js';
+import { monthDay, repoName } from './compile-words.js';
+import { foldOffers, governorLine, readOffers } from './offers.js';
+import { readSettings } from './settings.js';
+import { readSkillsState } from './state.js';
+import { jobCovered, listAllPersonal, listHeld, readSkill } from './store.js';
+import { refusedAtRecall } from './recall.js';
+import { errorLine, errorRows, extrasWords, guardrailLines, guardrailRows, lessonsLine, lessonTotal, placeOf, skillExtras, valueHere, } from './cli-skills-report-1b.js';
+const WEEK_MS = 7 * 86_400_000;
+const WATCH_MAX = 5;
+const HOSTS = { claude: 'Claude Code', cursor: 'Cursor', copilot: 'GitHub Copilot', codex: 'Codex', gemini: 'Gemini CLI' };
+/** `Oct 29` for an ISO time or a local `YYYY-MM-DD` day (read as that local day, not UTC midnight). */
+export function dayWords(d) {
+    return monthDay(/^\d{4}-\d{2}-\d{2}$/.test(d) ? `${d}T12:00:00` : d);
+}
+const plural = (n, w) => `${n} ${w}${n === 1 ? '' : 's'}`;
+const one = (t, max = 60) => flatLine(t, max);
+/** Where a skill applies, in words: `yours, in webshop` or `yours, in every repo`. */
+export function whereWords(applies) {
+    return !applies || applies.toLowerCase() === 'every repo' ? 'yours, in every repo' : `yours, in ${one(repoName(applies))}`;
+}
+/** The status part of a skill's line (2.10). */
+export function statusWords(r) {
+    const v = r.version ? ` v${one(r.version, 8)}` : '';
+    let s;
+    if (r.refused)
+        s = `needs a fix: ${one(r.refused, 120)} · not used until fixed`;
+    else if (r.status === 'needs-fix')
+        s = `needs a fix: ${one(r.statusWhy ?? 'its steps failed twice', 120)} · not used until fixed`;
+    else if (r.status === 'active')
+        s = `active${v} · used ${r.uses}, checked ${r.checkedUses}${r.lastWorked ? ` · last worked ${dayWords(r.lastWorked)}` : ''}`;
+    else {
+        const from = r.source ? ` from a run of ${plural(r.source.commands, 'command')}, ${r.source.failed ? `${r.source.failed} failed` : 'none failed'}` : '';
+        s = `candidate${v}${r.addedAt ? ` · saved ${dayWords(r.addedAt)}${from}` : ''}`;
+    }
+    return r.off ? `${s} · off: turn it on with trail skills on ${one(r.name)}` : s;
+}
+/** One held item's line. */
+export function heldWords(h) {
+    const why = h.why === 'host' ? `came from ${HOSTS[h.host] ?? 'another tool'}` : 'started without your yes';
+    return `held, not kept: ${one(h.name)} (${why}) · keep it: trail skills keep ${one(h.name)}`;
+}
+function rows(env, now, cwd) {
+    // Each file first: reading a needs-fix skill edited by hand puts its state back (4.8), so the state is read after.
+    const read = listAllPersonal(env).map((ref) => ({ ref, parsed: readSkill(ref) }));
+    const state = readSkillsState(env).skills;
+    const off = new Set(readSettings(env).skillsOff);
+    const place = placeOf(cwd, env);
+    return read.map(({ ref, parsed }) => {
+        const st = state[ref.id];
+        return {
+            name: ref.name, id: ref.id, scope: 'personal', applies: ref.applies, status: (st?.status ?? 'candidate'),
+            version: parsed?.meta.version ?? null, uses: st?.uses ?? 0, checkedUses: st?.checkedUses ?? 0, lastWorked: st?.lastWorked ?? null,
+            addedAt: st?.addedAt ?? null, source: st?.source ? { commands: st.source.commands, failed: st.source.failed } : null,
+            statusWhy: st?.statusWhy ?? null, off: off.has(ref.name), refused: parsed ? refusedAtRecall(parsed) : null,
+            ...skillExtras(ref, parsed, st, place, env, now),
+        };
+    }).filter((r) => r.status !== 'retired');
+}
+/** The facts `trail skills` prints, `cwd` the folder it runs in. Says the governor line at most once per time it turns on (records it). */
+export function skillsReport(env, now, cwd) {
+    const s = readSettings(env);
+    const records = foldOffers(readOffers(env)).filter((r) => r.event === 'shown' && now.getTime() - Date.parse(r.at) < WEEK_MS && Date.parse(r.at) <= now.getTime());
+    const watch = watching(env, now)
+        .filter((w) => OFFER_FAMILIES[w.job] && !jobCovered(w.job, { repoKeys: [w.repoKey], checkout: '', env }))
+        .sort((a, b) => b.sessionDays - a.sessionDays || a.repoKey.localeCompare(b.repoKey) || a.job.localeCompare(b.job))
+        .slice(0, WATCH_MAX)
+        .map((w) => ({ job: w.job, repo: w.repoKey, sessionDays: w.sessionDays, need: w.need }));
+    const skills = rows(env, now, cwd);
+    const place = placeOf(cwd, env);
+    return {
+        skills,
+        held: listHeld(env, now).map((h) => ({ name: h.name, why: h.why, host: h.host, repo: h.repoKey, at: h.at, shownAt: h.shownAt })),
+        watching: watch,
+        offers: {
+            on: s.offers === 'on', offSince: s.offers === 'off' ? s.offersOffAt : null, offIn: s.offRepos.slice(), perSession: 1, perWeek: 3,
+            thisWeek: records.length, kept: records.filter((r) => r.answer === 'yes').length,
+        },
+        governor: s.offers === 'on' ? governorLine(env, now) : null,
+        settings: { skills: s.skills, onSince: s.onSince },
+        guardrails: guardrailRows(place, env, s.skills === 'on'),
+        errorsHere: errorRows(place, env, now),
+        lessons: lessonTotal(skills.reduce((n, k) => n + k.lessons, 0), place, env),
+        value: valueHere(place, env, now),
+    };
+}
+/** The report as the lines 2.10 shows. */
+export function reportLines(r) {
+    const out = [];
+    if (r.value)
+        out.push(r.value);
+    if (!r.skills.length)
+        out.push('no skills yet');
+    const width = Math.max(0, ...r.skills.map((s) => one(s.name).length)) + 3;
+    for (const s of r.skills)
+        out.push(`${one(s.name).padEnd(width)}${whereWords(s.applies)} · ${statusWords(s)}${extrasWords(s)}`);
+    for (const h of r.held)
+        out.push(heldWords(h));
+    out.push(...guardrailLines(r.guardrails ?? []));
+    for (const l of [errorLine(r.errorsHere ?? []), lessonsLine(r.lessons ?? 0)])
+        if (l)
+            out.push(l);
+    if (r.watching.length)
+        out.push(`watching: ${r.watching.map((w) => `${w.job} in ${one(repoName(w.repo))}, ${w.sessionDays} of ${w.need} days`).join(' · ')}`);
+    const o = r.offers;
+    if (!o.on)
+        out.push(`offers: off${o.offSince ? ` since ${dayWords(o.offSince)}` : ''} · turn back on: trail skills offers on`);
+    else {
+        const head = o.offIn.length ? `offers: on, off in ${o.offIn.map((k) => one(repoName(k))).join(', ')}` : 'offers: on';
+        const week = o.thisWeek ? `${o.thisWeek} this week, ${o.kept} kept` : 'none this week';
+        out.push(`${head} · at most ${o.perSession} per session, ${o.perWeek} a week · ${week} · stop them: trail skills offers off`);
+        if (r.governor)
+            out.push(r.governor);
+    }
+    const st = r.settings;
+    out.push(st.skills === 'on' ? `skills: on${st.onSince ? ` since ${dayWords(st.onSince)}` : ''} · turn off: trail skills off` : 'skills: off · turn on: trail skills on');
+    return out;
+}
+//# sourceMappingURL=cli-skills-report.js.map

package/dist/skills/cli-skills-report.js.map

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

package/dist/skills/cli-skills.d.ts

@@ -0,0 +1,30 @@
+import { type Command } from 'commander';
+import { type PersonDeps } from './store.js';
+/** Seams for tests; production passes nothing. */
+export interface SkillCliDeps {
+    env?: NodeJS.ProcessEnv;
+    /** The clock: default `trailNow(env)` (TRAIL_TEST_NOW in a test home only). */
+    now?: () => Date;
+    cwd?: () => string;
+    /** Passed to the real `personAtTerminal` (TTYs, the process table), as g4's tests do. */
+    personDeps?: PersonDeps;
+    track?: (event: string, props: Record<string, string>) => void;
+    out?: (line: string) => void;
+    err?: (line: string) => void;
+    exit?: (code: number) => void;
+}
+/** `trail skills on` says this, word for word (1.7). */
+export declare const SKILLS_ON_LINES: readonly ["✓ skills on · Trail now counts jobs you ask for on more than one day: job words and dates only, kept on this machine, nothing uploaded.", "  When one checks out on its 3rd day, it offers once to keep the commands that worked (at most 1 offer per session, 3 a week).", "  See what it counts: trail skills · stop offers: trail skills offers off · all off: trail skills off"];
+export declare const OFFERS_OFF_LINE = "Skill offers are off. Turn them back on: trail skills offers on";
+/** 1b (R59): numbers are init's; `trail keep` keeps them, after the person typed them. */
+export declare const KEEP_NUMBERS_LINE = "trail keep <numbers> keeps items from trail init.";
+/** A person-only command run by an agent (1.7). */
+export declare const personOnly: (command: string) => string;
+/**
+ * A SKILL.md as `show` prints it: anyone can edit the file by hand, so no line of it may read as Trail's own
+ * (`[trail] ...`) or carry terminal escapes. Indentation stays (it's markdown).
+ */
+export declare function shownText(text: string): string;
+/** `trail skills …` and `trail forget <name>` (1.7). */
+export declare function registerSkillCommands(program: Command, deps?: SkillCliDeps): void;
+//# sourceMappingURL=cli-skills.d.ts.map

package/dist/skills/cli-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-skills.d.ts","sourceRoot":"","sources":["../../src/skills/cli-skills.ts"],"names":[],"mappings":"AAaA,OAAO,EAAkC,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AASzE,OAAO,EAAiH,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAW5J,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,yFAAyF;IACzF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IAC/D,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,wDAAwD;AACxD,eAAO,MAAM,eAAe,iYAIlB,CAAC;AACX,eAAO,MAAM,eAAe,oEAAoE,CAAC;AACjG,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,sDAAsD,CAAC;AACrF,mDAAmD;AACnD,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,WAA4E,CAAC;AASvH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAiOD,wDAAwD;AACxD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI,CA4ErF"}

package/dist/skills/cli-skills.js

@@ -0,0 +1,379 @@
+/**
+ * `trail skills` and its subcommands (design 1.7), plus the top-level
+ * `trail forget`. Every command that changes something prints one plain line
+ * and the command that undoes it. `skills on`, `offers on` and `keep` are the
+ * person's: run by an agent (`personAtTerminal` says no), they print who may
+ * run them and exit 1. This is the only module that imports the person-only
+ * setters of settings.ts (a static test pins it).
+ *
+ * `add` is g5's CLI half (`cliAdd`): this file only prints what it returns
+ * and sends `skill_saved`, because the save gate's import closure may not load
+ * telemetry. Telemetry carries closed-set values only, never a name.
+ */
+import { homedir } from 'node:os';
+import { Argument, InvalidArgumentError } from 'commander';
+import { repoPlace } from '../notes/home.js';
+import { flatLine } from '../notes/flatten.js';
+import { track as sendEvent } from '../telemetry/track.js';
+import { findPriorSheet, readRunSheet } from '../trace/runs.js';
+import { compileRun, refusalWords } from './compile.js';
+import { draftText, repoName } from './compile-words.js';
+import { cliAdd } from './save-gate.js';
+import { readSettings, setOffers, setSkillOff, setSkills, trailNow } from './settings.js';
+import { forgetSkill, keepHeld, listAllPersonal, listHeld, nameTaken, personAtTerminal, restoreSkill } from './store.js';
+import { readCapped } from './store-fs.js';
+import { heldWords, reportLines, skillsReport, statusWords, whereWords } from './cli-skills-report.js';
+import { extrasWords, fidelityLine } from './cli-skills-report-1b.js';
+import { lessonLine, readLessons } from './lessons.js';
+import { runCheckout } from './run-checkout.js';
+import { forgetLearning, initDraftCommand, lessonCommand } from './cli-skills-1b.js';
+import { noteAgentForget } from './forget-notice.js';
+import { draftFoldText, liftRestoreVersion, restoreVersionCommand, updateCommand, versionsLine } from './cli-skills-2.js';
+import { stepLearnings } from './follow-learnings.js';
+/** `trail skills on` says this, word for word (1.7). */
+export const SKILLS_ON_LINES = [
+    '✓ skills on · Trail now counts jobs you ask for on more than one day: job words and dates only, kept on this machine, nothing uploaded.',
+    '  When one checks out on its 3rd day, it offers once to keep the commands that worked (at most 1 offer per session, 3 a week).',
+    '  See what it counts: trail skills · stop offers: trail skills offers off · all off: trail skills off',
+];
+export const OFFERS_OFF_LINE = 'Skill offers are off. Turn them back on: trail skills offers on';
+/** 1b (R59): numbers are init's; `trail keep` keeps them, after the person typed them. */
+export const KEEP_NUMBERS_LINE = 'trail keep <numbers> keeps items from trail init.';
+/** A person-only command run by an agent (1.7). */
+export const personOnly = (command) => `Only the person can run this, in their own terminal: trail ${command}`;
+const one = (t, max = 60) => flatLine(t, max);
+/** Every line break a terminal or an agent might honour. */
+const BREAKS = /\r\n|[\n\r\u000b\u000c\u0085\u2028\u2029]/;
+/** Controls but tab (ESC, BEL, C1) and characters nobody sees: they can rewrite a terminal or hide a marker. */
+const UNSEEN = /[\u0000-\u0008\u000e-\u001f\u007f-\u009f]|[\p{Cf}\ufe00-\ufe0f]/gu;
+const MARKER = /^(\s*)(?:\[(?:trail|graft|trail-code)\]\s*)+/i;
+/**
+ * A SKILL.md as `show` prints it: anyone can edit the file by hand, so no line of it may read as Trail's own
+ * (`[trail] ...`) or carry terminal escapes. Indentation stays (it's markdown).
+ */
+export function shownText(text) {
+    return text.split(BREAKS).map((l) => l.replace(UNSEEN, '').replace(MARKER, '$1')).join('\n').trimEnd();
+}
+const unknownSkill = (name) => `✗ no skill called ${one(name)} · trail skills lists them`;
+const errText = (e) => `✗ ${one(e instanceof Error ? e.message : String(e), 200).replace(/^trail:\s*/, '')}`;
+function io(d) {
+    const env = d.env ?? process.env;
+    return {
+        env,
+        now: d.now ?? (() => trailNow(env)),
+        cwd: d.cwd ?? (() => process.cwd()),
+        person: () => personAtTerminal(env, d.personDeps ?? {}),
+        track: d.track ?? ((e, p) => { sendEvent(e, p); }),
+        out: d.out ?? ((l) => console.log(l)),
+        err: d.err ?? ((l) => console.error(l)),
+        exit: d.exit ?? ((c) => { process.exitCode = c; }),
+    };
+}
+/** Runs a command body; a thrown store or settings error (busy, a planted link) prints and exits 1. */
+const guarded = (x, fn) => () => {
+    try {
+        fn();
+    }
+    catch (e) {
+        x.err(errText(e));
+        x.exit(1);
+    }
+};
+const fail = (x, line) => {
+    x.err(line);
+    x.exit(1);
+};
+/** Is the person at the keyboard? Otherwise print who may run `command` and exit 1. */
+function personOr(x, command) {
+    if (x.person().ok)
+        return true;
+    fail(x, personOnly(command));
+    return false;
+}
+/** A personal skill by name (any repo), or a name the person turned off. */
+const knownSkill = (name, env) => listAllPersonal(env).some((r) => r.name === name) || readSettings(env).skillsOff.includes(name);
+/** Prints a 1b command's lines (to stdout on 0, stderr on 1) and its exit code. */
+function said(x, r) {
+    for (const l of r.lines)
+        (r.code === 0 ? x.out : x.err)(l);
+    if (r.code !== 0)
+        x.exit(r.code);
+}
+function forget(x, name) {
+    // 1b: a lesson or learning id, or a kept guardrail's name, before a skill's name (1.7).
+    const learning = forgetLearning(name, x.cwd(), x.env);
+    if (learning) {
+        if (learning.code === 0 && learning.dropped)
+            agentForgot(x, learning.dropped);
+        return said(x, learning);
+    }
+    const r = forgetSkill(name, x.env, x.now());
+    if (!r.ok)
+        return fail(x, unknownSkill(name));
+    agentForgot(x, { what: 'skill', name, back: `trail skills restore ${one(name)}` });
+    x.out(`✓ ${one(name)} forgotten · bring it back: trail skills restore ${one(name)}`);
+}
+/** D117 (2): an agent's forget (CLAUDECODE, or a claude or pty-wrapper ancestor, as R17) is told to the person at the next Stop. */
+function agentForgot(x, d) {
+    try {
+        if (x.env.CLAUDECODE === undefined && !x.person().claudeAncestor)
+            return;
+    }
+    catch { /* can't tell: note it, telling the person is the safe side */ }
+    noteAgentForget(d, x.env, x.now());
+}
+function list(x, json) {
+    const r = skillsReport(x.env, x.now(), x.cwd());
+    if (json)
+        x.out(JSON.stringify(r, null, 2));
+    else
+        for (const l of reportLines(r))
+            x.out(l);
+    // Phase 2 (P27): whether the value line went out, and how; no number from it.
+    if (r.value)
+        x.track('skill_value', { channel: 'list' });
+}
+function show(x, name) {
+    const ref = listAllPersonal(x.env).find((r) => r.name === name);
+    if (ref) {
+        const text = readCapped(ref.file);
+        if (text === null)
+            return fail(x, unknownSkill(name));
+        const row = skillsReportRow(x, ref.name);
+        x.out(shownText(text));
+        x.out('');
+        x.out(row ? `· ${whereWords(row.applies)} · ${statusWords(row)}${extrasWords(row)}` : `· ${whereWords(ref.applies)}`);
+        // Phase 2 (3.6): how its last uses followed it, when the ledger has the counts.
+        const fid = fidelityLine(ref.id, x.env);
+        if (fid)
+            x.out(`· ${fid}`);
+        // Phase 2 (3.6): the versions it keeps, and a change waiting beside a hand-edited file.
+        const versions = versionsLine(ref, x.env);
+        if (versions)
+            x.out(`· ${versions}`);
+        // 1b (2.12): every lesson kept with it, oldest first.
+        for (const l of readLessons(ref.dir))
+            x.out(`  ${lessonLine(l)}`);
+        return;
+    }
+    const held = listHeld(x.env, x.now()).find((h) => h.name === name);
+    const text = held ? readCapped(`${held.dir}/SKILL.md`) : null;
+    if (!held || text === null)
+        return fail(x, unknownSkill(name));
+    x.out(shownText(text));
+    x.out('');
+    x.out(`· ${heldWords(held)}`);
+}
+function skillsReportRow(x, name) {
+    return skillsReport(x.env, x.now(), x.cwd()).skills.find((s) => s.name === name) ?? null;
+}
+/** "show me" (2.1): the run compiled as an offer would keep it, printed. Writes nothing. */
+function draft(x, runId, print) {
+    if (!print)
+        return fail(x, `✗ use --print: trail skills draft ${one(runId, 40)} --print`);
+    // 1b: init's pending skill n, compiled again from its source (R24, R37).
+    const init = /^init-(\d{1,2})$/.exec(runId);
+    if (init)
+        return said(x, initDraftCommand(Number(init[1]), x.cwd(), x.env, x.now()));
+    // Phase 2 (4.7): a run whose change to a skill is offered prints that change as a diff.
+    const fold = draftFoldText(runId, x.env);
+    if (fold)
+        return x.out(fold);
+    const sheet = readRunSheet(runId, x.env);
+    if (!sheet)
+        return fail(x, `✗ no run called ${one(runId, 40)} (runs are kept 7 days)`);
+    // D93: the run's own checkout, as an offer compiles it (an older sheet: the folder it is shown in, when that is it).
+    const place = repoPlace(x.cwd(), x.env);
+    const root = runCheckout(sheet, x.env, place.git && place.key === sheet.repoKey ? place.checkout : '');
+    const scope = { repoKeys: [sheet.repoKey], checkout: root, env: x.env };
+    const opts = {
+        repoRoot: root, home: x.env.HOME || homedir(), platform: process.platform,
+        prior: findPriorSheet(sheet, x.env), applies: sheet.repoKey, now: x.now(), readSheet: (id) => readRunSheet(id, x.env),
+        taken: (n) => nameTaken(n, scope) !== null,
+        learnings: stepLearnings({ repoKeys: [sheet.repoKey], checkout: root, env: x.env }),
+    };
+    // An offer keeps a repeated job; a run with no check (an asked save) is shown the way an ask keeps it.
+    let c = compileRun(sheet, { ...opts, moment: 'repeated' });
+    if (!c.ok && (c.reason === 'no-check' || c.reason === 'trivial'))
+        c = compileRun(sheet, { ...opts, moment: 'asked' });
+    if (!c.ok)
+        return fail(x, `✗ Trail can't keep that run as a skill: ${refusalWords(c.reason, c.detail)}`);
+    x.out(draftText(c.skill, sheet));
+}
+/**
+ * 4.9 step 1 for the CLI: `add` takes a name and `--run` only. Commander gives an option a parent knows (`--json` of
+ * `trail skills`, a root option) to that parent wherever it is typed, so add refuses any option a parent got from the
+ * command line, the same way as an unknown one: an error, nothing saved.
+ */
+function onlyRun(cmd) {
+    for (let c = cmd.parent; c; c = c.parent) {
+        for (const o of c.options) {
+            if (c.getOptionValueSource(o.attributeName()) === 'cli')
+                cmd.error(`error: unknown option '${o.long ?? o.flags}'`, { exitCode: 1, code: 'commander.unknownOption' });
+        }
+    }
+}
+function add(x, name, runId) {
+    const r = cliAdd(name, runId, x.env, x.now(), x.cwd());
+    for (const l of r.lines)
+        (r.exit === 0 ? x.out : x.err)(l);
+    if (r.saved)
+        x.track('skill_saved', { from: r.saved.from, scope: r.saved.scope });
+    if (r.changed)
+        x.track('skill_changed', { op: r.changed });
+    if (r.exit !== 0)
+        x.exit(r.exit);
+}
+function keep(x, names) {
+    if (names.every((n) => /^\d+$/.test(n)))
+        return fail(x, KEEP_NUMBERS_LINE);
+    if (names.length !== 1)
+        return fail(x, '✗ keep one skill at a time: trail skills keep <name>');
+    const name = names[0];
+    if (!personOr(x, `skills keep ${one(name)}`))
+        return;
+    const r = keepHeld(name, x.person(), x.env, x.now());
+    if (r.ok) {
+        x.out(`✓ kept ${one(name)} as one of your skills · undo: trail forget ${one(name)}`);
+        x.track('skill_saved', { from: 'asked', scope: 'personal' });
+        return;
+    }
+    if (r.reason === 'not-a-person')
+        return fail(x, personOnly(`skills keep ${one(name)}`));
+    if (r.reason === 'name-taken')
+        return fail(x, `✗ ${one(name)} is already the name of another skill, so this one can't be kept under it`);
+    fail(x, `✗ nothing held called ${one(name)}: a held skill can be kept for 24 hours after Trail shows it · see what's held: trail skills`);
+}
+function restore(x, name) {
+    const r = restoreSkill(name, x.env, x.now());
+    if (r.ok)
+        return x.out(`✓ ${one(name)} is back · forget it again: trail forget ${one(name)}`);
+    if (r.reason === 'name-taken')
+        return fail(x, `✗ the name ${one(name)} is taken now, so the forgotten one can't come back under it`);
+    fail(x, `✗ no forgotten skill called ${one(name)}`);
+}
+function offers(x, state, here) {
+    let key = null;
+    if (here) {
+        const place = repoPlace(x.cwd(), x.env);
+        if (!place.git)
+            return fail(x, '✗ --here needs a repo: run it inside the repo');
+        key = place.key;
+    }
+    const flag = here ? ' --here' : '';
+    const where = key ? ` in ${one(repoName(key))}` : '';
+    if (state === 'on') {
+        if (!personOr(x, `skills offers on${flag}`))
+            return;
+        setOffers(true, key, x.env, x.now());
+        return x.out(`✓ skill offers on${where} · stop them: trail skills offers off${flag}`);
+    }
+    setOffers(false, key, x.env, x.now());
+    x.out(key ? `Skill offers are off${where}. Turn them back on: trail skills offers on --here` : OFFERS_OFF_LINE);
+    x.track('skill_answer', { answer: 'off' });
+}
+function onOff(x, state, name) {
+    if (name === undefined) {
+        if (state === 'on') {
+            if (!personOr(x, 'skills on'))
+                return;
+            setSkills(true, x.env, x.now());
+            for (const l of SKILLS_ON_LINES)
+                x.out(l);
+            return;
+        }
+        setSkills(false, x.env, x.now());
+        return x.out('✓ skills off: Trail stops counting jobs, offering skills and bringing them back · turn on again: trail skills on');
+    }
+    if (state === 'on' && !personOr(x, `skills on ${one(name)}`))
+        return;
+    if (!knownSkill(name, x.env))
+        return fail(x, unknownSkill(name));
+    setSkillOff(name, state === 'off', x.env);
+    x.out(state === 'off'
+        ? `✓ ${one(name)} off: it stops reaching the agent · turn it back on: trail skills on ${one(name)}`
+        : `✓ ${one(name)} on: it reaches the agent again · turn it off: trail skills off ${one(name)}`);
+}
+/** `trail skills …` and `trail forget <name>` (1.7). */
+export function registerSkillCommands(program, deps = {}) {
+    const x = io(deps);
+    // Phase 2: `restore --version <n>` reaches the restore, not the CLI's own --version (cli-skills-2.ts).
+    let restoreAt;
+    const lift = (f) => ((argv, o) => {
+        const l = liftRestoreVersion(argv ?? process.argv);
+        restoreAt = l.version;
+        return f.call(program, l.argv, o);
+    });
+    program.parse = lift(program.parse.bind(program));
+    program.parseAsync = lift(program.parseAsync.bind(program));
+    const skills = program
+        .command('skills')
+        .description("Your skills: the steps that worked, kept on this machine when you say so, brought back when you ask for the same job")
+        .option('--json', 'the same facts as one JSON object')
+        .action((opts) => guarded(x, () => list(x, !!opts.json))());
+    skills.command('show').description('Print a skill (or a held one) and its status').argument('<name>', 'the skill')
+        .action((name) => guarded(x, () => show(x, name))());
+    skills.command('draft').description("Print what keeping a run would save, or init's item n (init-<n>). Saves nothing").argument('<run-id>', 'the run, or init-<n>')
+        .option('--print', 'print it (the only thing draft does)')
+        .action((runId, opts) => guarded(x, () => draft(x, runId, !!opts.print))());
+    skills.command('add').description('Keep a run as a skill, after the person said yes or asked for it (what was typed decides; no flag does)')
+        .argument('<name>', 'the skill name')
+        .requiredOption('--run <run-id>', 'the run to keep', (v, prev) => {
+        if (prev !== undefined)
+            throw new InvalidArgumentError('give --run once.');
+        return v;
+    })
+        .action((name, opts, cmd) => {
+        onlyRun(cmd);
+        guarded(x, () => add(x, name, opts.run))();
+    });
+    skills.command('lesson').description('Keep the lesson Trail offered, after the person typed yes to it (what was typed decides; no flag does)')
+        .argument('[skill]', 'the skill the lesson rides with (none for a lesson about an error)')
+        .requiredOption('--offer <offer-id>', 'the offer the person said yes to', (v, prev) => {
+        if (prev !== undefined)
+            throw new InvalidArgumentError('give --offer once.');
+        return v;
+    })
+        .action((skill, opts, cmd) => {
+        onlyRun(cmd);
+        guarded(x, () => said(x, lessonCommand(skill ?? null, opts.offer, x.env, x.now())))();
+    });
+    skills.command('keep').description("Keep a skill Trail held because nobody said yes. Only you, in your own terminal").argument('<name...>', 'the held skill')
+        .action((names) => guarded(x, () => keep(x, names))());
+    skills.command('forget').description('Forget a skill (trail skills restore brings it back), a lesson or a learning by its id, or a guardrail').argument('<name>', 'the skill, lesson id, learning id or guardrail')
+        .action((name) => guarded(x, () => forget(x, name))());
+    skills.command('restore').description('Bring back the skill you forgot last, or with --version <n> an older version of a skill (only you, in your own terminal)')
+        .argument('<name>', 'the skill')
+        .action((name) => guarded(x, () => {
+        if (restoreAt === undefined)
+            return restore(x, name);
+        const code = restoreVersionCommand(name, restoreAt, x);
+        if (code !== 0)
+            x.exit(code);
+    })());
+    skills.command('update').description('Change a skill the way Trail showed, after the person typed yes to it (what was typed decides; no flag does)')
+        .argument('<name>', 'the skill')
+        .requiredOption('--offer <offer-id>', 'the offer the person said yes to', (v, prev) => {
+        if (prev !== undefined)
+            throw new InvalidArgumentError('give --offer once.');
+        return v;
+    })
+        .action((name, opts, cmd) => {
+        onlyRun(cmd);
+        guarded(x, () => {
+            const code = updateCommand(name, opts, x);
+            if (code !== 0)
+                x.exit(code);
+        })();
+    });
+    skills.command('offers').description('Turn skill offers on or off, everywhere or in this repo (--here). Only you turn them on')
+        .addArgument(new Argument('<state>', 'on or off').choices(['on', 'off'])).option('--here', 'just this repo')
+        .action((state, opts) => guarded(x, () => offers(x, state, !!opts.here))());
+    skills.command('on').description('Turn skills on (only you), or one skill back on').argument('[name]', 'one skill')
+        .action((name) => guarded(x, () => onOff(x, 'on', name))());
+    skills.command('off').description('Turn skills off, or one skill').argument('[name]', 'one skill')
+        .action((name) => guarded(x, () => onOff(x, 'off', name))());
+    program.command('forget', { hidden: true }).description('Forget one of your skills (trail skills restore brings it back), a lesson or a learning by its id, or a guardrail').argument('<name>', 'the skill, lesson id, learning id or guardrail')
+        .action((name) => guarded(x, () => forget(x, name))());
+}
+//# sourceMappingURL=cli-skills.js.map