sigmap 2.0.0-beta.6 → 2.0.0

package/CHANGELOG.md

@@ -6,99 +6,37 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
-## [2.0.0-beta.6] — 2026-04-04
+## [2.0.0] — 2026-04-04
 
-### Changed
-- Prerelease version bumped from `2.0.0-beta.5` to `2.0.0-beta.6` across CLI, MCP server info, root package metadata, and VS Code extension metadata.
-
-### Validation gate
-- 21/21 extractor tests passed
-- 17/17 integration suites passed (including v2plus 3/3)
-
----
-
-## [2.0.0-beta.5] — 2026-04-03
-
-### Changed
-- Prerelease version bumped from `2.0.0-beta.4` to `2.0.0-beta.5` across CLI, MCP server info, root package metadata, and VS Code extension metadata.
-
-### Validation gate
-- 21/21 extractor tests passed
-- 17/17 integration suites passed (including v2plus 3/3)
-
----
-
-## [2.0.0-beta.4] — 2026-04-03
-
-### Changed
-- Prerelease version bumped from `2.0.0-beta.3` to `2.0.0-beta.4` across CLI, MCP server info, root package metadata, and VS Code extension metadata.
-
-### Validation gate
-- 21/21 extractor tests passed
-- 17/17 integration suites passed (including v2plus 3/3)
-
----
-
-## [2.0.0-beta.3] — 2026-04-03
+### Added
+- **v2 output enrichment pipeline** — compact `deps`, `todos`, `changes` sections auto-generated in context output.
+- **Structural diff mode** — `--diff <base-ref>` writes a signature-level diff section comparing current signatures against a base branch.
+- **Test coverage markers** — opt-in per-function `✓`/`✗` hints by scanning test directories (`testCoverage: true`).
+- **Impact radius hints** — opt-in reverse dependency annotations (`impactRadius: true`).
+- **New helper extractors**:
+  - `src/extractors/deps.js` — Python and TS/JS dependency extraction + reverse dep map.
+  - `src/extractors/todos.js` — TODO/FIXME/HACK/XXX harvesting (max 20 entries).
+  - `src/extractors/coverage.js` — lightweight function/test correlation.
+  - `src/extractors/prdiff.js` — signature-level base-ref diffs.
+- **New config keys**: `enrichSignatures`, `depMap`, `schemaFields`, `todos`, `changes`, `changesCommits`, `testCoverage`, `testDirs`, `impactRadius`.
+- `test/integration/v2plus.test.js` — 3 integration tests for todos, coverage markers, and structural diff.
+- `test/integration/all.js` — unified integration runner and `test:integration:all` npm script.
 
 ### Changed
-- Prerelease version bumped from `2.0.0-beta.2` to `2.0.0-beta.3` across CLI, MCP server info, root package metadata, and VS Code extension metadata.
-- Version drift in [gen-context.js](gen-context.js) was corrected so runtime reporting matches published package metadata.
-
-### Validation gate
-- `node scripts/bundle.js`
-- `node test/run.js`
-- `node test/integration/all.js`
-- `node gen-context.js --report`
-
-## [2.0.0-beta.2] — 2026-04-03
+- **Enriched multi-language extractors** — return-type hints (`→ Type`) and richer signatures across C++, C#, Dart, Go, Java, JavaScript, Kotlin, PHP, Python, Ruby, Rust, Scala, Svelte, Swift, TypeScript, and Vue.
+- **Python extractor** — dataclass/BaseModel field collapse, top-level docstring hints, fixed field bleed across class boundaries.
+- **TypeScript extractor** — interface property types, class method return hints, compact hook return shapes for `export function useX()`, union type truncation extended to 35 chars.
+- Removed stale development files: `TIMELINE.md`, `scripts/bundle.js`, `scripts/make-icon.py`, `scripts/inject-search.py`, `scripts/backfill-npm.sh`, `examples/slack-context-bot.js`, `examples/copilot-prompts.code-snippets`.
 
 ### Fixed
-- Python BaseModel field extraction no longer bleeds into subsequent classes when class bodies are separated by blank lines.
-  - Updated [src/extractors/python.js](src/extractors/python.js) `tryExtractBaseModelFields` to stop scanning at the next top-level block.
-- TypeScript interface member type previews now preserve longer union strings.
-  - Updated [src/extractors/typescript.js](src/extractors/typescript.js) to extend interface type truncation from 20 to 35 characters.
-- TypeScript function-style hooks (`export function useX`) now include compact return object shapes, matching existing arrow-hook behavior.
-  - Updated [src/extractors/typescript.js](src/extractors/typescript.js) export-function extraction path.
-
-### Changed
-- Prerelease version bumped from `2.0.0-beta.1` to `2.0.0-beta.2` across CLI, MCP server info, root package metadata, and VS Code extension metadata.
+- Python `tryExtractBaseModelFields` no longer bleeds fields into subsequent classes.
+- TypeScript interface member type previews preserve longer union strings (20 → 35 chars).
+- TypeScript function-style hooks (`export function useX`) now include compact return object shapes.
 
 ### Validation gate
-- `node scripts/bundle.js`
-- `node test/run.js`
-- `node test/integration/all.js`
-- `node gen-context.js --report`
-- `node /Users/manojmallick/context-forge/gen-context.js --report` on arbi-platform
-
-## [2.0.0-beta.1] — 2026-04-03
-
-### Added
-- v2 output enrichment pipeline in [gen-context.js](gen-context.js): compact `deps`, `todos`, `changes`, optional structural `diff (vs <base>)`, optional test coverage markers, and optional impact-radius hints.
-- New helper extractors:
-  - [src/extractors/deps.js](src/extractors/deps.js) for Python and TS/JS dependency extraction
-  - [src/extractors/todos.js](src/extractors/todos.js) for TODO/FIXME/HACK/XXX harvesting
-  - [src/extractors/coverage.js](src/extractors/coverage.js) for lightweight function/test correlation
-  - [src/extractors/prdiff.js](src/extractors/prdiff.js) for signature-level base-ref diffs
-- New integration coverage in [test/integration/v2plus.test.js](test/integration/v2plus.test.js) for todos, changes, test coverage markers, and `--diff <base-ref>`.
-- New unified integration runner in [test/integration/all.js](test/integration/all.js) and npm script `test:integration:all` in [package.json](package.json).
-
-### Changed
-- Expanded multi-language extractors to surface compact return-type hints and richer signatures across C++, C#, Dart, Go, Java, JavaScript, Kotlin, PHP, Python, Ruby, Rust, Scala, Svelte, Swift, TypeScript, and Vue.
-- Python extractor now supports dataclass/BaseModel field collapse and top-level docstring hints.
-- TypeScript extractor now exposes interface property types, class method return hints, and compact hook return shapes for `use*` exports.
-- Source config defaults in [src/config/defaults.js](src/config/defaults.js) now include strategy keys and v2 output toggles so source-loaded config matches bundled behavior.
-- Compatibility tests were updated to current `sigmap.*` command/config naming and broader MCP tool lists.
-
-### Validation gate
-- `node test/run.js` → 21/21 pass
-- `node test/integration/all.js` → 17/17 integration suites pass
-- `node gen-context.js --report` on this repo → ~93.6% reduction
-- `node /Users/manojmallick/context-forge/gen-context.js --report` on arbi-platform → ~85.7% reduction, 3987 output tokens
-
-### Notes
-- This is a prerelease build intended for final release hardening before stable `2.0.0`.
-- Publish with the `beta` dist-tag to avoid upgrading stable consumers automatically.
+- 21/21 extractor tests passed
+- 17/17 integration suites passed (262 individual tests)
+- `node gen-context.js --report` → ~93.5% reduction
 
 
 ## [1.5.0] — 2026-04-04
@@ -127,7 +65,6 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ### Notes
 - The VS Code extension requires the `vscode` peer dependency at runtime (provided by the editor). It has no npm runtime dependencies of its own.
-- `scripts/inject-search.py` is the one-time migration script used to add search to existing HTML pages; it is idempotent (skip if already patched).
 
 ### Validation gate
 - `node gen-context.js --version` → `1.5.0` ✔  *(note: version bumped separately if desired)*

package/README.md

@@ -11,7 +11,7 @@
 
 <!-- Status -->
 [![npm version](https://img.shields.io/npm/v/sigmap?color=7c6af7&label=latest&logo=npm)](https://www.npmjs.com/package/sigmap)
-[![Tests](https://img.shields.io/badge/tests-274%20passing-22c55e)](https://github.com/manojmallick/sigmap/tree/main/test)
+[![Tests](https://img.shields.io/badge/tests-262%20passing-22c55e)](https://github.com/manojmallick/sigmap/tree/main/test)
 [![Zero deps](https://img.shields.io/badge/dependencies-zero-22c55e)](package.json)
 [![Last commit](https://img.shields.io/github/last-commit/manojmallick/sigmap?color=7c6af7)](https://github.com/manojmallick/sigmap/commits/main)
 
@@ -82,6 +82,23 @@ AI agent session starts with full context
 
 ---
 
+## 🆕 What's new in 2.0
+
+| Feature | Description |
+|---|---|
+| **Enriched signatures** | Return types, type hints, and schema field collapse (Python `@dataclass` / `BaseModel`) |
+| **Dependency map** | Compact import dependency section at the top of output (~50–100 extra tokens) |
+| **TODO/FIXME section** | Auto-harvested TODO/FIXME/HACK/XXX comments (max 20 entries) |
+| **Recent changes section** | Git-based recent changes summary in output |
+| **Test coverage markers** | Per-function `✓`/`✗` hints by scanning test directories |
+| **Structural diff mode** | `--diff <base-ref>` writes a signature-level diff section |
+| **Impact radius hints** | Reverse dependency annotations (used by: ...) |
+| **New helper extractors** | `deps.js`, `todos.js`, `coverage.js`, `prdiff.js` |
+
+Several v2 enhancements (deps map, TODOs, recent changes) are enabled by default. All v2 sections can be tuned or disabled via `gen-context.config.json`.
+
+---
+
 ## 🚀 Quick start
 
 **No install required — just Node.js 18+.**
@@ -147,7 +164,7 @@ The `vscode-extension/` directory contains a first-party VS Code extension that
 | **Stale notification** | Warns when `copilot-instructions.md` is > 24 h old; one-click regeneration |
 | **Regenerate command** | `SigMap: Regenerate Context` — runs `node gen-context.js` in the integrated terminal |
 | **Open context command** | `SigMap: Open Context File` — opens `.github/copilot-instructions.md` |
-| **Script path setting** | `contextforge.scriptPath` — override when `gen-context.js` is not at the project root |
+| **Script path setting** | `sigmap.scriptPath` — override when `gen-context.js` is not at the project root |
 
 Activate on startup (`onStartupFinished`) — loads within 3 s, never blocks editor startup.
 
@@ -380,7 +397,7 @@ node gen-context.js --track
 
 # Structured JSON report for CI (exits 1 if over budget)
 node gen-context.js --report --json
-# { "version": "1.5.0", "finalTokens": 3200, "reductionPct": 92.4, "overBudget": false }
+# { "version": "2.0.0", "finalTokens": 3200, "reductionPct": 92.4, "overBudget": false }
 
 # Composite health score
 node gen-context.js --health
@@ -478,7 +495,7 @@ sigmap/
 │   ├── fixtures/                ← one source file per language
 │   ├── expected/                ← expected extractor output
 │   ├── run.js                   ← zero-dep test runner
-│   └── integration/             ← 16 integration test files (253 tests)
+│   └── integration/             ← 17 integration test files (241 tests)
 │
 ├── docs/                        ← documentation site (GitHub Pages)
 │   ├── index.html               ← homepage
@@ -490,11 +507,12 @@ sigmap/
 │
 ├── scripts/
 │   ├── ci-update.sh             ← CI pipeline helper
-│   └── inject-search.py         ← one-time: add search to docs HTML pages
+│   └── release.sh               ← version bump + npm publish helper
 │
 ├── examples/
 │   ├── self-healing-github-action.yml
-│   └── gen-context.config.json  ← full annotated config
+│   ├── github-action.yml            ← ready-to-use CI workflow
+│   └── claude-code-settings.json    ← MCP server config example
 │
 ├── .npmignore                   ← excludes docs/, test/, vscode-extension/ from publish
 ├── .contextignore.example       ← exclusion template

package/gen-context.config.json.example

@@ -1,5 +1,5 @@
 {
-  "_comment": "ContextForge configuration — all keys are optional (defaults shown)",
+  "_comment": "SigMap configuration — all keys are optional (defaults shown)",
 
   "output": ".github/copilot-instructions.md",
 
@@ -38,15 +38,9 @@
   "_hotCommits_comment": "Only used by hot-cold strategy: how many recent commits count as 'hot'",
   "hotCommits": 10,
 
-  "_enrichSignatures_comment": "Enrich signatures with return types, type hints, and schema field collapse (Python @dataclass / BaseModel)",
-  "enrichSignatures": true,
-
   "_depMap_comment": "Include a compact import dependency map at the top of the output (~50-100 extra tokens)",
   "depMap": true,
 
-  "_schemaFields_comment": "Collapse Pydantic BaseModel / @dataclass class bodies to a single field-list line",
-  "schemaFields": true,
-
   "_todos_comment": "Include compact TODO/FIXME/HACK/XXX section (max 20 entries)",
   "todos": true,
 

package/gen-context.js

@@ -1045,8 +1045,12 @@ __factories["./src/extractors/python"] = function(module, exports) {
   function tryExtractBaseModelFields(stripped, bodyStart) {
     const lines = stripped.slice(bodyStart, bodyStart + 800).split('\n');
     const fields = [];
+    let foundFirst = false;
     for (const line of lines) {
+      if (line.trim() === '') continue;
+      if (foundFirst && !/^\s/.test(line)) break;
       if (!line.match(/^\s{4}\w/)) continue;
+      foundFirst = true;
       const f = line.match(/^\s{4}(\w+)\s*(?::\s*([^=\n]+?))?(?:\s*=\s*(.*))?$/);
       if (!f || f[1].startsWith('_') || f[1] === 'class' || f[1] === 'def') continue;
       const isOptional = (f[2] || '').includes('Optional') || f[3] !== undefined;
@@ -1629,7 +1633,7 @@ __factories["./src/extractors/typescript"] = function(module, exports) {
     for (const m of block.matchAll(/^\s+(readonly\s+)?(\w+)(\??):\s*([^;]+);/gm)) {
       const readonly = m[1] ? 'readonly ' : '';
       const optional = m[3] ? '?' : '';
-      const typeStr = m[4].trim().replace(/\s+/g, ' ').slice(0, 20);
+      const typeStr = m[4].trim().replace(/\s+/g, ' ').slice(0, 35);
       members.push(`${readonly}${m[2]}${optional}: ${typeStr}`);
     }
     for (const m of block.matchAll(/^\s+(\w+)\s*(?:<[^(]*>)?\s*\(([^)]*)\)\s*:/gm)) {
@@ -1712,7 +1716,20 @@ __factories["./src/extractors/deps"] = function(module, exports) {
     return [...deps].slice(0, 5);
   }
   
-  module.exports = { extractPythonDeps, extractTSDeps };
+  function buildReverseDepMap(forwardMap) {
+    const reverse = new Map();
+    if (!forwardMap || typeof forwardMap.entries !== 'function') return reverse;
+    for (const [file, deps] of forwardMap.entries()) {
+      if (!Array.isArray(deps)) continue;
+      for (const dep of deps) {
+        if (!reverse.has(dep)) reverse.set(dep, []);
+        reverse.get(dep).push(file);
+      }
+    }
+    return reverse;
+  }
+
+  module.exports = { extractPythonDeps, extractTSDeps, buildReverseDepMap };
   
 };
 
@@ -3566,7 +3583,7 @@ const path = require('path');
 const os = require('os');
 const { execSync } = require('child_process');
 
-const VERSION = '2.0.0-beta.6';
+const VERSION = '2.0.0';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {
@@ -3840,8 +3857,13 @@ function getDiffFiles(cwd, stagedOnly) {
 }
 
 function getFilesChangedSinceBase(cwd, baseRef) {
+  if (!/^[A-Za-z0-9._/\-~^]+$/.test(baseRef)) {
+    console.warn(`[sigmap] --diff: invalid base ref '${baseRef}'`);
+    return new Set();
+  }
   try {
-    const out = execSync(`git diff ${baseRef}..HEAD --name-only`, {
+    const { execFileSync } = require('child_process');
+    const out = execFileSync('git', ['diff', `${baseRef}..HEAD`, '--name-only'], {
       cwd, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
     });
     return new Set(out.split('\n').map((f) => f.trim()).filter(Boolean).map((f) => path.resolve(cwd, f)));
@@ -3858,7 +3880,8 @@ function buildDiffSectionFromBase(cwd, baseRef, currentEntries, config) {
     const rel = path.relative(cwd, entry.filePath);
     let baseSrc = '';
     try {
-      baseSrc = execSync(`git show ${baseRef}:"${rel}" 2>/dev/null`, {
+      const { execFileSync } = require('child_process');
+      baseSrc = execFileSync('git', ['show', `${baseRef}:${rel}`], {
         cwd, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
       });
     } catch (_) {

package/package.json

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

package/src/config/defaults.js

@@ -72,15 +72,9 @@ const DEFAULTS = {
     autoRegister: true,
   },
 
-  // Enrich signatures with return types, type hints, and schema field collapse
-  enrichSignatures: true,
-
   // Include a compact import dependency map at top of output
   depMap: true,
 
-  // Collapse Pydantic BaseModel / @dataclass fields to a single line
-  schemaFields: true,
-
   // Include TODO/FIXME/HACK/XXX comments as compact section
   todos: true,
 

package/src/extractors/coverage.js

@@ -35,11 +35,11 @@ function buildTestIndex(cwd, testDirs) {
       }
 
       for (const m of src.matchAll(/\b(?:test_|it\(|test\(|describe\()\s*['"`]?([\w_]+)/g)) {
-        if (m[1]) names.add(m[1].toLowerCase());
+        if (m[1] && m[1].length >= 3) names.add(m[1].toLowerCase());
       }
 
       for (const m of src.matchAll(/\b([a-zA-Z_][a-zA-Z0-9_]*)\b/g)) {
-        if (m[1]) names.add(m[1].toLowerCase());
+        if (m[1] && m[1].length >= 4) names.add(m[1].toLowerCase());
       }
     }
   }
@@ -48,12 +48,9 @@ function buildTestIndex(cwd, testDirs) {
 }
 
 function isTested(funcName, testIndex) {
-  if (!funcName || !testIndex || testIndex.size === 0) return false;
+  if (!funcName || funcName.length < 3 || !testIndex || testIndex.size === 0) return false;
   const lower = funcName.toLowerCase();
   if (testIndex.has(lower) || testIndex.has(`test_${lower}`)) return true;
-  for (const token of testIndex) {
-    if (token.includes(lower)) return true;
-  }
   return false;
 }
 

package/src/mcp/server.js

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