mindweave 0.0.1 → 2.1.2

package/LICENSE

@@ -0,0 +1,190 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the acting entity and all other entities
+      that control, are controlled by, or are under common control with
+      that entity. For the purposes of this definition, "control" means
+      (i) the power, direct or indirect, to cause the direction or
+      management of such entity, whether by contract or otherwise, or
+      (ii) ownership of fifty percent (50%) or more of the outstanding
+      shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, trademark, patent, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Nimannns
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,14 +1,171 @@
-# Mindweave
-
-**This package is not released yet.** Installing it does nothing useful.
-
-Mindweave is a coding agent that lives in your terminal and works inside your
-repository: reading, searching, editing, running commands, and checking its own work.
-It runs entirely on your machine. There is no backend, no telemetry, and no account.
-
-It is being built in the open. The first installable release will land here.
-
-**Source, documentation, and how to run it today:**
-https://github.com/mindweave-cli/Mindweave
-
-Licensed under Apache-2.0.
+<h1 align="center">Mindweave (mwcode)</h1>
+
+<p align="center">
+  A fast, model-adaptive, terminal-native AI coding agent.<br>
+  You bring your own key. It runs on your machine. Nothing goes anywhere else.
+</p>
+
+<p align="center">
+  <a href="LICENSE">Apache 2.0</a> &nbsp;•&nbsp;
+  <a href="CHANGELOG.md">Changelog</a> &nbsp;•&nbsp;
+  <a href="KNOWN-ISSUES.md">Known issues</a> &nbsp;•&nbsp;
+  <a href="CONTRIBUTING.md">Contributing</a> &nbsp;•&nbsp;
+  <a href="https://x.com/mindweavecli">X</a>
+</p>
+
+---
+
+## What it is
+
+Mindweave is a coding agent that lives in your terminal and works inside your repository:
+reading, searching, editing, running commands, and checking its own work.
+
+It runs entirely on your machine. There is no backend, no telemetry and no account. Your
+code and your API key never reach a Mindweave server, because there isn't one.
+
+It is built lean on purpose. Most of a coding agent's context budget goes on scaffolding
+the model never needed. Mindweave keeps prompts thin and leaves the room for the model to
+reason about your code.
+
+## Mindweave 1
+
+This is Mindweave 1 which is finally out, tagged `mindweave-1`. It is on npm, and the
+website is up. Install with the steps below.
+
+What landed in it is in the [changelog](CHANGELOG.md): thirteen model providers, a
+rebuilt terminal interface, reworked prompt caching and token accounting, project notes
+the agent maintains across sessions, and a long list of things that were quietly wrong.
+
+## Deferred tools, fixed in v2.1.0
+
+Tools that are not advertised up front are found with `find_tools`. Finding one returned
+its schema without adding the tool to the list sent with the next request, and a model
+that will only call a function present in that list could not call what it had just been
+shown. Every deferred tool was unreachable on those models, and a session resumed with
+`/continue` had the same shape, because nothing recorded which tools had been activated.
+The screenshot tool was where it was most visible: it could be found, described, and never
+run, which read as the model looping over a tool it could not reach.
+
+`find_tools` now activates what it finds. The tool joins the advertised set for the rest
+of the session, is written to the session file and restored on resume, and a forked
+session receives its own copy. The rest of v2.1.0 is in the [changelog](CHANGELOG.md).
+
+## Install
+
+Requires **Windows** and **Node.js 20+**. macOS and Linux are not supported yet, and the
+reason is written down in [KNOWN-ISSUES.md](KNOWN-ISSUES.md) rather than glossed over.
+
+macOS and Linux support is coming soon.
+
+```bash
+npm install -g mindweave
+```
+
+Then, in any project:
+
+```bash
+cd your-project
+mindweave          # or mw, for short
+```
+
+To build from source instead — for development, or to run an unreleased change:
+
+```bash
+git clone https://github.com/mindweave-cli/Mindweave
+cd Mindweave
+npm install
+npm run build
+npm link          # makes the `mindweave` command available globally
+```
+
+It asks for an API key on first launch and saves it to `~/.mindweave/.env`, so every
+project afterwards just works. `mindweave --help` covers the launch flags; everything
+else is configured inside a session.
+
+
+## What it can do
+
+**13 providers, 47 models, one key.** DeepSeek, Anthropic, OpenAI, Gemini, xAI, Mistral,
+Groq, Cerebras, Qwen, Kimi, GLM, Meta and MiniMax. Each family gets its own driver so it
+runs at its best without bloating the shared core, and only the driver you are using is
+ever loaded. Switch with `/provider` and `/model`; the choice is remembered per project.
+Full list: [PROVIDERS.md](src/drivers/PROVIDERS.md).
+
+**Deterministic code intelligence.** A background lane indexes your repo with tree-sitter
+and language servers, costing no tokens, so the agent understands your codebase rather
+than just the file you opened.
+
+**Real tools.** File read and edit, multi-file edits, ripgrep search, a shell with
+background jobs, sub-agents, and compiler diagnostics. Read-before-edit is enforced, and
+`/undo` is a real net rather than a hope.
+
+**Session memory.** Long sessions stay sharp through automatic compaction plus a running
+state summary that survives it. The agent can read its own earlier sessions in a project,
+so "what did we do last time" gets a real answer instead of a guess.
+
+**MCP servers.** Connect external tool servers (GitHub, Postgres, your own) with
+`/mcp add` or by asking in plain words. They start with your session, and their output is
+treated as untrusted by default. Full guide: [docs/MCP.md](docs/MCP.md).
+
+**Images and web search.** Drag a screenshot into the prompt or write `@shot.png`; a model
+that can see gets the image, and one that cannot says so plainly. Ask about a recent
+release and the agent looks it up instead of guessing, through your own provider, with no
+second account to manage.
+
+**Seeing your app.** It can capture one window and look at it, which is how you tell an
+app that started from an app that works. One window, never the whole screen, and it asks
+first, naming the window it is about to capture.
+
+**Project notes that carry across sessions.** MINDWEAVE.md is loaded every session and
+maintained by the agent, so a new conversation continues rather than starts over. Split
+it with `@./path` imports, keep machine-wide notes in `~/.mindweave/MINDWEAVE.md`, and
+put a MINDWEAVE.md inside a folder for conventions that are true only there — that one
+is loaded only while the agent works in it. `/init` writes the first one.
+
+**Per-project governor.** Give a project standing rules, reusable skills, and forbidden
+paths or commands the agent has to respect.
+
+## Using it
+
+| Command | What it does |
+| --- | --- |
+| `/help` | Lists every command |
+| `/init` | Writes MINDWEAVE.md, the project notes loaded every session |
+| `/provider` · `/model` · `/think` | Who answers, which model, how hard it reasons |
+| `/clear` · `/continue` | Start fresh, or resume an earlier session |
+| `/undo` | Reverts what the last turn changed |
+| `/mcp` | Manages connected MCP servers |
+| `shift-tab` | Cycles interaction modes |
+
+Type while it works and your message queues; press up to take it back and edit it.
+
+## Read more
+
+| | |
+| --- | --- |
+| [CHANGELOG.md](CHANGELOG.md) | What changed, and what each fix actually was |
+| [KNOWN-ISSUES.md](KNOWN-ISSUES.md) | What is broken or unfinished, written down rather than carried quietly |
+| [PHILOSOPHY.md](PHILOSOPHY.md) | How the project is run and what gets into the core. Short, and the honest version |
+| [BOUNDARY.md](BOUNDARY.md) | What belongs in the core versus a driver |
+| [CONTRIBUTING.md](CONTRIBUTING.md) | Mechanics, and what is most useful to report |
+| [SECURITY.md](SECURITY.md) | Reporting a vulnerability |
+| [docs/MCP.md](docs/MCP.md) | Connecting and trusting MCP servers |
+
+## Contributing
+
+Contributions are welcome, especially **model drivers**: Ollama is a stub waiting for
+someone, and a driver is a smaller job than people expect, owning one provider's wire
+format and nothing about how the agent behaves.
+
+Small fixes and reproduced bugs with a failing test can go straight to a pull request.
+For anything larger, start a Discussion first. AI-assisted contributions are fine; the
+one rule is that you understand and have tested what you are submitting.
+
+Bug reports are genuinely the most useful thing you can send. Mindweave is developed by
+running it on real projects and fixing what breaks, and nearly everything in the
+changelog started as a failure someone watched happen. [What to include, and what is
+especially worth reporting.](CONTRIBUTING.md#reporting-a-bug)
+
+## License
+
+[Apache License 2.0](LICENSE).

package/dist/alternator/chassis/cache.js

@@ -0,0 +1,47 @@
+/**
+ * cache.ts — persist the built graph so a large repo doesn't re-parse every
+ * session.
+ *
+ * Stored under `~/.mindweave/chassis/<sanitized-project>/graph.json` (next to where
+ * sessions live). On startup the lane loads this, then reconciles only the files
+ * whose size/mtime changed — so a warm start is near-instant. Best-effort: a
+ * missing/corrupt cache just means a full rebuild, never an error.
+ */
+import { promises as fs } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// v2: symbols carry endLine + doc (nested outlines, doc-comments). An older cache
+// is simply ignored and rebuilt, so the new fields are always present.
+// v3: the graph now includes HTML/CSS markup symbols + DOM string-link refs, so an
+// older cache must rebuild to pick up a project's stylesheets and pages.
+const VERSION = 3;
+function sanitizeProjectPath(root) {
+    return root.replace(/[/\\:]+/g, "-").replace(/^-+|-+$/g, "") || "root";
+}
+function cachePath(root) {
+    return join(homedir(), ".mindweave", "chassis", sanitizeProjectPath(root), "graph.json");
+}
+/** Load a saved snapshot for `root`, or null if absent/unreadable/stale-version. */
+export async function loadCache(root) {
+    try {
+        const raw = await fs.readFile(cachePath(root), "utf8");
+        const snap = JSON.parse(raw);
+        return snap.version === VERSION ? snap : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Write a snapshot for `root`. Best-effort: returns false on any failure. */
+export async function saveCache(root, snapshot) {
+    try {
+        const path = cachePath(root);
+        await fs.mkdir(join(path, ".."), { recursive: true });
+        await fs.writeFile(path, JSON.stringify({ version: VERSION, ...snapshot }), "utf8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/alternator/chassis/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,kFAAkF;AAClF,uEAAuE;AACvE,mFAAmF;AACnF,yEAAyE;AACzE,MAAM,OAAO,GAAG,CAAC,CAAC;AAelB,SAAS,mBAAmB,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC;AACzE,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;AAC3F,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;QAChD,OAAO,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,QAA0C;IACtF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QACpF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/alternator/chassis/domRefs.js

@@ -0,0 +1,53 @@
+/**
+ * domRefs.ts — pull DOM class/id references out of JavaScript (pure, regex).
+ *
+ * A page wires HTML/CSS/JS by literal name: `document.getElementById("hero")`,
+ * `querySelector(".hero-stats")`, `classList.add("active")`. These are the JS half
+ * of a cross-language string wire — extracting them as name-level references lets
+ * the graph connect a CSS rule / HTML element to the script that manipulates it.
+ * These names feed Mindweave's name-keyed def/ref graph, so `references(".hero")`
+ * includes the script that touches it.
+ *
+ * Deliberately conservative: ONLY well-known DOM selector APIs, so an arbitrary
+ * string literal never becomes graph noise. Pure + line-based (unit-tested).
+ */
+// Capture group 1 is the class/id name (a leading `.`/`#` is stripped). querySelector
+// takes a full selector, so we grab just its first simple token — enough to wire it.
+const PATTERNS = [
+    /\bgetElementById\(\s*['"`]([#.]?[A-Za-z_][\w-]*)['"`]/g,
+    /\bgetElementsByClassName\(\s*['"`]([#.]?[A-Za-z_][\w-]*)['"`]/g,
+    /\bquerySelector(?:All)?\(\s*['"`]([#.]?[A-Za-z_][\w-]*)/g,
+    /\bclassList\.(?:add|remove|toggle|contains|replace)\(\s*['"`]([A-Za-z_][\w-]*)['"`]/g,
+];
+/** DOM class/id names referenced in `code`. `lineOffset` shifts the reported line
+ *  (used when the code is an embedded `<script>` block inside an HTML file). */
+export function extractDomRefs(code, lineOffset = 0) {
+    const out = [];
+    const seen = new Set();
+    for (const re of PATTERNS) {
+        re.lastIndex = 0;
+        let m;
+        while ((m = re.exec(code)) !== null) {
+            const name = m[1].replace(/^[#.]/, "").trim();
+            if (!name)
+                continue;
+            const line = lineAt(code, m.index) + lineOffset;
+            const key = `${name}@${line}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push({ name, line });
+        }
+    }
+    return out;
+}
+/** The 1-based line a character offset falls on. */
+function lineAt(code, index) {
+    let line = 1;
+    const limit = Math.min(index, code.length);
+    for (let i = 0; i < limit; i++)
+        if (code[i] === "\n")
+            line++;
+    return line;
+}
+//# sourceMappingURL=domRefs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domRefs.js","sourceRoot":"","sources":["../../../src/alternator/chassis/domRefs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,sFAAsF;AACtF,qFAAqF;AACrF,MAAM,QAAQ,GAAsB;IAClC,wDAAwD;IACxD,gEAAgE;IAChE,0DAA0D;IAC1D,sFAAsF;CACvF,CAAC;AAEF;gFACgF;AAChF,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,UAAU,GAAG,CAAC;IACzD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC;QACjB,IAAI,CAAyB,CAAC;QAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC;YAChD,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,oDAAoD;AACpD,SAAS,MAAM,CAAC,IAAY,EAAE,KAAa;IACzC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;QAAE,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,IAAI,EAAE,CAAC;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/alternator/chassis/extractWorker.js

@@ -0,0 +1,65 @@
+/**
+ * extractWorker.ts — the other side of isolation.ts.
+ *
+ * Runs as a forked CHILD PROCESS and calls the same treesitter entry points the host
+ * does; the MINDWEAVE_TS_IN_WORKER env flag (set by the host at spawn) is what stops
+ * those entry points from routing back into isolation — in here, "heavy" grammars run
+ * in-process, which is the entire point: when one of them dies, it dies over here.
+ *
+ * ── WHY A PROCESS AND NOT A WORKER THREAD ───────────────────────────────────────
+ *
+ * This was a worker_thread first, and that could not work. The failure being contained
+ * is a V8 **Zone** allocation failure, and V8 handles that by calling
+ * `FatalProcessOutOfMemory`, which aborts the PROCESS. A worker thread shares the
+ * process, so the abort took the host down anyway — measured: parsing two lines of
+ * OCaml through the worker returned a correct result and then killed the host with
+ * exit code 3, in the compiled build, with no teardown requested.
+ *
+ * `resourceLimits` do not help, because they bound the JS heap and the code range, and
+ * a Zone is neither. That is also why the old "reproduction" case looked contained: an
+ * 8 MB heap limit produces a *heap* OOM, which really is thread-local and really does
+ * terminate just the worker. The two failures look alike in a stack trace and behave
+ * completely differently.
+ *
+ * A separate process is the only boundary V8's fatal handler cannot cross.
+ *
+ * Protocol: { id, op: "extract" | "span", ...args } in, { id, result } out, over the
+ * fork IPC channel. Any error is a null result — the caller's contract for the
+ * fallback tier.
+ */
+import { treeSitterExtract, treeSitterSpan } from "./treesitter.js";
+import { extractMarkup } from "./markup.js";
+if (!process.send)
+    throw new Error("extractWorker must run as a forked child process");
+process.on("message", async (msg) => {
+    let result = null;
+    try {
+        if (msg.op === "extract") {
+            result = await treeSitterExtract(msg.absPath, msg.code);
+        }
+        else if (msg.op === "markup") {
+            // The markup tier walks the tree itself, so it runs whole over here — only its
+            // finished defs/refs travel back. A live tree cannot cross the channel.
+            result = await extractMarkup(msg.absPath, msg.code);
+        }
+        else if (msg.op === "span") {
+            result = await treeSitterSpan(msg.absPath, msg.code, msg.name, msg.nearLine);
+        }
+    }
+    catch {
+        result = null;
+    }
+    // The channel can be gone if the host gave up on us mid-parse; that is its right,
+    // and there is nobody left to tell.
+    try {
+        // RSS rides along with every reply. The host bounds this process's memory but
+        // cannot observe it from outside, and the thing being bounded is WASM memory that
+        // no host-side proxy tracks — so the measurement has to be taken here, after the
+        // work, and reported. See workerRssMb in isolation.ts.
+        process.send({ id: msg.id, result, rss: process.memoryUsage().rss });
+    }
+    catch {
+        // Nothing to do — the host has already moved on.
+    }
+});
+//# sourceMappingURL=extractWorker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractWorker.js","sourceRoot":"","sources":["../../../src/alternator/chassis/extractWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C,IAAI,CAAC,OAAO,CAAC,IAAI;IAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;AAEvF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAQ,EAAE,EAAE;IACvC,IAAI,MAAM,GAAY,IAAI,CAAC;IAC3B,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,GAAG,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC/B,+EAA+E;YAC/E,wEAAwE;YACxE,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;aAAM,IAAI,GAAG,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;IACD,kFAAkF;IAClF,oCAAoC;IACpC,IAAI,CAAC;QACH,8EAA8E;QAC9E,kFAAkF;QAClF,iFAAiF;QACjF,uDAAuD;QACvD,OAAO,CAAC,IAAK,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC,CAAC,CAAC"}