DS008 Agentic Knowledge Units

DS008 is the governing source specification for the v1 Agentic Knowledge Units implementation. It defines the public facade, filesystem layout, locking and atomic write behavior, index metadata, BM25F ranking policy, ContextPack construction, recovery behavior, and error model.

Implementation Contract

The shipped module follows the DS008 boundary: local filesystem storage, rebuildable JSONL indexes, in-memory warm search, deterministic tokenization, bounded exact boosts, and doctor-based recovery. The implementation must remain local-only and must not introduce LLM calls, external search services, embeddings, vector stores, SQLite, or third-party ranking libraries into the AKU runtime path.

Source Specification

The full specification is maintained in docs/specs/DS008-AgenticKnowledgeUnits.md. Keep that Markdown file authoritative for contract changes, and update the companion architecture document when module layout, ranking semantics, storage format, recovery behavior, or public APIs change.