Template & Library — 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
BlueprintValidated	BlueprintService	`blueprints.versions.v1.blueprint-validated`	integration	4
BlueprintSubmitted	BlueprintService	`blueprints.versions.v1.blueprint-submitted`	integration	3
BlueprintPublished	BlueprintService	`blueprints.versions.v1.blueprint-published`	integration	4
ContextMapDerived	BlueprintService	`blueprints.models.v1.context-map-derived`	integration	2
DomainModelDerived	BlueprintService	`blueprints.models.v1.domain-model-derived`	integration	2
RecipeValidated	GenerationRecipeService	`generation.recipes.v1.recipe-validated`	integration	2
RecipeApproved	GenerationRecipeService	`generation.recipes.v1.recipe-approved`	integration	3
GenerationCompleted	GenerationRecipeService	`generation.recipes.v1.generation-completed`	integration	5
GeneratedOutputRecorded	GenerationRecipeService	`generation.outputs.v1.generated-output-recorded`	integration	3
TemplateVersionDiscovered	TemplateRegistryService	`template-catalog.templates.v1.template-version-discovered`	integration	2
TemplateVersionPublished	TemplateRegistryService	`template-catalog.templates.v1.template-version-published`	integration	4
LibraryVersionDiscovered	TemplateRegistryService	`template-catalog.libraries.v1.library-version-discovered`	integration	2
CompatibilityChecked	TemplateRegistryService	`template-catalog.compatibility.v1.compatibility-checked`	integration	2

BlueprintValidated¶

A version passed (or failed) validation with a report.


Producer	BlueprintService (BC-02 Blueprint)
Scope / version	integration / v1
Topic	`blueprints.versions.v1.blueprint-validated`
Aggregate	BlueprintVersion
Consumers	`StudioBff`, `RunControlService`, `GenerationRecipeService`, `AuditService`

Field	Type	Required
`blueprintId`	`string`	yes
`version`	`string`	yes
`tenantId`	`string`	yes
`projectId`	`string`	yes
`kind`	`enum:BlueprintKind`	yes
`passed`	`bool`	yes
`validationReportRef`	`string`	yes

BlueprintSubmitted¶

A validated version was submitted to Asset Publication.


Producer	BlueprintService (BC-02 Blueprint)
Scope / version	integration / v1
Topic	`blueprints.versions.v1.blueprint-submitted`
Aggregate	BlueprintVersion
Consumers	`AgentRegistryService`, `StudioBff`, `AuditService`

Field	Type	Required
`blueprintId`	`string`	yes
`version`	`string`	yes
`tenantId`	`string`	yes
`projectId`	`string`	yes

BlueprintPublished¶

The version is Published as an asset release.


Producer	BlueprintService (BC-02 Blueprint)
Scope / version	integration / v1
Topic	`blueprints.versions.v1.blueprint-published`
Aggregate	BlueprintVersion
Consumers	`GenerationRecipeService`, `StudioBff`, `AuditService`, `DashboardService`

Field	Type	Required
`blueprintId`	`string`	yes
`version`	`string`	yes
`tenantId`	`string`	yes
`projectId`	`string`	yes
`releaseId`	`string`	yes

ContextMapDerived¶

A context map was derived.


Producer	BlueprintService (BC-02 Blueprint)
Scope / version	integration / v1
Topic	`blueprints.models.v1.context-map-derived`
Aggregate	ContextMap
Consumers	`GenerationRecipeService`, `StudioBff`

Field	Type	Required
`contextMapId`	`guid`	yes
`tenantId`	`string`	yes
`projectId`	`string`	yes
`blueprintId`	`string`	yes
`blueprintVersion`	`string`	yes
`contexts`	`int`	yes

DomainModelDerived¶

A domain model was derived for a context.


Producer	BlueprintService (BC-02 Blueprint)
Scope / version	integration / v1
Topic	`blueprints.models.v1.domain-model-derived`
Aggregate	DomainModel
Consumers	`GenerationRecipeService`, `StudioBff`

Field	Type	Required
`domainModelId`	`guid`	yes
`tenantId`	`string`	yes
`projectId`	`string`	yes
`blueprintId`	`string`	yes
`contextId`	`string`	yes
`aggregates`	`int`	yes

RecipeValidated¶

A recipe passed (or failed) validation.


Producer	GenerationRecipeService (BC-15 Generation Recipe)
Scope / version	integration / v1
Topic	`generation.recipes.v1.recipe-validated`
Aggregate	GenerationRecipe
Consumers	`StudioBff`, `AuditService`

Field	Type	Required
`recipeId`	`guid`	yes
`version`	`int`	yes
`tenantId`	`string`	yes
`projectId`	`string`	yes
`passed`	`bool`	yes
`modules`	`int`	yes

RecipeApproved¶

A recipe may be executed by a generation run.


Producer	GenerationRecipeService (BC-15 Generation Recipe)
Scope / version	integration / v1
Topic	`generation.recipes.v1.recipe-approved`
Aggregate	GenerationRecipe
Consumers	`RunControlService`, `StudioBff`, `AuditService`

Field	Type	Required
`recipeId`	`guid`	yes
`version`	`int`	yes
`tenantId`	`string`	yes
`projectId`	`string`	yes
`approvedBy`	`string`	yes

GenerationCompleted¶

The generation run completed and every module's provenance is recorded.


Producer	GenerationRecipeService (BC-15 Generation Recipe)
Scope / version	integration / v1
Topic	`generation.recipes.v1.generation-completed`
Aggregate	GenerationRecipe
Consumers	`StudioBff`, `AuditService`, `DashboardService`, `FleetRolloutService`, `RepositoryIntelligenceService`

Field	Type	Required
`recipeId`	`guid`	yes
`version`	`int`	yes
`tenantId`	`string`	yes
`projectId`	`string`	yes
`runId`	`guid`	yes
`modules`	`int`	yes
`proposalIds`	`json`	yes

GeneratedOutputRecorded¶

One module's generated output provenance exists.


Producer	GenerationRecipeService (BC-15 Generation Recipe)
Scope / version	integration / v1
Topic	`generation.outputs.v1.generated-output-recorded`
Aggregate	GeneratedOutput
Consumers	`RepositoryIntelligenceService`, `StudioBff`, `AuditService`

Field	Type	Required
`outputId`	`guid`	yes
`tenantId`	`string`	yes
`projectId`	`string`	yes
`moduleName`	`string`	yes
`templateId`	`string`	yes
`templateVersion`	`string`	yes
`runId`	`guid`	yes
`proposalId`	`guid`	no

TemplateVersionDiscovered¶

A template version was read from its repository.


Producer	TemplateRegistryService (BC-14 Template Catalog)
Scope / version	integration / v1
Topic	`template-catalog.templates.v1.template-version-discovered`
Aggregate	TemplateVersion
Consumers	`StudioBff`, `AuditService`

Field	Type	Required
`templateId`	`string`	yes
`version`	`string`	yes
`layer`	`enum:TemplateLayer`	yes
`commit`	`string`	yes

TemplateVersionPublished¶

A template version is Published (asset release exists).


Producer	TemplateRegistryService (BC-14 Template Catalog)
Scope / version	integration / v1
Topic	`template-catalog.templates.v1.template-version-published`
Aggregate	TemplateVersion
Consumers	`GenerationRecipeService`, `FleetRolloutService`, `StudioBff`, `AuditService`

Field	Type	Required
`templateId`	`string`	yes
`version`	`string`	yes
`layer`	`enum:TemplateLayer`	yes
`releaseId`	`string`	yes

LibraryVersionDiscovered¶

A library version was read from the feed.


Producer	TemplateRegistryService (BC-14 Template Catalog)
Scope / version	integration / v1
Topic	`template-catalog.libraries.v1.library-version-discovered`
Aggregate	LibraryVersion
Consumers	`StudioBff`, `GenerationRecipeService`

Field	Type	Required
`libraryId`	`string`	yes
`version`	`string`	yes
`area`	`string`	yes
`state`	`enum:CatalogState`	yes

CompatibilityChecked¶

A compatibility cell was computed with evidence.


Producer	TemplateRegistryService (BC-14 Template Catalog)
Scope / version	integration / v1
Topic	`template-catalog.compatibility.v1.compatibility-checked`
Aggregate	CompatibilityEntry
Consumers	`GenerationRecipeService`, `StudioBff`

Field	Type	Required
`entryId`	`guid`	yes
`subjectKind`	`string`	yes
`subjectId`	`string`	yes
`subjectVersion`	`string`	yes
`withKind`	`string`	yes
`withId`	`string`	yes
`result`	`enum:Compatibility`	yes

Commands¶

Command	Service	Handled by	Result events
`CreateBlueprintVersion`	BlueprintService	BlueprintVersion
`ValidateBlueprint`	BlueprintService	BlueprintVersion	BlueprintValidated, ContextMapDerived, DomainModelDerived
`SubmitBlueprint`	BlueprintService	BlueprintVersion	BlueprintSubmitted
`DraftRecipe`	GenerationRecipeService	GenerationRecipe
`ValidateRecipe`	GenerationRecipeService	GenerationRecipe	RecipeValidated
`ApproveRecipe`	GenerationRecipeService	GenerationRecipe	RecipeApproved
`DiscoverTemplates`	TemplateRegistryService	TemplateVersion	TemplateVersionDiscovered, LibraryVersionDiscovered
`PublishTemplateVersion`	TemplateRegistryService	TemplateVersion

Consumed from other services¶

Consumer	Event	Producer	Handler	Purpose
BlueprintService	AssetReleasePublished	AgentRegistryService	`MarkPublished`	Blueprint releases published by Asset Publication.
BlueprintService	AssetReleaseDeprecated	AgentRegistryService	`MarkDeprecated`	Deprecated blueprint releases.
BlueprintService	ArtifactValidated	ArtifactService	`AttachValidation`	Artifact-level validators of descriptor documents.
GenerationRecipeService	BlueprintPublished	BlueprintService	`OfferRecipe`	A Published blueprint can be turned into a recipe.
GenerationRecipeService	BlueprintValidated	BlueprintService	`InvalidateDrafts`	A changed blueprint invalidates Draft recipes built on it.
GenerationRecipeService	ContextMapDerived	BlueprintService	`ProposeModulePlan`	The module plan is proposed from the context map.
GenerationRecipeService	DomainModelDerived	BlueprintService	`ProposeModulePlan`	Module parameters from the domain model.
GenerationRecipeService	TemplateVersionPublished	TemplateRegistryService	`OfferUpgrade`	A newer template version offers a recipe version (re-scaffold).
GenerationRecipeService	LibraryVersionDiscovered	TemplateRegistryService	`TrackLibraries`	Library versions available to pin.
GenerationRecipeService	CompatibilityChecked	TemplateRegistryService	`RefreshEvidence`	Compatibility evidence for validation.
GenerationRecipeService	RunCompleted	RunControlService	`CompleteGeneration`	The generation run completed.
GenerationRecipeService	RunFailed	RunControlService	`RevertToApproved`	The generation run failed; the recipe stays Approved.
GenerationRecipeService	ChangeProposalMerged	PipelineExecutionService	`LinkCommit`	Generated outputs link to their merged commit.
TemplateRegistryService	AssetReleasePublished	AgentRegistryService	`MarkPublished`	Template releases published by Asset Publication.
TemplateRegistryService	AssetReleaseDeprecated	AgentRegistryService	`MarkDeprecated`	Deprecated template releases.
TemplateRegistryService	PipelineRunCompleted	PipelineExecutionService	`RecordBuildEvidence`	Template repository builds are compatibility evidence.
TemplateRegistryService	ChunksPublished	KnowledgeIngestionService	`RefreshDocs`	Template documentation ingested for the catalog's docs links.