@nanonets/graft 0.24.0 → 0.25.0

package/dist/skills/receipts.js

@@ -0,0 +1,223 @@
+/**
+ * Receipts (design 2.7, 4.9): what the PreToolUse save gate decided about one
+ * `trail skills add`, for the CLI that runs right after it. One per session
+ * (`~/.trail/receipts/<session-id>.json`), replaced by the next add, found
+ * only for its run and name while fresh, and used once: the CLI sets `usedAt`
+ * when it acts on it, and a used receipt never counts again.
+ *
+ * A receipt is a hint, never proof. The CLI re-decides from the transcript
+ * (4.9 CLI half); a receipt the agent wrote itself is caught there.
+ *
+ * `lineAt` is the one positioned read the gate makes of the transcript: the
+ * line that starts at a byte offset the fold recorded, so the gate checks the
+ * person's typed line and each step's call and result without reading the
+ * whole file.
+ */
+import { createHash } from 'node:crypto';
+import { closeSync, lstatSync, openSync, readdirSync, readSync, realpathSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { readJsonSafe, trailPath, withLock, writePrivate } from '../util/private-fs.js';
+import { sessionPath } from '../trace/gate-file.js';
+import { dialectFor } from '../trace/dialect.js';
+/** A receipt older than this is stale: the CLI runs right after its PreToolUse. */
+const FRESH_MS = 10 * 60_000;
+/** Clock skew allowed between the hook and the CLI. */
+const AHEAD_MS = 5_000;
+const DEFAULT_MAX_LINE = 1024 * 1024;
+const TIERS = new Set(['A', 'B', 'C', 'D']);
+const CONSENTS = new Set(['offer-yes', 'asked', 'none']);
+const ASKED = new Set(['this repo', 'every repo', 'repo', 'team']);
+/** A session id as a file name, as phase 0's state.ts does it: anything odd is hashed. */
+function fileId(sessionId) {
+    if (/^[A-Za-z0-9_-][A-Za-z0-9._-]{0,127}$/.test(sessionId))
+        return sessionId;
+    return `h-${createHash('sha256').update(String(sessionId)).digest('hex').slice(0, 16)}`;
+}
+const receiptsDir = (env) => trailPath(env, 'receipts');
+/** <home>/receipts/<session-id>.json */
+export function receiptPath(sessionId, env) {
+    return join(receiptsDir(env), `${fileId(String(sessionId))}.json`);
+}
+/** Replaces the session's previous receipt. */
+export function writeReceipt(r, env) {
+    writePrivate(receiptPath(r.session, env), `${JSON.stringify(r, null, 2)}\n`);
+}
+const str = (v) => typeof v === 'string';
+const num = (v) => typeof v === 'number' && Number.isFinite(v);
+/** The receipt as Trail writes it, or null: a file of any other shape is not one. */
+function asReceipt(v) {
+    if (!v || typeof v !== 'object' || Array.isArray(v))
+        return null;
+    const r = v;
+    if (r.v !== 1 || !str(r.session) || !str(r.transcriptPath) || !str(r.toolUseId) || !str(r.runId) || !str(r.name) || !str(r.at))
+        return null;
+    if (!str(r.host) || !TIERS.has(r.tier) || !CONSENTS.has(r.consent) || (r.offerId !== null && !str(r.offerId)))
+        return null;
+    if (r.typed !== null && (!r.typed || typeof r.typed !== 'object' || !num(r.typed.offset) || !str(r.typed.lineSha)))
+        return null;
+    if (typeof r.typedYes !== 'boolean' || typeof r.typedSave !== 'boolean' || (r.asked !== null && !ASKED.has(r.asked)))
+        return null;
+    if (!num(r.stepsTotal) || !num(r.stepsVerified) || (r.verdict !== 'live' && r.verdict !== 'held'))
+        return null;
+    if (r.usedAt !== null && !str(r.usedAt))
+        return null;
+    if (r.checkout !== undefined && !str(r.checkout))
+        return null;
+    return r;
+}
+/** One receipt file, read only when it is a regular file (never through a link). */
+function readReceiptFile(path) {
+    try {
+        if (!lstatSync(path).isFile())
+            return null;
+    }
+    catch {
+        return null;
+    }
+    return asReceipt(readJsonSafe(path));
+}
+/** The unused receipt (usedAt null) for this run and name, fresh (<= 10 min old, not > 5 s in the future). Scans receipts/*.json. */
+export function findReceipt(runId, name, now = new Date(), env) {
+    let names;
+    try {
+        names = readdirSync(receiptsDir(env));
+    }
+    catch {
+        return null;
+    }
+    let best = null;
+    for (const n of names) {
+        if (!n.endsWith('.json'))
+            continue;
+        const r = readReceiptFile(join(receiptsDir(env), n));
+        if (!r || r.usedAt !== null || r.runId !== runId || r.name !== name)
+            continue;
+        const age = now.getTime() - Date.parse(r.at);
+        if (Number.isNaN(age) || age > FRESH_MS || age < -AHEAD_MS)
+            continue;
+        if (!best || Date.parse(r.at) > Date.parse(best.at))
+            best = r;
+    }
+    return best;
+}
+const sameReceipt = (a, b) => a.session === b.session && a.toolUseId === b.toolUseId && a.runId === b.runId && a.name === b.name && a.at === b.at;
+/** Sets usedAt on the receipt on disk, when it is still this one (a newer add replaces it, and stays unused). */
+export function markReceiptUsed(r, now = new Date(), env) {
+    const path = receiptPath(r.session, env);
+    withLock(path, () => {
+        const cur = readReceiptFile(path);
+        if (!cur || !sameReceipt(cur, r) || cur.usedAt !== null)
+            return;
+        writePrivate(path, `${JSON.stringify({ ...cur, usedAt: now.toISOString() }, null, 2)}\n`);
+    }, 1000);
+}
+/**
+ * The transcript line that starts at offset: one positioned read of at most maxBytes (default 1 MB), from the
+ * byte before it, so an offset inside a line is refused. null past the end, with no newline within maxBytes, or
+ * unreadable.
+ */
+export function lineAt(transcriptPath, offset, maxBytes = DEFAULT_MAX_LINE) {
+    if (!Number.isSafeInteger(offset) || offset < 0 || !(maxBytes > 0))
+        return null;
+    let fd;
+    try {
+        fd = openSync(transcriptPath, 'r');
+    }
+    catch {
+        return null;
+    }
+    try {
+        const from = offset === 0 ? 0 : offset - 1;
+        const lead = offset - from;
+        const buf = Buffer.alloc(lead + Math.floor(maxBytes));
+        const n = readSync(fd, buf, 0, buf.length, from);
+        if (n <= lead)
+            return null;
+        if (lead === 1 && buf[0] !== 0x0a)
+            return null;
+        const end = buf.indexOf(0x0a, lead);
+        if (end < 0 || end >= n)
+            return null;
+        return buf.subarray(lead, end).toString('utf8');
+    }
+    catch {
+        return null;
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/**
+ * The whole lines that end right before `offset` (which must be a line start), oldest first: one positioned read of
+ * at most maxBytes (default 1 MB) back from it. A line cut by the window is left out. [] at offset 0, inside a
+ * line, or unreadable.
+ */
+export function linesBefore(transcriptPath, offset, maxBytes = DEFAULT_MAX_LINE) {
+    if (!Number.isSafeInteger(offset) || offset <= 0 || !(maxBytes > 0))
+        return [];
+    let fd;
+    try {
+        fd = openSync(transcriptPath, 'r');
+    }
+    catch {
+        return [];
+    }
+    try {
+        const from = Math.max(0, offset - Math.floor(maxBytes));
+        const buf = Buffer.alloc(offset - from);
+        const n = readSync(fd, buf, 0, buf.length, from);
+        if (n !== buf.length || buf[n - 1] !== 0x0a)
+            return [];
+        const lines = buf.subarray(0, n - 1).toString('utf8').split('\n');
+        return from > 0 ? lines.slice(1) : lines;
+    }
+    catch {
+        return [];
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** sha256 hex of the whole line, as read (no newline). */
+export function lineSha(line) {
+    return createHash('sha256').update(line, 'utf8').digest('hex');
+}
+export function typedLineStillThere(transcriptPath, typed) {
+    const line = lineAt(transcriptPath, typed.offset);
+    return line !== null && lineSha(line) === typed.lineSha;
+}
+/**
+ * The receipt names the host's own transcript for its session (g7, D74), as its host's dialect knows it (4.16):
+ * for Claude Code `<projects>/<folder>/<session_id>.jsonl`, for Codex `CODEX_HOME/sessions/.../rollout-*-<session>.jsonl`
+ * whose first line names the session, each compared through realpath, so a link to a file elsewhere, a copy in /tmp
+ * or another session's file is not it. A host with no dialect can't save live; its receipt can only be held for its
+ * host, so it passes as it is, unless it claims tier A.
+ */
+export function receiptTranscriptOk(r, env = process.env) {
+    const d = dialectFor(r.host);
+    if (!d)
+        return r.tier !== 'A';
+    return d.transcriptOk(r, env);
+}
+/**
+ * The receipt names the very file the hooks read for its session (g7 review): the session state's cursor keeps the
+ * transcript's device and inode, from the path Claude Code itself gave the hooks. The path check above trusts the
+ * projects folders, and `$CLAUDE_CONFIG_DIR` comes from the env of `trail skills add`, which is the agent's; a copy
+ * under a folder the agent names, or in another project folder, is not the file the hooks read. A hard link to it
+ * is (same inode). No cursor (the hooks never read this session): no. Another host's receipt is held anyway: passes.
+ */
+export function receiptTranscriptRead(r, env = process.env) {
+    if (!dialectFor(r.host))
+        return r.tier !== 'A';
+    const cur = readJsonSafe(sessionPath(r.session, '.json', env))?.trace;
+    if (!cur || typeof cur.ino !== 'number' || typeof cur.dev !== 'number' || !cur.ino)
+        return false;
+    try {
+        const st = statSync(realpathSync(r.transcriptPath));
+        return st.isFile() && st.ino === cur.ino && st.dev === cur.dev;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=receipts.js.map

package/dist/skills/receipts.js.map

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

package/dist/skills/run-checkout.d.ts

@@ -0,0 +1,4 @@
+import type { RunSheet } from '../trace/types.js';
+/** The run's own checkout when it holds, else the first hint that does (an older sheet has none); '' when none. */
+export declare function runCheckout(sheet: Pick<RunSheet, 'repoKey' | 'checkout'>, env?: NodeJS.ProcessEnv, ...hints: Array<string | null | undefined>): string;
+//# sourceMappingURL=run-checkout.d.ts.map

package/dist/skills/run-checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-checkout.d.ts","sourceRoot":"","sources":["../../src/skills/run-checkout.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAelD,mHAAmH;AACnH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAGnK"}

package/dist/skills/run-checkout.js

@@ -0,0 +1,37 @@
+/**
+ * The checkout a run ran in (D93), for everything that compiles the run as a
+ * skill: the prompt hook's asked save, the offer moment, both halves of the
+ * save gate and the held copy. Compile reads paths relative to that root, so
+ * every one of them must use the same one, taken from the run itself (its
+ * sheet, or the receipt the PreToolUse half wrote), never from the folder a
+ * command happens to run in: a session that starts in a folder above the
+ * repo and cds into it runs `trail skills add` up there.
+ *
+ * A folder is used only when it still exists and is the top of a git
+ * checkout whose repo key is the run's. Otherwise ''.
+ */
+import { statSync } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
+import { repoPlace } from '../notes/home.js';
+/** `dir` is an existing checkout's top, with the key `repoKey`. */
+function holds(dir, repoKey, env) {
+    if (typeof dir !== 'string' || !dir || !isAbsolute(dir) || !repoKey)
+        return false;
+    try {
+        if (!statSync(dir).isDirectory())
+            return false;
+    }
+    catch {
+        return false;
+    }
+    const place = repoPlace(dir, env);
+    return place.git && place.key === repoKey && resolve(place.checkout) === resolve(dir);
+}
+/** The run's own checkout when it holds, else the first hint that does (an older sheet has none); '' when none. */
+export function runCheckout(sheet, env = process.env, ...hints) {
+    for (const dir of [sheet.checkout, ...hints])
+        if (holds(dir, sheet.repoKey, env))
+            return resolve(dir);
+    return '';
+}
+//# sourceMappingURL=run-checkout.js.map

package/dist/skills/run-checkout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-checkout.js","sourceRoot":"","sources":["../../src/skills/run-checkout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,mEAAmE;AACnE,SAAS,KAAK,CAAC,GAAY,EAAE,OAAe,EAAE,GAAsB;IAClE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAClF,IAAI,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,KAAK,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AACxF,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,WAAW,CAAC,KAA6C,EAAE,MAAyB,OAAO,CAAC,GAAG,EAAE,GAAG,KAAuC;IACzJ,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC;QAAE,IAAI,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACtG,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/skills/runblock.d.ts

@@ -0,0 +1,47 @@
+import type { SkillInjection } from '../trace/types.js';
+import { type Candidate } from './recall.js';
+import type { ParsedSkill } from './types.js';
+import { type ProbeResult } from './probes.js';
+import { type Lesson } from './lessons.js';
+import { type Anchor } from './anchors.js';
+import { type RecallMark } from './follow-learnings.js';
+export { runProbes, probePassWords, readyProbes, PROBE_BUDGET_MS, type ProbeResult, type ProbeOpts, type ProbeGit } from './probes.js';
+export declare const RUN_BLOCK_MAX = 1200;
+/** 'Oct 14' for a local date (`2026-10-14`) or an ISO time, in local time. */
+export declare function dayWords(d: string | null | undefined): string;
+/**
+ * canAsk: interactive entry, permission_mode in hostFacts.askModes, host claude (4.15 step 5).
+ * 1b: `lessons` (default: the skill folder's) end the block, guardrail-kind first (4.16); `gone` (default: the
+ * anchors gone where the candidate was found) opens it with the out-of-date line (4.18). Both count toward 1,200:
+ * lessons are the second thing cut, oldest first; guardrail-kind lessons and the out-of-date line never are.
+ */
+export declare function runBlock(c: Candidate, ctx: {
+    values: Record<string, string>;
+    notes: string[];
+    probes: ProbeResult[];
+    canAsk: boolean;
+    header: 'job' | 'compact';
+    lastFail: {
+        step: number;
+        at: string;
+    } | null;
+    lessons?: Lesson[];
+    gone?: Anchor[];
+    anchorDeadline?: number;
+    marks?: RecallMark[];
+}): string;
+/**
+ * D116 item 1: the check is a step that only reads (a status, a view, a log, a GET, a tests or query run), so a
+ * status question may run it. A push (it is the step that moved the branch), anything gated, or a command
+ * that changes things is not: that skill gets no check line.
+ */
+export declare function readOnlyCheck(s: Pick<ParsedSkill, 'check' | 'steps' | 'meta'>): boolean;
+/** The check line for a status question; '' when the skill has no check, or none that only reads (D116 item 1). */
+export declare function checkLine(c: Candidate, values: Record<string, string>): string;
+/** The SkillInjection recorded for a block or check line (live: true for job, name and compact cues). */
+export declare function injectionFor(c: Candidate, values: Record<string, string>, cue: SkillInjection['cue'], epoch: number, now?: Date): SkillInjection;
+/** g4's open issue 4 (D71 d): the ready probes that failed for a block ride on its injection, for the use line (never counted against the skill). */
+export declare function withReadyFailed(inj: SkillInjection, probes: ProbeResult[]): SkillInjection;
+/** 'trail: using skill <name> (v<n>, worked <Mon D>)'. */
+export declare function useNotice(c: Candidate): string;
+//# sourceMappingURL=runblock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runblock.d.ts","sourceRoot":"","sources":["../../src/skills/runblock.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAQrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAA8D,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AACvG,OAAO,EAA8B,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAkC,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExF,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvI,eAAO,MAAM,aAAa,OAAO,CAAC;AAMlC,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAI7D;AA+CD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;CAAE,GAAG,MAAM,CA8D7S;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC,GAAG,OAAO,CASvF;AAED,mHAAmH;AACnH,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAM9E;AAUD,yGAAyG;AACzG,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,cAAc,CAsB5J;AAED,qJAAqJ;AACrJ,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,cAAc,CAG1F;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAG9C"}

package/dist/skills/runblock.js

@@ -0,0 +1,227 @@
+/**
+ * What a skill brings back (design 4.15, spec 11): the run block a job or
+ * name cue injects, the check line a status question gets, the injection
+ * recorded for either, and the one line the person sees.
+ *
+ * The block is past tense and attributed ("fits", "last worked Oct 14",
+ * "what worked was step 5"), never an order: the agent starts from the
+ * steps because they worked here before. At most 1,200 characters. Every
+ * value is flattened to one line and every line after the header starts
+ * with two spaces, so nothing in a skill file can open a `[trail]` line.
+ *
+ * A step that can't be undone is said once, after its group: where the
+ * host can ask the person, Claude Code will ask before the group's first
+ * step and the agent waits for that; where it can't (headless, permissions
+ * skipped, another host), the agent shows the person the command instead
+ * of running it (D17). The words never tell the agent not to ask and never
+ * say what one yes covers (D101): an agent read those as a bypass.
+ */
+import { randomBytes } from 'node:crypto';
+import { nameOf } from './recall.js';
+import { flatLine } from '../notes/flatten.js';
+import { monthDay } from './compile-words.js';
+import { fillParams } from './params.js';
+import { gatedGroups, gatedKind } from './risk.js';
+import { neverSave } from './never-save.js';
+import { checkFamilyOf } from '../trace/checks.js';
+import { commandKind } from '../trace/shell.js';
+import { beforeYouStart } from './skillmd.js';
+import { probePassWords } from './probes.js';
+import { isGuardrailLesson, lessonLines, lessonRefused, readLessons } from './lessons.js';
+import { goneAnchors, outOfDateLine } from './anchors.js';
+import { WIDE_SCAN_MS } from './anchors-wide.js';
+import { markLines, stepNote, withFixes } from './follow-learnings.js';
+export { runProbes, probePassWords, readyProbes, PROBE_BUDGET_MS } from './probes.js';
+export const RUN_BLOCK_MAX = 1200;
+/** A command or value on one line, never cut (a cut command would be wrong; an overlong block becomes the pointer). */
+const flat = (t) => flatLine(t, 4000);
+const prose = (t, max = 200) => flatLine(t, max);
+/** 'Oct 14' for a local date (`2026-10-14`) or an ISO time, in local time. */
+export function dayWords(d) {
+    if (!d)
+        return 'an earlier day';
+    const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(d);
+    return m ? monthDay(new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3])).toISOString()) : monthDay(d);
+}
+const OWNER = { personal: 'yours', repo: "the repo's", team: "the team's" };
+/** 'last worked Oct 14', or 'saved Oct 14' for a skill that never checked out. */
+function whenWords(c) {
+    return c.state?.lastWorked ? `last worked ${dayWords(c.state.lastWorked)}` : `saved ${dayWords(c.state?.addedAt ?? null)}`;
+}
+const listWords = (ns) => (ns.length === 2 ? `${ns[0]} and ${ns[1]}` : `${ns.slice(0, -1).join(', ')} and ${ns[ns.length - 1]}`);
+function gatedNote(steps, canAsk) {
+    const one = steps.length === 1;
+    const which = one ? `step ${steps[0]}` : `steps ${listWords(steps)}`;
+    // D101: never "don't ask", never what one yes covers (that stays in pre-bash-skills' gate logic).
+    // D118 a: a step whose ask was denied is not run again that turn (the lab's agent retried a push three times).
+    if (!canAsk) {
+        return one
+            ? `    This session can't ask the person, so don't run ${which} (it can't be undone), not even after a yes in chat; show them the command to run themselves.`
+            : `    This session can't ask the person, so don't run ${which} (they can't be undone), not even after a yes in chat; show them the commands to run themselves.`;
+    }
+    const retry = ` If they say no, don't retry this turn; ask them to run ${one ? 'it' : 'them'}.`;
+    return one
+        ? `    Claude Code will ask the person before ${which} (it can't be undone); wait for that.${retry}`
+        : `    Claude Code will ask the person before step ${steps[0]} (${which} can't be undone); wait for that.${retry}`;
+}
+/** What a tests or query check shows by default: "step n passing" already says it. */
+const PLAIN_SHOWS = new Set(['the tests pass', 'rows come back']);
+function checkText(c, values, skill = c.skill) {
+    const s = skill;
+    if (!s.check)
+        return null;
+    const shows = s.checkShows ? prose(fillParams(s.checkShows, values)) : s.meta['check-tool'] ? 'READY' : null;
+    return { text: flat(fillParams(s.check, values)), shows };
+}
+/** 1b: a personal skill's lessons from its own folder (4.16); none for a skill that isn't in one. */
+function lessonsOf(c) {
+    return c.ref.scope === 'personal' && c.ref.dir ? readLessons(c.ref.dir) : [];
+}
+/** 1b: the anchors gone where the candidate was found (4.18; local file reads only). Phase 2 (4.13): a job cue's block may scan the CLI (its own 150 ms); a compaction's (SessionStart) reads only the cache. */
+function goneOf(c, scan, until) {
+    return c.here ? goneAnchors(c.skill, c.here.checkout, c.here.env ?? process.env, { scan, deadline: Math.min(until ?? Infinity, Date.now() + WIDE_SCAN_MS) }) : [];
+}
+/**
+ * canAsk: interactive entry, permission_mode in hostFacts.askModes, host claude (4.15 step 5).
+ * 1b: `lessons` (default: the skill folder's) end the block, guardrail-kind first (4.16); `gone` (default: the
+ * anchors gone where the candidate was found) opens it with the out-of-date line (4.18). Both count toward 1,200:
+ * lessons are the second thing cut, oldest first; guardrail-kind lessons and the out-of-date line never are.
+ */
+export function runBlock(c, ctx) {
+    // Part 7: a step the person's learning goes against shows its way (or is marked to leave out); never cut.
+    const marks = ctx.marks ?? [];
+    const s = withFixes(c.skill, marks);
+    const name = nameOf(c);
+    const ood = outOfDateLine(name, ctx.gone ?? goneOf(c, ctx.header === 'job', ctx.anchorDeadline));
+    const opening = ood ? [`[trail] ${ood}`] : [];
+    // A lesson is information the person kept (J07), filled like the steps; one edited by hand to skip the ask, or to
+    // hold a refused or gated command, is left out (D88, D101, 4.14 step 3: lessonRefused).
+    const kept = (ctx.lessons ?? lessonsOf(c)).map((l) => ({ ...l, text: fillParams(l.text, ctx.values) })).filter((l) => !lessonRefused(l.text));
+    const guardLines = lessonLines(kept.filter(isGuardrailLesson)).map((l) => `  ${l}`);
+    const lessonRest = lessonLines(kept.filter((l) => !isGuardrailLesson(l))).map((l) => `  ${l}`);
+    const owner = `${OWNER[c.ref.scope] ?? 'yours'}, v${prose(s.meta.version || '1', 12)}, ${whenWords(c)}`;
+    const header = ctx.header === 'compact'
+        ? `[trail] You were partway through skill ${name} when the conversation was compacted. Its steps (${owner}):`
+        : `[trail] Skill ${name} fits (${owner}).${ctx.lastFail ? ` Last time step ${ctx.lastFail.step} failed; watch its output.` : ''} Start from these exact steps, in order:`;
+    const failed = ctx.probes.filter((p) => !p.ok).map((p) => `  ready: ${prose(p.why ?? p.probe)}.${p.fix ? ` ${prose(p.fix)}` : ''}`);
+    const passedWords = ctx.probes.filter((p) => p.ok).map((p) => probePassWords(p.probe)).filter((w) => !!w);
+    const passed = passedWords.length ? `  ready: ${passedWords.join(', ')}` : null;
+    // D116 item 5: what the person does first (a login the run fed keystrokes into, kept out of the steps).
+    const before = beforeYouStart(s.meta).map((l) => `  before you start: ${prose(l)}.`);
+    const checkFirst = String(s.meta['check-first'] ?? '').split(' ; ').map((x) => x.trim()).filter(Boolean).map((x) => `  check first: ${flat(x)}`);
+    const groups = gatedGroups(s.steps);
+    const steps = [];
+    for (const st of s.steps) {
+        const note = st.wait ? ' (a wait: run it in the background if it may take over 2 minutes)' : st.bg ? ' (in the background)' : '';
+        const own = c.skill.steps.find((x) => x.n === st.n)?.cmd ?? st.cmd;
+        steps.push(`  ${st.n} ${flat(fillParams(st.cmd, ctx.values))}${note}${stepNote(marks, st.n, fillParams(own, ctx.values))}`);
+        const g = groups.find((x) => x.steps[x.steps.length - 1] === st.n);
+        if (g)
+            steps.push(gatedNote(g.steps, ctx.canAsk));
+    }
+    const chk = checkText(c, ctx.values, s);
+    let check = null;
+    if (chk) {
+        const asStep = [...s.steps].reverse().find((x) => x.cmd === s.check);
+        if (asStep && !s.meta['check-tool']) {
+            check = chk.shows && !PLAIN_SHOWS.has(chk.shows) ? `  check: step ${asStep.n} passing is the check (it should show ${chk.shows}).` : `  check: step ${asStep.n} passing is the check.`;
+        }
+        else
+            check = `  check: ${chk.text}${chk.shows ? ` (it should show ${chk.shows})` : ''}`;
+    }
+    // A line edited by hand to hold a command the risk rules refuse is left out.
+    const fails = s.ifFails.filter((l) => !neverSave(l)).slice(0, 2).map((l) => `  If it fails: ${prose(l)}`);
+    const notes = ctx.notes.map((n) => `  ${prose(n)}`);
+    const footer = `  If a step fails, fix that step and say so. End with "Used skill ${name}".`;
+    const follow = markLines(marks).map((l) => `  ${prose(l, 400)}`);
+    const build = (o) => [
+        ...opening, header, ...failed, ...(o.passed && passed ? [passed] : []), ...before, ...checkFirst, ...steps, ...(check ? [check] : []), ...follow,
+        ...fails.slice(0, o.fails), ...(o.notes ? notes : []), footer, ...guardLines, ...lessonRest.slice(lessonRest.length - o.lessons),
+    ].join('\n');
+    const all = lessonRest.length;
+    for (const o of [
+        { notes: true, fails: 2, passed: true, lessons: all }, { notes: false, fails: 2, passed: true, lessons: all },
+        ...Array.from({ length: all }, (_, i) => ({ notes: false, fails: 2, passed: true, lessons: all - 1 - i })),
+        { notes: false, fails: 1, passed: true, lessons: 0 }, { notes: false, fails: 1, passed: false, lessons: 0 },
+    ]) {
+        const block = build(o);
+        if (block.length <= RUN_BLOCK_MAX)
+            return block;
+    }
+    return [...opening, `[trail] Skill ${name} fits this ask, but its steps are too long to show here. Run trail skills show ${name} and start from them.`].join('\n');
+}
+/** A GET with curl or wget: no other method, no body, no upload. */
+const HTTP_GET = /^(?:curl|wget)\s/;
+const HTTP_WRITES = /\s(?:-X\s*(?!GET\b)\w|--request\s*(?!GET\b)\w|-d\b|--data\b|--data-\w+|-F\b|--form\b|-T\b|--upload-file\b|--post-\w+|--method=(?!GET\b))/i;
+/**
+ * D116 item 1: the check is a step that only reads (a status, a view, a log, a GET, a tests or query run), so a
+ * status question may run it. A push (it is the step that moved the branch), anything gated, or a command
+ * that changes things is not: that skill gets no check line.
+ */
+export function readOnlyCheck(s) {
+    const cmd = String(s.check ?? '').trim();
+    if (!cmd)
+        return false;
+    if (s.meta['check-tool'])
+        return true;
+    if (gatedKind(cmd) || s.steps.some((x) => x.cmd === s.check && x.gated))
+        return false;
+    const fam = checkFamilyOf(cmd, s.meta.job ?? null);
+    if (fam)
+        return fam !== 'push';
+    if (HTTP_GET.test(cmd))
+        return !HTTP_WRITES.test(` ${cmd}`);
+    return commandKind(cmd) === 'look';
+}
+/** The check line for a status question; '' when the skill has no check, or none that only reads (D116 item 1). */
+export function checkLine(c, values) {
+    if (!readOnlyCheck(c.skill))
+        return '';
+    const chk = checkText(c, values);
+    const name = nameOf(c);
+    if (!chk)
+        return '';
+    return `[trail] To check ${name}: ${chk.text}${chk.shows ? ` (it should show ${chk.shows})` : ''}. Answer from what it shows; don't run any other step.`;
+}
+/** D106: a check that shows a `{version}` param, filled with a literal version: what credit expects it to show. */
+function checkVersionOf(c, values) {
+    const name = /^\{([A-Za-z_]\w*)\}$/.exec(String(c.skill.checkShows ?? '').trim())?.[1];
+    const v = name && c.skill.params.some((p) => p.name === name && p.shape === 'version') ? values[name] : undefined;
+    const m = v === undefined ? null : /^v?(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)$/.exec(v.trim());
+    return m ? { checkVersion: m[1] } : {};
+}
+/** The SkillInjection recorded for a block or check line (live: true for job, name and compact cues). */
+export function injectionFor(c, values, cue, epoch, now = new Date()) {
+    const s = c.skill;
+    const block = cue !== 'check';
+    const tool = s.meta['check-tool'];
+    return {
+        injId: `i-${randomBytes(3).toString('hex')}`,
+        skillId: c.ref.id || s.meta.trail,
+        name: c.ref.name || s.name,
+        epoch,
+        at: now.toISOString(),
+        cue,
+        params: { ...values },
+        steps: block ? s.steps.map((st) => fillParams(st.cmd, values)) : [],
+        gated: block ? s.steps.filter((st) => st.gated).map((st) => ({ step: st.n, kind: st.gated })) : [],
+        check: s.check ? fillParams(s.check, values) : null,
+        ...(tool ? { checkTool: tool } : {}),
+        ...checkVersionOf(c, values),
+        runId: null,
+        live: block,
+        // 1b (R30): the asks phrase a job cue fired on, by its sha only.
+        ...(cue === 'job' && typeof c.phraseSha === 'string' && /^[0-9a-f]{8}$/.test(c.phraseSha) ? { phraseSha: c.phraseSha } : {}),
+    };
+}
+/** g4's open issue 4 (D71 d): the ready probes that failed for a block ride on its injection, for the use line (never counted against the skill). */
+export function withReadyFailed(inj, probes) {
+    const failed = probes.filter((p) => !p.ok).map((p) => p.probe);
+    return failed.length ? { ...inj, readyFailed: failed } : inj;
+}
+/** 'trail: using skill <name> (v<n>, worked <Mon D>)'. */
+export function useNotice(c) {
+    const when = c.state?.lastWorked ? `worked ${dayWords(c.state.lastWorked)}` : `saved ${dayWords(c.state?.addedAt ?? null)}`;
+    return `trail: using skill ${nameOf(c)} (v${prose(c.skill.meta.version || '1', 12)}, ${when})`;
+}
+//# sourceMappingURL=runblock.js.map

package/dist/skills/runblock.js.map

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