Skip to content

Commit eb06db1

Browse files
committed
docs: finalize strategy documentation across guides and site
1 parent 9985490 commit eb06db1

8 files changed

Lines changed: 53 additions & 21 deletions

File tree

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
2. Create `test/fixtures/{language}.{ext}` with representative code
77
3. Run `node test/run.js --update {language}` to generate expected output
88
4. Review the expected output — it should contain only signatures, no bodies
9-
5. Run `node test/run.js` — must be 21/21 PASS before opening a PR
9+
5. Run `node test/run.js` — must be 177/177 PASS (21 extractor + 156 integration) before opening a PR
1010

1111
## Extractor contract
1212

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ npx repomix --compress # deep dive sessions
5757

5858
---
5959

60-
## Languages supported (v0.1)
60+
## Languages supported
6161

6262
| Language | Extensions |
6363
|---|---|
@@ -301,7 +301,7 @@ node test/run.js --update # regenerate expected outputs
301301
```bash
302302
# Gate 1: all tests pass
303303
node test/run.js
304-
# Expected: 21/21 PASS
304+
# Expected: 177/177 PASS (21 extractor + 156 integration)
305305

306306
# Gate 2: no external imports
307307
grep "require(" gen-context.js | grep -v "^.*//.*require"

docs/index.html

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -151,7 +151,8 @@
151151
<div class="nav-links">
152152
<a href="#how-it-works" class="hide-sm">How it works</a>
153153
<a href="strategies.html" class="hide-sm">Strategies</a>
154-
<a href="#languages" class="hide-sm">Languages</a>
154+
<a href="languages.html" class="hide-sm">Languages</a>
155+
<a href="roadmap.html" class="hide-sm">Roadmap</a>
155156
<a href="#quick-start" class="hide-sm">Quick start</a>
156157
<a href="https://github.com/manojmallick/context-forge" class="nav-gh" target="_blank">★ GitHub</a>
157158
</div>
@@ -248,7 +249,7 @@ <h3>Stay current automatically</h3>
248249
<tr>
249250
<td><strong>ContextForge</strong></td>
250251
<td><div class="bar-cell"><div class="mini-bar"><div class="mini-fill" style="width:5%;background:var(--g)"></div></div><span class="best">~4,000</span></div></td>
251-
<td class="best">95%</td>
252+
<td class="best">97%</td>
252253
<td class="best">~$0.012</td>
253254
</tr>
254255
<tr>
@@ -412,12 +413,14 @@ <h2>Built for the community</h2>
412413
<span class="footer-logo">context-forge</span>
413414
<div class="footer-links">
414415
<a href="strategies.html">Strategies</a>
416+
<a href="languages.html">Languages</a>
417+
<a href="roadmap.html">Roadmap</a>
415418
<a href="https://github.com/manojmallick/context-forge">GitHub</a>
416419
<a href="https://github.com/manojmallick/context-forge/blob/main/CONTRIBUTING.md">Contributing</a>
417420
<a href="https://github.com/manojmallick/context-forge/blob/main/CHANGELOG.md">Changelog</a>
418421
<a href="https://github.com/yamadashy/repomix">Repomix ↗</a>
419422
</div>
420-
<span class="footer-mit">MIT © 2026 Manoj Kumar</span>
423+
<span class="footer-mit">MIT © 2026 Manoj Mallick</span>
421424
</div>
422425
</footer>
423426

docs/languages.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -599,7 +599,7 @@ <h2>Contributing is simple</h2>
599599
<a href="https://github.com/manojmallick/context-forge/blob/main/CHANGELOG.md">Changelog</a>
600600
<a href="repomix.html">Repomix</a>
601601
</div>
602-
<span class="footer-mit">MIT © 2026 Manoj Kumar</span>
602+
<span class="footer-mit">MIT © 2026 Manoj Mallick</span>
603603
</div>
604604
</footer>
605605

docs/quick-start.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -457,24 +457,24 @@ <h2>Explore further</h2>
457457
<div class="next-card-desc">Stack both tools for the two-layer caching strategy. ContextForge for daily; Repomix for deep sessions.</div>
458458
</a>
459459
<a class="next-card" href="roadmap.html">
460-
<div class="next-card-ey">v0.1 → v1.0</div>
460+
<div class="next-card-ey">v0.1 → v1.1</div>
461461
<div class="next-card-title">Full roadmap</div>
462-
<div class="next-card-desc">All 11 versions shipped. 97% token reduction. 177 tests. MIT license.</div>
462+
<div class="next-card-desc">All 12 versions shipped. 97% token reduction. 177 tests. MIT license.</div>
463463
</a>
464464
</div>
465465
</section>
466466

467467
<footer>
468468
<div class="footer-inner">
469-
<span class="footer-logo">context-forge v1.0.0</span>
469+
<span class="footer-logo">context-forge v1.1.0</span>
470470
<div class="footer-links">
471471
<a href="strategies.html">Strategies</a>
472472
<a href="https://github.com/manojmallick/context-forge">GitHub</a>
473473
<a href="https://github.com/manojmallick/context-forge/blob/main/CONTRIBUTING.md">Contributing</a>
474474
<a href="https://github.com/manojmallick/context-forge/blob/main/CHANGELOG.md">Changelog</a>
475475
<a href="repomix.html">Repomix</a>
476476
</div>
477-
<span class="footer-mit">MIT © 2026 Manoj Kumar</span>
477+
<span class="footer-mit">MIT © 2026 Manoj Mallick</span>
478478
</div>
479479
</footer>
480480

docs/repomix.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -498,7 +498,7 @@ <h2>Both tools, five minutes</h2>
498498
<a href="https://github.com/manojmallick/context-forge/blob/main/CHANGELOG.md">Changelog</a>
499499
<a href="repomix.html">Repomix</a>
500500
</div>
501-
<span class="footer-mit">MIT © 2026 Manoj Kumar</span>
501+
<span class="footer-mit">MIT © 2026 Manoj Mallick</span>
502502
</div>
503503
</footer>
504504

docs/roadmap.html

Lines changed: 37 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@
44
<meta charset="UTF-8">
55
<meta name="viewport" content="width=device-width,initial-scale=1.0">
66
<title>Roadmap — ContextForge</title>
7-
<meta name="description" content="ContextForge shipped v0.1 through v1.011 versions, 97% token reduction, 177 tests. Full visual timeline from baseline to complete system.">
8-
<meta property="og:title" content="ContextForge Roadmap — v0.1 to v1.0 complete">
7+
<meta name="description" content="ContextForge shipped v0.1 through v1.112 versions, 97% token reduction, 177 tests. Full visual timeline from baseline to complete system.">
8+
<meta property="og:title" content="ContextForge Roadmap — v0.1 to v1.1 complete">
99
<meta property="og:description" content="11 versions shipped. 97% token reduction. 177 tests. MIT license. See how ContextForge was built from first extractor to full enterprise system.">
1010
<meta property="og:url" content="https://manojmallick.github.io/context-forge/roadmap.html">
1111
<meta name="twitter:card" content="summary_large_image">
@@ -119,8 +119,8 @@
119119
<div class="page-hero">
120120
<div class="hero-inner">
121121
<div class="hero-badge"><span class="dot"></span>All versions complete</div>
122-
<h1>v0.0 → v1.0</h1>
123-
<p class="hero-sub">Eleven versions. Every one shipped. MIT open source from day one.</p>
122+
<h1>v0.0 → v1.1</h1>
123+
<p class="hero-sub">Twelve versions. Every one shipped. MIT open source from day one.</p>
124124
<div class="hero-stats">
125125
<div class="hstat"><span class="hstat-val p">97%</span><span class="hstat-lbl">Token reduction</span></div>
126126
<div class="hstat"><span class="hstat-val g">177</span><span class="hstat-lbl">Tests passing</span></div>
@@ -175,6 +175,11 @@ <h2>Reduction by version</h2>
175175
<div class="tp-bar-bg"><div class="tp-bar" style="width:4%;background:var(--p)"></div></div>
176176
<div class="tp-val" style="color:var(--pd)">97% total</div>
177177
</div>
178+
<div class="tp-row">
179+
<div class="tp-ver">v1.1</div>
180+
<div class="tp-bar-bg"><div class="tp-bar" style="width:1%;background:var(--p)"></div></div>
181+
<div class="tp-val" style="color:var(--pd)">~200 always-on</div>
182+
</div>
178183
</div>
179184
</section>
180185

@@ -427,14 +432,15 @@ <h2>Every version, every feature</h2>
427432
<div class="tl-item">
428433
<div class="tl-rail">
429434
<div class="tl-dot done" style="background:rgba(124,106,247,.2);border-color:var(--p);color:var(--pd);font-size:10px">v1.0</div>
435+
<div class="tl-line"></div>
430436
</div>
431437
<div class="tl-content">
432438
<div class="tl-header">
433439
<span class="tl-version" style="background:linear-gradient(135deg,var(--t1),var(--pd));-webkit-background-clip:text;-webkit-text-fill-color:transparent">v1.0</span>
434440
<span class="tl-name">Full system</span>
435441
<span class="tl-badge done">✓ Complete — tagged v1.0.0</span>
436442
</div>
437-
<div class="tl-desc">The complete ContextForge system. Self-healing CI auto-regenerates the context file when it drifts. The --health flag runs all 21 extractor checks and reports any failures. The --suggest-tool flag recommends which MCP tool to use for the current task. All 177 tests pass. The 97% token reduction is now stable across languages, repo sizes, and CI environments.</div>
443+
<div class="tl-desc">The complete ContextForge 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.</div>
438444
<div class="tl-tags">
439445
<span class="tl-tag">self-healing CI</span>
440446
<span class="tl-tag">--health</span>
@@ -446,14 +452,37 @@ <h2>Every version, every feature</h2>
446452
</div>
447453
</div>
448454

455+
<!-- v1.1 -->
456+
<div class="tl-item">
457+
<div class="tl-rail">
458+
<div class="tl-dot done" style="background:rgba(124,106,247,.2);border-color:var(--p);color:var(--pd);font-size:10px">v1.1</div>
459+
</div>
460+
<div class="tl-content">
461+
<div class="tl-header">
462+
<span class="tl-version" style="background:linear-gradient(135deg,var(--t1),var(--pd));-webkit-background-clip:text;-webkit-text-fill-color:transparent">v1.1</span>
463+
<span class="tl-name">Context strategies</span>
464+
<span class="tl-badge done">✓ Complete — tagged v1.1.0</span>
465+
</div>
466+
<div class="tl-desc">Three output strategies for different workflows. <strong>full</strong> (default) — one file, all signatures, always injected. <strong>per-module</strong> — one file per source directory plus a tiny always-on overview (~100–300 tokens); ~70% fewer injected tokens with zero context loss. <strong>hot-cold</strong> — 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.</div>
467+
<div class="tl-tags">
468+
<span class="tl-tag">strategy: full</span>
469+
<span class="tl-tag">strategy: per-module</span>
470+
<span class="tl-tag">strategy: hot-cold</span>
471+
<span class="tl-tag">hotCommits config</span>
472+
<span class="tl-tag">MIT v1.1.0</span>
473+
</div>
474+
<div class="tl-impact">hot-cold + MCP: ~200 tokens always-on — 99.75% reduction from baseline</div>
475+
</div>
476+
</div>
477+
449478
</div>
450479
</section>
451480

452481
<hr class="divider">
453482

454483
<section class="section">
455484
<p class="section-ey">Final numbers</p>
456-
<h2>v1.0.0 at a glance</h2>
485+
<h2>v1.1.0 at a glance</h2>
457486

458487
<div class="final-grid">
459488
<div class="final-stat">
@@ -482,14 +511,14 @@ <h2>v1.0.0 at a glance</h2>
482511

483512
<footer>
484513
<div class="footer-inner">
485-
<span class="footer-logo">context-forge v1.0.0</span>
514+
<span class="footer-logo">context-forge v1.1.0</span>
486515
<div class="footer-links">
487516
<a href="https://github.com/manojmallick/context-forge">GitHub</a>
488517
<a href="https://github.com/manojmallick/context-forge/blob/main/CONTRIBUTING.md">Contributing</a>
489518
<a href="https://github.com/manojmallick/context-forge/blob/main/CHANGELOG.md">Changelog</a>
490519
<a href="repomix.html">Repomix</a>
491520
</div>
492-
<span class="footer-mit">MIT © 2026 Manoj Kumar</span>
521+
<span class="footer-mit">MIT © 2026 Manoj Mallick</span>
493522
</div>
494523
</footer>
495524

docs/strategies.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -276,7 +276,7 @@ <h2>Full reference docs</h2>
276276
<a href="roadmap.html">Roadmap</a>
277277
<a href="repomix.html">Repomix</a>
278278
</div>
279-
<span class="footer-mit">MIT © 2026 Manoj Kumar</span>
279+
<span class="footer-mit">MIT © 2026 Manoj Mallick</span>
280280
</div>
281281
</footer>
282282

0 commit comments

Comments
 (0)