@nanonets/graft 0.24.1 → 0.25.0

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":"AAiBA,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAKpD,OAAO,EACL,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,UAAU,GACzJ,MAAM,kBAAkB,CAAC;AAmB1B,0BAA0B;AAC1B,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAE1D;AAqBD,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,EAAE,CAgB/D;AAED,iIAAiI;AACjI,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,WAAW,EAAE,CAiB5D;AAsBD,MAAM,WAAW,SAAS;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE;AAC3H,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,iBAAiB,GAAG,UAAU,CAAA;CAAE,CAAC;AAEvI,mCAAmC;AACnC,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,aAAa,CA0BvD;AA0BD,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,CAGnH;AAED,kHAAkH;AAClH,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,CAEtH;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,EACvH,EAAE,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAe7D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAc3F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,CAKpH;AAgBD,+CAA+C;AAC/C,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,MAA8D,CAAC;AACjI,8CAA8C;AAC9C,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,MAA6D,CAAC;AAC/H,qDAAqD;AACrD,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,MAAsC,CAAC;AAGxF,uHAAuH;AACvH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED,mBAAmB;AACnB,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/skills/offers.js

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