@nanonets/graft 0.24.0 → 0.25.0

package/dist/skills/offer-words-2.js

@@ -0,0 +1,194 @@
+import { flatLine } from '../notes/flatten.js';
+import { JOB_CLASSES } from '../trace/jobs.js';
+import { hostFacts } from './host-facts.js';
+import { FROM_TRAIL, quoteOf } from './directive-words.js';
+import { notSaved } from './offer-words.js';
+/** Moment 5 (4.7). `line2*` end with the keys the person answers with. */
+export const UPDATE_COPY = {
+    line1Update: '{check} This time step {step} of {name} failed and {cmds} worked instead.',
+    line1Preference: '{check} This time {steps} of {name} ran as {cmds}, the way {follows} says.',
+    line2Preference: 'Change {steps} of {name} to match? {size} (yes / show me / no)',
+    line1Extend: '{check} This time {name} also needed {cmds} {where}.',
+    line1Split: '{check} This time {name} ran only steps {from} to {to}, as it did last time.',
+    line2Lesson: 'Fold your {date} lesson into {name} as {steps}? {size} (yes / show me / no)',
+    line2TwoUses: 'Add {it} to {name} as {steps}? {They} ran in your last 2 {jobs}. {size} (yes / show me / no)',
+    line2Update: 'Change step {step} of {name} to the command that worked? {size} (yes / show me / no)',
+    line2Split: 'Keep steps {from} to {to} as their own skill, {new}, beside {name}? (yes / show me / no)',
+    size: '{n} line changes.',
+    handEdited: 'You changed {name} by hand, so Trail writes it beside your file for you to compare.',
+    reason: 'Skill {name} just ran and checked out, and this run did one thing differently; Trail offers once to change the skill to match.',
+    offered: 'Trail offered to change the skill {name} to match how this job just ran',
+    reasonSplit: 'A skill Trail brought in just ran only some of its steps, the same ones as last time; Trail offers once to keep those steps as a skill of their own, {name}.',
+    offeredSplit: 'Trail offered to keep steps of a skill as a skill of their own, {name}',
+};
+/** Moment 6 (4.8, J15, P16). */
+export const DRIFT_COPY = {
+    line1: '{check} {name} needs a fix, and this {job} went another way: {how}.',
+    line2: 'Replace {name} with the {k} steps that just worked, retire it, or leave it? (replace / retire / leave it)',
+    line2Hand: 'Write the {k} steps that just worked beside your edited {name}, retire it, or leave it? (replace / retire / leave it)',
+    reason: 'Skill {name} needs a fix, and this job just checked out another way; Trail offers once to replace it, retire it or leave it.',
+    offered: 'Trail offered to replace the skill {name} with the steps that just worked',
+};
+/** The retire proposal (4.9, P13). */
+export const RETIRE_COPY = {
+    line1: 'Trail brought in skill {name} {n} times lately, and its steps ran in {k} of them.',
+    line2: 'Retire it? trail skills restore {name} brings it back. (retire / keep it)',
+    reason: 'Trail brought in skill {name} for jobs here and its steps mostly did not run; it offers once, ever, to retire a skill like that.',
+    offered: 'Trail offered to retire the skill {name}',
+    retired: 'Trail retired {name}. Tell them in one line, with how to bring it back: trail skills restore {name}.',
+    busy: "Trail couldn't retire it just now: the person can run trail forget {name}. Tell them that in one line.",
+};
+const LINE_MAX = 400;
+const fill = (t, v) => t.replace(/\{(\w+)\}/g, (m, k) => (v[k] === undefined ? m : String(v[k])));
+const one = (v, max = 60) => flatLine(v, max);
+/** A command as a line shows it (R24): one line, at most 60 characters, its own single quotes made double, in single quotes. */
+export const quoted = (cmd) => `'${one(String(cmd ?? '').replace(/'/g, '"'), 60)}'`;
+const both = (items) => (items.length < 2 ? items.join('') : `${items.slice(0, -1).join(', ')} and ${items[items.length - 1]}`);
+const nounOf = (job) => JOB_CLASSES.find((j) => j.job === job)?.noun ?? job ?? 'job';
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+/** A lesson's local date ('2026-10-30') as 'Oct 30'; never shifted by the time zone. */
+function dayWords(local) {
+    const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(String(local ?? ''));
+    return m && MONTHS[Number(m[2]) - 1] ? `${MONTHS[Number(m[2]) - 1]} ${Number(m[3])}` : 'an earlier';
+}
+const pairOf = (a, b) => [flatLine(a, LINE_MAX), flatLine(b, LINE_MAX)];
+/** 4.7: moment 5's two lines. */
+export function updateLines(f) {
+    const C = UPDATE_COPY;
+    const name = one(f.name);
+    const check = one(f.check, 160);
+    const cmds = both(f.cmds.slice(0, 2).map(quoted));
+    const size = f.handEdited ? fill(C.handEdited, { name }) : fill(C.size, { n: Math.max(0, Math.floor(f.changes)) });
+    if (f.op === 'split' && f.split) {
+        const s = { from: f.split.from, to: f.split.to };
+        return pairOf(fill(C.line1Split, { check, name, ...s }), fill(C.line2Split, { ...s, name, new: one(f.split.name) }));
+    }
+    if (f.op === 'update') {
+        if (f.why === 'preference' && f.follows) {
+            const ns = f.steps?.length ? f.steps : [f.at];
+            const steps = ns.length === 1 ? `step ${ns[0]}` : `steps ${both(ns.map(String))}`;
+            const all = f.cmds.map(quoted);
+            const ran = all.length > 2 ? `${all.slice(0, 2).join(', ')} and ${all.length - 2} more` : both(all);
+            return pairOf(fill(C.line1Preference, { check, name, steps, cmds: ran, follows: one(f.follows) }), fill(C.line2Preference, { steps, name, size }));
+        }
+        return pairOf(fill(C.line1Update, { check, name, step: f.at, cmds }), fill(C.line2Update, { step: f.at, name, size }));
+    }
+    const n = Math.min(2, Math.max(1, f.cmds.length));
+    const steps = n === 1 ? `step ${f.at + 1}` : `steps ${f.at + 1} and ${f.at + 2}`;
+    const where = f.at > 0 ? `after step ${f.at}` : 'before step 1';
+    const line1 = fill(C.line1Extend, { check, name, cmds, where });
+    const line2 = f.why === 'lesson'
+        ? fill(C.line2Lesson, { date: dayWords(f.lessonDate), name, steps, size })
+        : fill(C.line2TwoUses, { it: n === 1 ? 'it' : 'them', They: n === 1 ? 'It' : 'They', name, steps, jobs: `${nounOf(f.job)}s`, size });
+    return pairOf(line1, line2);
+}
+/** 4.8: moment 6's two lines; at most 2 named each way. */
+export function driftLines(f) {
+    const C = DRIFT_COPY;
+    const name = one(f.name);
+    const skipped = both(f.skipped.slice(0, 2).map((s) => `${quoted(s.cmd)} (step ${s.n})`));
+    const ran = both(f.ran.slice(0, 2).map(quoted));
+    const how = skipped && ran ? `it skipped ${skipped} and ran ${ran}` : skipped ? `it skipped ${skipped}` : `it ran ${ran}`;
+    const line1 = fill(C.line1, { check: one(f.check, 160), name, job: nounOf(f.job), how });
+    return pairOf(line1, fill(f.handEdited ? C.line2Hand : C.line2, { name, k: Math.max(0, Math.floor(f.steps)) }));
+}
+/** 4.9: the retire proposal's two lines. */
+export function retireLines(f) {
+    const name = one(f.name);
+    return pairOf(fill(RETIRE_COPY.line1, { name, n: Math.floor(f.fired), k: Math.floor(f.followed) }), fill(RETIRE_COPY.line2, { name }));
+}
+/** Why the 2 lines end the reply (as 1a and 1b say it). */
+const SO_THEY_ANSWER = 'so the person can answer (Trail reads their answer to the last line, so keep it as it is)';
+const CHECKS = 'Trail checks their answer in this session before it changes anything';
+const CHECKS_KEEP = 'Trail checks their answer in this session before it keeps anything';
+const idOf = (o) => one(o.offerId, 40);
+const runOf = (o) => one(o.runId, 40);
+const isSplit = (o) => o.moment === 'update' && o.fold?.op === 'split';
+/** The skill an offer is about: its folder name. A split's offer names the new skill (its lines name the old one). */
+const skillName = (o) => one(o.name);
+function reason(o) {
+    const name = skillName(o);
+    if (o.moment === 'drift')
+        return fill(DRIFT_COPY.reason, { name });
+    if (o.moment === 'retire')
+        return fill(RETIRE_COPY.reason, { name });
+    if (isSplit(o))
+        return fill(UPDATE_COPY.reasonSplit, { name });
+    return fill(UPDATE_COPY.reason, { name });
+}
+/** The command a yes runs (4.11): `trail skills update` for update, extend and replace; 1a's add for a split. */
+export function yesCommand2(o) {
+    if (isSplit(o))
+        return `trail skills add ${one(o.fold?.splitName ?? o.name)} --run ${runOf(o)}`;
+    return `trail skills update ${one(o.name)} --offer ${idOf(o)}`;
+}
+/** After "show me": the draft, then the offer's own last line again, so Trail reads the answer to it (D72). */
+const showStep = (o) => `run trail skills draft ${runOf(o)} --print, paste what it prints as it is, then ask the last line again: "${one(o.lines?.[1] ?? '', 400)}"`;
+function onAnswer(o) {
+    if (o.moment === 'retire') {
+        return 'If they answer retire, Trail retires it itself when it reads their answer, and tells you what to say. If they say keep it, Trail changes nothing.';
+    }
+    const checks = isSplit(o) ? CHECKS_KEEP : CHECKS;
+    const yesWord = o.moment === 'drift' ? 'replace' : 'yes';
+    const yes = `If they answer ${yesWord}, run: ${yesCommand2(o)} (${checks}), then tell them the line it prints. `;
+    const show = `If they say show me, ${showStep(o)}. `;
+    if (o.moment === 'drift')
+        return `${yes}If they say retire, Trail retires it itself when it reads their answer. ${show}If they say leave it, Trail changes nothing.`;
+    return `${yes}${show}If they say no, Trail changes nothing.`;
+}
+/** 3.5 (R11): the Stop block's reason for moments 5, 6 and the retire proposal, given its 2 lines. */
+export function blockReason2(o, [a, b]) {
+    return `[trail] ${FROM_TRAIL} ${reason(o)} When you finish this reply, end it with these 2 lines, ${SO_THEY_ANSWER}:\n${a}\n${b}\n${onAnswer(o)}`;
+}
+/** 3.4: the post-tool text, for completeness (these moments go out at Stop only, R13). */
+export function postTool2(o, [a, b]) {
+    return `[trail] ${FROM_TRAIL} ${reason(o)} If this check finishes the job, end your reply with these 2 lines, ${SO_THEY_ANSWER}:\n${a}\n${b}\n`
+        + "If the job isn't done yet, or you are about to ask the person something, leave them out.";
+}
+/** `[trail] From Trail, ... They typed "x" <tail>`: the D107 opening, quoting the person's words when there are any. */
+function said(typed, tail) {
+    const q = quoteOf(typed);
+    return ['[trail]', FROM_TRAIL, q ? `They typed "${q}"${tail.startsWith('to ') ? ' ' : '. '}${tail}` : tail].join(' ');
+}
+function offered(o) {
+    const name = skillName(o);
+    if (o.moment === 'drift')
+        return fill(DRIFT_COPY.offered, { name });
+    if (o.moment === 'retire')
+        return fill(RETIRE_COPY.offered, { name });
+    if (isSplit(o))
+        return fill(UPDATE_COPY.offeredSplit, { name });
+    return fill(UPDATE_COPY.offered, { name });
+}
+/**
+ * 4.7 to 4.10: what the agent reads on the person's answer, as context on the answering prompt (a bare no as a block
+ * where the host shows its reason). `c.retired`: the retire the prompt hook made (the folder name), or null when the
+ * store was busy and nothing moved.
+ */
+export function answer2(a, o, c, env, typed, host) {
+    switch (a) {
+        case 'yes': {
+            const what = isSplit(o) ? 'to the new skill Trail showed,' : 'to the change Trail showed for';
+            const check = isSplit(o) ? CHECKS_KEEP : CHECKS;
+            const then = isSplit(o) ? ' Then tell them the line it prints.' : '';
+            return { context: said(typed, `${what} ${skillName(o)}. Run: ${yesCommand2(o)}. ${check}.${then}`) };
+        }
+        case 'show':
+            return { context: said(typed, `${offered(o)}, and they want to see it first. To show them, ${showStep(o)}, since Trail reads their answer to that question.`) };
+        case 'retire': {
+            const name = one(o.retire?.name ?? o.name);
+            return { context: said(typed, c.retired ? fill(RETIRE_COPY.retired, { name: one(c.retired) }) : fill(RETIRE_COPY.busy, { name })) };
+        }
+        case 'no': {
+            const say = notSaved(c).replace(/^OK, not saved\./, 'OK, nothing changed.');
+            if (hostFacts(env, host).promptBlockShown)
+                return { block: `trail: ${say}` };
+            return { context: said(typed, `${offered(o)}, and they said no, so Trail changed nothing. Let them know: "${say}"`) };
+        }
+        default:
+            return o.channel === 'notice' ? {} : {
+                context: said(typed, `That isn't an answer to Trail's offer (${offered(o).replace(/^Trail offered /, '')}), so Trail dropped the offer and changed nothing. No need to bring the offer up again.`),
+            };
+    }
+}
+//# sourceMappingURL=offer-words-2.js.map

package/dist/skills/offer-words-2.js.map

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

package/dist/skills/offer-words.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The words of a repeated-job offer and of the answers to it (design 3.4,
+ * 3.5, 4.12, spec 9). Re-exported from `offers.ts`, where the design names
+ * them.
+ *
+ * An offer is exactly 2 lines the agent says word for word: what checked out
+ * and what it cost, in numbers counted from the transcript, then the
+ * question with its three keys. Every value is flattened to one line, so a
+ * branch name or a version from a command can never add a line. Never
+ * "memory" or "remember", no em dashes: a test greps every string here.
+ */
+import type { Host } from '../trace/host.js';
+import type { DialectUse } from '../trace/dialect.js';
+import type { CheckHit, JobClass, PendingOffer } from '../trace/types.js';
+import type { HookOut } from './types.js';
+export interface OfferFacts {
+    job: JobClass;
+    check: CheckHit;
+    ordinal: number;
+    unit: 'day' | 'time';
+    commands: number;
+    failed: number;
+    steps: number;
+    where: 'this repo' | 'every repo';
+    branches: string[];
+}
+/** For `trail skills` (2.10), once per time the governor turns on. */
+export declare const GOVERNOR_LINE = "you kept fewer than 1 in 3 offers lately, so a job now has to come back a 4th day before Trail offers it";
+export declare function ordinalWord(n: number): string;
+/** 1b (4.13): the check's own line, as moment 2's line 1 opens (`Tests pass (12 passed).`), for moment 3's line 1. */
+export declare function checkLine(check: CheckHit, branches?: string[]): string;
+/** 4.12's line 2: the question an offer's yes answers. `n` is the skill's steps (a separate check counts as one). */
+export declare function keepLine(n: number, where?: 'this repo' | 'every repo'): string;
+/** `line` is a line 2 that `keepLine` (or moment 3's `repairLines`) writes, and nothing else (a question of the agent's own is not). */
+export declare function isKeepLine(line: string): boolean;
+/** The question after "show me" and the draft (4.12): a yes after the draft answers this. */
+export declare const KEEP_IT = "Keep it? (yes / no)";
+/** The reply's last words are `line` (said word for word as its last line): nothing after it, no question of the agent's own. */
+export declare function endsWithLine(reply: string, line: string): boolean;
+/** 4.12: exactly 2 lines, every number counted from the trace, every value flattened. */
+export declare function offerLines(f: OfferFacts): [string, string];
+/**
+ * 3.5: the Stop block's reason, which the agent reads. D101: from Trail, with Trail's own reason for offering; the
+ * 2 lines are Trail's question for the person, never an order to recite.
+ */
+export declare function stopBlockReason(o: PendingOffer, transcriptPath?: string | null, use?: DialectUse): string;
+/** 3.5: the Stop notice the person reads (channel `notice`). */
+export declare function noticeText(o: PendingOffer, transcriptPath?: string | null, use?: DialectUse): string;
+/** 3.4: the passing check's PostToolUse context (channel `post-tool`). */
+export declare function postToolOfferText(o: PendingOffer, transcriptPath?: string | null): string;
+/** What "OK, not saved." grows into: the way to stop offers on the first no ever, the pause when it starts. */
+export declare function notSaved(c: {
+    paused: boolean;
+    firstNo: boolean;
+}): string;
+/**
+ * 4.12, as context on the answering prompt; a bare no as a block where the host shows its reason (O2). D101: each
+ * directive says it is from Trail, quotes the words the person typed (`typed`, from the prompt hook's payload, never
+ * stored) and says why. 1b: a moment 3 or 4 offer's answers are `answer1b`'s, which need no lines.
+ */
+export declare function answerDirective(a: 'yes' | 'show' | 'no' | 'other', o: PendingOffer, c: {
+    paused: boolean;
+    firstNo: boolean;
+}, env?: NodeJS.ProcessEnv, typed?: string, host?: Host): HookOut;
+//# sourceMappingURL=offer-words.d.ts.map

package/dist/skills/offer-words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offer-words.d.ts","sourceRoot":"","sources":["../../src/skills/offer-words.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAY1C,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACtE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC;IACnF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,sEAAsE;AACtE,eAAO,MAAM,aAAa,6GAA6G,CAAC;AAKxI,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7C;AAoDD,sHAAsH;AACtH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAE,MAAM,EAAO,GAAG,MAAM,CAE1E;AAED,qHAAqH;AACrH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,WAAW,GAAG,YAA0B,GAAG,MAAM,CAG3F;AAKD,wIAAwI;AACxI,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhD;AAED,6FAA6F;AAC7F,eAAO,MAAM,OAAO,wBAAwB,CAAC;AAK7C,iIAAiI;AACjI,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAO1D;AAuBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,YAAY,EAAE,cAAc,GAAE,MAAM,GAAG,IAAW,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,MAAM,CAU/G;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,CAAC,EAAE,YAAY,EAAE,cAAc,GAAE,MAAM,GAAG,IAAW,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,MAAM,CAK1G;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,EAAE,cAAc,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,CAQ/F;AAED,+GAA+G;AAC/G,wBAAgB,QAAQ,CAAC,CAAC,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAIzE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,KAAK,GAAE,MAAW,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,CAmB7M"}

package/dist/skills/offer-words.js

@@ -0,0 +1,205 @@
+import { flatLine } from '../notes/flatten.js';
+import { JOB_CLASSES } from '../trace/jobs.js';
+import { hostFacts } from './host-facts.js';
+import { directive, FROM_TRAIL } from './directive-words.js';
+import { offerLinesOf } from './offer-lines.js';
+import { answer1b, blockReason1b, postTool1b } from './offer-words-1b.js';
+import { answer2, blockReason2, postTool2 } from './offer-words-2.js';
+/** Phase 2 (R11): moments 5 and 6 and the retire proposal have words of their own (offer-words-2.ts). */
+const isPhase2 = (o) => o.moment === 'update' || o.moment === 'drift' || o.moment === 'retire';
+/** For `trail skills` (2.10), once per time the governor turns on. */
+export const GOVERNOR_LINE = 'you kept fewer than 1 in 3 offers lately, so a job now has to come back a 4th day before Trail offers it';
+/** One line, at most `max` characters; '' when nothing is left. */
+const one = (v, max = 40) => flatLine(v, max);
+export function ordinalWord(n) {
+    const k = Math.max(0, Math.floor(n));
+    const teen = k % 100;
+    if (teen >= 11 && teen <= 13)
+        return `${k}th`;
+    return `${k}${['th', 'st', 'nd', 'rd'][k % 10] ?? 'th'}`;
+}
+const plural = (n, word) => `${n} ${word}${n === 1 ? '' : 's'}`;
+/** "beta and prod", "beta, staging and prod". */
+function listed(items) {
+    if (items.length < 2)
+        return items.join('');
+    return `${items.slice(0, -1).join(', ')} and ${items[items.length - 1]}`;
+}
+/** The ship subject and its verb: "beta and prod are both", "prod is", "beta, staging and prod are all". */
+function shipSubject(branches) {
+    const b = [...new Set(branches.map((x) => one(x)).filter(Boolean))];
+    if (!b.length)
+        return null;
+    if (b.length === 1)
+        return `${b[0]} is`;
+    return `${listed(b)} are ${b.length === 2 ? 'both' : 'all'}`;
+}
+/** 4.12's lead: what checked out, from the check's facts. Facts missing: the plainer words. */
+function lead(f) {
+    const facts = f.check.facts;
+    const sha = one(facts.sha ?? '').slice(0, 7);
+    switch (f.check.family) {
+        case 'npm-view': {
+            const v = one(facts.version ?? '');
+            return `Published ${v || 'the new version'}: npm shows it.`;
+        }
+        case 'deploy': {
+            const state = one(facts.state ?? '') || 'ready';
+            const subject = shipSubject(f.branches);
+            if (subject)
+                return `Shipped: ${subject}${sha ? ` at ${sha}` : ''} and ${state}.`;
+            return `Shipped: the deploy${sha ? ` at ${sha}` : ''} is ${state}.`;
+        }
+        case 'ls-remote':
+        case 'push': {
+            const remote = one(facts.remote ?? '') || 'the remote';
+            const subject = shipSubject(f.branches.length ? f.branches : facts.branch ? [facts.branch] : []);
+            if (subject && sha)
+                return `Shipped: ${subject} at ${sha} on ${remote}.`;
+            if (subject)
+                return `Shipped: ${subject.replace(/ (?:is|are (?:both|all))$/, '')} moved on ${remote}.`;
+            return `Shipped: ${sha ? `${sha} is` : 'it is'} on ${remote}.`;
+        }
+        case 'tests': {
+            const n = facts.passedCount;
+            return typeof n === 'number' && Number.isFinite(n) && n > 0 ? `Tests pass (${Math.floor(n)} passed).` : 'Tests pass.';
+        }
+        case 'query':
+            return 'Done: the numbers are in.';
+        default:
+            return 'Done: the check passed.';
+    }
+}
+/** 1b (4.13): the check's own line, as moment 2's line 1 opens (`Tests pass (12 passed).`), for moment 3's line 1. */
+export function checkLine(check, branches = []) {
+    return lead({ check, branches });
+}
+/** 4.12's line 2: the question an offer's yes answers. `n` is the skill's steps (a separate check counts as one). */
+export function keepLine(n, where = 'this repo') {
+    const k = Math.max(0, Math.floor(n));
+    return `Keep the ${k === 1 ? 'one' : k} that worked as a skill, just for you in ${where === 'every repo' ? 'every repo' : 'this repo'}? (yes / show me / no)`;
+}
+const KEEP_RE = /^Keep the (?:one|[1-9]\d*) that worked as a skill, just for you in (?:this repo|every repo)\? \(yes \/ show me \/ no\)$/;
+/** Moment 3's line 2 for a skill (4.13, offer-repair.ts `repairLines`). */
+const REPAIR_KEEP_RE = /^Keep the [1-9]\d* working steps as a skill, just for you in this repo\? \(yes \/ show me \/ no\)$/;
+/** `line` is a line 2 that `keepLine` (or moment 3's `repairLines`) writes, and nothing else (a question of the agent's own is not). */
+export function isKeepLine(line) {
+    const l = String(line ?? '');
+    return KEEP_RE.test(l) || REPAIR_KEEP_RE.test(l);
+}
+/** The question after "show me" and the draft (4.12): a yes after the draft answers this. */
+export const KEEP_IT = 'Keep it? (yes / no)';
+/** Spaces collapsed, and what a reply may dress its last line with (bold, italics, quotes, a full stop) taken off the end. */
+const bare = (t) => String(t ?? '').replace(/\s+/g, ' ').trim().replace(/[\s*_`"'\u2018\u2019\u201c\u201d.]+$/u, '');
+/** The reply's last words are `line` (said word for word as its last line): nothing after it, no question of the agent's own. */
+export function endsWithLine(reply, line) {
+    const l = bare(line);
+    return l.length > 0 && bare(reply).endsWith(l);
+}
+/** 4.12: exactly 2 lines, every number counted from the trace, every value flattened. */
+export function offerLines(f) {
+    const noun = JOB_CLASSES.find((j) => j.job === f.job)?.noun ?? 'job';
+    const commands = Math.max(0, Math.floor(f.commands));
+    const failed = Math.max(0, Math.floor(f.failed));
+    const cost = failed ? `${plural(commands, 'command')} this time, ${failed} failed` : `${plural(commands, 'command')} this time`;
+    const line1 = `${lead(f)} That's the ${ordinalWord(f.ordinal)} ${f.unit === 'day' ? 'day' : 'time'} I've worked out this ${noun} from scratch (${cost}).`;
+    return [flatLine(line1, 400), flatLine(keepLine(f.steps, f.where), 400)];
+}
+/**
+ * 1b (R12): the offer's lines through offerLinesOf (a correction's are rebuilt from the transcript); null when it has
+ * none, and then its texts are empty, so nothing goes out.
+ */
+function lines(o, transcriptPath, use) {
+    const l = offerLinesOf(o, transcriptPath, process.env, use);
+    return l ? [flatLine(l[0], 400), flatLine(l[1], 400)] : null;
+}
+const nameOf = (o) => one(o.name, 60);
+const runOf = (o) => one(o.runId, 40);
+/** D101: Trail's own reason for an offer, from its count: "Trail noticed this job worked out on 3 days; it offers once to keep it." */
+function offerReason(o) {
+    const n = Math.floor(Number(o.seen?.n));
+    const how = !Number.isFinite(n) || n < 2 ? 'more than once' : o.seen?.unit === 'time' ? `${n} times` : `on ${n} days`;
+    return `Trail noticed this job worked out ${how}; it offers once to keep it.`;
+}
+/** Why the 2 lines end the reply: the person answers the last one, and Trail matches that answer to its words. */
+const SO_THEY_ANSWER = 'so the person can answer (Trail reads their answer to the last line, so keep it as it is)';
+/**
+ * 3.5: the Stop block's reason, which the agent reads. D101: from Trail, with Trail's own reason for offering; the
+ * 2 lines are Trail's question for the person, never an order to recite.
+ */
+export function stopBlockReason(o, transcriptPath = null, use) {
+    const both = lines(o, transcriptPath, use);
+    if (!both)
+        return '';
+    if (isPhase2(o))
+        return blockReason2(o, both);
+    if (o.moment !== 'repeated')
+        return blockReason1b(o, both);
+    const [a, b] = both;
+    return `[trail] ${FROM_TRAIL} ${offerReason(o)} If the job is done, end your reply with these 2 lines, ${SO_THEY_ANSWER}:\n${a}\n${b}\n`
+        + `If they answer yes, run: trail skills add ${nameOf(o)} --run ${runOf(o)} (Trail checks their yes in this session before it keeps anything), then tell them the line it prints. `
+        + `If they say show me, run trail skills draft ${runOf(o)} --print, paste what it prints, and ask "${KEEP_IT}". `
+        + 'If they say no, Trail keeps nothing.';
+}
+/** 3.5: the Stop notice the person reads (channel `notice`). */
+export function noticeText(o, transcriptPath = null, use) {
+    const both = lines(o, transcriptPath, use);
+    if (!both)
+        return '';
+    const [a, b] = both;
+    return `trail: ${a}\n${b}`;
+}
+/** 3.4: the passing check's PostToolUse context (channel `post-tool`). */
+export function postToolOfferText(o, transcriptPath = null) {
+    const both = lines(o, transcriptPath);
+    if (!both)
+        return '';
+    if (isPhase2(o))
+        return postTool2(o, both);
+    if (o.moment !== 'repeated')
+        return postTool1b(o, both);
+    const [a, b] = both;
+    return `[trail] ${FROM_TRAIL} ${offerReason(o)} If this check finishes the job, end your reply with these 2 lines, ${SO_THEY_ANSWER}:\n${a}\n${b}\n`
+        + "If the job isn't done yet, or you are about to ask the person something, leave them out.";
+}
+/** What "OK, not saved." grows into: the way to stop offers on the first no ever, the pause when it starts. */
+export function notSaved(c) {
+    if (c.paused)
+        return "OK, not saved. I won't offer skills in this repo for 2 weeks. (To stop them everywhere: trail skills offers off)";
+    if (c.firstNo)
+        return 'OK, not saved. (To stop these offers: trail skills offers off)';
+    return 'OK, not saved.';
+}
+/**
+ * 4.12, as context on the answering prompt; a bare no as a block where the host shows its reason (O2). D101: each
+ * directive says it is from Trail, quotes the words the person typed (`typed`, from the prompt hook's payload, never
+ * stored) and says why. 1b: a moment 3 or 4 offer's answers are `answer1b`'s, which need no lines.
+ */
+export function answerDirective(a, o, c, env = process.env, typed = '', host) {
+    if (isPhase2(o))
+        return answer2(a, o, c, env, typed, host);
+    if (o.moment !== 'repeated')
+        return answer1b(a, o, notSaved(c), env, typed, host);
+    switch (a) {
+        case 'yes':
+            return { context: directive(typed, `${OFFERED}, and this is their answer. To keep it as they said, run: trail skills add ${nameOf(o)} --run ${runOf(o)}. ${CHECKS_YES} Then tell them the line it prints.`) };
+        case 'show':
+            return { context: directive(typed, `${OFFERED}, and they want to see it first. Run trail skills draft ${runOf(o)} --print, paste what it prints as it is, then ask "${KEEP_IT}", since Trail reads their answer to that question.`) };
+        case 'no': {
+            const say = notSaved(c);
+            if (hostFacts(env, host).promptBlockShown)
+                return { block: `trail: ${say}` };
+            return { context: directive(typed, `${OFFERED}, and they said no, so Trail kept nothing. Let them know: "${say}"`) };
+        }
+        default:
+            // The agent said the offer (stop, post-tool): it can let it go. A notice it never saw needs nothing.
+            return o.channel === 'notice' ? {} : {
+                context: directive(typed, "That isn't an answer to Trail's offer to keep the last job as a skill, so Trail dropped the offer and kept nothing. No need to bring the offer up again."),
+            };
+    }
+}
+/** What an answer directive says the offer was. */
+const OFFERED = 'Trail offered to keep the last job as a skill';
+/** Why the agent may run the add: the gate checks the yes, the agent's word is not taken for it. */
+const CHECKS_YES = 'Trail checks their yes in this session before it keeps anything.';
+//# sourceMappingURL=offer-words.js.map

package/dist/skills/offer-words.js.map

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

package/dist/skills/offers.d.ts

@@ -0,0 +1,66 @@
+import type { PendingOffer } from '../trace/types.js';
+import type { Answer, OfferLine } from './types.js';
+export { answerDirective, endsWithLine, isKeepLine, keepLine, noticeText, offerLines, postToolOfferText, stopBlockReason, GOVERNOR_LINE, KEEP_IT, type OfferFacts, } from './offer-words.js';
+/** <home>/offers.jsonl */
+export declare function offersPath(env?: NodeJS.ProcessEnv): string;
+export declare function readOffers(env?: NodeJS.ProcessEnv): OfferLine[];
+/** OfferLine's `answer` as the final one, null when never answered (`OfferLine & { answer: Answer | null }` can't hold null). */
+export type OfferRecord = Omit<OfferLine, 'answer'> & {
+    answer: Answer | null;
+};
+/**
+ * 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 declare function foldOffers(lines: OfferLine[]): OfferRecord[];
+export interface BudgetCtx {
+    repoKey: string;
+    key: string;
+    sessionOfferUsed: boolean;
+    now?: Date;
+    env?: NodeJS.ProcessEnv;
+}
+export type BudgetVerdict = {
+    ok: true;
+    extraDay: boolean;
+    secondChance: boolean;
+} | {
+    ok: false;
+    why: 'session' | 'week' | 'first-week' | 'said-no' | 'paused' | 'off' | 'off-here' | 'no-answer-twice' | 'too-soon';
+};
+/** 4.13, steps 1 to 8 in order. */
+export declare function offerBudget(c: BudgetCtx): BudgetVerdict;
+export declare function recordShown(o: PendingOffer, repoKey: string, env?: NodeJS.ProcessEnv, now?: Date): void;
+/** A stop or post-tool offer the agent left out: the session stays spent; the week and the governor ignore it. */
+export declare function recordNotShown(o: PendingOffer, repoKey: string, env?: NodeJS.ProcessEnv, now?: Date): void;
+/**
+ * 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 declare function recordAnswer(o: PendingOffer, repoKey: string, a: Answer, env?: NodeJS.ProcessEnv, now?: Date, op?: OfferLine['op']): {
+    paused: boolean;
+    firstNo: boolean;
+};
+/**
+ * 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 declare function governorLine(env?: NodeJS.ProcessEnv, now?: Date): string | null;
+/**
+ * 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 declare function recordInitClosed(repoKey: string, key: string, env?: NodeJS.ProcessEnv, now?: Date): void;
+/** Moment 5's key: `<skillId>|update|v<n>`. */
+export declare const updateOfferKey: (skillId: string, version: number) => string;
+/** Moment 6's key: `<skillId>|drift|v<n>`. */
+export declare const driftOfferKey: (skillId: string, version: number) => string;
+/** The retire proposal's key: `<skillId>|retire`. */
+export declare const retireOfferKey: (skillId: string) => string;
+/** The skill a skill-keyed offer names (moments 4, 5, 6 and the retire proposal); null for a repo-keyed one (2, 3). */
+export declare function skillOfOfferKey(key: string): string | null;
+/** 'o-' + 6 hex */
+export declare function newOfferId(): string;
+//# sourceMappingURL=offers.d.ts.map

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

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