Agentic Knowledge Units

Agentic Knowledge Units provide deterministic local project memory for AchillesAgentLib. The module is exported as an additive utility and is not wired into MainAgent by default.

Runtime Boundary

The implementation lives under AgenticKnowledgeUnits/. Callers instantiate the facade directly when they need filesystem-backed Knowledge Units, JSONL aggregate indexes, lexical search, ContextPack construction, or repair checks. The module does not call LLMAgent, search providers, embeddings, vector stores, or external services.

The architecture keeps the public surface small while splitting implementation work across private collaborators for storage, locks, atomic writes, indexing, tokenization, ranking, context packing, and doctor recovery.

Source Files

The canonical design material remains in the repository source files. docs/specs/DS008-AgenticKnowledgeUnits.md is the governing v1 contract, and this generated documentation page keeps the static HTML navigation available without depending on raw Markdown serving.

Public Import

The stable public import is the package subpath:

import { AgenticKnowledgeUnits } from 'ploinky-agent-lib/AgenticKnowledgeUnits';

The root package barrel also exposes the named AgenticKnowledgeUnits export for callers that already import from the main library surface.