@nanonets/graft 0.24.0 → 0.25.0

package/dist/claude/prompt-hook.js

@@ -0,0 +1,303 @@
+/**
+ * The prompt hook: what the agent reads alongside what the person just typed.
+ *
+ * Two lookups, independent of each other. The learnings that bear on the
+ * prompt are matched here, by their words, from a 3-character prompt up: "ff
+ * to prod" is too short to ask the graph about, and an ask that fails or runs
+ * out of time must not take the learnings down with it. The graph ask (`graft
+ * ask`, pointers only) runs for prompts of MIN_PROMPT_CHARS and up, and when it
+ * answers it also brings the learnings that touch the files its hits point into,
+ * the teammates' branches on the same code, and the retrieval pack.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { brand, tag } from '../brand.js';
+import { scopeOf, scopesOfGraph } from '../graph/scopes.js';
+import { keepsNotes } from '../notes/home.js';
+import { findNotes, listNotes } from '../notes/notes.js';
+import { INJECTED_POINTERS_CAP, notesForPrompt, relevantRetrieval } from './format.js';
+import { CHILD_TIMEOUT_MS, emitHook, graftJsonWithin, payloadSessionId, withContextDirArg } from './hook-io.js';
+import { promptPart } from './skills-wiring.js';
+import { recordSkillUse, skillOfPrompt } from './skill-use.js';
+import { readSession, readStats, writeSession } from './state.js';
+import { readWiring } from './stats.js';
+import { ownText, PASTE_MARK } from '../trace/claude.js';
+/** Prompts shorter than this never trigger the graph ask — they are almost always
+ * conversational ("yes go ahead", "thanks") and the coverage gate can't judge
+ * them reliably with so few terms. */
+export const MIN_PROMPT_CHARS = 12;
+/** Prompts shorter than this match nothing at all, learnings included: no
+ * word in them is long enough to look up. "ff to prod" (10) and "ship it" (7)
+ * clear it. */
+export const MIN_CUE_CHARS = 3;
+/**
+ * The most the prompt hook takes in all, graph ask included: the person's
+ * prompt waits on it before the agent starts. The learnings are matched first
+ * and never wait on the ask; the ask gets only what is left. A large repo's
+ * ask took 13 s at p95 before this (the lab, on main).
+ */
+export const PROMPT_BUDGET_MS = 4000;
+/** Kept back after the ask for the hook's own work: format, write the session, emit. */
+const AFTER_ASK_MS = 250;
+/** An ask with less time than this left isn't started: it would only be cut off. */
+const MIN_ASK_MS = 500;
+/** Headroom left for the hook's own work (read stdin, score, write session, emit)
+ * after its `graft ask` child returns, inside the installed timeout. */
+const HOOK_OVERHEAD_MS = 2000;
+/** Floor for an install from before 0.23 (a timeout meant as ms), so a hand-edited tiny one can't leave the child no time at all. */
+const MIN_CHILD_TIMEOUT_MS = 4000;
+/** An installed timeout at or over this was written as milliseconds (before 0.23); under it, seconds. */
+const LEGACY_MS_FROM = 1000;
+/**
+ * How long the prompt hook may let `graft ask` run, from the timeout that is
+ * *actually installed* (repo and user settings), not from what the current
+ * `settings-merge.ts` would install: an upgrade doesn't rewrite settings until
+ * the next init or upkeep, and a child that outlives the installed timeout
+ * gets the whole hook killed (no learnings, no session write).
+ *
+ * Claude Code reads `timeout` in seconds, which Trail writes from 0.23 on. A
+ * number of 1000 or more is an install from before, meant as milliseconds,
+ * and read that way. 0 means no room for an ask at all. The hook's own total
+ * budget (PROMPT_BUDGET_MS) cuts this further.
+ */
+export function promptAskTimeout(dir) {
+    const installed = installedHookTimeout(dir, 'UserPromptSubmit');
+    if (installed === null)
+        return CHILD_TIMEOUT_MS - HOOK_OVERHEAD_MS;
+    if (installed.legacy)
+        return Math.max(MIN_CHILD_TIMEOUT_MS, installed.ms - HOOK_OVERHEAD_MS);
+    const room = installed.ms - HOOK_OVERHEAD_MS;
+    return room >= MIN_ASK_MS ? room : 0;
+}
+/**
+ * Every settings file Claude Code merges hook definitions from, for a session
+ * rooted at `dir`. The per-repo file is not the only place graft's hooks can be
+ * installed: declaring them once at the user level wires every repo on the
+ * machine at once, and such a repo has no `.claude/settings.json` at all.
+ */
+function hookSettingsFiles(dir) {
+    const user = process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), '.claude');
+    return [
+        join(dir, '.claude', 'settings.json'),
+        join(dir, '.claude', 'settings.local.json'),
+        join(user, 'settings.json'),
+    ];
+}
+/** The timeout on one settings file's graft hook entry for `event`, or null if it
+ * can't be read (no settings file, hand-edited shape, unparseable JSON). */
+function hookTimeoutIn(file, event) {
+    try {
+        const settings = JSON.parse(readFileSync(file, 'utf8'));
+        const blocks = settings?.hooks?.[event];
+        if (!Array.isArray(blocks))
+            return null;
+        for (const block of blocks) {
+            for (const h of block?.hooks ?? []) {
+                if (typeof h?.command === 'string' && /(graft|trail)-hooks\.cjs|\/\.trail\/hook\.cjs/.test(h.command) && typeof h.timeout === 'number' && h.timeout > 0) {
+                    const legacy = h.timeout >= LEGACY_MS_FROM;
+                    return { ms: legacy ? h.timeout : h.timeout * 1000, legacy };
+                }
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The budget this hook is actually running under, or null when no settings file
+ * declares one.
+ *
+ * The smallest declared timeout wins rather than the nearest, because when more
+ * than one file declares the hook Claude Code runs every matching entry and this
+ * process cannot tell which one launched it. Guessing high is the expensive
+ * mistake: an overrunning child gets the whole hook SIGKILLed, so `emit()` and
+ * `writeSession()` never run and the turn silently gets no retrieval at all.
+ * Guessing low only shortens one query.
+ */
+function installedHookTimeout(dir, event) {
+    let smallest = null;
+    for (const file of hookSettingsFiles(dir)) {
+        const timeout = hookTimeoutIn(file, event);
+        if (timeout === null)
+            continue;
+        if (smallest === null || timeout.ms < smallest.ms)
+            smallest = timeout;
+    }
+    return smallest;
+}
+/**
+ * The "you're working in backend/, weight it" hint: on a multi-scope repo,
+ * narrow the prompt hook's `ask` call to whatever scope the last-edited file
+ * (`stats.lastFile`, captured at {@link handlePostEdit}) sits in.
+ *
+ * `lastFile` is only a basename (not a repo-relative path — see
+ * `handlePostEdit`), so this is a best-effort lookup against the CURRENT
+ * graph: any file node whose path ends in `/<lastFile>` (or equals it, for a
+ * repo-root file). Fails soft in every direction a hook must never crash on —
+ * no graph, a single-scope graph, a lastFile no longer in the graph (moved,
+ * deleted, or edited before the first build), or a basename that lands in
+ * more than one scope (ambiguous: could be either sub-project) all skip the
+ * hint silently, logging one line to stderr so the miss is visible without
+ * ever failing the hook.
+ */
+export function lastFileScopeHint(dir, lastFile) {
+    if (!lastFile)
+        return null;
+    try {
+        const w = readWiring(dir);
+        if (!w)
+            return null;
+        const scopes = scopesOfGraph(w);
+        if (scopes.length <= 1)
+            return null; // single-scope: no hint, no --in
+        const matches = (w.nodes ?? []).filter((n) => n.kind === 'file' && (n.path === lastFile || n.path.endsWith(`/${lastFile}`)));
+        if (matches.length === 0) {
+            console.error(`${tag()} prompt hook: lastFile "${lastFile}" not found in the graph, so no scope hint`);
+            return null;
+        }
+        const prefixes = new Set(matches.map((n) => scopeOf(n.path, scopes).prefix));
+        if (prefixes.size > 1) {
+            console.error(`${tag()} prompt hook: lastFile "${lastFile}" matches more than one scope, so no scope hint`);
+            return null;
+        }
+        const [prefix] = prefixes;
+        return prefix === '' ? null : prefix; // root scope: nothing to narrow
+    }
+    catch (e) {
+        console.error(`${tag()} prompt hook: scope hint lookup failed (${e?.message ?? e}), so no scope hint`);
+        return null;
+    }
+}
+/**
+ * The learnings that bear on `prompt`, best first: the ones whose title or
+ * text share its words, matched here with no graph ask needed, joined by the
+ * ones the ask matched on the files its hits point into when it answered. One
+ * learning is one entry, at its better score. Empty for a repo that keeps no
+ * learnings on this machine, and on any read failure: a missing learning costs
+ * one prompt, a broken hook costs the turn.
+ */
+export function promptLearnings(dir, prompt, ask, byWords = learningsByWords(dir, prompt)) {
+    const best = new Map();
+    const add = (h) => {
+        const key = h?.note && (h.note.path || h.note.title);
+        if (!key)
+            return;
+        const had = best.get(key);
+        if (!had || h.score > had.score)
+            best.set(key, h);
+    };
+    for (const h of byWords)
+        add(h);
+    for (const h of ask?.notes ?? [])
+        add(h);
+    return [...best.values()].sort((a, b) => b.score - a.score || String(b.note.date).localeCompare(String(a.note.date)));
+}
+/** The learnings whose title or text share the prompt's words: no graph needed. Empty on any read failure. */
+function learningsByWords(dir, prompt) {
+    try {
+        return keepsNotes(dir) ? findNotes(listNotes(dir), prompt) : [];
+    }
+    catch {
+        // Nothing matched by words this time; the ask's own matches still count.
+        return [];
+    }
+}
+/**
+ * The graph ask for `prompt`: pointers only, narrowed to the last-edited
+ * file's scope. Null when it fails, runs out of time, or there is no time
+ * left before `deadline` to start one.
+ */
+async function askGraph(dir, prompt, deadline) {
+    // Pointers-only, small, gated. No --source: per-prompt injected tokens are
+    // fresh full-price input on every turn (unlike the cached SessionStart
+    // orientation), so the pack carries locators, never inlined code — the agent
+    // pulls spans itself via `graft ask --source` when a pointer looks right.
+    // relevantRetrieval then drops the pack entirely when the prompt barely
+    // overlaps the top hit or when every hit was already injected this session.
+    // The prompt goes on stdin (`-`), never in argv, where any process on the
+    // machine can read it with `ps`.
+    const askArgs = withContextDirArg(dir, ['ask', '-', '.', '--json', '-n', '3']);
+    // "You're working in backend/, weight it": only fires on a multi-scope
+    // repo whose lastFile resolves cleanly to one scope — see lastFileScopeHint.
+    const scopeHint = lastFileScopeHint(dir, readStats(dir)?.lastFile);
+    if (scopeHint)
+        askArgs.push('--in', scopeHint);
+    const timeout = Math.min(promptAskTimeout(dir), deadline - Date.now() - AFTER_ASK_MS);
+    if (timeout < MIN_ASK_MS)
+        return null;
+    const ask = await graftJsonWithin(dir, askArgs, timeout, prompt);
+    return ask && typeof ask === 'object' ? ask : null;
+}
+/**
+ * The person's own words in the prompt slot, the shared filter's way: IDE
+ * context and reminders stripped, a pasted block left out, and '' when what
+ * arrived is harness text (a task notice, a command wrapper, a hand-back).
+ */
+export function promptWords(raw) {
+    return ownText(String(raw ?? '')).split(PASTE_MARK).join(' ').trim();
+}
+/**
+ * UserPromptSubmit. Ends inside `budgetMs` (PROMPT_BUDGET_MS by default): the
+ * learned-skills part first (its own 400 ms deadline), then the learnings
+ * matched by their words, then the graph ask in what is left; whatever was
+ * found goes out in one object even when the ask is cut. A skills block (a
+ * bare "no" where the host shows it) is the whole answer, with no ask.
+ *
+ * The skills part comes before the 3-character floor: an answer to an offer
+ * can be shorter than that ("no", "y", "ok"), and it only matches what the
+ * person typed.
+ */
+export async function handlePrompt(input, dir, opts = {}) {
+    // Background completion notices are machine events, not user queries: no skills answer, no ask (#551).
+    if (String(input?.prompt ?? '').trimStart().startsWith('<task-notification>'))
+        return;
+    const deadline = Date.now() + (opts.budgetMs ?? PROMPT_BUDGET_MS);
+    // `/name` for one of the repo's skills is a run of it; the name only goes.
+    recordSkillUse(skillOfPrompt(input?.prompt), input, dir);
+    const skills = await promptPart(input, dir);
+    if (skills.block)
+        return void emitHook('UserPromptSubmit', { block: skills.block });
+    const say = (txt) => emitHook('UserPromptSubmit', { context: [skills.context, txt].filter(Boolean).join('\n\n'), notice: skills.notice });
+    const prompt = promptWords(input?.prompt);
+    if (prompt.length < MIN_CUE_CHARS)
+        return say('');
+    const underTrail = brand() === 'trail';
+    // Learnings first: matched by their words, before and whatever the ask does.
+    const byWords = underTrail ? learningsByWords(dir, prompt) : [];
+    const ask = prompt.length >= MIN_PROMPT_CHARS ? await askGraph(dir, prompt, deadline) : null;
+    // Under graft, learnings come only with the ask; nothing else to say without it.
+    if (!ask && !underTrail)
+        return say('');
+    const id = payloadSessionId(input);
+    const s = readSession(dir, id);
+    // What an earlier session worked out matters more than where code is.
+    // Part 7: a learning the run block already says (its step repeats it, or it wins over a step) is said once, there.
+    const said = new Set(skills.said ?? []);
+    const all = underTrail ? promptLearnings(dir, prompt, ask, byWords) : [];
+    const learnings = all.filter((h) => !said.has(h.note.id));
+    // The session's one shown list, which on-touch reads too: a learning the block said is not shown again on a file open.
+    if (said.size)
+        s.injectedNotes = [...(s.injectedNotes ?? []), ...saidPaths(dir, said)].slice(-INJECTED_POINTERS_CAP);
+    const notes = learnings.length ? notesForPrompt({ query: prompt, mode: 'learnings', hits: [], notes: learnings }, s) : null;
+    const retrieval = ask ? relevantRetrieval(ask, s) : null;
+    // A count, never the prompt: nothing the person typed is kept (spec section 6).
+    if (ask)
+        s.promptAsks = (s.promptAsks ?? 0) + 1;
+    // Teammates' branches on the same code come after an edit instead (hooks.ts editOverlap).
+    say([notes, retrieval].filter(Boolean).join('\n\n'));
+    if (ask || notes || said.size)
+        writeSession(dir, id, s);
+}
+/** The paths the session's shown list knows the learnings `ids` by (as `listNotes` gives them). [] on a read failure. */
+function saidPaths(dir, ids) {
+    try {
+        return listNotes(dir, { branches: false }).filter((n) => ids.has(n.id)).map((n) => n.path || n.title);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=prompt-hook.js.map

package/dist/claude/prompt-hook.js.map

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

package/dist/claude/prompt-skills.d.ts

@@ -0,0 +1,19 @@
+import type { HookOut } from '../skills/types.js';
+import { skillsGate } from '../trace/skill-session.js';
+import { type ProbeOpts } from '../skills/runblock.js';
+import { type Consent } from './prompt-consent.js';
+export { sessionStartSkills } from './start-skills.js';
+export declare const PROMPT_DEADLINE_MS = 400;
+/** What tests swap: g5's two calls, telemetry, the gate (a temp folder reads as scratch), the probes' git, the deadline's clock. */
+export interface PromptDeps {
+    consent: Consent;
+    track: (event: string, props: Record<string, string>) => void;
+    gate: (input: unknown, dir: string, env?: NodeJS.ProcessEnv) => ReturnType<typeof skillsGate>;
+    probes: ProbeOpts;
+    clock: () => number;
+    /** Part 7: the file names of the learnings this session showed already (the prompt hook's and on-touch's one list). */
+    shown: () => ReadonlySet<string>;
+}
+/** 3.2. */
+export declare function promptSkills(input: any, dir: string, env?: NodeJS.ProcessEnv, deps?: Partial<PromptDeps>): HookOut;
+//# sourceMappingURL=prompt-skills.d.ts.map

package/dist/claude/prompt-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-skills.d.ts","sourceRoot":"","sources":["../../src/claude/prompt-skills.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,OAAO,EAAiC,UAAU,EAAkC,MAAM,2BAA2B,CAAC;AAYtH,OAAO,EAA4G,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGjK,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAWzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAKtC,oIAAoI;AACpI,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IAC9D,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,KAAK,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IAC9F,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,uHAAuH;IACvH,KAAK,EAAE,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;CAClC;AAKD,WAAW;AACX,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,OAAO,CAoCnI"}

package/dist/claude/prompt-skills.js

@@ -0,0 +1,305 @@
+import { homedir } from 'node:os';
+import { askText, matchJob } from '../trace/jobs.js';
+import { isCorrection, isSaveRequest, scopeWords, typedPrompt, typedSha } from '../trace/typed.js';
+import { currentRun, injectedThisEpoch, skillsGate, withSkillSession } from '../trace/skill-session.js';
+import { lastGoodRun } from '../trace/run-verdict.js';
+import { findPriorSheet, readRunSheet } from '../trace/runs.js';
+import { track } from '../telemetry/track.js';
+import { creditWindow, noteCorrectionLine, settleCredit } from '../skills/credit.js';
+import { compileRun } from '../skills/compile.js';
+import { refusalWords } from '../skills/compile-words.js';
+import { hostFacts } from '../skills/host-facts.js';
+import { resolveParams } from '../skills/params.js';
+import { lastUsedIn } from '../skills/state.js';
+import { nameTaken } from '../skills/store.js';
+import { candidatesHere, matchCue, nameOf, normalizePrompt, refusedAtRecall, withRunParams } from '../skills/recall.js';
+import { checkLine, injectionFor, readOnlyCheck, runBlock, runProbes, useNotice, withReadyFailed, PROBE_BUDGET_MS } from '../skills/runblock.js';
+import { flatLine } from '../notes/flatten.js';
+import { directive } from '../skills/directive-words.js';
+import { consent as g5consent } from './prompt-consent.js';
+import { canAsk, hookError, scopeKeys, sendAll, syncGate, trimInjected } from './skills-hook-util.js';
+import { runCheckout } from '../skills/run-checkout.js';
+import { lastResult, lastResultLine } from '../skills/check-result.js';
+import { noteCodexPrompt } from '../trace/codex.js';
+import { useFor } from '../trace/dialect.js';
+import { stopBlockReason } from '../skills/offer-words.js';
+import { recallMarks, saidIn, shownFiles, stepLearnings, withFixes } from '../skills/follow-learnings.js';
+import { readSession } from './state.js';
+import { payloadSessionId } from './hook-io.js';
+export { sessionStartSkills } from './start-skills.js';
+export const PROMPT_DEADLINE_MS = 400;
+const LOCK_WAIT_MS = 150;
+const LIVE_MS = 2 * 60 * 60 * 1000;
+const MAX_ASK_WORDS = 25;
+/** The telemetry answer for each class g5 reports (stale and not-shown were never answered: nothing is sent). */
+const ANSWERED = { yes: 'yes', show: 'show', no: 'no', other: 'none', retire: 'retire' };
+/** 3.2. */
+export function promptSkills(input, dir, env = process.env, deps = {}) {
+    const clock = deps.clock ?? Date.now;
+    const deadline = clock() + PROMPT_DEADLINE_MS;
+    const sent = [];
+    try {
+        const g = (deps.gate ?? skillsGate)(input, dir, env);
+        if (!g.ok)
+            return {};
+        const ctx = g.ctx;
+        const typed = typedPrompt(String(input?.prompt ?? ''));
+        if (!typed)
+            return {};
+        const d = {
+            consent: deps.consent ?? g5consent,
+            track: deps.track ?? ((e, p) => track(e, p, { env: ctx.env, ...(ctx.checkout ? { repo: ctx.checkout } : {}) })),
+            gate: deps.gate ?? skillsGate,
+            probes: deps.probes ?? {},
+            clock,
+            shown: deps.shown ?? (() => {
+                try {
+                    return shownFiles(readSession(dir, payloadSessionId(input)).injectedNotes);
+                }
+                catch {
+                    return new Set();
+                }
+            }),
+        };
+        // Phase 2 (3.2 step 1, P30, R7): on Codex the prompt's keyed hash goes into the session first, before the catch-up
+        // reads the rollout, so the typed line already there counts as the person's. A prompt that is Trail's own Stop
+        // reason (a continuation, should Codex send one through UserPromptSubmit, HC3) is never the person's: nothing runs.
+        let own = false;
+        const prepare = ctx.host === 'codex' ? (st) => {
+            own = isOwnBlockReason(st, String(input?.prompt ?? ''), ctx.transcriptPath);
+            if (!own)
+                noteCodexPrompt(st, String(input?.prompt ?? ''), env);
+        } : undefined;
+        const out = withSkillSession(ctx, { catchUp: ctx.fold, waitMs: LOCK_WAIT_MS, ...(prepare ? { prepare } : {}) }, (st, fold) => (own ? {} : inside(ctx, st, fold, typed, d, deadline, sent)));
+        sendAll(sent, d.track);
+        return out ?? {};
+    }
+    catch (e) {
+        hookError('prompt', e, env);
+        return {};
+    }
+}
+function inside(ctx, st, fold, typed, d, deadline, sent) {
+    const { env, now } = ctx;
+    const context = [];
+    // 4. An answer to a pending offer: g5 records it; yes, show me and no end the prompt here. Phase 2 (4.9, D72, R1): a
+    // retire is checked against the reply before it in the transcript, so the hook passes where it is.
+    const cap = d.consent.captureAnswer(st, typed, env, now, { transcriptPath: ctx.transcriptPath });
+    if (cap.answer && ANSWERED[cap.answer])
+        sent.push(['skill_answer', { answer: ANSWERED[cap.answer] }]);
+    if (cap.changed === 'retire')
+        sent.push(['skill_changed', { op: 'retire' }]);
+    if (cap.out)
+        return cap.out;
+    if (cap.extra)
+        context.push(cap.extra);
+    // 5. Credit (D57): the run a block came in for may have closed with this catch-up; then the correction window.
+    if (ctx.learn) {
+        // 1b (4.19): a cue phrase dropped at the flush says so once.
+        const cueDropped = () => sent.push(['skill_stale', { reason: 'unfollowed' }]);
+        // c8 (4.9): a firing this settle writes is considered by the next Stop's retire proposal.
+        const fired = (f) => { if (!f.followed)
+            st.firedLater = [...(st.firedLater ?? []), f].slice(-4); };
+        for (const s of settleCredit(st, { host: ctx.host, env, now, sessionId: ctx.sessionId, cueDropped, fired }))
+            sent.push(['skill_used', { outcome: s.outcome }]);
+        creditWindow(st, isCorrection(typed) ? { sha: typedSha(typed) } : null, { env, now });
+        noteCorrectionLine(st, fold?.typed ?? []);
+    }
+    // 6. "Save this as a skill" (moment 1).
+    if (ctx.fold && isSaveRequest(typed)) {
+        context.push(saveAsk(ctx, st, fold, typed, d));
+        syncGate(ctx, st);
+        return { context: context.join('\n') };
+    }
+    const np = normalizePrompt(typed);
+    let cached = null;
+    const cands = () => (cached ??= (() => {
+        const r = candidatesHere({ repoKeys: scopeKeys(ctx, st), checkout: ctx.checkout, env });
+        // Phase 2 (4.6): a proposal the person copied over their file is Trail's own again.
+        for (const _ of r.adopted)
+            sent.push(['skill_changed', { op: 'adopted' }]);
+        return r.cands;
+    })());
+    // 7. Liveness, before the cue.
+    endBlocks(st, typed, np, now, cands, askRun(st, fold, typed));
+    // 8. The cue, while there is time for it.
+    let notice;
+    let said;
+    if (d.clock() < deadline) {
+        const mine = [...st.injected].reverse().find((i) => i.cue !== 'check');
+        // A block this session counts as used just now; otherwise the newest use here, within 24 hours.
+        const lastUsed = mine ? { id: mine.skillId, at: now.toISOString() } : lastUsedIn(scopeKeys(ctx, st), env);
+        const cue = matchCue(np, cands(), lastUsed, now);
+        // Reading a large store can use up the time: past the deadline, no block this prompt (never half of one).
+        if (!cue || d.clock() >= deadline) { /* nothing */ }
+        else if (cue.kind === 'check') {
+            const values = checkValues(cue, np, mine && mine.skillId === cue.cand.ref.id ? mine : null);
+            // D116 item 1: a check that changes things (the push that moved prod) is never one to run for a status
+            // question; the last run's recorded result answers instead.
+            const line = refusedAtRecall(cue.cand.skill, values) ? ''
+                : readOnlyCheck(cue.cand.skill) ? checkLine(cue.cand, values)
+                    : lastResultLine(cue.cand, typed, lastResult(cue.cand, mine ?? null, st.runs, env));
+            if (line) {
+                context.push(line);
+                st.injected.push(injectionFor(cue.cand, values, 'check', st.epoch, now));
+            }
+        }
+        else {
+            const run = askRun(st, fold, typed);
+            // D118 b: what an earlier ask of this run named (the version) holds across its turns and re-sent blocks.
+            const r = bring(ctx, st, run ? withRunParams(cue, run.promptParams, np) : cue, d, deadline, run);
+            if (r) {
+                context.push(r.context);
+                notice = r.notice;
+                if (r.said?.length)
+                    said = r.said;
+            }
+        }
+    }
+    trimInjected(st);
+    syncGate(ctx, st);
+    const out = {};
+    if (context.length)
+        out.context = context.join('\n');
+    if (notice)
+        out.notice = notice;
+    if (said)
+        out.said = said;
+    return out;
+}
+/** 4.16: the prompt is the Stop block reason Trail gave for the offer it holds (whitespace aside). */
+function isOwnBlockReason(st, prompt, transcriptPath) {
+    const po = st.pendingOffer;
+    if (!po || po.channel !== 'stop' || !po.shownAt)
+        return false;
+    const flat = (t) => t.replace(/\s+/g, ' ').trim();
+    const reason = flat(stopBlockReason(po, transcriptPath, useFor('codex', st)));
+    return reason !== '' && flat(prompt) === reason;
+}
+/** 3.2 step 6. */
+function saveAsk(ctx, st, fold, typed, d) {
+    const env = ctx.env;
+    const last = lastGoodRun(st, env);
+    if ('none' in last)
+        return directive(typed, nothingToKeep(last));
+    const { run, sheet } = last;
+    const scope = scopeWords(typed);
+    const keys = st.scopeKeys.includes(run.repoKey) ? st.scopeKeys : [run.repoKey];
+    // D93: the run's own checkout, as both halves of the save gate compile it.
+    const root = runCheckout(sheet, env, ctx.repoKey === sheet.repoKey ? ctx.checkout : '');
+    const compiled = compileRun(sheet, {
+        repoRoot: root, home: env.HOME || homedir(), platform: process.platform,
+        prior: findPriorSheet(sheet, env), moment: 'asked', applies: scope === 'every repo' ? 'every repo' : run.repoKey, now: ctx.now, askedWith: typed,
+        readSheet: (id) => readRunSheet(id, env), taken: (n) => nameTaken(n, { repoKeys: keys, checkout: root || ctx.checkout, env }) !== null,
+        learnings: stepLearnings({ repoKeys: [sheet.repoKey], checkout: root, env }),
+    });
+    if (!compiled.ok) {
+        const words = refusalWords(compiled.reason, compiled.detail);
+        return directive(typed, `Trail can't keep that job as a skill: ${words}. Let them know: "I can't keep that as a skill: ${words}."`);
+    }
+    d.consent.noteSaveRequest(st, fold, { runId: run.id, typed, scope, skill: compiled.skill }, env, ctx.now);
+    return directive(typed, `The last job here worked, so to keep it as they asked, run: trail skills add ${compiled.skill.name} --run ${run.id}. `
+        + 'Trail checks their words in this session before it keeps anything. Then tell them the line it prints.');
+}
+/** 3.2 step 6, no run to keep: Trail's reason, then the words for the person (D101). */
+function nothingToKeep(last) {
+    if (last.none === 'skill') {
+        const name = flatLine(last.skillName ?? 'a skill', 60);
+        return `That job already ran from the skill ${name}, so Trail has nothing new to keep. Let them know: "That job already ran from the skill ${name}, so there's nothing new to keep."`;
+    }
+    if (last.none === 'failed') {
+        return `${ONLY_WORKED} and the last one didn't finish cleanly. Let them know: "There's nothing to keep yet: the last job didn't finish cleanly. Ask me again once it works."`;
+    }
+    if (last.none === 'unproven') {
+        return `${ONLY_WORKED} and the last command passed only through its fallback (|| echo, || true or || :), so Trail can't tell it worked. `
+            + 'Let them know: "There\'s nothing to keep yet: the last command only passed through its fallback, so I can\'t tell it worked. Ask me again once it works."';
+    }
+    return `${ONLY_WORKED} and no job has finished here since the conversation started or was last compacted. Let them know: "There's nothing to keep yet: no job has finished here since the conversation was last compacted. Ask me again once one works."`;
+}
+const ONLY_WORKED = 'Trail keeps only a job that worked,';
+/**
+ * 3.2 step 7: another job, over 25 words or 2 hours end a block; a status question or a short follow-up keeps it.
+ * D116 item 3: a line the fold folded into the block's own run (a go-ahead, an answer to the agent's question) keeps
+ * it at any length: the block lives as long as its run.
+ */
+function endBlocks(st, typed, np, now, cands, run) {
+    const live = st.injected.filter((i) => i.live);
+    if (!live.length)
+        return;
+    const job = np.status ? null : matchJob(askText(typed))?.job ?? null;
+    for (const inj of live) {
+        const age = now.getTime() - Date.parse(inj.at);
+        const skillJob = job === null ? null : cands().find((c) => c.ref.id === inj.skillId)?.skill.meta.job ?? null;
+        const ownRun = run !== null && inj.runId === run.id;
+        if (!(age < LIVE_MS) || (np.wordCount > MAX_ASK_WORDS && !ownRun) || (job !== null && job !== skillJob))
+            inj.live = false;
+    }
+}
+/** 3.2 step 8, job or name cue: a block, or a re-arm of the one this epoch already has. Null: its filled steps are refused. */
+/**
+ * The run of this very prompt, when this hook's catch-up folded its typed line (Claude Code writes the line before
+ * the hook runs): the block it brings belongs to that run, and no other ask typed a moment before or after it.
+ * Null when the line isn't on disk yet (the next fold links the block) or it started no run.
+ */
+function askRun(st, fold, typed) {
+    const last = fold?.typed[fold.typed.length - 1];
+    if (!last || last.sha !== typedSha(typed))
+        return null;
+    const run = currentRun(st);
+    return run && Date.parse(run.lastAt) >= Date.parse(last.at) ? run : null;
+}
+function bring(ctx, st, cue, d, deadline, run) {
+    const { env, now } = ctx;
+    const c = cue.cand;
+    // The risk rules on the steps as the block would show them, values filled in (a default can be edited by hand).
+    if (refusedAtRecall(c.skill, cue.values))
+        return null;
+    const prior = [...injectedThisEpoch(st)].reverse().find((i) => i.skillId === c.ref.id && i.cue !== 'check');
+    if (prior && sameValues(prior.params, cue.values)) {
+        // D65: a re-armed block is for the next ask's run. D137: after a hand-off it continues that block's run and window,
+        // but only while the fold continued that run (the 2-hour wait); a new run starts a new window with nothing handed.
+        if (prior.handed?.length && (run === null || run.id === prior.runId))
+            Object.assign(prior, { live: true, runId: run?.id ?? prior.runId });
+        else {
+            delete prior.handed;
+            Object.assign(prior, { live: true, at: now.toISOString(), runId: run?.id ?? null });
+        }
+        if (run)
+            run.skillId = c.ref.id;
+        return { context: `[trail] Same job as before: start from the steps of skill ${nameOf(c)} above.` };
+    }
+    // Part 7: what the person's live learnings say of these steps; the block says each once, and its steps are what credit reads.
+    // Read before the probes, so their budget is what is left. Past the deadline the block goes without them, and the prompt's learnings lines still say them.
+    const marks = d.clock() < deadline ? recallMarks(c.skill.steps, stepLearnings({ repoKeys: scopeKeys(ctx, st), checkout: ctx.checkout, env }), d.shown()) : [];
+    const budgetMs = Math.max(0, Math.min(PROBE_BUDGET_MS, deadline - d.clock()));
+    const probes = runProbes(c.skill, ctx.checkout, now, env, { ...d.probes, budgetMs });
+    const lastFail = c.state?.lastFails?.length ? c.state.lastFails[c.state.lastFails.length - 1] : null;
+    // Phase 2 (3.2 step 5): the anchors' CLI scan gets only what the 400 ms leave after the probes (the hook's clock may be a test's).
+    const anchorDeadline = Date.now() + Math.max(0, deadline - d.clock());
+    const block = runBlock(c, { values: cue.values, notes: cue.notes, probes, canAsk: canAsk(ctx), header: 'job', lastFail, anchorDeadline, marks });
+    const inj = withReadyFailed(injectionFor({ ...c, skill: withFixes(c.skill, marks) }, cue.values, cue.kind, st.epoch, now), probes);
+    if (run) {
+        inj.runId = run.id;
+        run.skillId = c.ref.id;
+    }
+    // New values: the full block replaces that injection's values and steps (same injId, a fresh run).
+    if (prior)
+        st.injected[st.injected.indexOf(prior)] = { ...inj, injId: prior.injId };
+    else
+        st.injected.push(inj);
+    const said = saidIn(block, marks);
+    return { context: block, ...(hostFacts(env, ctx.host).promptNotice ? { notice: useNotice(c) } : {}), ...(said.length ? { said } : {}) };
+}
+/** The check uses the values of the block it checks, and any the question itself names. */
+function checkValues(cue, np, block) {
+    const defs = cue.cand.skill.params;
+    const plain = resolveParams(defs, {}).values;
+    const asked = Object.fromEntries(Object.entries(cue.values).filter(([k, v]) => plain[k] !== v));
+    return { ...cue.values, ...(block?.params ?? {}), ...asked };
+}
+const sameValues = (a, b) => {
+    const ka = Object.keys(a).sort();
+    const kb = Object.keys(b).sort();
+    return ka.length === kb.length && ka.every((k, i) => k === kb[i] && a[k] === b[k]);
+};
+//# sourceMappingURL=prompt-skills.js.map