@nanonets/graft 0.24.0 → 0.24.1

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"}

package/dist/skills/anchors-git.js

@@ -0,0 +1,241 @@
+/**
+ * The file reads under "may be out of date" (design 4.18, R35): small files, and a checkout's git folder (its
+ * remotes, loose refs and packed-refs, through a worktree's or submodule's `gitdir` and `commondir`). No process, no
+ * network, nothing written. Split from anchors.ts (500-line rule).
+ */
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+export const MAX_READ = 1024 * 1024;
+export function readSmall(path, max = MAX_READ) {
+    try {
+        const st = statSync(path);
+        if (!st.isFile() || st.size > max)
+            return null;
+        return readFileSync(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+export const isFile = (p) => { try {
+    return statSync(p).isFile();
+}
+catch {
+    return false;
+} };
+export const exists = (p) => { try {
+    statSync(p);
+    return true;
+}
+catch {
+    return false;
+} };
+/** The common git folder (through a worktree's gitdir and commondir), its remotes and packed refs. Null outside git. */
+export function gitOf(checkout) {
+    if (!checkout)
+        return null;
+    let dir = resolve(checkout);
+    let gitDir = null;
+    for (let n = 0; n < 40; n++, dir = dirname(dir)) {
+        const dot = join(dir, '.git');
+        try {
+            const st = statSync(dot);
+            if (st.isDirectory())
+                gitDir = dot;
+            else if (st.isFile()) {
+                const m = /^gitdir:\s*(.+?)\s*$/m.exec(readSmall(dot, 4096) ?? '');
+                if (m)
+                    gitDir = resolve(dir, m[1]);
+            }
+        }
+        catch { /* keep looking up */ }
+        if (gitDir || dirname(dir) === dir)
+            break;
+    }
+    if (!gitDir)
+        return null;
+    const cd = readSmall(join(gitDir, 'commondir'), 4096);
+    const common = cd ? resolve(gitDir, cd.trim()) : gitDir;
+    const remotes = new Map();
+    let current = null;
+    for (const line of (readSmall(join(common, 'config')) ?? '').split('\n')) {
+        const sec = /^\s*\[\s*remote\s+"([^"]+)"\s*\]/.exec(line);
+        if (sec) {
+            current = sec[1];
+            continue;
+        }
+        if (/^\s*\[/.test(line)) {
+            current = null;
+            continue;
+        }
+        const url = /^\s*url\s*=\s*(.+?)\s*$/.exec(line);
+        if (current && url)
+            remotes.set(current, url[1]);
+    }
+    const reftable = exists(join(common, 'reftable'));
+    // A sparse checkout leaves files out on purpose (the file can stay after `sparse-checkout disable`: not sure either way).
+    const sparse = exists(join(gitDir, 'info', 'sparse-checkout')) || exists(join(common, 'info', 'sparse-checkout'));
+    return { common, remotes, packed: undefined, reftable, sparse };
+}
+/** `host/owner/repo` for an https, ssh or scp-style URL; null otherwise (a remote's name). */
+function urlKey(url) {
+    const u = url.trim().replace(/\/+$/, '').replace(/\.git$/, '');
+    const m = /^[a-z][a-z0-9+.-]*:\/\/(?:[^@/]+@)?([^/:]+)(?::\d+)?\/(.+)$/i.exec(u);
+    if (m)
+        return `${m[1].toLowerCase()}/${m[2]}`;
+    const scp = /^(?:[^@/:]+@)?([^/:]+):([^/].*)$/.exec(u);
+    return scp ? `${scp[1].toLowerCase()}/${scp[2]}` : null;
+}
+/** The remote's name: itself when the config has it, else the remote whose URL is the same repo; null when none. */
+function remoteName(git, remote) {
+    if (git.remotes.has(remote) || exists(join(git.common, 'refs', 'remotes', remote)))
+        return remote;
+    const want = urlKey(remote);
+    if (!want)
+        return null;
+    for (const [name, url] of git.remotes)
+        if (urlKey(url) === want)
+            return name;
+    return null;
+}
+/** packed-refs past this is not read: one search of a 15 MB file took 12 ms, five skills 400 ms (review). Not sure, never gone. */
+const MAX_PACKED = 4 * MAX_READ;
+/**
+ * The packed refs' text, `\n` first and last, searched with indexOf; '' when there is none, null when it is too big
+ * or can't be read (not sure). Held in memory for the process while its size and mtime stay: a hook checks up to 5
+ * skills against one file. Nothing is written (R35).
+ */
+let packedMemo = null;
+function packed(git) {
+    if (git.packed === undefined) {
+        const path = join(git.common, 'packed-refs');
+        let text = '';
+        try {
+            const st = statSync(path);
+            if (packedMemo && packedMemo.path === path && packedMemo.size === st.size && packedMemo.mtimeMs === st.mtimeMs)
+                text = packedMemo.text;
+            else {
+                const raw = readSmall(path, MAX_PACKED);
+                text = raw === null ? null : `\n${raw}\n`.replace(/\r/g, '');
+                packedMemo = { path, size: st.size, mtimeMs: st.mtimeMs, text };
+            }
+        }
+        catch { /* no packed-refs: nothing packed */ }
+        git.packed = text;
+    }
+    return git.packed;
+}
+/** Is the ref there: true, false, or null when packed-refs couldn't be read and it isn't loose. */
+function hasRef(git, ref) {
+    if (isFile(join(git.common, ...ref.split('/'))))
+        return true;
+    const text = packed(git);
+    return text === null ? null : text.includes(` ${ref}\n`);
+}
+/** 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 function refOid(git, ref) {
+    if (git.reftable)
+        return null;
+    const loose = readSmall(join(git.common, ...ref.split('/')), 4096);
+    if (loose !== null)
+        return /^[0-9a-f]{40,64}\s*$/.test(loose) ? loose.trim() : null;
+    const text = packed(git);
+    const m = text === null ? null : new RegExp(`\\n([0-9a-f]{40,64}) ${ref.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\n`).exec(text);
+    return m ? m[1] : null;
+}
+/** Does the checkout know any of this remote's branches (a loose ref under refs/remotes/<remote>, or a packed one)? */
+function remoteKnown(git, remote) {
+    try {
+        if (readdirSync(join(git.common, 'refs', 'remotes', remote)).some((n) => n !== 'HEAD'))
+            return true;
+    }
+    catch { /* none loose */ }
+    const text = packed(git);
+    if (text === null)
+        return false;
+    const key = ` refs/remotes/${remote}/`;
+    for (let i = text.indexOf(key); i >= 0; i = text.indexOf(key, i + 1)) {
+        if (!text.startsWith('HEAD\n', i + key.length))
+            return true;
+    }
+    return false;
+}
+/** Branch anchor gone? null when it can't be known (the remote isn't one this checkout has). */
+export function branchGone(git, a) {
+    // reftable keeps refs in neither loose files nor packed-refs: nothing here can say a branch is gone.
+    if (git.reftable)
+        return null;
+    if (a.via === 'checkout') {
+        const local = hasRef(git, `refs/heads/${a.name}`);
+        if (local !== false)
+            return local ? { gone: false } : null;
+        let remotes = [...git.remotes.keys()];
+        try {
+            remotes = [...new Set([...remotes, ...readdirSync(join(git.common, 'refs', 'remotes'))])];
+        }
+        catch { /* none */ }
+        return remotes.some((r) => hasRef(git, `refs/remotes/${r}/${a.name}`) === true) ? { gone: false } : { gone: true };
+    }
+    const remote = a.remote ? remoteName(git, a.remote) : null;
+    // A remote this checkout never fetched says nothing about its branches.
+    if (!remote || !remoteKnown(git, remote))
+        return null;
+    const has = hasRef(git, `refs/remotes/${remote}/${a.name}`);
+    return has === null ? null : { gone: !has, remote };
+}
+/** At most this many branch names are read from one checkout. */
+const MAX_BRANCHES = 2000;
+/**
+ * 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 function repoBranches(checkout) {
+    const out = new Set();
+    const git = gitOf(checkout);
+    if (!git || git.reftable)
+        return out;
+    const add = (name) => { if (name && name !== 'HEAD' && out.size < MAX_BRANCHES)
+        out.add(name); };
+    const walk = (dir, prefix, depth) => {
+        if (depth > 6 || out.size >= MAX_BRANCHES)
+            return;
+        let names;
+        try {
+            names = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of names) {
+            if (e.isDirectory())
+                walk(join(dir, e.name), `${prefix}${e.name}/`, depth + 1);
+            else if (e.isFile())
+                add(`${prefix}${e.name}`);
+        }
+    };
+    walk(join(git.common, 'refs', 'heads'), '', 0);
+    try {
+        for (const r of readdirSync(join(git.common, 'refs', 'remotes')))
+            walk(join(git.common, 'refs', 'remotes', r), '', 0);
+    }
+    catch { /* no remotes */ }
+    for (const m of (packed(git) ?? '').matchAll(/ refs\/(?:heads|remotes\/[^/\s]+)\/(\S+)\n/g))
+        add(m[1]);
+    return out;
+}
+const branchMemo = new Map();
+/** A lazy `hasBranch` for matchJob (D136 (3)): the checkout's branches are read at the first ask that needs them, once a process. */
+export function branchTest(checkout) {
+    return (name) => {
+        if (!checkout)
+            return false;
+        let b = branchMemo.get(checkout);
+        if (!b) {
+            if (branchMemo.size >= 20)
+                branchMemo.clear();
+            branchMemo.set(checkout, (b = repoBranches(checkout)));
+        }
+        return b.has(name);
+    };
+}
+//# sourceMappingURL=anchors-git.js.map

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

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

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

@@ -0,0 +1,25 @@
+import type { ParsedSkill } from './types.js';
+export type WideKind = 'ci-file' | 'service' | 'subcommand';
+/** where: the compose file (relative to the checkout) for a service, the program for a subcommand, 'GitHub Actions' for a CI file. */
+export interface WideAnchor {
+    kind: WideKind;
+    name: string;
+    step: number;
+    where: string;
+}
+/** The subcommand scan's own deadline (4.13), inside the prompt hook's 400 ms. */
+export declare const WIDE_SCAN_MS = 150;
+/** The wider anchors in the skill's steps that can be checked here, each once (the first step that leans on it). */
+export declare function wideAnchorsOf(skill: ParsedSkill, checkout: string, _env?: NodeJS.ProcessEnv): WideAnchor[];
+/** The service keys one indent under a column-0 `services:`; null when not sure (4.13, P25). */
+export declare function composeServices(text: string): Set<string> | null;
+/**
+ * Gone only when sure (4.13). `scan: false` reads only the cache for subcommands (SessionStart); `scan: true` may
+ * scan the CLI's source until `deadline` (default: WIDE_SCAN_MS from now). A check that throws or runs out of time is
+ * not gone, and a scan past its deadline caches nothing.
+ */
+export declare function wideGone(skill: ParsedSkill, checkout: string, env?: NodeJS.ProcessEnv, opts?: {
+    scan: boolean;
+    deadline?: number;
+}): WideAnchor[];
+//# sourceMappingURL=anchors-wide.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anchors-wide.d.ts","sourceRoot":"","sources":["../../src/skills/anchors-wide.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQ9C,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;AAC5D,sIAAsI;AACtI,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAEzF,kFAAkF;AAClF,eAAO,MAAM,YAAY,MAAM,CAAC;AA0NhC,oHAAoH;AACpH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,UAAwB,GAAG,UAAU,EAAE,CAEvH;AAuDD,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CA0BhE;AAiBD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,GAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAoB,GAAG,UAAU,EAAE,CA2B/K"}