Knowledge Platform — bounded contexts

Generated from the architecture model

This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.

flowchart LR
    subgraph knowledge["Knowledge Platform"]
        BC_09["BC-09<br/>Context Assembly"]
        BC_10["BC-10<br/>Sources & Ingestion"]
        BC_11["BC-11<br/>Retrieval & Indexes"]
        BC_12["BC-12<br/>Artifacts & Lineage"]
        BC_13["BC-13<br/>Promoted Memory"]
        BC_39["BC-39<br/>Repository Intelligence"]
    end

Hold "Alt" / "Option" to enable pan & zoom

Context	Authoritative state	Services	Status
BC-09 Context Assembly	Context snapshots, budget decisions, provenance	1	target
BC-10 Sources & Ingestion	Source identity/version, ACL, extraction status, deletion lineage	6	target
BC-11 Retrieval & Indexes	Retrieval projections, embedding/index revisions, graph projections	6	target
BC-12 Artifacts & Lineage	Artifact metadata, content references, version chains	5	target
BC-13 Promoted Memory	Reviewed memory, scope, provenance, expiry	5	target
BC-39 Repository Intelligence	Repository indexes (symbols, dependencies, calls, ownership, build and test graphs) per repository revision	1	target

BC-09 Context Assembly

Authoritative state: Context snapshots, budget decisions, provenance | Service | Granularity | Host | Status | |---|---|---|---| | ContextBuilderService | module of host | KnowledgeHost | target |

Events produced: ContextAssembled

BC-10 Sources & Ingestion

Authoritative state: Source identity/version, ACL, extraction status, deletion lineage | Service | Granularity | Host | Status | |---|---|---|---| | CodebaseKnowledgeService | module of host | KnowledgeHost | unmodelled | | DocumentationKnowledgeService | module of host | KnowledgeHost | unmodelled | | EmbeddingService | module of host | KnowledgeHost | unmodelled | | KnowledgeIngestionService | module of host | KnowledgeHost | target | | LibraryKnowledgeService | module of host | KnowledgeHost | unmodelled | | TemplateKnowledgeService | module of host | KnowledgeHost | unmodelled |

Events produced: SourceRegistered, SourceStateChanged, SourceDeleted, SourceSnapshotTaken, ChunksPublished, SnapshotFailed

BC-11 Retrieval & Indexes

Authoritative state: Retrieval projections, embedding/index revisions, graph projections · Decisions: ADR-0013 | Service | Granularity | Host | Status | |---|---|---|---| | KnowledgeGraphService | later stage | — | unmodelled | | KnowledgeHost | standalone host | — | target | | KnowledgeReplayService | later stage | — | unmodelled | | KnowledgeSearchService | module of host | KnowledgeHost | unmodelled | | MetadataIndexService | module of host | KnowledgeHost | unmodelled | | VectorMemoryService | module of host | KnowledgeHost | target |

Events produced: IndexRevisionReady, IndexRevisionRetired, IndexDegraded, GraphFactsUpdated, RetrievalExecuted

BC-12 Artifacts & Lineage

Authoritative state: Artifact metadata, content references, version chains | Service | Granularity | Host | Status | |---|---|---|---| | ArtifactMemoryService | module of host | KnowledgeHost | unmodelled | | ArtifactPreviewService | module of host | KnowledgeHost | unmodelled | | ArtifactService | module of host | KnowledgeHost | target | | LineageService | module of host | KnowledgeHost | unmodelled | | VersioningService | module of host | KnowledgeHost | unmodelled |

Events produced: ArtifactStored, ArtifactValidated, ArtifactSuperseded, ArtifactDeleted

BC-13 Promoted Memory

Authoritative state: Reviewed memory, scope, provenance, expiry | Service | Granularity | Host | Status | |---|---|---|---| | DecisionMemoryService | later stage | — | unmodelled | | MemoryPromotionService | module of host | KnowledgeHost | target | | PatternCatalogService | later stage | — | unmodelled | | PromptMemoryService | later stage | — | unmodelled | | RuntimeMemoryService | later stage | — | unmodelled |

Events produced: MemoryObserved, MemoryClassified, MemoryPromoted, MemoryArchived, SkillCandidateProposed

BC-39 Repository Intelligence

Authoritative state: Repository indexes (symbols, dependencies, calls, ownership, build and test graphs) per repository revision | Service | Granularity | Host | Status | |---|---|---|---| | RepositoryIntelligenceService | module of host | KnowledgeHost | target |

Events produced: RepositoryIndexed, RepositoryIndexFailed