@nanonets/graft 0.24.0 → 0.25.0

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