Knowledge Platform — events
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.
Topics follow context.area.vN.event-name (ADR-0012 port, ADR-0014 envelope). The context segment is the producing bounded context's slug.
| Event |
Producer |
Topic |
Scope |
Consumers |
| ArtifactStored |
ArtifactService |
artifacts.artifacts.v1.artifact-stored |
integration |
4 |
| ArtifactValidated |
ArtifactService |
artifacts.artifacts.v1.artifact-validated |
integration |
5 |
| ArtifactSuperseded |
ArtifactService |
artifacts.artifacts.v1.artifact-superseded |
integration |
1 |
| ArtifactDeleted |
ArtifactService |
artifacts.artifacts.v1.artifact-deleted |
integration |
2 |
| ContextAssembled |
ContextBuilderService |
context-assembly.snapshots.v1.context-assembled |
integration |
3 |
| MemoryObserved |
MemoryPromotionService |
memory.items.v1.memory-observed |
integration |
1 |
| MemoryClassified |
MemoryPromotionService |
memory.items.v1.memory-classified |
integration |
2 |
| MemoryPromoted |
MemoryPromotionService |
memory.items.v1.memory-promoted |
integration |
3 |
| MemoryArchived |
MemoryPromotionService |
memory.items.v1.memory-archived |
integration |
2 |
| SkillCandidateProposed |
MemoryPromotionService |
memory.items.v1.skill-candidate-proposed |
integration |
4 |
| SourceRegistered |
KnowledgeIngestionService |
ingestion.sources.v1.source-registered |
integration |
3 |
| SourceStateChanged |
KnowledgeIngestionService |
ingestion.sources.v1.source-state-changed |
integration |
2 |
| SourceDeleted |
KnowledgeIngestionService |
ingestion.sources.v1.source-deleted |
integration |
5 |
| SourceSnapshotTaken |
KnowledgeIngestionService |
ingestion.snapshots.v1.source-snapshot-taken |
integration |
2 |
| ChunksPublished |
KnowledgeIngestionService |
ingestion.snapshots.v1.chunks-published |
integration |
3 |
| SnapshotFailed |
KnowledgeIngestionService |
ingestion.snapshots.v1.snapshot-failed |
integration |
2 |
| RepositoryIndexed |
RepositoryIntelligenceService |
repo-intelligence.indexes.v1.repository-indexed |
integration |
4 |
| RepositoryIndexFailed |
RepositoryIntelligenceService |
repo-intelligence.indexes.v1.repository-index-failed |
integration |
2 |
| IndexRevisionReady |
VectorMemoryService |
retrieval.indexes.v1.index-revision-ready |
integration |
3 |
| IndexRevisionRetired |
VectorMemoryService |
retrieval.indexes.v1.index-revision-retired |
integration |
1 |
| IndexDegraded |
VectorMemoryService |
retrieval.indexes.v1.index-degraded |
integration |
2 |
| GraphFactsUpdated |
VectorMemoryService |
retrieval.graph.v1.graph-facts-updated |
integration |
2 |
| RetrievalExecuted |
VectorMemoryService |
retrieval.queries.v1.retrieval-executed |
integration |
2 |
ArtifactStored
Content stored with metadata and lineage.
|
|
| Producer |
ArtifactService (BC-12 Artifacts & Lineage) |
| Scope / version |
integration / v1 |
| Topic |
artifacts.artifacts.v1.artifact-stored |
| Aggregate |
Artifact |
| Consumers |
StudioBff, DashboardService, KnowledgeIngestionService, MemoryPromotionService |
| Field |
Type |
Required |
Description |
artifactId |
guid |
yes |
|
tenantId |
string |
yes |
|
projectId |
string |
yes |
|
kind |
enum:ArtifactKind |
yes |
|
contentHash |
hash |
yes |
|
producerRunId |
guid |
no |
|
chainId |
guid |
yes |
|
versionInChain |
int |
yes |
|
ArtifactValidated
A validator verdict was attached.
|
|
| Producer |
ArtifactService (BC-12 Artifacts & Lineage) |
| Scope / version |
integration / v1 |
| Topic |
artifacts.artifacts.v1.artifact-validated |
| Aggregate |
Artifact |
| Consumers |
BlueprintService, PipelineExecutionService, FeedbackService, StudioBff, QualityScoreService |
| Field |
Type |
Required |
Description |
artifactId |
guid |
yes |
|
tenantId |
string |
yes |
|
passed |
bool |
yes |
|
validationRef |
string |
yes |
|
ArtifactSuperseded
A newer version exists in the chain.
|
|
| Producer |
ArtifactService (BC-12 Artifacts & Lineage) |
| Scope / version |
integration / v1 |
| Topic |
artifacts.artifacts.v1.artifact-superseded |
| Aggregate |
Artifact |
| Consumers |
StudioBff |
| Field |
Type |
Required |
Description |
artifactId |
guid |
yes |
|
tenantId |
string |
yes |
|
chainId |
guid |
yes |
|
newArtifactId |
guid |
yes |
|
ArtifactDeleted
Content removed; metadata and lineage kept.
|
|
| Producer |
ArtifactService (BC-12 Artifacts & Lineage) |
| Scope / version |
integration / v1 |
| Topic |
artifacts.artifacts.v1.artifact-deleted |
| Aggregate |
Artifact |
| Consumers |
AuditService, DashboardService |
| Field |
Type |
Required |
Description |
artifactId |
guid |
yes |
|
tenantId |
string |
yes |
|
reason |
string |
yes |
|
ContextAssembled
A context snapshot was recorded for an attempt.
|
|
| Producer |
ContextBuilderService (BC-09 Context Assembly) |
| Scope / version |
integration / v1 |
| Topic |
context-assembly.snapshots.v1.context-assembled |
| Aggregate |
ContextSnapshot |
| Consumers |
StudioBff, DashboardService, QualityScoreService |
| Field |
Type |
Required |
Description |
contextSnapshotId |
guid |
yes |
|
tenantId |
string |
yes |
|
runId |
guid |
yes |
|
attemptId |
guid |
yes |
|
status |
enum:SnapshotStatus |
yes |
|
tokensUsed |
int |
yes |
|
tokenBudget |
int |
yes |
|
MemoryObserved
An observation became a candidate.
|
|
| Producer |
MemoryPromotionService (BC-13 Promoted Memory) |
| Scope / version |
integration / v1 |
| Topic |
memory.items.v1.memory-observed |
| Aggregate |
MemoryItem |
| Consumers |
DashboardService |
| Field |
Type |
Required |
Description |
memoryId |
guid |
yes |
|
tenantId |
string |
yes |
|
projectId |
string |
no |
|
originRunId |
guid |
yes |
|
MemoryClassified
A candidate was classified and evidence-checked.
|
|
| Producer |
MemoryPromotionService (BC-13 Promoted Memory) |
| Scope / version |
integration / v1 |
| Topic |
memory.items.v1.memory-classified |
| Aggregate |
MemoryItem |
| Consumers |
StudioBff, DashboardService |
| Field |
Type |
Required |
Description |
memoryId |
guid |
yes |
|
tenantId |
string |
yes |
|
class |
enum:MemoryClass |
yes |
|
confidence |
decimal |
yes |
|
trustTier |
string |
yes |
|
A memory is retrievable in its scope after review.
|
|
| Producer |
MemoryPromotionService (BC-13 Promoted Memory) |
| Scope / version |
integration / v1 |
| Topic |
memory.items.v1.memory-promoted |
| Aggregate |
MemoryItem |
| Consumers |
ContextBuilderService, StudioBff, AuditService |
| Field |
Type |
Required |
Description |
memoryId |
guid |
yes |
|
tenantId |
string |
yes |
|
scope |
enum:MemoryScope |
yes |
|
class |
enum:MemoryClass |
yes |
|
reviewApprovalId |
guid |
no |
|
MemoryArchived
A memory was archived (rejected, decayed or expired).
|
|
| Producer |
MemoryPromotionService (BC-13 Promoted Memory) |
| Scope / version |
integration / v1 |
| Topic |
memory.items.v1.memory-archived |
| Aggregate |
MemoryItem |
| Consumers |
ContextBuilderService, DashboardService |
| Field |
Type |
Required |
Description |
memoryId |
guid |
yes |
|
tenantId |
string |
yes |
|
reason |
string |
yes |
|
SkillCandidateProposed
A reinforced procedural memory is proposed as a skill release for Asset maintainers.
|
|
| Producer |
MemoryPromotionService (BC-13 Promoted Memory) |
| Scope / version |
integration / v1 |
| Topic |
memory.items.v1.skill-candidate-proposed |
| Aggregate |
MemoryItem |
| Consumers |
FeedbackService, StudioBff, StudioNotificationService, AuditService |
| Field |
Type |
Required |
Description |
memoryId |
guid |
yes |
|
tenantId |
string |
yes |
|
proposalRef |
string |
yes |
|
SourceRegistered
A source exists.
|
|
| Producer |
KnowledgeIngestionService (BC-10 Sources & Ingestion) |
| Scope / version |
integration / v1 |
| Topic |
ingestion.sources.v1.source-registered |
| Aggregate |
KnowledgeSource |
| Consumers |
StudioBff, AuditService, RepositoryIntelligenceService |
| Field |
Type |
Required |
Description |
sourceId |
guid |
yes |
|
tenantId |
string |
yes |
|
projectId |
string |
no |
|
kind |
enum:SourceKind |
yes |
|
classification |
string |
yes |
|
SourceStateChanged
Syncing, healthy, stale, failing, disabled or deleting.
|
|
| Producer |
KnowledgeIngestionService (BC-10 Sources & Ingestion) |
| Scope / version |
integration / v1 |
| Topic |
ingestion.sources.v1.source-state-changed |
| Aggregate |
KnowledgeSource |
| Consumers |
StudioBff, DashboardService |
| Field |
Type |
Required |
Description |
sourceId |
guid |
yes |
|
tenantId |
string |
yes |
|
fromState |
enum:SourceState |
yes |
|
toState |
enum:SourceState |
yes |
|
SourceDeleted
A source and its derived items were deleted; carries the deletion lineage reference.
|
|
| Producer |
KnowledgeIngestionService (BC-10 Sources & Ingestion) |
| Scope / version |
integration / v1 |
| Topic |
ingestion.sources.v1.source-deleted |
| Aggregate |
KnowledgeSource |
| Consumers |
VectorMemoryService, RepositoryIntelligenceService, ContextBuilderService, MemoryPromotionService, AuditService |
| Field |
Type |
Required |
Description |
sourceId |
guid |
yes |
|
tenantId |
string |
yes |
|
lineageRef |
string |
yes |
|
SourceSnapshotTaken
An immutable snapshot of a source version was captured.
|
|
| Producer |
KnowledgeIngestionService (BC-10 Sources & Ingestion) |
| Scope / version |
integration / v1 |
| Topic |
ingestion.snapshots.v1.source-snapshot-taken |
| Aggregate |
SourceSnapshot |
| Consumers |
RepositoryIntelligenceService, DashboardService |
| Field |
Type |
Required |
Description |
snapshotId |
guid |
yes |
|
sourceId |
guid |
yes |
|
tenantId |
string |
yes |
|
sourceVersion |
string |
yes |
|
kind |
enum:SourceKind |
yes |
|
ChunksPublished
Chunks with ACL and provenance are ready for indexing.
|
|
| Producer |
KnowledgeIngestionService (BC-10 Sources & Ingestion) |
| Scope / version |
integration / v1 |
| Topic |
ingestion.snapshots.v1.chunks-published |
| Aggregate |
SourceSnapshot |
| Consumers |
TemplateRegistryService, VectorMemoryService, DashboardService |
| Field |
Type |
Required |
Description |
snapshotId |
guid |
yes |
|
sourceId |
guid |
yes |
|
tenantId |
string |
yes |
|
chunkCount |
int |
yes |
|
embeddingProfileVersion |
string |
yes |
|
SnapshotFailed
A pipeline stage failed; the previous snapshot stays published.
|
|
| Producer |
KnowledgeIngestionService (BC-10 Sources & Ingestion) |
| Scope / version |
integration / v1 |
| Topic |
ingestion.snapshots.v1.snapshot-failed |
| Aggregate |
SourceSnapshot |
| Consumers |
StudioBff, DashboardService |
| Field |
Type |
Required |
Description |
snapshotId |
guid |
yes |
|
sourceId |
guid |
yes |
|
tenantId |
string |
yes |
|
stage |
string |
yes |
|
reason |
string |
yes |
|
RepositoryIndexed
An index set is Ready for a revision.
|
|
| Producer |
RepositoryIntelligenceService (BC-39 Repository Intelligence) |
| Scope / version |
integration / v1 |
| Topic |
repo-intelligence.indexes.v1.repository-indexed |
| Aggregate |
RepositoryIndexSet |
| Consumers |
ContextBuilderService, VectorMemoryService, StudioBff, DashboardService |
| Field |
Type |
Required |
Description |
indexSetId |
guid |
yes |
|
tenantId |
string |
yes |
|
sourceId |
guid |
yes |
|
revision |
string |
yes |
|
fileCount |
int |
yes |
|
symbolCount |
int |
yes |
|
RepositoryIndexFailed
Index build failed; the previous set stays Ready.
|
|
| Producer |
RepositoryIntelligenceService (BC-39 Repository Intelligence) |
| Scope / version |
integration / v1 |
| Topic |
repo-intelligence.indexes.v1.repository-index-failed |
| Aggregate |
RepositoryIndexSet |
| Consumers |
StudioBff, DashboardService |
| Field |
Type |
Required |
Description |
indexSetId |
guid |
yes |
|
tenantId |
string |
yes |
|
sourceId |
guid |
yes |
|
revision |
string |
yes |
|
reason |
string |
yes |
|
IndexRevisionReady
An index revision serves queries.
|
|
| Producer |
VectorMemoryService (BC-11 Retrieval & Indexes) |
| Scope / version |
integration / v1 |
| Topic |
retrieval.indexes.v1.index-revision-ready |
| Aggregate |
IndexRevision |
| Consumers |
ContextBuilderService, StudioBff, DashboardService |
| Field |
Type |
Required |
Description |
indexRevisionId |
guid |
yes |
|
tenantId |
string |
yes |
|
collectionId |
guid |
yes |
|
kind |
enum:IndexKind |
yes |
|
revision |
int |
yes |
|
IndexRevisionRetired
A revision was replaced.
|
|
| Producer |
VectorMemoryService (BC-11 Retrieval & Indexes) |
| Scope / version |
integration / v1 |
| Topic |
retrieval.indexes.v1.index-revision-retired |
| Aggregate |
IndexRevision |
| Consumers |
DashboardService |
| Field |
Type |
Required |
Description |
indexRevisionId |
guid |
yes |
|
tenantId |
string |
yes |
|
collectionId |
guid |
yes |
|
IndexDegraded
The backend of an index is unhealthy; retrieval degrades to the remaining indexes.
|
|
| Producer |
VectorMemoryService (BC-11 Retrieval & Indexes) |
| Scope / version |
integration / v1 |
| Topic |
retrieval.indexes.v1.index-degraded |
| Aggregate |
IndexRevision |
| Consumers |
ContextBuilderService, DashboardService |
| Field |
Type |
Required |
Description |
indexRevisionId |
guid |
yes |
|
tenantId |
string |
yes |
|
kind |
enum:IndexKind |
yes |
|
GraphFactsUpdated
Facts were added or closed in a domain.
|
|
| Producer |
VectorMemoryService (BC-11 Retrieval & Indexes) |
| Scope / version |
integration / v1 |
| Topic |
retrieval.graph.v1.graph-facts-updated |
| Aggregate |
GraphFact |
| Consumers |
ContextBuilderService, DashboardService |
| Field |
Type |
Required |
Description |
tenantId |
string |
yes |
|
domain |
enum:GraphDomain |
yes |
|
added |
int |
yes |
|
closed |
int |
yes |
|
sourceId |
guid |
no |
|
RetrievalExecuted
A scoped retrieval ran.
|
|
| Producer |
VectorMemoryService (BC-11 Retrieval & Indexes) |
| Scope / version |
integration / v1 |
| Topic |
retrieval.queries.v1.retrieval-executed |
| Aggregate |
RetrievalQuery |
| Consumers |
DashboardService, QualityScoreService |
| Field |
Type |
Required |
Description |
queryId |
guid |
yes |
|
tenantId |
string |
yes |
|
runId |
guid |
no |
|
resultCount |
int |
yes |
|
latencyMs |
int |
yes |
|
Commands
| Command |
Service |
Handled by |
Result events |
Summary |
Store |
ArtifactService |
Artifact |
ArtifactStored, ArtifactSuperseded |
|
RecordValidation |
ArtifactService |
Artifact |
ArtifactValidated |
|
Delete |
ArtifactService |
Artifact |
ArtifactDeleted |
|
Assemble |
ContextBuilderService |
ContextSnapshot |
ContextAssembled |
|
Observe |
MemoryPromotionService |
MemoryItem |
MemoryObserved |
|
PromoteMemory |
MemoryPromotionService |
MemoryItem |
MemoryPromoted |
|
ArchiveMemory |
MemoryPromotionService |
MemoryItem |
MemoryArchived |
|
RegisterSource |
KnowledgeIngestionService |
KnowledgeSource |
SourceRegistered |
|
SyncSource |
KnowledgeIngestionService |
SourceSnapshot |
SourceSnapshotTaken |
|
DeleteSource |
KnowledgeIngestionService |
KnowledgeSource |
SourceDeleted |
|
RebuildRepositoryIndexes |
RepositoryIntelligenceService |
RepositoryIndexSet |
RepositoryIndexed, RepositoryIndexFailed |
|
RebuildIndexes |
VectorMemoryService |
IndexRevision |
IndexRevisionReady, IndexRevisionRetired |
|
Retrieve |
VectorMemoryService |
RetrievalQuery |
RetrievalExecuted |
|
Consumed from other services
| Consumer |
Event |
Producer |
Handler |
Purpose |
| ArtifactService |
RunCompleted |
RunControlService |
SealRunArtifacts |
Mark the run's artifacts as final outputs and close open chains. |
| ArtifactService |
ProjectStateChanged |
ProjectService |
ExportOrDeleteOnClosing |
Export or delete project artifacts on Closing (XL-14). |
| ContextBuilderService |
IndexRevisionReady |
VectorMemoryService |
RefreshIndexCatalog |
Know which index revisions are current for planning. |
| ContextBuilderService |
IndexDegraded |
VectorMemoryService |
MarkDegraded |
Plan around a degraded index and mark snapshots Degraded. |
| ContextBuilderService |
GraphFactsUpdated |
VectorMemoryService |
InvalidateGraphCache |
Invalidate cached neighbourhoods. |
| ContextBuilderService |
SourceDeleted |
KnowledgeIngestionService |
RecordDeletionLineage |
Record that snapshots referencing the source carry deleted citations (D31). |
| MemoryPromotionService |
RunCompleted |
RunControlService |
CollectObservations |
Collect episodic observations and candidate facts from a completed run (learning loop §32). |
| MemoryPromotionService |
AttemptOutcomeReported |
AgentRuntimeService |
CollectAttemptObservations |
Collect per-attempt observations (problems, resolutions, tool outcomes). |
| MemoryPromotionService |
ApprovalDecided |
RunControlService |
ApplyReviewDecision |
Promote or archive after the review approval. |
| MemoryPromotionService |
ArtifactStored |
ArtifactService |
LinkEvidence |
Link evidence artifacts to candidate memories. |
| MemoryPromotionService |
SourceDeleted |
KnowledgeIngestionService |
InvalidateEvidence |
Re-check memories whose evidence cited a deleted source. |
| KnowledgeIngestionService |
SourceScopeChanged |
ProjectService |
ReconcileProjectSources |
Register or disable sources when a project's source scope changes. |
| KnowledgeIngestionService |
ProjectStateChanged |
ProjectService |
OffboardProjectSources |
Delete or export project sources on Closing (XL-13, XL-14). |
| RepositoryIntelligenceService |
SourceSnapshotTaken |
KnowledgeIngestionService |
BuildIndexSet |
Build indexes for GitRepository snapshots. |
| RepositoryIntelligenceService |
SourceRegistered |
KnowledgeIngestionService |
PrepareRepository |
Prepare language analyzers for new repository sources. |
| RepositoryIntelligenceService |
SourceDeleted |
KnowledgeIngestionService |
RemoveIndexSets |
Remove index sets of a deleted repository source. |
| VectorMemoryService |
ChunksPublished |
KnowledgeIngestionService |
IndexChunks |
Embed and index published chunks; extract entities and relationships into graph facts. |
| VectorMemoryService |
SourceDeleted |
KnowledgeIngestionService |
RemoveDerivedItems |
Remove vectors, index items and facts of a deleted source. |