fix(changelog): add v6.10.6 release notes

AGENTS.md

@@ -61,7 +61,7 @@ Always run `sigmap ask` or `sigmap --query` before searching for files relevant
 src/extractors/python_ast.py ← ast
 ```
 
-## changes (last 5 commits — 11 minutes ago)
+## changes (last 5 commits — 9 minutes ago)
 ```
 src/analysis/diagnostics.js                   +estimateTokens  +formatFileDecision  +computeFileMetrics  +explainInclusion
 src/map/import-graph.js                       +buildReverseGraph  ~extractImports  ~resolveJsPath  ~detectCycles
@@ -605,6 +605,15 @@ function formatAnalysisTable(stats, showSlow) → string
 function formatAnalysisJSON(stats) → object
 ```
 
+### src/mcp/server.js
+```
+module.exports = { start }
+function respond(id, result)
+function respondError(id, code, message)
+function dispatch(msg, cwd)
+function start(cwd)
+```
+
 ### src/analysis/diagnostics.js
 ```
 module.exports = { formatFileDecision, computeFileMetrics, explainInclusion, explainExclusion, estimateTokens }
@@ -624,12 +633,3 @@ function detectCycles(graph)
 function buildReverseGraph(graph)
 function analyze(files, cwd)
 ```
-
-### src/mcp/server.js
-```
-module.exports = { start }
-function respond(id, result)
-function respondError(id, code, message)
-function dispatch(msg, cwd)
-function start(cwd)
-```

CHANGELOG.md

@@ -10,6 +10,20 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [6.10.6] — 2026-05-11
+
+### Added
+
+- **Python absolute import detection** — Detects `from package.module import X` patterns in Python files, fixing empty import graphs for monorepos. Handles nested imports like `from services.auth.oauth import get_token` correctly (closes #181).
+- **Comprehensive import graph diagnostics** — New `sigmap-diagnostics.js` tool and `src/analysis/diagnostics.js` module provide per-file metrics and budget decision explanations. Helps debug why files are included/excluded and why import graphs may be empty (closes #182).
+- **Regression tests for MCP tools** — Added 8 comprehensive tests covering simple projects, monorepos, circular imports, and Python absolute imports. All tests passing to prevent regressions in `explain_file`, `get_impact`, and related tools.
+
+### Fixed
+
+- **Import graph edge resolution** — Improved `resolveJsPath` to handle additional extensions (.mjs, .cjs, .tsx) and better fileSet path handling. Import graph now correctly detects cross-file dependencies in complex project structures.
+
+---
+
 ## [6.10.5] — 2026-05-11
 
 ### Added

docs-vp/guide/benchmark.md

@@ -1,13 +1,13 @@
 ---
 title: Benchmark overview
-description: Official v6.10.5 benchmark snapshot. 96.8% average token reduction, 80.0% retrieval hit@5, 41.0% fewer prompts, and 13/18 raw repos overflowing GPT-4o without SigMap.
+description: Official v6.10.6 benchmark snapshot. 96.8% average token reduction, 80.0% retrieval hit@5, 41.0% fewer prompts, and 13/18 raw repos overflowing GPT-4o without SigMap.
 head:
   - - meta
     - property: og:title
       content: "SigMap benchmark overview — v6.10.1 snapshot"
   - - meta
     - property: og:description
-      content: "One place for token, retrieval, quality, and task metrics from the latest saved v6.10.1 benchmark run."
+      content: "One place for token, retrieval, quality, and task metrics from the latest saved v6.10.6 benchmark run."
   - - meta
     - property: og:url
       content: "https://manojmallick.github.io/sigmap/guide/benchmark"

docs-vp/guide/roadmap.md

@@ -1,6 +1,6 @@
 ---
 title: Roadmap
-description: SigMap version history and roadmap. From v0.0 to v6.10.5, with the latest releases fixing MCP tools extractImports export, restoring contributor attribution, and establishing develop-first branching strategy.
+description: SigMap version history and roadmap. From v0.0 to v6.10.6, with the latest releases implementing Python import detection, adding comprehensive diagnostics, and establishing develop-first branching strategy.
 head:
   - - meta
     - property: og:title
@@ -718,7 +718,7 @@ Fixed critical bug in bundled gen-context.js where `extractImports` function was
 
 ---
 
-### v6.10.5 — Import graph improvements + branching strategy ✓ (tagged v6.10.5 — 2026-05-11)
+### v6.10.6 — Import graph improvements + branching strategy ✓ (tagged v6.10.6 — 2026-05-11)
 
 Fixed import graph analysis for Python monorepos (issues #181, #182): added detection of absolute Python imports (`from package.module import X`), improved edge case handling, and added `sigmap-diagnostics.js` for debugging import detection. Also established branching strategy with develop as integration branch and main as release-only. Includes 8 regression tests for MCP tools and comprehensive testing guide.
 

docs-vp/index.md

@@ -78,9 +78,9 @@ features:
 
 <div style="max-width:840px;margin:0 auto;padding:18px 24px 0;text-align:center">
 <div style="display:inline-flex;flex-wrap:wrap;gap:.5rem;justify-content:center;background:var(--vp-c-brand-soft,#ede9fe);border:1px solid rgba(124,106,247,.25);border-radius:999px;padding:.55rem .9rem;font-size:.9rem;color:var(--vp-c-text-1)">
-  <span><strong>Release:</strong> v6.10.5</span>
+  <span><strong>Release:</strong> v6.10.6</span>
   <span>·</span>
-  <span>Develop-first branching strategy + regression tests</span>
+  <span>Python import detection + diagnostics tool</span>
 </div>
 <div style="margin-top:.4rem;display:inline-flex;flex-wrap:wrap;gap:.5rem;justify-content:center;background:var(--vp-c-default-soft,#f3f4f6);border:1px solid rgba(0,0,0,.08);border-radius:999px;padding:.55rem .9rem;font-size:.9rem;color:var(--vp-c-text-2)">
   <span><strong>Benchmark:</strong> sigmap-v6.10-main</span>
@@ -149,7 +149,7 @@ See the full [end-to-end walkthrough](/guide/walkthrough) to watch this in actio
 | Overall token reduction | — | **96.8%** |
 | GPT-4o overflow repos | 13/18 | **0/18** |
 
-Latest saved benchmark run: **2026-05-05 (v6.10.5)**.
+Latest saved benchmark run: **2026-05-11 (v6.10.6)**.
 
 </div>
 

gen-context.js

@@ -5607,7 +5607,7 @@ __factories["./src/mcp/server"] = function(module, exports) {
 
   const SERVER_INFO = {
     name: 'sigmap',
-  version: '6.10.5',
+  version: '6.10.6',
     description: 'SigMap MCP server — code signatures on demand',
   };
 
@@ -8234,7 +8234,7 @@ const path = require('path');
 const os = require('os');
 const { execSync } = require('child_process');
 
-const VERSION = '6.10.5';
+const VERSION = '6.10.6';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap",
-  "version": "6.10.5",
+  "version": "6.10.6",
   "description": "Zero-dependency AI context engine — 97% token reduction. No npm install. Runs on Node 18+.",
   "main": "gen-context.js",
   "exports": {

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap-cli",
-  "version": "6.10.5",
+  "version": "6.10.6",
   "description": "SigMap CLI wrapper — thin adapter for programmatic CLI invocation",
   "main": "index.js",
   "keywords": [

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap-core",
-  "version": "6.10.5",
+  "version": "6.10.6",
   "description": "SigMap core library — zero-dependency code signature extraction, retrieval, and security scanning",
   "main": "index.js",
   "keywords": [

src/mcp/server.js

@@ -18,7 +18,7 @@ const { readContext, searchSignatures, getMap, createCheckpoint, getRouting, exp
 
 const SERVER_INFO = {
   name: 'sigmap',
-  version: '6.10.5',
+  version: '6.10.6',
   description: 'SigMap MCP server — code signatures on demand',
 };
 

version.json

@@ -1,5 +1,5 @@
 {
-  "version": "6.10.5",
+  "version": "6.10.6",
   "benchmark_date": "2026-05-11",
   "benchmark_id": "sigmap-v6.10-main",
   "languages": 29,