@nanonets/graft 0.24.0 → 0.24.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"save-parse.d.ts","sourceRoot":"","sources":["../../src/skills/save-parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE;AAE9E,6FAA6F;AAC7F,eAAO,MAAM,aAAa,QAAqB,CAAC;AAgDhD,gHAAgH;AAChH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA0BnE;AAID,MAAM,WAAW,eAAe;IAAG,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE;AAE3F,uHAAuH;AACvH,eAAO,MAAM,gBAAgB,QAAwB,CAAC;AAEtD,kGAAkG;AAClG,eAAO,MAAM,YAAY,QAAuC,CAAC;AAEjE,wHAAwH;AACxH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA0BzE;AAID,MAAM,WAAW,eAAe;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAElE,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,QAAwB,CAAC;AAWtD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAmBzE"}

package/dist/skills/save-parse.js

@@ -0,0 +1,172 @@
+/**
+ * Reading a `trail skills add` command (design 4.9 step 1), whatever runs it:
+ * `trail`, `graft`, `npx @trailhq/trail-code`, `node .../trail.js`,
+ * `bash -c "..."`, `eval`, an alias or xargs. `skills add` anywhere in the
+ * command is an add; it must read as exactly `skills add <name> --run <id>`,
+ * once. Re-exported from `save-gate.ts`, where the design names it.
+ *
+ * Phase 2 (4.11): `trail skills update <name> --offer <id>`, read stricter
+ * still: nothing chained and no root options, since its gate writes a file.
+ */
+import { leadingCds, onlyTrail, simpleCommands } from '../trace/shell.js';
+/** /\bskills\s+add\b/: anywhere in the command, whatever binary, wrapper or path runs it. */
+export const SKILLS_ADD_RE = /\bskills\s+add\b/;
+const ALL_ADDS = /\bskills\s+add\b/g;
+/** Where the add's own words end, outside quotes: the next command, a redirect, a comment, a subshell's end. */
+const STOP = new Set([';', '&', '|', ')', '<', '>', '\n', '\r', '`']);
+/** The words after `skills add`, up to the end of that command. A quote never closed ends it (the close of `bash -c "..."`). */
+function tailWords(tail) {
+    const out = [];
+    let cur = '';
+    let has = false;
+    const flush = () => {
+        if (has)
+            out.push(cur);
+        cur = '';
+        has = false;
+    };
+    for (let i = 0; i < tail.length; i++) {
+        const ch = tail[i];
+        if (ch === '"' || ch === "'") {
+            const end = tail.indexOf(ch, i + 1);
+            if (end < 0)
+                break;
+            cur += tail.slice(i + 1, end);
+            has = true;
+            i = end;
+            continue;
+        }
+        if (ch === '\\' && i + 1 < tail.length && tail[i + 1] !== '\n') {
+            cur += tail[i + 1];
+            has = true;
+            i++;
+            continue;
+        }
+        if (STOP.has(ch)) {
+            // `2>&1`: digits right before a redirect are the redirect's, not a word.
+            if ((ch === '>' || ch === '<') && /^\d+$/.test(cur))
+                has = false;
+            break;
+        }
+        if (ch === '#' && !has)
+            break;
+        if (ch === ' ' || ch === '\t') {
+            flush();
+            continue;
+        }
+        cur += ch;
+        has = true;
+    }
+    flush();
+    return out;
+}
+/** null when the command doesn't parse as `<anything> skills add <name> --run <id>`, or adds more than once. */
+export function parseSkillsAdd(command) {
+    const text = String(command ?? '');
+    const hits = [...text.matchAll(ALL_ADDS)];
+    if (hits.length !== 1)
+        return null;
+    const words = tailWords(text.slice(hits[0].index + hits[0][0].length));
+    let name = null;
+    let runId = null;
+    const flags = [];
+    for (let i = 0; i < words.length; i++) {
+        const w = words[i];
+        if (w === '--run' && runId === null && i + 1 < words.length) {
+            runId = words[++i];
+            continue;
+        }
+        if (w.startsWith('--run=') && runId === null) {
+            runId = w.slice(6);
+            continue;
+        }
+        if (!w.startsWith('-') && name === null) {
+            name = w;
+            continue;
+        }
+        flags.push(w);
+    }
+    if (name === null || runId === null || !runId)
+        return null;
+    return { name, runId, flags };
+}
+/** /\bskills\s+lesson\b/: anywhere in the command, whatever runs it (the lesson gate, R12's twin of SKILLS_ADD_RE). */
+export const SKILLS_LESSON_RE = /\bskills\s+lesson\b/;
+const ALL_LESSONS = /\bskills\s+lesson\b/g;
+/** Every save the gate guards: a skill's add, a lesson's keep, and (phase 2) a skill's update. */
+export const SAVE_GATE_RE = /\bskills\s+(?:add|lesson|update)\b/;
+/** null when the command doesn't parse as `<anything> skills lesson [<skill>] --offer <id>`, or keeps more than one. */
+export function parseSkillsLesson(command) {
+    const text = String(command ?? '');
+    const hits = [...text.matchAll(ALL_LESSONS)];
+    if (hits.length !== 1 || [...text.matchAll(ALL_ADDS)].length)
+        return null;
+    const words = tailWords(text.slice(hits[0].index + hits[0][0].length));
+    let skill = null;
+    let offerId = null;
+    const flags = [];
+    for (let i = 0; i < words.length; i++) {
+        const w = words[i];
+        if (w === '--offer' && offerId === null && i + 1 < words.length) {
+            offerId = words[++i];
+            continue;
+        }
+        if (w.startsWith('--offer=') && offerId === null) {
+            offerId = w.slice(8);
+            continue;
+        }
+        if (!w.startsWith('-') && skill === null && offerId === null) {
+            skill = w;
+            continue;
+        }
+        flags.push(w);
+    }
+    if (!offerId)
+        return null;
+    return { skill, offerId, flags };
+}
+/** /\bskills\s+update\b/: anywhere in the command, whatever runs it. */
+export const SKILLS_UPDATE_RE = /\bskills\s+update\b/;
+const ALL_UPDATES = /\bskills\s+update\b/g;
+/** Past this the command is not read (D89). */
+const UPDATE_MAX = 64 * 1024;
+/** What comes right before `skills update`: a Trail binary, nothing between it and `skills` (no root option). */
+const TRAIL_BIN = /(?:^|[\s/"'(])(?:trail|graft|trail-code|@trailhq\/trail-code|@nanonets\/graft|(?:trail|graft)\.js)\s+$/;
+const SKILL_NAME = /^[a-z0-9][a-z0-9-]{0,63}$/;
+const OFFER_ID = /^o-[0-9a-f]{6}$/;
+/** A pipe (not `||`): its other side could cut or rewrite what the update prints. */
+const PIPE = /(?:^|[^|])\|(?!\|)/;
+/**
+ * null unless the command is exactly one `<trail> skills update <name> --offer <o-id>`, Trail's own and nothing
+ * else (1a's `onlyTrail`, one simple command after any leading cds, no pipe), with no other add, lesson or update.
+ */
+export function parseSkillsUpdate(command) {
+    const text = String(command ?? '');
+    if (text.length > UPDATE_MAX)
+        return null;
+    const hits = [...text.matchAll(ALL_UPDATES)];
+    if (hits.length !== 1 || SKILLS_ADD_RE.test(text) || SKILLS_LESSON_RE.test(text))
+        return null;
+    if (!TRAIL_BIN.test(text.slice(Math.max(0, hits[0].index - 200), hits[0].index)))
+        return null;
+    if (PIPE.test(text) || !onlyTrail(text) || simpleCommands(leadingCds(text).rest).length !== 1)
+        return null;
+    const words = tailWords(text.slice(hits[0].index + hits[0][0].length));
+    let name = null;
+    let offerId = null;
+    for (let i = 0; i < words.length; i++) {
+        const w = words[i];
+        if (w === '--offer' && offerId === null && i + 1 < words.length)
+            offerId = words[++i];
+        else if (w.startsWith('--offer=') && offerId === null)
+            offerId = w.slice(8);
+        else if (!w.startsWith('-') && name === null)
+            name = w;
+        else
+            return null;
+    }
+    if (!name || !offerId || !SKILL_NAME.test(name) || !OFFER_ID.test(offerId))
+        return null;
+    return { name, offerId };
+}
+//# sourceMappingURL=save-parse.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * What the save gate reads from the skill store (g4), without changing it:
+ * where a name is taken, which runs are already kept, and the run a held
+ * item was kept from (D65: a live save for the same run replaces it).
+ */
+import type { SkillState } from './types.js';
+export { nameTaken } from './store.js';
+/** The skills state's entries; {} when it can't be read. */
+export declare function readSkillsStateSafe(env?: NodeJS.ProcessEnv): Record<string, SkillState>;
+/** The run id a held item of this name was kept from (`HeldItem.runId`); null when there is none or it doesn't say. */
+export declare function heldRunId(name: string, env?: NodeJS.ProcessEnv): string | null;
+//# sourceMappingURL=save-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"save-store.d.ts","sourceRoot":"","sources":["../../src/skills/save-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAMvF;AAED,uHAAuH;AACvH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAM9E"}

package/dist/skills/save-store.js

@@ -0,0 +1,22 @@
+import { allHeld } from './store-held.js';
+import { readSkillsState } from './state.js';
+export { nameTaken } from './store.js';
+/** The skills state's entries; {} when it can't be read. */
+export function readSkillsStateSafe(env) {
+    try {
+        return readSkillsState(env).skills;
+    }
+    catch {
+        return {};
+    }
+}
+/** The run id a held item of this name was kept from (`HeldItem.runId`); null when there is none or it doesn't say. */
+export function heldRunId(name, env) {
+    try {
+        return allHeld(env).find((h) => h.name === name)?.runId ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=save-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"save-store.js","sourceRoot":"","sources":["../../src/skills/save-store.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,GAAuB;IACzD,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAuB;IAC7D,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/skills/settings.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `~/.trail/settings.json`: learned skills on or off (off by default), offers
+ * on or off (everywhere or per repo), pauses after two nos, skills a person
+ * turned off, and the governor's cache.
+ *
+ * Who may change what is fixed: only the person's own commands (the setters,
+ * imported only by `skills/cli-skills.ts`) turn skills and offers on or off;
+ * only the offer bookkeeping (`skills/offers.ts`) writes pauses and the
+ * governor. `trail init`, upgrades and `trail connect` never write this file.
+ * A test pins who imports what.
+ *
+ * A missing or broken file reads as the defaults. Keys a later version adds
+ * are kept on every write.
+ */
+import type { TrailSkillSettings } from './types.js';
+export { isTestHome, labInteractive } from './host-facts.js';
+export declare const DEFAULT_SETTINGS: TrailSkillSettings;
+/** Defaults on a missing or bad file; unknown keys are kept on every write. */
+export declare function readSettings(env?: NodeJS.ProcessEnv): TrailSkillSettings;
+/** TRAIL_TEST_NOW (ISO) in a test home only; else new Date(). */
+export declare function trailNow(env?: NodeJS.ProcessEnv): Date;
+/** The local calendar date `YYYY-MM-DD` of a time: days (pauses, session-days, last worked) are the person's days. */
+export declare function localDate(at: Date | string): string;
+/** onSince = now when it turns on. */
+export declare function setSkills(on: boolean, env?: NodeJS.ProcessEnv, now?: Date): TrailSkillSettings;
+/** here: adds or removes that repo key in offRepos; a global off sets offersOffAt. */
+export declare function setOffers(on: boolean, here: string | null, env?: NodeJS.ProcessEnv, now?: Date): TrailSkillSettings;
+export declare function setSkillOff(name: string, off: boolean, env?: NodeJS.ProcessEnv): TrailSkillSettings;
+export declare function pauseRepo(repoKey: string, until: Date, env?: NodeJS.ProcessEnv): TrailSkillSettings;
+export declare function noteGovernor(lastNine: Array<'yes' | 'no' | 'none'>, saidAt: string | null, env?: NodeJS.ProcessEnv): TrailSkillSettings;
+export declare function skillsOn(env?: NodeJS.ProcessEnv): boolean;
+export declare function offersHere(repoKey: string, now?: Date, env?: NodeJS.ProcessEnv): {
+    ok: true;
+} | {
+    ok: false;
+    why: 'off' | 'off-here' | 'paused';
+};
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/skills/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE7D,eAAO,MAAM,gBAAgB,EAAE,kBAIP,CAAC;AAmCzB,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAExE;AAiBD,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAOnE;AAED,sHAAsH;AACtH,wBAAgB,SAAS,CAAC,EAAE,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAInD;AAID,sCAAsC;AACtC,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,kBAAkB,CAK1G;AAED,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,kBAAkB,CAW/H;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAKnG;AAID,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAInG;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAKvI;AAED,wBAAgB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAEzD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAA;CAAE,CAO7J"}

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

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