@nanonets/graft 0.23.1 → 0.24.1

package/dist/skills/settings.js

@@ -0,0 +1,133 @@
+import { isTestHome } from './host-facts.js';
+import { readJsonSafe, trailPath, withLock, writePrivate } from '../util/private-fs.js';
+export { isTestHome, labInteractive } from './host-facts.js';
+export const DEFAULT_SETTINGS = Object.freeze({
+    v: 1, skills: 'off', onSince: null, offers: 'on', offersOffAt: null, offRepos: Object.freeze([]),
+    pausedUntil: Object.freeze({}), skillsOff: Object.freeze([]),
+    lastNine: Object.freeze([]), governorSaidAt: null,
+});
+/** How long a person's command waits for the file; a hook's bookkeeping waits less. */
+const PERSON_WAIT_MS = 1000;
+const HOOK_WAIT_MS = 200;
+const ANSWERS = new Set(['yes', 'no', 'none']);
+function settingsPath(env) {
+    return trailPath(env, 'settings.json');
+}
+const strOrNull = (v) => (typeof v === 'string' ? v : null);
+const strings = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === 'string') : []);
+/** The known fields of whatever was on disk, each its default when missing or of the wrong shape. */
+function fromRaw(raw) {
+    const r = raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
+    const paused = {};
+    if (r.pausedUntil && typeof r.pausedUntil === 'object' && !Array.isArray(r.pausedUntil)) {
+        for (const [k, v] of Object.entries(r.pausedUntil))
+            if (typeof v === 'string')
+                paused[k] = v;
+    }
+    return {
+        v: 1,
+        skills: r.skills === 'on' ? 'on' : 'off',
+        onSince: strOrNull(r.onSince),
+        offers: r.offers === 'off' ? 'off' : 'on',
+        offersOffAt: strOrNull(r.offersOffAt),
+        offRepos: strings(r.offRepos),
+        pausedUntil: paused,
+        skillsOff: strings(r.skillsOff),
+        lastNine: (Array.isArray(r.lastNine) ? r.lastNine : []).filter((a) => ANSWERS.has(a)).slice(-9),
+        governorSaidAt: strOrNull(r.governorSaidAt),
+    };
+}
+/** Defaults on a missing or bad file; unknown keys are kept on every write. */
+export function readSettings(env) {
+    return fromRaw(readJsonSafe(settingsPath(env)));
+}
+/** Read, change, write back under the file's lock, keeping keys this version doesn't know. */
+function update(env, change, waitMs) {
+    const path = settingsPath(env);
+    const done = withLock(path, () => {
+        const raw = readJsonSafe(path);
+        const keep = raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
+        const s = fromRaw(raw);
+        change(s);
+        writePrivate(path, `${JSON.stringify({ ...keep, ...s }, null, 2)}\n`);
+        return s;
+    }, waitMs);
+    if (!done.ok)
+        throw new Error('trail: the skills settings are busy (another trail command is writing them). Try again.');
+    return done.value;
+}
+/** TRAIL_TEST_NOW (ISO) in a test home only; else new Date(). */
+export function trailNow(env = process.env) {
+    const fixed = env.TRAIL_TEST_NOW;
+    if (fixed && isTestHome(env)) {
+        const d = new Date(fixed);
+        if (!Number.isNaN(d.getTime()))
+            return d;
+    }
+    return new Date();
+}
+/** The local calendar date `YYYY-MM-DD` of a time: days (pauses, session-days, last worked) are the person's days. */
+export function localDate(at) {
+    const d = typeof at === 'string' ? new Date(at) : at;
+    const two = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${two(d.getMonth() + 1)}-${two(d.getDate())}`;
+}
+// Person-only setters. Only src/skills/cli-skills.ts imports these (a static test, G0).
+/** onSince = now when it turns on. */
+export function setSkills(on, env, now = new Date()) {
+    return update(env, (s) => {
+        if (on && (s.skills !== 'on' || s.onSince === null))
+            s.onSince = now.toISOString();
+        s.skills = on ? 'on' : 'off';
+    }, PERSON_WAIT_MS);
+}
+/** here: adds or removes that repo key in offRepos; a global off sets offersOffAt. */
+export function setOffers(on, here, env, now = new Date()) {
+    return update(env, (s) => {
+        if (here !== null) {
+            s.offRepos = s.offRepos.filter((k) => k !== here);
+            if (!on)
+                s.offRepos.push(here);
+            return;
+        }
+        if (!on && s.offers !== 'off')
+            s.offersOffAt = now.toISOString();
+        if (on)
+            s.offersOffAt = null;
+        s.offers = on ? 'on' : 'off';
+    }, PERSON_WAIT_MS);
+}
+export function setSkillOff(name, off, env) {
+    return update(env, (s) => {
+        s.skillsOff = s.skillsOff.filter((n) => n !== name);
+        if (off)
+            s.skillsOff.push(name);
+    }, PERSON_WAIT_MS);
+}
+// Bookkeeping writers. Only src/skills/offers.ts imports these (the same test).
+export function pauseRepo(repoKey, until, env) {
+    return update(env, (s) => {
+        s.pausedUntil = { ...s.pausedUntil, [repoKey]: localDate(until) };
+    }, HOOK_WAIT_MS);
+}
+export function noteGovernor(lastNine, saidAt, env) {
+    return update(env, (s) => {
+        s.lastNine = lastNine.filter((a) => ANSWERS.has(a)).slice(-9);
+        s.governorSaidAt = saidAt;
+    }, HOOK_WAIT_MS);
+}
+export function skillsOn(env) {
+    return readSettings(env).skills === 'on';
+}
+export function offersHere(repoKey, now = new Date(), env) {
+    const s = readSettings(env);
+    if (s.offers === 'off')
+        return { ok: false, why: 'off' };
+    if (s.offRepos.includes(repoKey))
+        return { ok: false, why: 'off-here' };
+    const until = s.pausedUntil[repoKey];
+    if (until && until > localDate(now))
+        return { ok: false, why: 'paused' };
+    return { ok: true };
+}
+//# sourceMappingURL=settings.js.map

package/dist/skills/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/skills/settings.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAuB,MAAM,CAAC,MAAM,CAAC;IAChE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAwB;IACvH,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAA2B,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAwB;IAC7G,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAA4C,EAAE,cAAc,EAAE,IAAI;CACvE,CAAC,CAAC;AAEzB,uFAAuF;AACvF,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/C,SAAS,YAAY,CAAC,GAAuB;IAC3C,OAAO,SAAS,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,CAAU,EAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACpF,MAAM,OAAO,GAAG,CAAC,CAAU,EAAY,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAExH,qGAAqG;AACrG,SAAS,OAAO,CAAC,GAAY;IAC3B,MAAM,CAAC,GAAG,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,GAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,CAAC,CAAC,WAAW,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;QACxF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAsC,CAAC;YAAE,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1H,CAAC;IACD,OAAO;QACL,CAAC,EAAE,CAAC;QACJ,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;QACxC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACzC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;QACrC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC7B,WAAW,EAAE,MAAM;QACnB,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/B,QAAQ,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAA8B,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrI,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,GAAuB;IAClD,OAAO,OAAO,CAAC,YAAY,CAAU,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,8FAA8F;AAC9F,SAAS,MAAM,CAAC,GAAkC,EAAE,MAAuC,EAAE,MAAc;IACzG,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE;QAC/B,MAAM,GAAG,GAAG,YAAY,CAAU,IAAI,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,GAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3G,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,CAAC,CAAC,CAAC,CAAC;QACV,YAAY,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,CAAC,CAAC;IACX,CAAC,EAAE,MAAM,CAAC,CAAC;IACX,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;IACzH,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,QAAQ,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC3D,MAAM,KAAK,GAAG,GAAG,CAAC,cAAc,CAAC;IACjC,IAAI,KAAK,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,IAAI,EAAE,CAAC;AACpB,CAAC;AAED,sHAAsH;AACtH,MAAM,UAAU,SAAS,CAAC,EAAiB;IACzC,MAAM,CAAC,GAAG,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,wFAAwF;AAExF,sCAAsC;AACtC,MAAM,UAAU,SAAS,CAAC,EAAW,EAAE,GAAuB,EAAE,MAAY,IAAI,IAAI,EAAE;IACpF,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;QACvB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC;YAAE,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACnF,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/B,CAAC,EAAE,cAAc,CAAC,CAAC;AACrB,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,SAAS,CAAC,EAAW,EAAE,IAAmB,EAAE,GAAuB,EAAE,MAAY,IAAI,IAAI,EAAE;IACzG,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;QACvB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YAClD,IAAI,CAAC,EAAE;gBAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK;YAAE,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACjE,IAAI,EAAE;YAAE,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC;QAC7B,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/B,CAAC,EAAE,cAAc,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,GAAY,EAAE,GAAuB;IAC7E,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;QACvB,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACpD,IAAI,GAAG;YAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,EAAE,cAAc,CAAC,CAAC;AACrB,CAAC;AAED,gFAAgF;AAEhF,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,KAAW,EAAE,GAAuB;IAC7E,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;QACvB,CAAC,CAAC,WAAW,GAAG,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IACpE,CAAC,EAAE,YAAY,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAsC,EAAE,MAAqB,EAAE,GAAuB;IACjH,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;QACvB,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,cAAc,GAAG,MAAM,CAAC;IAC5B,CAAC,EAAE,YAAY,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAuB;IAC9C,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,MAAY,IAAI,IAAI,EAAE,EAAE,GAAuB;IACzF,MAAM,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IACzD,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;IACxE,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,KAAK,IAAI,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IACzE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/skills/skill-diff.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The line diff of two skill files, the size gate a fold must pass (phase 2
+ * design 4.3, spec 13), and the printed diff a person reads for `show me`, a
+ * proposal beside a hand-edited file, or (phase 3) a new file in a repo.
+ *
+ * Pure and bounded: texts over 64 KB, or a changed middle too big to align
+ * cheaply, are read as all removed and all added, never line by line.
+ */
+import type { CompiledSkill } from './types.js';
+export interface LineDiff {
+    removed: string[];
+    added: string[];
+    hunks: Array<{
+        at: number;
+        del: string[];
+        add: string[];
+    }>;
+}
+/** Spec 13: a fold changes at most 800 characters, and at most 40% of the file. */
+export declare const FOLD_MAX_CHARS = 800;
+export declare const FOLD_MAX_SHARE = 0.4;
+/** LCS on lines. A hunk's `at` is how many lines of `a` come before it (0-based). */
+export declare function lineDiff(a: string, b: string): LineDiff;
+/**
+ * 4.3 as D131 changed it: the characters an edit changes (every removed and added line, its line break counted), step
+ * numbers taken out first, so one inserted step anywhere costs about its own length. `share` is of the file as it is.
+ */
+export declare function sizeGate(before: string, after: string): {
+    chars: number;
+    share: number;
+    ok: boolean;
+};
+/**
+ * A unified diff (3 lines of context), at most `maxLines` lines with the more-lines line, step text as it is. '' when
+ * the texts are equal. Each line at most 400 characters, control characters and bidi marks as escapes (review). An empty `a` prints a new file: phase 3's `renderNewFileDiff` prints through it.
+ */
+export declare function printDiff(a: string, b: string, labels: [string, string], maxLines?: number): string;
+/** The Run lines a change touches, for "1 line changes": per hunk the larger of what goes and what comes. */
+export declare function runLinesChanged(before: CompiledSkill, after: CompiledSkill): number;
+//# sourceMappingURL=skill-diff.d.ts.map

package/dist/skills/skill-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-diff.d.ts","sourceRoot":"","sources":["../../src/skills/skill-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,MAAM,WAAW,QAAQ;IAAG,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;CAAE;AAE5H,mFAAmF;AACnF,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,cAAc,MAAM,CAAC;AAyDlC,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,CAWvD;AAWD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,CAMrG;AAmBD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,SAAkB,GAAG,MAAM,CAoC5G;AAKD,6GAA6G;AAC7G,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAGnF"}

package/dist/skills/skill-diff.js

@@ -0,0 +1,191 @@
+import { oneLine } from './skillmd.js';
+import { MAX_SKILL_BYTES } from './store-fs.js';
+/** Spec 13: a fold changes at most 800 characters, and at most 40% of the file. */
+export const FOLD_MAX_CHARS = 800;
+export const FOLD_MAX_SHARE = 0.4;
+/** The printed diff's default length, the more-lines line included. */
+const PRINT_MAX_LINES = 40;
+const CONTEXT = 3;
+/** Cells of the alignment table after the common start and end are taken off; past it the middle is one hunk. */
+const MAX_CELLS = 4_000_000;
+/** Lines of a text; a trailing line break ends the last line, it doesn't start an empty one. '' has none. */
+function linesOf(text) {
+    const t = String(text ?? '');
+    if (!t)
+        return [];
+    const out = t.split('\n');
+    if (out[out.length - 1] === '')
+        out.pop();
+    return out;
+}
+/** The edit script of the middle (LCS, a table of at most MAX_CELLS); past it, all removed then all added. */
+function middleOps(a, b) {
+    const n = a.length;
+    const m = b.length;
+    if (!n || !m || n * m > MAX_CELLS)
+        return [...a.map((line) => ({ kind: '-', line })), ...b.map((line) => ({ kind: '+', line }))];
+    const w = m + 1;
+    const t = new Uint32Array((n + 1) * w);
+    for (let i = n - 1; i >= 0; i--) {
+        for (let j = m - 1; j >= 0; j--) {
+            t[i * w + j] = a[i] === b[j] ? t[(i + 1) * w + j + 1] + 1 : Math.max(t[(i + 1) * w + j], t[i * w + j + 1]);
+        }
+    }
+    const ops = [];
+    let i = 0;
+    let j = 0;
+    while (i < n && j < m) {
+        if (a[i] === b[j]) {
+            ops.push({ kind: '=', line: a[i] });
+            i++;
+            j++;
+        }
+        else if (t[(i + 1) * w + j] >= t[i * w + j + 1])
+            ops.push({ kind: '-', line: a[i++] });
+        else
+            ops.push({ kind: '+', line: b[j++] });
+    }
+    while (i < n)
+        ops.push({ kind: '-', line: a[i++] });
+    while (j < m)
+        ops.push({ kind: '+', line: b[j++] });
+    return ops;
+}
+function editScript(a, b) {
+    const la = linesOf(a);
+    const lb = linesOf(b);
+    if (Buffer.byteLength(String(a ?? '')) > MAX_SKILL_BYTES || Buffer.byteLength(String(b ?? '')) > MAX_SKILL_BYTES) {
+        return [...la.map((line) => ({ kind: '-', line })), ...lb.map((line) => ({ kind: '+', line }))];
+    }
+    let pre = 0;
+    while (pre < la.length && pre < lb.length && la[pre] === lb[pre])
+        pre++;
+    let post = 0;
+    while (post < la.length - pre && post < lb.length - pre && la[la.length - 1 - post] === lb[lb.length - 1 - post])
+        post++;
+    const same = (l) => l.map((line) => ({ kind: '=', line }));
+    return [...same(la.slice(0, pre)), ...middleOps(la.slice(pre, la.length - post), lb.slice(pre, lb.length - post)), ...same(la.slice(la.length - post))];
+}
+/** LCS on lines. A hunk's `at` is how many lines of `a` come before it (0-based). */
+export function lineDiff(a, b) {
+    const out = { removed: [], added: [], hunks: [] };
+    let at = 0;
+    let open = null;
+    for (const op of editScript(a, b)) {
+        if (op.kind === '=') {
+            open = null;
+            at++;
+            continue;
+        }
+        if (!open) {
+            open = { at, del: [], add: [] };
+            out.hunks.push(open);
+        }
+        if (op.kind === '-') {
+            open.del.push(op.line);
+            out.removed.push(op.line);
+            at++;
+        }
+        else {
+            open.add.push(op.line);
+            out.added.push(op.line);
+        }
+    }
+    return out;
+}
+/**
+ * D131: step numbers read as one mark, so a renumber alone changes no line: a Run line's `N. `, the check line's
+ * `Step N, ` and an If it fails line's `what worked was step N.`.
+ */
+const unnumbered = (text) => String(text ?? '').split('\n').map((l) => l
+    .replace(/^\d+\. /, '#. ')
+    .replace(/^Step \d+, /, 'Step #, ')
+    .replace(/\bwhat worked was step \d+\./, 'what worked was step #.')).join('\n');
+/**
+ * 4.3 as D131 changed it: the characters an edit changes (every removed and added line, its line break counted), step
+ * numbers taken out first, so one inserted step anywhere costs about its own length. `share` is of the file as it is.
+ */
+export function sizeGate(before, after) {
+    const d = lineDiff(unnumbered(before), unnumbered(after));
+    const chars = [...d.removed, ...d.added].reduce((n, l) => n + l.length + 1, 0);
+    const len = String(before ?? '').length;
+    const share = len ? chars / len : chars ? 1 : 0;
+    return { chars, share, ok: chars <= FOLD_MAX_CHARS && share <= FOLD_MAX_SHARE };
+}
+/** A printed line's length cap: a 2 MB line (a binary file, a minified blob) is cut, never printed whole (review). */
+const PRINT_MAX_LINE = 400;
+/**
+ * Control characters, bidi marks and line separators, printed as escapes (review): a file a person or a teammate
+ * edited can hold an ESC sequence (a terminal title, a clipboard write) or a right-to-left mark that shows other text
+ * than the bytes. Trail's own files never hold one (oneLine drops them), so a skill's text prints as it is.
+ */
+const UNSAFE = /[\u0000-\u0008\u000b-\u001f\u007f-\u009f\u061c\u200e\u200f\u2028\u2029\u202a-\u202e\u2066-\u2069\ufeff]/g;
+const escapeOne = (ch) => (ch === '\r' ? '\\r' : `\\u${ch.charCodeAt(0).toString(16).padStart(4, '0')}`);
+const shown = (line) => {
+    const t = line.length > PRINT_MAX_LINE * 2 ? line.slice(0, PRINT_MAX_LINE * 2) : line;
+    const e = t.replace(UNSAFE, escapeOne);
+    return e.length > PRINT_MAX_LINE || t.length < line.length ? `${e.slice(0, PRINT_MAX_LINE)}…` : e;
+};
+const range = (start, count) => `${count === 0 ? start : start + 1},${count}`;
+/**
+ * A unified diff (3 lines of context), at most `maxLines` lines with the more-lines line, step text as it is. '' when
+ * the texts are equal. Each line at most 400 characters, control characters and bidi marks as escapes (review). An empty `a` prints a new file: phase 3's `renderNewFileDiff` prints through it.
+ */
+export function printDiff(a, b, labels, maxLines = PRINT_MAX_LINES) {
+    const ops = editScript(a, b);
+    if (!ops.some((o) => o.kind !== '='))
+        return '';
+    // Each op with its place in a and b; hunks are runs of changes with the context around them, merged when they touch.
+    const at = [];
+    let ai = 0;
+    let bi = 0;
+    for (const o of ops) {
+        at.push({ ai, bi });
+        if (o.kind !== '+')
+            ai++;
+        if (o.kind !== '-')
+            bi++;
+    }
+    const out = [`--- ${oneLine(labels[0])}`, `+++ ${oneLine(labels[1])}`];
+    let k = 0;
+    while (k < ops.length) {
+        if (ops[k].kind === '=') {
+            k++;
+            continue;
+        }
+        const start = Math.max(0, k - CONTEXT);
+        let end = k;
+        for (;;) {
+            while (end < ops.length && ops[end].kind !== '=')
+                end++;
+            let gap = end;
+            while (gap < ops.length && ops[gap].kind === '=')
+                gap++;
+            if (gap < ops.length && gap - end <= CONTEXT * 2) {
+                end = gap;
+                continue;
+            }
+            end = Math.min(ops.length, end + CONTEXT);
+            break;
+        }
+        const part = ops.slice(start, end);
+        const aCount = part.filter((o) => o.kind !== '+').length;
+        const bCount = part.filter((o) => o.kind !== '-').length;
+        out.push(`@@ -${range(at[start].ai, aCount)} +${range(at[start].bi, bCount)} @@`);
+        for (const o of part)
+            out.push(`${o.kind === '=' ? ' ' : o.kind}${shown(o.line)}`);
+        k = end;
+    }
+    const max = Math.max(3, Math.floor(maxLines));
+    if (out.length <= max)
+        return out.join('\n');
+    return [...out.slice(0, max - 1), `… ${out.length - (max - 1)} more lines`].join('\n');
+}
+/** A Run line without its number: what the step is, so a renumber alone changes no line. */
+const stepKey = (s) => `${s.gated ? 'G ' : ''}${oneLine(s.cmd)}${s.wait ? ' (wait)' : s.bg ? ' (bg)' : ''}`;
+/** The Run lines a change touches, for "1 line changes": per hunk the larger of what goes and what comes. */
+export function runLinesChanged(before, after) {
+    const text = (c) => c.steps.map(stepKey).join('\n') + (c.steps.length ? '\n' : '');
+    return lineDiff(text(before), text(after)).hunks.reduce((n, h) => n + Math.max(h.del.length, h.add.length), 0);
+}
+//# sourceMappingURL=skill-diff.js.map

package/dist/skills/skill-diff.js.map

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

package/dist/skills/skill-file.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The `metadata.trail` value a takeaway skill gets: `s-` and 6 hex digits
+ * from its name. The same name always gets the same one, so a skill that is
+ * marked twice (on two machines) is marked alike.
+ */
+export declare function skillMark(name: string): string;
+/**
+ * Whether Trail may rewrite the SKILL.md `text` (front matter `data`, kept in
+ * the repo or on this machine): see the top of this file.
+ */
+export declare function trailOwned(text: string, data: Record<string, unknown>, where: "repo" | "home"): boolean;
+/**
+ * Rewrite `file` at `version` with `body`. In the front matter only
+ * `metadata.version` changes (an old top-level `version` moves there), and a
+ * skill without `metadata.trail` gets `mark`, so it stays Trail's once the old
+ * `version` line is gone. A BOM is dropped: the reference validator refuses
+ * one. False, and the file untouched, when its front matter can't be found.
+ */
+export declare function rewriteSkill(file: string, version: number, body: string, mark: string): boolean;
+/** `path`, or the nearest folder above it that is there (a dangling link counts as there). */
+export declare function nearestThere(path: string): string;
+/** Whether `path`, every link followed, is inside `root` (links followed too). False when either can't be resolved. */
+export declare function within(path: string, root: string): boolean;
+//# sourceMappingURL=skill-file.d.ts.map

package/dist/skills/skill-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-file.d.ts","sourceRoot":"","sources":["../../src/skills/skill-file.ts"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAsBD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CASvG;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO/F;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD;AAED,uHAAuH;AACvH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO1D"}

package/dist/skills/skill-file.js

@@ -0,0 +1,97 @@
+/**
+ * One SKILL.md on disk: whether it is Trail's to rewrite, and the rewrite.
+ *
+ * A skill is Trail's when its front matter says so (`metadata.trail`, the one
+ * key spec section 6 gives Trail), when it is kept on this machine in
+ * ~/.trail (only Trail writes there), or when an older Trail already versioned
+ * it with a top-level `version: 3` line. Trail never rewrites any other
+ * SKILL.md: a skill someone wrote by hand stays exactly as they wrote it, and
+ * its corrections reach the agent through `trail skills show` instead.
+ *
+ * The rewrite finds the front matter the way the reader does (gray-matter
+ * skips a BOM and spaces after a fence), keeps the file's line ends, and
+ * leaves the file alone when it can't find both fences, so a skill never
+ * loses its name or description to a rewrite.
+ *
+ * A skill file is read or written only where its links keep it inside its
+ * own root, the repo's checkout or ~/.trail (`within`).
+ */
+import { createHash } from "node:crypto";
+import { lstatSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, relative, sep } from "node:path";
+import { withMetadataVersion } from "./front-version.js";
+/**
+ * The `metadata.trail` value a takeaway skill gets: `s-` and 6 hex digits
+ * from its name. The same name always gets the same one, so a skill that is
+ * marked twice (on two machines) is marked alike.
+ */
+export function skillMark(name) {
+    return `s-${createHash("sha1").update(`skill:${name}`).digest("hex").slice(0, 6)}`;
+}
+/** Where `text`'s front matter is, or null when it doesn't open and close with a `---` line. */
+function front(text) {
+    const lines = text.replace(/^/, "").split(/\r?\n/);
+    const fence = (l) => l !== undefined && l.trimEnd() === "---";
+    if (!fence(lines[0]))
+        return null;
+    const close = lines.findIndex((l, i) => i > 0 && fence(l));
+    return close === -1 ? null : { lines, close, eol: text.includes("\r\n") ? "\r\n" : "\n" };
+}
+/** The line an older Trail wrote at the top level, and nothing a person would write by hand for a version ("1.0", "1.0.0"). */
+const OLD_VERSION_LINE = /^version:[ \t]*\d+[ \t]*$/;
+/**
+ * Whether Trail may rewrite the SKILL.md `text` (front matter `data`, kept in
+ * the repo or on this machine): see the top of this file.
+ */
+export function trailOwned(text, data, where) {
+    if (where === "home")
+        return true;
+    const meta = data.metadata;
+    if (typeof meta === "object" && meta !== null && !Array.isArray(meta)) {
+        const mark = meta.trail;
+        if (typeof mark === "string" && mark.trim())
+            return true;
+    }
+    const f = front(text);
+    return f !== null && f.lines.slice(1, f.close).some((l) => OLD_VERSION_LINE.test(l));
+}
+/**
+ * Rewrite `file` at `version` with `body`. In the front matter only
+ * `metadata.version` changes (an old top-level `version` moves there), and a
+ * skill without `metadata.trail` gets `mark`, so it stays Trail's once the old
+ * `version` line is gone. A BOM is dropped: the reference validator refuses
+ * one. False, and the file untouched, when its front matter can't be found.
+ */
+export function rewriteSkill(file, version, body, mark) {
+    const f = front(readFileSync(file, "utf8"));
+    if (!f)
+        return false;
+    const fm = withMetadataVersion(f.lines.slice(1, f.close), version, mark);
+    const text = `---\n${fm.join("\n")}\n---\n\n${body.trim()}\n`;
+    writeFileSync(file, f.eol === "\n" ? text : text.replace(/\r?\n/g, f.eol));
+    return true;
+}
+/** `path`, or the nearest folder above it that is there (a dangling link counts as there). */
+export function nearestThere(path) {
+    for (let p = path;; p = dirname(p)) {
+        try {
+            lstatSync(p);
+            return p;
+        }
+        catch {
+            if (dirname(p) === p)
+                return p;
+        }
+    }
+}
+/** Whether `path`, every link followed, is inside `root` (links followed too). False when either can't be resolved. */
+export function within(path, root) {
+    try {
+        const rel = relative(realpathSync(root), realpathSync(path));
+        return rel === "" || (rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=skill-file.js.map

package/dist/skills/skill-file.js.map

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

package/dist/skills/skill-rebuild.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A SKILL.md back to the CompiledSkill that renders it (phase 2 design 4.4,
+ * P11). A skill's fields depend on each other (the steps, `confirm-before`,
+ * `needs`, the check line's "Step N", `version`), so a fold never edits the
+ * text: it rebuilds the CompiledSkill, changes its steps and renders again.
+ * That is only safe when the renderer gives back exactly the file Trail
+ * wrote, so `rebuildCompiled` returns null unless the round trip is byte for
+ * byte. `rebuildLoose` reads a hand-edited file as Trail reads it, for a
+ * proposal beside it (4.6); nothing it returns is ever written over that file.
+ *
+ * Pure: no disk. The source and the helper names come from the caller (the
+ * skill's state and its scripts/ folder).
+ */
+import type { CompiledSkill, ParsedSkill, SkillState } from './types.js';
+/**
+ * A SKILL.md Trail wrote, back to the CompiledSkill that renders it. null unless renderSkillMd(result) === text exactly,
+ * or when `parsed` is not this text's parse. `helpers` are the names in scripts/ (content '': a fold never writes
+ * scripts/, 4.5); `runId` is the state's run, when the caller has it.
+ */
+export declare function rebuildCompiled(text: string, parsed: ParsedSkill, extra: {
+    source: SkillState['source'];
+    helpers: string[];
+    runId?: string | null;
+}): CompiledSkill | null;
+/** Same, without the exact round trip: for a proposal beside a hand-edited file (4.6). null when it has no steps. */
+export declare function rebuildLoose(text: string, parsed: ParsedSkill): CompiledSkill | null;
+//# sourceMappingURL=skill-rebuild.d.ts.map

package/dist/skills/skill-rebuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-rebuild.d.ts","sourceRoot":"","sources":["../../src/skills/skill-rebuild.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA8CzE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE;IAAE,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,aAAa,GAAG,IAAI,CAkB1K;AAED,qHAAqH;AACrH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,IAAI,CAQpF"}