headroom/docs/content/docs
Bhavya Chopra c707de4691
docs: retire IntelligentContext from README and installation guide (#1445)
## Description

Public README and installation guide still marketed
**IntelligentContext** and score-based history dropping after PR-B1
retired those stages in favor of live-zone-only compression. This
updates the two first-touch docs so new users see the current pipeline:
compress fresh tool output and new turns only; frozen prefix preserved;
history never dropped.

Closes #1444

## Type of Change

- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [x] Documentation update
- [ ] Performance improvement
- [ ] Code refactoring (no functional changes)

## Changes Made

- **README.md** — replace IntelligentContext marketing bullet with
**live-zone compression** (new bytes only; frozen prefix preserved;
history never dropped)
- **README.md** — pipeline internals list current transforms and note
IntelligentContext / RollingWindow retirement (PR-B1)
- **docs/content/docs/installation.mdx** — core package description
matches live-zone ContentRouter
- **docs/content/docs/installation.mdx** — add PR-B1 retirement note for
IntelligentContext / RollingWindow

## Testing

- [ ] Unit tests pass (`pytest`)
- [ ] Linting passes (`ruff check .`)
- [ ] Type checking passes (`mypy headroom`)
- [ ] New tests added for new functionality
- [x] Manual testing performed

### Test Output

```text
$ rg -n 'IntelligentContext' README.md docs/content/docs/installation.mdx
README.md:289:- **Transforms** do the work: ... (live-zone only; IntelligentContext and RollingWindow were retired in PR-B1).
docs/content/docs/installation.mdx:31:> **Note:** IntelligentContext / RollingWindow ... were retired in PR-B1.

$ rg -n 'live-zone|Live-zone' README.md docs/content/docs/installation.mdx
README.md:274:- **Live-zone compression** — compresses only new bytes ...
README.md:289:- **Transforms** do the work: ... (live-zone only; ...)
docs/content/docs/installation.mdx:29:The core package includes ... live-zone ContentRouter compression.
```

## Real Behavior Proof

- Environment: macOS (darwin 25.5.0), branch
`docs/retire-intelligentcontext-readme` in
`/Users/bhavya/Desktop/Headroom-upstream`
- Exact command / steps: `rg -n 'IntelligentContext' README.md
docs/content/docs/installation.mdx` and `rg -n 'live-zone|Live-zone'
README.md docs/content/docs/installation.mdx`; read updated README
pipeline section and installation.mdx core-package blurb
- Observed result: IntelligentContext appears only in retirement notes
(not as an active feature); live-zone compression is the primary
marketed behavior in README and installation guide
- Not tested: Wiki pages (tracked as follow-up in #1444); docs site
build (`npm run build` in docs/)

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

## Checklist

- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [ ] I have added tests that prove my fix is effective or that my
feature works
- [ ] New and existing unit tests pass locally with my changes
- [ ] I have updated the CHANGELOG.md if applicable

## Additional Notes

Wiki still has extensive IntelligentContext docs — out of scope here;
follow-up tracked in #1444. CHANGELOG N/A (docs-only, no release note
required).

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-07-08 09:16:11 -05:00
..
agent-orchestration.mdx docs(orchestration): guide repeated agent wakes with CCR (#1871) 2026-07-08 08:37:24 -05:00
agno.mdx new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
anthropic-sdk.mdx new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
api-reference.mdx docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
architecture.mdx docs(orchestration): guide repeated agent wakes with CCR (#1871) 2026-07-08 08:37:24 -05:00
benchmarks.mdx docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
cache-optimization.mdx docs(orchestration): guide repeated agent wakes with CCR (#1871) 2026-07-08 08:37:24 -05:00
ccr.mdx docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
ci-cd-flows.mdx docs(ci): add CI/CD flow diagrams (#1062) 2026-06-16 23:05:15 -07:00
claude-code-azure-foundry.mdx fix(cli): harden all CLI surfaces + fix docs accuracy (#1491) 2026-06-27 14:48:43 -07:00
claude-code-vertex.mdx docs: use headroom-ai package name in install commands (#1014) (#1257) 2026-06-22 19:25:00 -05:00
code-compression.mdx fix: align docs and prune dead compatibility surfaces 2026-05-09 14:07:59 -07:00
community-savings.mdx fix(telemetry): switch anonymous telemetry to opt-in (off by default) (#1223) 2026-06-20 21:26:04 -07:00
configuration.mdx [codex] docs: add pipeline extension recipe (#1758) 2026-07-07 23:06:53 -05:00
context-management.mdx docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
docker-install.mdx feat: add lean-ctx context tool support 2026-05-11 17:54:17 -04:00
errors.mdx new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
failure-learning.mdx feat: add first-class OpenCode support (wrap, learn, mcp install) (#559) 2026-06-25 13:38:58 -05:00
filesystem-contract.mdx feat: add lean-ctx context tool support 2026-05-11 17:54:17 -04:00
how-compression-works.mdx docs(orchestration): guide repeated agent wakes with CCR (#1871) 2026-07-08 08:37:24 -05:00
image-compression.mdx fix: align docs and prune dead compatibility surfaces 2026-05-09 14:07:59 -07:00
index.mdx docs: fix stale API references, retired class imports, and incorrect examples 2026-06-02 19:19:19 -04:00
installation.mdx docs: retire IntelligentContext from README and installation guide (#1445) 2026-07-08 09:16:11 -05:00
langchain.mdx new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
limitations.mdx docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
litellm.mdx new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
mcp.mdx feat(cli): add headroom dashboard and surface the dashboard URL (#1277) (#1292) 2026-06-22 19:05:38 -05:00
memory.mdx feat(memory): add opt-in Apple-GPU (MPS) embedding runtime (#766) 2026-06-11 12:59:20 -05:00
meta.json docs(orchestration): guide repeated agent wakes with CCR (#1871) 2026-07-08 08:37:24 -05:00
metrics.mdx fix(proxy): expose persistent savings metrics (#1647) 2026-07-01 23:28:12 -05:00
openai-sdk.mdx new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
opencode.mdx fix(opencode): use local MCP config (#1383) 2026-07-06 06:22:15 -07:00
persistent-installs.mdx feat: headroom wrap opencode / unwrap opencode CLI (#1105) 2026-06-22 11:07:12 -05:00
pipeline-extensions.mdx docs: add pipeline-extension recipe and x-headroom-base-url routing docs (#1712) 2026-07-07 12:45:16 -05:00
proxy.mdx feat(proxy): add provider-only HTTP proxy (#1807) 2026-07-05 15:56:59 -07:00
quickstart.mdx new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
releases.mdx docs(ci): add CI/CD flow diagrams (#1062) 2026-06-16 23:05:15 -07:00
savings.mdx feat(savings): durable savings ledger + headroom savings command (#1127) 2026-06-22 18:47:57 -05:00
shared-context.mdx fix(cli): harden all CLI surfaces + fix docs accuracy (#1491) 2026-06-27 14:48:43 -07:00
simulation.mdx fix(cli): harden all CLI surfaces + fix docs accuracy (#1491) 2026-06-27 14:48:43 -07:00
smart-crusher.mdx docs: fix stale API references, retired class imports, and incorrect examples 2026-06-02 19:19:19 -04:00
strands.mdx docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
text-and-logs.mdx fix: align docs and prune dead compatibility surfaces 2026-05-09 14:07:59 -07:00
troubleshooting.mdx fix(claude): surface Remote Control proxy incompatibility (#1610) 2026-07-01 23:19:25 -05:00
vercel-ai-sdk.mdx new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00