@nanonets/graft 0.24.0 → 0.25.0

package/dist/trace/housekeeping.js

@@ -0,0 +1,93 @@
+/**
+ * Housekeeping for the skills files under `~/.trail` (design 1.3, 2): at most
+ * once an hour per machine, old run sheets (7 days), session files (30 days),
+ * receipts (1 day), held items shown more than 24 hours ago, and probe
+ * results older than 10 minutes. Re-exported from `skill-session.ts`.
+ */
+import { readdirSync, rmSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { readJsonSafe, trailPath, withLock, writePrivate } from '../util/private-fs.js';
+import { pruneRunSheets } from './run-sheets.js';
+const HOUR = 3600_000;
+const DAY = 24 * HOUR;
+/** Files in `dir` (not folders) whose mtime is older than `ms`, removed. */
+function dropOld(dir, ms, now, keep = () => false) {
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const name of names) {
+        if (keep(name))
+            continue;
+        const p = join(dir, name);
+        try {
+            const st = statSync(p);
+            if (st.isFile() && now.getTime() - st.mtimeMs > ms)
+                rmSync(p, { force: true });
+        }
+        catch { /* gone already */ }
+    }
+}
+/** Held items shown more than 24 h ago (held/<name>/held.json `shownAt`). */
+function dropShownHeld(dir, now) {
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const name of names) {
+        if (name.startsWith('.'))
+            continue;
+        const held = readJsonSafe(join(dir, name, 'held.json'));
+        const shown = typeof held?.shownAt === 'string' ? Date.parse(held.shownAt) : NaN;
+        if (!Number.isNaN(shown) && now.getTime() - shown > DAY) {
+            try {
+                rmSync(join(dir, name), { recursive: true, force: true });
+            }
+            catch { /* next time */ }
+        }
+    }
+}
+/** state/probes.json entries `{ at }` older than 10 minutes, under `entries` or at the top level. */
+function dropOldProbes(path, now) {
+    const raw = readJsonSafe(path);
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return;
+    const box = raw.entries && typeof raw.entries === 'object' && !Array.isArray(raw.entries) ? raw.entries : raw;
+    let changed = false;
+    for (const [k, v] of Object.entries(box)) {
+        const at = v && typeof v === 'object' ? Date.parse(String(v.at)) : NaN;
+        if (!Number.isNaN(at) && now.getTime() - at > 10 * 60_000) {
+            delete box[k];
+            changed = true;
+        }
+    }
+    if (changed)
+        writePrivate(path, JSON.stringify(raw));
+}
+/** At most once an hour (state/housekeeping.json): pruneRunSheets; sessions/*.json and their .gate.json and
+ *  .post.jsonl (and crash leftovers beside them) older than 30 days; receipts older than 1 day; held items shown more than 24 h ago;
+ *  expired state/probes.json entries. */
+export function housekeeping(now = new Date(), env) {
+    const mark = trailPath(env, 'state', 'housekeeping.json');
+    const last = readJsonSafe(mark);
+    const lastAt = typeof last?.at === 'string' ? Date.parse(last.at) : NaN;
+    if (!Number.isNaN(lastAt) && now.getTime() - lastAt < HOUR && now.getTime() >= lastAt)
+        return;
+    // One process does it; another one meanwhile skips it.
+    withLock(mark, () => {
+        writePrivate(mark, JSON.stringify({ at: now.toISOString() }));
+        pruneRunSheets(now, env);
+        // Every file: a session's state, gate and marks, and what a crash left beside them (.lock, .steal, .stale, .tmp).
+        dropOld(trailPath(env, 'sessions'), 30 * DAY, now);
+        dropOld(trailPath(env, 'receipts'), DAY, now, (n) => !n.endsWith('.json'));
+        dropShownHeld(trailPath(env, 'held'), now);
+        dropOldProbes(trailPath(env, 'state', 'probes.json'), now);
+    }, 0);
+}
+//# sourceMappingURL=housekeeping.js.map

package/dist/trace/housekeeping.js.map

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

package/dist/trace/jobs.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The job vocabulary (design 4.14): which short typed asks name a job, from a
+ * fixed list of verb classes ported from the mining's lexicon. Only canonical
+ * words and values of known shapes leave this file, never the typed text.
+ *
+ * An ask is a job only when it is 25 words or fewer, not a status or history
+ * question ("did you push?", "is it live", "..., right?") and not a problem
+ * report ("prod is broken", "why ..."). Fenced code, quoted lines and very
+ * long lines are pasted context, not the ask, and are dropped first.
+ *
+ * Tuned on one person's prompts; the real near misses live in the private
+ * lab, and every test here is synthetic. Pure: no files, no clock.
+ */
+import type { CheckFamily, JobClass, JobMatch, PromptParams } from './types.js';
+type JobDef = {
+    job: JobClass;
+    pattern: RegExp;
+    exclude?: RegExp;
+    vocab: Record<string, string>;
+    noun: string;
+    checkWords: string[];
+};
+export declare const JOB_CLASSES: ReadonlyArray<JobDef>;
+/** Jobs that can reach moment 2, and the check families that fit each (4.2). */
+export declare const OFFER_FAMILIES: Readonly<Partial<Record<JobClass, CheckFamily[]>>>;
+/** pr-green and sweep: judgement loops, left out by spec 23. Never offered, never compiled. */
+export declare const JUDGEMENT_JOBS: ReadonlySet<JobClass>;
+/** Lead words may stack ("ok so did it..."); a tag that asks for a yes ("..., didn't it?") is a status question too. */
+export declare const STATUS_OR_HISTORY: RegExp;
+export declare const PROBLEM_REPORT: RegExp;
+export declare const MAX_ASK_WORDS = 25;
+/**
+ * The person's own ask in a typed message: fenced code blocks (an unclosed one
+ * runs to the end), quoted lines (`>`) and lines of 800 characters or more
+ * dropped. Every matcher of typed text reads this, not the raw message.
+ */
+export declare function askText(typed: string): string;
+export declare function wordCount(text: string): number;
+export declare function isStatusOrHistory(text: string): boolean;
+/**
+ * Job of a typed ask, or null. Applies the 25-word cap, the status/history filter and the problem filter. `hasBranch`:
+ * whether the repo has a branch by a name, for "deploy it to <branch>" (D136 (3)); without it only beta, prod and
+ * staging name a ship.
+ */
+export declare function matchJob(typedText: string, opts?: {
+    anyLength?: boolean;
+    hasBranch?: (name: string) => boolean;
+}): JobMatch | null;
+/** Shape values in a typed ask (semver, sha, #PR, port, branch after 'branch', date). */
+export declare function promptParams(typedText: string): PromptParams;
+export {};
+//# sourceMappingURL=jobs.d.ts.map

package/dist/trace/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/trace/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmChF,KAAK,MAAM,GAAG;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAMtI,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,MAAM,CA2D7C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,CAE5E,CAAC;AAEH,+FAA+F;AAC/F,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,QAAQ,CAA4C,CAAC;AAE9F,wHAAwH;AACxH,eAAO,MAAM,iBAAiB,QACsU,CAAC;AACrW,eAAO,MAAM,cAAc,QAAmI,CAAC;AAC/J,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAKD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CAAO,GAAG,QAAQ,GAAG,IAAI,CAqBtI;AAID,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAiB5D"}

package/dist/trace/jobs.js

@@ -0,0 +1,182 @@
+/** Words that may sit between "run" and "tests": never a conjunction or another verb ("run it and write tests"). */
+const GAP = String.raw `(?:(?!(?:and|then|or|but|to|write|add|fix|create|update|make|remove|delete|skip)\b)[\w./:-]+ ){0,3}?`;
+const RUNNER = String.raw `(?:npm|pnpm|yarn|bun)(?: run)? test\b|npx (?:vitest|jest|playwright test)\b|go test\b|cargo test\b|make test\w*|python3? -m pytest\b|pytest\b|bats\b|rspec\b|jest\b|vitest\b`;
+/** D136 (3): up to 2 words naming what to test before a runner ("sql-output bats"), never a verb that sets it up. */
+const NAMED = String.raw `(?:(?!(?:and|then|or|but|to|write|add|fix|create|update|make|remove|delete|skip|install|configure|set|setup|upgrade|migrate|use|switch|what|how|which|why)\b)[\w./:-]+ ){0,2}?`;
+/** The tests job (4.14, D56b). */
+const TESTS = new RegExp([
+    String.raw `\b(?:re-?run|re run|run|kick off|execute)\b (?:the |all (?:of )?(?:the )?|our |my |these |those )?${GAP}(?:tests?|test ?suites?|suites?|specs?)\b`,
+    String.raw `\b(?:run|re-?run)\b (?:\S+ ){0,2}?(?:${RUNNER})`,
+    String.raw `^\s*(?:please |can you |could you |pls )?(?:${RUNNER})`,
+    // D136 (3): "sql-output bats please", "api tests", "sql-output tests please": the whole ask names what to test.
+    String.raw `^\s*(?:please |can you |could you |pls )?(?:the )?${NAMED}(?:bats|rspec|pytest|jest|vitest)\b(?: (?:please|pls|again|now))?\s*[.!]*$`,
+    String.raw `^\s*(?:please |pls )?(?:the )?(?!(?:write|add|fix|new|more|unit|my|our|your|these|those|some|any|no)\b)[\w./:-]+ tests?(?: (?:please|pls|again|now))?\s*[.!]*$`,
+    String.raw `\bmake sure (?:that )?(?:the |all (?:the )?)?(?:\w+ )?tests? (?:still )?(?:pass|are passing|are green|go green)\b`,
+    String.raw `\bget (?:the |all (?:the )?)?(?:\w+ )?tests? (?:passing|green|to pass)\b`,
+    String.raw `\b(?:integration|e2e|end-to-end|smoke|regression|acceptance) tests?\b`,
+    String.raw `\btest (?:it|this|that|everything|all(?: of (?:it|this))?) before (?:push|commit|merg|ship|deploy)\w*`,
+].join('|'));
+/**
+ * Not the tests job: how-to and wh- questions, a status question with no lead verb ("integration tests
+ * green?"), writing or changing tests, a test environment or account, testing it yourself.
+ */
+const TESTS_NOT = new RegExp([
+    String.raw `^\s*(?:(?:ok(?:ay)?|so|and|hmm)[\s,]+)*(?:how|what|which|where|when|why|who)\b`,
+    String.raw `\b(?:tests?|suites?|specs?)\b[^?]{0,30}\b(?:pass\w*|green|red|fail\w*|ok|done|finish\w*|running|broken)\s*\?\s*$`,
+    String.raw `\b(?:write|writing|add|adding|create|fix|fixing|update|remove|delete|skip|mock|refactor|rewrite|cover)\w* (?:\w+ ){0,3}?(?:tests?|specs?)\b`,
+    String.raw `\btest (?:env|environment|channel|account|data|mode|user|key|card|server|db|database|webhook|token|number|payment)s?\b`,
+    String.raw `\b(?:myself|yourself|ourselves)\b|\bfor (?:me|us|him|her|them) to (?:re-?)?(?:run|test)\b`,
+    String.raw `\b(?:install|configure|set ?up|upgrade|migrate|switch)\w* (?:\w+ ){0,3}?(?:to )?(?:bats|rspec|pytest|jest|vitest)\b`,
+].join('|'));
+/** D136 (3): ship or deploy (it) to a named place: the ship job when the repo has a branch by that name. */
+const SHIP_TO = /\b(?:ship|deploy)\w*(?: (?:it|this|that|them))? to (?:the )?([\w./-]+)/;
+/** Surface forms to canonical words, one map per class. */
+const words = (pairs) => Object.fromEntries(Object.entries(pairs).flatMap(([canon, forms]) => [canon, ...forms].map((f) => [f, canon])));
+export const JOB_CLASSES = [
+    {
+        job: 'release',
+        pattern: /\b(publish\w*|re-?publish|release\w* (a |the )?(new |next )?(version|ver|patch|minor|major)|cut (a |that |the )?release|redo the (npm )?publish|npm publish|bump (the )?version)\b/,
+        exclude: /publish\w* (on|to) (the )?(web|website)|call it publish|publishable|\brelease (the )?notes\b|\b(i|we)( have|'ve| had)? (already )?released\b/,
+        vocab: words({ publish: ['publishing', 'published', 'publishes', 'republish', 're-publish'], release: ['releases', 'releasing'], bump: ['bumping'], npm: [] }),
+        noun: 'release',
+        checkWords: ['published', 'released', 'out', 'live', 'up'],
+    },
+    {
+        job: 'ship',
+        pattern: /\b(push|puch|ff|fast.?forward|promote|deploy|ship|merge|update|move|get)\w* (\w+ ){0,4}(to |for |on |in |into )?(the )?(beta|prod|production|staging)\b|\bff to prod\b|\bupdate prod\b|^\s*(please )?ship it\b/,
+        exclude: /not working on (prod|beta)/,
+        vocab: words({
+            push: ['pushed', 'pushing', 'puch'], ff: ['fast-forward', 'fastforward'], promote: ['promoted'], deploy: ['deploying', 'deployed'], ship: ['shipping'],
+            merge: ['merged'], update: ['updated'], beta: [], prod: ['production'], staging: [],
+        }),
+        noun: 'ship',
+        checkWords: ['live', 'deployed', 'updated', 'up', 'out', 'green'],
+    },
+    {
+        job: 'pr-green',
+        pattern: /\b(ci\b|ci's|checks? (are |is )?fail\w*|failing (tests|checks)|failed tests|review comments|nitpicks|make (the )?ci (go )?green|ci goes? green|review.?bot)/,
+        vocab: words({ ci: ["ci's"], checks: ['check'], review: ['reviews'] }),
+        noun: 'CI fix',
+        checkWords: [],
+    },
+    {
+        job: 'sweep',
+        pattern: /\b(go through|sweep|verify|check)\b.{0,40}\b(all|other|more|newer|backlog|recent)\b.{0,25}\b(prs|pull requests|issues)\b|\bclose (more )?(issues|prs)\b/,
+        vocab: words({ sweep: [], prs: ['pull-requests'], issues: [] }),
+        noun: 'PR sweep',
+        checkWords: [],
+    },
+    {
+        job: 'run-local',
+        pattern: /\b(open (it|this|the \w+)? ?(locally|in (the )?browser|on (a )?local)|localhost|local server|run it locally|open locally)\b/,
+        vocab: words({ open: [], locally: [], localhost: [] }),
+        noun: 'local run',
+        checkWords: [],
+    },
+    {
+        job: 'report',
+        pattern: /\b(any new (users|people)|new users? (since|till|through|we have|came)|how many (new )?(users|people) (have|came|joined))\b/,
+        vocab: words({ new: [], users: ['user', 'people'], signups: ['signup'] }),
+        noun: 'report',
+        checkWords: [],
+    },
+    {
+        // D56b, rebuilt from real asks: none said "run the integration tests"; they said "run the tests", "rerun
+        // the e2e tests", named the runner, or "make sure the tests pass". "Test this thoroughly end to end" is a
+        // feature check the agent designs each time, not a test run, so it stays out.
+        job: 'tests',
+        pattern: TESTS,
+        exclude: TESTS_NOT,
+        vocab: words({ integration: [], e2e: ['end-to-end'], tests: ['test', 'suite', 'suites', 'specs', 'spec'] }),
+        noun: 'test run',
+        checkWords: ['passing', 'green', 'pass', 'passed'],
+    },
+];
+/** Jobs that can reach moment 2, and the check families that fit each (4.2). */
+export const OFFER_FAMILIES = Object.freeze({
+    release: ['npm-view'], ship: ['deploy', 'ls-remote', 'push'], tests: ['tests'], report: ['query'],
+});
+/** pr-green and sweep: judgement loops, left out by spec 23. Never offered, never compiled. */
+export const JUDGEMENT_JOBS = new Set(['pr-green', 'sweep']);
+/** Lead words may stack ("ok so did it..."); a tag that asks for a yes ("..., didn't it?") is a status question too. */
+export const STATUS_OR_HISTORY = /^\s*(?:(?:okay|ok|so|and|also|hey|btw|wait|hmm|tell(?: me)?)[\s,]+)*(did|is|was|has|have|are|were|does|how did|what did|when did|where did)\b|\b(did (you|we)|is it (live|done|published|deployed|out|up|green)|how did (we|you)|check (now )?if)\b|\b(right|correct)\?\s*$|\b(?:is|are|was|were|did|does|do|has|have)n'?t (?:it|they|we|you|that|he|she)\?\s*$/i;
+export const PROBLEM_REPORT = /\b(not working|(does|did|do)n'?t work|did not work|does not work|went wrong|still (broken|failing|not)|is broken)\b|^\s*why\b/i;
+export const MAX_ASK_WORDS = 25;
+/**
+ * The person's own ask in a typed message: fenced code blocks (an unclosed one
+ * runs to the end), quoted lines (`>`) and lines of 800 characters or more
+ * dropped. Every matcher of typed text reads this, not the raw message.
+ */
+export function askText(typed) {
+    const t = String(typed ?? '').replace(/```[\s\S]*?(?:```|$)/g, '\n');
+    return t.split(/\r?\n/).filter((l) => !/^\s*>/.test(l) && l.length < 800).join('\n').trim();
+}
+export function wordCount(text) {
+    return String(text ?? '').split(/\s+/).filter(Boolean).length;
+}
+export function isStatusOrHistory(text) {
+    return STATUS_OR_HISTORY.test(askText(text));
+}
+const URL = /\b[a-z][a-z0-9+.-]*:\/\/\S+/gi;
+const VERSION = /\bv?\d+\.\d+\.\d+(?:-[0-9a-z.]+)?\b/gi;
+/**
+ * Job of a typed ask, or null. Applies the 25-word cap, the status/history filter and the problem filter. `hasBranch`:
+ * whether the repo has a branch by a name, for "deploy it to <branch>" (D136 (3)); without it only beta, prod and
+ * staging name a ship.
+ */
+export function matchJob(typedText, opts = {}) {
+    const ask = askText(typedText);
+    // The cap is for matching skills; D120 (1)'s continuation of the open run's own job reads any length.
+    if (!ask || (!opts.anyLength && wordCount(ask) > MAX_ASK_WORDS))
+        return null;
+    if (STATUS_OR_HISTORY.test(ask) || PROBLEM_REPORT.test(ask))
+        return null;
+    const t = ask.toLowerCase().replace(URL, ' url ').replace(VERSION, ' ver ').replace(/\bfast forward/g, 'fast-forward').replace(/\s+/g, ' ').trim();
+    for (const c of JOB_CLASSES) {
+        if (!c.pattern.test(t) || c.exclude?.test(t))
+            continue;
+        const found = [];
+        for (const w of t.split(/[^a-z0-9'-]+/)) {
+            const canon = c.vocab[w] ?? c.vocab[w.replace(/'s$/, '')];
+            if (canon && !found.includes(canon))
+                found.push(canon);
+        }
+        return { job: c.job, words: found };
+    }
+    const to = opts.hasBranch ? SHIP_TO.exec(t) : null;
+    if (to && opts.hasBranch(to[1].replace(/[.]+$/, ''))) {
+        const ship = JOB_CLASSES.find((c) => c.job === 'ship');
+        if (!ship.exclude?.test(t))
+            return { job: 'ship', words: [...new Set(t.split(/[^a-z0-9'-]+/).map((w) => ship.vocab[w]).filter((w) => !!w))] };
+    }
+    return null;
+}
+const NOT_A_BRANCH = new Set(['to', 'and', 'the', 'is', 'of', 'for', 'from', 'then', 'with', 'in', 'on', 'it', 'so', 'a', 'name', 'called', 'named']);
+/** Shape values in a typed ask (semver, sha, #PR, port, branch after 'branch', date). */
+export function promptParams(typedText) {
+    const t = askText(typedText);
+    const out = {};
+    const version = /\bv?(\d+\.\d+\.\d+(?:-[0-9A-Za-z.]+)?)\b/.exec(t);
+    if (version)
+        out.version = version[1].replace(/\.$/, '');
+    for (const m of t.matchAll(/\b[0-9a-f]{7,40}\b/g)) {
+        if (/\d/.test(m[0]) && /[a-f]/.test(m[0])) {
+            out.sha = m[0];
+            break;
+        }
+    }
+    const pr = /(?:^|\s)#(\d+)\b|\bpr\s*#?(\d+)\b|\/pull\/(\d+)/i.exec(t);
+    if (pr)
+        out.pr = pr[1] ?? pr[2] ?? pr[3];
+    const port = /\b(?:localhost|127\.0\.0\.1|0\.0\.0\.0):(\d{2,5})\b|--port[= ](\d{2,5})\b|\bPORT=(\d{2,5})\b|\bport (\d{2,5})\b/i.exec(t);
+    if (port)
+        out.port = port[1] ?? port[2] ?? port[3] ?? port[4];
+    const branch = /\bbranch(?: called| named)? ([\w./-]+)/i.exec(t);
+    if (branch && !NOT_A_BRANCH.has(branch[1].toLowerCase()) && branch[1].length >= 2)
+        out.branch = branch[1];
+    const date = /\b20\d\d-\d\d-\d\d\b/.exec(t);
+    if (date)
+        out.date = date[0];
+    return out;
+}
+//# sourceMappingURL=jobs.js.map

package/dist/trace/jobs.js.map

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

package/dist/trace/known-repo.d.ts

@@ -0,0 +1,3 @@
+/** Never throws: a read that fails knows nothing. */
+export declare function repoKnown(key: string | null | undefined, checkout: string | null | undefined, env: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=known-repo.d.ts.map

package/dist/trace/known-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-repo.d.ts","sourceRoot":"","sources":["../../src/trace/known-repo.ts"],"names":[],"mappings":"AA0CA,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAO9H"}

package/dist/trace/known-repo.js

@@ -0,0 +1,55 @@
+/**
+ * D117 (3), J16: is this a repo Trail knows? It has a `.trail/` folder (trail
+ * init made it, or the team committed one), or its key is in
+ * `~/.trail/repos/index.json` (a root commit's key, or an alias either side).
+ * Outside one, the global hooks keep no pool and make no offers there; walls
+ * and guardrails still apply everywhere.
+ *
+ * Reads only: one stat and one small JSON file, no git, no process.
+ */
+import { realpathSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { trailHome } from '../notes/trail-home.js';
+import { readJsonSafe, trailPath } from '../util/private-fs.js';
+function isDir(p) {
+    try {
+        return statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** `<checkout>/.trail` is a folder and not the Trail home itself (a home folder that is a work tree). */
+function hasTrailFolder(checkout, env) {
+    const dot = join(checkout, '.trail');
+    if (!isDir(dot))
+        return false;
+    try {
+        return realpathSync(dot) !== realpathSync(trailHome(env));
+    }
+    catch {
+        return true;
+    }
+}
+function inIndex(key, env) {
+    const raw = readJsonSafe(trailPath(env, 'repos', 'index.json'));
+    if (!raw || typeof raw !== 'object')
+        return false;
+    const map = (v) => (v && typeof v === 'object' && !Array.isArray(v) ? v : {});
+    const aliases = map(raw.aliases);
+    if (Object.prototype.hasOwnProperty.call(aliases, key) || Object.values(aliases).includes(key))
+        return true;
+    return Object.values(map(raw.roots)).includes(key);
+}
+/** Never throws: a read that fails knows nothing. */
+export function repoKnown(key, checkout, env) {
+    try {
+        if (checkout && hasTrailFolder(checkout, env))
+            return true;
+        return typeof key === 'string' && key !== '' && inIndex(key, env);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=known-repo.js.map

package/dist/trace/known-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-repo.js","sourceRoot":"","sources":["../../src/trace/known-repo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEhE,SAAS,KAAK,CAAC,CAAS;IACtB,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,yGAAyG;AACzG,SAAS,cAAc,CAAC,QAAgB,EAAE,GAAsB;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,GAAG,CAAC,KAAK,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,GAAW,EAAE,GAAsB;IAClD,MAAM,GAAG,GAAG,YAAY,CAAyC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IACxG,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,GAAG,GAAG,CAAC,CAAU,EAA2B,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7I,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5G,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,SAAS,CAAC,GAA8B,EAAE,QAAmC,EAAE,GAAsB;IACnH,IAAI,CAAC;QACH,IAAI,QAAQ,IAAI,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3D,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/trace/pool.d.ts

@@ -0,0 +1,40 @@
+import type { JobClass, JobMatch } from './types.js';
+export interface PoolDay {
+    d: string;
+    s: string;
+    costly: boolean;
+}
+export interface PoolEntry {
+    words: string[];
+    days: PoolDay[];
+    lastGoodRun: string | null;
+    lastSeen: string;
+    shownAtInit: boolean;
+}
+export interface PoolFile {
+    v: 1;
+    jobs: Partial<Record<JobClass, PoolEntry>>;
+}
+export interface RepeatVerdict {
+    ok: boolean;
+    sessionDays: number;
+    dates: number;
+    costlyDays: number;
+    need: number;
+}
+/** join(trailHome, 'repos', ...repoKey.split('/'), 'pool.json'): the same folder as repoPlace(..).dir. */
+export declare function poolPath(repoKey: string, env?: NodeJS.ProcessEnv): string;
+export declare function readPool(repoKey: string, env?: NodeJS.ProcessEnv): PoolFile;
+/** Adds or updates the (d, s) day for a job (costly OR-ed), prunes days older than 45 and entries unseen for 45 days. Locked; null when the lock timed out. */
+export declare function notePoolDay(repoKey: string, m: JobMatch, day: PoolDay, goodRun: string | null, env?: NodeJS.ProcessEnv, now?: Date): PoolEntry | null;
+/** 3rd session-day in 45 days (4th when extraDay), at least 2 of them costly. */
+export declare function repeatedEnough(e: PoolEntry, extraDay: boolean, now?: Date): RepeatVerdict;
+/** Every job counted in the last 45 days, every repo, for `trail skills` (2.10). */
+export declare function watching(env?: NodeJS.ProcessEnv, now?: Date): Array<{
+    repoKey: string;
+    job: JobClass;
+    sessionDays: number;
+    costlyDays: number;
+    need: number;
+}>;
+//# sourceMappingURL=pool.d.ts.map

package/dist/trace/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/trace/pool.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,OAAO;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE;AAClE,MAAM,WAAW,SAAS;IAAG,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE;AACnI,MAAM,WAAW,QAAQ;IAAG,CAAC,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAA;CAAE;AAC9E,MAAM,WAAW,aAAa;IAAG,EAAE,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAepH,0GAA0G;AAC1G,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAGzE;AA6BD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,QAAQ,CAE3E;AAED,+JAA+J;AAC/J,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,SAAS,GAAG,IAAI,CAyBjK;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAE,IAAiB,GAAG,aAAa,CASrG;AA4BD,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,GAAE,IAAiB,GAAG,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAa1K"}

package/dist/trace/pool.js

@@ -0,0 +1,154 @@
+/**
+ * The pool (design 2.3): for one repo, the days each job came back, kept in
+ * `~/.trail/repos/<key>/pool.json` beside phase 0's repo folder. A day is a
+ * session-day: the local date a run started on and the session's hash, with
+ * whether that run cost much (5+ tool calls or a failure). Job words from a
+ * fixed vocabulary and days only: no prompt text, no commands.
+ *
+ * Only jobs that can reach moment 2 are counted (release, ship, tests,
+ * report). A job is due an offer on its 3rd session-day in the last 45 days
+ * counting today (the 4th under the governor), at least 2 of them costly.
+ * Days older than that are dropped on every write.
+ */
+import { readdirSync, statSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { localDate, readSettings } from '../skills/settings.js';
+import { readJsonSafe, trailPath, withLock, writePrivate } from '../util/private-fs.js';
+import { OFFER_FAMILIES } from './jobs.js';
+/** The window: today and the 44 days before it. */
+const WINDOW_DAYS = 45;
+const MAX_WORDS = 12;
+const DATE = /^\d{4}-\d{2}-\d{2}$/;
+/** The first local date inside the 45-day window that ends today. */
+function windowStart(now) {
+    const d = new Date(now.getFullYear(), now.getMonth(), now.getDate() - (WINDOW_DAYS - 1), 12);
+    return localDate(d);
+}
+const offerJob = (job) => Object.prototype.hasOwnProperty.call(OFFER_FAMILIES, job);
+/** join(trailHome, 'repos', ...repoKey.split('/'), 'pool.json'): the same folder as repoPlace(..).dir. */
+export function poolPath(repoKey, env) {
+    const parts = String(repoKey).split('/').filter((p) => p && p !== '.' && p !== '..');
+    return trailPath(env, 'repos', ...parts, 'pool.json');
+}
+function cleanEntry(v) {
+    if (!v || typeof v !== 'object' || Array.isArray(v))
+        return null;
+    const e = v;
+    const days = Array.isArray(e.days)
+        ? e.days.filter((d) => !!d && typeof d.d === 'string' && DATE.test(d.d) && typeof d.s === 'string').map((d) => ({ d: d.d, s: d.s, costly: d.costly === true }))
+        : [];
+    return {
+        words: Array.isArray(e.words) ? e.words.filter((w) => typeof w === 'string').slice(0, MAX_WORDS) : [],
+        days,
+        lastGoodRun: typeof e.lastGoodRun === 'string' ? e.lastGoodRun : null,
+        lastSeen: typeof e.lastSeen === 'string' ? e.lastSeen : days.map((d) => d.d).sort().at(-1) ?? '',
+        shownAtInit: e.shownAtInit === true,
+    };
+}
+function parsePool(raw) {
+    const jobs = {};
+    const r = raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
+    if (r.jobs && typeof r.jobs === 'object' && !Array.isArray(r.jobs)) {
+        for (const [job, v] of Object.entries(r.jobs)) {
+            const e = cleanEntry(v);
+            if (e && offerJob(job))
+                jobs[job] = e;
+        }
+    }
+    return { v: 1, jobs };
+}
+export function readPool(repoKey, env) {
+    return parsePool(readJsonSafe(poolPath(repoKey, env)));
+}
+/** Adds or updates the (d, s) day for a job (costly OR-ed), prunes days older than 45 and entries unseen for 45 days. Locked; null when the lock timed out. */
+export function notePoolDay(repoKey, m, day, goodRun, env, now = new Date()) {
+    if (!offerJob(m.job) || !DATE.test(day.d))
+        return null;
+    const path = poolPath(repoKey, env);
+    const from = windowStart(now);
+    const done = withLock(path, () => {
+        const raw = readJsonSafe(path);
+        const keep = raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
+        const pool = parsePool(raw);
+        const e = pool.jobs[m.job] ?? { words: [], days: [], lastGoodRun: null, lastSeen: day.d, shownAtInit: false };
+        for (const w of m.words)
+            if (e.words.length < MAX_WORDS && !e.words.includes(w))
+                e.words.push(w);
+        const same = e.days.find((x) => x.d === day.d && x.s === day.s);
+        if (same)
+            same.costly = same.costly || day.costly;
+        else
+            e.days.push({ d: day.d, s: day.s, costly: day.costly });
+        e.days.sort((a, b) => (a.d < b.d ? -1 : a.d > b.d ? 1 : 0));
+        if (goodRun)
+            e.lastGoodRun = goodRun;
+        if (day.d > e.lastSeen)
+            e.lastSeen = day.d;
+        pool.jobs[m.job] = e;
+        for (const [job, entry] of Object.entries(pool.jobs)) {
+            entry.days = entry.days.filter((x) => x.d >= from);
+            if (!entry.days.length || entry.lastSeen < from)
+                delete pool.jobs[job];
+        }
+        writePrivate(path, JSON.stringify({ ...keep, v: 1, jobs: pool.jobs }));
+        return pool.jobs[m.job] ?? null;
+    });
+    return done.ok ? done.value : null;
+}
+/** 3rd session-day in 45 days (4th when extraDay), at least 2 of them costly. */
+export function repeatedEnough(e, extraDay, now = new Date()) {
+    const from = windowStart(now);
+    const today = localDate(now);
+    const days = e.days.filter((x) => x.d >= from && x.d <= today);
+    const sessionDays = new Set(days.map((x) => `${x.d}|${x.s}`)).size;
+    const costlyDays = new Set(days.filter((x) => x.costly).map((x) => `${x.d}|${x.s}`)).size;
+    const dates = new Set(days.map((x) => x.d)).size;
+    const need = extraDay ? 4 : 3;
+    return { ok: sessionDays >= need && costlyDays >= 2, sessionDays, dates, costlyDays, need };
+}
+/** The governor from the settings cache (4.13 step 7): 3 or more answers lately, fewer than 1 in 3 a yes. */
+function governorOn(env) {
+    const nine = readSettings(env).lastNine;
+    return nine.length >= 3 && nine.filter((a) => a === 'yes').length * 3 < nine.length;
+}
+/** Every pool.json under `dir`, as repo keys (the folders between `repos/` and the file). */
+function poolKeys(root, dir, depth, out) {
+    if (depth > 6)
+        return;
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const name of names) {
+        const p = join(dir, name);
+        if (name === 'pool.json')
+            out.push(relative(root, dir).split(sep).join('/'));
+        else if (!name.startsWith('.')) {
+            try {
+                if (statSync(p).isDirectory())
+                    poolKeys(root, p, depth + 1, out);
+            }
+            catch { /* gone */ }
+        }
+    }
+}
+/** Every job counted in the last 45 days, every repo, for `trail skills` (2.10). */
+export function watching(env, now = new Date()) {
+    const root = trailPath(env, 'repos');
+    const keys = [];
+    poolKeys(root, root, 0, keys);
+    const extra = keys.length ? governorOn(env) : false;
+    const out = [];
+    for (const repoKey of keys.filter(Boolean)) {
+        for (const [job, e] of Object.entries(readPool(repoKey, env).jobs)) {
+            const v = repeatedEnough(e, extra, now);
+            if (v.sessionDays > 0)
+                out.push({ repoKey, job, sessionDays: v.sessionDays, costlyDays: v.costlyDays, need: v.need });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=pool.js.map