Skip to content

Commit 8ddafee

Browse files
committed
chore: rename context-forge → sigmap
- npm package: context-forge → sigmap - bin alias: context-forge → sigmap (gen-context kept for backward compat) - brand: ContextForge → SigMap everywhere - log prefix: [context-forge] → [sigmap] - GitHub repo URLs: manojmallick/context-forge → manojmallick/sigmap - GitHub Pages URL: manojmallick.github.io/context-forge → manojmallick.github.io/sigmap - VS Code extension id: context-forge → sigmap, command prefix: contextforge. → sigmap. - docs/_config.yml baseurl: /context-forge → /sigmap - 52 files updated, all 21 extractor tests passing - gen-context.js filename unchanged (backward compat) - gen-context.config.json unchanged (backward compat for existing users) - .contextignore unchanged (functional name, not brand)
1 parent c150d6f commit 8ddafee

52 files changed

Lines changed: 454 additions & 454 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/copilot-instructions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- Generated by ContextForge gen-context.js v1.0.0 -->
1+
<!-- Generated by SigMap gen-context.js v1.0.0 -->
22
<!-- DO NOT EDIT below the marker line — run gen-context.js to regenerate -->
33

44
# Code signatures

CHANGELOG.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Changelog
22

3-
All notable changes to ContextForge are documented here.
3+
All notable changes to SigMap are documented here.
44

55
Format: [Semantic Versioning](https://semver.org/)
66

@@ -11,8 +11,8 @@ Format: [Semantic Versioning](https://semver.org/)
1111
### Added
1212
- **VS Code extension** (`vscode-extension/`) — zero-dependency extension for VS Code / VS Code-compatible editors:
1313
- **Status bar item** — shows health grade (A/B/C/D) and time since last regeneration; refreshes every 60 s and immediately on file-system change to `copilot-instructions.md`.
14-
- **`ContextForge: Regenerate Context`** command — runs `node gen-context.js` in an integrated terminal from the workspace root.
15-
- **`ContextForge: Open Context File`** command — opens `.github/copilot-instructions.md` in the editor.
14+
- **`SigMap: Regenerate Context`** command — runs `node gen-context.js` in an integrated terminal from the workspace root.
15+
- **`SigMap: Open Context File`** command — opens `.github/copilot-instructions.md` in the editor.
1616
- **Stale context notification** — warns when `copilot-instructions.md` is > 24 h old; offers one-click regeneration or "Don't show again" suppression per workspace.
1717
- **`contextforge.scriptPath` setting** — override the path to `gen-context.js` when it is not at the project root.
1818
- `onStartupFinished` activation — loads within 3 s of VS Code opening, does not block startup.
@@ -126,7 +126,7 @@ Format: [Semantic Versioning](https://semver.org/)
126126
- `per-module`: asserts one `context-<module>.md` per `srcDir`, overview file references all modules, cross-module signature isolation
127127
- `hot-cold`: asserts `context-cold.md` is created, primary output contains only hot files, `hotCommits` config controls the boundary
128128
- Both strategies: fallback behaviour when `srcDir` is missing or repo has no git history
129-
- **`context-forge` npm binary alias**`package.json` `bin` now exposes both `gen-context` (existing) and `context-forge` (new alias), making `npx context-forge` work ahead of full npm publish in v1.5
129+
- **`sigmap` npm binary alias**`package.json` `bin` now exposes both `gen-context` (existing) and `sigmap` (new alias), making `npx sigmap` work ahead of full npm publish in v1.5
130130
- **`--diff` and `--diff --staged` listed in `--help`** — help text documents the upcoming flags so tooling auto-complete picks them up
131131

132132
### Changed
@@ -237,7 +237,7 @@ Format: [Semantic Versioning](https://semver.org/)
237237
- **`--format cache` CLI flag** — alongside the standard markdown output, writes `.github/copilot-instructions.cache.json`, a single Anthropic content block with `cache_control: { type: "ephemeral" }` ready for direct use in Anthropic API calls
238238
- **`src/format/cache.js`** — zero-dependency formatter; exports `formatCache(content) → JSON string` (single content block) and `formatCachePayload(content, model) → JSON string` (full messages API payload with system array)
239239
- **`format: 'default'` config key** — set `"format": "cache"` in `gen-context.config.json` to always write the cache JSON file on every run; default is `'default'` (markdown only)
240-
- **`docs/REPOMIX_CACHE.md`** — full prompt cache strategy: two-layer design (Repomix as stable cached prefix + ContextForge as dynamic segment), cost calculations (~60% reduction), API call examples, CI integration, cache warm-up strategy
240+
- **`docs/REPOMIX_CACHE.md`** — full prompt cache strategy: two-layer design (Repomix as stable cached prefix + SigMap as dynamic segment), cost calculations (~60% reduction), API call examples, CI integration, cache warm-up strategy
241241
- Integration test: `test/integration/cache.test.js` — 20 tests covering `formatCache()`, `formatCachePayload()`, CLI `--format cache` flag, config-driven mode, and absence of cache file when flag is not set
242242

243243
### Changed
@@ -292,7 +292,7 @@ Format: [Semantic Versioning](https://semver.org/)
292292

293293
### Validation gate
294294
- 94/94 tests pass (21 extractor + 73 integration)
295-
- `create_checkpoint` MCP tool returns JSON with `# ContextForge Checkpoint` header
295+
- `create_checkpoint` MCP tool returns JSON with `# SigMap Checkpoint` header
296296
- `create_checkpoint` with `note` param includes note in output
297297
- `tools/list` returns 4 tools including `create_checkpoint`
298298
- VS Code snippets file has JSON-valid syntax; `cf-` prefix on all 20 snippets
@@ -306,7 +306,7 @@ Format: [Semantic Versioning](https://semver.org/)
306306
- Manifest detection covers `package.json`, `Cargo.toml`, `go.mod`, `pyproject.toml`, `pom.xml`, `build.gradle`
307307
- `config.monorepo: true` triggers monorepo mode without the CLI flag
308308
- **Git-diff priority output ordering** — recently committed files now appear first in the generated output (not just protected from token-budget drops)
309-
- `examples/github-action.yml` — ready-to-use 4-job CI workflow: ContextForge, gen-project-map, Repomix, test suite (Node 18/20/22 matrix)
309+
- `examples/github-action.yml` — ready-to-use 4-job CI workflow: SigMap, gen-project-map, Repomix, test suite (Node 18/20/22 matrix)
310310
- `docs/CI_GUIDE.md` — full CI setup guide, monorepo config, `.contextignore` patterns, token report in CI
311311
- Integration test: `test/integration/monorepo.test.js` — 8 tests (packages/, apps/, services/, multi-manifest, 5-package smoke)
312312
- Integration test: `test/integration/contextignore.test.js` — 7 tests (patterns, wildcards, comments, union of both ignore files)
@@ -345,7 +345,7 @@ Format: [Semantic Versioning](https://semver.org/)
345345
- `src/mcp/handlers.js` — tool implementations; reads context files from disk on every call (no in-memory state)
346346
- `--mcp` CLI flag — starts MCP server on stdio
347347
- MCP auto-registration in `.claude/settings.json` and `.cursor/mcp.json` via `--setup`
348-
- `examples/claude-code-settings.json` — pre-configured entry for both ContextForge and Repomix MCP servers
348+
- `examples/claude-code-settings.json` — pre-configured entry for both SigMap and Repomix MCP servers
349349
- `docs/MCP_SETUP.md` — full MCP setup guide with both Claude Code and Cursor examples
350350
- Integration test: `test/integration/mcp-server.test.js` — 11 tests
351351

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Contributing to ContextForge
1+
# Contributing to SigMap
22

33
## Adding a language extractor
44

README.md

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<div align="center">
22

3-
<h1>⚡ ContextForge</h1>
3+
<h1>⚡ SigMap</h1>
44

55
<p><strong>Zero-dependency AI context engine — 97% token reduction</strong></p>
66

@@ -10,19 +10,19 @@
1010
</p>
1111

1212
<!-- Status -->
13-
[![GitHub release](https://img.shields.io/github/v/release/manojmallick/context-forge?color=7c6af7&label=latest)](https://github.com/manojmallick/context-forge/releases)
14-
[![Tests](https://img.shields.io/badge/tests-274%20passing-22c55e)](https://github.com/manojmallick/context-forge/tree/main/test)
13+
[![GitHub release](https://img.shields.io/github/v/release/manojmallick/sigmap?color=7c6af7&label=latest)](https://github.com/manojmallick/sigmap/releases)
14+
[![Tests](https://img.shields.io/badge/tests-274%20passing-22c55e)](https://github.com/manojmallick/sigmap/tree/main/test)
1515
[![Zero deps](https://img.shields.io/badge/dependencies-zero-22c55e)](package.json)
16-
[![Last commit](https://img.shields.io/github/last-commit/manojmallick/context-forge?color=7c6af7)](https://github.com/manojmallick/context-forge/commits/main)
16+
[![Last commit](https://img.shields.io/github/last-commit/manojmallick/sigmap?color=7c6af7)](https://github.com/manojmallick/sigmap/commits/main)
1717

1818
<!-- Meta -->
1919
[![License: MIT](https://img.shields.io/badge/License-MIT-7c6af7.svg)](LICENSE)
2020
[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
21-
[![npm](https://img.shields.io/badge/npm-context--forge-cb3837?logo=npm)](https://www.npmjs.com/package/context-forge)
22-
[![GitHub Stars](https://img.shields.io/github/stars/manojmallick/context-forge?style=flat&color=f59e0b&logo=github)](https://github.com/manojmallick/context-forge/stargazers)
21+
[![npm](https://img.shields.io/badge/npm-context--forge-cb3837?logo=npm)](https://www.npmjs.com/package/sigmap)
22+
[![GitHub Stars](https://img.shields.io/github/stars/manojmallick/sigmap?style=flat&color=f59e0b&logo=github)](https://github.com/manojmallick/sigmap/stargazers)
2323

2424
<!-- Links -->
25-
[![Docs](https://img.shields.io/badge/docs-live-7c6af7?logo=github-pages)](https://manojmallick.github.io/context-forge)
25+
[![Docs](https://img.shields.io/badge/docs-live-7c6af7?logo=github-pages)](https://manojmallick.github.io/sigmap)
2626
[![Changelog](https://img.shields.io/badge/changelog-CHANGELOG.md-blue)](CHANGELOG.md)
2727
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
2828
[![VS Code](https://img.shields.io/badge/VS%20Code-extension-0078d4?logo=visual-studio-code)](vscode-extension/)
@@ -52,7 +52,7 @@
5252

5353
## 🔍 What it does
5454

55-
ContextForge scans your source files and extracts only the **function and class signatures** — no bodies, no imports, no comments — then writes a compact context file that Copilot, Claude, Cursor, and Windsurf read automatically. Every session starts with full codebase awareness at a fraction of the token cost.
55+
SigMap scans your source files and extracts only the **function and class signatures** — no bodies, no imports, no comments — then writes a compact context file that Copilot, Claude, Cursor, and Windsurf read automatically. Every session starts with full codebase awareness at a fraction of the token cost.
5656

5757
```
5858
Your codebase
@@ -73,8 +73,8 @@ AI agent session starts with full context
7373
|---|---:|---:|
7474
| Raw source files | ~80,000 ||
7575
| Repomix compressed | ~8,000 | 90% |
76-
| **ContextForge signatures** | **~4,000** | **95%** |
77-
| ContextForge + MCP (`hot-cold`) | ~200 | **99.75%** |
76+
| **SigMap signatures** | **~4,000** | **95%** |
77+
| SigMap + MCP (`hot-cold`) | ~200 | **99.75%** |
7878

7979
> **97% fewer tokens. The same codebase understanding.**
8080
@@ -86,7 +86,7 @@ AI agent session starts with full context
8686

8787
```bash
8888
# 1. Copy gen-context.js into your project root
89-
curl -O https://raw.githubusercontent.com/manojmallick/context-forge/main/gen-context.js
89+
curl -O https://raw.githubusercontent.com/manojmallick/sigmap/main/gen-context.js
9090

9191
# 2. Generate your context file
9292
node gen-context.js
@@ -98,9 +98,9 @@ node gen-context.js
9898
Or via npm (globally):
9999

100100
```bash
101-
npx context-forge # run once without installing
102-
npm install -g context-forge # install globally
103-
context-forge # then use anywhere
101+
npx sigmap # run once without installing
102+
npm install -g sigmap # install globally
103+
sigmap # then use anywhere
104104
```
105105

106106
### Common workflows
@@ -117,19 +117,19 @@ node gen-context.js --mcp # start MCP server on stdio
117117

118118
### Companion tool: Repomix
119119

120-
ContextForge and [Repomix](https://github.com/yamadashy/repomix) are **complementary, not competing**:
120+
SigMap and [Repomix](https://github.com/yamadashy/repomix) are **complementary, not competing**:
121121

122122
| Tool | When to use |
123123
|---|---|
124-
| **ContextForge** | Always-on, git hooks, daily signature index (~4K tokens) |
124+
| **SigMap** | Always-on, git hooks, daily signature index (~4K tokens) |
125125
| **Repomix** | On-demand deep sessions, full file content, broader language support |
126126

127127
```bash
128128
node gen-context.js --setup # always-on context
129129
npx repomix --compress # deep dive sessions
130130
```
131131

132-
*"ContextForge for daily always-on context; Repomix for deep one-off sessions — use both."*
132+
*"SigMap for daily always-on context; Repomix for deep one-off sessions — use both."*
133133

134134
---
135135

@@ -143,8 +143,8 @@ The `vscode-extension/` directory contains a first-party VS Code extension that
143143
|---|---|
144144
| **Status bar item** | Shows health grade (`A`/`B`/`C`/`D`) + time since last regen; refreshes every 60 s |
145145
| **Stale notification** | Warns when `copilot-instructions.md` is > 24 h old; one-click regeneration |
146-
| **Regenerate command** | `ContextForge: Regenerate Context` — runs `node gen-context.js` in the integrated terminal |
147-
| **Open context command** | `ContextForge: Open Context File` — opens `.github/copilot-instructions.md` |
146+
| **Regenerate command** | `SigMap: Regenerate Context` — runs `node gen-context.js` in the integrated terminal |
147+
| **Open context command** | `SigMap: Open Context File` — opens `.github/copilot-instructions.md` |
148148
| **Script path setting** | `contextforge.scriptPath` — override when `gen-context.js` is not at the project root |
149149

150150
Activate on startup (`onStartupFinished`) — loads within 3 s, never blocks editor startup.
@@ -311,7 +311,7 @@ Tiers: `fast` (config/markup/typos) · `balanced` (features/tests/debug) · `pow
311311

312312
## 🔒 Security scanning
313313

314-
ContextForge automatically redacts secrets from all extracted signatures. Ten patterns are checked on every file:
314+
SigMap automatically redacts secrets from all extracted signatures. Ten patterns are checked on every file:
315315

316316
| Pattern | Example match |
317317
|---|---|
@@ -392,7 +392,7 @@ Copy `examples/self-healing-github-action.yml` to `.github/workflows/` to auto-r
392392
- Copilot acceptance rate drops below 30% (requires `COPILOT_API_TOKEN` — GitHub Enterprise)
393393

394394
```yaml
395-
- name: ContextForge health check
395+
- name: SigMap health check
396396
run: node gen-context.js --health --json
397397
- name: Regenerate context
398398
run: node gen-context.js
@@ -453,7 +453,7 @@ npm pack --dry-run
453453
## 📁 Project structure
454454

455455
```
456-
context-forge/
456+
sigmap/
457457
458458
├── gen-context.js ← PRIMARY ENTRY POINT — single file, zero deps
459459
├── gen-project-map.js ← import graph, class hierarchy, route table
@@ -508,7 +508,7 @@ context-forge/
508508
| **Zero npm dependencies** | `node gen-context.js` on a blank machine with Node 18+ — nothing else required |
509509
| **Never throw** | All extractors return `[]` on any error — the run always completes |
510510
| **Deterministic** | No AI or LLM involved in extraction — only regex + Node built-ins |
511-
| **Repomix is a companion** | Use both tools; ContextForge never replaces Repomix |
511+
| **Repomix is a companion** | Use both tools; SigMap never replaces Repomix |
512512
| **No telemetry** | Never phones home; all state is files in your repo |
513513
| **Local-first** | No cloud service, no database, no accounts |
514514

@@ -524,7 +524,7 @@ Releases are published automatically via GitHub Actions whenever a version tag i
524524

525525
2. **Generate an npm access token**:
526526
- npmjs.com → Account → Access Tokens → Generate New Token → **Granular Access Token** (or Classic Automation token)
527-
- Scope: `context-forge` package, permission: **Read and Write**
527+
- Scope: `sigmap` package, permission: **Read and Write**
528528

529529
3. **Add the secret to GitHub**:
530530
```
@@ -565,7 +565,7 @@ export NPM_TOKEN=npm_xxxxxxxxxxxx
565565
./scripts/backfill-npm.sh --publish --from v0.5.0
566566
```
567567

568-
The script assigns `dist-tag: legacy` to all versions except `v1.5.0` (which gets `latest`), so `npm install context-forge` always resolves to the current release.
568+
The script assigns `dist-tag: legacy` to all versions except `v1.5.0` (which gets `latest`), so `npm install sigmap` always resolves to the current release.
569569

570570
---
571571

@@ -594,8 +594,8 @@ MIT © 2026 [Manoj Mallick](https://github.com/manojmallick)
594594

595595
<div align="center">
596596

597-
If ContextForge saves you time — a ⭐ on [GitHub](https://github.com/manojmallick/context-forge) helps others find it.
597+
If SigMap saves you time — a ⭐ on [GitHub](https://github.com/manojmallick/sigmap) helps others find it.
598598

599-
**[Docs](https://manojmallick.github.io/context-forge) · [Changelog](CHANGELOG.md) · [Roadmap](docs/roadmap.html) · [Repomix](https://github.com/yamadashy/repomix)**
599+
**[Docs](https://manojmallick.github.io/sigmap) · [Changelog](CHANGELOG.md) · [Roadmap](docs/roadmap.html) · [Repomix](https://github.com/yamadashy/repomix)**
600600

601601
</div>

0 commit comments

Comments
 (0)