mindweave 0.0.1 → 2.1.2

package/dist/alternator/chassis/markup.js

@@ -0,0 +1,262 @@
+/**
+ * markup.ts — the HTML/CSS extraction tier: cross-language wiring on Mindweave's
+ * name-keyed graph.
+ *
+ * Mindweave's code tier (treesitter.ts) only understands TS/JS/Python, so a landing
+ * page (a big HTML file with embedded <style>/<script>) was invisible to the graph
+ * — the model had to read the whole file and brute-force string edits. This tier
+ * makes those files first-class:
+ *
+ *   - CSS selectors (`.hero`, `#nav`) become DEFINITIONS (name = the class/id).
+ *   - HTML `class="hero"` become REFERENCES; `id="nav"` become DEFINITIONS (the
+ *     element lives here) — so `#nav` from CSS and the element share the name.
+ *   - Embedded <style> is parsed as CSS and <script> scanned for DOM refs, because
+ *     a page keeps all three languages in one file.
+ *
+ * Because Mindweave's graph is keyed by NAME, feeding these defs/refs in wires the CSS
+ * rule ↔ the HTML elements ↔ the JS that touches them for free: `definition("hero")`
+ * finds the rule + element, `references("hero")` finds every use. `outline(page.html)`
+ * becomes the page's structure (sections + selectors) with line numbers — the model
+ * navigates to the exact part instead of reading 1700 lines.
+ */
+import { extname } from "node:path";
+import { pickNearest } from "../../tools/spanCore.js";
+import { parseTree } from "./treesitter.js";
+import { extractDomRefs } from "./domRefs.js";
+import { IN_WORKER, isolatedMarkup } from "./isolation.js";
+const HTML_EXTS = new Set([".html", ".htm"]);
+const CSS_EXTS = new Set([".css", ".scss", ".sass", ".less"]);
+const HTML_GRAMMAR = "tree-sitter-html.wasm";
+const CSS_GRAMMAR = "tree-sitter-css.wasm";
+/** Whether this tier handles a file (HTML or a stylesheet). */
+export function isMarkupSupported(absPath) {
+    const e = extname(absPath).toLowerCase();
+    return HTML_EXTS.has(e) || CSS_EXTS.has(e);
+}
+function isHtml(absPath) {
+    return HTML_EXTS.has(extname(absPath).toLowerCase());
+}
+/** Extract defs/refs/imports from an HTML or CSS file. Null on failure (the caller
+ *  degrades to grep/read), matching treeSitterExtract's contract. */
+export async function extractMarkup(absPath, code) {
+    // Isolated like the code tier, and for the same measured reason. This tier had no
+    // guard at all before — not even the grammar-size one — while parsing the big nested
+    // pages that cost the most. Inside the worker this check is false and the real work
+    // below runs, which is what the child is for.
+    if (!IN_WORKER)
+        return isolatedMarkup(absPath, code);
+    try {
+        if (isHtml(absPath))
+            return await extractHtml(code);
+        return { ...(await extractCssDefs(code, 0)), imports: [] };
+    }
+    catch {
+        return null;
+    }
+}
+// ── CSS ────────────────────────────────────────────────────────────────────────
+/**
+ * Every class/id selector in a stylesheet: DEFINED once, at the first rule that names
+ * it, and REFERENCED at every rule after that.
+ *
+ * Robust by design: instead of leaning on CSS grammar sub-node names, we take each
+ * rule's whole selector text and pull `.class` / `#id` tokens from it — so
+ * `.hero-stats .value { }` records BOTH `hero-stats` and `value` at that rule.
+ * `lineOffset` shifts lines when the CSS is an embedded <style> block.
+ *
+ * WHY DEDUPED. A class is written once per rule that touches it, and a real stylesheet
+ * touches the same class from many rules: measured on a 2,045-line sheet, 439 symbols
+ * for 128 distinct names — 3.4x — with `.sepia` stored sixty-six separate times. That
+ * one file was then 83% of the whole project's symbol graph, which is what the ranking
+ * ranks over and what an outline lists. Nothing is lost by deduping: "every rule that
+ * styles this class" is a REFERENCES question, and it is now answered as one.
+ */
+async function extractCssDefs(code, lineOffset, seen = new Set()) {
+    const tree = await parseTree(CSS_GRAMMAR, code);
+    if (!tree)
+        return { defs: [], refs: [] };
+    const defs = [];
+    const refs = [];
+    try {
+        for (const rule of tree.rootNode.descendantsOfType("rule_set")) {
+            const selectors = rule.namedChildren.find((c) => c.type === "selectors") ?? rule.namedChild(0);
+            const selText = selectors ? selectors.text : "";
+            const line = rule.startPosition.row + 1 + lineOffset;
+            const endLine = rule.endPosition.row + 1 + lineOffset;
+            const sig = oneLine(selText);
+            const here = new Set();
+            for (const m of selText.matchAll(/([.#])([A-Za-z_][\w-]*)/g)) {
+                const name = m[2];
+                const kind = m[1] === "#" ? "id" : "class";
+                const key = `${kind}:${name}`;
+                if (here.has(key))
+                    continue; // a class repeated in one selector counts once
+                here.add(key);
+                if (seen.has(key)) {
+                    refs.push({ name, line });
+                    continue;
+                }
+                seen.add(key);
+                defs.push({ name, kind, line, endLine, signature: sig });
+            }
+        }
+    }
+    finally {
+        tree.delete();
+    }
+    return { defs, refs };
+}
+// ── HTML ─────────────────────────────────────────────────────────────────────
+async function extractHtml(code) {
+    const tree = await parseTree(HTML_GRAMMAR, code);
+    if (!tree)
+        return { defs: [], refs: [], imports: [] };
+    const defs = [];
+    const refs = [];
+    const imports = [];
+    try {
+        const root = tree.rootNode;
+        // Attributes: class="…" → refs, id="…" → defs, href/src → local imports.
+        for (const attr of root.descendantsOfType("attribute")) {
+            const nameNode = attr.namedChildren.find((c) => c.type === "attribute_name");
+            const valNode = attr.namedChildren.find((c) => c.type === "quoted_attribute_value" || c.type === "attribute_value");
+            if (!nameNode || !valNode)
+                continue;
+            const attrName = nameNode.text.toLowerCase();
+            const value = stripQuotes(valNode.text);
+            const line = attr.startPosition.row + 1;
+            if (attrName === "class") {
+                for (const cls of value.split(/\s+/).filter(Boolean))
+                    refs.push({ name: cls, line });
+            }
+            else if (attrName === "id") {
+                const id = value.trim();
+                if (id)
+                    defs.push({ name: id, kind: "id", line, signature: `#${id}` });
+            }
+            else if (attrName === "href" || attrName === "src") {
+                if (isLocalRef(value))
+                    imports.push({ spec: value, line });
+            }
+        }
+        // Embedded <style> → CSS defs; <script> → DOM refs. raw_text carries the inner
+        // source; its start row shifts the reported lines to the enclosing file.
+        const cssSeen = new Set();
+        for (const style of root.descendantsOfType("style_element")) {
+            const raw = style.namedChildren.find((c) => c.type === "raw_text");
+            if (raw) {
+                // One `seen` across every <style> block in the page, so a class defined in the
+                // first block is a reference in the second rather than a second definition.
+                const css = await extractCssDefs(raw.text, raw.startPosition.row, cssSeen);
+                defs.push(...css.defs);
+                refs.push(...css.refs);
+            }
+        }
+        for (const script of root.descendantsOfType("script_element")) {
+            const raw = script.namedChildren.find((c) => c.type === "raw_text");
+            if (raw)
+                refs.push(...extractDomRefs(raw.text, raw.startPosition.row));
+        }
+    }
+    finally {
+        tree.delete();
+    }
+    return { defs, refs, imports };
+}
+/**
+ * The line span of a named CSS rule or HTML element, so read_symbol /
+ * replace_symbol_body can target a selector's whole block by name. For CSS: the
+ * rule_set whose selector mentions `.name`/`#name`. For HTML: the element carrying
+ * `id="name"`. `nearLine` disambiguates when the name appears more than once.
+ * Null when it can't be located (the caller degrades to a ranged read).
+ */
+export async function markupSpan(absPath, code, name, nearLine) {
+    try {
+        if (isHtml(absPath))
+            return await htmlSpan(code, name, nearLine);
+        return await cssSpan(code, name, nearLine, 0);
+    }
+    catch {
+        return null;
+    }
+}
+async function cssSpan(code, name, nearLine, lineOffset) {
+    const tree = await parseTree(CSS_GRAMMAR, code);
+    if (!tree)
+        return null;
+    try {
+        const spans = [];
+        const token = new RegExp(`[.#]${escapeRegExp(name)}(?![\\w-])`);
+        for (const rule of tree.rootNode.descendantsOfType("rule_set")) {
+            const selectors = rule.namedChildren.find((c) => c.type === "selectors") ?? rule.namedChild(0);
+            if (selectors && token.test(selectors.text)) {
+                spans.push({ start: rule.startPosition.row + 1 + lineOffset, end: rule.endPosition.row + 1 + lineOffset });
+            }
+        }
+        return pickNearest(spans, nearLine);
+    }
+    finally {
+        tree.delete();
+    }
+}
+async function htmlSpan(code, name, nearLine) {
+    const tree = await parseTree(HTML_GRAMMAR, code);
+    if (!tree)
+        return null;
+    try {
+        const spans = [];
+        // Also search embedded <style> blocks, so a selector defined in a page resolves.
+        for (const style of tree.rootNode.descendantsOfType("style_element")) {
+            const raw = style.namedChildren.find((c) => c.type === "raw_text");
+            if (raw) {
+                const inner = await cssSpan(raw.text, name, nearLine, raw.startPosition.row);
+                if (inner)
+                    spans.push(inner);
+            }
+        }
+        // Elements carrying id="name".
+        for (const attr of tree.rootNode.descendantsOfType("attribute")) {
+            const nameNode = attr.namedChildren.find((c) => c.type === "attribute_name");
+            const valNode = attr.namedChildren.find((c) => c.type === "quoted_attribute_value" || c.type === "attribute_value");
+            if (!nameNode || !valNode)
+                continue;
+            if (nameNode.text.toLowerCase() !== "id" || stripQuotes(valNode.text).trim() !== name)
+                continue;
+            const el = enclosingElement(attr);
+            spans.push({ start: el.startPosition.row + 1, end: el.endPosition.row + 1 });
+        }
+        return pickNearest(spans, nearLine);
+    }
+    finally {
+        tree.delete();
+    }
+}
+// ── helpers ──────────────────────────────────────────────────────────────────
+/** Climb from an attribute to its enclosing element (for an id's element span). */
+function enclosingElement(node) {
+    let n = node;
+    while (n.parent && n.type !== "element")
+        n = n.parent;
+    return n.type === "element" ? n : node;
+}
+function isLocalRef(value) {
+    const v = value.trim();
+    if (!v || v.startsWith("#"))
+        return false; // in-page anchor, not a file
+    if (/^[a-z][a-z0-9+.-]*:/i.test(v))
+        return false; // http:, mailto:, data:, etc.
+    if (v.startsWith("//"))
+        return false; // protocol-relative
+    return true;
+}
+function stripQuotes(s) {
+    return s.replace(/^["']|["']$/g, "");
+}
+function oneLine(s) {
+    const flat = s.replace(/\s+/g, " ").trim();
+    return flat.length > 120 ? flat.slice(0, 119) + "…" : flat;
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=markup.js.map

package/dist/alternator/chassis/markup.js.map

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

package/dist/alternator/chassis/provision.js

@@ -0,0 +1,198 @@
+/**
+ * provision.ts — auto-install language servers, Mason-style.
+ *
+ * When a project uses a language whose server isn't bundled or on PATH, Mindweave
+ * fetches it itself into `~/.mindweave/servers/<key>/` and caches it, so precision
+ * "just appears" without the user installing anything. Sources mirror how servers
+ * are actually distributed:
+ *
+ *   - npm    — `npm install` into the cache (this is the clean, broad source).
+ *   - github — download the OS/arch release asset and extract it (binaries like
+ *              rust-analyzer / clangd). [implemented in the next phase]
+ *
+ * Safety: only the curated, version-pinned registry in servers.ts is ever
+ * installed — never an arbitrary package. Best-effort: a failed/blocked install
+ * just leaves that language on the tree-sitter tier. Disable with
+ * MINDWEAVE_NO_AUTO_INSTALL. In-flight installs are deduped so a language is fetched
+ * once per session.
+ */
+import { killTree, spawnManaged } from "../../tools/killTree.js";
+import { existsSync, promises as fs } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import zlib from "node:zlib";
+import AdmZip from "adm-zip";
+const IS_WIN = process.platform === "win32";
+export function autoInstallEnabled() {
+    return !process.env.MINDWEAVE_NO_AUTO_INSTALL;
+}
+export function platformKey() {
+    return `${process.platform}-${process.arch}`;
+}
+function installDir(key) {
+    return join(homedir(), ".mindweave", "servers", key);
+}
+/** The launch command for an already-installed server, or null if not installed. */
+export function resolveInstalled(key, spec) {
+    const dir = installDir(key);
+    if (spec.source === "npm") {
+        const bin = join(dir, "node_modules", ".bin", spec.binName + (IS_WIN ? ".cmd" : ""));
+        return existsSync(bin) ? bin : null;
+    }
+    const target = spec.targets[platformKey()];
+    if (!target)
+        return null;
+    const bin = join(dir, target.bin.replaceAll("{version}", spec.version));
+    return existsSync(bin) ? bin : null;
+}
+const inflight = new Map();
+/**
+ * Return the install command path, installing the server first if needed.
+ * Deduped per key; best-effort (returns null on any failure or when disabled).
+ */
+export function ensureInstalled(key, spec, log) {
+    const already = resolveInstalled(key, spec);
+    if (already)
+        return Promise.resolve(already);
+    if (!autoInstallEnabled())
+        return Promise.resolve(null);
+    let p = inflight.get(key);
+    if (!p) {
+        p = doInstall(key, spec, log).catch(() => null);
+        inflight.set(key, p);
+    }
+    return p;
+}
+async function doInstall(key, spec, log) {
+    log?.(`installing ${key} (${spec.source})…`);
+    await fs.mkdir(installDir(key), { recursive: true });
+    const ok = spec.source === "npm" ? await installNpm(key, spec) : await installGithub(key, spec);
+    if (!ok) {
+        log?.(`could not install ${key} — using tree-sitter for now`);
+        return null;
+    }
+    const resolved = resolveInstalled(key, spec);
+    log?.(resolved ? `installed ${key}` : `installed ${key} but couldn't find its binary`);
+    return resolved;
+}
+/**
+ * Ceilings for provisioning. Every wait here is on something external — a registry,
+ * a release download, an extract — and provisioning is BEST EFFORT: failing just
+ * leaves that language on the tree-sitter tier, which is a working state.
+ *
+ * Before these existed, none of the three waits below was bounded: the spawns had
+ * no timeout and were never killed, and `fetch` had no signal. A stalled install
+ * therefore hung forever AND left its process tree behind, and because installs are
+ * deduped through `inflight`, the never-resolving promise was handed to every later
+ * caller for the rest of the session. That is the shape of "fresh project dirs,
+ * processes piling up, runs hanging past ten minutes": a fresh dir is exactly when
+ * provisioning runs, and a warm one skips it entirely.
+ */
+const NPM_INSTALL_TIMEOUT_MS = 180_000; // a real install of a language server
+const DOWNLOAD_TIMEOUT_MS = 120_000; // release asset, tens of MB
+const EXTRACT_TIMEOUT_MS = 60_000;
+/**
+ * Run a child to completion, but never wait forever: on timeout the whole process
+ * tree is killed and the step reports failure. Tree-killing matters because the
+ * things spawned here (npm, tar) start children of their own, and killing only the
+ * shell leaves those holding on.
+ */
+export function runBounded(command, args, options, timeoutMs) {
+    return new Promise((resolve) => {
+        const child = spawnManaged(command, args, options);
+        let settled = false;
+        const finish = (ok) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(ok);
+        };
+        const timer = setTimeout(() => {
+            killTree(child.pid);
+            finish(false);
+        }, timeoutMs);
+        if (typeof timer.unref === "function")
+            timer.unref();
+        child.on("error", () => finish(false));
+        child.on("close", (code) => finish(code === 0));
+    });
+}
+// ── npm source ──────────────────────────────────────────────────────────────
+async function installNpm(key, spec) {
+    const dir = installDir(key);
+    // Root npm at this dir with a private package.json — otherwise npm walks up
+    // looking for one and can try to write node_modules at the drive root (EPERM).
+    await fs.writeFile(join(dir, "package.json"), JSON.stringify({ name: `mindweave-server-${key}`, version: "0.0.0", private: true }));
+    // Pass the whole command as one string for the shell (npm is a .cmd shim on
+    // Windows). Args are from the curated registry, not user input.
+    const cmd = `npm install ${spec.package}@${spec.version} --no-save --no-audit --no-fund --loglevel=error`;
+    return runBounded(cmd, [], { cwd: dir, shell: true, stdio: "ignore" }, NPM_INSTALL_TIMEOUT_MS);
+}
+// ── github source ────────────────────────────────────────────────────────────
+async function installGithub(key, spec) {
+    const target = spec.targets[platformKey()];
+    if (!target)
+        return false; // this OS/arch isn't published — degrade to tree-sitter
+    const dir = installDir(key);
+    const asset = target.asset.replaceAll("{version}", spec.version);
+    const url = `https://github.com/${spec.repo}/releases/download/${spec.version}/${asset}`;
+    const archive = join(dir, asset);
+    if (!(await download(url, archive)))
+        return false;
+    try {
+        if (asset.endsWith(".zip")) {
+            new AdmZip(archive).extractAllTo(dir, true);
+        }
+        else if (asset.endsWith(".tar.gz") || asset.endsWith(".tgz") || asset.endsWith(".tar.xz")) {
+            if (!(await runTar(archive, dir)))
+                return false;
+        }
+        else if (asset.endsWith(".gz")) {
+            // Single-file gzip → the decompressed bytes ARE the binary.
+            const out = zlib.gunzipSync(await fs.readFile(archive));
+            await fs.mkdir(join(dir, target.bin, ".."), { recursive: true });
+            await fs.writeFile(join(dir, target.bin.replaceAll("{version}", spec.version)), out);
+        }
+        else {
+            return false; // unknown archive format
+        }
+    }
+    catch {
+        return false;
+    }
+    finally {
+        await fs.rm(archive, { force: true }).catch(() => { });
+    }
+    const bin = join(dir, target.bin.replaceAll("{version}", spec.version));
+    if (!IS_WIN && existsSync(bin)) {
+        try {
+            await fs.chmod(bin, 0o755);
+        }
+        catch {
+            /* not fatal */
+        }
+    }
+    return existsSync(bin);
+}
+/** Download `url` to `dest` (follows GitHub's redirect to the CDN). */
+async function download(url, dest) {
+    // AbortSignal.timeout covers the whole exchange, body included — a stalled
+    // download mid-body is the realistic failure, not a stalled connect.
+    try {
+        const res = await fetch(url, { redirect: "follow", signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS) });
+        if (!res.ok)
+            return false;
+        await fs.writeFile(dest, Buffer.from(await res.arrayBuffer()));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Extract a tarball with the system `tar` (handles .tar.gz / .tar.xz on every
+ *  platform; Windows 10+ ships bsdtar). */
+function runTar(archive, dir) {
+    return runBounded("tar", ["-xf", archive, "-C", dir], { stdio: "ignore" }, EXTRACT_TIMEOUT_MS);
+}
+//# sourceMappingURL=provision.js.map

package/dist/alternator/chassis/provision.js.map

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

package/dist/alternator/chassis/rank.js

@@ -0,0 +1,72 @@
+const DAMPING = 0.85;
+const ITERATIONS = 30;
+const FOCUS_BOOST = 25; // restart weight for symbols in the focus files
+// Guard against pathological repos: skip ranking past this many symbols (the
+// caller falls back to a cheaper heuristic). Tunable later.
+const MAX_NODES = 50_000;
+export function rankSymbols(graph, focusFiles, limit) {
+    const nodes = graph.allSymbols();
+    const n = nodes.length;
+    if (n === 0 || n > MAX_NODES)
+        return [];
+    const index = new Map();
+    nodes.forEach((node, i) => index.set(node.id, i));
+    // Build out-adjacency: referrer-symbol → referenced-symbol.
+    const out = Array.from({ length: n }, () => []);
+    const byName = graph.byNameMap();
+    for (const [name, refs] of graph.allRefs()) {
+        const targets = (byName.get(name) ?? [])
+            .map((id) => index.get(id))
+            .filter((i) => i !== undefined);
+        if (targets.length === 0)
+            continue;
+        for (const ref of refs) {
+            for (const referrer of graph.symbolsInFile(ref.file)) {
+                const ri = index.get(referrer.id);
+                if (ri === undefined)
+                    continue;
+                for (const t of targets)
+                    if (t !== ri)
+                        out[ri].push(t);
+            }
+        }
+    }
+    // Personalization vector: boost symbols defined in the focus files.
+    const focus = new Set(focusFiles);
+    const pers = new Float64Array(n);
+    let persSum = 0;
+    for (let i = 0; i < n; i++) {
+        const w = focus.has(nodes[i].file) ? FOCUS_BOOST : 1;
+        pers[i] = w;
+        persSum += w;
+    }
+    for (let i = 0; i < n; i++)
+        pers[i] /= persSum;
+    // Power iteration.
+    let rank = new Float64Array(n).fill(1 / n);
+    for (let iter = 0; iter < ITERATIONS; iter++) {
+        const next = new Float64Array(n);
+        for (let i = 0; i < n; i++)
+            next[i] = (1 - DAMPING) * pers[i];
+        let dangling = 0;
+        for (let i = 0; i < n; i++) {
+            const edges = out[i];
+            if (edges.length === 0) {
+                dangling += rank[i];
+                continue;
+            }
+            const share = (DAMPING * rank[i]) / edges.length;
+            for (const t of edges)
+                next[t] += share;
+        }
+        // Dangling mass redistributed along the personalization vector.
+        for (let i = 0; i < n; i++)
+            next[i] += DAMPING * dangling * pers[i];
+        rank = next;
+    }
+    return nodes
+        .map((symbol, i) => ({ symbol, score: rank[i] }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+}
+//# sourceMappingURL=rank.js.map

package/dist/alternator/chassis/rank.js.map

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