@nanonets/graft 0.24.0 → 0.25.0

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

@@ -0,0 +1,77 @@
+/**
+ * The file side of the skill store (store.ts, store-held.ts): private
+ * folders that never chmod or write through a link, capped reads, the one
+ * store lock, a skill folder written whole, and the state entry and ledger
+ * line a new personal skill starts with.
+ *
+ * A name reaches here from an agent's command line or a person's, so every
+ * name is checked to be one folder name before it is joined to a path.
+ */
+import { type Stats } from 'node:fs';
+import type { CompiledSkill, SkillFrom, SkillRef, SkillState } from './types.js';
+import { type Locked } from '../util/private-fs.js';
+/** SKILL.md is at most 60 lines; anything this big is not one. */
+export declare const MAX_SKILL_BYTES: number;
+/** How long a person's command waits for the store; a hook's bookkeeping waits less. */
+export declare const PERSON_WAIT_MS = 1000;
+export declare const HOOK_WAIT_MS = 200;
+/** One folder name: no separators, no dot start, no `..`. Wider than NAME_RE so hand-made folders can be named back. */
+export declare const safeName: (name: string) => boolean;
+export declare const lstatOrNull: (p: string) => Stats | null;
+export declare const statOrNull: (p: string) => Stats | null;
+/** A folder of ours: made 0700 when missing, tightened when it is a real folder; a link is left as it is (never chmod through it). */
+export declare function privateDir(dir: string): void;
+/** The file's text when it is a regular file (links followed) of at most 64 KB; null otherwise. */
+export declare function readCapped(file: string): string | null;
+export declare const skillsDir: (env?: NodeJS.ProcessEnv) => string;
+export declare const heldDir: (env?: NodeJS.ProcessEnv) => string;
+export declare const retiredDir: (env?: NodeJS.ProcessEnv) => string;
+/**
+ * Every change to skills/ or held/ runs under one lock (`skills/.store.lock`). Throws when it can't be had in time,
+ * and before anything is written when one of Trail's own folders is a link (own-folder.ts).
+ */
+export declare function underStoreLock<T>(env: NodeJS.ProcessEnv | undefined, fn: () => T, waitMs?: number): T;
+/** The same lock for a hook's bookkeeping: `{ ok: false }` when busy or when one of Trail's own folders is a link; nothing changed. */
+export declare function tryStoreLock<T>(env: NodeJS.ProcessEnv | undefined, fn: () => T, waitMs?: number): Locked<T>;
+/**
+ * A skill's folder, written whole into a folder that must not exist yet (made here, 0700): SKILL.md (0600), each
+ * helper in scripts/ (0700), and an empty lessons/ when asked. Throws on a folder already there (a link included),
+ * a bad name, or a helper whose file name is not one plain file name.
+ */
+export declare function writeSkillFolder(dir: string, c: CompiledSkill, text: string, opts: {
+    lessons: boolean;
+}): void;
+export declare function newSkillId(): string;
+/**
+ * The id to save under: the compiled one, unless another skill already holds it, a retired one included (restoring
+ * it brings its state back under that id, so two skills must never share one).
+ */
+export declare function freeId(id: string, name: string, env?: NodeJS.ProcessEnv): string;
+/** Throws unless the name can be a saved skill's: NAME_RE, no `--` or trailing dash, not one of Trail's own words. */
+export declare function checkSaveName(name: string): void;
+/** The skill folders other tools keep in the person's home (`~/.claude/skills`, `~/.agents/skills`, `$CLAUDE_CONFIG_DIR/skills`). */
+export declare function homeSkillDirs(env?: NodeJS.ProcessEnv): string[];
+/** What keeping or restoring a skill would collide with, without a checkout: built in, a personal skill, a host's skill. */
+export declare function takenAtHome(name: string, env?: NodeJS.ProcessEnv): 'built-in' | 'personal' | 'host' | null;
+export declare function personalRef(id: string, name: string, applies: string | null, env?: NodeJS.ProcessEnv): SkillRef;
+/**
+ * A new personal skill's state (candidate, uses 0) and its ledger `saved` line. Throws when the state can't be
+ * written (its lock busy, as a hook that died holding it leaves it for 10 s): a skill with no state entry would be
+ * recalled but could never count a use, so the caller undoes the save.
+ */
+export declare function startSkill(id: string, init: {
+    name: string;
+    from: SkillFrom;
+    runId: string | null;
+    hash: string;
+    source: SkillState['source'];
+    version: string;
+    consent: 'offer-yes' | 'asked' | 'init';
+    stepsVerified: number;
+    stepsTotal: number;
+    now: Date;
+    env?: NodeJS.ProcessEnv;
+}): void;
+/** Compiled steps plus a check that is not itself a step (4.9 step 10). */
+export declare const stepsTotal: (c: Pick<CompiledSkill, "steps" | "check" | "checkIsStep">) => number;
+//# sourceMappingURL=store-fs.d.ts.map

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

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

package/dist/skills/store-fs.js

@@ -0,0 +1,194 @@
+/**
+ * The file side of the skill store (store.ts, store-held.ts): private
+ * folders that never chmod or write through a link, capped reads, the one
+ * store lock, a skill folder written whole, and the state entry and ledger
+ * line a new personal skill starts with.
+ *
+ * A name reaches here from an agent's command line or a person's, so every
+ * name is checked to be one folder name before it is joined to a path.
+ */
+import { chmodSync, lstatSync, mkdirSync, readFileSync, rmSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { trailPath, withLock, writePrivate } from '../util/private-fs.js';
+import { BUILT_IN_NAMES, goodName } from './compile-words.js';
+import { appendLedger } from './ledger.js';
+import { getSkillState, updateSkillState } from './state.js';
+import { localDate } from './settings.js';
+import { randomBytes } from 'node:crypto';
+import { linkedOwnFolder, ownFolder } from './own-folder.js';
+const POSIX = process.platform !== 'win32';
+/** SKILL.md is at most 60 lines; anything this big is not one. */
+export const MAX_SKILL_BYTES = 64 * 1024;
+/** How long a person's command waits for the store; a hook's bookkeeping waits less. */
+export const PERSON_WAIT_MS = 1000;
+export const HOOK_WAIT_MS = 200;
+/** One folder name: no separators, no dot start, no `..`. Wider than NAME_RE so hand-made folders can be named back. */
+export const safeName = (name) => /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.test(String(name)) && !String(name).includes('..');
+export const lstatOrNull = (p) => {
+    try {
+        return lstatSync(p);
+    }
+    catch {
+        return null;
+    }
+};
+export const statOrNull = (p) => {
+    try {
+        return statSync(p);
+    }
+    catch {
+        return null;
+    }
+};
+/** A folder of ours: made 0700 when missing, tightened when it is a real folder; a link is left as it is (never chmod through it). */
+export function privateDir(dir) {
+    if (!lstatOrNull(dir))
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const st = lstatOrNull(dir);
+    if (POSIX && st?.isDirectory()) {
+        try {
+            chmodSync(dir, 0o700);
+        }
+        catch { /* not ours to change */ }
+    }
+}
+/** The file's text when it is a regular file (links followed) of at most 64 KB; null otherwise. */
+export function readCapped(file) {
+    const st = statOrNull(file);
+    if (!st?.isFile() || st.size > MAX_SKILL_BYTES)
+        return null;
+    try {
+        return readFileSync(file, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+export const skillsDir = (env) => trailPath(env, 'skills');
+export const heldDir = (env) => trailPath(env, 'held');
+export const retiredDir = (env) => join(skillsDir(env), '.retired');
+/**
+ * Every change to skills/ or held/ runs under one lock (`skills/.store.lock`). Throws when it can't be had in time,
+ * and before anything is written when one of Trail's own folders is a link (own-folder.ts).
+ */
+export function underStoreLock(env, fn, waitMs = PERSON_WAIT_MS) {
+    const linked = linkedOwnFolder(env);
+    if (linked)
+        ownFolder(trailPath(env, linked));
+    const done = tryStoreLock(env, fn, waitMs);
+    if (!done.ok)
+        throw new Error('trail: the skill store is busy (another trail command is changing it). Try again.');
+    return done.value;
+}
+/** The same lock for a hook's bookkeeping: `{ ok: false }` when busy or when one of Trail's own folders is a link; nothing changed. */
+export function tryStoreLock(env, fn, waitMs = HOOK_WAIT_MS) {
+    if (linkedOwnFolder(env))
+        return { ok: false };
+    privateDir(trailPath(env));
+    privateDir(skillsDir(env));
+    return withLock(join(skillsDir(env), '.store'), fn, waitMs);
+}
+/**
+ * A skill's folder, written whole into a folder that must not exist yet (made here, 0700): SKILL.md (0600), each
+ * helper in scripts/ (0700), and an empty lessons/ when asked. Throws on a folder already there (a link included),
+ * a bad name, or a helper whose file name is not one plain file name.
+ */
+export function writeSkillFolder(dir, c, text, opts) {
+    for (const h of c.helpers)
+        if (!safeName(h.file))
+            throw new Error(`trail: a helper script needs a plain file name: ${JSON.stringify(h.file).slice(0, 60)}`);
+    try {
+        mkdirSync(dir, { mode: 0o700 });
+    }
+    catch (e) {
+        if (e.code === 'EEXIST')
+            throw new Error(`trail: a skill folder called ${c.name} is already there`);
+        throw e;
+    }
+    try {
+        privateDir(dir);
+        writePrivate(join(dir, 'SKILL.md'), text);
+        if (c.helpers.length || opts.lessons)
+            privateDir(join(dir, 'scripts'));
+        for (const h of c.helpers)
+            writePrivate(join(dir, 'scripts', h.file), h.content, 0o700);
+        if (opts.lessons)
+            privateDir(join(dir, 'lessons'));
+    }
+    catch (e) {
+        // Half a skill (a full disk) would hold the name and never list: the folder made above goes.
+        rmSync(dir, { recursive: true, force: true });
+        throw e;
+    }
+}
+export function newSkillId() {
+    return `s-${randomBytes(3).toString('hex')}`;
+}
+/**
+ * The id to save under: the compiled one, unless another skill already holds it, a retired one included (restoring
+ * it brings its state back under that id, so two skills must never share one).
+ */
+export function freeId(id, name, env) {
+    const held = (x) => {
+        const s = getSkillState(x, env);
+        return s !== null && s.name !== name;
+    };
+    let out = id;
+    for (let i = 0; i < 64 && held(out); i++)
+        out = newSkillId();
+    return out;
+}
+/** Throws unless the name can be a saved skill's: NAME_RE, no `--` or trailing dash, not one of Trail's own words. */
+export function checkSaveName(name) {
+    if (!goodName(name))
+        throw new Error(`trail: not a skill name: ${JSON.stringify(name).slice(0, 60)}`);
+}
+/** The skill folders other tools keep in the person's home (`~/.claude/skills`, `~/.agents/skills`, `$CLAUDE_CONFIG_DIR/skills`). */
+export function homeSkillDirs(env) {
+    const e = env ?? process.env;
+    const home = e.HOME || homedir();
+    const dirs = [join(home, '.claude', 'skills'), join(home, '.agents', 'skills')];
+    if (e.CLAUDE_CONFIG_DIR)
+        dirs.push(join(e.CLAUDE_CONFIG_DIR, 'skills'));
+    return dirs;
+}
+/** What keeping or restoring a skill would collide with, without a checkout: built in, a personal skill, a host's skill. */
+export function takenAtHome(name, env) {
+    if (BUILT_IN_NAMES.has(name))
+        return 'built-in';
+    if (lstatOrNull(join(skillsDir(env), name)))
+        return 'personal';
+    if (homeSkillDirs(env).some((d) => lstatOrNull(join(d, name))))
+        return 'host';
+    return null;
+}
+export function personalRef(id, name, applies, env) {
+    const dir = join(skillsDir(env), name);
+    return { id, name, scope: 'personal', applies, dir, file: join(dir, 'SKILL.md') };
+}
+/**
+ * A new personal skill's state (candidate, uses 0) and its ledger `saved` line. Throws when the state can't be
+ * written (its lock busy, as a hook that died holding it leaves it for 10 s): a skill with no state entry would be
+ * recalled but could never count a use, so the caller undoes the save.
+ */
+export function startSkill(id, init) {
+    const at = init.now.toISOString();
+    const written = updateSkillState(id, () => ({
+        name: init.name, scope: 'personal', status: 'candidate', from: init.from, runId: init.runId, addedAt: at,
+        lastWorked: init.source ? localDate(init.source.at) : null, lastUsedAt: null, lastUsedRepo: null, uses: 0, checkedUses: 0,
+        hash: init.hash, source: init.source, lastFails: [], promoteOffers: {},
+    }), init.env);
+    if (!written)
+        throw new Error('trail: the skill state is busy (a hook is writing it). Try again in a few seconds.');
+    try {
+        appendLedger(id, {
+            at, event: 'saved', skill: id, v: init.version, from: init.from, scope: 'personal',
+            receipt: { consent: init.consent, stepsVerified: init.stepsVerified, stepsTotal: init.stepsTotal },
+        }, init.env);
+    }
+    catch { /* the state is the truth; the ledger is its record */ }
+}
+/** Compiled steps plus a check that is not itself a step (4.9 step 10). */
+export const stepsTotal = (c) => c.steps.length + (c.check && !c.checkIsStep ? 1 : 0);
+//# sourceMappingURL=store-fs.js.map

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

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

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

@@ -0,0 +1,44 @@
+import type { JobClass } from '../trace/types.js';
+import type { CompiledSkill, SkillRef } from './types.js';
+import type { PersonCheck } from './person.js';
+export interface HeldItem {
+    name: string;
+    why: 'no-yes' | 'host';
+    host: string;
+    job: JobClass | null;
+    repoKey: string;
+    at: string;
+    shownAt: string | null;
+    dir: string;
+    /** The run it was compiled from (D65: a live save for the same run drops the held item instead of being refused). Null when held.json lacks it. */
+    runId?: string | null;
+    /** D93: sha256(sessionId).slice(0, 12) of the session that held it; null when held.json lacks it (written before). */
+    session?: string | null;
+}
+/** Every held item Trail wrote, whatever its age, oldest first. */
+export declare function allHeld(env?: NodeJS.ProcessEnv): HeldItem[];
+/** Writes held/<name>/SKILL.md (+ scripts/) and held.json, replacing a held item of the same name. */
+export declare function saveHeld(c: CompiledSkill, why: HeldItem['why'], meta: {
+    host: string;
+    job: JobClass | null;
+    repoKey: string;
+    session?: string | null;
+}, env?: NodeJS.ProcessEnv, now?: Date): HeldItem;
+/** Held items not shown yet, and shown ones younger than 24 h (still keepable). */
+export declare function listHeld(env?: NodeJS.ProcessEnv, now?: Date): HeldItem[];
+/** Hook bookkeeping (SessionStart): a busy store leaves it unshown, to be shown next time. */
+export declare function markHeldShown(name: string, env?: NodeJS.ProcessEnv, now?: Date): void;
+export declare function dropHeld(name: string, env?: NodeJS.ProcessEnv): void;
+/**
+ * The person keeps a held item: it moves into skills/<name> as a candidate they asked for (ledger `saved`, consent
+ * `asked`, no steps verified: the transcript was not read again). Refused for anyone but the person, an unknown or
+ * expired item, or a name a personal skill, a host's skill or Trail itself already uses.
+ */
+export declare function keepHeld(name: string, person: PersonCheck, env?: NodeJS.ProcessEnv, now?: Date): {
+    ok: true;
+    ref: SkillRef;
+} | {
+    ok: false;
+    reason: 'not-a-person' | 'unknown' | 'name-taken';
+};
+//# sourceMappingURL=store-held.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store-held.d.ts","sourceRoot":"","sources":["../../src/skills/store-held.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ/C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAC3I,mJAAmJ;IACnJ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sHAAsH;IACtH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAkCD,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,QAAQ,EAAE,CAW3D;AAED,sGAAsG;AACtG,wBAAgB,QAAQ,CAAC,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,QAAQ,CAclN;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,QAAQ,EAAE,CAEpF;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,CAOjG;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAMpE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,YAAY,CAAA;CAAE,CAwC3M"}

package/dist/skills/store-held.js

@@ -0,0 +1,147 @@
+/**
+ * Held items (`~/.trail/held/<name>/`, design 2): a save Trail could not
+ * trust, because the person never said yes or because it came from a host
+ * where Trail can't check which steps ran. A held item is never read by
+ * recall. It is shown once, at the next `startup` or `resume` of another
+ * session than the one that held it (`session`, D93; `shownAt`), stays
+ * keepable for 24 hours after that showing, and is then deleted (by
+ * housekeeping, or here when kept). Only the person keeps one
+ * (`trail skills keep <name>`, checked by `personAtTerminal`).
+ *
+ * `held/<name>/SKILL.md` is the skill as it would have been saved; its
+ * `held.json` says why it was held, where it came from, and when it was shown.
+ */
+import { renameSync, rmSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { readJsonSafe, writePrivate } from '../util/private-fs.js';
+import { parseSkillMd, renderSkillMd, skillHash } from './skillmd.js';
+import { checkSaveName, freeId, heldDir, lstatOrNull, personalRef, privateDir, readCapped, safeName, skillsDir, startSkill, stepsTotal, takenAtHome, tryStoreLock, underStoreLock, writeSkillFolder, } from './store-fs.js';
+const KEEP_MS = 24 * 3600_000;
+/** One held item as Trail wrote it: a real folder (never a link) with a valid held.json; null otherwise. */
+function heldAt(name, env) {
+    if (!safeName(name))
+        return null;
+    const dir = join(heldDir(env), name);
+    if (!lstatOrNull(dir)?.isDirectory())
+        return null;
+    const f = readJsonSafe(join(dir, 'held.json'));
+    if (!f || typeof f !== 'object' || f.name !== name || (f.why !== 'no-yes' && f.why !== 'host') || typeof f.repoKey !== 'string' || typeof f.at !== 'string')
+        return null;
+    if (f.shownAt !== null && typeof f.shownAt !== 'string')
+        return null;
+    return { ...f, dir };
+}
+const toItem = (f) => ({
+    name: f.name, why: f.why, host: String(f.host ?? ''), job: f.job ?? null, repoKey: f.repoKey, at: f.at, shownAt: f.shownAt, dir: f.dir,
+    runId: typeof f.runId === 'string' ? f.runId : null,
+    session: typeof f.session === 'string' ? f.session : null,
+});
+/** Shown and more than 24 h ago: no longer keepable. */
+const expired = (f, now) => f.shownAt !== null && now.getTime() - Date.parse(f.shownAt) >= KEEP_MS;
+/** Every held item Trail wrote, whatever its age, oldest first. */
+export function allHeld(env) {
+    let names;
+    try {
+        names = readdirSync(heldDir(env));
+    }
+    catch {
+        return [];
+    }
+    return names.filter((n) => !n.startsWith('.')).flatMap((n) => {
+        const f = heldAt(n, env);
+        return f ? [toItem(f)] : [];
+    }).sort((a, b) => a.at.localeCompare(b.at) || a.name.localeCompare(b.name));
+}
+/** Writes held/<name>/SKILL.md (+ scripts/) and held.json, replacing a held item of the same name. */
+export function saveHeld(c, why, meta, env, now = new Date()) {
+    checkSaveName(c.name);
+    return underStoreLock(env, () => {
+        privateDir(heldDir(env));
+        const dir = join(heldDir(env), c.name);
+        rmSync(dir, { recursive: true, force: true }); // a link is removed, never followed
+        writeSkillFolder(dir, c, renderSkillMd(c), { lessons: false });
+        const f = {
+            v: 1, name: c.name, why, host: meta.host, job: meta.job, repoKey: meta.repoKey, at: now.toISOString(), shownAt: null,
+            id: c.meta.trail, runId: c.source.runId, ...(meta.session ? { session: meta.session } : {}), source: { commands: c.source.commands, failed: c.source.failed, at: c.source.at }, stepsTotal: stepsTotal(c),
+        };
+        writePrivate(join(dir, 'held.json'), JSON.stringify(f, null, 2));
+        return toItem({ ...f, dir });
+    });
+}
+/** Held items not shown yet, and shown ones younger than 24 h (still keepable). */
+export function listHeld(env, now = new Date()) {
+    return allHeld(env).filter((h) => !expired(h, now));
+}
+/** Hook bookkeeping (SessionStart): a busy store leaves it unshown, to be shown next time. */
+export function markHeldShown(name, env, now = new Date()) {
+    tryStoreLock(env, () => {
+        const f = heldAt(name, env);
+        if (!f || f.shownAt !== null)
+            return;
+        const { dir, ...file } = f;
+        writePrivate(join(dir, 'held.json'), JSON.stringify({ ...file, shownAt: now.toISOString() }, null, 2));
+    });
+}
+export function dropHeld(name, env) {
+    if (!safeName(name))
+        return;
+    tryStoreLock(env, () => {
+        const dir = join(heldDir(env), name);
+        if (lstatOrNull(dir))
+            rmSync(dir, { recursive: true, force: true });
+    });
+}
+/**
+ * The person keeps a held item: it moves into skills/<name> as a candidate they asked for (ledger `saved`, consent
+ * `asked`, no steps verified: the transcript was not read again). Refused for anyone but the person, an unknown or
+ * expired item, or a name a personal skill, a host's skill or Trail itself already uses.
+ */
+export function keepHeld(name, person, env, now = new Date()) {
+    if (!person.ok)
+        return { ok: false, reason: 'not-a-person' };
+    if (!safeName(name))
+        return { ok: false, reason: 'unknown' };
+    return underStoreLock(env, () => {
+        const f = heldAt(name, env);
+        // Trail wrote held/<name>/SKILL.md itself: a link there is not its file.
+        const own = f && !expired(f, now) && lstatOrNull(join(f.dir, 'SKILL.md'))?.isFile();
+        const text = own ? readCapped(join(f.dir, 'SKILL.md')) : null;
+        let parsed = text === null ? null : parseSkillMd(text, name);
+        if (!f || text === null || !parsed)
+            return { ok: false, reason: 'unknown' };
+        if (takenAtHome(name, env))
+            return { ok: false, reason: 'name-taken' };
+        const dir = join(skillsDir(env), name);
+        renameSync(f.dir, dir);
+        let file = text;
+        try {
+            rmSync(join(dir, 'held.json'), { force: true });
+            privateDir(join(dir, 'scripts'));
+            privateDir(join(dir, 'lessons'));
+            const id = freeId(parsed.meta.trail, name, env);
+            if (id !== parsed.meta.trail) {
+                file = text.replace(/^(\s+trail:\s*)"[^"\n]*"\s*$/m, `$1"${id}"`);
+                writePrivate(join(dir, 'SKILL.md'), file);
+                parsed = parseSkillMd(file, name) ?? parsed;
+            }
+            startSkill(id, {
+                name, from: 'asked', runId: f.runId ?? null, hash: skillHash(file), source: f.source ?? null, version: parsed.meta.version,
+                consent: 'asked', stepsVerified: 0, stepsTotal: typeof f.stepsTotal === 'number' ? f.stepsTotal : parsed.steps.length, now, env,
+            });
+            return { ok: true, ref: personalRef(id, name, parsed.meta.applies ?? null, env) };
+        }
+        catch (e) {
+            // Put the held item back as it was, so the person can keep it once the state is free.
+            try {
+                if (file !== text)
+                    writePrivate(join(dir, 'SKILL.md'), text);
+                renameSync(dir, f.dir);
+                const { dir: _dir, ...held } = f;
+                writePrivate(join(f.dir, 'held.json'), JSON.stringify(held, null, 2));
+            }
+            catch { /* left in skills/ without state: listed, and the person can forget it */ }
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=store-held.js.map

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

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

package/dist/skills/store.d.ts

@@ -0,0 +1,73 @@
+import type { JobClass } from '../trace/types.js';
+import type { CompiledSkill, ParsedSkill, SkillFrom, SkillRef } from './types.js';
+export { BUILT_IN_NAMES } from './compile-words.js';
+export { newSkillId } from './store-fs.js';
+export { dropHeld, keepHeld, listHeld, markHeldShown, saveHeld, type HeldItem } from './store-held.js';
+export { personAtTerminal, type PersonCheck, type PersonDeps, type PsRow } from './person.js';
+export declare function personalSkillsDir(env?: NodeJS.ProcessEnv): string;
+export interface ScopeCtx {
+    repoKeys: string[];
+    checkout: string;
+    env?: NodeJS.ProcessEnv;
+}
+/** Personal skills that apply to any of repoKeys or 'every repo', then repo (stub), then team (stub). Follows symlinks. Excludes held, retired and settings.skillsOff. */
+export declare function listSkills(ctx: ScopeCtx): SkillRef[];
+/** Every personal skill regardless of applies (for `trail skills`). */
+export declare function listAllPersonal(env?: NodeJS.ProcessEnv): SkillRef[];
+/** Repo skills (`.agents/skills/*` with `metadata.trail`, committed HEAD only): phase 3, so none in 1a. */
+export declare function listRepoSkills(_checkout: string): SkillRef[];
+/** Team skills (`~/.trail/teams/<team>/skills`, the team repo's default branch): phase 3, so none in 1a. */
+export declare function listTeamSkills(_repoKeys: string[], _env?: NodeJS.ProcessEnv): SkillRef[];
+/**
+ * The skill's SKILL.md, parsed (null when missing, not a file, over 64 KB, or not Trail's). A personal needs-fix
+ * skill whose file no longer has the hash Trail wrote was changed by hand, and goes back to what it was (4.8).
+ */
+export declare function readSkill(ref: SkillRef, known?: {
+    status?: string;
+} | null): ParsedSkill | null;
+export declare function findSkill(name: string, ctx: ScopeCtx): SkillRef | null;
+/**
+ * Where the name is taken: 'personal' | 'retired' | 'held' | 'repo' | 'team' | 'host' (~/.claude/skills, ~/.agents/skills,
+ * <checkout>/.claude/skills, <checkout>/.agents/skills) | 'built-in'; null when free. 'invalid' for a name that is not
+ * one folder name. In the checkout, a Trail skill (`metadata.trail`) is 'repo', anything else 'host'.
+ */
+export declare function nameTaken(name: string, ctx: ScopeCtx): string | null;
+/**
+ * Moment 2's "a Trail skill covers it" (4.12 condition 3): a skill in scope with this job and status candidate,
+ * active or needs-fix, or a held item for this repo and job not yet shown. Retired never covers. A skill the person
+ * turned off still covers its job: an offer would only make a second one.
+ */
+export declare function jobCovered(job: JobClass, ctx: ScopeCtx): boolean;
+/** Writes skills/<name>/SKILL.md (+ scripts/, empty lessons/), the state entry (candidate, source counts), ledger 'saved'. Locked. */
+export declare function savePersonal(c: CompiledSkill, opts: {
+    from: SkillFrom;
+    runId: string;
+    consent: 'offer-yes' | 'asked' | 'init';
+    stepsVerified: number;
+    env?: NodeJS.ProcessEnv;
+    now?: Date;
+}): SkillRef;
+/**
+ * Moves skills/<name> to skills/.retired/<name>-<YYYY-MM-DD>/ (`-2`, `-3` the same day); status retired, prevStatus kept.
+ * Phase 2 (4.9): the retire proposal's and drift's retire pass `reason: 'retire-offer'` (the ledger status line's
+ * reason) and a hook's short `waitMs`; a busy store throws, as for the person.
+ */
+export declare function forgetSkill(name: string, env?: NodeJS.ProcessEnv, now?: Date, o?: {
+    reason?: 'forget' | 'retire-offer';
+    waitMs?: number;
+}): {
+    ok: true;
+    to: string;
+} | {
+    ok: false;
+    reason: 'unknown';
+};
+/** The newest retired copy back to skills/<name>, with the status it had (needs-fix when it was, else prevStatus). */
+export declare function restoreSkill(name: string, env?: NodeJS.ProcessEnv, now?: Date): {
+    ok: true;
+    ref: SkillRef;
+} | {
+    ok: false;
+    reason: 'unknown' | 'name-taken';
+};
+//# sourceMappingURL=store.d.ts.map

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

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