mirror of
https://github.com/headroomlabs-ai/headroom.git
synced 2026-08-27 14:17:10 -04:00
4e18a81717
Follow-up to #2555. Documents every flag the cold-prefix hook / reasoning compaction / cache-TTL learner introduced, and makes two small safety fixes. Docs: - configuration.mdx: add HEADROOM_THINKING_COMPACT(+_KEEP_LAST), HEADROOM_COLD_RECOMPACT, HEADROOM_DEDUPE, HEADROOM_CACHE_TTL_LEARN, HEADROOM_KOMPRESS_ENDPOINT to the env table + a "Cold-prefix hook & reasoning compaction" section: what to set for what, how cold detection reads the real TTL (CC config vs learned), and a per-flag "can this be on by default?" analysis. - cache-optimization.mdx: a cold-prefix recompaction section linking to the flags. Code (both keep everything off by default): - ttl_observations.py: the observation log is now size-bounded (single-backup rotation) and respects HEADROOM_STATELESS — prerequisites for ever defaulting learning on. - openai.py: gate the extra classify_cache_miss attribution behind observations_enabled() so the learning seam costs nothing when it's off. ruff + mypy + self-checks green. |
||
|---|---|---|
| .. | ||
| app | ||
| components | ||
| content/docs | ||
| lib | ||
| overrides | ||
| screenshots | ||
| .gitignore | ||
| bun.lock | ||
| claude-code-bedrock-headroom.md | ||
| next.config.mjs | ||
| observability.md | ||
| package-lock.json | ||
| package.json | ||
| platform-feature-matrix.json | ||
| platform-stabilization.md | ||
| postcss.config.mjs | ||
| proxy.ts | ||
| README.md | ||
| rtk-architecture.md | ||
| source.config.ts | ||
| tsconfig.json | ||
| vercel.json | ||
docs
This is a Next.js application generated with Create Fumadocs.
Run development server:
npm run dev
# or
pnpm dev
# or
yarn dev
Open http://localhost:3000 with your browser to see the result.
Explore
In the project, you can see:
lib/source.ts: Code for content source adapter,loader()provides the interface to access your content.lib/layout.shared.tsx: Shared options for layouts, optional but preferred to keep.
| Route | Description |
|---|---|
app/(home) |
The route group for your landing page and other pages. |
app/docs |
The documentation layout and pages. |
app/api/search/route.ts |
The Route Handler for search. |
Fumadocs MDX
A source.config.ts config file has been included, you can customise different options like frontmatter schema.
Read the Introduction for further details.
Learn More
To learn more about Next.js and Fumadocs, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
- Fumadocs - learn about Fumadocs