@nanonets/graft 0.24.0 → 0.24.1

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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"}

package/dist/skills/store.js

@@ -0,0 +1,279 @@
+/**
+ * The skill store (design 1.4 and 2, spec 5 and 6). Personal skills live in
+ * `~/.trail/skills/<name>/` (SKILL.md, scripts/, lessons/), each applying to
+ * one repo or to every repo; what changes about them per person is in
+ * `state/skills.json` (state.ts) and their history in the ledger. Repo skills
+ * (`.agents/skills` in the checkout) and team skills (`~/.trail/teams`) are
+ * modelled in every type, and their lists are empty until phase 3.
+ *
+ * Listing follows links (a skill folder kept elsewhere and linked in is
+ * listed); writing never goes through one: a save makes a new folder, never
+ * fills one that is there; forget and restore move a folder (or the link
+ * itself) whole. Held items (store-held.ts) are never listed here, so recall
+ * never sees them. Files 0600, folders 0700.
+ */
+import { readdirSync, renameSync, rmSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { trailPath } from '../util/private-fs.js';
+import { parseSkillMd, renderSkillMd, skillHash } from './skillmd.js';
+import { BUILT_IN_NAMES } from './compile-words.js';
+import { readSettings, localDate } from './settings.js';
+import { appendLedger } from './ledger.js';
+import { getSkillState, handEdited, readSkillsState, updateSkillState } from './state.js';
+import { checkSaveName, freeId, heldDir, homeSkillDirs, lstatOrNull, personalRef, privateDir, readCapped, retiredDir, safeName, skillsDir, startSkill, statOrNull, stepsTotal, takenAtHome, underStoreLock, writeSkillFolder, } from './store-fs.js';
+import { allHeld } from './store-held.js';
+export { BUILT_IN_NAMES } from './compile-words.js';
+export { newSkillId } from './store-fs.js';
+export { dropHeld, keepHeld, listHeld, markHeldShown, saveHeld } from './store-held.js';
+export { personAtTerminal } from './person.js';
+export function personalSkillsDir(env) {
+    return skillsDir(env);
+}
+/** Every Trail skill folder in skills/ (links followed), by name; folders without `metadata.trail` are not Trail's. */
+function personalEntries(env) {
+    let names;
+    try {
+        names = readdirSync(skillsDir(env));
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const name of names.sort()) {
+        if (name.startsWith('.') || !safeName(name) || !statOrNull(join(skillsDir(env), name))?.isDirectory())
+            continue;
+        const text = readCapped(join(skillsDir(env), name, 'SKILL.md'));
+        const skill = text === null ? null : parseSkillMd(text, name);
+        if (skill)
+            out.push({ ref: personalRef(skill.meta.trail, name, skill.meta.applies ?? null, env), skill });
+    }
+    return out;
+}
+const appliesTo = (applies, keys) => !applies || applies.toLowerCase() === 'every repo' || keys.has(applies.toLowerCase());
+/** 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 function listSkills(ctx) {
+    const keys = new Set(ctx.repoKeys.map((k) => k.toLowerCase()));
+    const off = new Set(readSettings(ctx.env).skillsOff);
+    const state = readSkillsState(ctx.env).skills;
+    const personal = personalEntries(ctx.env)
+        .filter((e) => appliesTo(e.ref.applies, keys) && !off.has(e.ref.name) && state[e.ref.id]?.status !== 'retired')
+        .map((e) => e.ref);
+    return [...personal, ...listRepoSkills(ctx.checkout), ...listTeamSkills(ctx.repoKeys, ctx.env)];
+}
+/** Every personal skill regardless of applies (for `trail skills`). */
+export function listAllPersonal(env) {
+    return personalEntries(env).map((e) => e.ref);
+}
+/** Repo skills (`.agents/skills/*` with `metadata.trail`, committed HEAD only): phase 3, so none in 1a. */
+export function listRepoSkills(_checkout) {
+    return []; // phase 3
+}
+/** Team skills (`~/.trail/teams/<team>/skills`, the team repo's default branch): phase 3, so none in 1a. */
+export function listTeamSkills(_repoKeys, _env) {
+    return []; // phase 3
+}
+/**
+ * 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 function readSkill(ref, known) {
+    const text = readCapped(ref.file);
+    const skill = text === null ? null : parseSkillMd(text, basename(ref.dir));
+    if (skill && ref.scope === 'personal') {
+        // The state file sits beside skills/ in the same Trail home: <home>/skills/<name> -> <home>.
+        const env = { TRAIL_HOME: join(ref.dir, '..', '..') };
+        try {
+            // `known`: the state the caller already read for this skill (recall reads 200 skills against one state file).
+            const status = known !== undefined ? known?.status : getSkillState(skill.meta.trail, env)?.status;
+            if (status === 'needs-fix')
+                handEdited(skill.meta.trail, skill.hash, env);
+        }
+        catch { /* the skill still reads */ }
+    }
+    return skill;
+}
+export function findSkill(name, ctx) {
+    return listSkills(ctx).find((r) => r.name === name) ?? null;
+}
+/** What follows `<name>` in a retired copy's folder name: `-<date>`, then `-2`, `-3` the same day. */
+const RETIRED_TAIL = /^-(\d{4}-\d{2}-\d{2})(?:-(\d+))?$/;
+/** The retired copies of a name, newest first: `.retired/<name>-<date>` then `-2`, `-3` the same day. */
+function retiredCopies(name, env) {
+    let names;
+    try {
+        names = readdirSync(retiredDir(env));
+    }
+    catch {
+        return [];
+    }
+    return names.flatMap((n) => {
+        // A prefix check, not a regex built from the name: no character in it can mean anything.
+        const m = n.startsWith(name) ? RETIRED_TAIL.exec(n.slice(name.length)) : null;
+        return m ? [{ n, day: m[1], k: Number(m[2] ?? 1) }] : [];
+    }).sort((a, b) => b.day.localeCompare(a.day) || b.k - a.k).map((x) => x.n);
+}
+/** Is SKILL.md in this folder Trail's (`metadata.trail`)? */
+const trailMarked = (dir) => {
+    const text = readCapped(join(dir, 'SKILL.md'));
+    return text !== null && parseSkillMd(text, basename(dir)) !== 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 function nameTaken(name, ctx) {
+    if (!safeName(name))
+        return 'invalid';
+    if (BUILT_IN_NAMES.has(name))
+        return 'built-in';
+    const env = ctx.env;
+    if (lstatOrNull(join(skillsDir(env), name)))
+        return 'personal';
+    if (retiredCopies(name, env).length)
+        return 'retired';
+    if (lstatOrNull(join(heldDir(env), name)))
+        return 'held';
+    if (ctx.checkout) {
+        for (const d of [join(ctx.checkout, '.agents', 'skills'), join(ctx.checkout, '.claude', 'skills')]) {
+            if (lstatOrNull(join(d, name)))
+                return trailMarked(join(d, name)) ? 'repo' : 'host';
+        }
+    }
+    let teams = [];
+    try {
+        teams = readdirSync(trailPath(env, 'teams'));
+    }
+    catch { /* no team joined */ }
+    if (teams.some((t) => safeName(t) && lstatOrNull(join(trailPath(env, 'teams'), t, 'skills', name))))
+        return 'team';
+    if (homeSkillDirs(env).some((d) => lstatOrNull(join(d, name))))
+        return 'host';
+    return 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 function jobCovered(job, ctx) {
+    const keys = new Set(ctx.repoKeys.map((k) => k.toLowerCase()));
+    const state = readSkillsState(ctx.env).skills;
+    const live = personalEntries(ctx.env).some((e) => e.skill.meta.job === job && appliesTo(e.ref.applies, keys) && (state[e.ref.id]?.status ?? 'candidate') !== 'retired');
+    if (live)
+        return true;
+    return allHeld(ctx.env).some((h) => h.shownAt === null && h.job === job && keys.has(h.repoKey.toLowerCase()));
+}
+/** Writes skills/<name>/SKILL.md (+ scripts/, empty lessons/), the state entry (candidate, source counts), ledger 'saved'. Locked. */
+export function savePersonal(c, opts) {
+    checkSaveName(c.name);
+    const env = opts.env;
+    const now = opts.now ?? new Date();
+    return underStoreLock(env, () => {
+        const id = freeId(c.meta.trail, c.name, env);
+        const skill = id === c.meta.trail ? c : { ...c, meta: { ...c.meta, trail: id } };
+        const text = renderSkillMd(skill);
+        const dir = join(skillsDir(env), c.name);
+        writeSkillFolder(dir, skill, text, { lessons: true });
+        try {
+            startSkill(id, {
+                name: c.name, from: opts.from, runId: opts.runId, hash: skillHash(text), version: skill.meta.version,
+                source: { commands: c.source.commands, failed: c.source.failed, at: c.source.at },
+                consent: opts.consent, stepsVerified: opts.stepsVerified, stepsTotal: stepsTotal(c), now, env,
+            });
+        }
+        catch (e) {
+            rmSync(dir, { recursive: true, force: true }); // made just now: a skill with no state is undone whole
+            throw e;
+        }
+        return personalRef(id, c.name, skill.meta.applies ?? null, env);
+    });
+}
+/** The skill's id from its SKILL.md, or null. */
+const idIn = (dir) => {
+    const text = readCapped(join(dir, 'SKILL.md'));
+    return text === null ? null : parseSkillMd(text, basename(dir))?.meta.trail ?? null;
+};
+/**
+ * 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 function forgetSkill(name, env, now = new Date(), o = {}) {
+    if (!safeName(name))
+        return { ok: false, reason: 'unknown' };
+    const reason = o.reason === 'retire-offer' ? 'retire-offer' : 'forget';
+    return underStoreLock(env, () => {
+        const dir = join(skillsDir(env), name);
+        if (!lstatOrNull(dir))
+            return { ok: false, reason: 'unknown' };
+        const id = idIn(dir);
+        privateDir(retiredDir(env));
+        const day = localDate(now);
+        let to = join(retiredDir(env), `${name}-${day}`);
+        for (let k = 2; lstatOrNull(to); k++)
+            to = join(retiredDir(env), `${name}-${day}-${k}`);
+        renameSync(dir, to);
+        if (id)
+            moveStatus(id, reason, now, env);
+        return { ok: true, to };
+    }, o.waitMs);
+}
+/** The newest retired copy back to skills/<name>, with the status it had (needs-fix when it was, else prevStatus). */
+export function restoreSkill(name, env, now = new Date()) {
+    if (!safeName(name))
+        return { ok: false, reason: 'unknown' };
+    return underStoreLock(env, () => {
+        const [copy] = retiredCopies(name, env);
+        if (!copy)
+            return { ok: false, reason: 'unknown' };
+        if (takenAtHome(name, env))
+            return { ok: false, reason: 'name-taken' };
+        const dir = join(skillsDir(env), name);
+        renameSync(join(retiredDir(env), copy), dir);
+        const text = readCapped(join(dir, 'SKILL.md'));
+        const skill = text === null ? null : parseSkillMd(text, name);
+        const id = skill?.meta.trail ?? null;
+        if (id)
+            moveStatus(id, 'restore', now, env);
+        return { ok: true, ref: personalRef(id ?? '', name, skill?.meta.applies ?? null, env) };
+    });
+}
+/**
+ * Forget: retired, remembering what it was (a needs-fix skill keeps the status before it and its why, so restore can
+ * bring needs-fix back). Restore: back to needs-fix when it carries a why, else to prevStatus (candidate when unknown).
+ */
+function moveStatus(id, reason, now, env) {
+    let line = null;
+    const next = updateSkillState(id, (s) => {
+        if (!s)
+            return undefined;
+        if (reason !== 'restore') {
+            if (s.status === 'retired')
+                return s;
+            if (s.status !== 'needs-fix') {
+                s.prevStatus = s.status;
+                delete s.statusWhy;
+                delete s.fixHash;
+            }
+            line = { from: s.status, to: 'retired' };
+            s.status = 'retired';
+        }
+        else {
+            if (s.status !== 'retired')
+                return s;
+            const to = s.statusWhy ? 'needs-fix' : s.prevStatus && s.prevStatus !== 'retired' && s.prevStatus !== 'needs-fix' ? s.prevStatus : 'candidate';
+            line = { from: 'retired', to };
+            s.status = to;
+        }
+        return s;
+    }, env);
+    const l = line;
+    if (next && l) {
+        try {
+            appendLedger(id, { at: now.toISOString(), event: 'status', skill: id, from: l.from, to: l.to, reason }, env);
+        }
+        catch { /* the state is the truth */ }
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/skills/store.js.map

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

package/dist/skills/validate.d.ts

@@ -0,0 +1,11 @@
+/** The top-level keys the spec allows. */
+export declare const SPEC_KEYS: readonly string[];
+export declare const NAME_MAX = 64;
+export declare const DESCRIPTION_MAX = 1024;
+export declare const COMPATIBILITY_MAX = 500;
+/**
+ * Every way `text` (a SKILL.md) breaks the spec, for a skill in the folder
+ * `folderName`. Empty when it is valid.
+ */
+export declare function skillProblems(text: string, folderName: string): string[];
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/skills/validate.ts"],"names":[],"mappings":"AAkBA,0CAA0C;AAC1C,eAAO,MAAM,SAAS,EAAE,SAAS,MAAM,EAAqF,CAAC;AAE7H,eAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAgCrC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAwCxE"}