@yalehwang/archguard 0.1.23 → 0.1.32

package/README.md

@@ -1,6 +1,6 @@
 # ArchGuard
 
-ArchGuard analyzes source code to extract architectural insights and generates **Mermaid diagrams** at multiple levels of detail. It supports TypeScript (stable), Go (stable), Java (beta), and Python (beta) through a plugin system, and exposes query and MCP workflows for architecture inspection.
+ArchGuard analyzes source code to extract architectural insights and generates **Mermaid diagrams** at multiple levels of detail. It supports TypeScript (stable), Go (stable), Java (beta), Python (beta), C++ (beta), and Kotlin/Android (beta) through a plugin system, and exposes query and MCP workflows for architecture inspection.
 
 ## Screenshots
 
@@ -16,10 +16,11 @@ ArchGuard analyzes source code to extract architectural insights and generates *
 ## Features
 
 - **AI-Native MCP Interface**: Query architecture in natural language from Claude Code or Codex — analyze projects, trace dependencies, find implementers, detect cycles
-- **Multi-Language Support**: TypeScript, Go, Java, Python via plugin system
+- **Multi-Language Support**: TypeScript, Go, Java, Python, C++, Kotlin/Android via plugin system
 - **Multi-Level Diagrams**: Package (high-level), Class (default), Method (low-level)
 - **Go Architecture Atlas**: 4-layer visualization — package graph, capability graph, goroutine topology, flow graph
-- **Static Test Analysis**: Test coverage mapping, assertion density, orphan detection, and quality issues — no test execution required
+- **Kotlin/Android Support**: Auto-detect Kotlin projects, parse `build.gradle.kts` / `settings.gradle.kts`, and plan multi-module diagrams
+- **Static Test Analysis**: Test coverage mapping, assertion density, orphan detection, and quality issues — no test execution required, including Kotlin/Android projects
 - **Parallel Processing**: High-performance parsing with configurable concurrency
 - **Smart Caching**: File-based caching with SHA-256 hashing for fast repeated runs
 - **Zero External Dependencies**: Local Mermaid rendering using isomorphic-mermaid
@@ -37,12 +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 plugin marketplace add yaleh/archguard
+claude plugin install archguard@archguard
+```
+
+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
 claude mcp add --scope project archguard -- archguard mcp
 ```
 
+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:
+
+```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
+# 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.
@@ -77,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
 
@@ -99,7 +203,7 @@ Point archguard at any project path — no configuration file needed:
 
 > Analyze the architecture of `/home/user/work/my-project` using archguard MCP.
 
-Archguard auto-detects the language and project structure, generates diagrams under `<project>/.archguard/`, and builds the query index for follow-up queries.
+Archguard auto-detects the language and project structure, generates diagrams under `<project>/.archguard/`, and builds the query index for follow-up queries. Kotlin/Android projects are detected from `build.gradle.kts`, `settings.gradle.kts`, `.kt`, and `.kts` markers and can be analyzed without forcing `--lang kotlin`.
 
 ### Standalone CLI
 
@@ -130,7 +234,7 @@ archguard analyze [options]
 
 - `-s, --sources <paths...>` - Source directories; triggers auto-detection and multi-diagram generation
 - `--diagrams <levels...>` - Filter by level: `package` | `class` | `method` (language-dependent)
-- `--lang <language>` - Language: `typescript` | `go` | `java` | `python` (auto-detected)
+- `--lang <language>` - Language: `typescript` | `go` | `java` | `python` | `cpp` | `kotlin` (auto-detected)
 - `--config <path>` - Config file path (default: `archguard.config.json`)
 
 **Output:**
@@ -162,11 +266,6 @@ archguard analyze [options]
 - `--atlas-include-tests` - Include test packages in Atlas
 - `--atlas-protocols <protocols>` - Protocols included in flow graph
 
-**Claude CLI:**
-
-- `--cli-command <command>` - Claude CLI executable (default: `claude`)
-- `--cli-args <args>` - Additional Claude CLI arguments
-
 **Examples:**
 
 ```bash
@@ -199,6 +298,9 @@ archguard analyze --include-tests
 
 # Refresh test report only, skip re-parsing source (faster)
 archguard analyze --tests-only
+
+# Kotlin/Android project (explicit language selection is optional)
+archguard analyze -s ./app/src/main/java --lang kotlin
 ```
 
 ### `query`
@@ -248,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:**
@@ -277,7 +381,17 @@ Test analysis (requires `archguard_analyze(includeTests: true)` first):
 | `archguard_detect_test_patterns` | Detect test frameworks and return suggested pattern config — call this first |
 | `archguard_get_test_metrics` | Summary: file counts, entity coverage ratio, assertion density, issue counts |
 | `archguard_get_test_issues` | Per-file issues: `zero_assertion`, `orphan_test`, `assertion_poverty`, `skip_accumulation` |
-| `archguard_get_test_coverage` | Per-entity coverage map with confidence scores |
+| `archguard_get_entity_coverage` | Per-entity coverage map with confidence scores |
+
+Git history analysis:
+
+| Tool | Purpose |
+|------|---------|
+| `archguard_analyze_git` | Index git history for change-based queries |
+| `archguard_get_change_context` | Commits and changed files for an entity |
+| `archguard_get_cochange` | Files that frequently change together |
+| `archguard_get_change_risk` | Change risk score based on churn and coupling |
+| `archguard_get_ownership` | Author ownership breakdown per file or entity |
 
 See [MCP Usage Guide](docs/user-guide/mcp-usage.md) for setup, tool reference, and usage patterns.
 
@@ -301,12 +415,14 @@ archguard cache path    # Show cache directory
 
 ## Language Support
 
-| Language   | Status | Parser                    | Features                                           |
-|------------|--------|---------------------------|----------------------------------------------------|
-| TypeScript | Stable | ts-morph (AST)            | Classes, interfaces, enums, dependencies, path aliases |
-| Go         | Stable | tree-sitter + gopls       | Structs, interfaces, goroutines, Architecture Atlas |
-| Java       | Beta   | tree-sitter               | Classes, interfaces, Maven/Gradle deps              |
-| Python     | Beta   | tree-sitter               | Classes, functions, pip/Poetry deps                 |
+| Language       | Status | Parser                    | Features                                           |
+|----------------|--------|---------------------------|----------------------------------------------------|
+| TypeScript     | Stable | ts-morph (AST)            | Classes, interfaces, enums, dependencies, path aliases |
+| Go             | Stable | tree-sitter + gopls       | Structs, interfaces, goroutines, Architecture Atlas |
+| Java           | Beta   | tree-sitter               | Classes, interfaces, Maven/Gradle deps              |
+| Python         | Beta   | tree-sitter               | Classes, functions, pip/Poetry deps                 |
+| C++            | Beta   | tree-sitter               | Structs, classes, inheritance, CMake deps           |
+| Kotlin/Android | Beta   | tree-sitter               | Classes, interfaces, top-level functions, `build.gradle.kts` deps, `settings.gradle.kts` multi-module planning, static test analysis |
 
 ### Go Architecture Atlas
 
@@ -410,8 +526,34 @@ archguard analyze --diagrams class method
 | `cache.enabled` | boolean | `true` | Enable file-based caching |
 | `mermaid.theme` | string | `default` | Diagram theme |
 | `mermaid.transparentBackground` | boolean | `true` | Transparent PNG background |
-| `cli.command` | string | `claude` | Claude CLI executable |
-| `cli.timeout` | number | `60000` | Claude CLI timeout (ms) |
+| `projectSemantics` | object | — | Skill-authored project knowledge consumed during analysis |
+
+## Skill-Authored Project Semantics
+
+ArchGuard does not discover project semantics at runtime. Skills or users write project knowledge, and ArchGuard loads, validates, merges, and consumes it during analysis.
+
+Authoritative locations and priority:
+
+1. `archguard.config.json.projectSemantics`
+2. `.archguard/project-semantics.json`
+3. built-in defaults
+
+The sidecar file uses the same shape as `archguard.config.json.projectSemantics`.
+
+```json
+{
+  "additionalTestPatterns": ["tests/**/*.ts"],
+  "customAssertionPatterns": ["expect[A-Z]\\w+"],
+  "architecturalLayers": {
+    "src/analysis": "analysis",
+    "src/cli": "cli",
+    "src/rendering": "rendering"
+  },
+  "suggestedDepth": 2
+}
+```
+
+If either the config `projectSemantics` block or `.archguard/project-semantics.json` is malformed, ArchGuard fails fast during configuration load or analysis startup instead of silently ignoring the knowledge.
 
 ## Output Formats
 
@@ -515,7 +657,9 @@ archguard/
 │   │   ├── golang/          # Stable (tree-sitter + gopls + Atlas)
 │   │   │   └── atlas/       # package, capability, goroutine, flow builders
 │   │   ├── java/            # Beta
-│   │   └── python/          # Beta
+│   │   ├── python/          # Beta
+│   │   ├── cpp/             # Beta (tree-sitter + CMake)
+│   │   └── kotlin/          # Beta (tree-sitter + build.gradle.kts)
 │   └── types/               # Core types (config, ArchJSON, extensions)
 ├── tests/
 │   ├── unit/                # Unit tests
@@ -594,11 +738,11 @@ npm run build
 # Analyze ArchGuard itself
 node dist/cli/index.js analyze -v
 
-# Package-level overview
-node dist/cli/index.js analyze -l package -n overview
+# Package-level overview only
+node dist/cli/index.js analyze --diagrams package
 
 # Method-level detail for a module
-node dist/cli/index.js analyze -s ./src/cli -l method -n cli-module
+node dist/cli/index.js analyze -s ./src/cli --diagrams method
 ```
 
 ## Technology Stack

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/atlas-metrics-analysis.d.ts

@@ -0,0 +1,11 @@
+import type { PackageGraph, PackageNode } from '../types/extensions/go-atlas.js';
+export interface EnrichedPackageNode extends PackageNode {
+    fanIn: number;
+    fanOut: number;
+}
+export declare function computePackageFanMetrics(graph: PackageGraph): {
+    fanIn: Map<string, number>;
+    fanOut: Map<string, number>;
+};
+export declare function enrichPackageNodes(nodes: PackageNode[], fanIn: Map<string, number>, fanOut: Map<string, number>): EnrichedPackageNode[];
+//# sourceMappingURL=atlas-metrics-analysis.d.ts.map