@magic5644/graph-it-live 1.9.1 → 1.9.3

package/docs/CLI.md

@@ -11,6 +11,7 @@ The `graph-it` CLI gives you full access to the dependency analysis engine of Gr
 - [Global Options](#global-options)
 - [Output Formats](#output-formats)
 - [Commands](#commands)
+  - [graph-it (no arguments)](#graph-it-no-arguments)
   - [scan](#scan)
   - [summary](#summary)
   - [explain](#explain)
@@ -146,6 +147,76 @@ graph-it summary --format toon                    # → feed to an LLM
 
 ## Commands
 
+### graph-it (no arguments)
+
+Launches interactive mode when invoked without a command in a TTY session.
+
+```
+graph-it [options]
+```
+
+**Behavior:**
+
+- If `stdin` is a TTY, starts the interactive REPL.
+- If `stdin` is not a TTY, interactive mode is not started. Use direct commands such as `graph-it summary`, `graph-it trace`, or `graph-it check`.
+- REPL session default output format is `text` unless changed with `/format`.
+
+#### REPL slash commands
+
+| Command | Description |
+|--------|-------------|
+| `/trace` | Run trace flow for a selected file and optional symbol |
+| `/path` | Set session workspace scope (directory) |
+| `/file` | Set active file context for context-aware commands |
+| `/check-dependencies` | Check incoming and outgoing dependencies |
+| `/cycles` | List confirmed dependency cycles for a file |
+| `/summary` | Summarize current file context or workspace |
+| `/architecture` | Build workspace architecture graph |
+| `/check` | Find unused exports |
+| `/format` | Set preferred output format for the session |
+| `/command` | Run a raw CLI command line inside REPL |
+| `/help` | Show REPL command help |
+| `/quit` | Exit interactive mode |
+
+#### Post-result actions
+
+After each result, the REPL supports contextual actions:
+
+- drill-down into current file/symbol context
+- export current structured result in another format
+- save current output to file
+- set default session format
+- run context-aware follow-up actions (for example dependency, cycle, trace, dead-code, or architecture follow-ups)
+
+#### Session state
+
+REPL session state is in-memory for the current invocation and tracks:
+
+- `workspaceRoot`
+- `lastFile`
+- `lastSymbol`
+- `lastResult`
+- `lastCommandLine`
+- `preferredFormat`
+- `recentFiles` (max 5, newest first)
+- `tipCounter`
+
+#### Tips
+
+The REPL tip system includes:
+
+- general rotating tips
+- command-step tips (for example trace/check-dependencies/cycles/result steps)
+- persona-tagged tips (role-oriented hints)
+
+#### Save path safety
+
+When saving from REPL:
+
+- writes are restricted to paths inside the workspace root
+- path checks are enforced using resolved/real paths
+- symlink targets are refused for overwrite
+
 ### scan
 
 Index (or re-index) the workspace. Must be run before other analysis commands on first use; subsequent commands index automatically if needed.

package/docs/README.md

@@ -1,6 +1,6 @@
 # Graph-It-Live Documentation
 
-**Last Updated:** 2026-04-12
+**Last Updated:** 2026-05-09
 
 This directory is the single source of truth for technical documentation. It is organized into three sections.
 
@@ -13,6 +13,7 @@ Documentation describing how the system is built and how the layers interact.
 | File | Description |
 |------|-------------|
 | [architecture/codemaps/architecture.md](architecture/codemaps/architecture.md) | System overview — layers, services, file count |
+| [architecture/codemaps/class-hierarchy.md](architecture/codemaps/class-hierarchy.md) | **Class hierarchy diagram** — core interfaces, 45+ classes, design patterns |
 | [architecture/codemaps/backend.md](architecture/codemaps/backend.md) | Analyzer, MCP, and extension services |
 | [architecture/codemaps/cli.md](architecture/codemaps/cli.md) | Standalone CLI layer (`graph-it`) |
 | [architecture/codemaps/frontend.md](architecture/codemaps/frontend.md) | Webview / React components |
@@ -22,6 +23,8 @@ Documentation describing how the system is built and how the layers interact.
 | [architecture/MCP_DEBUG_LOGGING_SECURITY.md](architecture/MCP_DEBUG_LOGGING_SECURITY.md) | MCP debug logging — opt-in, rotation, privacy |
 | [architecture/PERFORMANCE_OPTIMIZATIONS.md](architecture/PERFORMANCE_OPTIMIZATIONS.md) | Performance patterns: batch processing, concurrency, caching |
 | [architecture/graph-it-live-architecture.svg](architecture/graph-it-live-architecture.svg) | Architecture diagram (SVG) |
+| [architecture/graph-it-live-architecture-diagram.html](architecture/graph-it-live-architecture-diagram.html) | Architecture diagram (interactive HTML) |
+| [architecture/graph-it-live-runtime-flows-diagram.html](architecture/graph-it-live-runtime-flows-diagram.html) | Runtime flows diagram — extension ↔ analyzer ↔ MCP ↔ CLI |
 
 ---
 
@@ -31,7 +34,7 @@ Standards and guidelines for contributors.
 
 | File | Description |
 |------|-------------|
-| [CLI.md](CLI.md) | **CLI reference** — all commands, options, output formats, tools, and advanced workflows |
+| [CLI.md](CLI.md) | **CLI + interactive REPL reference** — commands, options, output formats, tools, and interactive workflows |
 | [development/CODING_STANDARDS.md](development/CODING_STANDARDS.md) | TypeScript conventions, layer rules, React patterns |
 | [development/CROSS_PLATFORM_TESTING.md](development/CROSS_PLATFORM_TESTING.md) | Cross-platform path handling and test guidelines |
 | [development/ADR-001-package-manager-choice.md](development/ADR-001-package-manager-choice.md) | ADR: npm vs Yarn decision |

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.9.1",
+  "version": "1.9.3",
   "publisher": "magic5644",
   "author": {
     "name": "magic56"
@@ -1104,7 +1104,8 @@
     "test:cli:e2e": "bash scripts/test-cli-e2e.sh",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",
-    "check:types": "tsc --noEmit",
+    "check:types": "npm run check:types:clean",
+    "check:types:clean": "node -e \"require('node:fs').rmSync('out', { recursive: true, force: true });\" && tsc --noEmit",
     "audit": "npm audit",
     "audit:fix": "npm audit fix",
     "package": "vsce package",
@@ -1114,18 +1115,20 @@
   },
   "dependencies": {
     "@dagrejs/dagre": "^2.0.4",
+    "@inquirer/core": "^11.1.10",
+    "@inquirer/prompts": "^8.4.3",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "chokidar": "^5.0.0",
-    "cytoscape": "^3.33.2",
+    "cytoscape": "^3.33.3",
     "cytoscape-fcose": "^2.2.0",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
     "reactflow": "^11.11.4",
     "sql.js": "^1.14.1",
     "tree-sitter-wasms": "^0.1.13",
     "ts-morph": "^27.0.2",
     "web-tree-sitter": "^0.26.8",
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
@@ -1141,13 +1144,13 @@
     "@vscode/vsce": "^3.9.1",
     "esbuild": "^0.27.7",
     "esbuild-css-modules-plugin": "^3.1.5",
-    "eslint": "^10.2.1",
+    "eslint": "^10.3.0",
     "fast-check": "^4.7.0",
     "glob": "^13.0.6",
-    "globals": "^17.5.0",
+    "globals": "^17.6.0",
     "mocha": "^11.7.5",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.0",
+    "typescript-eslint": "^8.59.2",
     "vitest": "^4.1.5"
   },
   "overrides": {