Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions doc/architecture/SPEC/knowledge_service.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# knowledge_service/ — provider curation components

<!-- verified-against: 2026-09-26 -->

The provider owns knowledge curation beneath the public SDK v1 facade.
`KnowledgeCurator` composes four domain components over one explicit work
checkout: `CatalogMixin` discovers contained owner rule pages and their
capacity; `PromptMixin` validates and bounds evidence and fences it as data;
`ProposalMixin` validates source/page/rule identity and binds accepted
proposals to page digests; `ApplyMixin` performs locked append-only writes,
fixed validators and byte-exact rollback. `common` contains shared syntax,
bounds, hashes, errors and lock capability.

No component imports a CLI/MCP transport or ReviewBot, calls a model, clones,
pushes, or publishes. The host owns evidence collection, model calls, retries,
local commits and proposal export. The public `sdk.v1.knowledge` module only
re-exports the curator and validator error. Existing proposal IDs, errors,
wire projections, validator order and rollback behavior are compatibility
contracts across the move.
2 changes: 1 addition & 1 deletion doc/architecture/SPEC/knowledge_service/curation.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

<!-- verified-against: 2026-09-26 -->

`KnowledgeCurator` implements provider-owned catalog, bounded evidence prompt,
`KnowledgeCurator` composes provider-owned catalog, bounded evidence prompt,
proposal validation, append-only apply, fixed validator execution, and byte-exact
rollback for an explicit work checkout. It imports only SDK contract models and
standard-library services; it never imports a CLI/MCP transport, calls a model,
Expand Down
Loading
Loading