Knowledge Platform — microservices¶
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.
Every logical service keeps its own design page and model entry; deployment granularity says how it is shipped at first (decision D23). Modules of a host are deployed inside that host until an extraction decision is recorded.
flowchart TB
subgraph KnowledgeHost["KnowledgeHost (host)"]
ArtifactMemoryService["ArtifactMemoryService"]
ArtifactPreviewService["ArtifactPreviewService"]
ArtifactService["ArtifactService"]
CodebaseKnowledgeService["CodebaseKnowledgeService"]
ContextBuilderService["ContextBuilderService"]
DocumentationKnowledgeService["DocumentationKnowledgeService"]
EmbeddingService["EmbeddingService"]
MemoryPromotionService["MemoryPromotionService"]
KnowledgeIngestionService["KnowledgeIngestionService"]
KnowledgeSearchService["KnowledgeSearchService"]
LibraryKnowledgeService["LibraryKnowledgeService"]
LineageService["LineageService"]
MetadataIndexService["MetadataIndexService"]
RepositoryIntelligenceService["RepositoryIntelligenceService"]
TemplateKnowledgeService["TemplateKnowledgeService"]
VectorMemoryService["VectorMemoryService"]
VersioningService["VersioningService"]
end
DecisionMemoryService["DecisionMemoryService (later)"]:::later
KnowledgeGraphService["KnowledgeGraphService (later)"]:::later
KnowledgeReplayService["KnowledgeReplayService (later)"]:::later
PatternCatalogService["PatternCatalogService (later)"]:::later
PromptMemoryService["PromptMemoryService (later)"]:::later
RuntimeMemoryService["RuntimeMemoryService (later)"]:::later
classDef later stroke-dasharray: 4 4;| Service | Context | Granularity | Host | Status | Page |
|---|---|---|---|---|---|
| ArtifactMemoryService | BC-12 | module of host | KnowledgeHost | unmodelled | — |
| ArtifactPreviewService | BC-12 | module of host | KnowledgeHost | unmodelled | — |
| ArtifactService | BC-12 | module of host | KnowledgeHost | target | design |
| CodebaseKnowledgeService | BC-10 | module of host | KnowledgeHost | unmodelled | — |
| ContextBuilderService | BC-09 | module of host | KnowledgeHost | target | design |
| DecisionMemoryService | BC-13 | later stage | — | unmodelled | — |
| DocumentationKnowledgeService | BC-10 | module of host | KnowledgeHost | unmodelled | — |
| EmbeddingService | BC-10 | module of host | KnowledgeHost | unmodelled | — |
| KnowledgeGraphService | BC-11 | later stage | — | unmodelled | — |
| MemoryPromotionService | BC-13 | module of host | KnowledgeHost | target | design |
| KnowledgeHost | BC-11 | standalone host | — | target | design |
| KnowledgeIngestionService | BC-10 | module of host | KnowledgeHost | target | design |
| KnowledgeReplayService | BC-11 | later stage | — | unmodelled | — |
| KnowledgeSearchService | BC-11 | module of host | KnowledgeHost | unmodelled | — |
| LibraryKnowledgeService | BC-10 | module of host | KnowledgeHost | unmodelled | — |
| LineageService | BC-12 | module of host | KnowledgeHost | unmodelled | — |
| MetadataIndexService | BC-11 | module of host | KnowledgeHost | unmodelled | — |
| PatternCatalogService | BC-13 | later stage | — | unmodelled | — |
| PromptMemoryService | BC-13 | later stage | — | unmodelled | — |
| RepositoryIntelligenceService | BC-39 | module of host | KnowledgeHost | target | design |
| RuntimeMemoryService | BC-13 | later stage | — | unmodelled | — |
| TemplateKnowledgeService | BC-10 | module of host | KnowledgeHost | unmodelled | — |
| VectorMemoryService | BC-11 | module of host | KnowledgeHost | target | design |
| VersioningService | BC-12 | module of host | KnowledgeHost | unmodelled | — |
ArtifactMemoryService¶
Artifact-derived memory; merged into ArtifactService (observations go to MemoryPromotionService).
| Bounded context | BC-12 Artifacts & Lineage |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Knowledge Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
ArtifactPreviewService¶
Previews are projections; merged into ArtifactService.
| Bounded context | BC-12 Artifacts & Lineage |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Factory Studio (merge) |
| Status | unmodelled |
| Design page | not written yet |
ArtifactService¶
Authoritative artifact writer: hash-addressed content, metadata, lineage, version chains, previews as projections (BC-12).
| Bounded context | BC-12 Artifacts & Lineage |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Control Plane (module) |
| Status | target |
| Modelled | 1 aggregates · 5 REST + 3 gRPC · 4 events · 2 workers · 3 tables |
| Design page | planes/knowledge-memory/services/artifact-service/index.md |
CodebaseKnowledgeService¶
A source type (GitRepository with the code extractor); merged into KnowledgeIngestionService.
| Bounded context | BC-10 Sources & Ingestion |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Knowledge Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
ContextBuilderService¶
Context assembly: plan, retrieve, expand, rank, deduplicate, compress, budget; immutable context snapshots (BC-09).
| Bounded context | BC-09 Context Assembly |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Knowledge Platform (module) |
| Status | target |
| Modelled | 1 aggregates · 2 REST + 1 gRPC · 1 events · 0 workers · 2 tables |
| Design page | planes/knowledge-memory/services/context-builder-service/index.md |
DecisionMemoryService¶
DecisionMemoryService (Knowledge Platform group of the June-2026 catalog).
| Bounded context | BC-13 Promoted Memory |
| Granularity | later stage |
| Former catalog group | Knowledge Platform (defer) |
| Status | unmodelled |
| Design page | not written yet |
DocumentationKnowledgeService¶
A source type (documentation extractor); merged into KnowledgeIngestionService.
| Bounded context | BC-10 Sources & Ingestion |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Knowledge Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
EmbeddingService¶
Embedding is an ingestion step through the embedding profile; merged into VectorMemoryService.
| Bounded context | BC-10 Sources & Ingestion |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Knowledge Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
KnowledgeGraphService¶
No graph service exists; graph domains are a later capability
| Bounded context | BC-11 Retrieval & Indexes |
| Granularity | later stage |
| Former catalog group | Knowledge Platform (defer) |
| Status | unmodelled |
| Design page | not written yet |
MemoryPromotionService¶
Governed memory lifecycle from observation to reviewed promotion (BC-13).
| Bounded context | BC-13 Promoted Memory |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | (added 2026-10-09; BC-13 had no module row) (module) |
| Status | target |
| Modelled | 1 aggregates · 5 REST + 2 gRPC · 5 events · 3 workers · 3 tables |
| Design page | planes/knowledge-memory/services/memory-promotion-service/index.md |
KnowledgeHost¶
Knowledge platform host: ingestion, retrieval, graph, repository intelligence, artifacts, context, memory.
| Bounded context | BC-11 Retrieval & Indexes |
| Granularity | standalone host |
| Former catalog group | (host added 2026-10-09) (module) |
| Status | target |
| Modelled | 0 aggregates · 2 REST + 0 gRPC · 0 events · 0 workers · 0 tables |
| Design page | planes/knowledge-memory/services/knowledge-host/index.md |
KnowledgeIngestionService¶
Sources, collections, immutable snapshots and the ingestion pipeline with ACL propagation and deletion lineage (BC-10).
| Bounded context | BC-10 Sources & Ingestion |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Knowledge Platform (module) |
| Status | target |
| Modelled | 2 aggregates · 6 REST + 1 gRPC · 6 events · 3 workers · 5 tables |
| Design page | planes/knowledge-memory/services/knowledge-ingestion-service/index.md |
KnowledgeReplayService¶
KnowledgeReplayService (Knowledge Platform group of the June-2026 catalog).
| Bounded context | BC-11 Retrieval & Indexes |
| Granularity | later stage |
| Former catalog group | Knowledge Platform (defer) |
| Status | unmodelled |
| Design page | not written yet |
KnowledgeSearchService¶
Unified retrieval; merged into VectorMemoryService (retrieval and indexes).
| Bounded context | BC-11 Retrieval & Indexes |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Knowledge Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
LibraryKnowledgeService¶
A source type (library extractor); merged into KnowledgeIngestionService.
| Bounded context | BC-10 Sources & Ingestion |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Knowledge Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
LineageService¶
Lineage edges; merged into ArtifactService.
| Bounded context | BC-12 Artifacts & Lineage |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Control Plane (merge) |
| Status | unmodelled |
| Design page | not written yet |
MetadataIndexService¶
Metadata index; merged into VectorMemoryService.
| Bounded context | BC-11 Retrieval & Indexes |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Knowledge Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
PatternCatalogService¶
PatternCatalogService (Knowledge Platform group of the June-2026 catalog).
| Bounded context | BC-13 Promoted Memory |
| Granularity | later stage |
| Former catalog group | Knowledge Platform (defer) |
| Status | unmodelled |
| Design page | not written yet |
PromptMemoryService¶
Memory classes come after governed promotion exists
| Bounded context | BC-13 Promoted Memory |
| Granularity | later stage |
| Former catalog group | Knowledge Platform (defer) |
| Status | unmodelled |
| Design page | not written yet |
RepositoryIntelligenceService¶
Repository indexes: symbols, dependencies, calls, ownership, build and test graphs per revision.
| Bounded context | BC-39 Repository Intelligence |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | (added 2026-10-09) (module) |
| Status | target |
| Modelled | 1 aggregates · 2 REST + 7 gRPC · 2 events · 1 workers · 4 tables |
| Design page | planes/knowledge-memory/services/repository-intelligence-service/index.md |
RuntimeMemoryService¶
Working memory is run state (BC-03/06)
| Bounded context | BC-13 Promoted Memory |
| Granularity | later stage |
| Former catalog group | Knowledge Platform (defer) |
| Status | unmodelled |
| Design page | not written yet |
TemplateKnowledgeService¶
A source type (template extractor); merged into KnowledgeIngestionService.
| Bounded context | BC-10 Sources & Ingestion |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Knowledge Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
VectorMemoryService¶
Retrieval and indexes (historical name): vector, full-text, symbol, metadata, graph and temporal retrieval with scope enforced before top-k; rebuildable index revisions (BC-11).
| Bounded context | BC-11 Retrieval & Indexes |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Knowledge Platform (module) |
| Status | target |
| Modelled | 3 aggregates · 4 REST + 2 gRPC · 5 events · 3 workers · 4 tables |
| Design page | planes/knowledge-memory/services/vector-memory-service/index.md |
VersioningService¶
Version chains; merged into ArtifactService.
| Bounded context | BC-12 Artifacts & Lineage |
| Granularity | module of host · host KnowledgeHost |
| Former catalog group | Control Plane (merge) |
| Status | unmodelled |
| Design page | not written yet |