@magic5644/graph-it-live 1.0.0 → 1.0.2

package/README.md

@@ -9,13 +9,14 @@
 
 </div>
 
-[![Version](https://img.shields.io/visual-studio-marketplace/v/magic5644.graph-it-live?label=VS%20Code%20Marketplace&logo=visual-studio-code)](https://marketplace.visualstudio.com/items?itemName=magic5644.graph-it-live)
+[![Version](https://vsmarketplacebadges.dev/version/magic5644.graph-it-live.svg)](https://marketplace.visualstudio.com/items?itemName=magic5644.graph-it-live)
+[![vscode installs](https://vsmarketplacebadges.dev/installs-short/magic5644.graph-it-live.svg?label=vscode+installs)](https://marketplace.visualstudio.com/items?itemName=magic5644.graph-it-live)
 [![Open VSX Version](https://img.shields.io/open-vsx/v/magic5644/graph-it-live?label=Open%20VSX&logo=eclipse&logoColor=white)](https://open-vsx.org/extension/magic5644/graph-it-live)
+[![Open VSX Downloads](https://img.shields.io/open-vsx/dt/magic5644/graph-it-live?label=Open%20VSX%20Downloads)](https://open-vsx.org/extension/magic5644/graph-it-live)
+[![npm](https://img.shields.io/npm/v/%40magic5644%2Fgraph-it-live?label=npm%20CLI&logo=npm&logoColor=white)](https://www.npmjs.com/package/@magic5644/graph-it-live)
 [![AI Ready](https://img.shields.io/badge/AI%20Ready-MCP%20Server-blue?logo=modelcontextprotocol&logoColor=white)](https://modelcontextprotocol.io)
 [![License](https://img.shields.io/github/license/magic5644/Graph-It-Live)](https://github.com/magic5644/Graph-It-Live/blob/main/LICENSE)
 [![Github stars](https://img.shields.io/github/stars/magic5644/graph-it-live?style=flat&color=gold&logo=github)](https://github.com/magic5644/Graph-It-Live)
-[![vscode downloads](https://img.shields.io/visual-studio-marketplace/d/magic5644.graph-it-live?label=vscode%20Marketplace%20Downloads)](https://marketplace.visualstudio.com/items?itemName=magic5644.graph-it-live)
-[![Open VSX Downloads](https://img.shields.io/open-vsx/dt/magic5644/graph-it-live?label=Open%20VSX%20Downloads)](https://open-vsx.org/extension/magic5644/graph-it-live)
 
 ---
 
@@ -51,18 +52,49 @@ All three layers are also exposed to AI via a **20-tool MCP server**, so your as
 
 ## Table of Contents
 
-- [For AI — MCP Server](#-supercharge-your-ai-assistant)
-  - [Codemap Generation](#-codemap-generation-new)
-  - [All 21 MCP Tools](#available-tools)
-  - [TOON Format (Token Savings)](#toon-format-token-optimized-output)
-- [For Humans — Visual Features](#-features-for-humans)
+- [Why Graph-It-Live?](#why-graph-it-live)
+- [Table of Contents](#table-of-contents)
+- [🤖 Supercharge Your AI Assistant](#-supercharge-your-ai-assistant)
+  - [What your AI can do with Graph-It-Live](#what-your-ai-can-do-with-graph-it-live)
+  - [🗺️ Codemap Generation *(New)*](#️-codemap-generation-new)
+  - [📊 File Logic Analysis *(New)*](#-file-logic-analysis-new)
+- [👁️ Features for Humans](#️-features-for-humans)
   - [File Dependency Graph](#file-dependency-graph)
   - [Symbol-Level Drill-Down](#symbol-level-drill-down)
-  - [Live Call Graph](#-live-call-graph-new)
+  - [🔷 Live Call Graph *(New)*](#-live-call-graph-new)
   - [Unused Dependency Filter](#unused-dependency-filter)
-- [Installation & Usage](#installation)
+- [Prerequisites](#prerequisites)
+- [Installation](#installation)
+  - [From Marketplace](#from-marketplace)
+  - [From Open VSX Registry](#from-open-vsx-registry)
+- [Usage](#usage)
 - [Configuration](#configuration)
+  - [Performance Profiles](#performance-profiles)
+  - [All Settings](#all-settings)
+- [Standalone CLI](#standalone-cli)
+- [MCP Server (AI/LLM Integration)](#mcp-server-aillm-integration)
+  - [Setup](#setup)
+  - [Available Tools](#available-tools)
+  - [TOON Format (Token-Optimized Output)](#toon-format-token-optimized-output)
+  - [Native LM Tools (Copilot Agent Mode)](#native-lm-tools-copilot-agent-mode)
+  - [Manual MCP Server Configuration](#manual-mcp-server-configuration)
+    - [VS Code / VS Code Insiders](#vs-code--vs-code-insiders)
+    - [Cursor](#cursor)
+    - [Claude Desktop](#claude-desktop)
+    - [Development / Local Testing](#development--local-testing)
+    - [Windsurf](#windsurf)
+    - [Antigravity](#antigravity)
 - [Development](#development)
+  - [Quick Start](#quick-start)
+  - [Project Structure](#project-structure)
+  - [Build \& Test Commands](#build--test-commands)
+- [WASM Architecture](#wasm-architecture)
+  - [Architecture](#architecture)
+  - [Testing](#testing)
+  - [Troubleshooting](#troubleshooting)
+- [License](#license)
+- [Acknowledgements](#acknowledgements)
+- [Author](#author)
 
 ---
 
@@ -155,7 +187,7 @@ Entry points: initializeServer(), main()
 
 The core of Graph-It-Live: a **real-time interactive graph** showing file-to-file import relationships across your project.
 
-- **Multi-language:** TypeScript, JavaScript, Python, Rust, Vue, Svelte, GraphQL
+- **Multi-language:** TypeScript, JavaScript, Python, Rust, C#, Go, Java, Vue, Svelte, GraphQL
 - **Cycle detection:** Circular dependencies highlighted with red dashed lines and badges
 - **Smart navigation:** Click any node to open the file; expand/collapse dependencies dynamically
 - **Reverse lookup:** Right-click → "Find Referencing Files" for instant reverse dependency discovery
@@ -183,11 +215,13 @@ Go beyond file dependencies — **drill into any file to visualize function-to-f
 3. **Click-to-navigate:** Click any symbol to jump to its definition
 4. **Breadcrumb nav:** `Project > folder > file.ts` — one click to return to file view
 
-**Multi-language support:**
+**Multi-language support (symbol drill-down):**
 - TypeScript / JavaScript (ts-morph AST)
 - Python (tree-sitter WASM)
 - Rust (tree-sitter WASM)
 
+> **Note:** C#, Go, and Java are supported at the **file dependency graph level** (L1). Symbol drill-down is not yet available for these languages.
+
 **Benefits:**
 - **Understand code flow** without reading every line
 - **See who calls your exports** — incoming dependencies from other files
@@ -272,7 +306,7 @@ Also available on the [Open VSX Registry](https://open-vsx.org/extension/magic56
 
 ## Usage
 
-1. **Open a Project** — TypeScript, JavaScript, Python, Rust, Vue, Svelte, or GraphQL
+1. **Open a Project** — TypeScript, JavaScript, Python, Rust, C#, Go, Java, Vue, Svelte, or GraphQL
 2. **Open the Graph** — Click the Graph-It-Live icon in the Activity Bar, or run `Graph-It-Live: Show Dependency Graph`
 3. **Interact:**
    - **Click** a node → open the file
@@ -355,9 +389,10 @@ graph-it trace src/index.ts#main        # Trace execution flow
 graph-it explain src/utils.ts           # File logic analysis
 graph-it path src/index.ts              # Dependency graph from file
 graph-it check src/api.ts               # Unused exported symbols
-graph-it serve                          # Launch MCP stdio server
-graph-it tool --list                    # List all 20 MCP tools
+graph-it serve                          # Launch MCP stdio server (for AI clients)
+graph-it tool --list                    # List all 21 MCP tools
 graph-it tool analyze_dependencies --filePath=/abs/path/file.ts
+graph-it update                         # Update graph-it to the latest version
 ```
 
 **Without installing globally:**
@@ -367,6 +402,28 @@ npx @magic5644/graph-it-live scan
 npx @magic5644/graph-it-live serve
 ```
 
+**Output formats:** All analysis commands support `--format json|toon|markdown`. Use `toon` for AI consumption (30–60% token savings). The `trace` and `path` commands additionally support `--format mermaid` to generate a Mermaid diagram of the call or dependency flow:
+
+```bash
+graph-it summary src/api.ts --format toon
+graph-it path src/index.ts --format markdown
+graph-it path src/index.ts --format mermaid    # → Mermaid flowchart of dependency graph
+graph-it trace src/index.ts#main --format mermaid  # → Mermaid sequence/flowchart of execution trace
+```
+
+Example `--format mermaid` output for `graph-it path src/index.ts`:
+
+```mermaid
+graph LR
+  src/index.ts --> src/app.ts
+  src/app.ts --> src/router.ts
+  src/app.ts --> src/db.ts
+```
+
+This output can be pasted directly into any Markdown renderer (GitHub, Notion, VS Code Preview, etc.) or piped to a diagramming tool.
+
+**Use as MCP server (no VS Code):** Run `graph-it serve` and point your AI client at it — see [Manual MCP Server Configuration](#manual-mcp-server-configuration).
+
 ---
 
 ## MCP Server (AI/LLM Integration)
@@ -375,10 +432,18 @@ Graph-It-Live includes an optional **MCP server** that exposes its full analysis
 
 ### Setup
 
+**Option A — VS Code extension:**
+
 1. Set `graph-it-live.enableMcpServer` to `true` in VS Code settings
 2. The server starts automatically when the extension activates
 3. Your AI assistant detects the tools via MCP auto-discovery
 
+**Option B — Standalone CLI (no VS Code required):**
+
+1. Install: `npm install -g @magic5644/graph-it-live`
+2. Run `graph-it serve` — starts an MCP stdio server pointing at your current directory
+3. Configure your AI client to invoke `graph-it serve` as the MCP server command (see [Manual MCP Server Configuration](#manual-mcp-server-configuration))
+
 <div align="center">
   <img src="media/enable-mcp-server-tools.gif" alt="Enable MCP Server in VS Code Settings" width="800"/>
 </div>
@@ -431,7 +496,7 @@ All tools support an optional `format` parameter to reduce token consumption:
 | `toon` | Compact Token-Oriented Object Notation | 30-60% |
 | `markdown` | JSON wrapped in markdown code blocks | — |
 
-See [TOON Format Documentation](./docs/TOON_FORMAT.md) for full specifications.
+See [TOON Format Documentation](./docs/architecture/TOON_FORMAT.md) for full specifications.
 
 ### Native LM Tools (Copilot Agent Mode)
 
@@ -608,7 +673,11 @@ Create or edit `.antigravity/mcp.json` in your workspace or configure globally:
 For comprehensive development instructions, see:
 
 - **[DEVELOPMENT.md](DEVELOPMENT.md)** — Setup, build, testing, WASM architecture
-- **[CONTRIBUTING.md](CONTRIBUTING.md)** — Contribution guidelines and workflow
+- **[CONTRIBUTING.md](CONTRIBUTING.md)** — Contribution guidelines, branch naming, commit conventions
+- **[docs/development/CODING_STANDARDS.md](docs/development/CODING_STANDARDS.md)** — TypeScript conventions and code style rules
+- **[docs/development/CROSS_PLATFORM_TESTING.md](docs/development/CROSS_PLATFORM_TESTING.md)** — Cross-platform compatibility requirements (Windows/Linux/macOS)
+- **[docs/architecture/TOON_FORMAT.md](docs/architecture/TOON_FORMAT.md)** — Token-Optimized Output format specification for AI tools
+- **[docs/architecture/PERFORMANCE_OPTIMIZATIONS.md](docs/architecture/PERFORMANCE_OPTIMIZATIONS.md)** — Performance tuning and caching strategies
 
 ### Quick Start
 
@@ -646,8 +715,10 @@ Graph-It-Live/
 | Command | Description |
 |---------|-------------|
 | `npm run build` | Bundle via esbuild + copy WASM files |
+| `npm run build:cli` | Build standalone CLI only (`dist/graph-it.js`) |
 | `npm run watch` | Rebuild on change |
 | `npm test` | Run unit tests (Vitest, mocked parsers) |
+| `npm run test:cli` | Run CLI unit tests |
 | `npm run test:vscode` | E2E tests from source with real WASM |
 | `npm run test:vscode:vsix` | E2E tests from .vsix (pre-release) |
 | `npm run lint` | Lint TypeScript (ESLint) |