@nanonets/graft 0.24.0 → 0.25.0

package/dist/search/user-regexp.js

@@ -0,0 +1,150 @@
+/**
+ * The regular expression `graft grep` and `graft_find_all` search with, built
+ * from the pattern the person (or their agent) typed. A grep takes a regex by
+ * design, so the pattern's syntax is kept; what this adds is that the RegExp
+ * is never made from the raw text:
+ *
+ * - every literal character goes through the metacharacter escape, and only
+ *   regex syntax from a fixed set is written as itself, so the source handed
+ *   to `RegExp` is the typed pattern, character for character, rebuilt from
+ *   known parts;
+ * - a repeat of a group that already repeats (`(a+)+`, `(\w*\s)*`) is refused
+ *   with a SyntaxError, as an invalid pattern is: on a long line it backtracks
+ *   exponentially and holds the search (the MCP server with it) for minutes.
+ *   `--fixed` still searches for such text literally.
+ *
+ * Every other pattern compiles to exactly what `new RegExp(pattern)` gives,
+ * and an invalid one still throws `RegExp`'s own SyntaxError.
+ */
+/** One literal character, escaped when it is a regex metacharacter (`.` → `\.`). */
+const literal = (c) => c.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/** A metacharacter as regex syntax: each written from a constant, never from the pattern. */
+function syntax(c) {
+    switch (c) {
+        case ".": return ".";
+        case "*": return "*";
+        case "+": return "+";
+        case "?": return "?";
+        case "^": return "^";
+        case "$": return "$";
+        case "{": return "{";
+        case "}": return "}";
+        case "(": return "(";
+        case ")": return ")";
+        case "|": return "|";
+        case "[": return "[";
+        case "]": return "]";
+        case "\\": return "\\";
+        default: throw new SyntaxError(`not regex syntax: ${c}`);
+    }
+}
+const META = new Set([".", "*", "+", "?", "^", "$", "{", "}", "(", ")", "|", "[", "]", "\\"]);
+/** `{n}`, `{n,}`, `{n,m}` at the start of the text: its bounds. */
+const BRACES = /^\{(\d+)(,(\d*))?\}/;
+/** Thrown for a repeat of a repeating group: a SyntaxError, so callers report it as they report an invalid pattern. */
+export const NESTED_REPEAT = "a repeated group that repeats inside, like (a+)+, can take minutes on one long line; repeat only the inside, or use --fixed";
+/**
+ * `pattern` as a RegExp with `flags`, rebuilt from escaped literals and fixed syntax. Throws SyntaxError for an
+ * invalid pattern, and for a repeat of a group that repeats inside (see NESTED_REPEAT).
+ */
+export function userRegExp(pattern, flags = "") {
+    let out = "";
+    let inClass = false;
+    // Per open group: whether anything in it repeats (a quantifier with a top over 1).
+    const groups = [false];
+    // What a quantifier here applies to: a group (and whether it repeats inside), another atom, or nothing.
+    let last = null;
+    const repeatNow = () => { groups[groups.length - 1] = true; };
+    for (let i = 0; i < pattern.length;) {
+        const c = pattern[i];
+        if (c === "\\") {
+            const n = pattern[i + 1];
+            // A trailing `\` is written as it is: RegExp refuses it in its own words.
+            if (n === undefined)
+                out += syntax("\\");
+            else
+                out += META.has(n) ? literal(n) : syntax("\\") + literal(n);
+            i += n === undefined ? 1 : 2;
+            last = { group: false, repeats: false };
+            continue;
+        }
+        if (inClass) {
+            if (c === "]") {
+                inClass = false;
+                last = { group: false, repeats: false };
+            }
+            out += META.has(c) ? syntax(c) : literal(c);
+            i++;
+            continue;
+        }
+        if (!META.has(c)) {
+            out += literal(c);
+            last = { group: false, repeats: false };
+            i++;
+            continue;
+        }
+        const braces = c === "{" ? BRACES.exec(pattern.slice(i)) : null;
+        if (c === "*" || c === "+" || c === "?" || braces) {
+            const repeats = braces ? (braces[2] !== undefined ? braces[3] === "" || Number(braces[3]) > 1 : Number(braces[1]) > 1) : c !== "?";
+            if (repeats && last?.group && last.repeats)
+                throw new SyntaxError(`Invalid regular expression: /${pattern}/: ${NESTED_REPEAT}`);
+            if (repeats)
+                repeatNow();
+            if (braces) {
+                out += syntax("{");
+                for (const d of braces[0].slice(1, -1))
+                    out += literal(d);
+                out += syntax("}");
+                i += braces[0].length;
+            }
+            else {
+                out += syntax(c);
+                i++;
+            }
+            // A lazy repeat (`+?`): the `?` is part of it.
+            if (pattern[i] === "?") {
+                out += syntax("?");
+                i++;
+            }
+            last = null;
+            continue;
+        }
+        if (c === "[") {
+            inClass = true;
+            out += syntax("[");
+            i++;
+            if (pattern[i] === "^") {
+                out += syntax("^");
+                i++;
+            }
+            continue;
+        }
+        if (c === "(") {
+            groups.push(false);
+            out += syntax("(");
+            i++;
+            // `(?:`, `(?=`, `(?<name>`: the `?` opens the group's kind, it repeats nothing.
+            if (pattern[i] === "?") {
+                out += syntax("?");
+                i++;
+            }
+            last = null;
+            continue;
+        }
+        if (c === ")") {
+            const repeats = groups.length > 1 ? groups.pop() : false;
+            if (repeats)
+                repeatNow();
+            out += syntax(")");
+            last = { group: true, repeats };
+            i++;
+            continue;
+        }
+        // `.` is an atom; `^`, `$` and `|` leave nothing to repeat; a lone `{`, `}` or `]` is a literal in this mode.
+        out += syntax(c);
+        last = c === "." || c === "{" || c === "}" || c === "]" ? { group: false, repeats: false } : null;
+        i++;
+    }
+    return new RegExp(out, flags);
+}
+//# sourceMappingURL=user-regexp.js.map

package/dist/search/user-regexp.js.map

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

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

@@ -0,0 +1,38 @@
+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;
+}
+/**
+ * A bin target or a `node <file>` word as one form: forward slashes, normalized, no `./`. `dist/cli.js` on every
+ * platform, as package.json and the shell write it; `path.normalize` would make it `dist\cli.js` on Windows.
+ */
+export declare const binTarget: (p: string) => 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;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,KAAG,MAAqE,CAAC;AAE5G,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,279 @@
+/**
+ * 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, posix, 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;
+} };
+/**
+ * A bin target or a `node <file>` word as one form: forward slashes, normalized, no `./`. `dist/cli.js` on every
+ * platform, as package.json and the shell write it; `path.normalize` would make it `dist\cli.js` on Windows.
+ */
+export const binTarget = (p) => posix.normalize(p.replace(/\\/g, '/')).replace(/^\.\//, '');
+/** 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, binTarget(v));
+            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"}