sigmap 5.9.0 → 6.0.1

package/AGENTS.md

@@ -12,20 +12,21 @@ Use this marker block for all appendable context files:
 ## Auto-generated signatures
 <!-- Updated by gen-context.js -->
 You are a coding assistant with full knowledge of this codebase.
-Below are the code signatures extracted by SigMap v5.7.0 on 2026-04-17T21:17:18.905Z.
+Below are the code signatures extracted by SigMap v6.0.1 on 2026-04-21T10:54:32.005Z.
 
 Use these signatures to answer questions about the code accurately.
 
 ## Code Signatures
 
-<!-- Generated by SigMap gen-context.js v5.7.0 -->
+<!-- Generated by SigMap gen-context.js v6.0.1 -->
 <!-- DO NOT EDIT below the marker line — run gen-context.js to regenerate -->
 
 # Code signatures
 
-## changes (last 5 commits — 7 minutes ago)
+## changes (last 5 commits — 11 minutes ago)
 ```
-src/analysis/coverage-score.js                ~coverageScore  ~_walk
+src/extractors/typescript.js                  ~extractInterfaceMembers  ~extractClassMembers
+packages/adapters/codex.js                    ~format
 ```
 
 ## packages
@@ -36,14 +37,6 @@ module.exports = { CLI_ENTRY, run }
 function run(argv, cwd) → void
 ```
 
-### packages/adapters/codex.js
-```
-module.exports = { name, format, outputPath, write }
-function format(context, opts = {}) → string
-function outputPath(cwd) → string
-function write(context, cwd, opts = {})
-```
-
 ### packages/adapters/index.js
 ```
 module.exports = { getAdapter, listAdapters, adapt, outputsToAdapters }
@@ -144,21 +137,15 @@ function score(cwd) → { * score: number, * grad
 function adapt(context, adapterName, opts = {}) → string
 ```
 
-## src
-
-### src/map/route-table.js
+### packages/adapters/codex.js
 ```
-module.exports = { analyze }
-function shouldSkipFile(rel)
-function analyze(files, cwd)
+module.exports = { name, format, outputPath, write }
+function format(context, opts = {}) → string
+function outputPath(cwd) → string
+function write(context, cwd, opts = {})
 ```
 
-### src/routing/classifier.js
-```
-module.exports = { classify, classifyAll }
-function classify(filePath, sigs) → 'fast'|'balanced'|'powerf
-function classifyAll(fileEntries, cwd) → { fast: string[], balance
-```
+## src
 
 ### src/routing/hints.js
 ```
@@ -177,14 +164,6 @@ module.exports = { scan }
 function scan(signatures, filePath) → { safe: string[], redacte
 ```
 
-### src/tracking/logger.js
-```
-module.exports = { logRun, readLog, summarize }
-function logRun(entry, cwd)
-function readLog(cwd) → object[]
-function summarize(entries) → object
-```
-
 ### src/extractors/cpp.js
 ```
 module.exports = { extract }
@@ -344,16 +323,6 @@ module.exports = { extractTodos }
 function extractTodos(src) → {line:number, tag:string,
 ```
 
-### src/extractors/typescript.js
-```
-module.exports = { extract }
-function extract(src) → string[]
-function extractBlock(src, startIndex)
-function extractInterfaceMembers(block)
-function extractClassMembers(block)
-function normalizeParams(params)
-```
-
 ### src/extractors/vue.js
 ```
 module.exports = { extract }
@@ -607,32 +576,6 @@ function penalizeFiles(cwd, files, amount = 0.10)
 function resetWeights(cwd)
 ```
 
-### src/mcp/handlers.js
-```
-module.exports = { readContext, searchSignatures, getMap, createCheckpoint, getRouting, explainFile, listModules, queryContext, getImpact }
-function readContext(args, cwd)
-function searchSignatures(args, cwd)
-function getMap(args, cwd)
-function createCheckpoint(args, cwd)
-function getRouting(args, cwd)
-function explainFile(args, cwd)
-function listModules(args, cwd)
-function queryContext(args, cwd)
-function getImpact(args, cwd)
-```
-
-### src/retrieval/ranker.js
-```
-module.exports = { rank, buildSigIndex, scoreFile, formatRankTable, formatRankJSON, DEFAULT_WEIGHTS, detectIntent }
-function scoreFile(filePath, sigs, queryTokens, weights) → number
-function rank(query, sigIndex, opts) → { file: string, score: nu
-function _parseContextFile(contextPath) → Map<string, string[]>
-function buildSigIndex(cwd, opts) → Map<string, string[]>
-function formatRankTable(results, query) → string
-function formatRankJSON(results, query) → object
-function detectIntent(query)
-```
-
 ### src/format/benchmark-report.js
 ```
 module.exports = { loadBenchmarkReports, buildBenchmarkSummary, generateBenchmarkReportHtml, writeBenchmarkReport }
@@ -667,6 +610,60 @@ function coverageScore(cwd, fileEntries, config)
 function _walk(dir, excludeSet, out)
 ```
 
+### src/tracking/logger.js
+```
+module.exports = { logRun, readLog, summarize }
+function logRun(entry, cwd)
+function readLog(cwd) → object[]
+function summarize(entries) → object
+```
+
+### src/cache/sig-cache.js
+```
+module.exports = { loadCache, saveCache, getChangedFiles, updateCacheEntries }
+function cachePath(cwd)
+function loadCache(cwd, currentVersion) → Map<string, { mtime: numb
+function saveCache(cwd, currentVersion, cache)
+function getChangedFiles(files, cache) → { changed: string[], unch
+function updateCacheEntries(cache, extracted)
+```
+
+### src/extractors/typescript.js
+```
+module.exports = { extract }
+function extract(src) → string[]
+function extractBlock(src, startIndex)
+function extractInterfaceMembers(block)
+function extractClassMembers(block)
+function normalizeParams(params)
+```
+
+### src/mcp/handlers.js
+```
+module.exports = { readContext, searchSignatures, getMap, createCheckpoint, getRouting, explainFile, listModules, queryContext, getImpact }
+function readContext(args, cwd)
+function searchSignatures(args, cwd)
+function getMap(args, cwd)
+function createCheckpoint(args, cwd)
+function getRouting(args, cwd)
+function explainFile(args, cwd)
+function listModules(args, cwd)
+function queryContext(args, cwd)
+function getImpact(args, cwd)
+```
+
+### src/retrieval/ranker.js
+```
+module.exports = { rank, buildSigIndex, scoreFile, formatRankTable, formatRankJSON, DEFAULT_WEIGHTS, detectIntent }
+function scoreFile(filePath, sigs, queryTokens, weights) → number
+function rank(query, sigIndex, opts) → { file: string, score: nu
+function _parseContextFile(contextPath) → Map<string, string[]>
+function buildSigIndex(cwd, opts) → Map<string, string[]>
+function formatRankTable(results, query) → string
+function formatRankJSON(results, query) → object
+function detectIntent(query)
+```
+
 ### src/mcp/server.js
 ```
 module.exports = { start }

package/CHANGELOG.md

@@ -10,6 +10,37 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [6.0.1] — 2026-04-21
+
+### Fixed
+
+- **TypeScript extractor guard clauses (#97)** — `extractClassMembers` now skips control-flow keywords (`if`, `for`, `while`, `switch`, `do`, `try`, `catch`, `finally`, `else`) that were incorrectly emitted as method signatures when they appeared inside class bodies.
+- **Codex/AGENTS.md adapter preamble (#96)** — `packages/adapters/codex.js` no longer delegates to the OpenAI adapter. Output is now clean `# Code signatures\n\n<context>` markdown with no "You are a coding assistant…" preamble, no HTML comment metadata block, and no duplicate headers.
+
+---
+
+## [6.0.0] — 2026-04-19
+
+### Added
+
+- **Graph-boosted retrieval (v6.0)** — `rank()` in `src/retrieval/ranker.js` now accepts `opts.graph`. After scoring all files, a +0.4 `graphBoost` weight is added to 1-hop forward-import neighbors of any file with `score > 0`. Measured lift: +1.1pp (82.2% → 83.3% hit@5 using ranker.js on 90 benchmark tasks).
+- **`DEFAULT_WEIGHTS.graphBoost: 0.4`** — new weight constant; path-normalized relative↔absolute conversion handles the sigIndex/graph format mismatch.
+- **Incremental signature cache (`src/cache/sig-cache.js`)** — `loadCache`, `saveCache`, `getChangedFiles`, `updateCacheEntries` persist extracted signatures keyed by absolute path + mtime to `.sigmap-cache.json`. Version-keyed so upgrades automatically bust the cache. Ready to wire into `gen-context.js` for 80–95% speed reduction on re-runs.
+- **Graph-boosted MCP `query_context`** — `src/mcp/handlers.js` now builds a dependency graph via `buildFromCwd` and passes it to `rank()`, giving agents multi-hop neighbor boosting for free.
+- **README rewrite** — full 15-section conversion-optimised README (tagline, npx demo, ❌/✅ replace table, workflow arrow, canonical benchmark block, install options, integrations, try-it, start guide, why-not-embeddings, license).
+- **`test/integration/v591-readme.test.js`** — 50 tests covering all 15 README sections and consistency rules.
+- **`version.json` updated** — bumped to `6.0.0`, `benchmark_id` to `sigmap-v6.0-main`, metrics updated from live benchmark run: `overall_token_reduction_pct: 96.9`, `retrieval_lift: 5.8`, `graph_boosted_hit_at_5: 0.833`.
+
+### Changed
+
+- **All package versions** synced to `6.0.0` via `scripts/sync-versions.mjs`.
+- **`retrieval_lift`** corrected from 5.9× to 5.8× (actual benchmark run average).
+- **`overall_token_reduction_pct`** corrected from 98.1% to 96.9% (simple average across 18 repos from live matrix run; 98.1% was a weighted-by-size figure from a prior run).
+- **`task_success_proxy_pct`** corrected from 53.3% to 52.2% (live benchmark confirms 47/90 correct).
+- **`prompts_per_task`** corrected from 1.67 to 1.68 (live benchmark output).
+
+---
+
 ## [5.9.0] — 2026-04-18
 
 ### Added