Knowledge base

What the knowledge deriver left for review and whether it is still writing: the candidate records awaiting promotion with the branch of the episode each came from, one record by id with every reference it names resolved against the index, the ledger and git, and the derivation status of this checkout judged against the policy's freshness thresholds. Read from the index and the ledger; written by nothing here — the deriver is the shell tool's, and a person promotes.

• module knowledge_base
• builtin
• behaviorally_verified
• 3 capabilities

Capabilities

Each composed in this module's file; each with its own page.

• knowledge_base.candidatesEvery knowledge record with status candidate under the candidates source class: its class, its assertion, the episode it came from and that episode's branch, and how long it has waited — measured from the derivation that wrote it, then the commit that added it, then its own date — judged against session.freshness; against the policy's cap. A candidate whose episode this checkout does not know is reported with no branch rather than hidden. Ordered by id.query · behaviorally_verified · majordomus_knowledge_candidates · GET /api/v1/knowledge/candidates
• knowledge_base.recordOne knowledge record by id — candidate or curated — with every reference it names resolved: a session against the tracked session records and the ledger, a task or decision against the ledger and the task store, a commit against git, a file or test against the index and the tree, a rule, an ADR, an issue or another record against the index. Which references dangle is the question a reviewer asks before promoting, and the one the integrity validator asks of every record. A `task:none` or `decision:none` reference is refused by name.query · behaviorally_verified · majordomus_knowledge_record · GET /api/v1/knowledge/record
• knowledge_base.statusThe freshness half of the stopped-writer judgement (ADR 0052, applied to the knowledge deriver by ADR 0091): the newest knowledge.derived line, the newest session.closed line, how many closed episodes no derivation names, the candidate counts, and — once a derivation has run in this checkout and the switch is on — whether the newest closed episode went underived past session.freshness.stale_minutes. Episode ids are compared, never line order. Whether the close path still calls the deriver is read from the source by the shell validator, not here.query · behaviorally_verified · majordomus_knowledge_status · GET /api/v1/knowledge/status

Claims implemented in this module

Attached by the file that implements each claim; every one links to its page with the implementation and the test that proves it.

• ○guaranteed knowledge-served-on-every-surfaceThe candidates awaiting review, one record by id with its references resolved, and the derivation status of the checkout are one declaration each and answer with the same content over the command line, HTTP and MCPtest: apps/majordomus-cli/tests/knowledge_base.rs