sigmap 6.6.5 → 6.8.0

package/AGENTS.md

@@ -56,13 +56,6 @@ Use this marker block for all appendable context files:
 | To query by topic | `sigmap --query "<topic>"` |
 
 Always run `sigmap ask` or `sigmap --query` before searching for files relevant to a task.
-## changes (last 5 commits — 8 minutes ago)
-```
-src/plan/planner.js                           +createPlan
-src/retrieval/ranker.js                       +_computePenalty  +_computeHubs  +_isHub  ~scoreFile
-src/session/memory.js                         +sessionPath  +loadSession  +saveSession  +mergeSessionContext
-```
-
 ## packages
 
 ### packages/cli/index.js
@@ -580,11 +573,6 @@ function exportWeights(cwd, outputPath)
 function importWeights(cwd, importPath, replace)
 ```
 
-### src/config/defaults.js
-```
-module.exports = { DEFAULTS }
-```
-
 ### src/config/loader.js
 ```
 module.exports = { loadConfig, loadBaseConfig }
@@ -595,37 +583,6 @@ function loadConfig(cwd) → object
 function deepClone(obj)
 ```
 
-### src/discovery/source-root-registry.js
-```
-module.exports = { REGISTRY }
-```
-
-### src/discovery/source-root-resolver.js
-```
-module.exports = { resolveSourceRoots }
-function resolveSourceRoots(cwd, opts = {})
-function _detectMonorepo(cwd)
-function _enumerateCandidates(cwd, isMonorepo, ignorePatterns, excludeList)
-function _applySpecialRules(scored, cwd, primaryFw, fwEntry, frameworks)
-function _dedupeNested(scored)
-function _computeConfidence(frameworks, languages, scoredCount)
-```
-
-### src/discovery/language-detector.js
-```
-module.exports = { detectLanguages }
-function detectLanguages(cwd)
-function _walkDepth(dir, depth, extCount)
-```
-
-### src/discovery/source-root-scorer.js
-```
-module.exports = { scoreCandidate, getRecentlyChangedDirs, ROOT_ENTRYPOINTS }
-function getRecentlyChangedDirs(cwd)
-function scoreCandidate(dirName, fullPath, context)
-function _countSourceFiles(dir, depth)
-```
-
 ### src/discovery/framework-detector.js
 ```
 module.exports = { detectFrameworks }
@@ -636,6 +593,13 @@ function _existsAnywhere(cwd, filename, maxDepth)
 function _walkFind(dir, name, depth)
 ```
 
+### src/discovery/language-detector.js
+```
+module.exports = { detectLanguages }
+function detectLanguages(cwd)
+function _walkDepth(dir, depth, extCount)
+```
+
 ### src/discovery/sigmapignore.js
 ```
 module.exports = { loadIgnorePatterns, matchesIgnorePattern }
@@ -643,19 +607,9 @@ function loadIgnorePatterns(cwd)
 function matchesIgnorePattern(dirName, patterns)
 ```
 
-### src/plan/planner.js
-```
-module.exports = { createPlan }
-function createPlan(goal, cwd, config)
-```
-
-### src/mcp/server.js
+### src/discovery/source-root-registry.js
 ```
-module.exports = { start }
-function respond(id, result)
-function respondError(id, code, message)
-function dispatch(msg, cwd)
-function start(cwd)
+module.exports = { REGISTRY }
 ```
 
 ### src/retrieval/ranker.js
@@ -673,6 +627,12 @@ function formatRankJSON(results, query) → object
 function detectIntent(query)
 ```
 
+### src/plan/planner.js
+```
+module.exports = { createPlan }
+function createPlan(goal, cwd, config)
+```
+
 ### src/session/memory.js
 ```
 module.exports = { loadSession, saveSession, mergeSessionContext, clearSession }
@@ -682,3 +642,36 @@ function saveSession(cwd, { intent, topFiles, query })
 function mergeSessionContext(scores, session, currentIntent)
 function clearSession(cwd)
 ```
+
+### src/config/defaults.js
+```
+module.exports = { DEFAULTS }
+```
+
+### src/discovery/source-root-scorer.js
+```
+module.exports = { scoreCandidate, getRecentlyChangedDirs, ROOT_ENTRYPOINTS, JVM_PATH_PATTERN }
+function getRecentlyChangedDirs(cwd)
+function scoreCandidate(dirName, fullPath, context)
+function _countSourceFiles(dir, depth)
+```
+
+### src/discovery/source-root-resolver.js
+```
+module.exports = { resolveSourceRoots }
+function resolveSourceRoots(cwd, opts = {})
+function _detectMonorepo(cwd)
+function _enumerateCandidates(cwd, isMonorepo, ignorePatterns, excludeList)
+function _applySpecialRules(scored, cwd, primaryFw, fwEntry, frameworks)
+function _dedupeNested(scored)
+function _computeConfidence(frameworks, languages, scoredCount)
+```
+
+### src/mcp/server.js
+```
+module.exports = { start }
+function respond(id, result)
+function respondError(id, code, message)
+function dispatch(msg, cwd)
+function start(cwd)
+```

package/CHANGELOG.md

@@ -10,6 +10,27 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [6.8.0] — 2026-05-03
+
+### Added
+
+- **Session memory with 4-hour TTL** — Store intent, top-ranked files, and last query in `.context/session.json` to enable context carry-forward across multiple `sigmap ask` calls. Session expires after 4 hours, preventing stale context fixation.
+- **`sigmap ask --followup` flag** — Carry context from previous session with intent-aware boosting: +0.2 score for same intent, +0.1 for topic switch (different intent). Never reduces scores, only adds contextual signals.
+- **`sigmap plan "<goal>"` command** — Analyze change impact before editing: rank files by confidence level (inspect first vs. likely to change), compute impact radius using dependency graph, identify affected tests. Outputs human-readable table or JSON.
+
+---
+
+## [6.7.0] — 2026-05-03
+
+### Added
+
+- **2-hop graph traversal with decay** — Extended graph-boosted retrieval from 1-hop (0.40 boost) to 2-hop (0.15 boost for transitive dependencies), improving retrieval accuracy by catching cross-module architecture patterns. Exported `GRAPH_BOOST_AMOUNTS` constants for transparency.
+- **Hub suppression** — Automatically suppress common utility files (`utils/`, `helpers/`, `shared/`, `common/`, `index`) and high-fanout files (>20% of codebase) from graph boosts to reduce false-positive boosts and improve ranking signal quality.
+- **Incremental signature cache** — Introduced `sigCache: true` config key to enable incremental extraction, caching extracted signatures by mtime. Only re-extracts changed files on subsequent runs, dramatically improving performance on large codebases.
+- **Cache health statistics** — Display cache file size, entry count, and freshness in `--health` output (text and JSON formats) for visibility into cache state and efficiency.
+
+---
+
 ## [6.6.5] — 2026-04-30
 
 ### Added

package/README.md

@@ -12,6 +12,7 @@
 [![Zero deps](https://img.shields.io/badge/dependencies-zero-22c55e)](package.json)
 [![License: MIT](https://img.shields.io/badge/License-MIT-7c6af7.svg)](LICENSE)
 [![GitHub Stars](https://img.shields.io/github/stars/manojmallick/sigmap?style=flat&color=f59e0b&logo=github)](https://github.com/manojmallick/sigmap/stargazers)
+[![Hacker News](https://img.shields.io/badge/Hacker%20News-Discussion-orange?logo=ycombinator)](https://news.ycombinator.com/item?id=47956790)
 
 </div>
 
@@ -38,10 +39,10 @@ Works with Copilot, Claude, Cursor, Windsurf, and any LLM.
 
 ## Why SigMap?
 
-- **81.1% hit@5** — right file found in top 5 results (vs 13.6% baseline)
+- **80.0% hit@5** — right file found in top 5 results (vs 13.6% baseline)
 - **40–98% token reduction** — 2K–4K tokens instead of 80K+
 - **52.2% task success rate** — up from 10% without context
-- **1.69 prompts per task** — down from 2.84
+- **1.68 prompts per task** — down from 2.84
 - **Works with any LLM** — no API key, no cloud, no accounts
 - **Zero npm dependencies** — `npx sigmap` on any machine
 
@@ -75,19 +76,22 @@ Ask → Rank → Context → Validate → Judge → Learn
 ## Benchmark
 
 ```
-Benchmark : sigmap-v6.5-main
-Date      : 2026-04-25
+Benchmark : sigmap-v6.8-main
+Date      : 2026-04-30
 
-Hit@5          : 81.1%   (baseline 13.6%  — 6.0× lift)
-Prompt reduction : 41.4%
+Hit@5          : 80.0%   (baseline 13.6%  — 5.9× lift)
+Prompt reduction : 41.0%
 Task success   : 52.2%   (baseline 10%)
-Prompts / task : 1.69    (baseline 2.84)
-Token reduction: 40–98%  (avg 96.9% across 18 real repos)
+Prompts / task : 1.68    (baseline 2.84)
+Token reduction: 40–98%  (avg 96.8% across 18 real repos)
 ```
 
 Measured on 90 coding tasks across 18 real public repos. No LLM API — fully reproducible.
 
-[Full methodology →](https://manojmallick.github.io/sigmap/guide/benchmark.html)
+**Resources:**
+- [Full methodology →](https://manojmallick.github.io/sigmap/guide/benchmark.html)
+- [Benchmark suite (GitHub)](https://github.com/manojmallick/sigmap-benchmark-suite) — scripts, tasks, and raw data
+- [Benchmark data (Zenodo)](https://zenodo.org/records/19898842) — archived results for reproducibility
 
 <div align="center">
 <img src="docs/comparison-chart.svg" alt="SigMap benchmark — before vs after across 3 RAG quality metrics" width="700" />

package/gen-context.js

@@ -5387,7 +5387,7 @@ __factories["./src/mcp/server"] = function(module, exports) {
   
   const SERVER_INFO = {
     name: 'sigmap',
-  version: '6.6.5',
+  version: '6.8.0',
     description: 'SigMap MCP server — code signatures on demand',
   };
   
@@ -7855,7 +7855,7 @@ const path = require('path');
 const os = require('os');
 const { execSync } = require('child_process');
 
-const VERSION = '6.6.5';
+const VERSION = '6.8.0';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {
@@ -9900,10 +9900,19 @@ function main() {
 
   // v4.2: `sigmap ask "<query>"` — unified pipeline
   if (args[0] === 'ask') {
-    const query = args[1];
+    // v6.8: Handle --followup flag which may appear before or after query
+    let query = args[1];
+    if (query === '--followup' && args[2]) {
+      query = args[2];
+    } else if (query && query.startsWith('--') && query !== '--json' && query !== '--model') {
+      // Allow --json and --model but not other flags as query
+      console.error('[sigmap] Usage: sigmap ask "<query>" [--followup] [--json] [--model <name>]');
+      console.error('  Example: sigmap ask "fix the login bug" --followup');
+      process.exit(1);
+    }
     if (!query || query.startsWith('--')) {
-      console.error('[sigmap] Usage: sigmap ask "<query>"');
-      console.error('  Example: sigmap ask "fix the login bug"');
+      console.error('[sigmap] Usage: sigmap ask "<query>" [--followup] [--json] [--model <name>]');
+      console.error('  Example: sigmap ask "fix the login bug" --followup');
       process.exit(1);
     }
 

package/package.json

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

package/packages/cli/package.json

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

package/packages/core/package.json

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

package/src/mcp/server.js

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