codemap-ai 3.4.0 → 3.6.0

package/README.md

@@ -8,11 +8,38 @@ Stop guessing what breaks when you change code. CodeMap builds a complete call g
 
 - 🔍 **Call Graph Analysis** - Trace every function call across your entire codebase
 - 🎯 **Impact Analysis** - Know exactly what breaks before you change code
-- 🔗 **Cross-File Resolution** - Follows imports and tracks dependencies
+- 🔄 **Data Flow Analysis** - Track property accesses and detect breaking data shape changes (NEW in v3.5)
+- 🔗 **Cross-File Resolution** - Follows imports and tracks dependencies (90%+ accuracy)
 - 🚀 **FastAPI Support** - Detects HTTP endpoints and dependency injection
 - 💾 **Incremental Updates** - Only re-indexes changed files (git-aware)
 - 🤖 **Claude Code Integration** - MCP server for AI-powered code queries
 
+### New in v3.5.0: Data Flow Analysis
+
+CodeMap now tracks **property accesses** and **return shapes** to detect breaking changes:
+
+```python
+# Developer changes this:
+def get_user():
+    return {"id": 1, "name": "John", "email": "john@example.com"}
+
+# To this:
+def get_user():
+    return {"id": 1, "name": "John"}  # email removed!
+
+# CodeMap detects:
+# 🔴 CRITICAL: email accessed but no longer returned:
+#    • send_welcome_email() - line 78
+#    • validate_user_data() - line 120
+#    Impact: 15 functions will break
+```
+
+**Phase 3 captures:**
+- 6,976+ property accesses (`user.email`, `config.database.host`)
+- 890+ return shapes (object structures)
+- Breaking change detection (removed properties, type changes)
+- Severity scoring (CRITICAL for id/email/token/auth)
+
 ## Installation
 
 ```bash
@@ -122,6 +149,37 @@ Risk Assessment:
 
 ---
 
+### `codemap visualize` - Interactive Impact Visualization ✨ NEW
+
+Visualize impact analysis in an interactive web interface:
+
+```bash
+npx codemap-ai visualize
+```
+
+**What it does:**
+1. Analyzes impact of your changes
+2. Starts a local web server (port 37421)
+3. Opens browser with interactive graph visualization
+4. Shows call chains, severity levels, and affected functions
+
+**Features:**
+- 🎨 Color-coded severity (Red=CRITICAL, Orange=HIGH, Yellow=MEDIUM, Green=LOW)
+- 🔍 Zoom, pan, and explore the call graph
+- 💎 Changed functions highlighted
+- 📊 Impact statistics sidebar
+- 📝 Detailed function information on click
+
+**Perfect for:**
+- Understanding complex impact chains
+- PR reviews and demos
+- Identifying critical paths
+- Sharing impact visualizations with team
+
+See [Visualization Guide](./docs/VISUALIZATION.md) for details.
+
+---
+
 ### `codemap reindex` - Force Full Rebuild
 
 Force re-index everything from scratch: