vibe-splain 3.4.2 → 3.5.0

package/README.md

@@ -72,7 +72,7 @@ Your agent will loop through the high-gravity files, analyze each one, and build
 
 ### Three Levels of Analysis
 1. **Level 0 — Semantic Classification**: Maps files to architectural "pillars" (Auth, Payments, Database, etc.) using import-path heuristics and library signatures.
-2. **Level 1 — Structural and Behavioral Gravity**: Core computes `staticGravity` using Tree-Sitter AST analysis based on link density, nesting depth, and mutation counts. **Bundled Adapters** (like Cal.com and n8n) interpret product semantics to add `behavioralLift` for critical dynamic execution paths. Final `gravity` is the combination of static evidence and adapter interpretation.
+2. **Level 1 — Structural Gravity**: Computes `gravity` (0–100) using Tree-Sitter AST analysis — PageRank centrality, fan-in, cyclomatic complexity, public surface, and nesting depth. High-gravity files are the load-bearing hubs of the codebase. (An optional domain-adapter extension point exists for projects that want to add product-specific `behavioralLift`, but no adapters ship with the core — every scan is pure static analysis.)
 3. **Level 2 — Behavioral Traceability**: Tree-Sitter powered call-graph analysis. It maps function-level dependencies and identifies **Critical Functions** (entrypoints, semantic actions, or high-outbound callers).
 
 ### Claude Code PreToolUse Hook
@@ -86,7 +86,7 @@ Your agent will loop through the high-gravity files, analyze each one, and build
 
 ## MCP Tools
 
-vibe-splain exposes **8 tools** over MCP stdio:
+vibe-splain exposes these core dossier tools over MCP stdio:
 
 | Tool | Purpose |
 |------|---------|
@@ -141,14 +141,14 @@ The UI features:
 
 ```
 packages/
-├── brain/           # @vibe-splain/brain — repo-agnostic analysis core + bundled adapters
+├── brain/           # @vibe-splain/brain — repo-agnostic static analysis core
 │   └── src/
 │       ├── pipeline/
-│       │   └── adapters/ # Bundled product adapters (Cal.com, n8n)
+│       │   └── adapters/ # Optional domain-adapter extension point (none bundled)
 │       ├── scanner.ts    # Tree-Sitter AST analysis (static analysis, graph building)
 │       ├── dossier.ts    # Atomic persistence + UI regeneration
 │       ├── graph.ts      # Import graph read/write
-│       └── watcher.ts    # Chokidar file watcher
+│       └── network/      # Deterministic PreToolUse gate (escalation + gate index)
 ├── cli/             # vibe-splain — MCP server + CLI
 │   └── src/
 │       ├── index.ts          # #!/usr/bin/env node entry