sigmap 8.16.1 → 8.18.0

package/AGENTS.md

@@ -35,15 +35,16 @@ src/extractors/python_ast.py ← ast
 
 ## changes (last 5 commits — 0 seconds ago)
 ```
+src/extractors/csharp.js                      ~extract  ~extractMembers
+src/extractors/dart.js                        ~extract  ~extractMembers
+src/extractors/go.js                          ~extract  ~extractInterfaceMethods
+src/extractors/java.js                        ~extract  ~extractMembers
+src/extractors/kotlin.js                      ~extract  ~extractMembers
+src/extractors/php.js                         ~extract  ~extractMembers
+src/extractors/rust.js                        ~extract  ~extractMethods  ~extractReturnType
+src/extractors/scala.js                       ~extract  ~extractMembers
+src/extractors/swift.js                       ~extract  ~extractMembers  ~extractArrowType
 src/evidence/pack.js                          +riskFactorsFor  ~parseAnchor  ~buildEvidencePack  ~formatMarkdown
-src/graph/call-graph.js                       +calls  +maskRust  +name  +goDefs
-src/mcp/handlers.js                           +that  +getMethodImpact  ~queryContext  ~squeezeOutput
-src/mcp/server.js                             ~dispatch
-src/mcp/tools.js                              +it
-src/retrieval/ranker.js                       ~scoreFile  ~rank
-src/graph/blast-radius.js                     +tierFor  +_normRel  +_bfs  +methodBlastRadius
-src/review/pr-evidence.js                     ~buildPrEvidence  ~formatPrEvidenceMarkdown
-src/review/review-pr.js                       ~isSource  ~reviewPr
 ```
 
 ## packages
@@ -177,84 +178,94 @@ code-fence ---
 
 ### src/config/defaults.js
 ```
-module.exports = { DEFAULTS }  :163-163
+module.exports = { DEFAULTS }  :165-165
 ```
 
-### src/evidence/pack.js
+### src/extractors/csharp.js
 ```
-module.exports = { buildEvidencePack, formatJSON, formatMarkdown, parseAnchor, riskLabelFor, riskFactorsFor, findRelatedTests, SCHEMA_VERSION, SCHEMA_URL, TEST_DISCOVERY }  :326-337
-function parseAnchor(sig) → { symbol: string, start:   :64-72
-function riskLabelFor(relPath) → 'generated'|'test'|'migra  :84-86
-function riskFactorsFor(relPath) → string[]  :96-108
-function stemOf(relPath)  :111-114
-function testTargetStem(relPath) → string  :126-132
-function findRelatedTests(relPath, allFiles) → string[]  :143-154
-function reasonFor(signals)  :157-168
-function sigTokens(sigs)  :171-173
-function canonicalize(value) → string  :180-182
-function sortKeys(value)  :184-192
-function buildEvidencePack(query, cwd, opts = {}) → object  :205-281
-function ranked0Empty(query)  :284-286
-function formatJSON(pack)  :289-291
-function formatMarkdown(pack)  :294-324
+module.exports = { extract }  :71-71
+function extract(src) → string[]  :12-71
+function extractBlock(src, startIndex)  :35-44
+function extractMembers(block)  :46-59
+function normalizeParams(params)  :61-64
+function normalizeType(type)  :66-69
 ```
 
-### src/graph/call-graph.js
+### src/extractors/dart.js
 ```
-module.exports = { buildCallGraph, buildCallFileGraph, methodImpact, methodCallees, formatCallGraph, formatCallGraphJSON, extractDefs, maskJs, maskPy, maskRust }  :563-567
-function normalizePath(p)  :41-41
-function toRel(cwd, f)  :42-42
-function symId(cwd, absFile, name)  :43-43
-function maskJs(src)  :49-65
-function maskRust(src)  :70-91
-function maskPy(src)  :93-110
-function matchDelim(masked, openIdx, open, close)  :113-120
-function lineAt(src, idx)  :122-127
-function jsDefs(masked)  :132-237
-function pyDefs(masked)  :200-220
-function goDefs(masked)  :224-344
-function javaDefs(masked)  :250-367
-function rustDefs(masked)  :278-401
-function maskFor(filePath, src)  :300-305
-function extractDefs(filePath, src)  :307-315
-function callsInRange(masked, start, end)  :318-330
-function _walk(dir, excludeSet, out, depth)  :334-347
-function buildCallGraph(cwd, opts = {}) → { * forward: Map<string,s  :363-446
-function buildCallFileGraph(cwd, opts = {}) → { forward: Map<string,str  :459-482
-function _resolveSymbol(symbol, defs)  :485-490
-function _bfs(seedIds, graph, maxDepth)  :493-506
-function methodImpact(symbol, cwd, opts = {}) → { symbol:string, resolved  :516-522
-function methodCallees(symbol, cwd, opts = {}) → { symbol:string, resolved  :528-534
-function formatCallGraph(result, kind)  :537-549
-… +1 more signatures
+module.exports = { extract }  :84-84
+function extract(src) → string[]  :12-84
+function extractBlock(src, startIndex)  :54-63
+function extractMembers(block)  :65-77
+function normalizeParams(params)  :79-81
+```
+
+### src/extractors/go.js
+```
+module.exports = { extract }  :81-81
+function extract(src) → string[]  :12-81
+function extractBlock(src, startIndex)  :51-60
+function extractInterfaceMethods(block)  :62-74
+function normalizeParams(params)  :76-79
+```
+
+### src/extractors/java.js
+```
+module.exports = { extract }  :71-71
+function extract(src) → string[]  :12-71
+function extractBlock(src, startIndex)  :34-44
+function extractMembers(block)  :46-59
+function normalizeParams(params)  :61-64
+function normalizeType(type)  :66-69
+```
+
+### src/extractors/kotlin.js
+```
+module.exports = { extract }  :90-90
+function extract(src) → string[]  :12-90
+function extractBlock(src, startIndex)  :54-63
+function extractMembers(block)  :65-90
+function normalizeParams(params)  :81-88
 ```
 
-### src/mcp/handlers.js
-```
-module.exports = { readContext, searchSignatures, getMap, createCheckpoint, getRouting, explainFile, listModules, queryContext, getMethodImpact, getImpact, getLines, readMemory, getCalleeSignatures, notifyFileCreated, notifySymbolAdded, notifyFileDeleted, getDiffContext, getArchitectureOverview, verifySuggestion, squeezeOutput }  :975-975
-function _readContextFiles(cwd)  :10-17
-function readContext(args, cwd)  :36-66
-function searchSignatures(args, cwd)  :74-100
-function getMap(args, cwd)  :108-131
-function createCheckpoint(args, cwd)  :143-215
-function getRouting(args, cwd)  :224-261
-function explainFile(args, cwd)  :269-356
-function listModules(args, cwd)  :364-403
-function queryContext(args, cwd)  :411-438
-function getMethodImpact(args, cwd)  :446-460
-function getImpact(args, cwd)  :468-480
-function getLines(args, cwd)  :489-537
-function readMemory(args, cwd)  :545-580
-function getCalleeSignatures(args, cwd)  :589-634
-function _pkgVersion(cwd)  :641-644
-function notifyFileCreated(args, cwd)  :648-670
-function notifySymbolAdded(args, cwd)  :673-693
-function notifyFileDeleted(args, cwd)  :696-710
-function _changedFiles(cwd, args)  :716-728
-function getDiffContext(args, cwd)  :737-808
-function getArchitectureOverview(args, cwd)  :817-885
-function verifySuggestion(args, cwd)  :895-930
-function squeezeOutput(args, cwd)  :940-973
+### src/extractors/php.js
+```
+module.exports = { extract }  :96-96
+function extract(src) → string[]  :12-96
+function extractBlock(src, startIndex)  :58-67
+function extractMembers(block)  :69-96
+function normalizeParams(params)  :86-89
+function normalizeType(type)  :91-94
+```
+
+### src/extractors/rust.js
+```
+module.exports = { extract }  :110-110
+function extract(src) → string[]  :12-110
+function extractBlock(src, startIndex)  :72-81
+function extractMethods(block)  :83-110
+function normalizeParams(params)  :97-100
+function extractReturnType(afterParen)  :102-110
+```
+
+### src/extractors/scala.js
+```
+module.exports = { extract }  :88-88
+function extract(src) → string[]  :12-88
+function extractBlock(src, startIndex)  :47-56
+function extractMembers(block)  :58-88
+function normalizeParams(params)  :74-81
+function normalizeType(type)  :83-86
+```
+
+### src/extractors/swift.js
+```
+module.exports = { extract }  :97-97
+function extract(src) → string[]  :12-97
+function extractBlock(src, startIndex)  :54-63
+function extractMembers(block)  :65-97
+function normalizeParams(params)  :80-87
+function extractArrowType(str)  :89-97
 ```
 
 ### src/mcp/server.js
@@ -266,27 +277,10 @@ function dispatch(msg, cwd)  :41-108
 function start(cwd)  :113-139
 ```
 
-### src/mcp/tools.js
-```
-module.exports = { TOOLS }  :392-392
-```
-
-### src/retrieval/ranker.js
+### src/retrieval/enrich-from-maps.js
 ```
-module.exports = { rank, buildSigIndex, scoreFile, formatRankTable, formatRankJSON, DEFAULT_WEIGHTS, GRAPH_BOOST_AMOUNTS, detectIntent }  :598-598
-function _computePenalty(filePath)  :63-70
-function _computeHubs(graph)  :73-84
-function _isHub(filePath)  :87-91
-function scoreFile(filePath, sigs, queryTokens, weights) → { score: number, signals:  :102-159
-function rank(query, sigIndex, opts) → { file: string, score: nu  :177-302
-function _parseContextFile(contextPath) → Map<string, string[]>  :372-404
-function _mergeSigIndex(target, source)  :407-415
-function _buildSigIndexFromCache(cwd) → Map<string, string[]>  :422-442
-function _enrichSigIndexFromStrategy(cwd, index) → Map<string, string[]>  :450-456
-function buildSigIndex(cwd, opts) → Map<string, string[]>  :473-506
-function formatRankTable(results, query) → string  :515-551
-function formatRankJSON(results, query) → object  :560-575
-function detectIntent(query)  :590-596
+module.exports = { enrichWithSurfaces }  :55-55
+function enrichWithSurfaces(index, cwd) → number  :25-53
 ```
 
 ### src/analysis/coverage-score.js
@@ -539,6 +533,25 @@ function scoreUsefulness(taskResult, rankingScore)  :11-38
 function computeUsefulnessStats(taskResults)  :40-66
 ```
 
+### src/evidence/pack.js
+```
+module.exports = { buildEvidencePack, formatJSON, formatMarkdown, parseAnchor, riskLabelFor, riskFactorsFor, findRelatedTests, SCHEMA_VERSION, SCHEMA_URL, TEST_DISCOVERY }  :326-337
+function parseAnchor(sig) → { symbol: string, start:   :64-72
+function riskLabelFor(relPath) → 'generated'|'test'|'migra  :84-86
+function riskFactorsFor(relPath) → string[]  :96-108
+function stemOf(relPath)  :111-114
+function testTargetStem(relPath) → string  :126-132
+function findRelatedTests(relPath, allFiles) → string[]  :143-154
+function reasonFor(signals)  :157-168
+function sigTokens(sigs)  :171-173
+function canonicalize(value) → string  :180-182
+function sortKeys(value)  :184-192
+function buildEvidencePack(query, cwd, opts = {}) → object  :205-281
+function ranked0Empty(query)  :284-286
+function formatJSON(pack)  :289-291
+function formatMarkdown(pack)  :294-324
+```
+
 ### src/extractors/coverage.js
 ```
 module.exports = { buildTestIndex, isTested }  :79-79
@@ -557,31 +570,12 @@ function normalizeParams(params)  :59-62
 function normalizeType(type)  :64-67
 ```
 
-### src/extractors/csharp.js
-```
-module.exports = { extract }  :59-59
-function extract(src) → string[]  :8-59
-function extractBlock(src, startIndex)  :27-36
-function extractMembers(block)  :38-47
-function normalizeParams(params)  :49-52
-function normalizeType(type)  :54-57
-```
-
 ### src/extractors/css.js
 ```
 module.exports = { extract }  :69-69
 function extract(src) → string[]  :8-17
 ```
 
-### src/extractors/dart.js
-```
-module.exports = { extract }  :60-60
-function extract(src) → string[]  :8-60
-function extractBlock(src, startIndex)  :34-43
-function extractMembers(block)  :45-53
-function normalizeParams(params)  :55-57
-```
-
 ### src/extractors/deps.js
 ```
 module.exports = { extractPythonDeps, extractTSDeps, extractRDeps, buildReverseDepMap }  :110-110
@@ -618,15 +612,6 @@ module.exports = { extract }  :2-2
 function extract(src)  :14-26
 ```
 
-### src/extractors/go.js
-```
-module.exports = { extract }  :65-65
-function extract(src) → string[]  :8-65
-function extractBlock(src, startIndex)  :39-48
-function extractInterfaceMethods(block)  :50-58
-function normalizeParams(params)  :60-63
-```
-
 ### src/extractors/graphql.js
 ```
 module.exports = { extract }  :66-66
@@ -639,16 +624,6 @@ module.exports = { extract }  :39-39
 function extract(src) → string[]  :9-37
 ```
 
-### src/extractors/java.js
-```
-module.exports = { extract }  :60-60
-function extract(src) → string[]  :8-60
-function extractBlock(src, startIndex)  :27-37
-function extractMembers(block)  :39-48
-function normalizeParams(params)  :50-53
-function normalizeType(type)  :55-58
-```
-
 ### src/extractors/javascript.js
 ```
 module.exports = { extract }  :147-147
@@ -661,15 +636,6 @@ function formatReturnHint(type)  :138-140
 function normalizeParams(params)  :142-145
 ```
 
-### src/extractors/kotlin.js
-```
-module.exports = { extract }  :66-66
-function extract(src) → string[]  :8-66
-function extractBlock(src, startIndex)  :34-43
-function extractMembers(block)  :45-66
-function normalizeParams(params)  :57-64
-```
-
 ### src/extractors/line-anchor.js
 ```
 module.exports = { lineAt, anchor, withAnchor }  :52-52
@@ -690,16 +656,6 @@ module.exports = { extract }  :135-135
 function extract(src) → string[]  :10-133
 ```
 
-### src/extractors/php.js
-```
-module.exports = { extract }  :71-71
-function extract(src) → string[]  :8-71
-function extractBlock(src, startIndex)  :37-46
-function extractMembers(block)  :48-71
-function normalizeParams(params)  :61-64
-function normalizeType(type)  :66-69
-```
-
 ### src/extractors/prdiff.js
 ```
 module.exports = { diffSignatures, extractName }  :70-70
@@ -781,26 +737,6 @@ function normalizeParams(params)  :40-43
 function extractReturnHint(stripped, index)  :45-52
 ```
 
-### src/extractors/rust.js
-```
-module.exports = { extract }  :82-82
-function extract(src) → string[]  :8-82
-function extractBlock(src, startIndex)  :48-57
-function extractMethods(block)  :59-82
-function normalizeParams(params)  :69-72
-function extractReturnType(afterParen)  :74-82
-```
-
-### src/extractors/scala.js
-```
-module.exports = { extract }  :76-76
-function extract(src) → string[]  :8-76
-function extractBlock(src, startIndex)  :39-48
-function extractMembers(block)  :50-76
-function normalizeParams(params)  :62-69
-function normalizeType(type)  :71-74
-```
-
 ### src/extractors/shell.js
 ```
 module.exports = { extract }  :43-43
@@ -823,16 +759,6 @@ function normalizeParams(params)  :48-51
 function normalizeType(type)  :53-56
 ```
 
-### src/extractors/swift.js
-```
-module.exports = { extract }  :73-73
-function extract(src) → string[]  :8-73
-function extractBlock(src, startIndex)  :34-43
-function extractMembers(block)  :45-73
-function normalizeParams(params)  :56-63
-function extractArrowType(str)  :65-73
-```
-
 ### src/extractors/terraform.js
 ```
 module.exports = { extract }  :74-74
@@ -1033,6 +959,36 @@ function build(files, cwd, ctx) → { forward: Map<string,str  :387-426
 function buildFromCwd(cwd, opts) → { forward: Map<string,str  :438-492
 ```
 
+### src/graph/call-graph.js
+```
+module.exports = { buildCallGraph, buildCallFileGraph, methodImpact, methodCallees, formatCallGraph, formatCallGraphJSON, extractDefs, maskJs, maskPy, maskRust }  :563-567
+function normalizePath(p)  :41-41
+function toRel(cwd, f)  :42-42
+function symId(cwd, absFile, name)  :43-43
+function maskJs(src)  :49-65
+function maskRust(src)  :70-91
+function maskPy(src)  :93-110
+function matchDelim(masked, openIdx, open, close)  :113-120
+function lineAt(src, idx)  :122-127
+function jsDefs(masked)  :132-237
+function pyDefs(masked)  :200-220
+function goDefs(masked)  :224-344
+function javaDefs(masked)  :250-367
+function rustDefs(masked)  :278-401
+function maskFor(filePath, src)  :300-305
+function extractDefs(filePath, src)  :307-315
+function callsInRange(masked, start, end)  :318-330
+function _walk(dir, excludeSet, out, depth)  :334-347
+function buildCallGraph(cwd, opts = {}) → { * forward: Map<string,s  :363-446
+function buildCallFileGraph(cwd, opts = {}) → { forward: Map<string,str  :459-482
+function _resolveSymbol(symbol, defs)  :485-490
+function _bfs(seedIds, graph, maxDepth)  :493-506
+function methodImpact(symbol, cwd, opts = {}) → { symbol:string, resolved  :516-522
+function methodCallees(symbol, cwd, opts = {}) → { symbol:string, resolved  :528-534
+function formatCallGraph(result, kind)  :537-549
+… +1 more signatures
+```
+
 ### src/graph/impact.js
 ```
 module.exports = { getImpact, analyzeImpact, formatImpact, formatImpactJSON }  :240-240
@@ -1140,13 +1096,6 @@ function walk(dir, cwd, depth, out)  :31-62
 function analyze(files, cwd)  :64-82
 ```
 
-### src/map/route-table.js
-```
-module.exports = { analyze }  :127-127
-function shouldSkipFile(rel)  :18-21
-function analyze(files, cwd)  :23-125
-```
-
 ### src/mcp/install.js
 ```
 module.exports = { CLIENTS, listClients, installClient, resolveTarget }  :142-142
@@ -1159,6 +1108,11 @@ function _installYaml(filePath, scriptPath)  :99-117
 function installClient(client, opts = {}) → client, label, path, stat  :124-140
 ```
 
+### src/mcp/tools.js
+```
+module.exports = { TOOLS }  :392-392
+```
+
 ### src/nudge.js
 ```
 module.exports = { checkStarNudge, readUsage, usagePath, showStarNudge, RUN_THRESHOLD, SUCCESS_THRESHOLD }  :92-92
@@ -1192,6 +1146,24 @@ function expandQuery(qToks) → Map<string, number>  :132-141
 function bm25rank(query, candidates) → Array<object & { score: n  :154-193
 ```
 
+### src/retrieval/ranker.js
+```
+module.exports = { rank, buildSigIndex, scoreFile, formatRankTable, formatRankJSON, DEFAULT_WEIGHTS, GRAPH_BOOST_AMOUNTS, detectIntent }  :598-598
+function _computePenalty(filePath)  :63-70
+function _computeHubs(graph)  :73-84
+function _isHub(filePath)  :87-91
+function scoreFile(filePath, sigs, queryTokens, weights) → { score: number, signals:  :102-159
+function rank(query, sigIndex, opts) → { file: string, score: nu  :177-302
+function _parseContextFile(contextPath) → Map<string, string[]>  :372-404
+function _mergeSigIndex(target, source)  :407-415
+function _buildSigIndexFromCache(cwd) → Map<string, string[]>  :422-442
+function _enrichSigIndexFromStrategy(cwd, index) → Map<string, string[]>  :450-456
+function buildSigIndex(cwd, opts) → Map<string, string[]>  :473-506
+function formatRankTable(results, query) → string  :515-551
+function formatRankJSON(results, query) → object  :560-575
+function detectIntent(query)  :590-596
+```
+
 ### src/retrieval/tokenizer.js
 ```
 module.exports = { tokenize, STOP_WORDS }  :54-54

package/CHANGELOG.md

@@ -10,6 +10,30 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [8.18.0] — 2026-07-12
+
+Minor release — **the §7.4 Phase-2 closer**: with these three changes, every quality-ceiling row in the master plan's scorecard is done or measure-gated-closed.
+
+### Added
+- **Line anchors for Kotlin, Swift, PHP, Scala, and Dart (#486, PR #487):** the v8.17 recipe applied to the remaining five brace languages — newline-preserving comment strips, brace-matched `:start-end` ranges on types, `:n-n` members, body-scan ranging for top-level functions (expression bodies and PSR next-line braces degrade to single-line anchors). All five fixture files anchor 100%; **9 brace languages** now carry Surgical Context anchors.
+- **Route surface-enrichment, opt-in and measure-gated (#488, PR #489):** `collectRoutes` split out of the route-table analyzer (markdown unchanged); `enrichWithSurfaces` appends deterministic `route METHOD /path` pseudo-signatures to the defining file's rankable index entry (sorted, deduped, copy-on-write, idempotent). Config `retrieval.surfaceEnrichment` (default `false`) wired into `ask`/`--query`/`query_context`. **Measured** by the new `npm run benchmark:surface-enrichment` A/B: 280 route pseudo-sigs across 18 repos, 90 tasks — **delta +0** (the corpus never asks route-worded questions), so the default stays off per the gate; the fixture test proves the value case directly — a route-worded query retrieves the controller *only* when enriched.
+
+### Changed
+- **Docs — the agent's live loop (#490, PR #491):** new "Your agent's live loop" section in the MCP guide framing `query_context` → `get_callee_signatures` → `get_lines` → `verify_suggestion` → `get_method_impact` as what an agentic loop *calls for grounding* (grep finds; SigMap grounds); README gains the framing and the previously missing `get_method_impact` in its tool list.
+- **Ranking is now anchor-invariant:** BM25 strips `:start-end` line anchors before tokenizing, so adding anchors to an extractor never shifts length normalization — this moved one borderline task from partial to **rank-1** (correct 61→62/90, task-success proxy 67.8→68.9%).
+- **Headline metric shift, documented honestly:** anchors on the five new corpus languages consume real context budget, and one already-borderline Swift task (`vapor-t002`, a route-worded query) fell out of top-5 — **hit@5 87.8% → 86.7%** (stable across repeated runs, root-caused to the vapor repo). Rank-1 accuracy and task success went **up**; the trade buys Surgical Context anchors on 9 languages.
+
+---
+
+## [8.17.0] — 2026-07-12
+
+Minor release — **line anchors for Java, Go, Rust, and C#** (§7.4 Lang ceiling, the roadmap's long-named "anchors for the remaining extractors" item).
+
+### Added
+- **Extractor line anchors for Java/Go/Rust/C# (#483, PR #484):** signatures from these languages now carry `:start-end` anchors — types/functions with bodies get real brace-matched ranges, single-line members get `:n-n`, Rust bodyless items (unit structs, trait declarations) get single-line anchors. Prerequisite fix folded in: the four extractors' comment strips are now **newline-preserving** (block comments previously collapsed outright, making true line numbers impossible — regression-tested with a multi-line license header above declarations). Downstream, verified: Evidence Pack `anchorCoverage` goes **0 → 1.0** on Go/Java fixtures with populated `sourceLines`, and `get_lines` (Surgical Context) works on all four languages. Expected extractor fixtures regenerated; `parseAnchor` round-trips every emitted anchor.
+
+---
+
 ## [8.16.1] — 2026-07-12
 
 Patch release — **benchmark hygiene**; the published package is unchanged (scripts + tests only).

package/README.md

@@ -59,9 +59,9 @@ That map is exactly what agentic grep is worst at: reproducible, auditable conte
 
 **Proof it pays off** (full benchmark below):
 <!--SM:whyMetrics-->
-- **87.8% hit@5** — right file found in top 5 results (vs 13.6% baseline)
-- **97.0% token reduction** — average across 21 real repos
-- **67.8% task success rate** — up from 10% without context
+- **86.7% hit@5** — right file found in top 5 results (vs 13.6% baseline)
+- **96.9% token reduction** — average across 21 real repos
+- **68.9% task success rate** — up from 10% without context
 - **1.44 prompts per task** — down from 2.84 (49.2% fewer retries)
 <!--/SM:whyMetrics-->
 - **<!--SM:languages-->33<!--/SM:languages--> languages supported** — TypeScript, Python, Go, Rust, Java, R, and more
@@ -98,7 +98,7 @@ sigmap verify answer.md --report        # standalone red/amber/green HTML report
 | Without SigMap | With SigMap |
 |---|---|
 | ❌ Non-reproducible agent guesses | ✅ Deterministic map — same input, same output, every time |
-| ❌ "Trust me" AI answers | ✅ Grounded — right file in context <!--SM:hitWhole-->88%<!--/SM:hitWhole--> of the time, every symbol on a real line anchor |
+| ❌ "Trust me" AI answers | ✅ Grounded — right file in context <!--SM:hitWhole-->87%<!--/SM:hitWhole--> of the time, every symbol on a real line anchor |
 | ❌ Embeddings / vector DB required | ✅ Zero deps, no infra, fully offline |
 
 ---
@@ -122,13 +122,13 @@ Ask → Rank → Context → Validate → Judge → Learn
 
 <!--SM:benchmarkBlock-->
 ```
-Benchmark : sigmap-v8.16-main (21 repositories, including R language)
-Date      : 2026-07-11
+Benchmark : sigmap-v8.18-main (21 repositories, including R language)
+Date      : 2026-07-12
 
-Hit@5          : 87.8%   (baseline 13.6%  — 6.5× lift)
-Token reduction: 97.0%   (across 21 repos)
+Hit@5          : 86.7%   (baseline 13.6%  — 6.4× lift)
+Token reduction: 96.9%   (across 21 repos)
 Prompt reduction : 49.2% (2.84 → 1.44 prompts per task)
-Task success   : 67.8%   (baseline 10%)
+Task success   : 68.9%   (baseline 10%)
 Repos tested   : 21 (JavaScript, Python, Go, Rust, Java, R, C++, C#, Dart, Swift, Ruby, PHP, Scala, Kotlin, and more)
 ```
 <!--/SM:benchmarkBlock-->
@@ -228,7 +228,9 @@ Use SigMap with open-source tools and fully self-hosted setups:
 sigmap --mcp
 ```
 
-Tools: `read_context`, `search_signatures`, `get_map`, `create_checkpoint`, `get_routing`, `explain_file`, `list_modules`, `query_context`, `get_impact`, `get_lines`, `read_memory`, `get_callee_signatures`, `get_diff_context` (changed files + signatures + blast radius), `get_architecture_overview` (modules, hub files, cycles), `verify_suggestion` (ground AI code against repo + installed libraries), `squeeze_output` (compress noisy tool/log/JSON output mid-session), plus the live-index notifications `sigmap_notify_file_created`, `sigmap_notify_symbol_added`, and `sigmap_notify_file_deleted`. Full reference: [llms-full.txt](llms-full.txt).
+Tools: `read_context`, `search_signatures`, `get_map`, `create_checkpoint`, `get_routing`, `explain_file`, `list_modules`, `query_context`, `get_method_impact` (per-symbol blast radius), `get_impact`, `get_lines`, `read_memory`, `get_callee_signatures`, `get_diff_context` (changed files + signatures + blast radius), `get_architecture_overview` (modules, hub files, cycles), `verify_suggestion` (ground AI code against repo + installed libraries), `squeeze_output` (compress noisy tool/log/JSON output mid-session), plus the live-index notifications `sigmap_notify_file_created`, `sigmap_notify_symbol_added`, and `sigmap_notify_file_deleted`. Full reference: [llms-full.txt](llms-full.txt).
+
+SigMap doesn't compete with your agent's live search — it's what the live loop **calls for grounding**: grep finds the file; `query_context` → `get_callee_signatures` → `get_lines` → `verify_suggestion` → `get_method_impact` prove the symbols, lines, calls, and blast radius — deterministically. See [the agent live-loop guide](https://sigmap.io/guide/mcp#your-agents-live-loop).
 
 ---