@magic5644/graph-it-live 1.11.0 → 1.12.0

package/docs/CLI.md

@@ -19,6 +19,8 @@ The `graph-it` CLI gives you full access to the dependency analysis engine of Gr
   - [check](#check)
   - [trace](#trace)
   - [query](#query)
+  - [stats](#stats)
+  - [wiki](#wiki)
   - [tool](#tool)
   - [serve](#serve)
   - [install](#install)
@@ -661,6 +663,68 @@ graph-it query "what is the entry point for the CLI" --format json
 
 ---
 
+### stats
+
+Report session-level token metrics with strict separation between:
+- **estimated JSON vs TOON encoding sizes** (chars/4 heuristic), and
+- **real provider-reported LLM usage** (`llmUsage`).
+
+```
+graph-it stats [options]
+```
+
+**Options:**
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--workspace, -w` | auto-detected | Project root |
+| `--stats-dir <dir>` | `~/.graph-it/stats` | Override persisted stats directory |
+| `--format, -f` | `text` | Output format (`text`, `json`, `markdown`) |
+
+**What it reports:**
+- current process session (`byTool`, totals, `llmUsage`)
+- persisted history (`bySource`, `byTool`)
+- required wording that `llmUsage` is never summed into estimated encoding totals
+
+**Local zero-LLM proof workflow:**
+
+```bash
+# Runs architecture, codemap, impact, and call-graph analyses twice (JSON + TOON).
+# ANTHROPIC_API_KEY and OPENAI_API_KEY are removed from child processes.
+# Raw outputs and report.json are written under .reports/context-economy/.
+npm run test:context-economy
+```
+
+The generated `report.json` stores, for every corpus operation:
+
+- `llmUsage.calls = 0` and `llmUsage.tokensUsed = 0`;
+- raw JSON and TOON output paths;
+- UTF-8 bytes, characters, and `estimateTokenSavings()` values;
+- persisted CLI session snapshots, which also must show zero provider usage.
+
+The `chars / 4` values are **encoding estimates**, not provider billing tokens or a
+claim that an LLM was called. Local graph traversal performs no LLM request. The
+optional `query` command may use an LLM only to extract keywords; without a
+provider key it uses the deterministic heuristic fallback. MCP response synthesis
+belongs to the calling AI client, not to Graph-It-Live's local analyzers.
+
+**TOON secondary benchmark workflow:**
+
+```bash
+# Primary + secondary payload benchmarks for session-stats TOON encoding
+npx vitest bench tests/benchmarks/sessionStatsToon.bench.ts
+```
+
+**Examples:**
+
+```bash
+graph-it stats
+graph-it stats --format json
+graph-it stats --stats-dir /tmp/graph-it-stats --format markdown
+```
+
+---
+
 ### wiki
 
 Generate a navigable markdown wiki from the call graph. Creates one article per source file with hub scores, symbol lists, caller/callee cross-links, and a grouped index — all with relative links only (portable, can be committed to the repo).

package/package.json

@@ -2,7 +2,7 @@
   "name": "@magic5644/graph-it-live",
   "displayName": "Graph-It-Live",
   "description": "AI-first dependency graph & code intelligence for VS Code. Visualize file imports, symbol call hierarchies, and cross-file call graphs. Detect circular dependencies, dead code, and breaking changes. Built-in MCP Server with 21 tools for GitHub Copilot, Cursor, Claude, Windsurf, and Antigravity. Generate AI-friendly codemaps. TypeScript, JavaScript, C#, Go, Java, Python, Rust, Vue, Svelte, GraphQL.",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "publisher": "magic5644",
   "author": {
     "name": "magic56"
@@ -1116,6 +1116,7 @@
     "test:all": "npm run test:unit",
     "test:bench": "node scripts/run-benchmarks.mjs",
     "test:bench:memory": "node scripts/run-memory-bench.mjs",
+    "test:context-economy": "npm run build:cli && node scripts/context-economy-corpus.mjs",
     "test:mcp": "node scripts/test-mcp.js",
     "test:cli:e2e": "bash scripts/test-cli-e2e.sh",
     "lint": "eslint src",
@@ -1137,7 +1138,7 @@
     "chokidar": "^5.0.0",
     "cytoscape": "^3.34.0",
     "cytoscape-fcose": "^2.2.0",
-    "ink": "^7.1.0",
+    "ink": "^7.1.1",
     "react": "^19.2.7",
     "react-devtools-core": "^6.1.5",
     "react-dom": "^19.2.7",
@@ -1146,33 +1147,33 @@
     "tree-sitter-wasms": "^0.1.13",
     "ts-morph": "^27.0.2",
     "vis-network": "10.1.0",
-    "web-tree-sitter": "^0.26.10",
+    "web-tree-sitter": "^0.26.11",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@testing-library/react": "^16.3.2",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^25.9.4",
+    "@types/node": "^25.9.5",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "@types/sql.js": "^1.4.11",
     "@types/vscode": "^1.96.0",
-    "@vitest/coverage-v8": "^4.1.9",
-    "@vitest/ui": "^4.1.9",
+    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/ui": "^4.1.10",
     "@vscode/test-electron": "^2.5.2",
     "@vscode/vsce": "^3.9.2",
     "esbuild": "^0.28.1",
     "esbuild-css-modules-plugin": "^3.1.5",
-    "eslint": "^10.6.0",
-    "fast-check": "^4.8.0",
+    "eslint": "^10.7.0",
+    "fast-check": "^4.9.0",
     "glob": "^13.0.6",
     "globals": "^17.7.0",
     "happy-dom": "^20.10.6",
     "mocha": "^11.7.6",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.62.1",
-    "vitest": "^4.1.9"
+    "typescript-eslint": "^8.64.0",
+    "vitest": "^4.1.10"
   },
   "overrides": {
     "picomatch": "^4.0.4",