feat: SigMap v2.0.0 — v2 pipeline, new extractors, docs alignment (#2)

* feat: add FastAPI router, Zustand store, and API object extraction

- python.js: detect @router.METHOD decorators → produce GET/POST/... → fn() sigs
- typescript.js: detect create<State>() stores with field listing
- typescript.js: detect xxxApi = { method: async => } objects
- Both: raise sigs slice limit (python 25→30, ts 25→35)
- gen-context.js: sync bundle with same changes

* feat: SigMap v2.0.0 — v2 pipeline, new extractors, docs alignment

Major release featuring:

Pipeline:
- New v2 context sections: TODOs, Recent changes, Coverage gaps, PR diff
- Dependency extractors for Python (import/from) and TypeScript (import/require)

Extractor fixes:
- Python: BaseModel field bleed across classes
- TypeScript: union type truncation (slice 35)
- TypeScript: function-style hook shape detection

Docs & release prep:
- All version surfaces bumped to 2.0.0
- README: v2 What's New section, updated project structure, 262 test badge
- CHANGELOG: consolidated beta entries into single 2.0.0 entry
- All 6 HTML docs pages updated (footers, meta, badges)
- Roadmap: added v2.0 timeline entry
- Branding: ContextForge → SigMap across .npmignore, config example, CI guide
- Removed 8 stale files (TIMELINE.md, standalone bundle, scripts, examples)

Tests: 21/21 extractors + 17/17 integration suites (262 total)

* fix: address all 9 Copilot review comments

- Fix bundled BaseModel field bleed (add foundFirst boundary logic)
- Fix bundled TS interface property slice(0,20) → slice(0,35)
- Fix command injection in --diff: validate baseRef, use execFileSync
- Add buildReverseDepMap to bundled deps.js exports
- Tighten coverage heuristic: min token length, exact match only
- Remove unused enrichSignatures/schemaFields from defaults + config example
- Fix README: v2 features are default-on, not opt-in
- Fix roadmap.html og:description: 17 versions, 262 tests
- Regenerate copilot-instructions.md with v2.0.0 header

Author: manojmallick

.github/copilot-instructions.md

@@ -1,5 +1,6 @@
 CLAUDE.md
-TIMELINE.md
 PROJECT_MAP.md
 gen-context.standalone.js
 package.json.bak
+node_modules/
+.context/

.gitignore

@@ -1,4 +1,4 @@
-# ContextForge — files excluded from npm publish
+# SigMap — files excluded from npm publish
 # Only gen-context.js, gen-project-map.js, src/, README.md, LICENSE, CHANGELOG.md,
 # .contextignore.example, and gen-context.config.json.example are published.
 

.npmignore

@@ -6,6 +6,39 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [2.0.0] — 2026-04-04
+
+### 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
+- **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 `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
+- 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
 
 ### Added
@@ -32,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)*

CHANGELOG.md

@@ -6,7 +6,8 @@
 2. Create `test/fixtures/{language}.{ext}` with representative code
 3. Run `node test/run.js --update {language}` to generate expected output
 4. Review the expected output — it should contain only signatures, no bodies
-5. Run `node test/run.js` — must be 177/177 PASS (21 extractor + 156 integration) before opening a PR
+5. Run `node test/run.js` — must be 21/21 PASS before opening a PR
+6. Run `node test/integration/all.js` — 17/17 integration suites must pass
 
 ## Extractor contract
 

CONTRIBUTING.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
@@ -426,8 +443,8 @@ node test/run.js typescript
 # Regenerate expected outputs after extractor changes
 node test/run.js --update
 
-# Full integration suite (253 tests across 16 test files)
-for f in test/integration/*.test.js; do node "$f"; done
+# Full integration suite
+node test/integration/all.js
 ```
 
 ### Validation gates
@@ -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