flowfig 0.6.0 → 0.8.0

package/dist/code.js

@@ -0,0 +1,568 @@
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { extname, isAbsolute, relative, resolve, sep } from 'node:path';
+const LANGS = {
+    '.ts': 'ts',
+    '.tsx': 'ts',
+    '.mts': 'ts',
+    '.cts': 'ts',
+    '.js': 'ts',
+    '.jsx': 'ts',
+    '.mjs': 'ts',
+    '.cjs': 'ts',
+    '.py': 'py',
+    '.go': 'go',
+    '.java': 'java',
+    '.cs': 'cs',
+    '.rs': 'rs',
+};
+export const langOf = (path) => LANGS[extname(path)] ?? null;
+export const readFile = (full) => {
+    try {
+        return statSync(full).isFile() ? readFileSync(full, 'utf8') : null;
+    }
+    catch {
+        return null;
+    }
+};
+readFile.files = (root) => {
+    const out = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (e.name.startsWith('.') || e.name === 'node_modules')
+                continue;
+            const full = resolve(dir, e.name);
+            if (e.isDirectory())
+                walk(full);
+            else
+                out.push(relative(root, full).split(sep).join('/'));
+        }
+    };
+    walk(root);
+    return out;
+};
+const blank = (s) => s.replace(/[^\n]/g, ' ');
+const wordBefore = (s, end) => /(\w+)$/.exec(s.slice(Math.max(0, end - 12), end))?.[1] ?? '';
+function mask(src, lang) {
+    let code = '';
+    let keep = '';
+    const n = src.length;
+    let i = 0;
+    const push = (txt, kind) => {
+        code += kind === 'code' ? txt : blank(txt);
+        keep += kind === 'comment' ? blank(txt) : txt;
+    };
+    if (lang === 'py') {
+        while (i < n) {
+            const c = src[i];
+            if (c === '#') {
+                const e = src.indexOf('\n', i);
+                const end = e < 0 ? n : e;
+                push(src.slice(i, end), 'comment');
+                i = end;
+                continue;
+            }
+            const m = /^([rRbBuUfF]{0,2})('''|"""|'|")/.exec(src.slice(i, i + 5));
+            if (m && (m[1] === '' || !/[\w]/.test(src[i - 1] ?? ''))) {
+                const q = m[2];
+                let j = i + m[0].length;
+                while (j < n) {
+                    if (src[j] === '\\')
+                        j += 2;
+                    else if (src.startsWith(q, j)) {
+                        j += q.length;
+                        break;
+                    }
+                    else if (q.length === 1 && src[j] === '\n')
+                        break;
+                    else
+                        j++;
+                }
+                const bodyAt = i + m[0].length;
+                const closeAt = Math.max(bodyAt, j - q.length);
+                push(src.slice(i, bodyAt), 'code');
+                push(src.slice(bodyAt, closeAt), 'string');
+                push(src.slice(closeAt, j), 'code');
+                i = j;
+                continue;
+            }
+            push(c, 'code');
+            i++;
+        }
+        return { code, keep };
+    }
+    const stack = [];
+    let depth = 0;
+    let prevSig = '';
+    while (i < n) {
+        const c = src[i];
+        const d = src[i + 1];
+        if (c === '/' && d === '/') {
+            const e = src.indexOf('\n', i);
+            const end = e < 0 ? n : e;
+            push(src.slice(i, end), 'comment');
+            i = end;
+            continue;
+        }
+        if (c === '/' && d === '*') {
+            const e = src.indexOf('*/', i + 2);
+            const end = e < 0 ? n : e + 2;
+            push(src.slice(i, end), 'comment');
+            i = end;
+            continue;
+        }
+        if (lang === 'ts' && c === '/' && /^$|[(,=:[!&|?{};]$/.test(prevSig)) {
+            let j = i + 1;
+            let cls = false;
+            while (j < n && src[j] !== '\n') {
+                if (src[j] === '\\')
+                    j += 2;
+                else if (src[j] === '/' && !cls)
+                    break;
+                else {
+                    if (src[j] === '[')
+                        cls = true;
+                    else if (src[j] === ']')
+                        cls = false;
+                    j++;
+                }
+            }
+            if (src[j] === '/') {
+                push('/', 'code');
+                push(src.slice(i + 1, j), 'string');
+                push('/', 'code');
+                i = j + 1;
+                prevSig = 'x';
+                continue;
+            }
+        }
+        if (lang === 'rs' && c === "'" && /[A-Za-z_]/.test(d ?? '') && src[i + 2] !== "'") {
+            push(c, 'code');
+            i++;
+            continue;
+        }
+        const tpl = lang === 'ts' && c === '`';
+        const raw = (lang === 'go' && c === '`') || (lang === 'cs' && c === '@' && d === '"');
+        if (c === '"' || c === "'" || tpl || raw || (c === '}' && stack.length && stack.at(-1) === depth)) {
+            let open = c;
+            if (c === '}') {
+                stack.pop();
+                depth--;
+            }
+            if (raw && c === '@')
+                open = '"';
+            const startQ = c === '@' ? i + 2 : i + 1;
+            const q = c === '}' ? '`' : open;
+            const triple = (lang === 'java' || lang === 'cs') && src.startsWith('"""', i);
+            let j = triple ? i + 3 : startQ;
+            let enterTpl = false;
+            while (j < n) {
+                if (triple) {
+                    if (src.startsWith('"""', j))
+                        break;
+                    j++;
+                    continue;
+                }
+                if (src[j] === '\\' && !raw)
+                    j += 2;
+                else if (raw && c === '@' && src[j] === '"' && src[j + 1] === '"')
+                    j += 2;
+                else if (src[j] === q)
+                    break;
+                else if (q === '`' && lang === 'ts' && src[j] === '$' && src[j + 1] === '{') {
+                    enterTpl = true;
+                    break;
+                }
+                else if (!raw && q !== '`' && src[j] === '\n')
+                    break;
+                else
+                    j++;
+            }
+            const head = c === '}' ? 1 : startQ - i;
+            push(src.slice(i, i + head), 'code');
+            push(src.slice(i + head, j), 'string');
+            if (enterTpl) {
+                push('${', 'code');
+                depth++;
+                stack.push(depth);
+                i = j + 2;
+                prevSig = '{';
+                continue;
+            }
+            const tail = triple ? 3 : 1;
+            push(src.slice(j, j + tail), 'code');
+            i = j + tail;
+            prevSig = 'x';
+            continue;
+        }
+        if (c === '{')
+            depth++;
+        else if (c === '}')
+            depth--;
+        push(c, 'code');
+        if (!/\s/.test(c))
+            prevSig = /\w/.test(c)
+                ? !/\w/.test(src[i + 1] ?? '') && /^(return|typeof|case|in|of)$/.test(wordBefore(src, i + 1))
+                    ? '('
+                    : 'x'
+                : c;
+        i++;
+    }
+    return { code, keep };
+}
+export const esc = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+export function matchClose(code, open) {
+    const pair = { '{': '}', '(': ')', '[': ']' }[code[open]];
+    let d = 0;
+    for (let i = open; i < code.length; i++) {
+        if (code[i] === code[open])
+            d++;
+        else if (code[i] === pair && --d === 0)
+            return i;
+    }
+    return code.length - 1;
+}
+const indentAt = (code, pos) => {
+    const ls = code.lastIndexOf('\n', pos - 1) + 1;
+    return /^[ \t]*/.exec(code.slice(ls))[0].length;
+};
+function braceBody(code, from, start, lang) {
+    let i = from;
+    let pd = 0;
+    const defIndent = indentAt(code, start);
+    while (i < code.length) {
+        const c = code[i];
+        if (c === '(' || c === '[')
+            pd++;
+        else if (c === ')' || c === ']') {
+            if (--pd < 0)
+                return null;
+        }
+        else if (pd === 0) {
+            if (c === ';')
+                return [start, i + 1];
+            if (c === '\n' && lang === 'go' && !/[,({[=+\-*/|&.:]\s*$/.test(code.slice(Math.max(start, i - 40), i)))
+                return [start, i];
+            if (c === '}')
+                return null;
+            if (c === '=' && code[i + 1] === '>' && lang === 'ts') {
+                let k = i + 2;
+                while (/\s/.test(code[k]))
+                    k++;
+                if (code[k] !== '{') {
+                    let pd2 = 0;
+                    for (let j = k; j < code.length; j++) {
+                        const ch = code[j];
+                        if ('([{'.includes(ch))
+                            pd2++;
+                        else if (')]}'.includes(ch)) {
+                            if (--pd2 < 0)
+                                return [start, j];
+                        }
+                        else if (pd2 === 0 && (ch === ';' || ch === ','))
+                            return [start, j];
+                        else if (pd2 === 0 && ch === '\n') {
+                            const next = code.slice(j + 1).match(/^[ \t]*(\S)/);
+                            if (next && indentAt(code, j + 1) <= defIndent && !/[.?:|&+]/.test(next[1]))
+                                return [start, j];
+                        }
+                    }
+                    return [start, code.length];
+                }
+                i = k;
+                continue;
+            }
+            if (c === '{') {
+                const before = code.slice(Math.max(0, i - 12), i).trimEnd();
+                const goTypeDecl = lang === 'go' && /^type\s+\w+(\[[^\]]*\])?\s+(struct|interface)\s*$/.test(code.slice(start, i));
+                if (!goTypeDecl && (/[:|&<,]$/.test(before) || /\b(interface|struct)$/.test(before))) {
+                    i = matchClose(code, i) + 1;
+                    continue;
+                }
+                return [start, matchClose(code, i) + 1];
+            }
+        }
+        i++;
+    }
+    return null;
+}
+export function pyBody(code, start) {
+    const ind = indentAt(code, start);
+    let i = start;
+    let pd = 0;
+    for (; i < code.length; i++) {
+        const c = code[i];
+        if ('([{'.includes(c))
+            pd++;
+        else if (')]}'.includes(c))
+            pd--;
+        else if (c === ':' && pd === 0 && /^[ \t]*(\n|$)/.test(code.slice(i + 1, i + 200)))
+            break;
+        else if (c === '\n' && pd === 0 && !code.slice(start, i).endsWith('\\')) {
+            if (!/^\s*(async\s+)?(def|class)\b/.test(code.slice(code.lastIndexOf('\n', start - 1) + 1)))
+                return [start, i];
+        }
+    }
+    let j = code.indexOf('\n', i);
+    if (j < 0)
+        return [start, code.length];
+    let end = j;
+    while (j < code.length) {
+        const ls = j + 1;
+        const le = code.indexOf('\n', ls) < 0 ? code.length : code.indexOf('\n', ls);
+        const line = code.slice(ls, le);
+        if (line.trim() && indentAt(code, ls) <= ind)
+            break;
+        if (line.trim())
+            end = le;
+        j = le;
+        if (le >= code.length)
+            break;
+    }
+    return [start, end];
+}
+const E = '(?![\\p{L}\\p{N}_$])';
+function defPatterns(lang, name, inContainer) {
+    const N = esc(name);
+    const re = (src) => new RegExp(src, 'gu');
+    switch (lang) {
+        case 'ts':
+            return [
+                re(`\\bfunction\\s*\\*?\\s*${N}\\s*[<(]`),
+                re(`\\b(class|interface|enum|namespace|module)\\s+${N}${E}`),
+                re(`\\btype\\s+${N}${E}\\s*[<=]`),
+                re(`\\b(const|let|var)\\s+${N}${E}\\s*[:=]`),
+                re(`(^|[\\n;{}])[ \\t]*((public|private|protected|static|async|readonly|override|abstract|get|set|declare)\\s+)*\\*?${N}\\s*[<(]`),
+                re(`(^|[\\n;{}])[ \\t]*((public|private|protected|static|readonly|override|declare)\\s+)*${N}\\s*[?!]?\\s*(:(?:[^=;\\n]|=>)*)?=(?![=>])`),
+                re(`(^|[\\n;{}])[ \\t]*(module\\.)?exports\\.${N}\\s*=(?!=)`),
+                ...(inContainer ? [re(`(^|[\\n{,])[ \\t]*${N}\\s*[?]?:`)] : []),
+            ];
+        case 'py':
+            return [
+                re(`(^|\\n)[ \\t]*(async\\s+)?def\\s+${N}\\s*\\(`),
+                re(`(^|\\n)[ \\t]*class\\s+${N}${E}`),
+                re(`(^|\\n)${inContainer ? '[ \\t]+' : ''}${N}\\s*(:[^=\\n]+)?=(?!=)`),
+            ];
+        case 'go':
+            return [
+                re(`\\bfunc\\s+${N}\\s*[\\[(]`),
+                re(`\\bfunc\\s*\\([^)]*\\)\\s*${N}\\s*[\\[(]`),
+                re(`\\btype\\s+${N}${E}`),
+                re(`\\b(var|const)\\s+${N}${E}`),
+                re(`(^|\\n)[ \\t]+${N}${E}(\\s*,\\s*[\\p{L}\\p{N}_]+)*\\s*(=|[\\w\\[*]+[^\\n]*=)`),
+                re(`(^|\\n)[ \\t]+${N}\\s+(struct|interface)${E}`),
+                ...(inContainer ? [re(`(^|\\n)[ \\t]+${N}\\s*(\\(|\\s+\\S)`)] : []),
+            ];
+        case 'java':
+        case 'cs':
+            return [
+                re(`\\b(class|interface|enum|record|struct)\\s+${N}${E}`),
+                re(`(^|[\\n;{}])[ \\t]*([\\w<>\\[\\],.?]+\\s+){1,12}${N}\\s*(<[^>]*>)?\\s*\\(`),
+                re(`(^|[\\n;{}\\]])[ \\t]*([\\w<>\\[\\],.?]+\\s+){1,12}${N}\\s*(=(?![=>])|;|\\{\\s*(get|set|init)\\b|=>)`),
+            ];
+        case 'rs':
+            return [re(`\\bfn\\s+${N}${E}`), re(`\\b(struct|enum|trait|type|mod|const|static|union)\\s+${N}${E}`)];
+    }
+}
+const KEYWORDS = new Set(['if', 'for', 'while', 'switch', 'catch', 'return', 'new', 'await', 'typeof', 'else', 'do', 'throw']);
+function depthAt(code, pos, lo) {
+    let d = 0;
+    for (let i = lo; i < pos; i++) {
+        if (code[i] === '{')
+            d++;
+        else if (code[i] === '}')
+            d--;
+    }
+    return d;
+}
+function inTypeBody(code, pos) {
+    for (let i = pos, d = 0; i >= 0; i--) {
+        if (code[i] === '}')
+            d++;
+        else if (code[i] === '{' && d-- === 0)
+            return /(?<![:,]\s*)\b(class|interface|enum|record|struct)\s+\w[^;{}]*$/.test(code.slice(Math.max(0, i - 300), i));
+    }
+    return false;
+}
+function pyMemberIndent(code, lo, hi) {
+    const base = indentAt(code, lo);
+    let min = Infinity;
+    for (const line of code.slice(lo, hi).split('\n').slice(1)) {
+        const ind = /^[ \t]*/.exec(line)[0].length;
+        if (line.trim() && ind > base)
+            min = Math.min(min, ind);
+    }
+    return min;
+}
+function findIn(code, lang, name, lo, hi, member, receiver) {
+    if (KEYWORDS.has(name) && !/^(rs|py|go)$/.test(lang))
+        return null;
+    const inContainer = member != null;
+    const memberIndent = inContainer && lang === 'py' ? pyMemberIndent(code, lo, hi) : -1;
+    const hits = [];
+    const pats = defPatterns(lang, name, inContainer);
+    for (const re of pats) {
+        re.lastIndex = lo;
+        let m;
+        while ((m = re.exec(code)) && m.index < hi) {
+            const nameAt = m.index + m[0].lastIndexOf(name);
+            const start = m.index + /^[;{}\]]?\s*/.exec(m[0])[0].length;
+            if (lang === 'go' && receiver != null && !/^\s*func\s*\(/.test(m[0]))
+                continue;
+            if (lang === 'go' && receiver != null && /^func\s*\(/.test(m[0])) {
+                const recv = /^func\s*\(([^)]*)\)/
+                    .exec(m[0])[1]
+                    .trim()
+                    .replace(/^\w+\s+/, '');
+                if (!new RegExp(`^\\*?\\s*${esc(receiver)}(\\[[^\\]]*\\])?$`).test(recv))
+                    continue;
+            }
+            if (code[nameAt - 1] === '.' && !/\bexports\.$/.test(code.slice(nameAt - 8, nameAt)))
+                continue;
+            if (lang === 'ts') {
+                const before = code.slice(0, start);
+                if (/[?:=&|]\s*$/.test(before) && !/\b(case\b[^:\n]*|default)\s*:\s*$/.test(before))
+                    continue;
+            }
+            if (lang === 'go' && !inContainer && m[0].includes('=') && depthAt(code, start, 0) > 0)
+                continue;
+            if ((lang === 'java' || lang === 'cs') && re === pats.at(-1) && !inTypeBody(code, start))
+                continue;
+            const ext = lang === 'py' ? pyBody(code, start) : braceBody(code, nameAt + name.length, start, lang);
+            if (!ext)
+                continue;
+            const isMethodish = /\(\s*$/.test(m[0]) && !/\b(function|func|fn|def)\b/.test(m[0]);
+            if (isMethodish && lang !== 'py' && !(lang === 'go' && inContainer)) {
+                const p = code.indexOf('(', nameAt);
+                const close = matchClose(code, p);
+                const after = code.slice(close + 1).match(/^\s*(\S)/)?.[1];
+                if (!after ||
+                    !(after === '{' ||
+                        after === ':' ||
+                        (lang !== 'ts' && /[\w=]/.test(after)) ||
+                        (after === ';' && (lang === 'java' || lang === 'cs'))))
+                    continue;
+                if (lang === 'java' || lang === 'cs') {
+                    const pre = code.slice(start, nameAt);
+                    if (/\b(new|return|else|throw)\s*$/.test(pre) || /[=.]\s*$/.test(pre))
+                        continue;
+                }
+            }
+            if (lang === 'java' || lang === 'cs') {
+                const pre = code.slice(start, nameAt);
+                if (/\b(new|return|else|throw|await|yield|case|in|is|as|out|ref|goto|var|using|do)\s*$/.test(pre) || /[=.]\s*$/.test(pre))
+                    continue;
+            }
+            const depth = depthAt(code, start, lo);
+            if (inContainer && lang === 'py' ? indentAt(code, start) !== memberIndent : member != null && depth !== member)
+                continue;
+            hits.push({ start, end: ext[1], depth });
+        }
+    }
+    if (!hits.length)
+        return null;
+    hits.sort((a, b) => a.depth - b.depth || a.start - b.start);
+    return [hits[0].start, hits[0].end];
+}
+function rustImpls(code, type) {
+    const out = [];
+    const self = new RegExp(`^(&\\s*('\\w+\\s+)?(mut\\s+)?)?(\\w+::)*${esc(type)}\\s*(<.*>)?$`, 's');
+    const re = /\bimpl\b([^{;]*)\{/g;
+    let m;
+    while ((m = re.exec(code))) {
+        let head = m[1].replace(/\bwhere\b[^]*$/, '').trim();
+        if (head.startsWith('<')) {
+            let d = 0;
+            let k = 0;
+            do {
+                if (head[k] === '<')
+                    d++;
+                else if (head[k] === '>' && head[k - 1] !== '-')
+                    d--;
+            } while (d > 0 && ++k < head.length);
+            head = head.slice(k + 1).trim();
+        }
+        const forAt = head.search(/\bfor\s/);
+        if (!self.test(forAt < 0 ? head : head.slice(forAt + 3).trim()))
+            continue;
+        const open = m.index + m[0].length - 1;
+        out.push([open, matchClose(code, open)]);
+    }
+    return out;
+}
+export function outside(root, path) {
+    const rel = relative(root, resolve(root, path));
+    return isAbsolute(path) || rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel);
+}
+export function codeFile(root, path, read = readFile, cache = new Map()) {
+    const full = resolve(root, path);
+    if (cache.has(full))
+        return cache.get(full);
+    const lang = outside(root, path) ? null : langOf(path);
+    const raw = lang ? read(full) : null;
+    const text = raw?.replace(/^\uFEFF/, '').replace(/\r\n/g, '\n');
+    const file = lang && text != null ? { path, lang, text, ...mask(text, lang) } : null;
+    cache.set(full, file);
+    return file;
+}
+export function locate(file, symbol) {
+    const { code, lang } = file;
+    const parts = symbol.split('.');
+    if (!parts.every((p) => /^[\p{L}_$][\p{L}\p{N}_$]*$/u.test(p)))
+        return null;
+    const hit = (r) => {
+        if (!r)
+            return null;
+        let start = r[0];
+        for (;;) {
+            const prevEnd = code.lastIndexOf('\n', start - 1);
+            if (prevEnd < 0)
+                break;
+            const prevStart = code.lastIndexOf('\n', prevEnd - 1) + 1;
+            if (!/^\s*@/.test(code.slice(prevStart, prevEnd)))
+                break;
+            start = prevStart;
+        }
+        return { start, end: r[1] };
+    };
+    if (parts.length === 1 && parts[0] === 'default' && lang === 'ts') {
+        const m = /\bexport\s+default\b/.exec(code);
+        return m && { start: m.index, end: code.length };
+    }
+    if (parts.length === 1)
+        return hit(findIn(code, lang, parts[0], 0, code.length, null));
+    if (lang === 'go' && parts.length === 2) {
+        const r = findIn(code, lang, parts[1], 0, code.length, null, parts[0]);
+        if (r && /^func\s*\(/.test(code.slice(r[0])))
+            return hit(r);
+        const t = findIn(code, lang, parts[0], 0, code.length, null);
+        return t ? hit(findIn(code, lang, parts[1], t[0] + 1, t[1], 1)) : null;
+    }
+    if (lang === 'rs' && parts.length === 2) {
+        for (const [a, b] of rustImpls(code, parts[0])) {
+            const r = findIn(code, lang, parts[1], a + 1, b, 0);
+            if (r)
+                return hit(r);
+        }
+        return null;
+    }
+    let lo = 0;
+    let hi = code.length;
+    for (let k = 0; k < parts.length; k++) {
+        const r = findIn(code, lang, parts[k], lo, hi, k > 0 ? 1 : null);
+        if (!r)
+            return null;
+        if (k === parts.length - 1)
+            return hit(r);
+        lo = r[0] + 1;
+        hi = r[1];
+    }
+    return null;
+}
+export const isDefined = (file, symbol) => locate(file, symbol) != null;

package/dist/diff.js

@@ -1,9 +1,6 @@
-// The spec diff: what a PR changed in a figure, by id. The SVG geometry follows from the spec, so the spec is the diff.
 import { edgeId, isGroup, str, toBeat } from './model.js';
 const show = (v) => (v == null ? '(none)' : `"${str(v)}"`);
-/** The fields that changed, as `name "old" -> "new"` parts; empty when equal. */
 const fields = (a, b, names) => names.filter((k) => str(a[k]) !== str(b[k])).map((k) => `${String(k)} ${show(a[k])} -> ${show(b[k])}`);
-/** Compare two maps by key. The order is stable: changed first, then removed, then added. */
 function compare(kind, before, after, fieldsOf) {
     const out = [];
     for (const [id, a] of before) {
@@ -28,7 +25,6 @@ const messages = (fig) => new Map((fig.steps ?? [])
 export function diff(before, after) {
     const boxes = (f) => {
         const m = new Map();
-        // The group is its label, else its id; the top level has none.
         const walk = (g, parent) => g.children.forEach((c) => (isGroup(c) ? walk(c, c.label != null ? str(c.label) : c.id) : m.set(c.id, { ...c, group: parent })));
         walk(f.layout);
         return m;

package/dist/draw.d.ts

@@ -1,6 +1,5 @@
-/** A file name from the question: lower case, letters and digits, joined by -, at most 60 characters. */
+/** A file name from the question: at most 60 characters. */
 export declare function slug(question: string): string;
-/** The claude argv after the binary. The system prompt carries the agent text, the output path and the folder rule. */
 export declare function agentArgs(o: {
     question: string;
     out: string;
@@ -8,5 +7,4 @@ export declare function agentArgs(o: {
     maxTurns: number;
     model?: string;
 }): string[];
-/** Run `flowfig draw`. Prints, and returns the exit code. */
 export declare function runDraw(argv: string[]): Promise<number>;

package/dist/draw.js

@@ -1,4 +1,3 @@
-// `flowfig draw`: one command to the first figure. Claude Code reads the repo and renders; draw checks the result itself.
 import { spawnSync } from 'node:child_process';
 import { existsSync, mkdirSync, rmSync, statSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
@@ -10,7 +9,7 @@ import { verify } from './verify.js';
 const ALLOWED = 'Read,Glob,Grep,Bash(npx flowfig *)';
 const DISALLOWED = 'Edit,MultiEdit,NotebookEdit';
 const USAGE = 'usage: flowfig draw "<question>" [--out <path>] [--model <alias>] [--max-turns <n>] [--json] [--open]';
-/** A file name from the question: lower case, letters and digits, joined by -, at most 60 characters. */
+/** A file name from the question: at most 60 characters. */
 export function slug(question) {
     const s = question
         .toLowerCase()
@@ -21,7 +20,6 @@ export function slug(question) {
     return s || 'figure';
 }
 const specPath = (out) => out.replace(/\.svg$/, '.json');
-/** The claude argv after the binary. The system prompt carries the agent text, the output path and the folder rule. */
 export function agentArgs(o) {
     const spec = specPath(o.out);
     const system = `${AGENT_TEXT.trimEnd()}\n\nWrite the spec to ${spec} with the Write tool. Then run exactly \`npx flowfig ${spec} ${o.out}\` as one command, alone on its line: no heredoc, no \`;\`, no \`&&\`, no pipe (the permission rule matches one plain command only). Then run \`npx flowfig verify ${o.out}\` the same way. Run every command from this folder, ${o.cwd}.`;
@@ -51,7 +49,6 @@ const fail = (message, code) => {
     console.error(message);
     return code;
 };
-/** Run `flowfig draw`. Prints, and returns the exit code. */
 export async function runDraw(argv) {
     const args = [...argv];
     const flag = (n) => args.includes(n) && args.splice(args.indexOf(n), 1).length > 0;
@@ -103,7 +100,7 @@ export async function runDraw(argv) {
     catch (e) {
         return fail(`draw: ${e.message}`, 2);
     }
-    // A figure from an earlier run must not pass as this run's work: compare the mtime.
+    // Compare the mtime: a figure from an earlier run must not pass.
     const mtime = () => (existsSync(full) ? statSync(full).mtimeMs : undefined);
     const before = mtime();
     const run = spawnSync(bin, agentArgs({ question, out, cwd, maxTurns, model }), {
@@ -112,7 +109,7 @@ export async function runDraw(argv) {
         stdio: ['ignore', 'pipe', 'inherit'],
         maxBuffer: 64 * 1024 * 1024,
     });
-    // The JSON is the last line that starts with {: a warning line may come before it.
+    // The JSON is the last line that starts with {; a warning can come before.
     const line = (run.stdout ?? '')
         .split('\n')
         .reverse()
@@ -177,7 +174,6 @@ export async function runDraw(argv) {
     }
     stop();
     let code = errors || stopped !== undefined ? 1 : 0;
-    // The SVG is on disk also with findings, so the user can look at it.
     if (open) {
         try {
             const line = openedLine((await openSvg(full))[0]);

package/dist/edges.d.ts

@@ -0,0 +1,7 @@
+import { type CodeFile, type Lang, type Read } from './code.ts';
+export type EdgeResult = 'found' | 'not-found' | 'unsure' | 'not-checked';
+export declare const EDGE_LANGS: ReadonlySet<Lang>;
+export declare function edgeResult(root: string, caller: string, callee: string | undefined, via: string | undefined, read?: Read, cache?: Map<string, CodeFile | null>): {
+    result: EdgeResult;
+    reason: string;
+};