@yalehwang/archguard 0.1.31 → 0.1.32

package/README.md

@@ -38,30 +38,91 @@ npm install -g @yalehwang/archguard
 
 ### Using with Claude Code
 
-Register the MCP server (project scope):
+Install ArchGuard as a Claude Code plugin from the npm-source marketplace.
+Claude Code runs `npm install` of the plugin package, which depends on an
+exact `@yalehwang/archguard` version — the full runtime dependency closure
+(ordinary JS dependencies, `web-tree-sitter`, bundled grammar WASM assets,
+platform-selected optional packages) is resolved on your machine, with no
+global `archguard` binary, vendored `node_modules`, or `NODE_PATH` involved:
 
 ```bash
-claude mcp add --scope project archguard -- archguard mcp
+claude plugin marketplace add yaleh/archguard
+claude plugin install archguard@archguard
 ```
 
-Or install it for Claude Code user scope, including the bundled repository
-skills from this checkout:
+Restart Claude Code afterwards so the plugin loads. The plugin bundles the
+`archguard` MCP server (launched via `plugin/mcp-launcher.mjs`, which resolves
+the ArchGuard CLI entry from the plugin's own npm dependency tree) plus the
+`feature-developer` and `project-semantics-discovery` skills.
+
+Alternatively, register the MCP server directly without the plugin (project
+scope, requires a global `archguard` install):
 
 ```bash
-bash scripts/install-claude-user-scope.sh
+claude mcp add --scope project archguard -- archguard mcp
 ```
 
-This installs the `archguard` binary globally for the current user, registers
-`archguard mcp` in `~/.claude/mcp.json`, and syncs all skills from
-`.agents/skills/` into `~/.claude/skills/`.
+For a local checkout, `scripts/install-claude-user-scope.sh` runs the same
+npm-source marketplace flow against your checkout: it adds (or updates) the
+`archguard` marketplace registration, installs (or updates) the
+`archguard@archguard` plugin at user scope, and removes any legacy ArchGuard
+entry that older installers left in the deprecated `~/.claude/mcp.json`. It
+never installs a global `archguard` binary, never writes a registration into
+`~/.claude/mcp.json`, and never installs or builds native Tree-sitter
+packages. The script is idempotent — re-run it to upgrade after pulling a
+new version:
 
-If you already have fresh `dist/` artifacts and only want to re-install the user
-scope wiring, use:
+```bash
+bash scripts/install-claude-user-scope.sh
+# Register the GitHub marketplace source instead of the local checkout:
+bash scripts/install-claude-user-scope.sh --marketplace-source yaleh/archguard
+```
+
+### Parser runtime selection (auto | native | wasm)
+
+A normal install is the **deterministic WASM baseline**: `web-tree-sitter`
+plus the bundled grammar WASM assets are always installed, and the native
+`tree-sitter` runtime/grammar packages are never installed or built by
+ArchGuard itself. This holds for the Claude plugin installer as well:
+`scripts/install-claude-user-scope.sh` never installs, builds, or globally
+mutates native Tree-sitter packages — the plugin closure it registers is the
+WASM baseline. Per language, `ARCHGUARD_PARSER_RUNTIME` selects the
+backend:
+
+- `auto` (default) — probe the native `(runtime, grammar)` tuple with a health
+  check; use native only when the probe passes, otherwise fall back to WASM
+  and record the reason in diagnostics.
+- `native` — require native; fail loudly with an actionable error if the
+  probe fails (never silently substitutes WASM).
+- `wasm` — never touch native modules; portable and deterministic.
+
+`ARCHGUARD_PARSER_RUNTIME` is the canonical setting. The former
+`ARCHGUARD_PARSER_BACKEND` is a deprecated alias: it applies only when the
+canonical variable is unset, and ArchGuard then prints a one-time stderr
+warning. Every analysis surfaces a one-line effective-runtime summary —
+language → backend chosen → source of choice → fallback reason — in
+`--verbose` mode and always when a fallback occurs; MCP protocol output
+stays clean (diagnostics route to stderr).
 
 ```bash
-bash scripts/install-claude-user-scope.sh --skip-build
+# Default (auto): per-language health-checked native-first selection with WASM fallback
+ARCHGUARD_PARSER_RUNTIME=auto archguard analyze -s ./src --lang go
+
+# Force the portable baseline (diagnostics, restricted CI)
+ARCHGUARD_PARSER_RUNTIME=wasm archguard analyze -s ./src --lang go
+
+# Require the native accelerator; fail if unavailable or ABI-incompatible
+ARCHGUARD_PARSER_RUNTIME=native archguard analyze -s ./src --lang go
 ```
 
+Native acceleration is opt-in and discovered only at runtime: install the
+optional native packages (`tree-sitter` + the per-language grammar packages,
+declared as optional peers) into ArchGuard's own package scope, or point
+`ARCHGUARD_NATIVE_MODULE_ROOT=/path/to/root` at a trusted module root
+containing them. The analyzed project's `node_modules` is never consulted.
+See [Parser Runtime Selection](docs/user-guide/parser-runtime.md) for the
+full policy.
+
 Then ask Claude to analyze any project:
 
 > Analyze the architecture of `/path/to/my-project` using archguard MCP.
@@ -96,21 +157,45 @@ Claude will call `archguard_analyze(includeTests: true)`, then sequence through
 
 ### Using with Codex
 
-Register the MCP server:
+Codex does not read Claude plugin manifests, so its MCP configuration must
+launch an ArchGuard installation that owns its own runtime dependency closure.
+`scripts/install-codex-user-scope.sh` registers exactly one TOML-safe
+`[mcp_servers.archguard]` table in the Codex user config
+(`~/.codex/config.toml`, or `$CODEX_HOME/config.toml`) that invokes the
+npm-installed `@yalehwang/archguard` CLI — never Claude's versioned plugin
+cache and never the source checkout:
 
 ```bash
-codex mcp add archguard -- archguard mcp
+# Registers the global npm install (discovered via `npm root -g`):
+bash scripts/install-codex-user-scope.sh
+
+# Or point at a specific npm-installed ArchGuard root explicitly:
+bash scripts/install-codex-user-scope.sh --archguard-root "$(npm root -g)"
 ```
 
-Or add to `~/.codex/config.toml`:
+The installer is idempotent (re-run it to refresh after an upgrade): it updates
+the single archguard table in place, preserves all unrelated Codex
+configuration, and forwards the parser-runtime policy as
+`ARCHGUARD_PARSER_RUNTIME` (`--parser-runtime auto|native|wasm`, default
+`auto`). It writes an entry of this shape:
 
 ```toml
 [mcp_servers.archguard]
-command = "archguard"
-args = ["mcp"]
+command = "node"
+args = ["<npm-install>/@yalehwang/archguard/dist/cli/index.js", "mcp"]
+env = { ARCHGUARD_PARSER_RUNTIME = "auto" }
+startup_timeout_sec = 30
+tool_timeout_sec = 120
+```
+
+Alternatively, register manually (requires `archguard` on Codex's `PATH`):
+
+```bash
+codex mcp add archguard -- archguard mcp
 ```
 
-Then prompt Codex in the same way. The same MCP tools are available.
+Then prompt Codex in the same way and verify in the Codex TUI with `/mcp` (or
+`codex mcp list`). The same MCP tools are available.
 
 ### Analyzing an External Project
 
@@ -265,10 +350,12 @@ The MCP server exposes the query tools plus `archguard_analyze`, which refreshes
 claude mcp add --scope project archguard -- archguard mcp
 ```
 
-**Codex** — add via CLI or `~/.codex/config.toml`:
+**Codex** — register at user scope via the installer (launches the
+npm-installed CLI), or manually via CLI / `~/.codex/config.toml`:
 
 ```bash
-codex mcp add archguard -- archguard mcp
+bash scripts/install-codex-user-scope.sh        # idempotent, TOML-safe
+codex mcp add archguard -- archguard mcp        # manual alternative
 ```
 
 **Available MCP tools:**

package/assets/grammars/benchmarks.md

@@ -0,0 +1,101 @@
+<!-- Generated by scripts/benchmark-parser-backends.mjs (npm run build first). -->
+# Parser backend benchmark (native vs WASM)
+
+- date: 2026-07-30
+- node: v26.5.0
+- platform: linux/x64
+- iterations per fixture: 50 (after warm-up)
+
+| language | parser-only native (ms) | parser-only wasm (ms) | ratio | pipeline native (ms) | pipeline wasm (ms) | ratio |
+|---|---|---|---|---|---|---|
+| go | 0.235 | 0.731 | 3.11x | 2.998 | 1.378 | 0.46x |
+| java | 0.271 | 0.377 | 1.39x | 2.232 | 0.974 | 0.44x |
+| python | 0.383 | 0.329 | 0.86x | 1.680 | 0.628 | 0.37x |
+| cpp | 0.691 | 2.057 | 2.98x | 3.160 | 1.553 | 0.49x |
+| kotlin | 0.560 | 1.848 | 3.30x | 5.585 | 1.902 | 0.34x |
+| **mean** | 0.428 | 1.069 | **2.33x** | 3.131 | 1.287 | **0.42x** |
+
+"pipeline" = plugin.parseCode() (tree-sitter parse + extractor + ArchJSON mapping),
+the parse-dominated portion of an end-to-end ArchGuard analysis.
+
+## TASK-40 after: process caches and parse-worker crossover
+
+Measured 2026-07-30 on Node v26.5.0, linux/x64, 4 cores. The small/medium
+runs were heavily contended by three concurrent task worktrees (1-minute load
+9.40-9.97); the large run had load 2.47. Ratios, not absolute timings, are the
+decision evidence.
+
+| fixture size | iterations | parser-only native (mean ms) | parser-only WASM (mean ms) | ratio | full-analysis native (mean ms) | full-analysis WASM (mean ms) | ratio |
+|---|---:|---:|---:|---:|---:|---:|---:|
+| small (1x) | 20 | 0.677 | 0.589 | **1.09x** | 3.400 | 1.188 | **0.45x** |
+| medium (10x) | 10 | 13.719 | 8.378 | **1.05x** | 38.818 | 14.469 | **0.42x** |
+| large (50x) | 5 | 48.947 | 28.224 | **0.93x** | 157.095 | 54.580 | **0.41x** |
+
+The committed worker threshold is **12 files** (`PARSE_WORKER_THRESHOLD`). Below
+that, serial parsing avoids worker startup; above it, synchronous parsing runs
+in a bounded pool (maximum configured concurrency). WASM runtime and grammar
+promises are cached per asset directory for the process lifetime and parser
+sessions are reused within their owning worker/plugin.
+
+Decision: no exception to the 2.5x full-analysis ceiling is needed. Both measured
+full-analysis ratios are below 1x on this host (and therefore within the stated
+"never exceeds 2.5x" bound). The earlier uncontended baseline remains above for
+comparison; the contended after run must not be read as an absolute speedup.
+Memory/shutdown evidence is enforced by `wasm-memory.test.ts` and
+`parser-pool.test.ts` (success/error termination and serial/parallel determinism).
+
+
+### TASK-40 audit remediation: real end-to-end path
+
+Measured after production wiring on Node v26.5.0, linux/x64, 4 cores, 1-minute
+load 2.44. Each end-to-end fixture is a 12-file project and includes file
+discovery, runtime selection, threshold decision, process pool lifecycle,
+analysis merge, and query persistence.
+
+| scope | parser-only ratio | parse+extract ratio | end-to-end ratio |
+|---|---:|---:|---:|
+| five-language mean | **1.32x** | **0.54x** | **0.62x** |
+
+Per-language end-to-end WASM/native ratios: Go 0.17x, Java 0.66x, Python
+0.97x, C++ 0.64x, Kotlin 0.65x. No result exceeds the 2.5x ceiling. Absolute
+means were 127.9 ms native and 86.5 ms WASM under the recorded load. The
+benchmark uses `runAnalysis()` rather than treating `plugin.parseCode()` as a
+complete analysis; the latter remains separately reported as parse+extract.
+
+
+### TASK-40 final audit: verified project-worker dispatch
+
+Node v26.5.0, linux/x64, 4 cores; load average 3.30/1.58/1.36. The benchmark
+now fails if `ProcessParseWorkerPools.dispatchCount` remains zero, proving each
+native and WASM sample crossed the 12-file threshold and executed the language
+plugin's complete `parseProject()` inside a real worker. Three measured runs per
+parser-only fixture were used; each end-to-end runtime analyzed one 12-file
+project.
+
+| measure | native mean | WASM mean | WASM/native |
+|---|---:|---:|---:|
+| parser-only | 0.713 ms | 0.665 ms | **1.32x** (mean language ratio) |
+| parse+extract | 3.586 ms | 1.476 ms | **0.50x** |
+| end-to-end project | 2141.8 ms | 1858.0 ms | **0.74x** |
+
+End-to-end per-language ratios: Go 0.17x, Java 0.77x, Python 0.95x, C++
+1.05x, Kotlin 0.76x. No 2.5x exception is required. The higher absolute times
+relative to the earlier audit run are worker startup and complete project
+plugin initialization now honestly included rather than bypassed.
+
+### TASK-40 targeted audit: alternating repeated E2E samples
+
+Clean build, Node v26.5.0, linux/x64, 4 cores; load 3.53/2.23/1.74.
+Each backend ran three complete 12-file analyses, alternating order by
+iteration. The benchmark fails closed when worker dispatch is zero and compares
+canonical structural output (version, language, source files, entities,
+relations, modules) across native/WASM and all iterations.
+
+| measure | native mean | WASM mean | ratio |
+|---|---:|---:|---:|
+| parser-only | 0.766 ms | 0.688 ms | **1.33x** mean language ratio |
+| parse+extract | 3.818 ms | 1.735 ms | **0.54x** |
+| E2E median of 3/backend | 781.1 ms | 774.1 ms | **1.00x** |
+
+E2E ratios: Go 1.01x, Java 1.13x, Python 1.02x, C++ 0.89x, Kotlin
+0.95x. All structural outputs were equivalent and no ratio exceeded 2.5x.

package/assets/grammars/checksums.json

@@ -0,0 +1,8 @@
+{
+  "tree-sitter.wasm": "sha256:f38dcc4b43b818f9a0785bc1c6d5611a75ac4cdd428ff3f02757c34ca4e46d7f",
+  "tree-sitter-go.wasm": "sha256:9504573f352b20be7f2f1911754d710622aedc15afff16d5ed8fb5645681aee7",
+  "tree-sitter-java.wasm": "sha256:4fdeac4ca6ca089f06c6f7e562abcac1733cd465728cc7031ebb73c2019122c4",
+  "tree-sitter-python.wasm": "sha256:16108b50df4ee9a30168794252ab55e7c93bfc5765d7fa0aa3e335752c515f47",
+  "tree-sitter-cpp.wasm": "sha256:174eb0deb75b2ec7881bcacda9f995648d8e683956e5c2267e69ab6dc503fcbf",
+  "tree-sitter-kotlin.wasm": "sha256:7009d69453bc8735e438b2818a633efb21c88f99782769abba60dffedfab73f7"
+}

package/{node_modules/tree-sitter/LICENSE → assets/grammars/licenses/tree-sitter-cpp.LICENSE}

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2014 maxbrunsfeld
+Copyright (c) 2014 Max Brunsfeld
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/{node_modules/node-gyp-build/LICENSE → assets/grammars/licenses/tree-sitter-go.LICENSE}

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2017 Mathias Buus
+Copyright (c) 2014 Max Brunsfeld
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -9,13 +9,13 @@ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assets/grammars/licenses/tree-sitter-java.LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Ayman Nadeem
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assets/grammars/licenses/tree-sitter-kotlin.LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Amaan Qureshi <amaanq12@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assets/grammars/licenses/tree-sitter-python.LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Max Brunsfeld
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assets/grammars/licenses/tree-sitter.LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018-2024 Max Brunsfeld
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assets/grammars/provenance.json

@@ -0,0 +1,66 @@
+{
+  "generatedBy": "scripts/fetch-grammar-wasms.mjs",
+  "abi": "tree-sitter ABI 14/15 (web-tree-sitter 0.25.x)",
+  "sources": [
+    {
+      "asset": "tree-sitter.wasm",
+      "role": "runtime",
+      "package": "web-tree-sitter",
+      "version": "0.25.10",
+      "license": "MIT",
+      "licenseFile": "licenses/tree-sitter.LICENSE",
+      "tarball": "https://registry.npmjs.org/web-tree-sitter/-/web-tree-sitter-0.25.10.tgz",
+      "tarballIntegrity": "sha512-Y09sF44/13XvgVKgO2cNDw5rGk6s26MgoZPXLESvMXeefBf7i6/73eFurre0IsTW6E14Y0ArIzhUMmjoc7xyzA=="
+    },
+    {
+      "asset": "tree-sitter-go.wasm",
+      "role": "grammar",
+      "package": "tree-sitter-go",
+      "version": "0.25.0",
+      "license": "MIT",
+      "licenseFile": "licenses/tree-sitter-go.LICENSE",
+      "tarball": "https://registry.npmjs.org/tree-sitter-go/-/tree-sitter-go-0.25.0.tgz",
+      "tarballIntegrity": "sha512-APBc/Dq3xz/e35Xpkhb1blu5UgW+2E3RyGWawZSCNcbGwa7jhSQPS8KsUupuzBla8PCo8+lz9W/JDJjmfRa2tw=="
+    },
+    {
+      "asset": "tree-sitter-java.wasm",
+      "role": "grammar",
+      "package": "tree-sitter-java",
+      "version": "0.23.5",
+      "license": "MIT",
+      "licenseFile": "licenses/tree-sitter-java.LICENSE",
+      "tarball": "https://registry.npmjs.org/tree-sitter-java/-/tree-sitter-java-0.23.5.tgz",
+      "tarballIntegrity": "sha512-Yju7oQ0Xx7GcUT01mUglPP+bYfvqjNCGdxqigTnew9nLGoII42PNVP3bHrYeMxswiCRM0yubWmN5qk+zsg0zMA=="
+    },
+    {
+      "asset": "tree-sitter-python.wasm",
+      "role": "grammar",
+      "package": "tree-sitter-python",
+      "version": "0.25.0",
+      "license": "MIT",
+      "licenseFile": "licenses/tree-sitter-python.LICENSE",
+      "tarball": "https://registry.npmjs.org/tree-sitter-python/-/tree-sitter-python-0.25.0.tgz",
+      "tarballIntegrity": "sha512-eCmJx6zQa35GxaCtQD+wXHOhYqBxEL+bp71W/s3fcDMu06MrtzkVXR437dRrCrbrDbyLuUDJpAgycs7ncngLXw=="
+    },
+    {
+      "asset": "tree-sitter-cpp.wasm",
+      "role": "grammar",
+      "package": "tree-sitter-cpp",
+      "version": "0.23.4",
+      "license": "MIT",
+      "licenseFile": "licenses/tree-sitter-cpp.LICENSE",
+      "tarball": "https://registry.npmjs.org/tree-sitter-cpp/-/tree-sitter-cpp-0.23.4.tgz",
+      "tarballIntegrity": "sha512-qR5qUDyhZ5jJ6V8/umiBxokRbe89bCGmcq/dk94wI4kN86qfdV8k0GHIUEKaqWgcu42wKal5E97LKpLeVW8sKw=="
+    },
+    {
+      "asset": "tree-sitter-kotlin.wasm",
+      "role": "grammar",
+      "package": "@tree-sitter-grammars/tree-sitter-kotlin",
+      "version": "1.1.0",
+      "license": "MIT",
+      "licenseFile": "licenses/tree-sitter-kotlin.LICENSE",
+      "tarball": "https://registry.npmjs.org/@tree-sitter-grammars/tree-sitter-kotlin/-/tree-sitter-kotlin-1.1.0.tgz",
+      "tarballIntegrity": "sha512-vlVXaxEE8t2kpJgfZpa8XVvxcnKw9AYtRTgy7KWjsDmAsadk06RxAT80IXOgGQnmM9i/orQn1nD84gPNUHu6DQ=="
+    }
+  ]
+}

package/dist/analysis/fitness/rule-types.d.ts

@@ -1,34 +1,2 @@
-export type ComparisonOp = '<' | '<=' | '>' | '>=' | '==' | '!=';
-export interface MetricThresholdRule {
-    type?: 'metric';
-    metric: string;
-    op: ComparisonOp;
-    value: number;
-    message: string;
-}
-export interface DependencyConstraintRule {
-    type: 'no-dependency';
-    from: string;
-    to: string;
-    message: string;
-}
-export type GimLossType = 'feasibility' | 'consistency' | 'description-length' | 'generation-alignment';
-export interface GimLossRule {
-    type: 'gim-loss';
-    loss: GimLossType;
-    op: ComparisonOp;
-    value: number;
-    message: string;
-}
-export type FitnessRule = MetricThresholdRule | DependencyConstraintRule | GimLossRule;
-export interface FitnessConfig {
-    rules: FitnessRule[];
-    failOnViolation: boolean;
-}
-export interface RuleResult {
-    rule: FitnessRule;
-    passed: boolean;
-    actual?: number | string;
-    detail?: string;
-}
+export type { ComparisonOp, MetricThresholdRule, DependencyConstraintRule, GimLossType, GimLossRule, FitnessRule, FitnessConfig, RuleResult, } from '../../types/fitness-rules.js';
 //# sourceMappingURL=rule-types.d.ts.map

package/dist/analysis/fitness/rule-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule-types.d.ts","sourceRoot":"","sources":["../../../src/analysis/fitness/rule-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG,oBAAoB,GAAG,sBAAsB,CAAC;AAExG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,mBAAmB,GAAG,wBAAwB,GAAG,WAAW,CAAC;AAEvF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"rule-types.d.ts","sourceRoot":"","sources":["../../../src/analysis/fitness/rule-types.ts"],"names":[],"mappings":"AAQA,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,UAAU,GACX,MAAM,0BAA0B,CAAC"}

package/dist/cli/analyze/run-analysis.d.ts

@@ -2,11 +2,15 @@ import type { Config } from '../config-loader.js';
 import type { CLIOptions, DiagramConfig } from '../../types/config.js';
 import type { ProgressReporterLike } from '../progress/index.js';
 import type { DiagramResult } from '../processors/diagram-processor.js';
+import { type SelectParserBackendOptions } from '../../plugins/shared/parser-runtime.js';
+import { ProcessParseWorkerPools } from '../../parser/process-parse-worker-pools.js';
+export declare function loadPluginForLanguage(language: string, workspaceRoot: string, parserRuntime?: SelectParserBackendOptions): Promise<import('../../core/interfaces/language-plugin.js').ILanguagePlugin>;
 export interface RunAnalysisOptions {
     sessionRoot: string;
     workDir: string;
     cliOptions: Partial<CLIOptions>;
     reporter: ProgressReporterLike;
+    parseWorkerPools?: ProcessParseWorkerPools;
 }
 export interface RunAnalysisResult {
     config: Config;

package/dist/cli/analyze/run-analysis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-analysis.d.ts","sourceRoot":"","sources":["../../../src/cli/analyze/run-analysis.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAQjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AA8DxE,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAQD,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmSzF"}
+{"version":3,"file":"run-analysis.d.ts","sourceRoot":"","sources":["../../../src/cli/analyze/run-analysis.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAQjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAexE,OAAO,EAIL,KAAK,0BAA0B,EAChC,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAYjF,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,aAAa,GAAE,0BAA+B,GAC7C,OAAO,CAAC,OAAO,sCAAsC,EAAE,eAAe,CAAC,CAsBzE;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAQD,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsVzF"}