@nanonets/graft 0.23.1 → 0.24.1

package/dist/notes/team-check.js

@@ -0,0 +1,130 @@
+/**
+ * Whether something `trail init` found is fit to offer as a team learning:
+ * it is tied to code that exists now, and the repo doesn't already say it.
+ *
+ * A learning a teammate's Claude acts on names the file or function it is
+ * about; that is also what lets trail hand it to Claude when Claude opens
+ * that file. One that names no code is a habit or a status line, and stays
+ * the person's own. One that CLAUDE.md, AGENTS.md or an existing learning
+ * already says adds nothing but noise.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { contextDirFor } from "../context/node-file.js";
+import { loadGraphCached } from "../graph/load.js";
+import { listNotes, mentionedFiles } from "./notes.js";
+const TOUCH_LIMIT = 10;
+/** `foo_test.go`, `foo.test.ts`, `test/…`, `__tests__/…`, `spec/…`. */
+const TEST_PATH = /(?:^|\/)(?:tests?|__tests__|spec)\/|[._-](?:test|spec)\.[A-Za-z]+$|_test\.go$/;
+/** `Foo`, `Foo.bar`, `foo_bar()` in backticks: names a note can give a symbol by. */
+const TICKED = /`([A-Za-z_$][\w$]*(?:(?:\.|::|#)[A-Za-z_$][\w$]*)*)(?:\(\))?`/g;
+/**
+ * The code `text` is about, as `touches:` entries: files it names that exist
+ * in the checkout, `paths` that exist (an inline review comment's file), and
+ * `file#Symbol` for a backticked name the graph knows in one to three places.
+ * Empty when it names no code that exists now.
+ */
+export function codeAnchors(repo, text, paths = []) {
+    const out = [];
+    const add = (t) => {
+        if (out.length < TOUCH_LIMIT && !out.includes(t))
+            out.push(t);
+    };
+    for (const f of mentionedFiles(repo, text))
+        add(f);
+    for (const p of paths)
+        if (p && !p.startsWith("..") && existsSync(join(repo, p)))
+            add(p);
+    const graph = loadGraphCached(contextDirFor(repo));
+    if (!graph)
+        return out;
+    const names = new Set();
+    for (const m of text.matchAll(TICKED)) {
+        const last = m[1].split(/\.|::|#/).pop();
+        // Short or generic words (`id`, `run`) match too much to mean anything.
+        if (last.length >= 4)
+            names.add(last);
+    }
+    if (!names.size)
+        return out;
+    const byName = new Map();
+    for (const n of graph.nodes) {
+        if (n.kind === "file" || !names.has(n.name))
+            continue;
+        const list = byName.get(n.name) ?? [];
+        list.push(n.id);
+        byName.set(n.name, list);
+    }
+    for (const ids of byName.values()) {
+        // A test's fake of a function isn't what the note is about, when the real one is there.
+        const real = ids.filter((id) => !TEST_PATH.test(id.split("#")[0]));
+        const pick = real.length ? real : ids;
+        if (pick.length <= 3)
+            for (const id of pick)
+                add(id);
+    }
+    return out;
+}
+const STOP = new Set("the and for with from that this what when where which into does have has had been being they them their there then than also only just more most some such very will would should could must about after before over under using used make makes made keep keeps kept your yours ours here every each other".split(" "));
+/** The words that carry meaning: four letters or more, not filler. */
+export function contentWords(s) {
+    return new Set(s
+        .toLowerCase()
+        .split(/[^a-z0-9_]+/)
+        .filter((w) => w.length >= 4 && !STOP.has(w)));
+}
+/** Paragraphs and list items of a markdown text, each as its content words. */
+function chunks(text) {
+    return text
+        .split(/\n\s*\n|\n(?=\s*(?:[-*+]|\d+\.)\s)/)
+        .map(contentWords)
+        .filter((w) => w.size >= 3);
+}
+function readText(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+export function knownText(repo) {
+    const docs = ["CLAUDE.md", "AGENTS.md", ".claude/CLAUDE.md"].map((f) => readText(join(repo, f)));
+    let notes = [];
+    try {
+        notes = listNotes(repo, { branches: false });
+    }
+    catch {
+        /* no learnings yet */
+    }
+    return {
+        chunks: [...docs.flatMap(chunks), ...notes.flatMap((n) => chunks(n.body))],
+        titles: notes.map((n) => contentWords(n.title)).filter((w) => w.size > 0),
+    };
+}
+/**
+ * Whether the repo already says what a candidate says: most of its title's
+ * and lead's words in one paragraph of CLAUDE.md, AGENTS.md or a learning, or
+ * a learning with nearly the same title.
+ */
+export function alreadySaid(known, title, body) {
+    const t = contentWords(title);
+    if (t.size && known.titles.some((k) => overlap(t, k) >= 0.8 && overlap(k, t) >= 0.8))
+        return true;
+    const lead = body.replace(/^#+ .*$/gm, "").trim().slice(0, 400);
+    const words = contentWords(`${title} ${lead}`);
+    if (words.size < 5)
+        return false;
+    return known.chunks.some((c) => overlap(words, c) >= 0.6);
+}
+/** The share of `a`'s words that are in `b`. */
+function overlap(a, b) {
+    if (!a.size)
+        return 0;
+    let n = 0;
+    for (const w of a)
+        if (b.has(w))
+            n++;
+    return n / a.size;
+}
+//# sourceMappingURL=team-check.js.map

package/dist/notes/team-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-check.js","sourceRoot":"","sources":["../../src/notes/team-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,uEAAuE;AACvE,MAAM,SAAS,GAAG,+EAA+E,CAAC;AAElG,qFAAqF;AACrF,MAAM,MAAM,GAAG,gEAAgE,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY,EAAE,QAAkB,EAAE;IAC1E,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE;QACxB,IAAI,GAAG,CAAC,MAAM,GAAG,WAAW,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,KAAK,GAAG,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC;IACvB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,EAAG,CAAC;QAC3C,wEAAwE;QACxE,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,SAAS;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,wFAAwF;QACxF,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QACtC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;YAAE,KAAK,MAAM,EAAE,IAAI,IAAI;gBAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,IAAI,GAAG,IAAI,GAAG,CAClB,6SAA6S,CAAC,KAAK,CAAC,GAAG,CAAC,CACzT,CAAC;AAEF,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,IAAI,GAAG,CACZ,CAAC;SACE,WAAW,EAAE;SACb,KAAK,CAAC,aAAa,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAChD,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,IAAI;SACR,KAAK,CAAC,oCAAoC,CAAC;SAC3C,GAAG,CAAC,YAAY,CAAC;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAQD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjG,IAAI,KAAK,GAAsC,EAAE,CAAC;IAClD,IAAI,CAAC;QACH,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IACD,OAAO;QACL,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1E,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,KAAa,EAAE,IAAY;IACvE,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClG,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,gDAAgD;AAChD,SAAS,OAAO,CAAC,CAAc,EAAE,CAAc;IAC7C,IAAI,CAAC,CAAC,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,CAAC,IAAI,CAAC;QAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,CAAC,EAAE,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/notes/trail-home.d.ts

@@ -0,0 +1,3 @@
+/** `~/.trail`, or `$TRAIL_HOME`. */
+export declare function trailHome(env?: NodeJS.ProcessEnv, home?: string): string;
+//# sourceMappingURL=trail-home.d.ts.map

package/dist/notes/trail-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trail-home.d.ts","sourceRoot":"","sources":["../../src/notes/trail-home.ts"],"names":[],"mappings":"AAQA,oCAAoC;AACpC,wBAAgB,SAAS,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,CAEhG"}

package/dist/notes/trail-home.js

@@ -0,0 +1,12 @@
+/**
+ * `~/.trail` on its own, so a hook's fast path (the trace layer, `trail keep`'s
+ * check before a shell command) can find it without loading notes/home.ts and
+ * the front-matter parser that file needs to count learnings.
+ */
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+/** `~/.trail`, or `$TRAIL_HOME`. */
+export function trailHome(env = process.env, home = homedir()) {
+    return env.TRAIL_HOME ? resolve(env.TRAIL_HOME) : join(home, ".trail");
+}
+//# sourceMappingURL=trail-home.js.map

package/dist/notes/trail-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trail-home.js","sourceRoot":"","sources":["../../src/notes/trail-home.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,oCAAoC;AACpC,MAAM,UAAU,SAAS,CAAC,MAAyB,OAAO,CAAC,GAAG,EAAE,OAAe,OAAO,EAAE;IACtF,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACzE,CAAC"}

package/dist/skills/anchors-cli.d.ts

@@ -0,0 +1,33 @@
+export declare const MAX_SRC_FILES = 400;
+export declare const MAX_SRC_BYTES: number;
+/** One CLI program of the checkout: its bin name, its package folder and its bin target (the source folder is found only when scanning). */
+export interface Cli {
+    prog: string;
+    pkgDir: string;
+    target: string;
+}
+/** The bins of the nearest package.json from the step's folder up to the checkout: name to target. null when none or unreadable. */
+export declare function binsNear(checkout: string, dir: string): {
+    pkgDir: string;
+    bins: Map<string, string>;
+} | null;
+/** The folder a program's commands are registered in: `src/`, else its bin target's folder, inside the package. */
+export declare function srcOf(pkgDir: string, target: string): string | null;
+/**
+ * The names registered with `.command('x'`, `new Command('x'`, `createCommand('x'`, `.alias('x')` and an `.aliases` array in `text` (each
+ * literal's first word), into `out`. false when one isn't a plain string literal, or a default command exists: then
+ * any word may be the CLI's, and nothing is judged.
+ */
+export declare function registrations(text: string, out: Set<string>): boolean;
+/**
+ * The names the program registers, or null when not known. `scan: false` (SessionStart) reads only the cache, and
+ * only an entry under a day old; `scan: true` walks the files (stat only) and reads them only when the signature
+ * moved, then writes the cache. Past the deadline: null, nothing written.
+ */
+export declare function cliNames(cli: Cli, checkout: string, env: NodeJS.ProcessEnv, opts: {
+    scan: boolean;
+    deadline: number;
+}): string[] | null;
+/** Gone only when at least 3 other registrations were found, none dynamic, and `x` isn't among them (P23). */
+export declare function subcommandGone(names: string[] | null, x: string): boolean;
+//# sourceMappingURL=anchors-cli.d.ts.map

package/dist/skills/anchors-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors-cli.d.ts","sourceRoot":"","sources":["../../src/skills/anchors-cli.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,aAAa,QAAkB,CAAC;AAW7C,4IAA4I;AAC5I,MAAM,WAAW,GAAG;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAKrE,oIAAoI;AACpI,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAoB5G;AAED,mHAAmH;AACnH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAInE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CA6BrE;AAsGD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAoBvI;AAED,8GAA8G;AAC9G,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAIzE"}

package/dist/skills/anchors-cli.js

@@ -0,0 +1,274 @@
+/**
+ * The repo's own CLI subcommands (phase 2 design 4.13, P23, P24): the `bin`
+ * names in the nearest package.json, the commander-style registrations in
+ * the package's source folder, and the cache that keeps SessionStart from
+ * scanning (`state/anchors-cache.json`, 2.7).
+ *
+ * A scan reads at most 400 files and 8 MB of `.ts .js .mjs .cjs` under `src/`
+ * (else the bin target's folder), within a deadline; past any limit, a
+ * dynamic registration, or a default command, nothing is judged. The cache
+ * holds command names and a 16-hex signature of the files' paths, sizes and
+ * mtimes, never file text. Local file reads only: no process, no network.
+ */
+import { createHash } from 'node:crypto';
+import { lstatSync, readdirSync, statSync } from 'node:fs';
+import { dirname, join, normalize, relative, resolve, sep } from 'node:path';
+import { exists, readSmall } from './anchors-git.js';
+import { readPlain } from '../init/plain-file.js';
+import { trailPath, writePrivate } from '../util/private-fs.js';
+export const MAX_SRC_FILES = 400;
+export const MAX_SRC_BYTES = 8 * 1024 * 1024;
+const MAX_CHECKOUTS = 20;
+/** At SessionStart a cache this old is not sure: the CLI may have changed since (P24). */
+const START_CACHE_MS = 24 * 3600_000;
+const EXT = /\.(?:[cm]?[jt]s|[jt]sx)$/;
+/** The cache file is read only as a plain file this size or under (no link, no FIFO, D100). */
+const MAX_CACHE_BYTES = 1024 * 1024;
+/** Commands the libraries add on their own. */
+const BUILT_IN = new Set(['help']);
+const NAME = /^[A-Za-z0-9][A-Za-z0-9:._-]{0,39}$/;
+const inside = (top, p) => p === top || p.startsWith(top + sep);
+const isDir = (p) => { try {
+    return statSync(p).isDirectory();
+}
+catch {
+    return false;
+} };
+/** The bins of the nearest package.json from the step's folder up to the checkout: name to target. null when none or unreadable. */
+export function binsNear(checkout, dir) {
+    const top = resolve(checkout);
+    for (let d = resolve(top, dir); inside(top, d); d = dirname(d)) {
+        const file = join(d, 'package.json');
+        if (exists(file)) {
+            const text = readSmall(file, 256 * 1024);
+            if (text === null)
+                return null;
+            let pkg;
+            try {
+                pkg = JSON.parse(text);
+            }
+            catch {
+                return null;
+            }
+            const bins = new Map();
+            if (typeof pkg?.bin === 'string' && typeof pkg.name === 'string')
+                bins.set(pkg.name.replace(/^@[^/]+\//, ''), pkg.bin);
+            else if (pkg?.bin && typeof pkg.bin === 'object') {
+                for (const [k, v] of Object.entries(pkg.bin))
+                    if (typeof v === 'string')
+                        bins.set(k, v);
+            }
+            for (const [k, v] of bins)
+                bins.set(k, normalize(v).replace(/^\.\//, ''));
+            return bins.size ? { pkgDir: d, bins } : null;
+        }
+        if (d === top)
+            return null;
+    }
+    return null;
+}
+/** The folder a program's commands are registered in: `src/`, else its bin target's folder, inside the package. */
+export function srcOf(pkgDir, target) {
+    if (isDir(join(pkgDir, 'src')))
+        return join(pkgDir, 'src');
+    const d = dirname(resolve(pkgDir, target));
+    return inside(pkgDir, d) && isDir(d) ? d : null;
+}
+/**
+ * The names registered with `.command('x'`, `new Command('x'`, `createCommand('x'`, `.alias('x')` and an `.aliases` array in `text` (each
+ * literal's first word), into `out`. false when one isn't a plain string literal, or a default command exists: then
+ * any word may be the CLI's, and nothing is judged.
+ */
+export function registrations(text, out) {
+    if (/\bisDefault\s*:\s*true/.test(text))
+        return false;
+    // yargs' commandDir loads commands from files, and its completion() adds one: the names can't be listed (review).
+    if (/\.(?:commandDir|completion)\s*\(/.test(text))
+        return false;
+    const re = /\.(command|alias|aliases)\s*\(\s*|\b(?:new\s+Command|createCommand)\s*\(\s*/g;
+    for (let m = re.exec(text); m; m = re.exec(text)) {
+        let at = re.lastIndex;
+        const many = m[1] === 'aliases';
+        if (many) {
+            if (text[at] !== '[')
+                return false;
+            at = skipSpace(text, at + 1);
+        }
+        for (;;) {
+            const q = text[at];
+            if ((q === ')' && !many) || (q === ']' && many))
+                break; // `new Command()`, `.alias()` read back, `[]`
+            if (q !== "'" && q !== '"' && q !== '`')
+                return false;
+            const end = text.indexOf(q, at + 1);
+            const lit = end < 0 ? '' : text.slice(at + 1, end);
+            if (end < 0 || /[\\\n]/.test(lit) || (q === '`' && lit.includes('${')))
+                return false;
+            const name = lit.trim().split(/\s+/)[0] ?? '';
+            if (name === '$0' || name === '*')
+                return false;
+            if (name)
+                out.add(name);
+            if (!many)
+                break;
+            at = skipSpace(text, end + 1);
+            if (text[at] === ',')
+                at = skipSpace(text, at + 1);
+            else if (text[at] !== ']')
+                return false;
+        }
+    }
+    return true;
+}
+const skipSpace = (t, i) => { while (i < t.length && /\s/.test(t[i]))
+    i++; return i; };
+/** The source files (stat only), their signature, and whether a limit was passed. null past the deadline. */
+function walk(cli, src, deadline) {
+    const files = [];
+    const parts = [];
+    let bytes = 0;
+    try {
+        const p = statSync(join(cli.pkgDir, 'package.json'));
+        parts.push(`package.json\0${p.size}\0${Math.trunc(p.mtimeMs)}`);
+    }
+    catch { /* the bins were read from it a moment ago */ }
+    const stack = [src];
+    while (stack.length) {
+        if (Date.now() > deadline)
+            return null;
+        const d = stack.pop();
+        let entries;
+        try {
+            entries = readdirSync(d, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+        for (const e of entries) {
+            if (e.name.startsWith('.') || e.name === 'node_modules')
+                continue;
+            const p = join(d, e.name);
+            // A linked folder or source file can hold registrations the walk doesn't follow: not sure (review).
+            if (e.isSymbolicLink()) {
+                if (EXT.test(e.name) || isDir(p))
+                    return { files, sig: sigOf(cli, parts), over: true };
+                continue;
+            }
+            if (e.isDirectory()) {
+                stack.push(p);
+                continue;
+            }
+            if (!e.isFile() || !EXT.test(e.name))
+                continue;
+            const st = lstatSync(p);
+            files.push(p);
+            bytes += st.size;
+            parts.push(`${relative(cli.pkgDir, p)}\0${st.size}\0${Math.trunc(st.mtimeMs)}`);
+            if (files.length > MAX_SRC_FILES || bytes > MAX_SRC_BYTES)
+                return { files, sig: sigOf(cli, parts), over: true };
+        }
+    }
+    // The bin target outside the source folder can register commands too (a hand-written bin/acme.js; review).
+    const target = resolve(cli.pkgDir, cli.target);
+    if (inside(cli.pkgDir, target) && !inside(src, target)) {
+        try {
+            const st = lstatSync(target);
+            if (st.isFile()) {
+                files.push(target);
+                bytes += st.size;
+                parts.push(`${relative(cli.pkgDir, target)}\0${st.size}\0${Math.trunc(st.mtimeMs)}`);
+                if (bytes > MAX_SRC_BYTES)
+                    return { files, sig: sigOf(cli, parts), over: true };
+            }
+        }
+        catch { /* not built yet: the source folder is all there is */ }
+    }
+    return { files, sig: sigOf(cli, parts), over: false };
+}
+const sigOf = (cli, parts) => createHash('sha256').update(`${cli.pkgDir}\n${parts.join('\n')}`).digest('hex').slice(0, 16);
+/** Every name registered in the files, or [] when not sure (a dynamic one, a default command). null past the deadline. */
+function scanNames(files, deadline) {
+    const names = new Set();
+    for (const f of files) {
+        if (Date.now() > deadline)
+            return null;
+        const text = readSmall(f, MAX_SRC_BYTES);
+        if (text === null || !registrations(text, names))
+            return [];
+    }
+    const list = [...names].filter((n) => NAME.test(n)).sort();
+    return list.length === names.size && list.length <= 200 ? list : [];
+}
+const cachePath = (env) => trailPath(env, 'state', 'anchors-cache.json');
+/** Per checkout, and per package below its top: two packages' programs of one name never share names (review). */
+const keyOf = (checkout, pkgDir) => {
+    const rel = relative(resolve(checkout), resolve(pkgDir));
+    return createHash('sha256').update(rel ? `${resolve(checkout)}\0${rel}` : resolve(checkout)).digest('hex').slice(0, 12);
+};
+function readCache(env) {
+    let raw = null;
+    try {
+        const text = readPlain(cachePath(env), MAX_CACHE_BYTES);
+        raw = text === null ? null : JSON.parse(text);
+    }
+    catch { /* read as empty */ }
+    const ok = raw && typeof raw === 'object' && raw.checkouts && typeof raw.checkouts === 'object' && !Array.isArray(raw.checkouts);
+    const checkouts = {};
+    if (raw && ok) {
+        for (const [k, e] of Object.entries(raw.checkouts)) {
+            if (!/^[0-9a-f]{12}$/.test(k) || !e || typeof e.sig !== 'string' || typeof e.at !== 'string' || !e.cli || typeof e.cli !== 'object')
+                continue;
+            const cli = {};
+            for (const [p, names] of Object.entries(e.cli))
+                if (Array.isArray(names))
+                    cli[p] = names.filter((n) => typeof n === 'string' && NAME.test(n));
+            checkouts[k] = { sig: e.sig, cli, at: e.at };
+        }
+    }
+    return { v: 1, checkouts };
+}
+function writeCache(env, file) {
+    const keep = Object.entries(file.checkouts).sort((a, b) => Date.parse(b[1].at) - Date.parse(a[1].at)).slice(0, MAX_CHECKOUTS);
+    try {
+        writePrivate(cachePath(env), JSON.stringify({ v: 1, checkouts: Object.fromEntries(keep) }));
+    }
+    catch { /* scanned again next time */ }
+}
+/**
+ * The names the program registers, or null when not known. `scan: false` (SessionStart) reads only the cache, and
+ * only an entry under a day old; `scan: true` walks the files (stat only) and reads them only when the signature
+ * moved, then writes the cache. Past the deadline: null, nothing written.
+ */
+export function cliNames(cli, checkout, env, opts) {
+    const file = readCache(env);
+    const key = keyOf(checkout, cli.pkgDir);
+    const entry = file.checkouts[key];
+    if (!opts.scan) {
+        const age = entry ? Date.now() - Date.parse(entry.at) : NaN;
+        return entry && age >= 0 && age < START_CACHE_MS ? entry.cli[cli.prog] ?? null : null;
+    }
+    const src = srcOf(cli.pkgDir, cli.target);
+    const w = src ? walk(cli, src, opts.deadline) : null;
+    if (!w)
+        return null;
+    let names = w.over ? [] : null;
+    if (!names && entry?.sig === w.sig && entry.cli[cli.prog])
+        return entry.cli[cli.prog];
+    names ??= scanNames(w.files, opts.deadline);
+    if (!names)
+        return null;
+    const cliMap = entry?.sig === w.sig ? { ...entry.cli } : {};
+    cliMap[cli.prog] = names;
+    file.checkouts[key] = { sig: w.sig, cli: cliMap, at: new Date().toISOString() };
+    writeCache(env, file);
+    return names;
+}
+/** Gone only when at least 3 other registrations were found, none dynamic, and `x` isn't among them (P23). */
+export function subcommandGone(names, x) {
+    if (!names || BUILT_IN.has(x))
+        return false;
+    const others = names.filter((n) => n !== x && !BUILT_IN.has(n));
+    return others.length >= 3 && !names.includes(x);
+}
+//# sourceMappingURL=anchors-cli.js.map

package/dist/skills/anchors-cli.js.map

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

package/dist/skills/anchors-git.d.ts

@@ -0,0 +1,29 @@
+import type { Anchor } from './anchors.js';
+export declare const MAX_READ: number;
+export declare function readSmall(path: string, max?: number): string | null;
+export declare const isFile: (p: string) => boolean;
+export declare const exists: (p: string) => boolean;
+export interface Git {
+    common: string;
+    remotes: Map<string, string>;
+    packed: string | null | undefined;
+    reftable: boolean;
+    sparse: boolean;
+}
+/** The common git folder (through a worktree's gitdir and commondir), its remotes and packed refs. Null outside git. */
+export declare function gitOf(checkout: string): Git | null;
+/** A ref's object id (loose, then packed), or null when it isn't there or can't be read (phase 2 c4: the CI check). */
+export declare function refOid(git: Git, ref: string): string | null;
+/** Branch anchor gone? null when it can't be known (the remote isn't one this checkout has). */
+export declare function branchGone(git: Git, a: Anchor): {
+    gone: boolean;
+    remote?: string;
+} | null;
+/**
+ * D136 (3): the branch names a checkout knows, local and remote (`refs/heads/<b>`, `refs/remotes/<r>/<b>`), loose and
+ * packed, so "deploy it to dev" can be the ship job for any branch the repo has. Empty outside git, or under reftable.
+ */
+export declare function repoBranches(checkout: string): Set<string>;
+/** A lazy `hasBranch` for matchJob (D136 (3)): the checkout's branches are read at the first ask that needs them, once a process. */
+export declare function branchTest(checkout: string): (name: string) => boolean;
+//# sourceMappingURL=anchors-git.d.ts.map

package/dist/skills/anchors-git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors-git.d.ts","sourceRoot":"","sources":["../../src/skills/anchors-git.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,eAAO,MAAM,QAAQ,QAAc,CAAC;AAEpC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAW,GAAG,MAAM,GAAG,IAAI,CAQrE;AACD,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,YAAqE,CAAC;AACtG,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,YAAkE,CAAC;AAEnG,MAAM,WAAW,GAAG;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE;AAE5I,wHAAwH;AACxH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAgClD;AAqDD,uHAAuH;AACvH,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO3D;AAgBD,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAezF;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAoB1D;AAGD,qIAAqI;AACrI,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAUtE"}