# ir

> An information-retrieval substrate for agentic systems


## Pages in this subsection

- [ir](ir.html.md): `ir` — an information-retrieval substrate for agentic systems.
- [ir.base](ir.base.html.md): Core data model for `ir`.
- [ir.cli](ir.cli.html.md): Command-line surface for `ir` (dispatched by cw).
- [ir.config](ir.config.html.md): Filesystem locations and process-wide defaults for `ir`.
- [ir.coverage](ir.coverage.html.md): Corpus-coverage diagnostic — what’s on disk vs. what’s actually indexed.
- [ir.embed](ir.embed.html.md): Embedder resolution for `ir` — a decent local default, a light fallback.
- [ir.eval](ir.eval.html.md): Capability-discovery evaluation — measuring how well a corpus is *found*.
- [ir.eval_gen](ir.eval_gen.html.md): LLM-backed generation of evaluation cases for `ir.eval`.
- [ir.formulate](ir.formulate.html.md): Query formulation — the Formulator seam (ir_09 §3).
- [ir.graph](ir.graph.html.md): The semantic link graph — typed edges between artifacts (report 12).
- [ir.index](ir.index.html.md): The indexing pipeline and incremental maintenance.
- [ir.maintenance](ir.maintenance.html.md): Idempotent background-work runner — `ir maintain` (issue #58).
- [ir.policy](ir.policy.html.md): Per-corpus policy — how a corpus is segmented/stored and what background work it gets.
- [ir.registry](ir.registry.html.md): Named-corpus registry — persistent, reusable corpus definitions.
- [ir.requirements](ir.requirements.html.md): Dependency check for `ir`: name what is missing and how to install it.
- [ir.rerank](ir.rerank.html.md): The precision stage: a cross-encoder rerank over the first-stage candidates.
- [ir.retrieve](ir.retrieve.html.md): Retrieval — hard metadata filtering + dense / lexical / hybrid ranking.
- [ir.schedule](ir.schedule.html.md): Install and operate the OS job that runs `ir maintain` — `ir schedule` (issue #75).
- [ir.sources](ir.sources.html.md): Defining a corpus source — an abstract strategy plus parameters.
- [ir.store](ir.store.html.md): Persistence for `ir` — the repository layer over `dol` key-value views.
- [ir.strategy](ir.strategy.html.md): Indexing strategies — the “what do we index?” seam.
- [ir.synopsis](ir.synopsis.html.md): Synopsis surfaces — LLM-derived summaries as an indexed surface (report 12).
- [ir.tools](ir.tools.html.md): Agent-callable tool surface over `ir` — plain functions returning JSON-ready

## Optional

- [Top-level llms.txt](../llms.txt): Complete documentation index.