v0.0 → v1.5

Measure the problem. Install Repomix, create .repomixignore, measure token consumption before any optimisation. This is the number we spend every version beating.

The first version that matters. A single file — gen-context.js — with all 21 language extractors inline. Zero npm dependencies. Runs on any machine with Node.js 18+. Writes .github/copilot-instructions.md. Installs a post-commit git hook via --setup.

Secret scanning blocks AWS keys, GitHub tokens, database connection strings, and 10 other credential patterns from ever appearing in the output. The .contextignore file (gitignore syntax) lets teams exclude generated code, test fixtures, and vendor directories. Token budget enforcement with a defined drop order.

A JSON-RPC stdio server implementing the Model Context Protocol. Three tools: read_context (pull signatures for any module on demand), search_signatures (keyword search across all signatures), get_map (structural sections). The MCP server reads files on every call — no stale state, no restart needed.

gen-project-map.js produces PROJECT_MAP.md with three structural views: an import graph showing every file dependency, a class hierarchy showing extends/implements relationships, and a route table extracting HTTP routes from Express, FastAPI, Rails, and similar frameworks.

Monorepo mode generates a separate context file per package — agents working on one service don't receive signatures from all others. The GitHub Action runs on every push and PR, fails CI if token budget is exceeded, and posts a reduction report as a PR comment.

A session compression guide (SESSION_DISCIPLINE.md) that codifies how agents should summarise conversations, checkpoint progress, and restart from a minimal state. The --track flag logs every run to .sigmap/runs.jsonl for monitoring. Reduces per-conversation token cost by 40%.

A file complexity scorer classifies every file as fast (simple CRUD, 0.33× cost), balanced (business logic, 1× cost), or powerful (architecture decisions, 3× cost). The routing table is appended to the context file. Agents use the fast-tier model for 70% of tasks — the ones that don't need powerful reasoning.

The --format cache flag wraps context in Anthropic's cache_control breakpoints. The stable codebase signatures become a cached prefix — the most expensive tokens are computed once and reused across every request in a session. The 60% API cost reduction compounds with the model routing savings from v0.7.

The --report --json flag emits a machine-readable token reduction JSON suitable for CI dashboards and custom monitoring. An ENTERPRISE_SETUP.md consolidates all enterprise configuration. 23 new integration tests bring total coverage to 177 passing tests.

The complete SigMap system. Self-healing CI auto-regenerates the context file when it drifts. The --health flag gives a composite 0–100 score for context freshness, reduction quality, and over-budget run rate. The --suggest-tool flag classifies any task description into fast / balanced / powerful model tiers. All 177 tests pass.

Three output strategies for different workflows. full (default) — one file, all signatures, always injected. per-module — one file per source directory plus a tiny always-on overview (~100–300 tokens); ~70% fewer injected tokens with zero context loss. hot-cold — recently committed files auto-injected (~200–800 tokens); everything else written to a cold file for MCP on-demand retrieval; ~90% fewer always-on tokens when using Claude Code or Cursor with MCP enabled.

Added sigmap npm binary alias alongside gen-context so npx sigmap works from any machine without cloning the repo. Improved --init to scaffold both gen-context.config.json and .contextignore in one step. Added 9 integration tests covering per-module and hot-cold strategy edge cases.

The --diff flag generates context only for files changed in the current git working tree — ideal for PR reviews and CI. --diff --staged restricts to staged files only, making it a perfect pre-commit check. Both modes auto-fall-back to full generate when outside a git repository or when no files have changed. Watch mode debounce is now configurable via watchDebounce in config.

Two new MCP tools: explain_file returns signatures, resolved imports, and reverse callers for any file in a single call — agents get full file context without guessing paths. list_modules returns a token-count table of all top-level module directories so agents know where to look before calling read_context. Strategy-aware health scorer no longer penalises hot-cold or per-module runs for low reduction — intentionally small outputs score correctly. MCP server now exposes 7 tools total.

A zero-dependency VS Code extension shows a status bar item displaying the health grade and time since last regeneration (refreshes every 60 s). It warns when context is stale (>24 h), adds Regenerate Context and Open Context File commands, and supports a configurable script path. All six HTML documentation pages gained client-side keyword search (press / to open). A proper .npmignore prepares the package for npm publish — npx sigmap resolves to the runtime-only artifact.