@nanonets/graft 0.24.0 → 0.25.0

package/dist/skills/offers.js

@@ -0,0 +1,284 @@
+/**
+ * Skill offers (design 2.5, 4.12, 4.13, spec 9): the log of every offer
+ * shown and answered (`~/.trail/offers.jsonl`, the never-ask-again list), the
+ * budget every offer shares, and the bookkeeping an answer leaves.
+ *
+ * The budget, in this order: offers off (everywhere or in this repo), a repo
+ * paused after two nos, 1 offer per session, 1 in the first week after skills
+ * go on, 3 a week, never again after a no for that (repo, job), one more
+ * chance 14+ days after an ignored offer and then never, and the governor:
+ * when fewer than 1 in 3 of the last 9 answered offers were kept, a job has
+ * to come back one more day before it is offered.
+ *
+ * The log is the truth. `settings.json` keeps only the pause and a cache of
+ * the governor's window; only this file writes them (a static test pins it).
+ * The words of an offer and of the answers to it are in `offer-words.ts`.
+ */
+import { randomBytes } from 'node:crypto';
+import { localDate, noteGovernor, pauseRepo, readSettings } from './settings.js';
+import { appendPrivateLine, trailPath } from '../util/private-fs.js';
+import { readFileSync } from 'node:fs';
+export { answerDirective, endsWithLine, isKeepLine, keepLine, noticeText, offerLines, postToolOfferText, stopBlockReason, GOVERNOR_LINE, KEEP_IT, } from './offer-words.js';
+import { GOVERNOR_LINE } from './offer-words.js';
+const DAY_MS = 86_400_000;
+const WEEK_MS = 7 * DAY_MS;
+const IGNORED_AFTER_MS = DAY_MS;
+const SECOND_CHANCE_MS = 14 * DAY_MS;
+const PAUSE_DAYS = 14;
+const WEEK_CAP = 3;
+const GOVERNOR_WINDOW = 9;
+const EVENTS = new Set(['shown', 'answer', 'not-shown', 'closed']);
+/** Phase 2 (R2): moments 5 and 6 and the retire proposal are kept as themselves; a moment this file doesn't know is
+ *  written as 'repeated' (line below), so each new one must be listed here first. */
+const MOMENTS = new Set(['repeated', 'repaired', 'correction', 'update', 'drift', 'retire']);
+/** 2.4: what an answer line's yes chose. */
+const OPS = new Set(['update', 'extend', 'split', 'replace', 'retire']);
+const ANSWERS = new Set(['yes', 'no', 'show', 'none', 'withdrawn']);
+const CHANNELS = new Set(['stop', 'notice', 'post-tool']);
+/** <home>/offers.jsonl */
+export function offersPath(env) {
+    return trailPath(env, 'offers.jsonl');
+}
+const str = (v) => typeof v === 'string';
+function asLine(v) {
+    if (!v || typeof v !== 'object' || Array.isArray(v))
+        return null;
+    const l = v;
+    if (!str(l.id) || !str(l.at) || Number.isNaN(Date.parse(l.at)) || !EVENTS.has(l.event))
+        return null;
+    if (!str(l.repo) || !str(l.key) || !str(l.runId) || !str(l.name) || !CHANNELS.has(l.channel))
+        return null;
+    // 1b (4.20): a closed line is only ever init's, a no; every other line is an offer of moment 2, 3 or 4.
+    if (l.event === 'closed')
+        return l.moment === 'init' && l.answer === 'no' ? l : null;
+    if (!MOMENTS.has(l.moment))
+        return null;
+    if (l.event === 'answer' && !ANSWERS.has(l.answer))
+        return null;
+    // 2.4: an op outside the set is dropped, the line kept (its answer still counts).
+    if (Object.hasOwn(l, 'op') && !(l.event === 'answer' && OPS.has(l.op))) {
+        const { op: _op, ...rest } = l;
+        return rest;
+    }
+    return l;
+}
+export function readOffers(env) {
+    let text;
+    try {
+        text = readFileSync(offersPath(env), 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const raw of text.split('\n')) {
+        if (!raw.trim())
+            continue;
+        try {
+            const l = asLine(JSON.parse(raw));
+            if (l)
+                out.push(l);
+        }
+        catch { /* a bad line is skipped */ }
+    }
+    return out;
+}
+/**
+ * Folds 'shown' + 'answer' + 'not-shown' lines by id: one record per offer with its final answer. The record's
+ * `at` is when it was shown; `not-shown` (the agent left it out) wins over `shown`; the last answer wins.
+ */
+export function foldOffers(lines) {
+    const byId = new Map();
+    for (const l of lines) {
+        let r = byId.get(l.id);
+        if (r === undefined) {
+            const { answer: _a, ...base } = l;
+            r = { ...base, event: l.event === 'answer' ? 'shown' : l.event, answer: null };
+            byId.set(l.id, r);
+        }
+        if (l.event === 'not-shown' && r.event !== 'closed')
+            r.event = 'not-shown';
+        if (l.event === 'closed')
+            r.answer = 'no';
+        if (l.event === 'answer' && l.answer) {
+            r.answer = l.answer;
+            if (l.op)
+                r.op = l.op;
+        }
+    }
+    return [...byId.values()];
+}
+/** yes, no or none (an ignored offer: answered none, or shown and never answered for 24 h); null otherwise, and for init's closed lines. */
+function settled(r, now) {
+    if (r.event === 'closed')
+        return null; // "said no" for its key only (4.20, P10)
+    if (r.answer === 'yes' || r.answer === 'no' || r.answer === 'none')
+        return r.answer;
+    if (r.answer === null && r.event === 'shown' && now.getTime() - Date.parse(r.at) > IGNORED_AFTER_MS)
+        return 'none';
+    return null;
+}
+const byTime = (a, b) => Date.parse(a.at) - Date.parse(b.at);
+/** The governor's window: the last 9 offers that were kept, refused or ignored, oldest first. */
+function lastNine(records, now) {
+    return records.slice().sort(byTime).flatMap((r) => {
+        const s = settled(r, now);
+        return s ? [s] : [];
+    }).slice(-GOVERNOR_WINDOW);
+}
+const governorOn = (nine) => nine.length >= 3 && nine.filter((a) => a === 'yes').length * 3 < nine.length;
+/** 4.13, steps 1 to 8 in order. */
+export function offerBudget(c) {
+    const now = c.now ?? new Date();
+    const s = readSettings(c.env);
+    if (s.offers === 'off')
+        return { ok: false, why: 'off' };
+    if (s.offRepos.includes(c.repoKey))
+        return { ok: false, why: 'off-here' };
+    const until = s.pausedUntil[c.repoKey];
+    if (until && until > localDate(now))
+        return { ok: false, why: 'paused' };
+    if (c.sessionOfferUsed)
+        return { ok: false, why: 'session' };
+    const records = foldOffers(readOffers(c.env));
+    const shown = records.filter((r) => r.event === 'shown');
+    const since = s.onSince === null ? NaN : Date.parse(s.onSince);
+    if (!Number.isNaN(since) && now.getTime() - since < WEEK_MS && shown.some((r) => Date.parse(r.at) >= since))
+        return { ok: false, why: 'first-week' };
+    const weekAgo = now.getTime() - WEEK_MS;
+    if (shown.filter((r) => Date.parse(r.at) > weekAgo && Date.parse(r.at) <= now.getTime() + 5000).length >= WEEK_CAP)
+        return { ok: false, why: 'week' };
+    const mine = records.filter((r) => r.key === c.key);
+    if (mine.some((r) => r.answer === 'no'))
+        return { ok: false, why: 'said-no' };
+    const ignored = mine.filter((r) => settled(r, now) === 'none');
+    let secondChance = false;
+    if (ignored.length >= 2)
+        return { ok: false, why: 'no-answer-twice' };
+    if (ignored.length === 1) {
+        if (now.getTime() - Date.parse(ignored[0].at) < SECOND_CHANCE_MS)
+            return { ok: false, why: 'too-soon' };
+        secondChance = true;
+    }
+    return { ok: true, extraDay: governorOn(lastNine(records, now)), secondChance };
+}
+function line(o, repoKey, event, now, answer, op) {
+    const moment = MOMENTS.has(o.moment) ? o.moment : 'repeated';
+    const l = { id: o.offerId, at: now.toISOString(), event, repo: repoKey, key: o.key, moment, runId: o.runId, name: o.name, channel: o.channel };
+    if (answer)
+        l.answer = answer;
+    if (answer && op && OPS.has(op))
+        l.op = op;
+    return l;
+}
+function append(l, env) {
+    appendPrivateLine(offersPath(env), JSON.stringify(l));
+}
+/** The governor cache in settings.json: the window as it is now; said-at kept while the governor stays on. */
+function refreshGovernor(env, now, saidAt) {
+    const nine = lastNine(foldOffers(readOffers(env)), now);
+    const s = readSettings(env);
+    const keep = saidAt === undefined ? s.governorSaidAt : saidAt;
+    const next = governorOn(nine) ? keep : null;
+    if (JSON.stringify(s.lastNine) === JSON.stringify(nine) && s.governorSaidAt === next)
+        return;
+    try {
+        noteGovernor(nine, next, env);
+    }
+    catch { /* busy: the log stays the truth, the cache catches up next time */ }
+}
+export function recordShown(o, repoKey, env, now = new Date()) {
+    append(line(o, repoKey, 'shown', now), env);
+    refreshGovernor(env, now);
+}
+/** A stop or post-tool offer the agent left out: the session stays spent; the week and the governor ignore it. */
+export function recordNotShown(o, repoKey, env, now = new Date()) {
+    append(line(o, repoKey, 'not-shown', now), env);
+}
+/**
+ * Records the answer and refreshes settings.lastNine. The 2nd 'no' in a row in this repo pauses it 14 days.
+ * Phase 2 (2.4): `op` says which change a yes chose (a fold op, drift's 'replace', or 'retire'); `answer` stays 1a's.
+ */
+export function recordAnswer(o, repoKey, a, env, now = new Date(), op) {
+    const before = a === 'no' ? foldOffers(readOffers(env)) : [];
+    append(line(o, repoKey, 'answer', now, a, op), env);
+    refreshGovernor(env, now);
+    if (a !== 'no')
+        return { paused: false, firstNo: false };
+    const firstNo = !before.some((r) => r.answer === 'no' && r.event !== 'closed' && r.id !== o.offerId);
+    const here = foldOffers(readOffers(env)).filter((r) => r.repo === repoKey).sort(byTime).filter((r) => settled(r, now) !== null);
+    const lastTwo = here.slice(-2);
+    if (lastTwo.length < 2 || !lastTwo.every((r) => settled(r, now) === 'no'))
+        return { paused: false, firstNo };
+    try {
+        pauseRepo(repoKey, new Date(now.getTime() + PAUSE_DAYS * DAY_MS), env);
+    }
+    catch {
+        return { paused: false, firstNo }; // not written: not said
+    }
+    return { paused: true, firstNo };
+}
+/**
+ * For `trail skills` (2.10): the governor line the first time it is printed while the governor is on (records
+ * governorSaidAt through noteGovernor); null otherwise. noteGovernor clears governorSaidAt when the governor turns
+ * off, so it is said again next time.
+ */
+export function governorLine(env, now = new Date()) {
+    const nine = lastNine(foldOffers(readOffers(env)), now);
+    const s = readSettings(env);
+    if (!governorOn(nine)) {
+        if (s.governorSaidAt !== null || JSON.stringify(s.lastNine) !== JSON.stringify(nine))
+            refreshGovernor(env, now, null);
+        return null;
+    }
+    if (s.governorSaidAt !== null)
+        return null;
+    try {
+        noteGovernor(nine, now.toISOString(), env);
+    }
+    catch {
+        return null; // not recorded: say it next time instead of twice
+    }
+    return GOVERNOR_LINE;
+}
+/**
+ * Init's `closed` line (2.4, 4.20, R53): an item the person was shown at `trail init` and didn't keep. It counts as
+ * "said no" for `key` forever, and for nothing else: not the session, the week, the first week, the pause or the
+ * governor (P10). Its only writer; b6 calls it for each skill key init closes.
+ */
+export function recordInitClosed(repoKey, key, env, now = new Date()) {
+    append({
+        id: `o-init-${randomBytes(2).toString('hex')}`, at: now.toISOString(), event: 'closed', repo: repoKey, key, moment: 'init', runId: '', name: '',
+        channel: 'stop', answer: 'no',
+    }, env);
+}
+/* Keys (2.4, 4.10, P8, P13). Moments 5 and 6 are keyed per version, so a no is never asked again for that version and
+ * a new version (only after a yes, an adopted hand edit or a restore) may be offered again; the retire proposal is
+ * once per skill, ever. A key names a skill, never a repo: the offer's `repo` (1b) says where it was made. */
+const KEY_PART = /^[^|\s]{1,200}$/;
+function keyPart(skillId) {
+    if (!KEY_PART.test(String(skillId)))
+        throw new Error('trail: not a skill id for an offer key');
+    return skillId;
+}
+function keyVersion(version) {
+    if (!Number.isSafeInteger(version) || version < 1)
+        throw new Error('trail: not a skill version for an offer key');
+    return version;
+}
+/** Moment 5's key: `<skillId>|update|v<n>`. */
+export const updateOfferKey = (skillId, version) => `${keyPart(skillId)}|update|v${keyVersion(version)}`;
+/** Moment 6's key: `<skillId>|drift|v<n>`. */
+export const driftOfferKey = (skillId, version) => `${keyPart(skillId)}|drift|v${keyVersion(version)}`;
+/** The retire proposal's key: `<skillId>|retire`. */
+export const retireOfferKey = (skillId) => `${keyPart(skillId)}|retire`;
+const SKILL_KEY = /^([^|\s]{1,200})\|(?:correction|update\|v[1-9]\d*|drift\|v[1-9]\d*|retire)$/;
+/** The skill a skill-keyed offer names (moments 4, 5, 6 and the retire proposal); null for a repo-keyed one (2, 3). */
+export function skillOfOfferKey(key) {
+    return SKILL_KEY.exec(String(key))?.[1] ?? null;
+}
+/** 'o-' + 6 hex */
+export function newOfferId() {
+    return `o-${randomBytes(3).toString('hex')}`;
+}
+//# sourceMappingURL=offers.js.map

package/dist/skills/offers.js.map

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

package/dist/skills/own-folder.d.ts

@@ -0,0 +1,9 @@
+/** The folders Trail keeps its skill files in. */
+export declare const OWN_FOLDERS: readonly ["skills", "state", "ledger", "held", string];
+/** True when `dir` is a symbolic link (a missing folder is not one). */
+export declare function isLinked(dir: string): boolean;
+/** The first of Trail's own folders that is a link, relative to the home, or null. */
+export declare function linkedOwnFolder(env?: NodeJS.ProcessEnv): string | null;
+/** Throws when `dir` is a link: the message names it, so the person can see what was planted. */
+export declare function ownFolder(dir: string): void;
+//# sourceMappingURL=own-folder.d.ts.map

package/dist/skills/own-folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-folder.d.ts","sourceRoot":"","sources":["../../src/skills/own-folder.ts"],"names":[],"mappings":"AAeA,kDAAkD;AAClD,eAAO,MAAM,WAAW,wDAA6E,CAAC;AAEtG,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAM7C;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,CAGtE;AAED,iGAAiG;AACjG,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3C"}

package/dist/skills/own-folder.js

@@ -0,0 +1,36 @@
+/**
+ * Trail's own folders under its home (`skills`, `state`, `ledger`, `held`,
+ * `skills/.retired`) are folders Trail made. A link in place of one was
+ * planted (an agent with a shell can do it in one command), and writing
+ * through it would put the person's skills, counts or ledger wherever it
+ * points, a repo included, and chmod that folder 0700. So a write refuses a
+ * folder that is a link. The Trail home itself may be a link (a person's
+ * dotfiles); only the folders inside it are checked.
+ *
+ * Node builtins only.
+ */
+import { lstatSync } from 'node:fs';
+import { join } from 'node:path';
+import { trailHome } from '../notes/trail-home.js';
+/** The folders Trail keeps its skill files in. */
+export const OWN_FOLDERS = ['skills', 'state', 'ledger', 'held', join('skills', '.retired')];
+/** True when `dir` is a symbolic link (a missing folder is not one). */
+export function isLinked(dir) {
+    try {
+        return lstatSync(dir).isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+/** The first of Trail's own folders that is a link, relative to the home, or null. */
+export function linkedOwnFolder(env) {
+    const home = trailHome(env ?? process.env);
+    return OWN_FOLDERS.find((f) => isLinked(join(home, f))) ?? null;
+}
+/** Throws when `dir` is a link: the message names it, so the person can see what was planted. */
+export function ownFolder(dir) {
+    if (isLinked(dir))
+        throw new Error(`trail: ${dir} is a link, not Trail's own folder; Trail won't write through it. Remove the link to go on.`);
+}
+//# sourceMappingURL=own-folder.js.map

package/dist/skills/own-folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-folder.js","sourceRoot":"","sources":["../../src/skills/own-folder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,kDAAkD;AAClD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAU,CAAC;AAEtG,wEAAwE;AACxE,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAAC,GAAuB;IACrD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAClE,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,QAAQ,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,GAAG,6FAA6F,CAAC,CAAC;AACjJ,CAAC"}

package/dist/skills/person.d.ts

@@ -0,0 +1,34 @@
+export interface PersonCheck {
+    ok: boolean;
+    tty: boolean;
+    claudeCodeEnv: boolean;
+    claudeAncestor: boolean;
+}
+/** One row of the process table: `comm` is the executable (a full path on macOS), `args` the command line. */
+export interface PsRow {
+    pid: number;
+    ppid: number;
+    comm: string;
+    args: string;
+}
+/** Seams for tests: the TTYs, the process table, and the process to start from. */
+export interface PersonDeps {
+    stdinTTY?: boolean;
+    stdoutTTY?: boolean;
+    ps?: () => PsRow[] | null;
+    pid?: number;
+}
+/** An agent's CLI (Claude Code's, Codex's) or a pty wrapper. */
+export declare function isAgentProcess(r: PsRow): boolean;
+/** True when an agent process is among the 12 above `pid`, or when `pid` isn't in the table (can't tell). */
+export declare function agentAncestor(rows: PsRow[], pid: number): boolean;
+/** The whole process table from `ps` at its own path (never from PATH, which a caller sets), or null. */
+export declare function readProcessTable(): PsRow[] | null;
+/**
+ * stdin and stdout are TTYs, CLAUDECODE is unset, and no ancestor process (ps, up to 12 levels) is the claude CLI
+ * (basename exactly `claude`, or node running an `@anthropic-ai/claude-code` cli) or a pty wrapper an agent could use
+ * (`script`, `expect`, `unbuffer`, python running `pty`). The desktop app (`Claude`, capital C) is not the CLI, so its
+ * terminal panel counts as the person's.
+ */
+export declare function personAtTerminal(env?: NodeJS.ProcessEnv, deps?: PersonDeps): PersonCheck;
+//# sourceMappingURL=person.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"person.d.ts","sourceRoot":"","sources":["../../src/skills/person.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,WAAW;IAAG,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE;AAC3G,8GAA8G;AAC9G,MAAM,WAAW,KAAK;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAChF,mFAAmF;AACnF,MAAM,WAAW,UAAU;IAAG,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,KAAK,EAAE,GAAG,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE;AAYhH,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAQhD;AAED,6GAA6G;AAC7G,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAYjE;AAID,yGAAyG;AACzG,wBAAgB,gBAAgB,IAAI,KAAK,EAAE,GAAG,IAAI,CAqBjD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,GAAE,UAAe,GAAG,WAAW,CAMzG"}

package/dist/skills/person.js

@@ -0,0 +1,102 @@
+/**
+ * Is the person at their own terminal (design 1.4 `personAtTerminal`)?
+ * `trail skills keep`, `skills on` and `offers on` are the person's: an
+ * agent that runs them is refused before they run (the agent guard), and the
+ * CLI checks again here.
+ *
+ * The person: stdin and stdout are TTYs, CLAUDECODE is unset, and no process
+ * above this one (up to 12 levels) is an agent's CLI (a program named exactly
+ * `claude`, or node running `@anthropic-ai/claude-code`; Codex's `codex`, its
+ * `codex-<target>` builds, or node running `@openai/codex`, whose exec tool can
+ * give a command a terminal) or a pty wrapper an agent could use to fake a
+ * terminal (`script`, `expect`, `unbuffer`, python running `pty`). The desktop
+ * apps are `Claude` and `Codex`, with a capital C: their own windows are the
+ * person's. (`claudeAncestor` keeps its 1a name: any agent ancestor.)
+ *
+ * When the process table can't be read, the answer is no: a person can run
+ * the command again, an agent must not get through on an error.
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { basename } from 'node:path';
+const LEVELS = 12;
+const PTY_WRAPPERS = new Set(['script', 'expect', 'unbuffer']);
+/** `python3`, and the macOS framework builds (Homebrew's, Xcode's), which run as `Python`. */
+const PYTHON = /^python[\d.]*$/i;
+const NODE = /^(?:node|nodejs|bun)(?:\.exe)?$/;
+const firstWord = (args) => args.trim().split(/\s+/)[0] ?? '';
+/** Codex's CLI: `codex`, and the per-target builds its npm package ships (`codex-x86_64-unknown-linux-musl`). */
+const CODEX = /^codex(?:-(?:aarch64|x86_64|arm64|amd64)-[\w-]{1,60})?(?:\.exe)?$/;
+/** An agent's CLI (Claude Code's, Codex's) or a pty wrapper. */
+export function isAgentProcess(r) {
+    const exe = basename(r.comm.trim());
+    const argv0 = basename(firstWord(r.args));
+    if (exe === 'claude' || argv0 === 'claude')
+        return true;
+    if (CODEX.test(exe) || CODEX.test(argv0))
+        return true;
+    if (NODE.test(exe) && /@anthropic-ai[/\\]claude-code\b|@openai[/\\]codex\b/.test(r.args))
+        return true;
+    if (PTY_WRAPPERS.has(exe) || PTY_WRAPPERS.has(argv0))
+        return true;
+    return (PYTHON.test(exe) || PYTHON.test(argv0)) && /\bpty\b/.test(r.args);
+}
+/** True when an agent process is among the 12 above `pid`, or when `pid` isn't in the table (can't tell). */
+export function agentAncestor(rows, pid) {
+    const byPid = new Map(rows.map((r) => [r.pid, r]));
+    const self = byPid.get(pid);
+    if (!self)
+        return true;
+    let at = self.ppid;
+    for (let level = 0; level < LEVELS && at > 1; level++) {
+        const r = byPid.get(at);
+        if (!r)
+            break;
+        if (isAgentProcess(r))
+            return true;
+        at = r.ppid;
+    }
+    return false;
+}
+const PS = ['/bin/ps', '/usr/bin/ps'];
+/** The whole process table from `ps` at its own path (never from PATH, which a caller sets), or null. */
+export function readProcessTable() {
+    const ps = PS.find((p) => existsSync(p));
+    if (!ps || process.platform === 'win32')
+        return null;
+    const run = (fields) => execFileSync(ps, ['-A', '-o', fields], {
+        encoding: 'utf8', timeout: 3000, maxBuffer: 16 * 1024 * 1024, stdio: ['ignore', 'pipe', 'ignore'], env: { LC_ALL: 'C', PATH: '/usr/bin:/bin' },
+    });
+    try {
+        const rows = new Map();
+        for (const line of run('pid=,ppid=,comm=').split('\n')) {
+            const m = /^\s*(\d+)\s+(\d+)\s(.*)$/.exec(line);
+            if (m)
+                rows.set(Number(m[1]), { pid: Number(m[1]), ppid: Number(m[2]), comm: m[3].trim(), args: '' });
+        }
+        for (const line of run('pid=,args=').split('\n')) {
+            const m = /^\s*(\d+)\s(.*)$/.exec(line);
+            const r = m ? rows.get(Number(m[1])) : undefined;
+            if (r)
+                r.args = m[2].trim();
+        }
+        return rows.size ? [...rows.values()] : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * stdin and stdout are TTYs, CLAUDECODE is unset, and no ancestor process (ps, up to 12 levels) is the claude CLI
+ * (basename exactly `claude`, or node running an `@anthropic-ai/claude-code` cli) or a pty wrapper an agent could use
+ * (`script`, `expect`, `unbuffer`, python running `pty`). The desktop app (`Claude`, capital C) is not the CLI, so its
+ * terminal panel counts as the person's.
+ */
+export function personAtTerminal(env = process.env, deps = {}) {
+    const tty = (deps.stdinTTY ?? process.stdin.isTTY === true) && (deps.stdoutTTY ?? process.stdout.isTTY === true);
+    const claudeCodeEnv = env.CLAUDECODE !== undefined;
+    const rows = (deps.ps ?? readProcessTable)();
+    const claudeAncestor = rows === null ? true : agentAncestor(rows, deps.pid ?? process.pid);
+    return { ok: tty && !claudeCodeEnv && !claudeAncestor, tty, claudeCodeEnv, claudeAncestor };
+}
+//# sourceMappingURL=person.js.map

package/dist/skills/person.js.map

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

package/dist/skills/probe-clean.d.ts

@@ -0,0 +1,9 @@
+type Git = (args: string[], cwd: string, timeoutMs: number) => {
+    code: number | null;
+    out: string;
+    timedOut: boolean;
+};
+/** Whether every change `git status --porcelain` printed is a path init wrote here and nobody changed since. */
+export declare function onlyTrailChanges(out: string, checkout: string, git: Git, timeoutMs: number, env?: NodeJS.ProcessEnv): boolean;
+export {};
+//# sourceMappingURL=probe-clean.d.ts.map

package/dist/skills/probe-clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-clean.d.ts","sourceRoot":"","sources":["../../src/skills/probe-clean.ts"],"names":[],"mappings":"AAcA,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAYvH,gHAAgH;AAChH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAiB1I"}

package/dist/skills/probe-clean.js

@@ -0,0 +1,48 @@
+/**
+ * D120 (2), replacing D116 item 4's pattern: the clean-tree ready probe leaves
+ * out exactly the paths `trail init` recorded writing in this checkout (its
+ * install record, src/init/install-record.ts), and only while each still holds
+ * what init wrote. So a repo whose wiring isn't committed yet doesn't open every
+ * run block with "Uncommitted changes here", and any later edit to one of those
+ * files, the person's own settings changes included, blocks again. Anything
+ * init never wrote blocks, in `.trail/` too. No record: nothing is left out.
+ * Read only: `git status --porcelain` output, one more `git status` per
+ * untracked folder (to list its files the way git sees them), the record, and
+ * the hashes of the files it names.
+ */
+import { initLeftIt, readInstallRecord } from '../init/install-record.js';
+/** The paths of `git status --porcelain` lines (both sides of a rename, quotes left on: such a path is never init's). */
+function statusPaths(out) {
+    const paths = [];
+    for (const line of out.split('\n')) {
+        if (line.length < 4)
+            continue;
+        paths.push(...line.slice(3).split(' -> '));
+    }
+    return paths;
+}
+/** Whether every change `git status --porcelain` printed is a path init wrote here and nobody changed since. */
+export function onlyTrailChanges(out, checkout, git, timeoutMs, env = process.env) {
+    const paths = statusPaths(out);
+    if (!paths.length)
+        return false;
+    const files = readInstallRecord(checkout, env);
+    if (!files)
+        return false;
+    for (const p of paths) {
+        if (!p.endsWith('/')) {
+            if (!initLeftIt(files, checkout, p))
+                return false;
+            continue;
+        }
+        // An untracked folder is shown whole: list its files as git sees them (ignored ones left out).
+        const inside = git(['status', '--porcelain', '--untracked-files=all', '--', p], checkout, timeoutMs);
+        if (inside.timedOut || inside.code !== 0)
+            return false;
+        const rels = statusPaths(inside.out);
+        if (!rels.length || rels.length > 64 || rels.some((r) => !initLeftIt(files, checkout, r)))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=probe-clean.js.map

package/dist/skills/probe-clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-clean.js","sourceRoot":"","sources":["../../src/skills/probe-clean.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAI1E,yHAAyH;AACzH,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,QAAgB,EAAE,GAAQ,EAAE,SAAiB,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC/H,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;YAClD,SAAS;QACX,CAAC;QACD,+FAA+F;QAC/F,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACrG,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACvD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAC1G,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/skills/probes.d.ts

@@ -0,0 +1,26 @@
+import type { ParsedSkill } from './types.js';
+export interface ProbeResult {
+    probe: string;
+    ok: boolean;
+    why?: string;
+    fix?: string;
+}
+/** What runs git for a probe; tests stub it. `code` null when it didn't finish. */
+export type ProbeGit = (args: string[], cwd: string, timeoutMs: number) => {
+    code: number | null;
+    out: string;
+    timedOut: boolean;
+};
+export interface ProbeOpts {
+    /** At most 300; the prompt hook passes what its deadline leaves. */
+    budgetMs?: number;
+    git?: ProbeGit;
+}
+export declare const PROBE_BUDGET_MS = 300;
+/** The probes of a skill's `ready` line, in order. */
+export declare function readyProbes(s: Pick<ParsedSkill, 'meta'>): string[];
+/** A passed probe in words, for the run block's ready line; null for a form that never runs. */
+export declare function probePassWords(probe: string): string | null;
+/** Allowlisted local probes only, without a shell, 300 ms total, cached 10 min in <home>/state/probes.json keyed by checkout+probe. */
+export declare function runProbes(s: ParsedSkill, checkout: string, now?: Date, env?: NodeJS.ProcessEnv, opts?: ProbeOpts): ProbeResult[];
+//# sourceMappingURL=probes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"probes.d.ts","sourceRoot":"","sources":["../../src/skills/probes.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,MAAM,WAAW,WAAW;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE;AAEvF,mFAAmF;AACnF,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AACnI,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAED,eAAO,MAAM,eAAe,MAAM,CAAC;AAgCnC,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAElE;AAID,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU3D;AA6GD,uIAAuI;AACvI,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,GAAE,SAAc,GAAG,WAAW,EAAE,CA4B7J"}