Skip to content

Scenario catalog

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.

A design artefact, not a tracker

This catalog is derived from the model by python -I tools/docs_model derive-scenarios and validated with the backlog (ADR-0029, decision D111). Ids are locked and never renumbered.

Scenarios 880 (endpoint 392, event 231, route-class 55, step 186, outcome 16)
Traced by a PBI 631
Enriched by a writer 631
Exempted (with the increment that completes them) 45
Ratchet epics enforced: agent-mesh, component-extensions, control-plane, data-event, devops-gitops, engineering-readiness, factory-assets, factory-studio, fleet-operations, generated-saas, governance, integration, knowledge, marketplace, model-compute, observability, outcome-verification, runtime-cloud, template-library, tools-mcp; pilot features: agent-registry-service-complete, agent-registry-service-publication, agent-registry-service-thin, agent-runtime-service, agent-runtime-worker, alert-rule-service, approval-policy-service, artifact-service, audit-service-complete, blueprint-service, command-line-client, command-line-client-commands, component-agent-template, component-agent-template-contract, component-agent-template-factory-access, component-agent-template-identity, component-agent-template-release, component-aiskills-library-template-skill-packages, component-api-gateway-template, component-api-library-template-factory-clients, component-audit-factory-evidence, component-auth-server-template-factory-tokens, component-base-template-factory-profile, component-base-template-findings, component-base-template-product-profile, component-blazor-mfe-library-template, component-blazor-shell, component-blazor-shell-template-studio, component-compliance-factory-classifications, component-documentation-template-factory-docs, component-extensions-ai, component-healthchecks-aggregator-engine-library, component-healthchecks-aggregator-fleet-profile, component-identity-template-factory-roles, component-library-template-factory-profile, component-mcp, component-observability-factory-conventions, component-platform-template-environment-stack, component-saas-extensions, component-saas-metering, component-saas-metering-template, component-saas-tenants, component-saas-tenants-template, component-uikit-factory-compositions, component-worker-template-factory-profile, component-workers-runtime-library, connector-registry-service-deliveries, connector-registry-service-thin, context-builder-service-thin, contracts-package, control-plane-api, cost-usage-service-complete, dashboard-service, data-event-foundations, delivery-host, durable-execution-spike, envelope-registry-service, environment-promotion-service, environment-service, execution-capacity-service-complete, execution-capacity-service-thin, feedback-service, generation-recipe-service, governance-host, ia-cprovisioning-service, integration-host, integration-service-thin, knowledge-host, knowledge-ingestion-service-thin, local-development-environment, mcp-server-registry-service-thin, model-gateway-host, model-router-service, observability-host, owner-decisions, pipeline-execution-service-complete, pipeline-execution-service-thin, policy-engine-service, project-service, quality-score-service-complete, quality-score-service-thin, release-service, repository-and-pipeline-conventions, repository-intelligence-service-thin, retention-residency-service, run-control-service, runtime-cloud-host, runtime-environment-service, secret-broker-service, slo-service, store-profile-service, studio-assets, studio-bff, studio-governance-administration, studio-intelligence, studio-notification-service, studio-operations-usage, studio-quality-releases, studio-realtime-gateway, studio-software-factory, studio-workspace, template-catalog-host, template-registry-service, tool-adapter-service, tool-executor-host, trusted-scope-chain, typed-gateway-clients, vector-memory-service-thin, verify-deliver-it, verify-generate-a-microservice, verify-readiness, verify-studio, verify-trust-and-accountability, wf-application-design, wf-architecture-decomposition, wf-behaviour-simulation, wf-compliance-check, wf-database-blueprint, wf-debt-review, wf-delivery-run, wf-generate-product, wf-infrastructure-plan, wf-module-blueprints, wf-observability-blueprint, wf-pipeline-blueprint, wf-plan-run, wf-preview-environment, wf-project-bootstrap, wf-release, wf-security-blueprint, wf-test-plan, wf-vision-to-blueprint, workflow-engine-service; final: True

A scenario holds the trigger, a given/when/then and one failure branch. The derived text is a default; a writer sets enriched: true after reviewing it against the service or workflow definition. A PBI traces a scenario by id in traces.scenarios; under the ratchet (rule 23) every scenario of a ratcheted epic's subjects is traced or exempted.

AgentCardService

Service in BC-04; first delivered in I8. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-AgentCardService-001 | endpoint | GET /factory/agent-cards with scope factory.agents.discover | the response is 200 | the required dependency is unavailable | — | derived | | SCN-AgentCardService-002 | endpoint | GET /factory/agent-cards/{agentId} with scope factory.agents.discover | the response is 200 | 404: the addressed resource is absent or outside the caller's scope | — | derived | | SCN-AgentCardService-003 | endpoint | POST /factory/agent-cards/{agentId}/tasks with scope factory.agents.invoke | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-AgentCardService-004 | endpoint | GET /factory/agent-cards/{agentId}/tasks/{taskId} with scope factory.agents.invoke | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-AgentCardService-005 | event | AgentCardService publishes AgentCardPublished on asset-publication.agent-cards.v1.agent-card-published | the payload carries cardId, tenantId, agentId, releaseId, visibility; each consumer (StudioBff (RefreshAgentCardView), MarketplaceCatalogService (LinkAgentCard)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-AgentCardService-006 | event | AgentCardService publishes AgentCardWithdrawn on asset-publication.agent-cards.v1.agent-card-withdrawn | the payload carries cardId, tenantId, agentId, reason; each consumer (StudioBff (RefreshAgentCardView), MarketplaceCatalogService (DelistOrFlag)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived |

AgentRegistryService

Service in BC-04; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-AgentRegistryService-001 | endpoint | POST /factory/asset-releases/validate with scope factory.assets.write | the response is 200 with a report that names each resolved dependency with its exact version and hash and each missing, unreviewed or incompatible dependency with its kind and asset id; the same inputs give the same manifest hash and one changed dependency gives another; no row, no blob, no event and no approval request is written (side-effect class sandbox) | 400: the body lacks a candidate field or carries a publication field of release-manifest-v1; 403: the scope lacks factory.assets.write; the source commit cannot be read because ext-azure-devops is unavailable (fail-fast dependency) | AIFACTORY-US-414 | enriched | | SCN-AgentRegistryService-002 | endpoint | POST /factory/asset-releases with scope factory.assets.write | the response is 202 with the release location; the ClosureResolver worker, triggered by AssetReleaseSubmitted, resolves the closure and computes the hash, and when it equals manifestHash it writes the closure rows and stores the resolved manifest, after which the publication approval is requested; before I4 no evaluation suite exists and no evaluation runs (D140), and from I4 QualityScoreService evaluates the candidate where an evaluation suite exists for its asset kind; a repeated call with the same Idempotency-Key and the same body returns the same release and changes nothing | 400: the body lacks a candidate field or carries a publication field; 403: the scope lacks factory.assets.write; 409: the same Idempotency-Key arrives with a different body, or the version of the asset already exists in the tenant as a Published or Deprecated release, which is immutable; ArtifactService is unavailable (fail-fast dependency); the hash the ClosureResolver computes differs from the submitted one; the source commit stays unreachable after the five attempts of the ClosureResolver | AIFACTORY-US-415 | enriched | | SCN-AgentRegistryService-003 | endpoint | POST /factory/asset-releases/{releaseId}/publish with scope factory.assets.publish | the response is 200 with the release; connectsoft.factory.releases.published is incremented and the release is immutable from then on; a repeated call for a release that is already Published returns 200 and changes nothing; the inbox handler PublishOnApproval applies the same transition when ApprovalDecided grants the publication approval of the release, returns the candidate to Draft through RejectedOrChanged on a rejection or a request for changes, and returns it to Draft through ApprovalExpiredStaleOrCancelled with a finding that names the outcome when the request expired, went stale or was cancelled (D117) | 403: the scope lacks factory.assets.publish; 404: no release with that releaseId exists in the tenant of the caller, which is also the answer for a release of another tenant (ADR-0015); 409: the release is Draft, Deprecated or Revoked, a revoked release never being published again (D119); 412: a closure entry is missing, not Published or incompatible, from I4 the evidence is missing although a suite exists for the asset kind while Publication:Gates:RequireEvaluation is true (D140), the publication approval is not granted for this manifestHash, or, for any asset kind, the granting decision names the subject in submittedBy as decidedBy or was not given under the role the asset kind requires, Platform admin for a ModelProfile release and Reviewer for every other kind (D119) | AIFACTORY-US-416 | enriched | | SCN-AgentRegistryService-004 | endpoint | POST /factory/asset-releases/{releaseId}/deprecate with scope factory.assets.publish | the response is 200; the manifest stays readable and unchanged, so the release can still be read and loaded by its id for the runs that pinned it; on the event RunControlService refuses new runs that would pin the release (409) while runs already pinned continue; a repeated call for a release that is already Deprecated returns 200 and writes no second event and no second evidence | 400: the body lacks the reason or names an in-flight policy other than finish, drain or revoke; 403: the scope lacks factory.assets.publish, or the caller holds the scope without the Platform admin role; 404: no release with that releaseId exists in the tenant of the caller, which is also the answer for a release of another tenant (ADR-0015); 409: the release is Draft, InReview or Revoked | AIFACTORY-US-417 | enriched | | SCN-AgentRegistryService-014 | endpoint | POST /factory/asset-releases/{releaseId}/revoke with scope factory.assets.publish | the response is 200 with the release; the stored manifest is unchanged, so the release can still be read and loaded by its id and the registry repoints no run; no transition leaves Revoked and a revoked release is never pinned, aliased or published again, since AssetPublication.ResolveRelease resolves no alias and no release id to it for a new pin, MoveAlias refuses it with 409 and PublishRelease answers 409 (D119); the revocation moves and removes no alias, so an alias that points at the release stays in place and visible, and a resolution through it answers FAILED_PRECONDITION naming the revoked release until an administrator moves the alias (D121), as does a resolution by the release id of the revoked release (D123); on the event RunControlService applies the stated in-flight policy to every run that is not terminal and whose pinned release closure holds the release, child runs included, so that under finish the runs continue to their end, under drain the step that is running finishes, no further step is dispatched and the run ends Cancelled with the reason release-revoked, and under revoke the run is cancelled at once with the same reason (D123), AgentRuntimeService interrupts the running attempts of those runs under revoke and lets them finish under drain, AgentCardService withdraws the card and AuditService records the evidence; a repeated call that names the reason and the policy the release already keeps returns 200 and writes no second event and no second evidence | 400: the body lacks the reason or the inFlightPolicy, or names a policy other than finish, drain or revoke; 403: the scope lacks factory.assets.publish, or the caller holds the scope without the Platform admin role; 404: no release with that releaseId exists in the tenant of the caller, which is also the answer for a release of another tenant (ADR-0015); 409: the release is Draft or InReview, because the model holds the transition Revoke from Published and from Deprecated only, or it is already Revoked and the call names another reason or another policy, because no transition leaves Revoked (D119) | AIFACTORY-US-536 | enriched | | SCN-AgentRegistryService-005 | endpoint | GET /factory/asset-releases/{releaseId} with scope factory.assets.read | the response is 200 with the manifest as release-manifest-v1, every closure entry with its exact version and hash, the evaluation record reference with its verdict, the approval and the aliases that point at the release, and with what the release keeps, the withdrawalReason and the inFlightPolicy of a deprecation or a revocation and the finding of a candidate that returned to Draft (D119); a Deprecated release and a Revoked release are returned with their state and their manifest unchanged, a Revoked release also with every alias that still points at it, because an alias of a revoked release stays in place and visible until an administrator moves it (D121); nothing is written | 403: the scope lacks factory.assets.read; 404: no release with that releaseId exists in the tenant of the caller or the platform tenant; a release of another tenant is not found under the tenant row filter of the service and is answered 404, the same answer as for a releaseId that does not exist (ADR-0015) | AIFACTORY-US-418 | enriched | | SCN-AgentRegistryService-006 | endpoint | GET /factory/asset-releases with scope factory.assets.read | the response is 200 with only the matching releases of the tenant of the caller and of the platform tenant, each with its kind, asset, version and state; releases of other tenants never appear (row-filter isolation, ADR-0015); nothing is written | the identity platform cannot validate the token or agent-registry-sql is unavailable | AIFACTORY-US-418 | enriched | | SCN-AgentRegistryService-007 | endpoint | PUT /factory/assets/{assetKind}/{assetId}/aliases/{name} with scope factory.assets.publish | the response is 200; from then on AssetPublication.ResolveRelease resolves the alias to the new release; a run that was accepted before the move keeps the release it pinned; no event is published for an alias; a repeated call that names the release the alias already points at returns 200 and changes nothing; an alias that points at a Revoked release, which the revocation left in place and visible, is moved to a Published release in the same way, and from then on its resolution returns that release and no longer answers FAILED_PRECONDITION (D121) | 403: the scope lacks factory.assets.publish; 404: the asset or the target release does not exist in the tenant of the caller, which is also the answer for an asset or a release of another tenant (ADR-0015); 409: the target release is Draft, InReview, Deprecated or Revoked, a revoked release never being aliased again (D119), or a concurrent move of the same alias committed first (version conflict) | AIFACTORY-US-419 | enriched | | SCN-AgentRegistryService-008 | endpoint | gRPC AssetPublication.ResolveRelease (internal, none streaming) | the reply message carries exactly one immutable release with the fields releaseId, assetKind, assetId, version, state, hash and every closure entry with its exact version and hash of release-manifest-v1; an alias is resolved to the release it points at when the call is made, so the caller pins the release id and a later alias move never changes an accepted run; nothing is written; in the thin delivery of I1 the release is one of the twenty-six seeded Draft releases, the releases of all eleven model profiles of model/model-profiles.yaml among them, which are resolved by alias under the Draft allowance (D121, D123), the reply states state Draft and publishedAt, publishedBy, evaluation and approval are absent; from I2 an alias that MoveAlias pointed at a Published release resolves to it with publishedAt, publishedBy and approval and without evaluation (D140), from the complete delivery every alias resolves to a Published release that carries them, evaluation included where a suite exists for its asset kind, and a Revoked release is never resolved for a new pin, by its release id or by an alias that pointed at it (D119); such an alias is neither moved nor removed by the revocation and stays in place and visible until an administrator moves it (D121) | the caller presents no workload identity (UNAUTHENTICATED); its token lacks the service scope (PERMISSION_DENIED); the request names neither an alias nor a release id (INVALID_ARGUMENT); no such alias or release exists among the releases the tenant can read, which is also the answer for a release of another tenant (NOT_FOUND, ADR-0015); the alias points at a release that is Revoked, or the request names the release id of a Revoked release (FAILED_PRECONDITION with a status message that names the revoked release, D121, D123); agent-registry-sql is unavailable (UNAVAILABLE) | AIFACTORY-US-402 | enriched | | SCN-AgentRegistryService-009 | endpoint | gRPC AssetPublication.LoadRelease (internal, server streaming) | the stream delivers the manifest message with the fields releaseId, assetKind, assetId, version, state and hash of release-manifest-v1 and, beside them, the content reference and the hash of the authoring document of the release (D121), then one message per closure entry with its exact version, hash and content reference in the order of the manifest, and completes; the content itself is fetched from ArtifactService by the caller; loading the same release twice yields the same messages; nothing is written; in the thin delivery of I1 the release is one of the twenty-six seeded Draft releases, six workflow definitions, nine agents and all eleven model profiles of model/model-profiles.yaml (D123), whose authoring document the seed loader stored in ArtifactService under the content reference the manifest message names (D121), and publishedAt, publishedBy, evaluation and approval are absent in state Draft | the caller presents no workload identity (UNAUTHENTICATED); its token lacks the service scope (PERMISSION_DENIED); the request carries no release id (INVALID_ARGUMENT); the release does not exist among the releases the tenant can read, which is also the answer for a release of another tenant (NOT_FOUND, ADR-0015); the store becomes unavailable before or during the stream (UNAVAILABLE) | AIFACTORY-US-403 | enriched | | SCN-AgentRegistryService-010 | event | AgentRegistryService publishes AssetReleaseSubmitted on asset-publication.releases.v1.asset-release-submitted | the event is sent with releaseId, tenantId, assetKind, assetId, version and manifestHash and with the tenant of the release in the envelope; it triggers the ClosureResolver worker of the service, which writes the closure rows when the hash it computes equals manifestHash and otherwise leaves the candidate InReview with a blocking finding; from I4 QualityScoreService evaluates the candidate (RunReleaseGate), no evaluation running before I4 (D140), and StudioBff refreshes its view (RefreshAssetReleaseView); each consumer is idempotent on the event id and proves its handling in its own suite | the transport is unavailable when the dispatcher runs, or the submission rolled back | AIFACTORY-US-415 | enriched | | SCN-AgentRegistryService-011 | event | AgentRegistryService publishes AssetReleasePublished on asset-publication.releases.v1.asset-release-published | the event is sent with releaseId, tenantId, assetKind, assetId, version and manifestHash and with the tenant of the release in the envelope; AgentRuntimeService warms its release cache (WarmReleaseCache), WorkflowEngineService loads the workflow definition (LoadWorkflowDefinition), AgentCardService publishes the card (PublishCard), StudioBff refreshes its view and the other consumers the model lists act on it; each consumer is idempotent on the event id and proves its handling in its own suite | the transport is unavailable when the dispatcher runs, or the publication rolled back | AIFACTORY-US-416 | enriched | | SCN-AgentRegistryService-012 | event | AgentRegistryService publishes AssetReleaseDeprecated on asset-publication.releases.v1.asset-release-deprecated | the event is sent with releaseId, tenantId and inFlightPolicy and with the tenant of the release in the envelope; RunControlService refuses new runs that would pin the release (BlockNewPins, SubmitRun answers 409) while runs already pinned continue, AgentRuntimeService applies the in-flight policy to running attempts (ApplyInFlightPolicy), AgentCardService withdraws the card (WithdrawCard) and StudioBff refreshes its view; each consumer is idempotent on the event id and proves its handling in its own suite | the transport is unavailable when the dispatcher runs, or the deprecation rolled back | AIFACTORY-US-417 | enriched | | SCN-AgentRegistryService-013 | event | AgentRegistryService publishes AssetReleaseRevoked on asset-publication.releases.v1.asset-release-revoked | the event is sent with releaseId, tenantId, reason and inFlightPolicy and with the tenant of the release in the envelope; RunControlService applies the stated in-flight policy to every run that is not terminal and whose pinned release closure holds the revoked release, child runs included, where finish lets the runs continue to their end, drain lets the step that is running finish, dispatches no further step and ends the run Cancelled with the reason release-revoked, and revoke cancels the run at once with the same reason (D123), and it keeps the state Revoked of the release, so that SubmitRun refuses a run that would pin it with 409, also through an alias that still points at it, since the revocation leaves such an alias in place and visible until an administrator moves it (ApplyRevocationPolicy, D119, D121), AgentRuntimeService interrupts the running attempts of those runs under revoke, lets them finish under drain and does nothing under finish (ApplyInFlightPolicy, D123), AgentCardService withdraws the card (WithdrawCard) and AuditService records the evidence (RecordEvidence); each consumer is idempotent on the event id and proves its handling in its own suite | the transport is unavailable when the dispatcher runs, or the revocation rolled back | AIFACTORY-US-417 | enriched | | SCN-AgentRegistryService-015 | event | AgentRegistryService publishes LearningReleaseOpened on asset-publication.releases.v1.learning-release-opened | the event is sent with releaseId, tenantId, proposalId, assetKind, assetId and version and the tenant of the release in the envelope; a repeated LearningProposalDecided for the same proposal opens no second release and announces the same release id again, and a rejected proposal opens nothing and announces nothing; FeedbackService records the resulting release (RecordResultingRelease), idempotent on the event id, and proves its handling in its own suite (D131) | the transport is unavailable when the dispatcher runs, or the command that opened the release rolled back | AIFACTORY-US-1493 | enriched |

AgentRuntimeService

Service in BC-06; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-AgentRuntimeService-001 | endpoint | GET /runtime/attempts/{attemptId} with scope factory.runs.read | the response is 200 with state, phase, the phases passed, the checkpoints, every call by request hash and receipt reference and never by content, the decision requests, the delegations and the outcome with its hash; nothing is written | the token lacks factory.runs.read or grants no role in the project of the attempt (403); the attempt does not exist or belongs to another tenant (404) | AIFACTORY-US-471 | enriched | | SCN-AgentRuntimeService-002 | endpoint | GET /runtime/attempts/{attemptId}/checkpoints with scope factory.runs.read | the response is 200 with the checkpoints in sequence order, each with sequence, phase, adapter version, hash and creation time and without the adapter state, which stays an opaque blob; nothing is written | the token lacks factory.runs.read or grants no role in the project of the attempt (403); the attempt does not exist or belongs to another tenant (404) | AIFACTORY-US-471 | enriched | | SCN-AgentRuntimeService-003 | endpoint | GET /runtime/releases/{releaseId} with scope factory.assets.read | the response is 200 with, for each adapter version, the release id, the manifest hash, the state (Verified, Rejected or Revoked), the time of verification and the in-flight policy; nothing is written | the token lacks factory.assets.read (403); the release was never loaded by this worker or belongs to another tenant (404) | AIFACTORY-US-463 | enriched | | SCN-AgentRuntimeService-004 | endpoint | gRPC Runtime.Interrupt (internal, none streaming) | the reply carries ack-v1 at once and the request is recorded on the attempt; at the next safe point the loop stops, no further model or tool call is made, calls in flight settle as observed or uncertain, the attempt moves to Cancelled, or to Uncertain when an effect stays unconfirmed, AttemptCancellationObserved is written in the same transaction and one outcome is reported, Cancelled with the failure class cancellation or Uncertain with the class uncertain; a repeated request is acknowledged without a second effect; the same interruption is applied inside the service, without the method, to the running attempts of every run whose pinned release closure holds a release that AssetReleaseRevoked revokes with the in-flight policy revoke, each of which ends Cancelled with the failure class cancellation (trigger ReleaseRevokedWithPolicyRevoke), while under drain the attempt finishes and under finish nothing changes | the caller has no workload identity (UNAUTHENTICATED) or no service scope (PERMISSION_DENIED), the request is invalid (INVALID_ARGUMENT), or the attempt is unknown or belongs to another tenant (NOT_FOUND) | AIFACTORY-US-468 | enriched | | SCN-AgentRuntimeService-005 | endpoint | gRPC Runtime.AnswerDecision (internal, none streaming) | the reply carries ack-v1, the decision request is answered with answeredAt and the attempt returns to Running (trigger DecisionReceived); the same answer repeated is acknowledged without a second effect; an approval is never answered here and arrives through ApprovalDecided | the caller has no workload identity (UNAUTHENTICATED) or no service scope (PERMISSION_DENIED); the request is invalid or names a decision of kind Approval (INVALID_ARGUMENT); the attempt or the decision is unknown or belongs to another tenant (NOT_FOUND); the decision was answered differently or the attempt is not WaitingForDecision (FAILED_PRECONDITION) | AIFACTORY-US-466 | enriched | | SCN-AgentRuntimeService-006 | endpoint | gRPC Runtime.WatchAttempt (internal, server streaming) | the stream delivers each later phase change and checkpoint of the attempt once and in commit order as run-event-envelope-v1, until the attempt is terminal or the subscriber cancels; the method is of class read and nothing is written | the caller has no workload identity (UNAUTHENTICATED) or no service scope (PERMISSION_DENIED), the request is invalid (INVALID_ARGUMENT), or the attempt is unknown or belongs to another tenant (NOT_FOUND) | AIFACTORY-US-471 | enriched | | SCN-AgentRuntimeService-007 | event | AgentRuntimeService publishes AttemptStarted on execution.attempts.v1.attempt-started | the payload carries attemptId, runId, stepId, tenantId, releaseId, snapshotId and fencingToken; the event is published once per attempt and a redelivered AttemptDispatched publishes no second one; the handling by StudioBff, DashboardService and QualityScoreService, idempotent on the event id, is proven by the suite of each consumer | the transport is unavailable; or the attempt cannot start because the lease is held by another holder or the claim names a superseded lease, which Run Control answers with FAILED_PRECONDITION, the release is rejected, the context stays unavailable, or the task contract or the snapshot cannot be read or does not match its hash | AIFACTORY-US-464 | enriched | | SCN-AgentRuntimeService-008 | event | AgentRuntimeService publishes AttemptPhaseChanged on execution.attempts.v1.attempt-phase-changed | the payload carries attemptId, runId, tenantId, phase and state; one event is published per transition, in commit order for one attempt; the handling by StudioBff and DashboardService, idempotent on the event id, is proven by the suite of each consumer | the transport is unavailable | AIFACTORY-US-465 | enriched | | SCN-AgentRuntimeService-009 | event | AgentRuntimeService publishes AttemptCheckpointed on execution.attempts.v1.attempt-checkpointed | the payload carries attemptId, runId, tenantId, checkpointId, sequence and adapterVersion; the handling by DashboardService, idempotent on the event id, is proven by the suite of the consumer | the transport is unavailable; or the artifact store is unavailable when the checkpoint is due | AIFACTORY-US-465 | enriched | | SCN-AgentRuntimeService-010 | event | AgentRuntimeService publishes AttemptDecisionRequested on execution.attempts.v1.attempt-decision-requested | the payload carries attemptId, runId, tenantId, decisionId, kind and, for an approval, approvalId; the handling by StudioBff, StudioNotificationService and DashboardService, idempotent on the event id, is proven by the suite of each consumer | the transport is unavailable; or Run Control refuses or cannot take the approval request | AIFACTORY-US-466 | enriched | | SCN-AgentRuntimeService-011 | event | AgentRuntimeService publishes AttemptCancellationObserved on execution.attempts.v1.attempt-cancellation-observed | the payload carries attemptId, runId, tenantId and uncertainCalls, the number of calls whose effect could not be confirmed; one event is published per attempt; the handling by StudioBff and DashboardService, idempotent on the event id, is proven by the suite of each consumer | the transport is unavailable | AIFACTORY-US-468 | enriched | | SCN-AgentRuntimeService-012 | event | AgentRuntimeService publishes AttemptOutcomeReported on execution.attempts.v1.attempt-outcome-reported | the payload carries attemptId, runId, tenantId, state, the optional failureClass (transient, permanent, policy-denied or validation for a Failed attempt, cancellation for a Cancelled one, uncertain for an Uncertain one and none for Succeeded and TimedOut), outcomeHash, corrections, modelCalls and toolCalls; one event is published per attempt and a report repeated with the same hash writes no second one; the authoritative outcome is AttemptOutcomeRecorded of Run Control; the runtime waits for nothing after its report, and the operator decision for a step that failed under the failure policy Escalate or for an Uncertain outcome on a step of class shared-write or above is opened by Run Control, which keeps the marked invocation id on that decision and where the Operator records the finding on an uncertain tool effect, applied or not-applied, and Run Control records it in ToolAdapterService; the handling by MemoryPromotionService, DashboardService and QualityScoreService, idempotent on the event id, is proven by the suite of each consumer | the transport is unavailable; or Run Control is unreachable, or answers that the fencing token is stale or the attempt already settled | AIFACTORY-US-467 | enriched | | SCN-AgentRuntimeService-013 | event | AgentRuntimeService publishes SubAgentDelegated on execution.attempts.v1.sub-agent-delegated | the payload carries attemptId, runId, tenantId, childRunId, childAgentId and depth; the child is a run of its own that inherits the tenant, the project, the policy revision and the pinned release closure of its parent; it gets no reservation of its own and its usage counts on the reservation of the parent run; its outcome returns through RunCompleted, RunFailed and RunCancelled of Run Control, the result of a completed child being read through the outputRef of RunCompleted and a child stopped for an overrun of its budget, which ends Cancelled with the reason budget-exceeded, being a failed child whose delegation is set to failed for the supervisor attempt; the handling by StudioBff and DashboardService, idempotent on the event id, is proven by the suite of each consumer | the transport is unavailable; or the delegation would exceed the depth limit or Run Control refuses the child run submission, as it does with FAILED_PRECONDITION under a parent run that is terminal or Cancelling | AIFACTORY-US-470 | enriched | | SCN-AgentRuntimeService-014 | event | AgentRuntimeService publishes ReleaseLoaded on execution.releases.v1.release-loaded | the payload carries releaseId, tenantId, manifestHash and adapterVersion; a second load of the same release and adapter version publishes nothing; the handling by DashboardService, idempotent on the event id, is proven by the suite of the consumer | the transport is unavailable; or the registry is unavailable or its stream ends without completion | AIFACTORY-US-463 | enriched | | SCN-AgentRuntimeService-015 | event | AgentRuntimeService publishes ReleaseLoadRejected on execution.releases.v1.release-load-rejected | the payload carries releaseId, tenantId, reason and adapterVersion; every attempt of that release fails with the reason and never runs; the handling by StudioBff, AuditService, which records it as evidence, and DashboardService, idempotent on the event id, is proven by the suite of each consumer | the transport is unavailable | AIFACTORY-US-463 | enriched |

AgentRuntimeWorker

Service in BC-06; first delivered in I3. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-AgentRuntimeWorker-001 | endpoint | GET /runtime/health with scope factory.health.read | liveness answers 200 without a token; the detail is 200 with the aggregated health of AgentRuntimeService, of WorkflowEngineService and of the identity platform; while a cached signing key still validates tokens the gateway stays in rotation and reports degraded, naming the identity platform; a fronted service that does not answer is reported as unavailable in the detail | 503: the identity platform is unreachable and no valid signing key remains | AIFACTORY-US-475 | enriched | | SCN-AgentRuntimeWorker-002 | endpoint | GET /runtime/meta/modules with scope factory.meta.read | the response is 200 with the fronted services AgentRuntimeService and WorkflowEngineService, each with its version and repository; the runtime adapter version, the checkpoint format version and the supported tool schema versions are stated as not available until the model names their source and are never invented by the gateway; nothing is written | no token is presented (401), the token lacks factory.meta.read or holds the scope and none of the roles Observer, Operator and Platform admin (403), or the identity platform is unreachable and no valid signing key remains | AIFACTORY-US-475 | enriched | | SCN-AgentRuntimeWorker-003 | route-class | a request to a read route fronted by AgentRuntimeWorker (AgentRuntimeService, WorkflowEngineService) | the response is served from the fronted service with no side effect and returns unchanged with the correlation id; the routes address a resource by its identifier only, so a 403 for a missing project role and a 404 for a resource of another tenant come from the fronted service and return unchanged | no token, an expired token, an identity token or a user token issued for another gateway (401); a token without the scope of the operation (403); the fronted service does not answer (503) | AIFACTORY-US-473 | enriched | | SCN-AgentRuntimeWorker-004 | route-class | a request to a sandbox route fronted by AgentRuntimeWorker (WorkflowEngineService) | the service validates the workflow DSL document and reports; no shared state changes, the gateway adds no gate of its own to the class, and the response returns unchanged with the correlation id | no token, an expired token, an identity token or a user token issued for another gateway (401); a token without factory.assets.write (403); WorkflowEngineService does not answer (503) | AIFACTORY-US-473 | enriched |

AlertRuleService

Service in BC-21; first delivered in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-AlertRuleService-001 | endpoint | GET /factory/alerts with scope factory.operations.read | the response is 200 with the alert instances of the trusted tenant that match the filter, each with rule, deduplication key, source reference, state, acknowledgement and deliveries; no instance of another tenant is returned and nothing is written | 403: the caller's scope lacks factory.operations.read | AIFACTORY-US-1120 | enriched | | SCN-AlertRuleService-002 | endpoint | POST /factory/alerts/{alertId}/acknowledge with scope factory.operations.operate | the response is 200, the instance is Acknowledged with acknowledgedBy set to the caller and the time to acknowledge recorded, no event is published, and a repeat returns 200 and changes nothing | 403: the caller's scope lacks factory.operations.operate; 404: no alert with that id exists in the caller's tenant, which is also the answer for an alert of another tenant (ADR-0015) | AIFACTORY-US-1120 | enriched | | SCN-AlertRuleService-003 | endpoint | POST /factory/alerts/{alertId}/resolve with scope factory.operations.operate | the response is 200, the instance is Resolved with resolvedAt set, and the AlertResolved outbox record with resolvedBy naming the caller is written in the same transaction | 403: the caller's scope lacks factory.operations.operate; 404: no alert with that id exists in the caller's tenant, which is also the answer for an alert of another tenant (ADR-0015) | AIFACTORY-US-1120 | enriched | | SCN-AlertRuleService-004 | endpoint | GET /factory/alert-rules with scope factory.operations.read | the response is 200 with the rules of the trusted tenant only, each with name, source kind, severity, routes and whether it is active, and nothing is written | 403: the caller's scope lacks factory.operations.read | AIFACTORY-US-1116 | enriched | | SCN-AlertRuleService-005 | endpoint | PUT /factory/alert-rules/{name} with scope factory.operations.admin | the response is 200, one AlertRule row exists for the tenant and the name with the values of the body, and the AlertRuleChanged outbox record is written in the same transaction; a repeat of the same body changes nothing and writes no record, and a rule of the same name in another tenant is untouched | 403: the caller's scope lacks factory.operations.admin; or the body routes to an external channel without a connector, or deactivates a platform rule | AIFACTORY-US-1116 | enriched | | SCN-AlertRuleService-006 | event | AlertRuleService publishes AlertRuleChanged on operations.alerts.v1.alert-rule-changed | the payload carries ruleId, tenantId, name and active; the consumers StudioBff (RefreshAlertRuleView) and AuditService (RecordEvidence) handle it in their own suites, idempotent on the event id | the transport is unavailable | AIFACTORY-US-1116 | enriched | | SCN-AlertRuleService-007 | event | AlertRuleService publishes AlertFired on operations.alerts.v1.alert-fired | the payload carries alertId, tenantId, ruleId, severity, sourceRef and dedupKey; a further event with the same key writes no second instance and no second event; the consumers StudioBff (RefreshAlertInstanceView), StudioNotificationService (NotifyOperators), StudioRealtimeGateway (PushAlert) and, from I7, FleetIncidentService (OpenFromAlert) handle it in their own suites, idempotent on the event id; the handler ProjectAlertInstance of DashboardService is not registered while the owner decides the projections the model does not hold | the transport is unavailable | AIFACTORY-US-1117 | enriched | | SCN-AlertRuleService-008 | event | AlertRuleService publishes AlertResolved on operations.alerts.v1.alert-resolved | the payload carries alertId, tenantId and, for a manual resolution only, resolvedBy; the consumers StudioBff (RefreshAlertInstanceView) and StudioRealtimeGateway (PushAlert) handle it in their own suites, idempotent on the event id; the handler ProjectAlertInstance of DashboardService is not registered while the owner decides the projections the model does not hold | the transport is unavailable | AIFACTORY-US-1120 | enriched |

ApprovalPolicyService

Service in BC-20; first delivered in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ApprovalPolicyService-001 | endpoint | GET /factory/approval-rules with scope factory.policies.read | the response is 200 with a page of rules, each with scope, action class, action pattern, approver roles, exclusions, quorum, expiry, on-expiry rule, re-request limit, break-glass allowance, policy revision and active flag: the platform rules, the tenant rules of the tenant of the token and the rules of the projects in which the caller holds a role, and the rules of every project of the tenant for the Platform admin; no rule of another tenant is listed; nothing is written | 401: no token or an expired token; 403: the token lacks factory.policies.read, or it is a workload token, which no REST operation admits; 503: approval-policy-sql does not answer | AIFACTORY-US-924 | enriched | | SCN-ApprovalPolicyService-002 | endpoint | POST /factory/projects/{projectId}/approval-rules/validate with scope factory.policies.write | the response is 200 with the result: valid, or not valid with every offending rule listed with its action class, the member that loosens and the tenant value it loosens; nothing is stored, no rule changes and no event is published, so a validated rule is not in force until a policy revision that carries it is activated | 400: the body cannot be read as rules, names an unknown action class or role, or names a scope other than the project of the path; 401: no token or an expired token; 403: the token lacks the scope, it is a workload token, or the caller is neither Workspace admin of the project nor Platform admin; 404: a Platform admin names a project that does not exist in the tenant (ADR-0015 amendment D113) | AIFACTORY-US-924 | enriched | | SCN-ApprovalPolicyService-003 | endpoint | GET /factory/approvals/{approvalId}/routing with scope factory.approvals.read | the response is 200 with the latest routing evaluation of the approval: the rule applied, the eligible approvers, the quorum, the expiry and the outcome; nothing is written | 401: no token or an expired token; 403: the token lacks the scope, it is a workload token, or the caller holds no role in the project of the approval; 404: the tenant of the token holds no routing evaluation for the approval id, whether the approval belongs to another tenant or was never routed (ADR-0015 amendment D113) | AIFACTORY-US-925 | enriched | | SCN-ApprovalPolicyService-004 | endpoint | gRPC ApprovalPolicy.Route (internal, none streaming) | the service takes the rule of the action class from the rules it holds for the pinned revision, a matching action pattern first, and for a revision it does not hold, as every seeded tenant bundle that publishes no event (D127), asks Policy.Decide of PolicyEngineService with the action kind approval-eligibility, takes the rule from the obligations of the decision and keeps it under that revision as it was read (D126, D136); it never uses a rule of a newer revision, resolves the eligible approvers through Projects.ListRoleHolders of ProjectService from the memberships and delegations in force, without the requester, without the author where the rule excludes the author and without a Platform admin, needs no run, sets the expiry within the platform maximum, writes one RoutingEvaluation and the ApprovalRouted outbox record in one transaction and replies with the evaluation id, the rule id, the approvers, the quorum, the expiry, onExpiry and maxReRequests, which RunControlService copies onto its request with the evaluation id; the outcome is Eligible, or NoEligibleApprover when fewer approvers are eligible than the quorum needs, in which case the request stays Pending in RunControlService; a repeat for the same approval id returns the first evaluation and writes nothing | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope or is a user token; INVALID_ARGUMENT: no approval id, no subject, no requester, no action class, a subject kind outside the closed list or an action class outside the five; FAILED_PRECONDITION: the decision of PolicyEngineService carries no approval rule for the action class, or the pinned revision is not held by the tenant of the call; UNAVAILABLE: PolicyEngineService or ProjectService does not answer, or approval-policy-sql does not answer or the transaction fails | AIFACTORY-US-925 | enriched | | SCN-ApprovalPolicyService-005 | endpoint | gRPC ApprovalPolicy.ValidateDecision (internal, none streaming) | the service checks in this order that the decider is not the requester, is not the author where the rule excludes the author, decides before expiresAt of the routing and holds an approver role of the rule in the project now, by the memberships and delegations at decision time read through Projects.ListRoleHolders (D126, D136); the outcome is Eligible with the quorum met or not met, RequesterExcluded, AuthorExcluded, Expired or Invalid; a break-glass decision of a Platform admin is Eligible only when the rule allows break-glass, the identity platform confirms the role and the request carries a reason; every validation, valid or not, writes one RoutingEvaluation and the ApprovalDecisionValidated outbox record in one transaction; the service records no decision and advances no run; a repeat for the same approval, decider and decision returns the first evaluation | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope or is a user token; INVALID_ARGUMENT: no approval id, no decider or no decision; NOT_FOUND: the approval was never routed in the tenant of the call, which includes an approval of another tenant; UNAVAILABLE: ProjectService does not answer, the identity platform does not answer for a break-glass decision, or approval-policy-sql does not answer or the transaction fails | AIFACTORY-US-926 | enriched | | SCN-ApprovalPolicyService-006 | event | ApprovalPolicyService publishes ApprovalRuleActivated on approval-policy.rules.v1.approval-rule-activated | the payload carries ruleId, tenantId, scope, actionClass and policyRevision; a redelivered event and a revision already in force publish nothing; StudioBff (RefreshApprovalRuleView) and AuditService (RecordEvidence) handle the event once, idempotent on the event id, in their own suites | the transport is unavailable or a consumer throws; or the rule set of the revision is invalid; or Policy.Decide does not answer or ends UNAVAILABLE | AIFACTORY-US-923 | enriched | | SCN-ApprovalPolicyService-007 | event | ApprovalPolicyService publishes ApprovalRouted on approval-policy.routing.v1.approval-routed | the payload carries evaluationId, approvalId, tenantId, the outcome Eligible or NoEligibleApprover and expiresAt; a repeated routing call publishes nothing, and a re-route writes a new evaluation and a new event for the same approval; StudioNotificationService (NotifyApprovers) and AuditService (RecordEvidence) handle the event once, idempotent on the event id, in their own suites | the transport is unavailable or a consumer throws | AIFACTORY-US-925 | enriched | | SCN-ApprovalPolicyService-008 | event | ApprovalPolicyService publishes ApprovalDecisionValidated on approval-policy.routing.v1.approval-decision-validated | the payload carries evaluationId, approvalId, tenantId, deciderId, outcome and breakGlass and no reason text; every validation is announced, the refused ones included, so that a break-glass decision is always audited; AuditService (RecordEvidence) handles the event once, idempotent on the event id, in their own suites | the transport is unavailable or a consumer throws | AIFACTORY-US-926 | enriched |

ArtifactService

Service in BC-12; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ArtifactService-001 | endpoint | GET /factory/artifacts/{artifactId} with scope factory.artifacts.read | the response is 200 with the metadata of the artifact (artifact-v1), its lineage edges, its position in the version chain (chainId, versionInChain, the latest version of the chain and the state), its validation as passed and validationRef once a verdict is recorded and as validation.status (unvalidated, valid or invalid), which is read from passed, and a scoped download reference, which is a delegated, read-only reference of the blob store for the one blob of this artifact, limited in time and without an account credential; a Deleted artifact is returned with the state Deleted, its metadata and lineage and no download reference; nothing is written | 403: the token lacks factory.artifacts.read or holds no role in the project of the artifact; 404: no artifact with that artifactId exists in the tenant of the caller; an artifact of another tenant is not found under the tenant row filter of the service and is answered 404, the same answer as for an identifier that does not exist (ADR-0015) | AIFACTORY-US-787 | enriched | | SCN-ArtifactService-002 | endpoint | GET /factory/artifacts/{artifactId}/preview with scope factory.artifacts.read | the response is 200 with the rendered preview and the name of the renderer; a restricted field is redacted in every case; the outcome allow shows the content and the outcome allow-with-constraints replaces it by its reference, hash and size; the preview is a projection: no artifact, blob, row or event is created and no second copy of the content exists | 403: the token lacks the scope or a role in the project of the artifact, or the outcome of the decision is deny or allow-with-approval, which the service never grants itself; 404: the artifact does not exist in the tenant of the caller, which is also the answer for an artifact of another tenant (ADR-0015), or it has no preview because it is Deleted or no enabled renderer serves its kind and media type; or PolicyEngineService or artifact-blob does not answer | AIFACTORY-US-788 | enriched | | SCN-ArtifactService-003 | endpoint | GET /factory/artifacts/{artifactId}/versions with scope factory.artifacts.read | the response is 200 with every version of the chain in ascending order, each with artifactId, versionInChain, contentHash, state and createdAt; superseded and deleted versions are listed with their state; nothing is written | 403: the token lacks factory.artifacts.read or holds no role in the project of the artifact; 404: no artifact with that artifactId exists in the tenant of the caller, which is also the answer for an artifact of another tenant (ADR-0015) | AIFACTORY-US-787 | enriched | | SCN-ArtifactService-004 | endpoint | GET /factory/runs/{runId}/artifacts with scope factory.runs.read | the response is 200 with exactly the artifacts that run produced in the projects the token grants, each with its state, its validation (validation.status with validationRef) and the final-output mark, the field finalOutput that SealRunArtifacts sets when RunCompleted of RunControlService arrives; a runId of which the service holds no artifact visible to the caller, that is an unknown run, a run of another tenant (ADR-0015), a run of a project the token does not grant or a run that produced nothing yet, is answered 200 with an empty list, because the service holds no record of runs and the answer never confirms that a run exists (D125); nothing is written | 403: the token lacks factory.runs.read; the operation has no 404 | AIFACTORY-US-787 | enriched | | SCN-ArtifactService-005 | endpoint | POST /factory/projects/{projectId}/artifacts/export with scope factory.artifacts.admin | the response is 202 with the export request; ExportWorker picks the recorded request up from ExportRequests, without any event of ProjectService (D125), produces the package (records as JSON, content in its original format under its hash, reports as Markdown), stores it as one artifact of kind Export announced by ArtifactStored and completes the request in the same transaction; a request the worker finds a second time builds one package; a repeated call with the same Idempotency-Key in the same tenant and project returns the same request and starts nothing | 403: the token lacks the scope or a role in the project, or the outcome of the decision is deny, allow-with-approval or allow-with-constraints, because the service never grants an approval itself and can apply no constraint to a package; 404: the tenant of the caller holds no version chain in the project, which is also the answer for a project of another tenant (ADR-0015); or the worker fails its five attempts | AIFACTORY-US-790 | enriched | | SCN-ArtifactService-006 | endpoint | gRPC Artifacts.Store (internal, client streaming) | the reply carries artifact-v1 with artifactId, contentHash and contentRef; the store is idempotent on tenant and hash within a chain for an artifact that still holds content, so a repeat returns the existing artifact, a Superseded one included, and writes no row, blob or event, while a hash that matches only a Deleted artifact of the chain is written as a new version with its blob; connectsoft.factory.artifacts.stored and connectsoft.factory.artifacts.bytes move | the caller has no workload identity (UNAUTHENTICATED); the token lacks the service scope, or the outcome of the decision is deny, allow-with-approval or allow-with-constraints (PERMISSION_DENIED with the decision id); the metadata is invalid, the stated hash differs from the content or the content exceeds Knowledge:Artifacts:MaxArtifactMb (INVALID_ARGUMENT); artifact-blob or PolicyEngineService does not answer, or artifact-sql fails after the blob was written (UNAVAILABLE); or held content of the tenant has the same hash and another size, a suspected collision (FAILED_PRECONDITION) | AIFACTORY-US-784 | enriched | | SCN-ArtifactService-007 | endpoint | gRPC Artifacts.Fetch (internal, server streaming) | the server stream delivers the artifact-v1 metadata message and then the content as it was stored, and completes; the bytes have the hash contentHash states, which the caller compares; nothing is written and no event is published | the caller has no workload identity (UNAUTHENTICATED); the token lacks the service scope or the workload forwards another project of the tenant (PERMISSION_DENIED); the request names neither an identifier nor a reference (INVALID_ARGUMENT); the tenant of the caller holds no such artifact, which is also the case of an artifact of another tenant (NOT_FOUND, ADR-0015); the artifact is Deleted (FAILED_PRECONDITION); or artifact-blob does not answer | AIFACTORY-US-785 | enriched | | SCN-ArtifactService-008 | endpoint | gRPC Artifacts.RecordValidation (internal, none streaming) | the artifact moves from Stored to Validated (trigger ValidationRecorded) with validationRef set and the verdict kept in the field passed (D125), ArtifactValidated is written in the same transaction and the reply is ack-v1 stating accepted; the artifact-v1 metadata then carries passed and validationRef and shows validation.status, read from passed, valid for a passed and invalid for a failed verdict, where it showed unvalidated before; a repeat of the recorded verdict with the recorded reference is accepted and changes nothing in every state that still carries that validationRef | the caller has no workload identity (UNAUTHENTICATED); the token lacks the service scope or the workload forwards another project of the tenant (PERMISSION_DENIED); the request names no artifact or no validationRef (INVALID_ARGUMENT); the tenant of the caller holds no such artifact, which is also the case of an artifact of another tenant (NOT_FOUND, ADR-0015); artifact-sql does not answer (UNAVAILABLE); or the artifact carries another verdict or reference, or is Superseded or Deleted without a verdict, for which the model has no transition | AIFACTORY-US-786 | enriched | | SCN-ArtifactService-009 | event | ArtifactService publishes ArtifactStored on artifacts.artifacts.v1.artifact-stored | the payload carries artifactId, tenantId, kind, contentHash, chainId, versionInChain and, when set, producerRunId and descriptor, and no content; it carries projectId for a project artifact and none for a tenant-level artifact (D125); StudioBff (RefreshArtifactView), DashboardService (ProjectArtifact), KnowledgeIngestionService (IngestArtifact), MemoryPromotionService (LinkEvidence), WorkflowEngineService (CorrelateArtifact) and GenerationRecipeService (TrackDesignInputs) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-784 | enriched | | SCN-ArtifactService-010 | event | ArtifactService publishes ArtifactValidated on artifacts.artifacts.v1.artifact-validated | the payload carries artifactId, tenantId, passed and validationRef and not the content of the validation record; BlueprintService (AttachValidation), PipelineExecutionService (LinkValidation), FeedbackService (HarvestValidation), StudioBff (RefreshArtifactView) and QualityScoreService (CollectValidationStats) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-786 | enriched | | SCN-ArtifactService-011 | event | ArtifactService publishes ArtifactSuperseded on artifacts.artifacts.v1.artifact-superseded | the payload carries the artifactId of the superseded version, tenantId, chainId and newArtifactId; StudioBff (RefreshArtifactView) handles it exactly once, idempotent on the event id; the superseded version stays readable by its identifier and its hash | the transport is unavailable or the consumer throws | AIFACTORY-US-784 | enriched | | SCN-ArtifactService-012 | event | ArtifactService publishes ArtifactDeleted on artifacts.artifacts.v1.artifact-deleted | the payload carries artifactId, tenantId and reason and no content; the content is removed from artifact-blob after the commit, unless another artifact of the tenant that still has content references it, and the pending removal is cleared; AuditService (RecordEvidence) and DashboardService (ProjectArtifact) each handle the event exactly once, idempotent on the event id; connectsoft.factory.artifacts.deleted counts the deletion | the transport is unavailable, a consumer throws, or the blob store does not answer when the content is removed | AIFACTORY-US-789 | enriched | | SCN-ArtifactService-013 | event | ArtifactService publishes ProjectDataOffboarded on artifacts.projects.v1.project-data-offboarded | the payload carries projectId, tenantId and outcome, exported or deleted; ProjectService (RecordDataOffboarded) handles it exactly once, idempotent on the event id, and moves the project to Closed only after this confirmation and the one of RunControlService (D117); one confirmation is written per closing project, also for a project without artifacts | the transport is unavailable or the consumer throws, the export failed its five attempts, or the blob store does not answer while the content of a deleted project is removed | AIFACTORY-US-790 | enriched |

AuditService

Service in BC-19; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-AuditService-001 | endpoint | GET /factory/audit with scope factory.audit.read | the response is 200 with the matching entries in pages in the order of the tenant sequence, each with kind, actor, action, target, outcome, sourceEvent, recordedAt, previousHash and entryHash and with the signed head of the tenant that covers it, so that its chain position can be verified; evidence of another tenant is never returned, a filter that names a run or an actor of another tenant returns an empty page, and nothing is written | 403: the token lacks factory.audit.read or names a project of the tenant in which the caller holds no role; 400: a filter cannot be parsed (a code the model omits) | AIFACTORY-US-966 | enriched | | SCN-AuditService-002 | endpoint | POST /factory/projects/{projectId}/audit/export with scope factory.audit.export | the response is 202 with the identifier of the export request; a repeated call with the same Idempotency-Key and the same input returns the same request and changes nothing | 403: the token lacks factory.audit.export; 404: the tenant of the caller holds no evidence for that project, which is the one answer for a project that does not exist and a project of another tenant (ADR-0015); 400: the key header is missing; 409: the same key arrives with another input (400 and 409 are codes the model omits); or ArtifactService does not answer while the worker stores the package | AIFACTORY-US-967 | enriched | | SCN-AuditService-003 | endpoint | GET /factory/classifications with scope factory.audit.read | the response is 200 with the labels of the tenant per resource type, each with dataClass, retentionDays, residency, setBy, setAt and its redaction rules with identifier, detector, action and the projections they apply to; no label of another tenant is returned and nothing is written | 403: the token lacks factory.audit.read | AIFACTORY-US-968 | enriched | | SCN-AuditService-004 | endpoint | PUT /factory/classifications/{resourceType} with scope factory.audit.admin | the response is 200 with the label; a call that sets what the label already holds answers 200 and writes no event and no entry | 403: the token lacks factory.audit.admin; 409: the label of one resource would be weaker than the default of its type, or a new default of a type would leave an existing instance label weaker than it; 400: the body names an unknown class, detector, action or projection, a rule whose redactor is not registered, no retentionDays or no residency (a code the model omits) | AIFACTORY-US-968 | enriched | | SCN-AuditService-005 | endpoint | GET /factory/findings with scope factory.audit.read | the response is 200 with the matching findings of the tenant in pages, each with severity, category, evidence entries, state, raisedAt and resolvedAt; no finding of another tenant is returned and nothing is written | 403: the token lacks factory.audit.read | AIFACTORY-US-970 | enriched | | SCN-AuditService-006 | endpoint | POST /factory/findings/{findingId}/resolve with scope factory.audit.admin | the response is 200; connectsoft.factory.audit.findings_open falls; a repeated call with the same state answers 200 and changes nothing | 403: the token lacks factory.audit.admin; 404: no finding with that findingId exists in the tenant of the caller, a finding of another tenant being answered the same (ADR-0015); 400: the reason is missing or the state is neither resolved nor accepted-risk; 409: the finding already ended in the other state (400 and 409 are codes the model omits) | AIFACTORY-US-970 | enriched | | SCN-AuditService-007 | endpoint | gRPC Audit.Record (internal, none streaming) | the reply carries ack-v1 after the entry is committed; a repeated call with the same record is answered OK with ack-v1 and leaves one entry | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope; INVALID_ARGUMENT: the record fails the schema, carries chainHash or names another tenant than the forwarded one; ALREADY_EXISTS: the same evidence identifier arrives with other content; UNAVAILABLE: audit-sql does not answer | AIFACTORY-US-964 | enriched | | SCN-AuditService-008 | endpoint | gRPC Audit.Classify (internal, none streaming) | the reply carries the data class, the retention, the redaction rule identifiers and the residency, with the configured default stated as such and carrying no retention and no rule; nothing is written and no label of another tenant is resolved | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope; INVALID_ARGUMENT: the resource type is missing | AIFACTORY-US-968 | enriched | | SCN-AuditService-009 | endpoint | gRPC Audit.Redact (internal, none streaming) | the reply carries the artifact-v1 of the redacted artifact with its reference, its hash and the applied rule identifiers; the same request repeated returns the same artifact; when no rule applies nothing is stored and the reply names the input; the content is held in memory for the call only and reaches no row, event, log record or metric | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope; INVALID_ARGUMENT: the reference, the resource or the projection is missing; NOT_FOUND: the artifact does not exist or belongs to another tenant (ADR-0015); a redactor fails; UNAVAILABLE with the failure class transient: ArtifactService does not answer | AIFACTORY-US-969 | enriched | | SCN-AuditService-015 | endpoint | gRPC Audit.RaiseFindings (internal, none streaming) | the reply carries ack-v1 after the transaction commits and connectsoft.factory.audit.findings_open rises for each recorded finding; a finding id already recorded is neither recorded nor published again, so a retried step raises nothing twice, and a call whose findings are all recorded appends no entry, publishes nothing and answers ack-v1; a finding of another tenant is never touched | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks factory.audit.write; INVALID_ARGUMENT: the document fails docs/reference/schemas/findings.schema.json or its count critical differs from the findings of severity critical it lists; UNAVAILABLE: audit-sql does not answer | AIFACTORY-US-1516 | enriched | | SCN-AuditService-010 | event | AuditService publishes AuditEntryRecorded on audit.evidence.v1.audit-entry-recorded | the payload carries entryId, tenantId, sequence, kind, action and, for an entry that names a run, runId, and no reason, actor or target; the event has no consumer (D131) and is published for subscribers that a later delivery adds | the transport is unavailable or the consumer throws | AIFACTORY-US-964 | enriched | | SCN-AuditService-011 | event | AuditService publishes AuditChainVerified on audit.evidence.v1.audit-chain-verified | the payload carries tenantId, headSequence and valid, true for a verified and signed head and false for a break with the sequence of the last valid head; connectsoft.factory.audit.chain_valid is one or zero for the tenant; a later run whose span holds only the verification entry of the previous run moves the head onto it and appends none; the event has no consumer (D131) | the signing port does not answer, the transport is unavailable or the consumer throws | AIFACTORY-US-965 | enriched | | SCN-AuditService-012 | event | AuditService publishes ClassificationChanged on audit.classification.v1.classification-changed | the payload carries labelId, tenantId, resourceType, dataClass, retentionDays and, for the label of one resource, resourceId; ContextBuilderService, ArtifactService, KnowledgeIngestionService and ModelRouterService apply the label from their next operation on (ApplyClassification) and StudioBff refreshes its view (RefreshClassificationLabelView), each exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-968 | enriched | | SCN-AuditService-013 | event | AuditService publishes FindingRaised on audit.findings.v1.finding-raised | the payload carries findingId, tenantId, severity and category and no evidence text; AlertRuleService (FireFromFinding), StudioNotificationService (NotifyOperators), and StudioBff (RefreshFindingView) each handle it exactly once, idempotent on the event id; connectsoft.factory.audit.findings_open rose for the tenant and the severity | the transport is unavailable or a consumer throws | AIFACTORY-US-970 | enriched | | SCN-AuditService-014 | event | AuditService publishes FindingResolved on audit.findings.v1.finding-resolved | the payload carries findingId, tenantId and state; StudioBff (RefreshFindingView) handles it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-970 | enriched |

BlueprintService

Service in BC-02; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-BlueprintService-001 | endpoint | GET /factory/blueprints with scope factory.blueprints.read | the response is 200 with the blueprints of the named project that match the filter, each with its versions, their kind, state, schema version, document hash and author; a Draft version authored by a run is listed and flagged with its run (D64); no row of another tenant or of a project outside the trusted scope appears, and nothing is written | 400: the call carries no projectId; 403: the scope of the caller lacks factory.blueprints.read, the gateway finds that the roles of the token do not grant the named project, or the named project differs from the project of the trusted scope the service receives | AIFACTORY-US-675 | enriched | | SCN-BlueprintService-002 | endpoint | GET /factory/blueprints/{blueprintId}/versions/{version} with scope factory.blueprints.read | the response is 200 with the state, kind and schema version of the version, the reference and hash of its document, the validation report reference with its findings, the context map and domain model references, the release id once Published and the author, with the run and attempt of a version authored by a run; the content of the document is not part of the answer and nothing is written | 403: the scope of the caller lacks factory.blueprints.read; 404: no version with that blueprintId and version exists in the tenant and project of the caller; a version of another tenant is not found under the tenant row filter of the service and is answered 404, the same answer as for an id that does not exist (ADR-0015) | AIFACTORY-US-675 | enriched | | SCN-BlueprintService-003 | endpoint | POST /factory/blueprints with scope factory.blueprints.write | the response is 201 with the version reference; no integration event of the service is published, because the model names none for this command, and one audit-evidence-v1 record with the actor, the blueprint id, the version, the kind and the document hash is written to the outbox in the transaction of the command; connectsoft.factory.blueprints.versions counts the Draft; a repeated call with the same Idempotency-Key, and the same document under another key, return the existing version and change nothing; a document with another hash for an existing Draft or Validated version of the tenant replaces its document, and a Validated version then returns to Draft through DocumentChanged; a blueprint id and version that only another tenant holds are stored as a Draft version of the tenant of the caller | 400: the body carries no projectId; 403: the scope of the caller lacks factory.blueprints.write, the gateway finds that the roles of the token do not grant the named project, or the named project differs from the project of the trusted scope the service receives; 409: the same Idempotency-Key arrives with another document (ADR-0014 decision 3), or the addressed version is Submitted, Published or Deprecated, a state conflict; 422: the metadata is invalid, the kind is unknown or the document names another project than the trusted scope; 503: ArtifactService, a required dependency that fails fast, does not answer | AIFACTORY-US-674 | enriched | | SCN-BlueprintService-004 | endpoint | POST /factory/blueprints/{blueprintId}/versions/{version}/validate with scope factory.blueprints.write | the response is 200 with the receipt; a passed version moves from Draft to Validated for exactly the validated document hash and a failed version stays Draft; a Module Blueprint passes the rule MOD-002 when every switch it uses is declared by the manifest of its pinned template version, and a switch the manifest does not declare is a finding with that rule id that fails the validation; BlueprintValidated with passed true or false is written in the same transaction; for a passed Service or Module Blueprint the context map and the domain models are derived in that transaction; a repeated call for the same version and document hash returns the same receipt and publishes nothing again | 403: the scope of the caller lacks factory.blueprints.write; 404: the version does not exist in the tenant and project of the caller, a version of another tenant included (ADR-0015); 409: the version is Submitted, Published or Deprecated, a state conflict; 503: a required dependency that fails fast does not answer, ArtifactService for every kind or TemplateRegistryService for a Module Blueprint; a schema version the registry of schemas cannot resolve is not a refusal but a receipt with passed false that names the schema id | AIFACTORY-US-676 | enriched | | SCN-BlueprintService-005 | endpoint | POST /factory/blueprints/{blueprintId}/versions/{version}/submit with scope factory.blueprints.publish | the response is 202; the release candidate is opened by Asset Publication from the event, and the version becomes Published only when Asset Publication announces the release; a repeated call for a version already Submitted returns 202 and writes nothing | 403: the scope of the caller lacks factory.blueprints.publish; 404: the version does not exist in the tenant and project of the caller, a version of another tenant included (ADR-0015); 409: the version is Draft, Published or Deprecated, or a Service or Module version has no derived context map and domain model | AIFACTORY-US-678 | enriched | | SCN-BlueprintService-006 | endpoint | gRPC Blueprints.SubmitDraftVersion (internal, none streaming) | the reply carries blueprint-version-ref-v1 with blueprint id, version, kind, document hash, state, tenant and project; the version is visible to the readers of the project; a second call with the same document hash returns the same version and creates none; no integration event of the service is published, and one audit-evidence-v1 record with the run and its attempt as actor is written to the outbox in the transaction of the command | the caller has no workload identity (Unauthenticated), its token lacks the service scope (PermissionDenied), the body is no document of a blueprint kind, fails the metadata check or names another project than the forwarded scope (InvalidArgument), the addressed version is Submitted, Published or Deprecated (FailedPrecondition), or ArtifactService does not answer (Unavailable) | AIFACTORY-US-674 | enriched | | SCN-BlueprintService-007 | endpoint | gRPC Blueprints.Validate (internal, none streaming) | the reply carries blueprint-validation-receipt-v1 with receipt id, document hash, schema version, rule set version, verdict, finding counts, report reference, derived references, idempotency key and receipt hash; the call itself writes only the receipt, and the service moves the version from Draft to Validated when it records ValidationPassed for that exact document hash and leaves it Draft when the receipt fails; BlueprintValidated is written in the transaction of the verdict; a repeated call for the same version and document hash returns the same receipt and publishes nothing again | the caller has no workload identity (Unauthenticated), its token lacks the service scope (PermissionDenied), the request is invalid (InvalidArgument), the version is unknown or belongs to another tenant (NOT_FOUND, ADR-0015), the version is Submitted, Published or Deprecated (FailedPrecondition), or a required dependency does not answer, ArtifactService for every kind or TemplateRegistryService for a Module Blueprint (Unavailable) | AIFACTORY-US-676 | enriched | | SCN-BlueprintService-008 | endpoint | gRPC Blueprints.GetDerivedModel (internal, none streaming) | the reply carries artifact-v1 with the references and content hashes of the context map and of the domain models of that version; nothing is written | the caller has no workload identity (Unauthenticated), its token lacks the service scope (PermissionDenied), the request is invalid (InvalidArgument), the version is unknown or belongs to another tenant (NOT_FOUND, ADR-0015), or the version has no derived models (FailedPrecondition) | AIFACTORY-US-677 | enriched | | SCN-BlueprintService-009 | event | BlueprintService publishes BlueprintValidated on blueprints.versions.v1.blueprint-validated | the payload carries blueprintId, version, tenantId, projectId, kind, passed, validationReportRef and documentHash and no document content; WorkflowEngineService (CorrelateBlueprint), RunControlService (MarkApprovalStale), GenerationRecipeService (InvalidateDrafts, TrackDesignInputs), StudioBff (RefreshBlueprintVersionView) and AuditService (RecordEvidence) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-676 | enriched | | SCN-BlueprintService-010 | event | BlueprintService publishes BlueprintSubmitted on blueprints.versions.v1.blueprint-submitted | the payload carries blueprintId, version, tenantId and projectId; AgentRegistryService (OpenReleaseCandidate), GenerationRecipeService (TrackBindableBlueprints), StudioBff (RefreshBlueprintVersionView) and AuditService (RecordEvidence) each handle it exactly once, idempotent on the event id; GenerationRecipeService keeps the Submitted version as one a recipe may bind until the evaluation gate of I4; the handler of AgentRegistryService arrives with its complete delivery in I4, after its publication path of I2 (D140), and until then the version stays Submitted | the transport is unavailable or a consumer throws | AIFACTORY-US-678 | enriched | | SCN-BlueprintService-011 | event | BlueprintService publishes BlueprintPublished on blueprints.versions.v1.blueprint-published | the payload carries blueprintId, version, tenantId, projectId and releaseId; GenerationRecipeService (OfferRecipe), StudioBff (RefreshBlueprintVersionView), AuditService (RecordEvidence) and DashboardService (ProjectBlueprintVersion) each handle it exactly once, idempotent on the event id; no command of BlueprintService publishes this event | the transport is unavailable or a consumer throws; the asset release event is delivered twice, names no Submitted version or names another tenant | AIFACTORY-US-678 | enriched | | SCN-BlueprintService-012 | event | BlueprintService publishes ContextMapDerived on blueprints.models.v1.context-map-derived | the payload carries contextMapId, tenantId, projectId, blueprintId, blueprintVersion and contexts, the number of bounded contexts, and no model content; WorkflowEngineService (CorrelateSignal), GenerationRecipeService (ProposeModulePlan) and StudioBff (RefreshContextMapView) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-677 | enriched | | SCN-BlueprintService-013 | event | BlueprintService publishes DomainModelDerived on blueprints.models.v1.domain-model-derived | the payload carries domainModelId, tenantId, projectId, blueprintId, contextId and aggregates, the number of aggregates, and no model content; WorkflowEngineService (CorrelateSignal), GenerationRecipeService (ProposeModulePlan) and StudioBff (RefreshDomainModelView) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-677 | enriched |

ComputePoolService

Service in BC-41; first delivered in I8. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ComputePoolService-001 | endpoint | GET /factory/compute-pools with scope factory.compute.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-ComputePoolService-002 | endpoint | POST /factory/compute-pools with scope factory.compute.admin | the response is 201; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-ComputePoolService-003 | endpoint | POST /factory/compute-pools/{poolId}/drain with scope factory.compute.admin | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-ComputePoolService-004 | endpoint | POST /factory/compute-pools/{poolId}/warm with scope factory.compute.admin | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-ComputePoolService-005 | endpoint | GET /factory/compute-pools/placements/{placementId} with scope factory.compute.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-ComputePoolService-006 | endpoint | gRPC ComputePools.Place (internal, none streaming) | the reply carries model-invocation-v1 and the side effect of the method's class happens once | the caller has no workload identity or the request fails validation | — | derived | | SCN-ComputePoolService-007 | endpoint | gRPC ComputePools.ReportUtilization (internal, client streaming) | the reply carries ack-v1 and the side effect of the method's class happens once | the caller has no workload identity or the request fails validation | — | derived | | SCN-ComputePoolService-008 | event | ComputePoolService publishes ComputePoolRegistered on compute-pools.pools.v1.compute-pool-registered | the payload carries poolId, tenantId, kind, region, securityBoundary; each consumer (StudioBff (RefreshComputePoolView), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-ComputePoolService-009 | event | ComputePoolService publishes ComputePoolStateChanged on compute-pools.pools.v1.compute-pool-state-changed | the payload carries poolId, tenantId, fromState, toState; each consumer (StudioBff (RefreshComputePoolView), AuditService (RecordEvidence), ModelRouterService (UpdateDeploymentAvailability)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-ComputePoolService-010 | event | ComputePoolService publishes ModelWarmed on compute-pools.cache.v1.model-warmed | the payload carries poolId, tenantId, model, vramGb; each consumer (ModelRouterService (UpdateDeploymentAvailability)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-ComputePoolService-011 | event | ComputePoolService publishes ModelEvicted on compute-pools.cache.v1.model-evicted | the payload carries poolId, tenantId, model, reason; each consumer (ModelRouterService (UpdateDeploymentAvailability)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-ComputePoolService-012 | event | ComputePoolService publishes PlacementDecided on compute-pools.placement.v1.placement-decided | the payload carries placementId, tenantId, deploymentId, chosenPoolId, outcome; each consumer (AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived |

ConnectorRegistryService

Service in BC-17; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ConnectorRegistryService-001 | endpoint | GET /factory/connectors with scope factory.connections.read | the response is 200 with the descriptors of the platform tenant and of the tenant of the caller, each carrying connectorId, version, provider, capabilities, adapter reference, webhook scheme and certification state; a descriptor of another tenant is not revealed, nothing is written and no event is published | a call without a token, a token without the scope, or the store connector-registry-sql unavailable | AIFACTORY-US-1001 | enriched | | SCN-ConnectorRegistryService-002 | endpoint | POST /factory/connectors/{connectorId}/certify with scope factory.connections.admin | the response is 202; the runner resolves the connection of the sandbox project through Connections.Resolve of IntegrationService, exchanges its broker ticket through SecretBroker.Issue for a short-lived credential of the purpose delivery and stores the evidence through Artifacts.Store; on a passing suite the descriptor moves from Draft through Certified to Active with its certificationRef, and the ConnectorActivated outbox record and the audit evidence AuditEvidenceSubmitted are written in the same transaction; a repeated call with the same key returns the same reference and runs nothing | a token without the scope, a caller of another tenant on a descriptor of the platform tenant, a descriptor that another tenant registered or an unknown descriptor, a body without projectId, a failing capability, a refusal of Connections.Resolve or SecretBroker.Issue, or IntegrationService, SecretBrokerService or ArtifactService that does not answer | AIFACTORY-US-1002 | enriched | | SCN-ConnectorRegistryService-003 | endpoint | POST /factory/subscriptions with scope factory.connections.admin | the response is 201 with the subscriptionId and the ingress path /webhooks/{ingressRef}; the Subscription is written active with the connection of P and an opaque unique ingressRef, and the ConnectorSubscriptionChanged outbox record is written in the same transaction; a repeated call with the same key returns the same result and changes nothing | a body without projectId or with an event type the scheme does not accept, a token without the scope or for a project it does not grant, an unknown connector or one another tenant registered, a connector without an Active version with a webhook scheme, the key reused with another body, a refusal of Connections.Resolve (no-grant, a connection not Active or Degraded, NOT_FOUND), or IntegrationService or the store connector-registry-sql unavailable | AIFACTORY-US-1483 | enriched | | SCN-ConnectorRegistryService-004 | endpoint | GET /factory/deliveries with scope factory.connections.read | the response is 200 with a page of the matching deliveries of tenant A only, each with deliveryId, direction, connectorId, subscriptionId, externalId, state, payloadHash, receivedAt, settledAt and receiptRef and never the payload; a delivery of tenant B is never revealed, an Outbound filter returns an empty page in I2, and nothing is written | a call without a token, a token without the scope, an unknown filter value, or the store connector-registry-sql unavailable | AIFACTORY-US-1483 | enriched | | SCN-ConnectorRegistryService-005 | endpoint | POST /factory/deliveries/{deliveryId}/replay with scope factory.connections.operate | the response is 202 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-ConnectorRegistryService-006 | endpoint | gRPC Connectors.Deliver (internal, none streaming) | the reply carries tool-invocation-v1 and the side effect of the method's class happens once | the caller has no workload identity or the request fails validation | — | exempt until I5 | | SCN-ConnectorRegistryService-007 | endpoint | gRPC Connectors.ResolveCapability (internal, none streaming) | the reply names the connector and its version, the adapter reference, the capability, the connection, its endpoint policy narrowed by the grant and the broker ticket; it carries no credential and nothing is written | a Draft descriptor, an undeclared capability or a descriptor of another tenant, a refusal of IntegrationService, a call without a workload identity or without the service scope, an execution scope of another tenant, a request without a capability or without a project, or IntegrationService or the store unavailable | AIFACTORY-US-1003 | enriched | | SCN-ConnectorRegistryService-015 | endpoint | gRPC Connectors.ReadPipelineRun (internal, none streaming) | the reply is a tool-receipt-v1 receipt with status Succeeded whose resultRef names the run with its state, commit, stages and the results the system of record reports; it carries no credential, ticket or credential reference and nothing is written to connector-registry-sql | a call without a workload identity or a forwarded tenant, a token without the scope, an execution scope of another tenant, a request without a project or without a run reference, no Active descriptor that declares the capability, a refusal of Connections.Resolve or SecretBroker.Issue, a run unknown to Azure DevOps, Azure DevOps that does not answer within the deadline, or IntegrationService, SecretBrokerService, ArtifactService or the store unavailable | AIFACTORY-US-1481 | enriched | | SCN-ConnectorRegistryService-016 | endpoint | gRPC Connectors.ReadPullRequest (internal, none streaming) | the reply is a tool-receipt-v1 receipt with status Succeeded whose resultRef names the pull request with its review state, commits and merge commit as the system of record reports them; it carries no credential, ticket or credential reference and nothing is written to connector-registry-sql | a call without a workload identity or a forwarded tenant, a token without the scope, an execution scope of another tenant, a request without a project or without a pull-request reference, no Active descriptor that declares the capability, a refusal of Connections.Resolve or SecretBroker.Issue, a pull request unknown to Azure DevOps, Azure DevOps that does not answer within the deadline, or IntegrationService, SecretBrokerService, ArtifactService or the store unavailable | AIFACTORY-US-1481 | enriched | | SCN-ConnectorRegistryService-017 | endpoint | gRPC Connectors.ReadPackageFeed (internal, none streaming) | the reply is a tool-receipt-v1 receipt with status Succeeded whose resultRef names a result that states whether the version is present and the digest the feed reports; an absent version or another digest is an answer and not an error; the reply carries no credential, ticket or credential reference and nothing is written to connector-registry-sql | a call without a workload identity or a forwarded tenant, a token without the scope, an execution scope of another tenant, a request without a project or without the feed and version, no Active descriptor that declares the capability, a refusal of Connections.Resolve or SecretBroker.Issue, Azure DevOps that does not answer within the deadline, or IntegrationService, SecretBrokerService, ArtifactService or the store unavailable | AIFACTORY-US-1481 | enriched | | SCN-ConnectorRegistryService-018 | endpoint | gRPC Connectors.ReadContainerRegistry (internal, none streaming) | the reply is a tool-receipt-v1 receipt with status Succeeded whose resultRef names a result that states whether the image is present and the digest the registry reports; an absent image or another digest is an answer and not an error; the reply carries no credential, ticket or credential reference and nothing is written to connector-registry-sql | a call without a workload identity or a forwarded tenant, a token without the scope, an execution scope of another tenant, a request without a project or without the registry and digest, no Active descriptor that declares the capability, a refusal of Connections.Resolve or SecretBroker.Issue, Azure DevOps that does not answer within the deadline, or IntegrationService, SecretBrokerService, ArtifactService or the store unavailable | AIFACTORY-US-1481 | enriched | | SCN-ConnectorRegistryService-008 | event | ConnectorRegistryService publishes ConnectorActivated on connectors.connectors.v1.connector-activated | the payload carries connectorId, version, tenantId and provider; each consumer (StudioBff (RefreshConnectorDescriptorView), AuditService (RecordEvidence), ToolAdapterService (ActivateDescriptors)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1002 | enriched | | SCN-ConnectorRegistryService-009 | event | ConnectorRegistryService publishes ConnectorDeprecated on connectors.connectors.v1.connector-deprecated | the payload carries connectorId, version, tenantId; each consumer (StudioBff (RefreshConnectorDescriptorView), ToolAdapterService (RetireDescriptors)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-ConnectorRegistryService-010 | event | ConnectorRegistryService publishes ConnectorSubscriptionChanged on connectors.subscriptions.v1.connector-subscription-changed | the payload carries subscriptionId, tenantId, connectorId and active, and ingressRef, connectionId, the descriptor version and its webhook scheme, never a secret or a secret reference; WebhookGatewayService (RefreshIngressTable) writes or updates the ingress entry of the ingressRef exactly once, idempotent on the event id, and makes it inactive for active false, while StudioBff (RefreshSubscriptionView) and AuditService (RecordEvidence) handle it in their own suites | the transport is unavailable or the consumer throws | AIFACTORY-US-1483 | enriched | | SCN-ConnectorRegistryService-011 | event | ConnectorRegistryService publishes DeliveryReceived on connectors.deliveries.v1.delivery-received | the payload carries deliveryId, tenantId, connectorId, subscriptionId, eventType and payloadHash and never the payload or a credential; each consumer (PipelineExecutionService (ApplyDelivery), WorkflowEngineService (CorrelateSignal), KnowledgeIngestionService (IngestOnDelivery)) handles it exactly once, idempotent on the event id; a verified delivery with the same dedupKey for the tenant and connector, inside or after Integration:Connectors:ReplayWindowMinutes while the earlier row is kept, writes no second row, publishes nothing, is counted Deduplicated and completes its inbox message | the transport is unavailable or the consumer throws; or the subscription is inactive, the event type is outside it, the connector has no Active descriptor with a webhook scheme or the payload hash does not match; or ArtifactService or the store connector-registry-sql is unavailable while the delivery is recorded | AIFACTORY-US-1480 | enriched | | SCN-ConnectorRegistryService-012 | event | ConnectorRegistryService publishes DeliveryDispatched on connectors.deliveries.v1.delivery-dispatched | the payload carries deliveryId, tenantId, direction, receiptRef; each consumer (AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-ConnectorRegistryService-013 | event | ConnectorRegistryService publishes DeliveryFailed on connectors.deliveries.v1.delivery-failed | the payload carries deliveryId, tenantId, direction, reason; each consumer (StudioBff (RefreshDeliveryView), StudioNotificationService (NotifyOperators), AuditService (RecordEvidence), AlertRuleService (FireFromDelivery)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-ConnectorRegistryService-014 | event | ConnectorRegistryService publishes DeliveryReplayed on connectors.deliveries.v1.delivery-replayed | the payload carries deliveryId, tenantId, replayedBy; each consumer (AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 |

ContextBuilderService

Service in BC-09; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ContextBuilderService-001 | endpoint | GET /factory/runs/{runId}/context-snapshots with scope factory.runs.read | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-ContextBuilderService-002 | endpoint | GET /factory/context-snapshots/{contextSnapshotId} with scope factory.runs.read | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-ContextBuilderService-003 | endpoint | gRPC ContextAssembly.Assemble (internal, none streaming) | the reply is the context package of the attempt: runId, attemptId, the trusted scope, one item per pinned artifact in the order of the request with name, descriptor and reference unchanged, and a hash over them; a stated token limit cuts nothing and a step without pinned artifacts receives an empty package; nothing is written, no ContextSnapshot is recorded and no event is published; the same request receives the same package; connectsoft.factory.context.assemblies counts it with the status Assembled | the caller has no workload identity (UNAUTHENTICATED); the token lacks the service scope (PERMISSION_DENIED); or the request names no run, no attempt, or an entry without a reference (INVALID_ARGUMENT) | AIFACTORY-US-794 | enriched | | SCN-ContextBuilderService-004 | event | ContextBuilderService publishes ContextAssembled on context-assembly.snapshots.v1.context-assembled | the payload carries contextSnapshotId, tenantId, runId, attemptId, status; each consumer (StudioBff (RefreshContextSnapshotView), DashboardService (ProjectContext), QualityScoreService (CollectContextStats)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 |

ControlPlaneApi

Service in BC-01; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ControlPlaneApi-001 | endpoint | GET /factory/health with scope factory.health.read | the response is 200; the detail names the identity platform and each fronted service with its state; a fronted service that does not answer is reported as unavailable in the detail and does not turn the answer into 503, because it is an optional dependency and the routes of the other services keep serving; while the identity platform is unreachable and a cached signing key still validates tokens, the gateway stays in rotation: readiness stays ready, tokens that were already issued keep passing, and from the first failed probe the response is still 200 with the health degraded and a detail that names the identity platform as unreachable (D117); nothing is written | 503: the identity platform, the one required dependency, is unreachable and no valid signing key remains, because none was cached or the cached keys expired, so the gateway cannot validate tokens | AIFACTORY-US-408 | enriched | | SCN-ControlPlaneApi-002 | endpoint | GET /factory/meta/modules with scope factory.meta.read | the response is 200 with the seven services this gateway fronts, as deployment.fronts of the model lists them, each with its version and its repository; nothing is written | 401: no token or an expired token; 403: the token lacks factory.meta.read; the identity platform is unreachable and no valid signing key remains to validate the token | AIFACTORY-US-408 | enriched | | SCN-ControlPlaneApi-003 | route-class | a request to a production route fronted by ControlPlaneApi (EnvironmentService, ProjectService) | the fronted service decides the production action under its own rules and writes its event in the transaction of its command; for a freeze or an unfreeze EnvironmentService writes EnvironmentStateChanged, from which AuditService records the evidence; the gateway evaluates no approval, holds no approval state and writes nothing; the answer of the service returns unchanged with the correlation id | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; where the path or a message field names the project or the tenant, 403 for a token that grants no role in that project and 404 for another tenant (ADR-0015); where the route names only a resource id, the fronted service answers 403 for a missing project role and 404 for a resource of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-407 | enriched | | SCN-ControlPlaneApi-004 | route-class | a request to a publication route fronted by ControlPlaneApi (AgentRegistryService) | AgentRegistryService decides the publication action: a release is published only after its gates and the publication approval, and the answer of the service, including 409 and 412, returns unchanged with the correlation id; the gateway evaluates no approval, holds no approval reference and writes nothing | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; where the path or a message field names the project or the tenant, 403 for a token that grants no role in that project and 404 for another tenant (ADR-0015); where the route names only a resource id, such as the releaseId of a publication, the fronted service answers 403 for a missing role and 404 for a release of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-407 | enriched | | SCN-ControlPlaneApi-005 | route-class | a request to a read route fronted by ControlPlaneApi (AgentCardService, AgentRegistryService, CostUsageService, EnvironmentService) | the fronted service answers with no side effect and the response returns unchanged with the correlation id; the gateway keeps no state of the call; connectsoft.factory.host.requests and connectsoft.factory.host.request_duration record the call with its service and route | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation, over gRPC PERMISSION_DENIED for a workload token without the service scope; where the path or a message field names the project or the tenant, 403 for a token that grants no role in that project and 404, over gRPC NOT_FOUND, for another tenant (ADR-0015); where the route names only a resource id, the fronted service answers 403 for a missing project role and 404 for a resource of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-405 | enriched | | SCN-ControlPlaneApi-006 | route-class | a request to a sandbox route fronted by ControlPlaneApi (AgentRegistryService) | the fronted service performs the sandbox action, which changes no shared state (for ValidateRelease a closure report and no release), and its answer returns unchanged with the correlation id; the gateway adds no gate of its own to the class and keeps no state | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; where the path or a message field names the project or the tenant, 403 for a token that grants no role in that project and 404 for another tenant (ADR-0015); 503: the fronted service does not answer | AIFACTORY-US-405 | enriched | | SCN-ControlPlaneApi-007 | route-class | a request to a shared-write route fronted by ControlPlaneApi (AgentCardService, CostUsageService, EnvironmentService, ProjectService) | the fronted service applies the request once under its own idempotency rule and its answer, including its 409 for a key reused with a different body, returns unchanged with the correlation id; the gateway stores neither the key nor the result, so after a replica crash nothing is replayed and the caller retries with the same key and receives the result of the one application | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; where the path or a message field names the project or the tenant, 403 for a token that grants no role in that project and 404 for another tenant (ADR-0015); where the route names only a resource id, the fronted service answers 403 for a missing project role and 404 for a resource of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-406 | enriched | | SCN-ControlPlaneApi-008 | route-class | a request to a spend route fronted by ControlPlaneApi (FactoryCommercialService) | the fronted service decides the spend action, and budgets and reservations stay with the service that owns them; its answer returns unchanged with the correlation id; the gateway reads no budget, holds no reservation and writes nothing | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; where the path or a message field names the project or the tenant, 403 for a token that grants no role in that project and 404 for another tenant (ADR-0015); where the route names only a resource id, the fronted service answers 403 for a missing role and 404 for a resource of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer or is not deployed yet | AIFACTORY-US-407 | enriched |

CostUsageService

Service in BC-05; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-CostUsageService-001 | endpoint | GET /factory/projects/{projectId}/usage with scope factory.usage.read | the response is 200 with, per meter, the quantity and the cost in each of the states estimated, reserved, observed, reconciled and uncertain, and with the limitUsd, committedUsd and approvalThresholdUsd of the budget; the reserved figure is the estimate of the reservations still Reserved; uncertain usage is shown as uncertain, with a quantity it holds marked as not confirmed, none for a record without one and without a cost, and never as observed or as zero; a project without usage in the period answers 200 with empty figures; nothing is written | 403: the scope lacks factory.usage.read, or the role claims of the token do not admit the project; 404: no Budget exists for that projectId in the tenant of the caller, which is also the answer for a project of another tenant (ADR-0015) | AIFACTORY-US-457 | enriched | | SCN-CostUsageService-002 | endpoint | GET /factory/runs/{runId}/usage with scope factory.usage.read | the response is 200 with the usage records of the run, each with meter, dimensions, quantity, status, pricing revision, estimated and confirmed cost and source receipt, and with the reservation of the run, its state, estimatedUsd, settledUsd and approvalId; for a settled run without uncertain records the sum of the cost of its records equals settledUsd; nothing is written | 403: the scope lacks factory.usage.read, or the token does not admit the project of the run; 404: the service holds no reservation and no usage for that runId in the tenant of the caller, which is also the answer for a run of another tenant (ADR-0015) | AIFACTORY-US-457 | enriched | | SCN-CostUsageService-003 | endpoint | PUT /factory/projects/{projectId}/budget with scope factory.usage.admin | the response is 200 with the budget; a body that states another period replaces the period of that budget and creates no second one; the new limit and threshold apply to reservations made from then on, and reservations already Reserved keep their amount; a PUT that states the stored values changes nothing and publishes nothing | 403: the scope lacks factory.usage.admin, or the caller is by the role claims of the token neither Workspace admin of the project nor Platform admin; 404: no budget exists for that project in the tenant of the caller, which is also the answer for a project of another tenant (ADR-0015); 409: approvalThresholdUsd is above Usage:Thresholds:PlatformApprovalThresholdUsd, or limitUsd is below the committedUsd of the budget | AIFACTORY-US-452, AIFACTORY-US-1495 | enriched | | SCN-CostUsageService-014 | endpoint | PUT /factory/budget with scope factory.usage.admin | the response is 200 with the budget; the one tenant-wide Budget of the tenant is created or changed, never a second one, and the BudgetUpdated outbox record without projectId is written in the same transaction; the same PUT repeated changes nothing and publishes nothing; from then on no project budget of the tenant may be set above that limit (D137) | a limit above the platform limit or below the limit of a project budget of the tenant, or a caller without the scope or without the Platform admin role | AIFACTORY-US-1495 | enriched | | SCN-CostUsageService-004 | endpoint | gRPC Usage.Reserve (internal, none streaming) | the reply carries usage-reservation-v1 with one of three outcomes. Reserved, when committedUsd plus the estimate stays within limitUsd and the estimate does not exceed the threshold: the Reservation is created in Reserved with the estimate of the service, whatever amount the caller sent, and with expiresAt from Usage:Reservations:ExpiryMinutes, committedUsd grows by the estimate and BudgetReserved is written in the same transaction. Denied, when the estimate would take committedUsd above limitUsd or when the estimator has no entry for the run and so no estimate, which is never taken as zero: the reservation is recorded as Denied, the budget is unchanged, BudgetReservationDenied is written with the reason and connectsoft.factory.usage.reservations_denied is incremented. Approval-required, when the estimate fits the limit and exceeds the threshold: nothing is reserved, no reservation row is written, committedUsd is unchanged, neither of the two events is written and SpendApprovalRequired is written with the run, the project, the estimate and the threshold (D117); RunControlService opens a run-level spend approval and the run waits in WaitingForApproval, and when ApprovalDecided announces that approval as Approved the handler ReserveOnSpendApproval reserves the approved estimate with its approvalId and writes BudgetReserved, or records a denial when the budget no longer covers it, while a Rejected or Expired approval reserves and releases nothing. A second request for a run that has a reservation returns the outcome that exists; concurrent reservations on one budget are retried on the row version and no reservation exceeds the limit; while observed usage holds committedUsd above limitUsd every reservation is Denied | the caller has no workload identity (Unauthenticated), its token lacks the service scope (PermissionDenied), the request fails validation (InvalidArgument), or the project or the run belongs to another tenant (NOT_FOUND, ADR-0015) | AIFACTORY-US-453 | enriched | | SCN-CostUsageService-005 | endpoint | gRPC Usage.RecordUsage (internal, none streaming) | the reply carries ack-v1; one UsageRecord per meter is written with the pricing revision of the service valid at occurredAt and its estimatedCostUsd, in the status Observed, Estimated or, when the receipt reports no usage, Uncertain, together with its UsageRecorded outbox record in the same transaction; a receipt whose quantity is unknown is stored as Uncertain without a quantity, and a receipt for which no pricing revision is valid at occurredAt is stored as Uncertain with its quantity and without a revision, both with empty cost columns, to be priced or reconciled later by the ReconciliationWorker, and no receipt is refused for a missing price (D117); no read or event presents an Uncertain record as observed or as zero; the same receipt with the same content again, by this method or by the handler of ModelInvoked, which writes one record on each of the two token meters, or of ToolInvoked, writes no second record and is acknowledged as accepted (unique on meter and source receipt); a later receipt that reports the usage of a stored Estimated or Uncertain record is kept in LateReceipts as the confirmation of that record for the ReconciliationWorker and acknowledged as accepted; other content for an Observed or Reconciled record is acknowledged as a conflict and changes nothing; a record that names no run, the usage of an invocation outside a run such as a model call on the OpenAI-compatible route of the model gateway, is written with the tenant and the project and without a run, belongs to no reservation, and its cost is added to committedUsd of the budget of its project in the same transaction (D123); a record whose cost takes committedUsd of the budget above limitUsd also writes BudgetExceeded, without a runId when the record names no run | the caller has no workload identity (Unauthenticated), its token lacks the service scope (PermissionDenied), the request fails validation, names a meter outside the enumeration, has no receipt id or states the status observed or estimated without a quantity (InvalidArgument), or the project belongs to another tenant (NOT_FOUND, ADR-0015) | AIFACTORY-US-454 | enriched | | SCN-CostUsageService-006 | event | CostUsageService publishes BudgetReserved on usage-accounting.reservations.v1.budget-reserved | the payload carries reservationId, runId, tenantId and estimatedUsd; RunControlService dispatches the first attempt of the run (ReleaseFirstStepOnReservation), for a run that is Held once its environment is active again (D119), and StudioBff refreshes its reservation view (RefreshReservationView); each consumer handles it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-453 | enriched | | SCN-CostUsageService-007 | event | CostUsageService publishes BudgetReservationDenied on usage-accounting.reservations.v1.budget-reservation-denied | the payload carries runId, tenantId and reason; RunControlService fails an Accepted or a Held run as Failed with the failure class policy-denied through the trigger BudgetDenied (FailRunOnBudgetDenial) and StudioBff refreshes its reservation view (RefreshReservationView); each consumer handles it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-453 | enriched | | SCN-CostUsageService-012 | event | CostUsageService publishes SpendApprovalRequired on usage-accounting.reservations.v1.spend-approval-required | the payload carries runId, tenantId, projectId, estimatedUsd and thresholdUsd; RunControlService opens a run-level approval request of action class spend for the run, without a step, a lease or a fencing token, and moves the run from Accepted to WaitingForApproval, or for a run that is Held opens the approval at once and leaves the run Held (OpenSpendApproval, D119), exactly once, idempotent on the event id and with at most one spend approval per run; the approval can be decided while the run is Held; when ApprovalDecided later announces that approval as Approved, the handler ReserveOnSpendApproval reserves the approved estimatedUsd with its approvalId at once, whatever the state of the run (D119), and writes BudgetReserved, or records a denial with BudgetReservationDenied when the budget no longer covers it; a Rejected, Expired or Cancelled spend approval reserves and releases nothing, because nothing was reserved, and the decisions of other proposal kinds are ignored | the transport is unavailable or the consumer throws | AIFACTORY-US-453 | enriched | | SCN-CostUsageService-008 | event | CostUsageService publishes ReservationSettled on usage-accounting.reservations.v1.reservation-settled | the payload carries reservationId, runId, tenantId, settledUsd and uncertain; settledUsd is the sum of the cost of the usage records of the run and of the child runs noted under its reservation, whose usage is settled with it (D121), for a settlement, also when it exceeds the estimate, and zero with uncertain false for a released and for an expired reservation, whose state is read through GetRunUsage; uncertain is true while a record of the run is Uncertain or Estimated; StudioBff refreshes its reservation view (RefreshReservationView), DashboardService projects the settlement (ProjectUsage) and FactoryCommercialService accumulates the run cost (AccumulateRunCost); each consumer handles it exactly once, idempotent on the event id; a Reserved reservation of a run with a usage record or a noted attempt outcome is never released or expired; a reservation that is still Reserved when its monthly budget rolls over stays Reserved, is carried into the new period with its estimate and publishes nothing at the rollover (D119) | the transport is unavailable or a consumer throws; or a run spends after its reservation came to rest, because a receipt arrives after settlement or the run dispatched although its reservation was Expired or Released, which the service cannot rule out since it holds no dispatch fact | AIFACTORY-US-455, AIFACTORY-US-459 | enriched | | SCN-CostUsageService-009 | event | CostUsageService publishes UsageRecorded on usage-accounting.usage.v1.usage-recorded | the payload carries usageId, tenantId, projectId, meter, status and the quantity, which is absent for an Uncertain record whose quantity is unknown and is read with that status when it is present (D117); DashboardService projects usage by status (ProjectUsage) and FactoryCommercialService accumulates the meter of the period (AccumulateMeter); each consumer handles it exactly once, idempotent on the event id; connectsoft.factory.usage.cost_usd counts the cost by meter and status | the transport is unavailable or a consumer throws | AIFACTORY-US-454 | enriched | | SCN-CostUsageService-010 | event | CostUsageService publishes UsageReconciled on usage-accounting.usage.v1.usage-reconciled | the payload carries usageId, tenantId and confirmedCostUsd; FactoryCommercialService adjusts the meter (AdjustMeter) and DashboardService updates the usage record projection (ProjectUsageRecord); each consumer handles it exactly once, idempotent on the event id; the same confirmation applied twice confirms once (idempotent on usageId plus the statement reference); connectsoft.factory.usage.uncertain_records falls for a record that was Uncertain; when the reservation of the run is no longer Reserved, committedUsd of the budget was corrected by the difference in the same transaction; a record without a confirmation stays as it is and is never zeroed; the adapter for provider statements is a later capability and none is built | the transport is unavailable or a consumer throws | AIFACTORY-US-456 | enriched | | SCN-CostUsageService-011 | event | CostUsageService publishes BudgetUpdated on usage-accounting.budgets.v1.budget-updated | the payload carries budgetId, tenantId, projectId and limitUsd; StudioBff refreshes its budget view (RefreshBudgetView) and AuditService records the change as evidence (RecordEvidence); each consumer handles it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-452, AIFACTORY-US-1495 | enriched | | SCN-CostUsageService-013 | event | CostUsageService publishes BudgetExceeded on usage-accounting.budgets.v1.budget-exceeded | the payload carries budgetId, tenantId, projectId, committedUsd, limitUsd and the runId of the run whose usage raised the amount, the run that crossed the limit or a later one, which may be a child run (D121) and is absent when that usage names no run; RunControlService records a cancellation intent for that run with the reason budget-exceeded and the actor system, so that the run follows the cancellation path and ends Cancelled with the reason budget-exceeded, never Failed (CancelRunOnBudgetExceeded, D123), exactly once, idempotent on the event id; an event without a runId names no run and stops none; the observed cost stays in committedUsd, and while the amount is above the limit every reservation against the budget is Denied with the reason budget-exceeded, until the limit is raised or the rollover of a monthly budget opens a new period; only the run the event names is stopped, and when it is a child run it ends Cancelled like every stopped run and only its parent treats it as a failed child, with its delegation set to failed and its step run of kind SubWorkflow set to Failed with the failure class policy-denied and the reason budget-exceeded (D121, D123); every run whose observed usage raises committedUsd of a budget that is above limitUsd is named by an event of its own, once, and stopped the same way, while the runs that stay within their estimate finish and settle (D121); later usage of the named run that leaves committedUsd above limitUsd publishes no second event (D119); a write that does not raise committedUsd or leaves it at or below limitUsd publishes nothing, so a run within its estimate is never named | the transport is unavailable or the consumer throws; or the run the event names is already Completed, Failed, Cancelled or Cancelling | AIFACTORY-US-549 | enriched |

DashboardService

Service in BC-21; first delivered in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-DashboardService-001 | endpoint | GET /factory/operations/runs with scope factory.runs.read | the response is 200 with the runs of that project only, each with state, counts, approvals waiting, uncertain effects, tokens, cost by status and updatedAt, and the projection lag is stated; nothing is written | 403: the caller's scope lacks factory.runs.read | AIFACTORY-US-1124 | enriched | | SCN-DashboardService-002 | endpoint | GET /factory/operations/runs/{runId} with scope factory.runs.read | the response is 200 with the projection and its entries in sequence order, each with kind, reference, summary, time, duration and cost and no content, the traceId and a drill-down link while the telemetry backend answers, and updatedAt with the projection lag; when the telemetry backend is unavailable the response is still 200 from the store without the drill-down link | 403: the caller's scope lacks factory.runs.read; 404: no run with that id exists in the caller's tenant and project, which is also the answer for a run of another tenant (ADR-0015) | AIFACTORY-US-1124 | enriched | | SCN-DashboardService-003 | endpoint | GET /factory/operations/overview with scope factory.operations.read | the response is 200 with the tenant and project overviews of the trusted tenant per window, each with computedAt; nothing of another tenant is returned and nothing is written | 403: the caller's scope lacks factory.operations.read | AIFACTORY-US-1125 | enriched | | SCN-DashboardService-004 | endpoint | GET /factory/operations/overview/{kind}/{subjectId} with scope factory.operations.read | the response is 200 with the metrics of that project per window and computedAt, and nothing is written | 403: the caller's scope lacks factory.operations.read; 404: the kind is any other than ProjectOverview and TenantOverview, which are the only overviews kept in I4 (D131), or no overview of that kind and subject exists in the caller's tenant, which is also the answer for a subject of another tenant (ADR-0015) | AIFACTORY-US-1125 | enriched | | SCN-DashboardService-005 | endpoint | POST /factory/operations/runs/{runId}/rebuild with scope factory.operations.admin | the response is 202, the ProjectionRebuilder replaces the projection and its entries with the state rebuilt from the journal port and the same events, the result equals the projection built before, and RunProjectionUpdated is written in the same transaction; a repeated request while a rebuild of the same run and sequence is pending answers 202 and one rebuild runs, and the existing projection keeps serving reads until a rebuild commits | 403: the caller's scope lacks factory.operations.admin; 404: no run with that id exists in the caller's tenant and project, which is also the answer for a run of another tenant (ADR-0015) | AIFACTORY-US-1126 | enriched | | SCN-DashboardService-006 | endpoint | gRPC Operations.Subscribe (internal, server streaming) | the stream delivers one run-event-envelope-v1 per committed change with run id, tenant, state and lastEventSequence in commit order; changes of runs of another tenant or of a project outside the scope are not delivered, and nothing is written | the caller has no workload identity, its token lacks the service scope, or the request fails validation | AIFACTORY-US-1127 | enriched | | SCN-DashboardService-007 | event | DashboardService publishes RunProjectionUpdated on operations.projections.v1.run-projection-updated | the payload carries runId, tenantId, state and lastEventSequence; a redelivered event id of a producer changes no projection and publishes nothing; the consumers StudioBff (RefreshRunProjectionView) and StudioRealtimeGateway (PushRun) handle it in their own suites, idempotent on the event id | the transport is unavailable | AIFACTORY-US-1123 | enriched | | SCN-DashboardService-008 | event | DashboardService publishes OperationsDigestProduced on operations.projections.v1.operations-digest-produced | the payload carries tenantId, window and computedAt; a duplicate trigger for the same tenant, window and computedAt writes nothing more; the consumers StudioBff (RefreshOverviewProjectionView) and SloService (EvaluateSlos) handle it in their own suites, idempotent on the event id | the transport is unavailable | AIFACTORY-US-1125 | enriched |

DataEventFoundations

Service in BC-42; first delivered in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-DataEventFoundations-001 | endpoint | GET /data-event/health with scope factory.health.read | liveness answers 200 without a token; the caller receives 200 with the readiness of the gateway and the state of each of the three fronted services and of the identity platform; when one fronted service stops answering, health reports it unavailable, its routes answer 503 with a retry hint and the routes of the other two keep serving; nothing is written and no token or payload is logged | the identity platform is unreachable: first while a cached signing key still validates tokens, then after no valid key remains | AIFACTORY-US-1445 | enriched | | SCN-DataEventFoundations-002 | endpoint | GET /data-event/meta/profiles with scope factory.meta.read | the response is 200 with the active messaging profile and its envelope schema version, composed from ListEnvelopeProfiles of EnvelopeRegistryService, and the store profiles of the topology with engine and adapter library, composed from ListStoreProfiles of StoreProfileService; the gateway keeps nothing and writes nothing | no token, a token without factory.meta.read, or EnvelopeRegistryService or StoreProfileService does not answer | AIFACTORY-US-1445 | enriched | | SCN-DataEventFoundations-003 | route-class | a request to a production route fronted by DataEventFoundations (EnvelopeRegistryService, RetentionResidencyService, StoreProfileService) | each fronted service decides the gate of its own action (a Forward or Breaking schema version without every acknowledgement is 409, a tenant deletion without its approval is 412, a binding that violates residency is 422 with the rule id) and its answer, 201, 202, 409, 412 or 422, returns unchanged with the correlation id; the gateway evaluates no approval, holds no approval reference and writes no evidence | no token, an expired token, a token without factory.data.admin, or a topic or store id of another tenant | AIFACTORY-US-1444 | enriched | | SCN-DataEventFoundations-004 | route-class | a request to a read route fronted by DataEventFoundations (EnvelopeRegistryService, RetentionResidencyService, StoreProfileService) | the call reaches the fronted service with the user token unchanged, the tenant, the correlation id and the trace context; the answer of the fronted service returns unchanged; nothing is written by the gateway or the service | no token, an expired token, a token without the scope, a fronted service that does not answer, or a resource of another tenant | AIFACTORY-US-1442 | enriched | | SCN-DataEventFoundations-005 | route-class | a request to a shared-write route fronted by DataEventFoundations (RetentionResidencyService) | both operations declare natural idempotency, so the repeat carries the same body and RetentionResidencyService applies the change once; both answers return unchanged with the correlation id and the gateway stores nothing and replays nothing | no token, a token without the scope, a fronted service that does not answer, or a refusal of the fronted service | AIFACTORY-US-1443 | enriched |

DeliveryHost

Service in BC-23; first delivered in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-DeliveryHost-001 | endpoint | GET /delivery/health with scope factory.health.read | liveness answers 200 without a token; the detail answers 200 with the state of each fronted service and of the identity platform; a fronted service that does not answer is reported unavailable in the detail while the answer stays 200, its routes answer 503 with a retry hint and the routes of the other services keep serving; nothing is written, because the gateway holds no state | the identity platform is unreachable, a call for the detail carries no token or lacks factory.health.read | AIFACTORY-US-1321 | enriched | | SCN-DeliveryHost-002 | endpoint | GET /delivery/meta/systems with scope factory.meta.read | the response is 200 with the systems of record its metadata port returns and nothing else; when the port has no source the systems are stated as not reported in a provisional stub owed to the owner and no value is invented; no fronted service is called and nothing is written | a call without a token or with a token that lacks factory.meta.read, or the identity platform unreachable with no valid signing key left | AIFACTORY-US-1321 | enriched | | SCN-DeliveryHost-003 | route-class | a request to a production route fronted by DeliveryHost (EnvironmentPromotionService) | the gate stays in EnvironmentPromotionService, whose one production approval is bound to the release id and the environment and requested from RunControlService with the subject kind promotion (D133, D135), an Operator holding the approval of a rollback by role and the rollback promotion skipping the approval gate; the gateway evaluates no policy, holds no approval, refuses nothing for a missing approval and audits nothing itself, AuditService recording the evidence from the events of the service; the answer of the service, a 202, a 409, a 412, a 422, the 403 of a missing role or the 404 of a resource of another tenant, returns unchanged with the correlation id | no token, an expired token, a user token issued for another gateway, a token without the scope of the operation, or a user token or a workload token without factory.delivery.promote on the gRPC route | AIFACTORY-US-1320 | enriched | | SCN-DeliveryHost-004 | route-class | a request to a read route fronted by DeliveryHost (EnvironmentPromotionService, PipelineExecutionService, ReleaseService) | the fronted service serves the response with no side effect and applies its own tenant filter and role policies; its answer, the 403 of a missing role and the 404 of a resource of another tenant included, returns unchanged with the correlation id; on the gRPC read route the tenant-id and project metadata are forwarded unchanged; the gateway keeps nothing of the call | no token, an expired token, an identity token, a user token issued for another gateway, a token without the scope, a project filter naming a project the token does not grant, a workload token on a REST route, a user token or a workload token without factory.delivery.read on the gRPC route, or the fronted service does not answer | AIFACTORY-US-1318 | enriched | | SCN-DeliveryHost-005 | route-class | a request to a shared-write route fronted by DeliveryHost (PipelineExecutionService, ReleaseService) | the fronted service applies a repeated request once, by its key for the two operations idempotent by key header and naturally for the others; the gateway stores no key and no result, replays nothing after a replica crash, and returns the answer, a 409, 412 or 422 of the service among them, unchanged with the correlation id | no token, an expired token or a token without the scope, a user token or a workload token without factory.delivery.propose on the gRPC route, or the fronted service does not answer | AIFACTORY-US-1319 | enriched |

EnvelopeRegistryService

Service in BC-42; first delivered in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-EnvelopeRegistryService-001 | endpoint | GET /factory/data/topics with scope factory.data.read | each response is 200 with the matching topics, each with its producer, registered consumers, current schema version and state, paged; every caller with the scope sees the same registry; nothing is written | 403: the caller's scope lacks factory.data.read | AIFACTORY-US-1446 | enriched | | SCN-EnvelopeRegistryService-002 | endpoint | GET /factory/data/topics/{topic} with scope factory.data.read | the response is 200 with the topic and its three schema versions in order, each with its schema reference, its compatibility against the previous version, its publication moment and, where it applies, its deprecation moment, and the version each consumer acknowledged; nothing is written | the caller lacks factory.data.read, or the registry holds no topic of that name | AIFACTORY-US-1446 | enriched | | SCN-EnvelopeRegistryService-003 | endpoint | PUT /factory/data/topics/{topic} with scope factory.data.admin | the first call answers 201 and the topic is Draft with its producer, consumers and envelope profile, and TopicRegistered is written in the same transaction; the second answers 200 and writes one more event; the third answers 200 and writes nothing | a context segment that is not the producer slug, a second producer, an event name another topic carries, a Retired topic, a user caller without the scope or the Platform admin role, or a workload token without the service scope | AIFACTORY-US-1447 | enriched | | SCN-EnvelopeRegistryService-004 | endpoint | POST /factory/data/topics/{topic}/schema-versions with scope factory.data.admin | the first answers 201 with compatibility Backward, the version is current and SchemaVersionPublished is written in the same transaction, as a Full version would; a repeat with the same key and body returns the same 201 and changes nothing; the Forward and the Breaking version, not backward compatible, are each refused with 409 listing the consumer that has not acknowledged it, and become current only when every row of TopicConsumers acknowledges them; the first version of a Draft topic activates it | the same key with a different body, a Retired topic, an unparseable version or unreadable schema, an unknown topic, a caller without the scope, or ArtifactService does not answer | AIFACTORY-US-1448 | enriched | | SCN-EnvelopeRegistryService-005 | endpoint | GET /factory/data/envelope-profiles with scope factory.data.read | the response is 200 with each profile, its body fields, the transport properties mirrored from the envelope, its outbox and inbox table contracts, its deduplication window and the flag of the active profile; the envelope fields are the same on every profile; nothing is written | 403: the caller's scope lacks factory.data.read | AIFACTORY-US-1450 | enriched | | SCN-EnvelopeRegistryService-006 | endpoint | gRPC Envelopes.ResolveTopic (internal, none streaming) | each reply topic-resolution-v1 carries the topic, its current schema version and its state, Active, Deprecated or Retired, so the host does not publish on a Retired topic; the method is of class read and writes nothing | the caller has no workload identity, the request fails validation, or the event name is not registered | AIFACTORY-US-1451 | enriched | | SCN-EnvelopeRegistryService-007 | endpoint | gRPC Envelopes.ValidateEnvelope (internal, none streaming) | the reply envelope-validation-v1 for the valid envelope is valid with no violation; each other one is not valid and lists every failed rule as a violation with its path and rule, and connectsoft.factory.data_event.envelope_validation_failures is incremented by producer and topic; the method writes nothing else | the caller has no workload identity or the request fails validation | AIFACTORY-US-1451 | enriched | | SCN-EnvelopeRegistryService-008 | event | EnvelopeRegistryService publishes TopicRegistered on data-foundations.topics.v1.topic-registered | the payload carries topic, producer, currentSchemaVersion and state; StudioBff (RefreshTopicDefinitionView) and AuditService (RecordEvidence) each handle it once, idempotent on the event id; a second ModelSync run of the same catalog publishes nothing and reports the topics the catalog does not list as drift | the transport is unavailable or a consumer throws | AIFACTORY-US-1447 | enriched | | SCN-EnvelopeRegistryService-009 | event | EnvelopeRegistryService publishes SchemaVersionPublished on data-foundations.topics.v1.schema-version-published | the payload carries topic, version and compatibility; StudioBff (RefreshTopicDefinitionView) and AuditService (RecordEvidence) each handle it once, idempotent on the event id; a refused Breaking version publishes nothing | the transport is unavailable or a consumer throws | AIFACTORY-US-1448 | enriched | | SCN-EnvelopeRegistryService-010 | event | EnvelopeRegistryService publishes TopicDeprecated on data-foundations.topics.v1.topic-deprecated | the payload carries topic and retiresAt; StudioBff (RefreshTopicDefinitionView) and AuditService (RecordEvidence) each handle it once, idempotent on the event id; the topic keeps delivering during the window, and the sweeper then moves it to Retired without an event, once per topic and day | the transport is unavailable or a consumer throws | AIFACTORY-US-1449 | enriched | | SCN-EnvelopeRegistryService-011 | event | EnvelopeRegistryService publishes EnvelopeProfileActivated on data-foundations.envelopes.v1.envelope-profile-activated | the payload carries profile and envelopeSchemaVersion; StudioBff (RefreshEnvelopeProfileView) and AuditService (RecordEvidence) each handle it once, idempotent on the event id; a start with nothing changed publishes nothing | the transport is unavailable or a consumer throws | AIFACTORY-US-1450 | enriched |

EnvironmentPromotionService

Service in BC-24; first delivered in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-EnvironmentPromotionService-001 | endpoint | GET /factory/delivery/promotions with scope factory.delivery.read | the response is 200 with only the promotions of the projects in which the caller holds a role that match the filter, each with its gates; promotions of other tenants and projects never appear and nothing is written | 403: the caller's scope lacks factory.delivery.read | AIFACTORY-US-1316 | enriched | | SCN-EnvironmentPromotionService-002 | endpoint | GET /factory/delivery/promotions/{promotionId} with scope factory.delivery.read | the response is 200 with the promotion, its gates with outcome and evidence reference, the approval id of a production promotion, the desired-state reference, the verification results and, for a rolled back promotion, the rollback evidence; nothing is written | 403: the caller's scope lacks factory.delivery.read or the caller holds no role in the project of the promotion; 404: no promotion with that id exists in the caller's tenant, and a promotion of another tenant is not found under the tenant row filter and is answered 404, the same answer as for an unknown id (ADR-0015) | AIFACTORY-US-1316 | enriched | | SCN-EnvironmentPromotionService-003 | endpoint | POST /factory/delivery/promotions with scope factory.delivery.promote | the response is 202 with the location of the promotion; connectsoft.factory.delivery.promotions is incremented; the gates start from PromotionRequested; a repeated call with the same Idempotency-Key and the same body returns the same promotion and changes nothing | 403: the caller lacks factory.delivery.promote or a role in the project of the release; 409: the same Idempotency-Key arrives with another body; 412: the release was withdrawn (BlockPromotion); 422: the request has no Idempotency-Key, the body names no release, no environment or no strategy or an unknown strategy, or the class of the environment is not on the promotion path, a Sandbox environment among them; 404: the release or the environment is not recorded in the caller's tenant, whether unknown, of another tenant or never announced, one answer for all so that a resource of another tenant is never confirmed (ADR-0015 amendment D113) | AIFACTORY-US-1311 | enriched | | SCN-EnvironmentPromotionService-004 | endpoint | POST /factory/delivery/promotions/{promotionId}/rollback with scope factory.delivery.operate | the response is 202; connectsoft.factory.delivery.rollbacks counts a manual rollback; the rollback promotion passes the other gates and hands off through PromotionApproved like any promotion; when it completes, the addressed promotion moves from Completed to RolledBack (trigger ManualRollback) and RollbackCompleted is written in that transaction, and until then it stays Completed; a repeat on the promotion whose rollback this operation opened returns 202 and opens nothing | 403: the caller lacks factory.delivery.operate or the role Operator in the project; 404: no promotion with that id exists in the caller's tenant, a promotion of another tenant being answered alike (ADR-0015); 409: the promotion is not Completed, it is Completed without a previous release, a later promotion completed in the same environment so its release is no longer current, or it was rolled back automatically by VerificationFailedAutoRollback | AIFACTORY-US-1315 | enriched | | SCN-EnvironmentPromotionService-005 | endpoint | GET /factory/environments/{environmentId}/current-release with scope factory.delivery.read | the response is 200 with the release currently completed in the environment, the release of its latest Completed promotion, a completed rollback promotion included, so that after a rollback the previous release is current (D135); nothing is written | 403: the caller's scope lacks factory.delivery.read; 404: the environment is unknown in the caller's tenant, belongs to another tenant (ADR-0015) or no release has completed in it | AIFACTORY-US-1316 | enriched | | SCN-EnvironmentPromotionService-006 | endpoint | gRPC Promotions.Request (internal, none streaming) | the reply carries ack-v1; a repeat for the same run, release and target environment, the key of the step delivery-run/request-promotion, returns the same acknowledgement and creates no second promotion | the caller has no workload identity, the workload token lacks factory.delivery.promote, the request fails validation, the release or the environment is not recorded in the forwarded tenant (unknown or of another tenant alike), or the release was withdrawn | AIFACTORY-US-1311 | enriched | | SCN-EnvironmentPromotionService-007 | event | EnvironmentPromotionService publishes PromotionRequested on releases.promotions.v1.promotion-requested | the payload carries promotionId, tenantId, projectId, releaseId, environmentId, environmentClass and the runId when the request carried one; the GateEvaluator of the service starts on it, and StudioBff (RefreshPromotionView), AuditService (RecordEvidence) and DashboardService (ProjectPromotion) handle it exactly once, idempotent on the event id, in their own suites | the transport is unavailable or a consumer throws | AIFACTORY-US-1311 | enriched | | SCN-EnvironmentPromotionService-008 | event | EnvironmentPromotionService publishes PromotionApproved on releases.promotions.v1.promotion-approved | the payload carries promotionId, tenantId, releaseId, environmentId, strategy, desiredStateRef and, for a production promotion only, approvalId; IaCProvisioningService (ProvisionPromotion) deploys from it without a second approval, and StudioBff (RefreshPromotionView) and AuditService (RecordEvidence) handle it exactly once, idempotent on the event id, in their own suites | a gate fails or the release is withdrawn during the evaluation, the 3 attempts of a gate are exhausted because ReleaseService, PolicyEngineService or RunControlService does not answer, the production approval is rejected or expires, or it is decided ChangesRequested, Stale or Cancelled or the release is withdrawn while it waits; separately, the transport is unavailable or a consumer throws | AIFACTORY-US-1312, AIFACTORY-US-1313 | enriched | | SCN-EnvironmentPromotionService-009 | event | EnvironmentPromotionService publishes PromotionCompleted on releases.promotions.v1.promotion-completed | the payload carries promotionId, tenantId, projectId, releaseId, environmentId, environmentClass and previousReleaseId, and the optional runId and stepRunId of the requesting step, absent when no run requested the promotion (D141); the release is the current release of the environment; EnvironmentService (RecordCurrentRelease), RunControlService (SettleWaitingStep, which looks up the waiting step by runId and stepRunId and ignores an event without them), StudioBff (RefreshPromotionView) and StudioNotificationService (NotifyProject) handle it exactly once, idempotent on the event id, in their own suites | the transport is unavailable or a consumer throws | AIFACTORY-US-1314 | enriched | | SCN-EnvironmentPromotionService-010 | event | EnvironmentPromotionService publishes PromotionFailed on releases.promotions.v1.promotion-failed | the payload carries promotionId, tenantId, releaseId, environmentId, reason and rolledBack, false after a provisioning failure and true after the automatic rollback, whose RollbackCompleted is written in the same transaction, and the optional runId and stepRunId of the requesting step, absent when no run requested the promotion (D141); RunControlService (SettleWaitingStep, which looks up the waiting step by runId and stepRunId and ignores an event without them), StudioBff (RefreshPromotionView), FleetRolloutService (HaltOnFailure) and AuditService (RecordEvidence) handle it exactly once, idempotent on the event id, in their own suites | the transport is unavailable or a consumer throws | AIFACTORY-US-1314 | enriched | | SCN-EnvironmentPromotionService-011 | event | EnvironmentPromotionService publishes RollbackCompleted on releases.promotions.v1.rollback-completed | the payload carries promotionId, tenantId, environmentId, releaseId, the previous release as restoredReleaseId and the rollback promotion as rollbackPromotionId; EnvironmentService (RecordCurrentRelease), StudioBff (RefreshPromotionView), FleetInventoryService (UpdateInstanceRelease) and AuditService (RecordEvidence) handle it exactly once, idempotent on the event id, in their own suites | the transport is unavailable or a consumer throws | AIFACTORY-US-1315 | enriched |

EnvironmentService

Service in BC-01; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-EnvironmentService-001 | endpoint | POST /factory/projects/{projectId}/environments with scope factory.projects.admin | the response is 201 with the environment and its location; a repeated call with the same Idempotency-Key and the same body returns the same environment and changes nothing | 403: the scope lacks factory.projects.admin or the token grants no role in the addressed project, whose existence is never confirmed; 404: a caller with the tenant-wide Platform admin role names a projectId that does not exist in the tenant of the token or belongs to another tenant, the same answer for both (ADR-0015 amendment D113; the model names this 404 for the operation, D117); 409: the name is already used by an environment of the project, or the same Idempotency-Key arrives with a different body; ProjectService is unavailable (fail-fast dependency); the body is invalid, for which the model names no status (an open point) | AIFACTORY-US-409 | enriched | | SCN-EnvironmentService-002 | endpoint | GET /factory/projects/{projectId}/environments with scope factory.projects.read | the response is 200 with exactly the environments of that project in the tenant of the caller, each with its name, class, state and region; environments of other projects and of other tenants never appear (row-filter isolation, ADR-0015); nothing is written | 403: the scope lacks factory.projects.read or the token grants no role in the addressed project, whose existence is never confirmed; 404: a caller with the tenant-wide Platform admin role names a projectId that does not exist in the tenant of the token or belongs to another tenant, the same answer for both (ADR-0015 amendment D113; the model names this 404 for the operation, D117); ProjectService is unavailable when the project of a Platform admin is confirmed (fail-fast dependency) | AIFACTORY-US-410 | enriched | | SCN-EnvironmentService-003 | endpoint | POST /factory/environments/{environmentId}/freeze with scope factory.projects.admin | the response is 200 with the environment in state Frozen; connectsoft.factory.environments.frozen rises by one for its tenant and class; on the event RunControlService holds the runs that target the environment and ToolAdapterService refuses shared-write and production calls that target it; a repeated call for an environment that is already Frozen returns 200 and writes no second event | 403: the scope lacks factory.projects.admin or the token grants no role in the project of the environment; 404: no environment with that environmentId exists in the tenant of the caller, which is also the answer for an environment of another tenant (ADR-0015); 409: the environment is Draft or Retired, which have no Freeze transition, or a concurrent change won the version check | AIFACTORY-US-411 | enriched | | SCN-EnvironmentService-004 | endpoint | POST /factory/environments/{environmentId}/unfreeze with scope factory.projects.admin | the response is 200 with the environment in state Active; connectsoft.factory.environments.frozen falls by one for its tenant and class; on the event RunControlService releases the runs it held for the environment; a repeated call for an environment that is already Active returns 200 and writes no second event | 403: the scope lacks factory.projects.admin, the token grants no role in the project of the environment, or the caller holds the scope but neither the Workspace admin role for that project nor the Platform admin role; 404: no environment with that environmentId exists in the tenant of the caller, which is also the answer for an environment of another tenant (ADR-0015); 409: the environment is Draft or Retired, which have no Unfreeze transition, or a concurrent change won the version check | AIFACTORY-US-411 | enriched | | SCN-EnvironmentService-005 | endpoint | gRPC Environments.GetPolicyClass (internal, none streaming) | the reply message, fixed by the contract test of the service, carries the scope fields tenantId, projectId and environmentId of that environment and beside them the fields class and state from the committed state of the store, so the caller raises a shared-write against a Production environment to a production action and refuses a shared-write or production call against a Frozen one; nothing is written | the caller presents no workload identity (UNAUTHENTICATED); its token lacks the service scope (PERMISSION_DENIED); the request names no environment (INVALID_ARGUMENT); no such environment exists in the forwarded tenant, which is also the answer for an environment of another tenant (NOT_FOUND, ADR-0015); the store is unavailable (UNAVAILABLE) | AIFACTORY-US-410 | enriched | | SCN-EnvironmentService-006 | event | EnvironmentService publishes EnvironmentCreated on projects.environments.v1.environment-created | the event is sent with environmentId, projectId, tenantId and class and with the tenant and the project in the envelope; IaCProvisioningService plans the baseline (ProvisionBaseline), RuntimeEnvironmentService opens the runtime inventory (TrackDeclared) and StudioBff refreshes its view (RefreshEnvironmentView), each in its own increment; each consumer is idempotent on the event id and proves its handling in its own suite | the transport is unavailable when the dispatcher runs, or the creation rolled back | AIFACTORY-US-409 | enriched | | SCN-EnvironmentService-007 | event | EnvironmentService publishes EnvironmentStateChanged on projects.environments.v1.environment-state-changed | the event is sent with environmentId, tenantId, fromState, toState and class, the policy class of the environment announced beside its state (D117), and with the tenant in the envelope; a Retire from Frozen lowers connectsoft.factory.environments.frozen by one for the tenant and class of the environment; RunControlService holds the runs of a frozen environment, releases them when it is active again, fails every non-terminal run of a retired environment and keeps the announced state and, beside it, the announced class of the environment in GateStates, from which it refuses at submission a run that targets a production-class environment with a release that is not Published (GateRunsByEnvironment), ToolAdapterService refuses shared-write and production calls against a Frozen environment (ApplyFreeze), EnvironmentPromotionService gates promotions (GateEnvironment), StudioBff refreshes its view and AuditService records the change as evidence; each consumer is idempotent on the event id and proves its handling in its own suite | the transport is unavailable when the dispatcher runs; a change is requested that is not one of the five transitions; two transitions of one environment commit concurrently | AIFACTORY-US-412 | enriched |

ExecutionCapacityService

Service in BC-26; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ExecutionCapacityService-001 | endpoint | GET /factory/capacity/pools with scope factory.capacity.read | the response is 200 with the shared pools and the dedicated pools of the caller's tenant, each with kind, security boundary, region, node profile, minimum, maximum and current size, utilisation and state; a dedicated pool of another tenant never appears (row-filter isolation, ADR-0015); nothing is written | 403: the caller's scope lacks factory.capacity.read | AIFACTORY-US-1041 | enriched | | SCN-ExecutionCapacityService-002 | endpoint | PUT /factory/capacity/pools/{poolId} with scope factory.capacity.admin | the response is 201 for a new pool and 200 for a change; the same body repeated is answered 200 and writes nothing (natural idempotency) | 403: the caller lacks factory.capacity.admin or is not a Platform admin; 404: the pool id exists as a dedicated pool of another tenant, which is never overwritten (ADR-0015); 422: the minimum exceeds the maximum, the region lies outside the residency bounds of the tenant of the pool, or the security boundary does not allow the kind of the pool; or the residency bounds cannot be read from RetentionResidencyService (fail-fast) | AIFACTORY-US-1041 | enriched | | SCN-ExecutionCapacityService-003 | endpoint | GET /factory/capacity/quotas with scope factory.capacity.read | the response is 200 with the effective quota of the tenant and of each of its projects, concurrent runs, concurrent sandboxes, cpu and memory per attempt and execution minutes per day, each limit with its source edition or override, the defaults read from RuntimeCloud:Capacity:EditionDefaults (D34) for the edition FactoryCommercialService answers; nothing is written | 403: the caller's scope lacks factory.capacity.read | AIFACTORY-US-1043 | enriched | | SCN-ExecutionCapacityService-004 | endpoint | PUT /factory/capacity/quotas/{scope} with scope factory.capacity.admin | the response is 200; the same body repeated is answered 200 and writes nothing (natural idempotency) | 403: the caller lacks factory.capacity.admin, or a Workspace admin addresses the defaults of an edition, which only a Platform admin sets; 404: the project belongs to another tenant (ADR-0015); 422: a project quota looser than its tenant quota, a tenant quota looser than the defaults of its edition, a negative value or an unknown scope | AIFACTORY-US-1043 | enriched | | SCN-ExecutionCapacityService-005 | endpoint | GET /factory/capacity/leases with scope factory.capacity.read | the response is 200 with the active and the recent leases of the caller's tenant within the retention of CapacityLeases, each with holder kind, holder id, pool, state, cpu, memory and its grant, expiry and release times, denied leases included; leases of another tenant never appear (row-filter isolation, ADR-0015); nothing is written | 403: the caller's scope lacks factory.capacity.read | AIFACTORY-US-1046 | enriched | | SCN-ExecutionCapacityService-006 | endpoint | gRPC Capacity.AcquireLease (internal, none streaming) | the reply carries the lease with its id, state, pool, expiry and workspaceRef; a repeat for the same holder kind and holder id while its lease is Granted or Active returns the same lease and grants nothing twice; when the pool, or from I2 a quota, has no room, the lease moves from Requested to Denied by QuotaOrPoolExhausted and the reply names the limit, with the reason pool-exhausted for an exhausted pool (D129), with no grant, and the holder asks again; from I2 the denied request of an exhausted pool is recorded in queuedRequests of PoolGrain as demand and queue-drain reserves freed capacity for the oldest queued holder, whose retry is granted | the caller has no workload identity (UNAUTHENTICATED), its token lacks factory.capacity.lease (PERMISSION_DENIED), the request lacks tenant, project or run or names an unknown holder kind (INVALID_ARGUMENT), in I1 it names the holder kind attempt, build or browser, which the one sandbox pool does not serve (FAILED_PRECONDITION), or it asks for a sandbox with a non-empty egress allow list, or from I2 a browser session, that no pool whose security boundary allows it can serve (FAILED_PRECONDITION) | AIFACTORY-US-1036 | enriched | | SCN-ExecutionCapacityService-007 | endpoint | gRPC Capacity.RenewLease (internal, none streaming) | the reply carries the lease with the same id, pool and workspaceRef and the new expiresAt; nothing is granted twice | the caller has no workload identity (UNAUTHENTICATED), its token lacks factory.capacity.lease (PERMISSION_DENIED), the request has no lease id (INVALID_ARGUMENT), the lease is unknown or of another tenant (NOT_FOUND, the same answer for both, ADR-0015), or the lease is already Released, Expired or Denied (FAILED_PRECONDITION) | AIFACTORY-US-1037 | enriched | | SCN-ExecutionCapacityService-008 | endpoint | gRPC Capacity.ReleaseLease (internal, none streaming) | the reply carries ack-v1; a second release by either path, or a redelivered event, finds the lease Released or Expired, is acknowledged and writes nothing, so capacity is freed once | the caller has no workload identity (UNAUTHENTICATED), its token lacks factory.capacity.lease (PERMISSION_DENIED), the request has no lease id (INVALID_ARGUMENT), or the lease is unknown or of another tenant (NOT_FOUND, the same answer for both, ADR-0015) | AIFACTORY-US-1038 | enriched | | SCN-ExecutionCapacityService-009 | event | ExecutionCapacityService publishes WorkerPoolStateChanged on capacity.pools.v1.worker-pool-state-changed | the payload carries poolId, tenantId, kind, fromState, toState and currentSize; each consumer (StudioBff (RefreshWorkerPoolView), AlertRuleService (FireFromCapacity), SloService (UpdateServiceHealth)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1042 | enriched | | SCN-ExecutionCapacityService-010 | event | ExecutionCapacityService publishes QuotaChanged on capacity.quotas.v1.quota-changed | the payload carries quotaId, tenantId, projectId where the quota is of a project, concurrentRuns and concurrentSandboxes; each consumer (RunControlService (ResumeDispatchOnQuota), StudioBff (RefreshQuotaView), AuditService (RecordEvidence, the evidence of the change)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1043 | enriched | | SCN-ExecutionCapacityService-011 | event | ExecutionCapacityService publishes QuotaExceeded on capacity.quotas.v1.quota-exceeded | the payload carries tenantId, projectId, holderKind, holderId and limit, which names the limiting quota; each consumer (CostUsageService (RecordQuotaDenial), RunControlService (HoldDispatchOnQuota), StudioBff (RefreshQuotaView)) handles it exactly once, idempotent on the event id, and the holder waits | the transport is unavailable or the consumer throws | AIFACTORY-US-1044 | enriched | | SCN-ExecutionCapacityService-012 | event | ExecutionCapacityService publishes CapacityLeaseGranted on capacity.leases.v1.capacity-lease-granted | the payload carries leaseId, tenantId, holderKind, holderId, poolId and expiresAt; the consumer CostUsageService (RecordCapacityUsage) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1036 | enriched | | SCN-ExecutionCapacityService-013 | event | ExecutionCapacityService publishes CapacityLeaseReleased on capacity.leases.v1.capacity-lease-released | the payload carries leaseId, tenantId, holderKind, holderId, poolId, state (Released or Expired) and executionSeconds; the consumer CostUsageService (RecordCapacityUsage) handles it exactly once, idempotent on the event id; one event exists per lease | the transport is unavailable or the consumer throws | AIFACTORY-US-1038 | enriched |

FactoryCommercialService

Service in BC-34; first delivered in I7. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-FactoryCommercialService-001 | endpoint | GET /factory/subscription with scope factory.commercial.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FactoryCommercialService-002 | endpoint | PUT /factory/subscription with scope factory.commercial.admin | the response is 200; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-FactoryCommercialService-003 | endpoint | GET /factory/invoices with scope factory.commercial.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FactoryCommercialService-004 | endpoint | gRPC Commercial.GetEntitlements (internal, none streaming) | the reply carries execution-scope-v1 and the side effect of the method's class happens once | the caller has no workload identity or the request fails validation | — | derived | | SCN-FactoryCommercialService-005 | event | FactoryCommercialService publishes SubscriptionChanged on factory-commercial.subscriptions.v1.subscription-changed | the payload carries subscriptionId, tenantId, edition, state; each consumer (CostUsageService (ApplyEditionLimits), StudioBff (RefreshFactorySubscriptionView), FleetInventoryService (ApplyEdition), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-FactoryCommercialService-006 | event | FactoryCommercialService publishes InvoiceIssued on factory-commercial.invoices.v1.invoice-issued | the payload carries invoiceId, tenantId, totalUsd; each consumer (StudioBff (RefreshFactorySubscriptionView), StudioNotificationService (NotifyOperators)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived |

FeedbackService

Service in BC-22; first delivered in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-FeedbackService-001 | endpoint | POST /factory/feedback with scope factory.feedback.write | the response is 201; the comment is stored through ArtifactService, the HumanFeedback row holds tenant and project from the trusted scope and the author from the token, and the FeedbackRecorded outbox record is written in the same transaction; the subject is not changed; a repeated call with the same key and body returns the same feedback and changes nothing | the caller's scope lacks factory.feedback.write, or ArtifactService is unreachable | AIFACTORY-US-1098 | enriched | | SCN-FeedbackService-002 | endpoint | GET /factory/feedback with scope factory.feedback.read | the response is 200 with the matching feedback of the caller tenant and projects in scope; no feedback of another tenant is listed and nothing is written | the caller's scope lacks factory.feedback.read | AIFACTORY-US-1098 | enriched | | SCN-FeedbackService-003 | endpoint | GET /factory/evaluation/datasets with scope factory.evaluation.read | the response is 200 with the datasets of the caller tenant, their versions, task counts and classification; nothing is written | the caller's scope lacks factory.evaluation.read | AIFACTORY-US-1099 | enriched | | SCN-FeedbackService-004 | endpoint | POST /factory/evaluation/datasets/{datasetId}/snapshot with scope factory.evaluation.run | the response is 202; DatasetSnapshotter stores the snapshot once through ArtifactService as an immutable artifact and writes a new Datasets row with a new datasetId, the same tenant and name, the version plus one, its task count, snapshot reference and tasks, together with the DatasetPublished outbox record in one transaction; every earlier row stays unchanged; a repeated call with the same key returns the same result and publishes no second version | the dataset belongs to another tenant or does not exist, the scope is missing, or ArtifactService fails on all three attempts of the worker | AIFACTORY-US-1099 | enriched | | SCN-FeedbackService-005 | endpoint | GET /factory/learning/proposals with scope factory.evaluation.read | the response is 200 with the matching proposals of the caller tenant, each with its evidence and expected effect; nothing is written | the caller's scope lacks factory.evaluation.read | AIFACTORY-US-1101 | enriched | | SCN-FeedbackService-006 | endpoint | POST /factory/learning/proposals/{proposalId}/decide with scope factory.assets.write | the response is 200; an accepted proposal is Accepted and AgentRegistryService opens the Draft release candidate of the target asset in BC-04 when it consumes the event, a rejected one is Rejected with the reason, both record the reviewer, and the LearningProposalDecided outbox record is written in the transaction of the decision; the same decision repeated by the same caller answers 200 with the recorded state, writes no second event and changes nothing | a different decision on an Accepted or Rejected proposal, a proposal that is Proposed or Superseded, a proposal of another tenant or an unknown id, or a missing scope | AIFACTORY-US-1102 | enriched | | SCN-FeedbackService-007 | endpoint | gRPC Learning.GetDatasetSnapshot (internal, none streaming) | the reply carries artifact-v1 with the reference of the immutable snapshot of that version; the method is a read, nothing is written and the same request answers the same | the version does not exist, the dataset belongs to another tenant or the version has no snapshot; or the caller has no workload identity, lacks the service scope, or the request fails validation | AIFACTORY-US-1100 | enriched | | SCN-FeedbackService-008 | event | FeedbackService publishes FeedbackRecorded on evaluation.feedback.v1.feedback-recorded | the payload carries feedbackId, tenantId, subjectKind, subjectRef, kind and, for a rating, rating; StudioBff (RefreshHumanFeedbackView) handles it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-1098 | enriched | | SCN-FeedbackService-009 | event | FeedbackService publishes DatasetPublished on evaluation.datasets.v1.dataset-published | the payload carries datasetId, tenantId, name, version and taskCount; StudioBff (RefreshDatasetView) and QualityScoreService (RefreshSuiteDataset) each handle it exactly once, idempotent on the event id; a suite that pins an older version keeps it | the transport is unavailable or a consumer throws | AIFACTORY-US-1099 | enriched | | SCN-FeedbackService-010 | event | FeedbackService publishes LearningProposalRaised on evaluation.learning.v1.learning-proposal-raised | the payload carries proposalId, tenantId, kind, targetAssetId and targetVersion; StudioBff (RefreshLearningProposalView), StudioNotificationService (NotifyMaintainers) and AuditService (RecordEvidence) each handle it exactly once, idempotent on the event id; the same evidence never raises a second proposal | the transport is unavailable or a consumer throws, or the drafting model is unavailable | AIFACTORY-US-1101 | enriched | | SCN-FeedbackService-011 | event | FeedbackService publishes LearningProposalDecided on evaluation.learning.v1.learning-proposal-decided | the payload carries proposalId, tenantId, state and, for an accepted proposal, targetAssetId, targetVersion and summaryRef without resultingReleaseId; AgentRegistryService (OpenReleaseCandidate), StudioBff (RefreshLearningProposalView) and AuditService (RecordEvidence) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-1102 | enriched |

FleetIncidentService

Service in BC-37; first delivered in I7. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-FleetIncidentService-001 | endpoint | GET /factory/fleet/incidents with scope factory.fleet.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetIncidentService-002 | endpoint | GET /factory/fleet/incidents/{incidentId} with scope factory.fleet.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetIncidentService-003 | endpoint | POST /factory/fleet/incidents with scope factory.fleet.operate | the response is 201; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetIncidentService-004 | endpoint | POST /factory/fleet/incidents/{incidentId}/transition with scope factory.fleet.operate | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetIncidentService-005 | endpoint | GET /factory/fleet/on-call with scope factory.fleet.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetIncidentService-006 | endpoint | PUT /factory/fleet/on-call/{recordId} with scope factory.fleet.admin | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetIncidentService-007 | endpoint | POST /factory/fleet/offboardings with scope factory.fleet.admin | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetIncidentService-008 | endpoint | POST /factory/fleet/offboardings/{offboardingId}/acknowledge-handover with scope factory.fleet.admin | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetIncidentService-009 | endpoint | GET /factory/fleet/offboardings/{offboardingId} with scope factory.fleet.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetIncidentService-010 | event | FleetIncidentService publishes IncidentOpened on fleet-operations.incidents.v1.incident-opened | the payload carries incidentId, tenantId, productId, severity, title; each consumer (StudioBff (RefreshProductIncidentView), StudioNotificationService (NotifyOnCall), AuditService (RecordEvidence), AlertRuleService (FireFromIncident)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-FleetIncidentService-011 | event | FleetIncidentService publishes IncidentStateChanged on fleet-operations.incidents.v1.incident-state-changed | the payload carries incidentId, tenantId, productId, fromState, toState; each consumer (StudioBff (RefreshProductIncidentView), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-FleetIncidentService-012 | event | FleetIncidentService publishes IncidentResolved on fleet-operations.incidents.v1.incident-resolved | the payload carries incidentId, tenantId, productId, severity, durationMinutes; each consumer (StudioBff (RefreshProductIncidentView), AuditService (RecordEvidence), FeedbackService (HarvestIncident), SloService (EvaluateSlos)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-FleetIncidentService-013 | event | FleetIncidentService publishes OnCallChanged on fleet-operations.on-call.v1.on-call-changed | the payload carries recordId, tenantId, responder, from, to; each consumer (StudioBff (RefreshOnCallRecordView), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-FleetIncidentService-014 | event | FleetIncidentService publishes OffboardingRequested on fleet-operations.offboarding.v1.offboarding-requested | the payload carries offboardingId, tenantId, productId, customerTenantId; each consumer (FactoryCommercialService (FreezeBillingOnOffboarding), StudioBff (RefreshOffboardingView), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-FleetIncidentService-015 | event | FleetIncidentService publishes OffboardingCompleted on fleet-operations.offboarding.v1.offboarding-completed | the payload carries offboardingId, tenantId, productId, customerTenantId, deletionOrderId; each consumer (FactoryCommercialService (AdjustMeter), StudioBff (RefreshOffboardingView), FleetInventoryService (RetireProduct), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived |

FleetInventoryService

Service in BC-35; first delivered in I7. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-FleetInventoryService-001 | endpoint | GET /factory/fleet/products with scope factory.fleet.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetInventoryService-002 | endpoint | GET /factory/fleet/products/{productId} with scope factory.fleet.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetInventoryService-003 | endpoint | POST /factory/fleet/products with scope factory.fleet.admin | the response is 201; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetInventoryService-004 | endpoint | GET /factory/fleet/products/{productId}/instances with scope factory.fleet.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetInventoryService-005 | endpoint | PUT /factory/fleet/products/{productId}/objectives/{kind} with scope factory.fleet.admin | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetInventoryService-006 | endpoint | gRPC Fleet.GetInstance (internal, none streaming) | the reply carries ack-v1 and the side effect of the method's class happens once | the caller has no workload identity or the request fails validation | — | derived | | SCN-FleetInventoryService-007 | event | FleetInventoryService publishes ProductOnboarded on fleet-inventory.products.v1.product-onboarded | the payload carries productId, tenantId, projectId, edition; each consumer (FactoryCommercialService (AccumulateMeter), StudioBff (RefreshOperatedProductView), AuditService (RecordEvidence), SloService (TrackProductHealth)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-FleetInventoryService-008 | event | FleetInventoryService publishes ProductInstanceStateChanged on fleet-inventory.products.v1.product-instance-state-changed | the payload carries instanceId, productId, tenantId, customerTenantId, environmentId; each consumer (StudioBff (RefreshOperatedProductView), FleetIncidentService (TrackAffected), FleetRolloutService (TrackInstances)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-FleetInventoryService-009 | event | FleetInventoryService publishes ProductObjectiveDefined on fleet-inventory.objectives.v1.product-objective-defined | the payload carries objectiveId, tenantId, productId, kind, target; each consumer (StudioBff (RefreshProductObjectiveView), AuditService (RecordEvidence), SloService (ApplyProductObjective)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived |

FleetOperationsHost

Service in BC-35; first delivered in I7. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-FleetOperationsHost-001 | endpoint | GET /fleet/health with scope factory.health.read | the response is 200 | 503: the request cannot be applied | — | derived | | SCN-FleetOperationsHost-002 | endpoint | GET /fleet/meta/summary with scope factory.meta.read | the response is 200 | the required dependency is unavailable | — | derived | | SCN-FleetOperationsHost-003 | route-class | a request to a production route fronted by FleetOperationsHost (FleetIncidentService, FleetRolloutService) | the action is approval-gated and audited; the gateway refuses it without the promotion's approval; the response returns unchanged with the correlation id | no token, an expired token or a project the token does not grant | — | derived | | SCN-FleetOperationsHost-004 | route-class | a request to a read route fronted by FleetOperationsHost (FleetIncidentService, FleetInventoryService, FleetRolloutService) | the response is served from the fronted service with no side effect; the response returns unchanged with the correlation id | no token, an expired token or a project the token does not grant | — | derived | | SCN-FleetOperationsHost-005 | route-class | a request to a shared-write route fronted by FleetOperationsHost (FleetIncidentService, FleetInventoryService, FleetRolloutService) | the request carries an idempotency key and the fronted service applies it once; the response returns unchanged with the correlation id | no token, an expired token or a project the token does not grant | — | derived |

FleetRolloutService

Service in BC-36; first delivered in I7. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-FleetRolloutService-001 | endpoint | GET /factory/fleet/rollouts with scope factory.fleet.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetRolloutService-002 | endpoint | GET /factory/fleet/rollouts/{rolloutId} with scope factory.fleet.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetRolloutService-003 | endpoint | POST /factory/fleet/rollouts with scope factory.fleet.operate | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetRolloutService-004 | endpoint | POST /factory/fleet/rollouts/{rolloutId}/resume with scope factory.fleet.operate | the response is 202 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetRolloutService-005 | endpoint | POST /factory/fleet/rollouts/{rolloutId}/rollback with scope factory.fleet.operate | the response is 202 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetRolloutService-006 | endpoint | POST /factory/fleet/rollouts/{rolloutId}/cancel with scope factory.fleet.operate | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-FleetRolloutService-007 | event | FleetRolloutService publishes RolloutPlanned on fleet-rollouts.rollouts.v1.rollout-planned | the payload carries rolloutId, tenantId, productId, kind, waves; each consumer (StudioBff (RefreshRolloutView), StudioNotificationService (NotifyOperators), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-FleetRolloutService-008 | event | FleetRolloutService publishes RolloutWaveCompleted on fleet-rollouts.rollouts.v1.rollout-wave-completed | the payload carries rolloutId, tenantId, productId, wave, instances; each consumer (StudioBff (RefreshRolloutView), FleetInventoryService (UpdateInstanceRelease)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-FleetRolloutService-009 | event | FleetRolloutService publishes RolloutHalted on fleet-rollouts.rollouts.v1.rollout-halted | the payload carries rolloutId, tenantId, productId, wave, reason; each consumer (StudioBff (RefreshRolloutView), StudioNotificationService (NotifyOperators), FleetIncidentService (OpenFromRollout), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-FleetRolloutService-010 | event | FleetRolloutService publishes RolloutCompleted on fleet-rollouts.rollouts.v1.rollout-completed | the payload carries rolloutId, tenantId, productId, state, targetReleaseId; each consumer (StudioBff (RefreshRolloutView), FleetInventoryService (UpdateInstanceRelease), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived |

GeneratedProductHost

Service in BC-30; first delivered in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-GeneratedProductHost-001 | endpoint | GET /product/descriptor with scope product.admin.read | the response is 200 | the required dependency is unavailable | — | derived | | SCN-GeneratedProductHost-002 | endpoint | GET /product/health with scope product.health.read | the response is 200 | 503: the request cannot be applied | — | derived | | SCN-GeneratedProductHost-003 | endpoint | GET /product/operations/handover with scope product.admin.read | the response is 200 | 404: the addressed resource is absent or outside the caller's scope | — | derived | | SCN-GeneratedProductHost-004 | endpoint | POST /product/operations/handover/acknowledge with scope product.admin.write | the response is 200 | 404: the addressed resource is absent or outside the caller's scope | — | derived | | SCN-GeneratedProductHost-005 | endpoint | POST /product/operations/export with scope product.admin.write | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-GeneratedProductHost-006 | endpoint | POST /product/operations/delete-tenant with scope product.admin.write | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-GeneratedProductHost-007 | event | GeneratedProductHost publishes ProductDescriptorPublished on product-domains.descriptor.v1.product-descriptor-published | the payload carries productId, tenantId, releaseId, tenancyMode, operationsMode; each consumer (StudioBff (RefreshProductDescriptorView), FleetInventoryService (ApplyProductDescriptor), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-GeneratedProductHost-008 | event | GeneratedProductHost publishes OperationsHandoverAcknowledged on product-domains.operations.v1.operations-handover-acknowledged | the payload carries handoverId, tenantId, productId, managedEdition; each consumer (FactoryCommercialService (AccumulateMeter), StudioBff (RefreshManagedOperationsHandoverView), FleetInventoryService (MarkManagedOperation), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived |

GeneratedSaasFoundations

Service in BC-31; first delivered in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-GeneratedSaasFoundations-001 | endpoint | GET /product/tenants with scope product.admin.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-GeneratedSaasFoundations-002 | endpoint | POST /product/tenants with scope product.admin.write | the response is 201; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-GeneratedSaasFoundations-003 | endpoint | GET /product/tenants/{productTenantId}/subscription with scope product.admin.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-GeneratedSaasFoundations-004 | endpoint | PUT /product/tenants/{productTenantId}/subscription with scope product.admin.write | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-GeneratedSaasFoundations-005 | endpoint | gRPC Foundations.ResolveTenant (internal, none streaming) | the reply carries ack-v1 and the side effect of the method's class happens once | the caller has no workload identity or the request fails validation | — | derived | | SCN-GeneratedSaasFoundations-006 | event | GeneratedSaasFoundations publishes ProductTenantProvisioned on product-tenancy.tenants.v1.product-tenant-provisioned | the payload carries productTenantId, factoryTenantId, customerTenantId, region; each consumer (FleetInventoryService (RegisterInstance), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-GeneratedSaasFoundations-007 | event | GeneratedSaasFoundations publishes ProductTenantStateChanged on product-tenancy.tenants.v1.product-tenant-state-changed | the payload carries productTenantId, factoryTenantId, customerTenantId, fromState, toState; each consumer (FleetIncidentService (TrackAffected), FleetInventoryService (UpdateInstanceState), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-GeneratedSaasFoundations-008 | event | GeneratedSaasFoundations publishes ProductSubscriptionChanged on product-tenancy.subscriptions.v1.product-subscription-changed | the payload carries subscriptionId, factoryTenantId, customerTenantId, edition, state; each consumer (FleetInventoryService (ApplyEdition), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-GeneratedSaasFoundations-009 | event | GeneratedSaasFoundations publishes ProductUsageMetered on product-tenancy.usage.v1.product-usage-metered | the payload carries subscriptionId, factoryTenantId, customerTenantId, dimension, period; each consumer (FleetInventoryService (RecordInstanceUsage)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived |

GenerationRecipeService

Service in BC-15; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-GenerationRecipeService-001 | endpoint | GET /factory/recipes with scope factory.recipes.read | the response is 200 with the recipes of the named project, each with its versions and their states; no row of another tenant or of a project outside the trusted scope appears, and nothing is written | 400: the call carries no projectId; 403: the scope of the caller lacks factory.recipes.read, the gateway finds that the roles of the token do not grant the named project, or the named project differs from the project of the trusted scope the service receives | AIFACTORY-US-684 | enriched | | SCN-GenerationRecipeService-002 | endpoint | GET /factory/recipes/{recipeId}/versions/{version} with scope factory.recipes.read | the response is 200 with the blueprint version the recipe is built on, the module plan with the kind, context, template id and version, switches, parameters and path of each module, the design inputs each module pins by id, version and hash, the library versions, the repository layout, the compatibility evidence, the state, the approver and draftAllowanceUsed, which says whether the recipe binds a Submitted blueprint version or a discovered template version under the Draft allowance; a module that pins a template version for which a newer Published version is known in the catalog rows of the platform tenant names that version as available; nothing is written | 403: the scope of the caller lacks factory.recipes.read; 404: no recipe with that recipeId and version exists in the tenant and project of the caller; a recipe of another tenant is not found under the tenant row filter of the service and is answered 404, the same answer as for an id that does not exist (ADR-0015) | AIFACTORY-US-684 | enriched | | SCN-GenerationRecipeService-003 | endpoint | POST /factory/recipes with scope factory.recipes.write | the response is 201 with the recipe id and version; no integration event of the service is published, because the model names none for this command, and one audit-evidence-v1 record with the actor, the recipe id and the version is written to the outbox in the transaction of the command; connectsoft.factory.recipes counts the Draft; a repeated call with the same Idempotency-Key and the same body returns the same recipe and changes nothing | 400: the body carries no projectId; 403: the scope of the caller lacks factory.recipes.write, the gateway finds that the roles of the token do not grant the named project, or the named project differs from the project of the trusted scope the service receives; 409: the same Idempotency-Key arrives with another body (ADR-0014 decision 3); 412: BindableBlueprintVersions does not hold the blueprint id and version for the trusted tenant and project, whether it is unknown, belongs to another project or tenant or was not yet submitted, and the answer never says which (ADR-0015), and from I4 every version that is not Published; 422: a module entry names an unknown module kind or no template, the body names a recipe id that the project of the trusted scope does not hold, or the body carries no plan and no proposal exists for the blueprint version | AIFACTORY-US-683 | enriched | | SCN-GenerationRecipeService-004 | endpoint | POST /factory/recipes/{recipeId}/versions/{version}/validate with scope factory.recipes.write | the response is 200 with the result; a recipe that holds every rule moves from Draft to Validated through PlanValidated with its compatibility evidence, and draftAllowanceUsed is true exactly when a Submitted blueprint version or a template version that is not yet Published is bound or, until I4, a library passed with a cell that is Unknown; a recipe that breaks a rule stays Draft with one failure per broken rule that names the module and the pin or library; a compatibility cell that is Compatible passes with its entry id as evidence, one that is CompatibleWithWarnings passes with a warning, one that is Unknown passes until I4 with a finding of severity warning under the Draft allowance and fails from I4 (D125), and one that is Incompatible or missing fails with a reason of its own; RecipeValidated with passed true or false is written in the same transaction; a repeated call for an unchanged recipe returns the same result and publishes nothing again | 403: the scope of the caller lacks factory.recipes.write; 404: the recipe does not exist in the tenant and project of the caller, a recipe of another tenant included (ADR-0015); 422: the recipe is Approved, Executing, Generated or Superseded; 503: TemplateRegistryService or BlueprintService, required dependencies that fail fast, does not answer after the second attempt of the validator | AIFACTORY-US-685 | enriched | | SCN-GenerationRecipeService-005 | endpoint | POST /factory/recipes/{recipeId}/versions/{version}/approve with scope factory.recipes.approve | the response is 200; the recipe is immutable from then on and a change is a new version that needs its own approval; a repeated call for a version already Approved returns 200 and writes nothing | 403: the scope of the caller lacks factory.recipes.approve, or the caller lacks the Reviewer role while the option requires it; 404: the recipe does not exist in the tenant and project of the caller, a recipe of another tenant included (ADR-0015); 409: the recipe is Draft, Executing, Generated or Superseded, or a pin of the Validated recipe no longer resolves; 503: ArtifactService, a required dependency that fails fast, does not answer | AIFACTORY-US-686 | enriched | | SCN-GenerationRecipeService-006 | endpoint | GET /factory/projects/{projectId}/generated-outputs with scope factory.recipes.read | the response is 200 with the provenance of the generated modules of that project by commit, each with recipe version, run, attempt, agent release, template version, manifest hash, the generated files with their hashes and the preserved paths, and with the proposal id and the commit once the change proposal was merged; a project without recorded outputs is answered 200 with an empty list; nothing is written | 403: the scope of the caller lacks factory.recipes.read; 404: the path projectId is not the project of the trusted scope of the caller, whether that id is unknown, belongs to another tenant or names a project of the same tenant outside the scope (ADR-0015) | AIFACTORY-US-687 | enriched | | SCN-GenerationRecipeService-007 | endpoint | gRPC Recipes.GetApprovedRecipe (internal, none streaming) | the reply carries artifact-v1 with the reference and content hash of the recipe document, which holds the module plan with its counts by module kind and every pinned design input of every module resolved to its reference (ADR-0027); nothing is written | the caller has no workload identity (Unauthenticated), its token lacks the service scope (PermissionDenied), the request is invalid (InvalidArgument), the recipe is unknown or belongs to another tenant (NOT_FOUND, ADR-0015), or the recipe is Draft, Validated, Generated or Superseded (FailedPrecondition) | AIFACTORY-US-687 | enriched | | SCN-GenerationRecipeService-008 | endpoint | gRPC Recipes.RecordOutput (internal, none streaming) | the reply carries ack-v1; connectsoft.factory.recipes.generated_modules counts the module; a repeated call for the same run, recipe and change set hash returns the same acknowledgement and records nothing (D133) | the caller has no workload identity (Unauthenticated), its token lacks the service scope (PermissionDenied), the module is not in the plan of the recipe, the template version is not the one the module pins or a path is listed as both generated and preserved (InvalidArgument), the recipe is unknown or belongs to another tenant (NOT_FOUND, ADR-0015), or the recipe is neither Approved nor Executing (FailedPrecondition) | AIFACTORY-US-687 | enriched | | SCN-GenerationRecipeService-009 | event | GenerationRecipeService publishes RecipeValidated on generation.recipes.v1.recipe-validated | the payload carries recipeId, version, tenantId, projectId, passed and modules, the number of modules, and no recipe content; StudioBff (RefreshGenerationRecipeView) and AuditService (RecordEvidence) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-685 | enriched | | SCN-GenerationRecipeService-010 | event | GenerationRecipeService publishes RecipeApproved on generation.recipes.v1.recipe-approved | the payload carries recipeId, version, tenantId, projectId and approvedBy; WorkflowEngineService (CorrelateSignal), whose readiness correlation submits the generation run, RunControlService (MarkApprovalStale), StudioBff (RefreshGenerationRecipeView) and AuditService (RecordEvidence) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-686 | enriched | | SCN-GenerationRecipeService-011 | event | GenerationRecipeService publishes GenerationCompleted on generation.recipes.v1.generation-completed | the payload carries recipeId, version, tenantId, projectId, runId, modules, the number of modules whose provenance is recorded, and proposalIds, the proposal ids known for those outputs, an empty list when none is known; WorkflowEngineService (CorrelateSignal), StudioBff (RefreshGenerationRecipeView), DashboardService (ProjectGenerationRecipe), FleetRolloutService (OfferRollout), RepositoryIntelligenceService (BuildIndexSet) and AuditService (RecordEvidence) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws; the run failed or was cancelled instead, or the run event is delivered twice or names a run no recipe is Executing for | AIFACTORY-US-688 | enriched | | SCN-GenerationRecipeService-012 | event | GenerationRecipeService publishes GeneratedOutputRecorded on generation.outputs.v1.generated-output-recorded | the payload carries outputId, tenantId, projectId, moduleName, templateId, templateVersion, runId and, once known, proposalId, and no file content; StudioBff (RefreshGeneratedOutputView), AuditService (RecordEvidence) and RepositoryIntelligenceService (PrepareRepository) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-687 | enriched |

GovernanceHost

Service in BC-18; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-GovernanceHost-001 | endpoint | GET /governance/health with scope factory.health.read | the response is 200; the detail names the identity platform and each fronted service with its state; a fronted service that does not answer, or that is not deployed yet as ApprovalPolicyService is until I4, is reported as unavailable in the detail and does not turn the answer into 503, because it is an optional dependency and the routes of the other services keep serving; while the identity platform is unreachable and a cached signing key still validates tokens, the gateway stays in rotation: readiness stays ready, tokens that were already issued keep passing, and from the first failed probe the response is still 200 with the health degraded and a detail that names the identity platform as unreachable (D117); nothing is written | 503: the identity platform, the one required dependency, is unreachable and no valid signing key remains, because none was cached or the cached keys expired, so the gateway cannot validate tokens | AIFACTORY-US-932 | enriched | | SCN-GovernanceHost-002 | endpoint | GET /governance/meta/revisions with scope factory.meta.read | the response is 200 with the active policy revisions per scope, the approval rule revisions per scope and the head of the audit hash chain as the metadata port of the gateway reports them; on an instance whose port has no source, which is every deployed instance until the owner names the operations that return them, each member is stated as not reported and no value is invented; no operation of a fronted service is called and nothing is written | 401: no token or an expired token; 403: the token lacks factory.meta.read; the identity platform is unreachable and no valid signing key remains to validate the token | AIFACTORY-US-932 | enriched | | SCN-GovernanceHost-003 | route-class | a request to a external route fronted by GovernanceHost (AuditService) | AuditService accepts the export and answers 202, its own worker produces the package in open formats with chain proofs, and where the command leaves audit evidence the service writes it to its own outbox in the transaction of the command; the gateway calls no connector, writes no receipt and no evidence and keeps nothing; the answer of the service returns unchanged with the correlation id, and so does the reply of SecretBroker.Verify on its gRPC route | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation or grants no role in the project the path names; PERMISSION_DENIED: a workload token without the service scope, or a user token, on the gRPC route; 404: AuditService answers it for a project that does not exist in the tenant of the token (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-931 | enriched | | SCN-GovernanceHost-004 | route-class | a request to a production route fronted by GovernanceHost (AuditService, SecretBrokerService) | the fronted service decides the command: AuditService sets the classification or answers 409, and SecretBrokerService registers, rotates or revokes the reference and talks to the vault itself; whatever gate a command has is decided by the fronted service that owns it; the gateway evaluates no policy and no approval, holds no classification and no secret reference and logs no body of these routes; the answer of the service, including 200, 201 and 409, returns unchanged with the correlation id | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation, or the fronted service answers it for a missing role; 404: the fronted service answers it for a secret reference of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-931 | enriched | | SCN-GovernanceHost-005 | route-class | a request to a read route fronted by GovernanceHost (ApprovalPolicyService, AuditService, PolicyEngineService, SecretBrokerService) | the fronted service serves the response and the gateway writes nothing; the response returns unchanged with the correlation id; a route addressed by a revision, a run or an approval is forwarded under the tenant of the token, and the 403 of the fronted service for a missing role and its 404 for a resource of another tenant return unchanged; the gRPC routes of Policy.Decide, Policy.GetActiveRevision, Policy.ValidateTightening, ApprovalPolicy.Route, ApprovalPolicy.ValidateDecision and Audit.Classify forward the tenant-id and the project metadata of a workload token that holds the service scope unchanged; the gateway caches no decision, no revision and no routing | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation, or a workload token is presented on a REST route; PERMISSION_DENIED: a workload token without the service scope, or a user token, on a gRPC route; 503, over gRPC UNAVAILABLE: the fronted service does not answer or is not deployed yet, as ApprovalPolicyService is until I4 | AIFACTORY-US-929 | enriched | | SCN-GovernanceHost-006 | route-class | a request to a sandbox route fronted by GovernanceHost (ApprovalPolicyService, PolicyEngineService) | the fronted service validates or simulates the candidate and stores nothing, activates nothing and publishes nothing; its result, valid or not valid, returns unchanged with its status and the correlation id; the gateway reads no candidate and keeps none | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope, it is a workload token, or it grants no role in the project the path names; 400 and 404: the fronted service answers them for an unreadable candidate and for a project that does not exist in the tenant; 503: the fronted service does not answer or is not deployed yet, as ApprovalPolicyService is until I4 | AIFACTORY-US-929 | enriched | | SCN-GovernanceHost-007 | route-class | a request to a shared-write route fronted by GovernanceHost (AuditService) | the fronted service applies the request under its own rule and its answer returns unchanged with the correlation id; the gateway is no party to idempotency: it stores neither a request nor a result and replays nothing after a replica crash, so the caller repeats the call; the credential in the reply of SecretBroker.Issue passes through and is written to no log record, no activity, no metric and no cache entry | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; PERMISSION_DENIED: a workload token without the service scope, or a user token, on a gRPC route; 404: AuditService answers it for a finding of another tenant (ADR-0015 amendment D113); 503, over gRPC UNAVAILABLE: the fronted service does not answer | AIFACTORY-US-930 | enriched |

IaCProvisioningService

Service in BC-25; first delivered in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-IaCProvisioningService-001 | endpoint | GET /factory/provisioning/specifications with scope factory.provisioning.read | the response is 200 with the specifications of the projects the caller holds a role in, per environment with every version, its program reference and commit, and configuration and secret references as references only; a Platform admin receives every project of the tenant; no row of another tenant appears and nothing is written | 403: the caller's scope lacks factory.provisioning.read | AIFACTORY-US-1071 | enriched | | SCN-IaCProvisioningService-002 | endpoint | GET /factory/provisioning/runs with scope factory.provisioning.read | the response is 200 with only the matching runs of the projects the caller holds a role in, each with state, kind, specification version and receipt summaries; no run of another project or tenant appears, no secret output is in a receipt and nothing is written | 403: the caller's scope lacks factory.provisioning.read | AIFACTORY-US-1072 | enriched | | SCN-IaCProvisioningService-003 | endpoint | GET /factory/provisioning/runs/{provisioningRunId} with scope factory.provisioning.read | the response is 200 with the state, the plan receipt, the approval reference, the apply receipt and the logs reference of the run; an output the program marked as secret is absent from the reply and nothing is written | the caller lacks the scope or a role in the project, or the run belongs to another tenant or does not exist | AIFACTORY-US-1072 | enriched | | SCN-IaCProvisioningService-004 | endpoint | POST /factory/provisioning/runs with scope factory.provisioning.apply | the response is 202 with the run location and the ProvisioningRun is Planned; the plan is recorded before any apply, and an empty plan ends Cancelled with the reason no-changes without reaching the gate; a run without the approval of a promotion is gated by the policy decision of PolicyEngineService alone, asked with the action kind provisioning-apply, which pairs with the domain Deployment, the target provisioning-apply, the side-effect class of the plan, the environment and the hash of the plan receipt (D127, D129); allow, and allow-with-constraints the service can honour, move it to Applying with the decision id in the plan receipt and AuditEvidenceSubmitted with the action policy-allowed; allow-with-approval moves it to AwaitingApproval with the approval requested through RunControlService for the subject kind provisioning-run, also for a run without a Factory run (D129, D135), and bound to the hash of the plan receipt, and only an approval of that hash moves it on; deny ends the run Failed and writes AuditEvidenceSubmitted with the action policy-denied and ProvisioningFailed (D129); a repeated call with the same idempotency key returns the same run and changes nothing | the same key with a different body, an invalid body, a version the specification does not hold or the kind Promotion, a missing scope or role, a specification of another tenant, a constraint the service cannot honour, or the policy decision answering INVALID_ARGUMENT, FAILED_PRECONDITION or UNAVAILABLE or the planner failing | AIFACTORY-US-1073 | enriched | | SCN-IaCProvisioningService-005 | endpoint | POST /factory/provisioning/runs/{provisioningRunId}/cancel with scope factory.provisioning.apply | the response is 200, the run is Cancelled, the Applier never takes it and no event is written; the same call repeated returns 200 and changes nothing | the run is in AwaitingApproval, Applying, Applied or another later state, the caller lacks the scope or a role, or the run belongs to another tenant or does not exist | AIFACTORY-US-1075 | enriched | | SCN-IaCProvisioningService-006 | endpoint | gRPC Provisioning.GetCurrentSpecification (internal, none streaming) | the reply names the last applied specification version per specification kind of the environment, each with its kind, program reference, commit and release, beside the ack-v1 members, never a declared version that was not applied, and nothing is written, because the method is of class read | no workload identity, a token without the scope, an invalid request or an environment of another tenant | AIFACTORY-US-1071 | enriched | | SCN-IaCProvisioningService-007 | event | IaCProvisioningService publishes SpecificationDeclared on provisioning.specifications.v1.specification-declared | the payload carries specificationId, tenantId, environmentId, kind, version and programVersion and no secret value; the same commit named again writes no version and no record; this service proves the publication, and each consumer the model lists, RuntimeEnvironmentService, StudioBff and AuditService, proves its handling idempotent on the event id in its own suite | the transport is unavailable | AIFACTORY-US-1071 | enriched | | SCN-IaCProvisioningService-008 | event | IaCProvisioningService publishes ProvisioningPlanned on provisioning.runs.v1.provisioning-planned | the payload carries provisioningRunId, tenantId, environmentId, kind, the optional promotionId and planSummary, which is empty for an empty plan whose run ends Cancelled with the reason no-changes; this service proves the publication, and each consumer the model lists, StudioBff, AuditService and EnvironmentPromotionService, proves its handling idempotent on the event id in its own suite | the transport is unavailable | AIFACTORY-US-1073 | enriched | | SCN-IaCProvisioningService-009 | event | IaCProvisioningService publishes ProvisioningApplied on provisioning.runs.v1.provisioning-applied | the payload carries provisioningRunId, tenantId, projectId, environmentId, kind, the optional promotionId, specificationVersion and outputs, without an output marked secret; a duplicate trigger applies nothing twice; this service proves the publication, and each consumer the model lists, ExecutionCapacityService, EnvironmentPromotionService, RuntimeEnvironmentService, EnvironmentService, StudioBff and AuditService, proves its handling idempotent on the event id in its own suite | the transport is unavailable, or ArtifactService does not answer when the logs and the state snapshot are stored | AIFACTORY-US-1074 | enriched | | SCN-IaCProvisioningService-010 | event | IaCProvisioningService publishes ProvisioningFailed on provisioning.runs.v1.provisioning-failed | the payload carries provisioningRunId, tenantId, environmentId, kind, the optional promotionId and reason, with no secret value; the runner was called at most once and the service never retries the cloud write; this service proves the publication, and each consumer the model lists, EnvironmentPromotionService, RuntimeEnvironmentService, StudioBff, AuditService and AlertRuleService, proves its handling idempotent on the event id in its own suite | the transport is unavailable | AIFACTORY-US-1074 | enriched |

IntegrationHost

Service in BC-16; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-IntegrationHost-001 | endpoint | GET /integration/health with scope factory.health.read | the response is 200; the detail names the identity platform and each fronted service with its state; a fronted service that does not answer is reported as unavailable in the detail and the answer stays 200, its routes answer 503 with a retry hint and the routes of the other service keep serving | the identity platform is unreachable | AIFACTORY-US-1013 | enriched | | SCN-IntegrationHost-002 | endpoint | GET /integration/meta/connectors with scope factory.meta.read | the response is 200 with the two services this gateway fronts and their repositories, as deployment.fronts of the model lists them, and with the adapters its metadata port returns, each with its version and capability interfaces; when the port has no source the adapters are stated as not reported and no value is invented; no fronted service is called and nothing is written | a call without a token or with a token that lacks factory.meta.read | AIFACTORY-US-1013 | enriched | | SCN-IntegrationHost-003 | route-class | a request to a external route fronted by IntegrationHost (ConnectorRegistryService, IntegrationService) | the fronted service decides the external action under its own rules: IntegrationService probes the credential through the Secret Broker and answers 200 with the outcome, ConnectorRegistryService creates the subscription or makes the delivery after the policy decision of PolicyEngineService and writes its event and its audit evidence AuditEvidenceSubmitted to its own outbox in the transaction of its command; the response returns unchanged with the correlation id; the gateway calls no connector, reads no credential and writes no receipt | no token, an expired token, a token without the scope of the operation, a project in the body of CreateSubscription the token does not grant, a user token on the gRPC route or a connection of another tenant | AIFACTORY-US-1012 | enriched | | SCN-IntegrationHost-004 | route-class | a request to a production route fronted by IntegrationHost (IntegrationService) | IntegrationService decides the production action under its own rules: whether it needs an approval is decided by the policy decision of PolicyEngineService alone, and the service writes its event and its audit evidence AuditEvidenceSubmitted on audit.evidence.v1.evidence-submitted to its own outbox in the transaction of its command; its answer returns unchanged with the correlation id; the gateway evaluates no policy and no approval and holds none | no token, an expired token, a token without the scope, a connection of another tenant or a refused policy decision | AIFACTORY-US-1012 | enriched | | SCN-IntegrationHost-005 | route-class | a request to a read route fronted by IntegrationHost (ConnectorRegistryService, IntegrationService) | the response is served from the fronted service with no side effect, under the tenant of the token for the three REST reads, which carry no project, and with the forwarded metadata for the gRPC reads; the NOT_FOUND, PERMISSION_DENIED and FAILED_PRECONDITION answers of the fronted service return with their reasons; the response returns unchanged with the correlation id and the gateway keeps nothing of the call | no token, an expired token, an identity token, a user token of another gateway, a token without the scope, a workload token on a REST route or a user token on a gRPC route | AIFACTORY-US-1010 | enriched | | SCN-IntegrationHost-006 | route-class | a request to a sandbox route fronted by IntegrationHost (ConnectorRegistryService) | ConnectorRegistryService accepts the certification and answers 202, its conformance suite runs against a sandbox connection so the effect stays in the sandbox system, and the service writes its event and its audit evidence to its own outbox; the response returns unchanged with the correlation id and the gateway stores neither the key nor a result | no token, an expired token, a token without the scope, a project the token does not grant, or a descriptor of another tenant | AIFACTORY-US-1011 | enriched | | SCN-IntegrationHost-007 | route-class | a request to a shared-write route fronted by IntegrationHost (ConnectorRegistryService, IntegrationService) | the fronted service applies the request once under its own rule and the same key with the same body returns the same result; the response returns unchanged with the correlation id; the gateway stores neither a key nor a result, keeps no session and writes no event, so a replica that crashes during a call loses nothing and the caller retries with the same key | no token, an expired token, a token without the scope, a project the token does not grant, or a key reused with a different body | AIFACTORY-US-1011 | enriched |

IntegrationService

Service in BC-16; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-IntegrationService-001 | endpoint | POST /factory/connections with scope factory.connections.admin | the response is 201 with the location; the Connection is in state Draft and not healthy with its rotation metadata, and the ConnectionRegistered outbox record and the audit evidence AuditEvidenceSubmitted are written in the same transaction; the reference is held in the row only; a repeated call with the same key and body returns the same connection and changes nothing | a token without the scope, the same key with a different body, a second connection with the same name in the tenant, a body with a credential value or an unknown member, or another provider than Azure DevOps | AIFACTORY-US-1004 | enriched | | SCN-IntegrationService-002 | endpoint | GET /factory/connections with scope factory.connections.read | the response is 200 with each connection of the tenant of the caller, carrying its identifier, name, provider, credential kind, state, health, last verification, next rotation due and grant count, without the credential reference and without any value; a connection of another tenant is not revealed and nothing is written | a call without a token, a token without the scope or an unavailable store | AIFACTORY-US-1005 | enriched | | SCN-IntegrationService-003 | endpoint | POST /factory/connections/{connectionId}/verify with scope factory.connections.admin | the response is 200 with the outcome; a Draft connection that verifies moves to Verified and then Active and healthy in one transaction with two ConnectionStateChanged outbox records and the audit evidence; an Active connection that fails moves to Degraded, and a Degraded one that verifies moves back to Active, each with its event; a Draft connection that fails stays Draft with the reason and no ConnectionStateChanged; every verification that reaches an outcome writes the audit evidence AuditEvidenceSubmitted with that outcome; a repeated call with the same key returns the same outcome and changes nothing | a token without the scope, a connection of another tenant or an unknown connection, or a broker that does not answer | AIFACTORY-US-1006 | enriched | | SCN-IntegrationService-004 | endpoint | PUT /factory/connections/{connectionId}/grants/{subjectKind}/{subjectId} with scope factory.connections.admin | the response is 200; the grant is written with the granting subject and the time, and the ConnectionGrantChanged outbox record with the change set or narrowed and the audit evidence are written in the same transaction; the same body repeated returns 200 and writes nothing | a token without the scope, a policy decision other than allow (the platform bundle denies a grant to a caller who is neither Workspace admin of the project nor Platform admin), an answer that is no decision, a connection of another tenant or unknown, a project unknown in the tenant, another subject kind than Project, or ProjectService or PolicyEngineService that does not answer | AIFACTORY-US-1007 | enriched | | SCN-IntegrationService-005 | endpoint | POST /factory/connections/{connectionId}/rotate with scope factory.connections.admin | the response is 200; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-IntegrationService-006 | endpoint | POST /factory/connections/{connectionId}/revoke with scope factory.connections.admin | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-IntegrationService-007 | endpoint | gRPC Connections.Resolve (internal, none streaming) | the reply names the connection, the provider, the credential kind, the endpoint policy narrowed by the grant and a broker ticket that names the credential reference, which the caller exchanges through SecretBroker.Issue for a short-lived credential; it carries no credential, the reference is logged nowhere, nothing is written and the resolve counter records the outcome granted | a project without a grant or with an expired grant, a connection that is not Active, Degraded or ambiguous, no connection or a connection of another tenant, a call without a workload identity or without the service scope, or an invalid request | AIFACTORY-US-1008 | enriched | | SCN-IntegrationService-008 | event | IntegrationService publishes ConnectionRegistered on connections.connections.v1.connection-registered | the payload carries connectionId, tenantId, provider and credentialKind and no credential reference; each consumer (StudioBff (RefreshConnectionView), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1004 | enriched | | SCN-IntegrationService-009 | event | IntegrationService publishes ConnectionStateChanged on connections.connections.v1.connection-state-changed | the payload carries connectionId, tenantId, fromState and toState, the two events of an activation in commit order; each consumer (StudioBff (RefreshConnectionView), AuditService (RecordEvidence), ConnectorRegistryService (PauseOnRevocation), KnowledgeIngestionService (PauseOrResumeSources)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1006 | enriched | | SCN-IntegrationService-010 | event | IntegrationService publishes ConnectionGrantChanged on connections.grants.v1.connection-grant-changed | the payload carries connectionId, tenantId, subjectKind, subjectId and change; each consumer (StudioBff (RefreshConnectionView), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1007 | enriched | | SCN-IntegrationService-011 | event | IntegrationService publishes CredentialRotated on connections.connections.v1.credential-rotated | the payload carries connectionId, tenantId, rotatedAt; each consumer (AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 |

KnowledgeHost

Service in BC-11; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-KnowledgeHost-001 | endpoint | GET /knowledge/health with scope factory.health.read | the response is 200; the detail names the identity platform and each fronted service with its state; a fronted service that does not answer, or that is not deployed yet as RepositoryIntelligenceService and MemoryPromotionService are until I5, is reported as unavailable in the detail and does not turn the answer into 503, because it is an optional dependency and the routes of the other services keep serving; while the identity platform is unreachable and a cached signing key still validates tokens, the gateway stays in rotation: readiness stays ready, tokens that were already issued keep passing, and from the first failed probe the response is still 200 with the health degraded and a detail that names the identity platform as unreachable (D117); nothing is written | 503: the identity platform, the one required dependency, is unreachable and no valid signing key remains, because none was cached or the cached keys expired, so the gateway cannot validate tokens | AIFACTORY-US-826 | enriched | | SCN-KnowledgeHost-002 | endpoint | GET /knowledge/meta/modules with scope factory.meta.read | the response is 200 with the six services this gateway fronts, as deployment.fronts of the model lists them, each with its version and its repository, and with the vector profile in use (ADR-0013) and the embedding profile versions of the indexes as the metadata port of the gateway reports them; on an instance whose port has no source, which is every deployed instance until the owner names the operation of VectorMemoryService that returns them, both are stated as not reported and no value is invented; no operation of a fronted service is called and nothing is written | 401: no token or an expired token; 403: the token lacks factory.meta.read; the identity platform is unreachable and no valid signing key remains to validate the token | AIFACTORY-US-826 | enriched | | SCN-KnowledgeHost-003 | route-class | a request to a external route fronted by KnowledgeHost (ArtifactService) | ArtifactService accepts the export and answers 202, its own worker produces the package in open formats, and where the command leaves audit evidence the service writes it to its own outbox in the transaction of the command; the gateway calls no connector, writes no receipt and no evidence and keeps nothing; the answer of the service returns unchanged with the correlation id | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation or grants no role in the project the path names; 404: ArtifactService answers it for a project that does not exist in the tenant of the token (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-825 | enriched | | SCN-KnowledgeHost-004 | route-class | a request to a production route fronted by KnowledgeHost (KnowledgeIngestionService, MemoryPromotionService) | the fronted service decides the production action under its own rules and writes its event and its evidence in the transaction of its command: KnowledgeIngestionService moves the source to Deleting and deletes every derived item with deletion lineage, and MemoryPromotionService records the consent of the tenant; the gateway evaluates no approval, holds no approval and no consent and writes nothing; the answer of the service returns unchanged with the correlation id | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; the fronted service answers 403 for a missing role and 404 for a source of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer or is not deployed yet | AIFACTORY-US-825 | enriched | | SCN-KnowledgeHost-005 | route-class | a request to a publication route fronted by KnowledgeHost (MemoryPromotionService) | MemoryPromotionService decides the promotion: a memory reaches Promoted only through a review decision bound to its exact content hash and, for shared scope, with the consent record of the tenant, and the answer of the service, including 409 and 412, returns unchanged with the correlation id; the gateway evaluates no approval, holds no approval reference and writes nothing | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; the fronted service answers 403 for a missing role and 404 for a memory of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer or is not deployed yet | AIFACTORY-US-825 | enriched | | SCN-KnowledgeHost-006 | route-class | a request to a read route fronted by KnowledgeHost (ArtifactService, ContextBuilderService, KnowledgeIngestionService, MemoryPromotionService) | the fronted service answers with no side effect and the response returns unchanged with the correlation id; the server stream of Artifacts.Fetch is passed through without buffering content; the gateway keeps no state of the call; connectsoft.factory.knowledge.host.requests and connectsoft.factory.knowledge.host.request_duration record the call with its service and route | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation, or a workload token is presented on a REST route, over gRPC PERMISSION_DENIED for a workload token without the service scope and for a user token; where the route names only a resource id, the fronted service answers 403 for a missing role and 404, over gRPC NOT_FOUND, for a resource of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer or is not deployed yet | AIFACTORY-US-823 | enriched | | SCN-KnowledgeHost-007 | route-class | a request to a shared-write route fronted by KnowledgeHost (KnowledgeIngestionService, MemoryPromotionService, RepositoryIntelligenceService, VectorMemoryService) | the fronted service applies the request once under its own idempotency rule and its answer, including its answer for a key reused with a different body, returns unchanged with the correlation id; the gateway stores neither the key nor the result nor any content, so after a replica crash nothing is replayed and the caller retries with the same key, or stores the same content again, and receives the result of the one application | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation, or grants no role in the project the path of SetCollection names; where the route names only a resource id, the fronted service answers 403 for a missing role and 404 for a resource of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer or is not deployed yet | AIFACTORY-US-824 | enriched |

KnowledgeIngestionService

Service in BC-10; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-KnowledgeIngestionService-001 | endpoint | POST /factory/knowledge/sources with scope factory.knowledge.admin | the response is 201; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-KnowledgeIngestionService-002 | endpoint | GET /factory/knowledge/sources with scope factory.knowledge.read | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-KnowledgeIngestionService-003 | endpoint | POST /factory/knowledge/sources/{sourceId}/sync with scope factory.knowledge.admin | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-KnowledgeIngestionService-004 | endpoint | DELETE /factory/knowledge/sources/{sourceId} with scope factory.knowledge.admin | the response is 202 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-KnowledgeIngestionService-005 | endpoint | GET /factory/knowledge/snapshots/{snapshotId} with scope factory.knowledge.read | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-KnowledgeIngestionService-006 | endpoint | PUT /factory/projects/{projectId}/knowledge/collections/{name} with scope factory.knowledge.admin | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-KnowledgeIngestionService-007 | endpoint | gRPC Ingestion.GetSourceScope (internal, none streaming) | the reply is the execution-scope-v1 of the request, with the tenant and the project of the trusted scope and a sourceScope whose repositories and documentCollections are present and empty; nothing is written or published and the same request receives the same reply, so the retrieval path returns an empty, well-formed result | the caller has no workload identity (UNAUTHENTICATED); the token lacks the service scope (PERMISSION_DENIED); the request lacks a member the schema requires or its body names another tenant or project than the forwarded scope (INVALID_ARGUMENT); or the signing keys of the identity authority cannot be loaded | AIFACTORY-US-792 | enriched | | SCN-KnowledgeIngestionService-008 | event | KnowledgeIngestionService publishes SourceRegistered on ingestion.sources.v1.source-registered | the payload carries sourceId, tenantId, projectId, kind, classification; each consumer (StudioBff (RefreshKnowledgeSourceView), AuditService (RecordEvidence), RepositoryIntelligenceService (PrepareRepository)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-KnowledgeIngestionService-009 | event | KnowledgeIngestionService publishes SourceStateChanged on ingestion.sources.v1.source-state-changed | the payload carries sourceId, tenantId, fromState, toState; each consumer (StudioBff (RefreshKnowledgeSourceView)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-KnowledgeIngestionService-010 | event | KnowledgeIngestionService publishes SourceDeleted on ingestion.sources.v1.source-deleted | the payload carries sourceId, tenantId, lineageRef; each consumer (AuditService (RecordEvidence), ContextBuilderService (RecordDeletionLineage), MemoryPromotionService (InvalidateEvidence), RepositoryIntelligenceService (RemoveIndexSets)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-KnowledgeIngestionService-011 | event | KnowledgeIngestionService publishes SourceSnapshotTaken on ingestion.snapshots.v1.source-snapshot-taken | the payload carries snapshotId, sourceId, tenantId, sourceVersion, kind; each consumer (RepositoryIntelligenceService (BuildIndexSet)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-KnowledgeIngestionService-012 | event | KnowledgeIngestionService publishes ChunksPublished on ingestion.snapshots.v1.chunks-published | the payload carries snapshotId, sourceId, tenantId, chunkCount, embeddingProfileVersion; each consumer (VectorMemoryService (IndexChunks), TemplateRegistryService (RefreshDocs)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-KnowledgeIngestionService-013 | event | KnowledgeIngestionService publishes SnapshotFailed on ingestion.snapshots.v1.snapshot-failed | the payload carries snapshotId, sourceId, tenantId, stage, reason; each consumer (StudioBff (RefreshSourceSnapshotView)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 |

LicenseService

Service in BC-28; first delivered in I8. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-LicenseService-001 | endpoint | GET /factory/marketplace/listings/{listingId}/pricing with scope factory.marketplace.read | the response is 200 | 404: the addressed resource is absent or outside the caller's scope | — | derived | | SCN-LicenseService-002 | endpoint | PUT /factory/marketplace/listings/{listingId}/pricing with scope factory.marketplace.publish | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-LicenseService-003 | endpoint | POST /factory/marketplace/listings/{listingId}/acquire with scope factory.marketplace.acquire | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-LicenseService-004 | endpoint | GET /factory/marketplace/entitlements with scope factory.marketplace.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-LicenseService-005 | endpoint | POST /factory/marketplace/publishers with scope factory.marketplace.publish | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-LicenseService-006 | endpoint | POST /factory/marketplace/publishers/{publisherId}/certify with scope factory.marketplace.admin | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-LicenseService-007 | endpoint | POST /factory/marketplace/listings/{listingId}/reviews with scope factory.marketplace.read | the response is 201 | 403: the caller's scope lacks the required right | — | derived | | SCN-LicenseService-008 | endpoint | gRPC Licensing.CheckEntitlement (internal, none streaming) | the reply carries ack-v1 and the side effect of the method's class happens once | the caller has no workload identity or the request fails validation | — | derived | | SCN-LicenseService-009 | event | LicenseService publishes PricingPlanChanged on licensing.pricing.v1.pricing-plan-changed | the payload carries pricingId, listingId, model; each consumer (StudioBff (RefreshPricingPlanView), AuditService (RecordEvidence), MarketplaceCatalogService (ApplyPricingPlan)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-LicenseService-010 | event | LicenseService publishes EntitlementGranted on licensing.entitlements.v1.entitlement-granted | the payload carries entitlementId, tenantId, listingId, subscriptionId, validTo; each consumer (FactoryCommercialService (AccumulateMeter), StudioBff (RefreshEntitlementView), AuditService (RecordEvidence), MarketplaceCatalogService (ContinueInstallation)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-LicenseService-011 | event | LicenseService publishes EntitlementStateChanged on licensing.entitlements.v1.entitlement-state-changed | the payload carries entitlementId, tenantId, listingId, fromState, toState; each consumer (AgentRegistryService (ApplyEntitlementState), StudioBff (RefreshEntitlementView), AuditService (RecordEvidence), MarketplaceCatalogService (ApplyEntitlementState)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-LicenseService-012 | event | LicenseService publishes PublisherCertified on licensing.publishers.v1.publisher-certified | the payload carries publisherId, tenantId, state; each consumer (StudioBff (RefreshPublisherView), AuditService (RecordEvidence), MarketplaceCatalogService (ApplyPublisherState)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived |

MarketplaceCatalogService

Service in BC-27; first delivered in I8. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-MarketplaceCatalogService-001 | endpoint | GET /factory/marketplace/listings with scope factory.marketplace.read | the response is 200 | the required dependency is unavailable | — | derived | | SCN-MarketplaceCatalogService-002 | endpoint | GET /factory/marketplace/listings/{listingId} with scope factory.marketplace.read | the response is 200 | 404: the addressed resource is absent or outside the caller's scope | — | derived | | SCN-MarketplaceCatalogService-003 | endpoint | POST /factory/marketplace/listings with scope factory.marketplace.publish | the response is 201; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-MarketplaceCatalogService-004 | endpoint | POST /factory/marketplace/listings/{listingId}/submit with scope factory.marketplace.publish | the response is 202 | 403: the caller's scope lacks the required right | — | derived | | SCN-MarketplaceCatalogService-005 | endpoint | POST /factory/marketplace/listings/{listingId}/install with scope factory.marketplace.install | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | derived | | SCN-MarketplaceCatalogService-006 | endpoint | GET /factory/marketplace/installations with scope factory.marketplace.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-MarketplaceCatalogService-007 | endpoint | DELETE /factory/marketplace/installations/{installationId} with scope factory.marketplace.install | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-MarketplaceCatalogService-008 | endpoint | gRPC Catalog.ResolveListing (internal, none streaming) | the reply carries release-manifest-v1 and the side effect of the method's class happens once | the caller has no workload identity or the request fails validation | — | derived | | SCN-MarketplaceCatalogService-009 | event | MarketplaceCatalogService publishes ListingPublished on marketplace.listings.v1.listing-published | the payload carries listingId, tenantId, kind, assetId, releaseId; each consumer (AgentCardService (LinkListing), StudioBff (RefreshListingView), AuditService (RecordEvidence), LicenseService (TrackListing)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-MarketplaceCatalogService-010 | event | MarketplaceCatalogService publishes ListingStateChanged on marketplace.listings.v1.listing-state-changed | the payload carries listingId, tenantId, fromState, toState, reason; each consumer (StudioBff (RefreshListingView), AuditService (RecordEvidence), LicenseService (FollowListing)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-MarketplaceCatalogService-011 | event | MarketplaceCatalogService publishes ListingInstalled on marketplace.installations.v1.listing-installed | the payload carries installationId, tenantId, projectId, listingId, releaseId; each consumer (AgentRegistryService (RegisterInstalledRelease), StudioBff (RefreshInstallationView), AuditService (RecordEvidence), LicenseService (CountSeats)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-MarketplaceCatalogService-012 | event | MarketplaceCatalogService publishes ListingRemoved on marketplace.installations.v1.listing-removed | the payload carries installationId, tenantId, listingId; each consumer (AgentRegistryService (WithdrawInstalledRelease), StudioBff (RefreshInstallationView), AuditService (RecordEvidence), LicenseService (ReleaseSeats)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived |

MarketplaceHost

Service in BC-27; first delivered in I8. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-MarketplaceHost-001 | endpoint | GET /marketplace/health with scope factory.health.read | the response is 200 | 503: the request cannot be applied | — | derived | | SCN-MarketplaceHost-002 | route-class | a request to a publication route fronted by MarketplaceHost (LicenseService, MarketplaceCatalogService) | the action is approval-gated and the gateway forwards only a request that carries the approval reference; the response returns unchanged with the correlation id | no token, an expired token or a project the token does not grant | — | derived | | SCN-MarketplaceHost-003 | route-class | a request to a read route fronted by MarketplaceHost (LicenseService, MarketplaceCatalogService) | the response is served from the fronted service with no side effect; the response returns unchanged with the correlation id | no token, an expired token or a project the token does not grant | — | derived | | SCN-MarketplaceHost-004 | route-class | a request to a shared-write route fronted by MarketplaceHost (LicenseService, MarketplaceCatalogService) | the request carries an idempotency key and the fronted service applies it once; the response returns unchanged with the correlation id | no token, an expired token or a project the token does not grant | — | derived | | SCN-MarketplaceHost-005 | route-class | a request to a spend route fronted by MarketplaceHost (LicenseService) | the request is checked against the budget before it is forwarded; the response returns unchanged with the correlation id | no token, an expired token or a project the token does not grant | — | derived |

McpServerRegistryService

Service in BC-08; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-McpServerRegistryService-001 | endpoint | GET /factory/mcp-servers with scope factory.tools.read | the response is 200 with a paged list of the servers of the trusted tenant, each with serverId, name, direction, transport, authentication, state and the counts of bound tools, unbound tools, resources and prompts; on a deployed thin instance the list is empty and well formed; a server of another tenant never appears; nothing is written and no event is published | 401: no token is presented; 403: the scope of the caller lacks factory.tools.read | AIFACTORY-US-596 | enriched | | SCN-McpServerRegistryService-002 | endpoint | POST /factory/mcp-servers with scope factory.tools.admin | the response is 201; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-McpServerRegistryService-003 | endpoint | POST /factory/mcp-servers/{serverId}/discover with scope factory.tools.admin | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-McpServerRegistryService-004 | endpoint | POST /factory/mcp-servers/{serverId}/activate with scope factory.tools.admin | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-McpServerRegistryService-005 | endpoint | GET /factory/mcp-servers/{serverId}/capabilities with scope factory.tools.read | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-McpServerRegistryService-006 | endpoint | POST /factory/mcp-servers/{serverId}/retire with scope factory.tools.admin | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-McpServerRegistryService-007 | endpoint | gRPC McpRegistry.ResolveTool (internal, none streaming) | for a bound tool the reply carries serverId, transport, endpointRef or commandRef, authentication, governancePolicyRef, protocolVersion, toolName, schemaHash and declaredClass and never a credential; the method is of class read and writes nothing; on a deployed thin instance every call is answered NOT_FOUND, and the fifteen native tools of the chain never cause one, because the executor resolves only a descriptor of kind Mcp | UNAUTHENTICATED: the caller has no workload identity, or the workload call forwards no tenant; PERMISSION_DENIED: the token lacks the service scope; INVALID_ARGUMENT: the request names no tool id, and never a missing tenant; NOT_FOUND: no bound binding of an Active server exists for the tool in the forwarded tenant, which is also the answer for a binding of another tenant (ADR-0015); UNAVAILABLE: mcp-server-registry-sql does not answer | AIFACTORY-US-597 | enriched | | SCN-McpServerRegistryService-008 | endpoint | gRPC McpRegistry.ListCapabilities (internal, none streaming) | the reply lists each capability with its binding, an unbound tool marked as not invocable; the method is of class read and writes nothing; on a deployed thin instance the reply is an empty, well-formed list for every scope, so the MCP endpoint the Factory exposes lists no tool in I1, where it serves only calls bound to a run, a step and an attempt, and IDE clients and partner agents arrive with the complete registry in I5 (D121); a capability of another tenant never appears | UNAUTHENTICATED: the caller has no workload identity, or the workload call forwards no tenant; PERMISSION_DENIED: the token lacks the service scope, or the execution-scope-v1 names a tenant other than the forwarded one (reason scope-mismatch); UNAVAILABLE: mcp-server-registry-sql does not answer | AIFACTORY-US-597 | enriched | | SCN-McpServerRegistryService-009 | event | McpServerRegistryService publishes McpServerRegistered on tool-execution.mcp-servers.v1.mcp-server-registered | the payload carries serverId, tenantId, direction, transport, authentication; each consumer (StudioBff (RefreshMcpServerView), AuditService (RecordEvidence)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-McpServerRegistryService-010 | event | McpServerRegistryService publishes McpServerStateChanged on tool-execution.mcp-servers.v1.mcp-server-state-changed | the payload carries serverId, tenantId, fromState, toState; each consumer (StudioBff (RefreshMcpServerView), AuditService (RecordEvidence), ToolAdapterService (UpdateServerHealth)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-McpServerRegistryService-011 | event | McpServerRegistryService publishes McpCapabilitiesDiscovered on tool-execution.mcp-servers.v1.mcp-capabilities-discovered | the payload carries serverId, tenantId, tools, resources, prompts; each consumer (StudioBff (RefreshMcpServerView)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 |

MemoryPromotionService

Service in BC-13; first delivered in I5. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-MemoryPromotionService-001 | endpoint | GET /factory/memory with scope factory.memory.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-MemoryPromotionService-002 | endpoint | GET /factory/memory/{memoryId} with scope factory.memory.read | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-MemoryPromotionService-003 | endpoint | POST /factory/memory/{memoryId}/promote with scope factory.memory.review | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-MemoryPromotionService-004 | endpoint | POST /factory/memory/{memoryId}/archive with scope factory.memory.review | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-MemoryPromotionService-005 | endpoint | PUT /factory/memory/consent with scope factory.memory.admin | the response is 200 | 403: the caller's scope lacks the required right | — | derived | | SCN-MemoryPromotionService-006 | endpoint | gRPC Memory.RetrieveMemory (internal, none streaming) | the reply carries context-snapshot-v1 and the side effect of the method's class happens once | the caller has no workload identity or the request fails validation | — | derived | | SCN-MemoryPromotionService-007 | endpoint | gRPC Memory.Observe (internal, none streaming) | the reply carries ack-v1 and the side effect of the method's class happens once | the caller has no workload identity or the request fails validation | — | derived | | SCN-MemoryPromotionService-008 | event | MemoryPromotionService publishes MemoryObserved on memory.items.v1.memory-observed | the payload carries memoryId, tenantId, projectId, originRunId; no modelled consumer exists yet, the event is retained for projections | the transport is unavailable or the consumer throws | — | derived | | SCN-MemoryPromotionService-009 | event | MemoryPromotionService publishes MemoryClassified on memory.items.v1.memory-classified | the payload carries memoryId, tenantId, class, confidence, trustTier; each consumer (StudioBff (RefreshMemoryItemView)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-MemoryPromotionService-010 | event | MemoryPromotionService publishes MemoryPromoted on memory.items.v1.memory-promoted | the payload carries memoryId, tenantId, scope, class, reviewApprovalId; each consumer (StudioBff (RefreshMemoryItemView), AuditService (RecordEvidence), ContextBuilderService (RefreshIndexCatalog)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-MemoryPromotionService-011 | event | MemoryPromotionService publishes MemoryArchived on memory.items.v1.memory-archived | the payload carries memoryId, tenantId, reason; each consumer (ContextBuilderService (RefreshIndexCatalog)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived | | SCN-MemoryPromotionService-012 | event | MemoryPromotionService publishes SkillCandidateProposed on memory.items.v1.skill-candidate-proposed | the payload carries memoryId, tenantId, proposalRef; each consumer (StudioBff (RefreshMemoryItemView), StudioNotificationService (NotifyMaintainers), AuditService (RecordEvidence), FeedbackService (RaiseSkillProposal)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | derived |

ModelGatewayHost

Service in BC-07; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ModelGatewayHost-001 | endpoint | GET /model-gateway/health with scope factory.health.read | the response is 200; the detail names the identity platform and each fronted service with its state; a fronted service that does not answer, ComputePoolService before its delivery among them, is reported as unavailable in the detail and does not turn the answer into 503, because it is an optional dependency and the routes of the other service keep serving; while the identity platform is unreachable and a cached signing key still validates tokens, the gateway stays in rotation: readiness stays ready, tokens that were already issued keep passing, and from the first failed probe the response is still 200 with the health degraded and a detail that names the identity platform as unreachable (D117); nothing is written | 503: the identity platform, the one required dependency, is unreachable and no valid signing key remains, because none was cached or the cached keys expired, so the gateway cannot validate tokens | AIFACTORY-US-565 | enriched | | SCN-ModelGatewayHost-002 | endpoint | GET /model-gateway/meta/adapters with scope factory.meta.read | the response is 200 with the provider adapters of the services behind this gateway, each with its package version and its supported protocols (OpenAI-compatible, Anthropic-compatible, embeddings, reranking, streaming, structured outputs, tool calls), as the source reported them; the gateway loads no adapter itself, holds no state and writes nothing | 401: no token or an expired token; 403: the token lacks factory.meta.read; 503: the metadata source does not answer or none is configured; the identity platform is unreachable and no valid signing key remains to validate the token | AIFACTORY-US-565 | enriched | | SCN-ModelGatewayHost-008 | endpoint | POST /v1/chat/completions with scope factory.models.invoke | the response is 200 with one chat completion translated from the reply or, with stream true, an event stream that relays every message in the order received and ends with the terminal marker of the protocol; the id of the completion is the invocation id of the receipt, and its usage holds the token counts of the receipt when the provider reported them and is absent, never zero, when it did not; ModelRouterService took the policy decision, the credential and the deployment and wrote the receipt, as for any other invocation; the usage of a run-bound call counts on the reservation of the run and its receipt is listed with the receipts of the run; for a call outside a run no route plan is persisted, the usage is metered on the budget of the project without a reservation and the receipt is read through ListProjectReceipts of ModelRouterService, which the gateway fronts; the gateway resolved no profile, held no credential, stored neither a key nor an output and wrote nothing | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks factory.models.invoke, it is a workload token that is not the token of an attempt, the OpenAI-Project header of a call outside a run names a project the role claims of the token do not grant, or ModelRouterService answers PERMISSION_DENIED, the denial of a policy decision among them; 400: a call outside a run carries no OpenAI-Project header, the body cannot be translated, a member the translation does not carry among them, or ModelRouterService answers INVALID_ARGUMENT; 404: the switch is false, so no route is hosted, or no profile answers to the model name; 429: the call exceeds the rate limit of the route, or ModelRouterService refuses it for a rate, or answers RESOURCE_EXHAUSTED for a call outside a run of a project whose budget is marked exceeded, while a run-bound call is never refused for that mark (D125); 503 or 504: ModelRouterService does not answer, or the provider exceeds the timeout or the deadline | AIFACTORY-US-756 | enriched | | SCN-ModelGatewayHost-003 | route-class | a request to a production route fronted by ModelGatewayHost (ComputePoolService) | ComputePoolService decides the production action under its own rules and writes its event in the transaction of its command; the gateway evaluates no approval, holds no approval state and writes nothing; the answer of the service returns unchanged with the correlation id | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; the fronted service answers 403 for a missing role and 404 for a pool of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer or, before I8, is not deployed | AIFACTORY-US-564 | enriched | | SCN-ModelGatewayHost-004 | route-class | a request to a publication route fronted by ModelGatewayHost (ModelRouterService) | ModelRouterService decides the publication action: a deployment is approved through ApproveDeployment only in state Evaluated, with a license that permits the use and capability evidence that meets the thresholds of every profile that lists it, and by attestation through AttestDeployment only in state Candidate or Evaluated with a stated reason (D121, D123), and the answer of the service, including 400, 409 and 412, returns unchanged with the correlation id; the gateway evaluates no approval and no attestation, holds no approval reference and writes nothing | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; the route names only the deploymentId, so the fronted service answers 403 for a caller who is not Platform admin and 404 for a deployment of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-564 | enriched | | SCN-ModelGatewayHost-005 | route-class | a request to a read route fronted by ModelGatewayHost (ComputePoolService, ModelRouterService) | the fronted service answers with no side effect and the response returns unchanged with the correlation id; the gateway keeps no state of the call; connectsoft.factory.model_gateway.host.requests and connectsoft.factory.model_gateway.host.request_duration record the call | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation, or it is a workload token, because no public REST operation names a service scope, or, on the route of ListProjectReceipts, the role claims of the token do not grant the project of the path (D123); every other read route names only a resource id, so the fronted service answers 403 for a missing role and 404 for a profile, a deployment or a run of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-562 | enriched | | SCN-ModelGatewayHost-006 | route-class | a request to a sandbox route fronted by ModelGatewayHost (ModelRouterService) | the fronted service performs the sandbox action, which changes no shared state (for EvaluateDeployment a request for a capability suite run answered 202, the evidence arriving later inside the service), and its answer returns unchanged with the correlation id; the gateway adds no gate of its own and writes nothing | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; the route names only the deploymentId, so the fronted service answers 403 for a caller who is not Platform admin and 404 for a deployment of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-562 | enriched | | SCN-ModelGatewayHost-007 | route-class | a request to a shared-write route fronted by ModelGatewayHost (ComputePoolService, ModelRouterService) | the fronted service applies the request once under its own idempotency rule, by key for RegisterDeployment and per run and profile for ResolveRoutePlan, and its answer, including the 409 of a key reused with another body, returns unchanged with the correlation id; the gateway stores neither the key nor a result, so a replica that crashes during the call loses nothing and the caller retries with the same key | 401, over gRPC UNAUTHENTICATED: no token, an expired token, an identity token or a user token issued for another gateway; 403, over gRPC PERMISSION_DENIED: the token lacks the scope of the operation or the workload token lacks the service scope; the fronted service answers 403 for a missing role and 404, over gRPC NOT_FOUND, for a resource of another tenant (ADR-0015 amendment D113); 503, over gRPC UNAVAILABLE: the fronted service does not answer | AIFACTORY-US-563 | enriched |

ModelRouterService

Service in BC-07; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ModelRouterService-001 | endpoint | GET /factory/model-profiles with scope factory.models.read | the response is 200 with the active profile versions of the platform tenant and of the tenant of the caller, each with capabilities, privacy class, limits and fallback chain; a retired version and a profile of another tenant never appear; nothing is written | 401: no token or an expired token; 403: the token lacks factory.models.read; 503: model-router-sql is unavailable | AIFACTORY-US-569 | enriched | | SCN-ModelRouterService-002 | endpoint | GET /factory/model-profiles/{profileId} with scope factory.models.read | the response is 200 with the profile, its allowed deployments in preference order and, for each deployment the tenant filter admits, its state, health and capability verdicts; nothing is written | 404: the profileId does not exist, has no active version or belongs to another tenant (ADR-0015 amendment D113); 403: the token lacks factory.models.read | AIFACTORY-US-569 | enriched | | SCN-ModelRouterService-003 | endpoint | GET /factory/model-deployments with scope factory.models.admin | the response is 200 with the deployments of the tenant of the token, paged, each with provider, model, region, privacy class, state, health, license metadata and evidence reference; a deployment of another tenant never appears and no credential is returned; nothing is written | 403: the token lacks factory.models.admin, or the caller holds neither the Platform admin nor the Observer role | AIFACTORY-US-570 | enriched | | SCN-ModelRouterService-004 | endpoint | POST /factory/model-deployments with scope factory.models.admin | the response is 201 with the deployment; the ModelDeployment is written in state Candidate together with its DeploymentStateChanged outbox record, which carries toState Candidate and no fromState for a registration (D121), in the same transaction; a Candidate is never routed; a repeated call with the same key and the same body returns the same deployment and writes nothing; a deployment of the provider self-hosted is registered without an adapter check; a deploymentId that only another tenant uses is registered for the tenant of the token, because the key of the table includes the tenant (D121) | 403: the token lacks factory.models.admin or the caller is not Platform admin; 409: the same key with a different body, or a deploymentId that already exists in the tenant; 400: the body lacks a required member, carries a credential value, names a provider outside the six values of the model, or names one of the five provider values with an adapter while that adapter is not loaded | AIFACTORY-US-058, AIFACTORY-US-570 | enriched | | SCN-ModelRouterService-005 | endpoint | POST /factory/model-deployments/{deploymentId}/evaluate with scope factory.models.admin | the response is 202 and no shared state of the service changes; the evidence arrives later as EvaluationCompleted of the kind capability-suite, which the CapabilityEvidenceImporter turns into capability scores and, for a Candidate, the state Evaluated; a repeated call with the same key returns the same 202 and requests no second run | 403: the token lacks factory.models.admin or the caller is not Platform admin; 404: the deploymentId does not exist or belongs to another tenant (ADR-0015 amendment D113) | AIFACTORY-US-571 | enriched | | SCN-ModelRouterService-006 | endpoint | POST /factory/model-deployments/{deploymentId}/approve with scope factory.models.admin | the response is 200; the deployment moves to Approved through PlatformAdminApproval, which records the approval basis capability-suite (D121), together with its DeploymentStateChanged outbox record, which carries approvalBasis capability-suite (D123), in the same transaction and becomes routable while it is healthy; a repeated call for a deployment that is already Approved returns 200 and changes nothing | 403: the token lacks factory.models.admin or the caller is not Platform admin; 404: the deploymentId does not exist or belongs to another tenant; 409: the deployment is Candidate, Degraded or Retired; 412: the license forbids the use, or a capability score is missing or below a threshold of a profile that lists the deployment | AIFACTORY-US-058, AIFACTORY-US-572 | enriched | | SCN-ModelRouterService-020 | endpoint | POST /factory/model-deployments/{deploymentId}/attest with scope factory.models.admin | the response is 200 with the deployment; it moves from Candidate or from Evaluated to Approved through PlatformAdminAttestation and keeps approvalBasis attestation, the stated approvalReason and the subject of the token as attestedBy, together with its DeploymentStateChanged outbox record (fromState Candidate or Evaluated, toState Approved, approvalBasis, approvalReason and attestedBy) in the same transaction; it is routable like any Approved deployment while it is healthy; AuditService records the event, which carries the basis, the reason and the attesting subject, as the evidence of the act; a repeated call for a deployment already Approved on the basis attestation answers 200 without effect and publishes nothing (D121, D123) | 403: the token lacks factory.models.admin or the caller is not Platform admin; 400: the body states no reason; 404: the deploymentId does not exist or belongs to another tenant (ADR-0015 amendment D113); 409: the deployment is Degraded, Retired or Approved on the basis capability-suite, or its license metadata forbids the use (D123) | AIFACTORY-US-757 | enriched | | SCN-ModelRouterService-007 | endpoint | POST /factory/model-profiles/{profileId}/route-plan/preview with scope factory.models.read | the response is 200 with the candidates in order, the filters applied and the reason of exclusion of every other allowed deployment; no route plan is persisted and nothing is published | 403: the token lacks factory.models.read; 404: the profileId does not exist, is retired or belongs to another tenant; 503: PolicyEngineService does not answer, so no route is shown without a decision | AIFACTORY-US-573 | enriched | | SCN-ModelRouterService-008 | endpoint | GET /factory/runs/{runId}/model-receipts with scope factory.runs.read | the response is 200 with the receipts of the run, ordered by start and paged, each with invocation, attempt, profile, the deployment that answered, request hash, outcome, usage status with tokens where known, fallback flag, policy decision id and output artifact reference; unknown usage is shown as unknown and never as zero; the receipt of a run-bound call of the OpenAI-compatible route of ModelGatewayHost is among them, and a receipt that names no run is never returned, because ListProjectReceipts reads those (D123); a run with a plan and no receipt yet returns an empty list to every caller of the tenant who holds the scope, because a route plan names no project; no prompt or completion content is returned and nothing is written | 403: the token lacks factory.runs.read, or the run has receipts and the role claims of the caller do not admit the project they name; 404: neither a route plan nor a receipt of the tenant names the runId, which is also the answer for a run of another tenant (ADR-0015 amendment D113) | AIFACTORY-US-058, AIFACTORY-US-577 | enriched | | SCN-ModelRouterService-021 | endpoint | GET /factory/projects/{projectId}/model-receipts with scope factory.models.read | the response is 200 with the receipts of the tenant and the project that name no run, ordered by start and paged, each with invocation, profile, the deployment that answered, request hash, outcome, usage status with tokens where known, fallback flag, policy decision id and output artifact reference, and without run, attempt and route plan; unknown usage is shown as unknown and never as zero; a receipt that names a run is never returned, the receipt of a run-bound call of the OpenAI-compatible route among them, which ListRunReceipts lists with its run; a project the token grants that has no such receipt returns an empty list; no prompt or completion content is returned and nothing is written | 403: the token lacks factory.models.read; 403 answered by ModelGatewayHost, which fronts the read: the role claims of the token do not grant the project of the path, so the call does not reach the service | AIFACTORY-US-901 | enriched | | SCN-ModelRouterService-009 | endpoint | gRPC ModelGateway.ResolveRoutePlan (internal, none streaming) | the router asks PolicyEngineService for the decision under the policy revision the request names, filters the allowed deployments of the profile by state, tenant, privacy class, region, decision, capability thresholds, which a deployment approved by attestation passes without scores (D121), and a loaded adapter, orders them by the routing weights, and writes the RoutePlan with its candidates and constraints together with the RoutePlanResolved outbox record in one transaction; the reply names the route plan, the profile version and the candidates; a repeated call for the same run and profile with the same input returns the stored plan and writes nothing | the caller has no workload identity (UNAUTHENTICATED), its token lacks the service scope or the decision denies the profile for the scope (PERMISSION_DENIED), the request fails validation (INVALID_ARGUMENT), the profile is unknown, retired or of another tenant (NOT_FOUND, failure class permanent for the attempt), no deployment passes the filters, or a repeated call for the same run and profile names another profile version, policy revision, classification or capability set, which is a conflict (FAILED_PRECONDITION, told apart by the error detail), or PolicyEngineService does not answer (UNAVAILABLE, fail closed) | AIFACTORY-US-058, AIFACTORY-US-573 | enriched | | SCN-ModelRouterService-010 | endpoint | gRPC ModelGateway.Invoke (internal, server streaming) | tokens are streamed to the caller and the stream ends with the receipt; the InvocationReceipt with the deployment that answered, the policy decision id, the outcome and the usage status is written together with the ModelInvoked outbox record in one transaction; usage is Reported when the provider states it and Unknown, never zero, when it does not; the output is stored by hash through ArtifactService and only its reference is kept; after the commit Usage.RecordUsage of CostUsageService is called once per token meter; the same idempotency key with the same request hash returns the existing receipt and makes no second provider call; a run-bound call under the forwarded token of an attempt is an invocation of its run: the route plan of the run and profile is used, and the project, the classification and the profile version the snapshot of the run pinned are taken from that route plan (D125), the receipt carries the run and the attempt, the usage counts on the reservation of the run and the receipt is listed by ListRunReceipts; for a call outside a run the tenant comes from the token and the project from the invocation, the active version of the profile is used, the candidates are resolved for the call, no route plan is persisted, the receipt names no run, no attempt and no route plan, the usage is recorded without a run and metered on the budget of the project without a reservation, and the receipt is listed by ListProjectReceipts (D123); a run-bound call is never refused for a budget mark of its project (D125) | no workload identity and no forwarded user token (UNAUTHENTICATED); a workload token without the service scope, a forwarded workload token that is not the token of an attempt, a user token without factory.models.invoke, or a policy decision that denies, also for a tool outside the permitted set, which writes a receipt with the outcome Denied that names the first candidate of the plan (PERMISSION_DENIED); an invalid request, a capability the profile lacks or a profile of another modality (INVALID_ARGUMENT); a profile the tenant cannot read, a model profile id of the OpenAI-compatible route that no profile the tenant can read answers to, or a runId for which the tenant of the caller holds no route plan of the profile, whether the run belongs to another tenant, does not exist or was never resolved (NOT_FOUND, failure class permanent); the same key with another request hash (FAILED_PRECONDITION); a call outside a run for a project that ProjectBudgetMarks marks as exceeded after BudgetExceeded of CostUsageService, while the mark is in force, that is until a BudgetUpdated at or below the limit or the turn of the budget period clears it (RESOURCE_EXHAUSTED, D125); the provider exceeds the timeout or the deadline (DEADLINE_EXCEEDED); PolicyEngineService or SecretBrokerService does not answer, or no candidate is healthy (UNAVAILABLE, failure class transient) | AIFACTORY-US-058, AIFACTORY-US-574 | enriched | | SCN-ModelRouterService-011 | endpoint | gRPC ModelGateway.Embed (internal, none streaming) | the reply carries the vectors, the embeddingCompatibility of the profile version and the receipt; the InvocationReceipt and the ModelInvoked outbox record are written in one transaction; inside a run the route plan of the run and profile is used, outside a run the candidates are resolved for the call under the same filters and decision, no plan is persisted and the receipt, which names no run, is listed with the receipts of its project that name no run (D123); the vectors are not stored by the service; the same idempotency key returns the existing receipt and makes no second provider call | no workload identity (UNAUTHENTICATED); no service scope or a denying policy decision (PERMISSION_DENIED); an invalid request or a profile that is not of the modality Embedding (INVALID_ARGUMENT); a profile of another tenant, or inside a run a runId for which the tenant of the caller holds no route plan of the profile, whether the run belongs to another tenant, does not exist or was never resolved (NOT_FOUND, failure class permanent); PolicyEngineService or SecretBrokerService does not answer, or no candidate is healthy (UNAVAILABLE) | AIFACTORY-US-576 | enriched | | SCN-ModelRouterService-012 | endpoint | gRPC ModelGateway.Rerank (internal, none streaming) | the reply carries the ranked scores and the receipt; the InvocationReceipt and the ModelInvoked outbox record are written in one transaction; inside a run the route plan of the run and profile is used, outside a run the candidates are resolved for the call and no plan is persisted; the scores are not stored by the service; usage the provider does not report stays Unknown and is never zero | no workload identity (UNAUTHENTICATED); no service scope or a denying policy decision (PERMISSION_DENIED); an invalid request or a profile that is not of the modality Rerank (INVALID_ARGUMENT); a profile of another tenant, or inside a run a runId for which the tenant of the caller holds no route plan of the profile, whether the run belongs to another tenant, does not exist or was never resolved (NOT_FOUND, failure class permanent); no adapter behind the rerank adapter port for the provider of the candidate, as on a deployed instance until a keyed rerank adapter of the pinned AI library serves that provider (UNIMPLEMENTED); PolicyEngineService or SecretBrokerService does not answer, or no candidate is healthy (UNAVAILABLE) | AIFACTORY-US-576 | enriched | | SCN-ModelRouterService-013 | event | ModelRouterService publishes ModelProfileActivated on model-access.profiles.v1.model-profile-activated | the payload carries profileId, version, tenantId, releaseId and privacyClass; StudioBff (RefreshModelProfileView), AuditService (RecordEvidence) and DashboardService (ProjectModelProfile) each handle it exactly once, idempotent on the event id; an activation repeated for the same profile, version and release publishes nothing twice | the transport is unavailable or a consumer throws | AIFACTORY-US-058, AIFACTORY-US-569 | enriched | | SCN-ModelRouterService-014 | event | ModelRouterService publishes ModelProfileRetired on model-access.profiles.v1.model-profile-retired | the payload carries profileId, version and tenantId; the version is no longer selectable and runs that pinned it finish on their route plans; StudioBff (RefreshModelProfileView) and AuditService (RecordEvidence) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-569 | enriched | | SCN-ModelRouterService-015 | event | ModelRouterService publishes DeploymentStateChanged on model-access.deployments.v1.deployment-state-changed | the payload carries deploymentId, tenantId, fromState, which is absent only for a registration, toState and healthy and, for an approval, approvalBasis, with approvalReason and attestedBy for an approval by attestation, so that the audit record of an approval holds them (D123); StudioBff (RefreshModelDeploymentView), AuditService (RecordEvidence) and DashboardService (ProjectModelDeployment) each handle it exactly once, idempotent on the event id; a probe that confirms the current state, and a probe that is skipped because PolicyEngineService or SecretBrokerService does not answer, publish nothing | the transport is unavailable or a consumer throws | AIFACTORY-US-058, AIFACTORY-US-572 | enriched | | SCN-ModelRouterService-016 | event | ModelRouterService publishes CapabilityEvidenceRecorded on model-access.deployments.v1.capability-evidence-recorded | the payload carries deploymentId, tenantId, suiteVersion and evidenceRef; a Candidate deployment moved to Evaluated in the same transaction and DeploymentStateChanged announces it; StudioBff (RefreshModelDeploymentView) and DashboardService (ProjectModelDeployment) each handle it exactly once, idempotent on the event id; the same deployment, suite version and evidence reference imported again publishes nothing | the transport is unavailable or a consumer throws | AIFACTORY-US-058, AIFACTORY-US-571 | enriched | | SCN-ModelRouterService-017 | event | ModelRouterService publishes RoutePlanResolved on model-access.routing.v1.route-plan-resolved | the payload carries routePlanId, runId, tenantId, profileId and candidates; DashboardService (ProjectRoutePlan) handles it exactly once, idempotent on the event id; a repeated resolution of the same run and profile publishes nothing | the transport is unavailable or the consumer throws | AIFACTORY-US-058, AIFACTORY-US-573 | enriched | | SCN-ModelRouterService-018 | event | ModelRouterService publishes ModelInvoked on model-access.invocations.v1.model-invoked | the payload carries invocationId, tenantId, projectId, runId and attemptId where the call has them, profileId, deploymentId, outcome, usageStatus and, where known, inputTokens, outputTokens and estimatedCostUsd; unknown usage is absent, never zero; CostUsageService (RecordModelUsage) records the input and the output tokens on its two meters, against the reservation of the run or, for a receipt that names no run, against the budget of the project of the receipt without a reservation (D123), and stores a receipt without a valid price or with an unknown quantity as Uncertain, and DashboardService (ProjectReceipt) and QualityScoreService (CollectModelStats) each handle it exactly once, idempotent on the event id; no prompt or completion content is in the event | the transport is unavailable or a consumer throws | AIFACTORY-US-058, AIFACTORY-US-574 | enriched | | SCN-ModelRouterService-019 | event | ModelRouterService publishes ModelFallbackUsed on model-access.invocations.v1.model-fallback-used | the payload carries invocationId, tenantId, profileId, fromDeploymentId, toDeploymentId and reason; the receipt names the deployment that answered and sets fallbackUsed; AuditService (RecordEvidence) and DashboardService (ProjectInvocationReceipt) each handle it exactly once, idempotent on the event id; a fallback never crosses to a less private class and no candidate is added at invocation time | the transport is unavailable or a consumer throws | AIFACTORY-US-575 | enriched |

ObservabilityHost

Service in BC-21; first delivered in I3. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ObservabilityHost-001 | endpoint | GET /observability/health with scope factory.health.read | the response is 200 with liveness, readiness and the aggregated health of the identity platform and of AlertRuleService, DashboardService, FeedbackService, QualityScoreService and SloService; a fronted service that does not answer is reported degraded and does not take the gateway out of rotation; with the identity platform unreachable and a cached signing key still valid the answer is 200 degraded | no valid signing key remains to validate tokens (D117) | AIFACTORY-US-1108 | enriched | | SCN-ObservabilityHost-002 | endpoint | GET /observability/meta/backends with scope factory.meta.read | the response is 200 with the configured OpenTelemetry backends for traces, metrics and logs and the GenAI semantic-convention version in use, read from configuration without a call to a fronted service | the gateway cannot validate the token, or no valid signing key remains (D117) | AIFACTORY-US-1108 | enriched | | SCN-ObservabilityHost-003 | route-class | a request to a publication route fronted by ObservabilityHost (QualityScoreService) | QualityScoreService decides the approval gate and the author rule; the gateway holds no approval reference and returns its 200, 412, 409 or 404 unchanged with the correlation id | no token, an expired token, a user token for another gateway or a token without the scope; or QualityScoreService does not answer | AIFACTORY-US-1107 | enriched | | SCN-ObservabilityHost-004 | route-class | a request to a read route fronted by ObservabilityHost (AlertRuleService, DashboardService, FeedbackService, QualityScoreService) | the response is served by the fronted service with no side effect and returns unchanged with the correlation id, including its 404 for a resource of another tenant (ADR-0015 amendment D113) and the not-found answer of a deployed service that does not host the operation, such as the thin QualityScoreService before I4; a server stream is passed through without buffering | no token, an expired token or a token without the scope, a workload token on a REST route or a user token on a gRPC route; or the fronted service does not answer or is not deployed | AIFACTORY-US-1105 | enriched | | SCN-ObservabilityHost-005 | route-class | a request to a sandbox route fronted by ObservabilityHost (QualityScoreService) | QualityScoreService starts the evaluation, whose tasks run as sandbox-class Factory runs in their isolated workspaces, and its 202, 409 or ack-v1 reply returns unchanged with the correlation id; the gateway stores nothing and is no party to idempotency | no token, an expired token or a token without the scope, or a user token on the gRPC route; or QualityScoreService does not answer | AIFACTORY-US-1107 | enriched | | SCN-ObservabilityHost-006 | route-class | a request to a shared-write route fronted by ObservabilityHost (AlertRuleService, DashboardService, FeedbackService, SloService) | the fronted service applies the change once by its key or its natural target and its answer, including 409 and 404, returns unchanged with the correlation id; the gateway stores nothing of the call and adds no key | no token, an expired token or a token without the scope; or the fronted service does not answer | AIFACTORY-US-1106 | enriched |

PipelineExecutionService

Service in BC-23; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-PipelineExecutionService-001 | endpoint | GET /factory/delivery/proposals with scope factory.delivery.read | the response is 200 with only the matching proposals of the caller's tenant and projects in scope, each with its state and pull-request reference; proposals of another tenant never appear (ADR-0015) and nothing is written | 403: the caller's scope lacks factory.delivery.read | AIFACTORY-US-1280 | enriched | | SCN-PipelineExecutionService-002 | endpoint | GET /factory/delivery/proposals/{proposalId} with scope factory.delivery.read | the response is 200 with the proposal, its commits with their trailers, its reviewers, the pipeline runs that name it and its provenance (runId, attemptId, agentReleaseId, changeSetRef); nothing is written | 403: the caller's scope lacks factory.delivery.read; 404: the proposalId is unknown or belongs to another tenant | AIFACTORY-US-1280 | enriched | | SCN-PipelineExecutionService-003 | endpoint | POST /factory/delivery/proposals with scope factory.delivery.propose | the response is 202 with the location of the proposal and the ChangeProposal is recorded Proposed with changeSetRef from the stored change set; after the answer the branch is pushed with the trailers Factory-Run, Factory-ChangeSet and Factory-Agent (BranchCreated), the pull request is opened (PullRequestOpen) and ChangeProposalOpened is written in that transaction; a repeated call with the same key and body, or a run and hash already recorded through Pipelines.RecordProposal, returns the same proposal and changes nothing | 403: the scope lacks factory.delivery.propose; 409: the same key with a different body; the changeSetHash does not match the stored change set; after the 202 the branch policy refuses the push or the system of record is unreachable; ArtifactService is unavailable | AIFACTORY-US-1276 | enriched | | SCN-PipelineExecutionService-004 | endpoint | GET /factory/delivery/pipeline-runs with scope factory.delivery.read | the response is 200 with only the matching runs of the caller's tenant and projects in scope; runs of another tenant never appear (ADR-0015) and nothing is written | 403: the caller's scope lacks factory.delivery.read | AIFACTORY-US-1284 | enriched | | SCN-PipelineExecutionService-005 | endpoint | GET /factory/delivery/pipeline-runs/{pipelineRunId} with scope factory.delivery.read | the response is 200 with the stages and every typed result with kind, passed, summary and artifact reference, a failed result named; nothing is written | 403: the caller's scope lacks factory.delivery.read; 404: the pipelineRunId is unknown or belongs to another tenant | AIFACTORY-US-1284 | enriched | | SCN-PipelineExecutionService-006 | endpoint | POST /factory/delivery/pipeline-runs/{pipelineRunId}/reconcile with scope factory.delivery.operate | the response is 202; the run is read from the system of record through the connector, takes its observed state and results once and, when it ended, PipelineRunCompleted is written in that transaction; a run already terminal changes nothing | 403: the scope lacks factory.delivery.operate; 404: the run is unknown or belongs to another tenant; the system of record is unreachable | AIFACTORY-US-1285 | enriched | | SCN-PipelineExecutionService-007 | endpoint | gRPC Pipelines.RecordProposal (internal, none streaming) | the reply carries ack-v1; one ChangeProposal exists in PullRequestOpen with its provenance, its pull-request reference, its tool receipt and its commits, and ChangeProposalOpened is written in that transaction; a repeated call for the same run and change-set hash, through this method or after OpenChangeProposal, replies the same acknowledgement and writes nothing | the caller has no workload identity, the token lacks factory.delivery.propose, the request fails the validation of change-proposal-record-v1 or names no provenance, or ArtifactService is unavailable | AIFACTORY-US-1277 | enriched | | SCN-PipelineExecutionService-008 | event | PipelineExecutionService publishes ChangeProposalOpened on pipelines.proposals.v1.change-proposal-opened | the payload carries proposalId, tenantId, projectId, runId, repository and the optional pullRequestRef; one proposal yields one event whichever entry point opened it; each consumer (WorkflowEngineService, RunControlService, AuditService, and StudioBff and DashboardService in their increments) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1278 | enriched | | SCN-PipelineExecutionService-009 | event | PipelineExecutionService publishes ChangeProposalStateChanged on pipelines.proposals.v1.change-proposal-state-changed | the payload carries proposalId, tenantId, runId, fromState and toState; each consumer (RunControlService, which marks a pending approval of a superseded version Stale, StudioBff and DashboardService in their increments) handles it exactly once, idempotent on the event id; a delivery whose transition the model does not draw publishes nothing | the transport is unavailable or the consumer throws | AIFACTORY-US-1281 | enriched | | SCN-PipelineExecutionService-010 | event | PipelineExecutionService publishes ChangeProposalMerged on pipelines.proposals.v1.change-proposal-merged | the payload carries proposalId, tenantId, projectId, runId and mergedCommit; each consumer (ReleaseService (LinkProposal), RunControlService, WorkflowEngineService, GenerationRecipeService, RepositoryIntelligenceService, AuditService, FeedbackService and StudioBff, each in its increment) handles it exactly once, idempotent on the event id; the Factory itself never merges | the transport is unavailable or the consumer throws | AIFACTORY-US-1282 | enriched | | SCN-PipelineExecutionService-011 | event | PipelineExecutionService publishes PipelineRunStarted on pipelines.runs.v1.pipeline-run-started | the payload carries pipelineRunId, tenantId, projectId, commit and the optional proposalId; each consumer (StudioBff and DashboardService in their increments) handles it exactly once, idempotent on the event id; a repeated delivery records nothing and publishes nothing | the transport is unavailable or the consumer throws | AIFACTORY-US-1283 | enriched | | SCN-PipelineExecutionService-012 | event | PipelineExecutionService publishes PipelineRunCompleted on pipelines.runs.v1.pipeline-run-completed | the payload carries pipelineRunId, tenantId, projectId, commit, state and results, the state being the one the system of record reported and each failed result carrying passed false with its kind and summary, so that consumers judge readiness from the typed results, and the optional runId and stepRunId that the pipeline run took from the proposal of its commit, absent when no run requested it (D141); each consumer (ReleaseService (AssembleFromRun), RunControlService (SettleWaitingStep, which looks up the waiting step by runId and stepRunId and ignores an event without them), WorkflowEngineService, TemplateRegistryService, QualityScoreService, AuditService, and StudioBff and DashboardService in their increments) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1283 | enriched |

PolicyEngineService

Service in BC-18; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-PolicyEngineService-001 | endpoint | GET /factory/policies with scope factory.policies.read | the response is 200 with a page of bundles, each with revision, scope, scope id, release, parent revision, domains, rulesHash, the active flag and activatedAt: the platform bundle, the tenant bundles of the tenant of the token and the project bundles of the projects in which the caller holds a role, and every project bundle of the tenant for the Platform admin; no bundle of another tenant is listed; nothing is written | 401: no token or an expired token; 403: the token lacks factory.policies.read, or it is a workload token, which no REST operation admits; 503: policy-engine-sql does not answer | AIFACTORY-US-920 | enriched | | SCN-PolicyEngineService-002 | endpoint | GET /factory/policies/{revision} with scope factory.policies.read | the response is 200 with the typed rules of the revision, each with rule id, domain, match, effect, obligations and priority, equal to the stored rule rows; a retired revision stays readable, because runs that pinned it finish on it; nothing is written | 401: no token or an expired token; 403: the token lacks the scope, it is a workload token, or the revision is a project bundle of a project in which the caller holds no role; 404: the revision does not exist or belongs to another tenant (ADR-0015 amendment D113); 503: the store does not answer | AIFACTORY-US-920 | enriched | | SCN-PolicyEngineService-003 | endpoint | POST /factory/projects/{projectId}/policy/validate with scope factory.policies.write | the response is 200 with the result: valid when every rule tightens, or not valid with every loosening rule listed with its rule id, the tenant rule it loosens and the reason, in which case connectsoft.factory.policy.tightening_rejections is incremented; nothing is stored, no bundle is activated and no event is published, so a validated override is not in force | 400: the body cannot be read as a bundle document, names an unknown domain or effect, or names a scope other than the project of the path; 401: no token or an expired token; 403: the token lacks the scope, or the caller is neither Workspace admin of the project nor Platform admin; 404: a Platform admin names a project that Projects.ResolveScope of ProjectService answers as not existing in the tenant (ADR-0015 amendment D113); 409: the tenant revision was retired without a successor, so no active tenant bundle is there to validate against (a tenant that never had one is seeded first, D127); 503: policy-engine-sql does not answer, or ProjectService does not answer for the call of a Platform admin | AIFACTORY-US-921 | enriched | | SCN-PolicyEngineService-004 | endpoint | POST /factory/policies/simulate with scope factory.policies.write | the response is 200 with the count of decisions read, the count that would change and, for each changed decision, its decision id, the recorded effect, the simulated effect and the matched rules; no decision is recorded, no cache entry is written, no event is published and neither ProjectService nor EnvironmentService is called; only the decisions of the hot window are read | 400: the candidate cannot be read or the period has no start or no end; 401: no token or an expired token; 403: the token lacks the scope, it is a workload token, or a candidate of project scope names a project the roles of the token do not grant; 503: the store does not answer | AIFACTORY-US-921 | enriched | | SCN-PolicyEngineService-005 | endpoint | GET /factory/runs/{runId}/policy-decisions with scope factory.runs.read | the response is 200 with the decisions of the run in the order of their evaluation, each with decision id, domain, action, action class, effect, policy revision, obligations, matched rules, reasons and evaluatedAt; the response holds identifiers, classes, rule ids and hashes and never prompt text, a secret or a payload; nothing is written; a decision the retention sweep moved to the immutable store is no longer listed | 401: no token or an expired token; 403: the token lacks the scope, it is a workload token, or the caller holds no role in the project of the decisions; 404: the tenant of the token holds no decision for the run id, whether the run belongs to another tenant, does not exist or has no decision yet (ADR-0015 amendment D113); 503: the store does not answer | AIFACTORY-US-922 | enriched | | SCN-PolicyEngineService-006 | endpoint | gRPC Policy.Decide (internal, none streaming) | the reply is a policy-decision-v1 document with decision id, policy revision, domain, outcome, obligations, matched rules, reason and evaluatedAt; one immutable PolicyDecision and its PolicyDecisionRecorded outbox record are written in one transaction; the five effects are returned as the outcomes of the same name, allow, allow-with-constraints, allow-with-approval, deny and prohibited; an allow-with-approval reply carries the raised class in action.sideEffectClass and in obligations.approvalClass and the approval rule in obligations.approverRule, and the stored decision keeps the same obligations; an action that no rule of the bundle and its parents matches is denied (D127); the service opens no approval request, which for a tool call ToolAdapterService opens in RunControlService; a repeat of the same request within Governance:Policy:DecisionCacheSeconds under the same revision returns the recorded decision and writes nothing, and with the cache unreachable or the entry ended the request is evaluated and recorded anew with a new decision id; the decision holds no prompt text, secret or payload | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope or is a user token; INVALID_ARGUMENT: no subject, no tenant or an unknown action kind; NOT_FOUND: the named revision is not held by the tenant; FAILED_PRECONDITION: the tenant revision was retired without a successor, so the tenant holds a bundle but none is active; UNAVAILABLE: ProjectService, EnvironmentService or policy-engine-sql does not answer | AIFACTORY-US-918 | enriched | | SCN-PolicyEngineService-007 | endpoint | gRPC Policy.GetActiveRevision (internal, none streaming) | the reply names the revision a new run of that scope must pin, the active revision of the narrowest scope that has a bundle, the project bundle and else the tenant bundle, with its scope, its rulesHash and the revisions of its stored parents up to the platform bundle, also when a wider scope has activated a newer revision since; a tenant without a tenant bundle is seeded first, once and without an event, exactly as at its first decision, and the reply names the seeded revision, which no event announces (D127); no decision is recorded | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope or is a user token; INVALID_ARGUMENT: the request names no tenant; FAILED_PRECONDITION: the tenant revision was retired without a successor; UNAVAILABLE: the store does not answer | AIFACTORY-US-919 | enriched | | SCN-PolicyEngineService-008 | endpoint | gRPC Policy.ValidateTightening (internal, none streaming) | the reply is an acknowledgement in the shape of ack-v1: accepted when every rule tightens, or a conflict that lists every loosening rule with its rule id, the parent rule it loosens and the reason, counted in connectsoft.factory.policy.tightening_rejections; nothing is stored, no bundle changes and no event is published | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope or is a user token; INVALID_ARGUMENT: the request names no tenant or the candidate cannot be read; FAILED_PRECONDITION: the parent scope of the candidate has no active bundle; UNAVAILABLE: the store does not answer | AIFACTORY-US-919 | enriched | | SCN-PolicyEngineService-009 | event | PolicyEngineService publishes PolicyRevisionActivated on policy.bundles.v1.policy-revision-activated | the payload carries revision, tenantId, scope, scopeId and rulesHash; the publisher proves the outbox record in the transaction of the activation, the envelope and the payload; an activation whose derived revision id is already stored and active publishes nothing; each consumer handles the event once, idempotent on the event id, in its own suite: RunControlService (PinActivePolicyRevision) and AuditService (RecordEvidence) in I1, StudioBff (RefreshPolicyBundleView) from I3 and ApprovalPolicyService (LoadApprovalRules) from I4 | the transport is unavailable or a consumer throws; or the rule document cannot be read or loosens its parent | AIFACTORY-US-916 | enriched | | SCN-PolicyEngineService-010 | event | PolicyEngineService publishes PolicyRevisionRetired on policy.bundles.v1.policy-revision-retired | the payload carries revision, tenantId and scope; the retired revision keeps its rules, and runs that pinned it finish on it; StudioBff (RefreshPolicyBundleView), from I3, and AuditService (RecordEvidence) handle the event once, idempotent on the event id, in their own suites | the transport is unavailable or a consumer throws | AIFACTORY-US-916 | enriched | | SCN-PolicyEngineService-011 | event | PolicyEngineService publishes PolicyDecisionRecorded on policy.decisions.v1.policy-decision-recorded | the payload carries decisionId, tenantId, the optional runId, domain, action, actionClass, effect and policyRevision and no prompt text, secret or payload; a cached repeat of a decision publishes nothing; AuditService (RecordEvidence), the one consumer of the event, handles it once, idempotent on the event id, in its own suite | the transport is unavailable or a consumer throws | AIFACTORY-US-918 | enriched |

ProjectService

Service in BC-01; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ProjectService-001 | endpoint | POST /factory/projects with scope factory.projects.write | the response is 201 with the project, and only when the project and the assignment both stand; connectsoft.factory.projects.active rises by one; a repeated call with the same Idempotency-Key and the same input returns the same project and changes nothing, and a repeat after an interrupted first attempt derives the same projectId, counts the answer of the Identity service that the assignment already exists as accepted and ends with one project and one assignment | 400: the body fails validation; 403: the scope lacks factory.projects.write, or the Identity service refuses the actor, who by its records is not Platform admin of the tenant; 409: the same Idempotency-Key arrives with a different input, or the key already exists in the tenant, both answered before the Identity service is called; 503: the Identity service is unavailable; the commit of the project fails after the Identity service accepted the assignment, because a concurrent request took the key or project-sql is unavailable | AIFACTORY-US-443 | enriched | | SCN-ProjectService-002 | endpoint | GET /factory/projects with scope factory.projects.read | the response is 200 with the projects of the trusted tenant in which the caller holds a role, each with projectId, key, name, state and region, paged; a Platform admin and an Observer assigned with the tenant scope, whose roles come from the claims of the token and never from a membership row, receive every project of the tenant; projects of other tenants never appear (row-filter isolation, ADR-0015); nothing is written | the identity platform cannot validate the token or project-sql is unavailable | AIFACTORY-US-444 | enriched | | SCN-ProjectService-003 | endpoint | GET /factory/projects/{projectId} with scope factory.projects.read | the response is 200 with the state, region and retention of the project, its memberships and delegations from the projection ProjectService keeps from the events of the Identity service, and its source scope entries; no environment data is returned, because EnvironmentService owns environments; nothing is written | 403: the scope lacks factory.projects.read, or the caller holds neither a role in the project nor a tenant-wide role by claim; 404: no project with that projectId exists in the tenant of the caller, which is also the answer for a project of another tenant (ADR-0015) | AIFACTORY-US-444 | enriched | | SCN-ProjectService-004 | endpoint | PUT /factory/projects/{projectId}/members/{subjectId} with scope factory.projects.admin | the response is 200 once the Identity service accepted every write, where its answer that a granted assignment already exists and its answer that a removed assignment is not found count as accepted; the projection and MembershipChanged follow from the events of the Identity service; a repeat that states the roles the projection already holds sends nothing, and a repeat sent before those events were handled sends the same writes again and is answered 200 | 400: the body names Platform admin or another value outside MembershipRole, answered before the Identity service is called; 403: the scope lacks factory.projects.admin, or the Identity service refuses the actor, whatever role the token states; 404: the project does not exist in the tenant of the caller, which is also the answer for a project of another tenant (ADR-0015), or the subject is not a member of the tenant; 503: the Identity service is unavailable, also after it accepted an earlier write of the same statement | AIFACTORY-US-446 | enriched | | SCN-ProjectService-005 | endpoint | POST /factory/projects/{projectId}/delegations with scope factory.projects.delegate | the response is 201 with the delegationId the Identity service assigned; the projection and DelegationChanged follow from the grant event of the Identity service; a repeated call with the same Idempotency-Key and the same input returns the same delegation and changes nothing | 400: the body has no reason, no expiry, an expiry beyond the maximum or a role outside MembershipRole, among them Platform admin, answered before the Identity service is called; 403: the scope lacks factory.projects.delegate, or the Identity service refuses the grantor, who by its records holds neither the delegated role nor a higher one; 404: the grantee is not a member of the tenant, or the project belongs to another tenant, answered like one that does not exist (ADR-0015); 409: the same Idempotency-Key arrives with a different input; 503: the Identity service is unavailable | AIFACTORY-US-447 | enriched | | SCN-ProjectService-006 | endpoint | DELETE /factory/projects/{projectId}/delegations/{delegationId} with scope factory.projects.delegate | the response is 204, also right after the 201 of Delegate; when the revocation event of the Identity service arrives the projection row gets revokedAt and DelegationChanged is published; Projects.ResolveScope no longer returns the delegated role; a revocation the Identity service answers as already revoked is answered 204 | 403: the scope lacks factory.projects.delegate, or the Identity service refuses the actor, who is neither the grantor nor Workspace admin of the project nor Platform admin; 404: the Identity service holds no such delegation in the tenant and project of the caller, which is also its answer for a delegation of another tenant (ADR-0015); 503: the Identity service is unavailable | AIFACTORY-US-447 | enriched | | SCN-ProjectService-007 | endpoint | PUT /factory/projects/{projectId}/source-scope with scope factory.projects.admin | the response is 200 with the stored scope; Projects.ResolveScope returns the new set from then on; a PUT that states the stored set changes no row and publishes nothing | 400: an entry has an unknown kind, an empty reference or duplicates the kind and reference of another entry; 403: the scope lacks factory.projects.admin, or the caller is by the role claims of the token neither Workspace admin of the project nor Platform admin; 404: the project does not exist in the tenant of the caller, which is also the answer for a project of another tenant (ADR-0015) | AIFACTORY-US-448 | enriched | | SCN-ProjectService-008 | endpoint | POST /factory/projects/{projectId}/close with scope factory.projects.admin | the response is 202; the worker journals each completed step in OffboardingJournal: it confirms the Closing announcement as published, on which RunControlService cancels the open runs and ArtifactService and KnowledgeIngestionService export or delete per tenant policy, and revokes every unexpired delegation through the Identity service with the recorded closing member named as actor; the project stays Closing until two confirmations are journaled, ProjectRunsSettled of RunControlService, that no non-terminal run of the project remains (RecordRunsSettled), and ProjectDataOffboarded of ArtifactService, that its data was exported or deleted (RecordDataOffboarded), in either order (D117); only then the worker moves the project to Closed (trigger OffboardingCompleted) with a second ProjectStateChanged, and connectsoft.factory.projects.active falls by one | 403: the scope lacks factory.projects.admin, or the caller is by the role claims of the token neither Workspace admin of the project nor Platform admin; 404: the project does not exist in the tenant of the caller, which is also the answer for a project of another tenant (ADR-0015); 409: the project is already Closing or Closed; after the 202 the worker is interrupted, the Identity service is unavailable or it refuses the recorded closing actor, or one of the two confirmations has not arrived | AIFACTORY-US-449 | enriched | | SCN-ProjectService-015 | endpoint | POST /factory/projects/{projectId}/suspend with scope factory.projects.admin | the response is 200 with the project; ProjectStateChanged is published in the run event envelope and is the audit evidence of the command, which AuditService records with the actor and the reason; on the announcement RunControlService refuses new runs of the project with 409 and cancels the open ones (GateRunsByProject); the project is not off-boarded, its delegations stay and nothing is exported or deleted; a Suspended project can be resumed or closed | 400: the body has no reason or a blank one; 403: the scope lacks factory.projects.admin, or the caller is by the role claims of the token neither Workspace admin of the project nor Platform admin; 404: the project does not exist in the tenant of the caller, which is also the answer for a project of another tenant (ADR-0015); 409: the project is not Active, which includes a repeated suspension of a Suspended project | AIFACTORY-US-550 | enriched | | SCN-ProjectService-016 | endpoint | POST /factory/projects/{projectId}/resume with scope factory.projects.admin | the response is 200 with the project; ProjectStateChanged is published in the run event envelope and is the audit evidence of the command, which AuditService records with the actor and the reason; on the announcement RunControlService accepts new runs of the project again (GateRunsByProject), and the runs that were cancelled by the suspension stay Cancelled, since a resumption restarts nothing | 400: the body has no reason or a blank one; 403: the scope lacks factory.projects.admin, or the caller is by the role claims of the token neither Workspace admin of the project nor Platform admin; 404: the project does not exist in the tenant of the caller, which is also the answer for a project of another tenant (ADR-0015); 409: the project is not Suspended, which includes a project that is Active, Closing or Closed | AIFACTORY-US-550 | enriched | | SCN-ProjectService-009 | endpoint | gRPC Projects.ResolveScope (internal, none streaming) | the reply is a valid execution-scope-v1 that returns tenantId, projectId, callerId, callerKind and the policyRevision the caller sent, with roles from the membership rows of the subject and from the delegations to the subject that are neither revoked nor past expiresAt at the moment of the call, sourceScope from the SourceScopes rows and the region of the project in policyContext; tenant-scope roles, Platform admin and a tenant-wide Observer, travel as claims and are not resolved from rows; the method answers for a project in any state; nothing is written or published and the result is not cached across requests | the caller has no workload identity (Unauthenticated), its token lacks the service scope (PermissionDenied), the request fails validation against the schema (InvalidArgument), or the project does not exist in the forwarded tenant, which is also the answer for a project of another tenant (NOT_FOUND, ADR-0015) | AIFACTORY-US-445 | enriched | | SCN-ProjectService-017 | endpoint | gRPC Projects.ListRoleHolders (internal, none streaming) | the reply names once each member who holds the role by membership or by a delegation neither revoked nor past expiresAt at the call, with the source of the role, read from the projection of memberships and delegations without a call to the Identity Service; tenant-scope roles held by claim are never listed, a role nobody holds gives an empty list, and nothing is written or published (D126, D136) | the caller has no workload identity or lacks the service scope, the request names no role or more than one, or the project is unknown or belongs to another tenant | AIFACTORY-US-1494 | enriched | | SCN-ProjectService-010 | event | ProjectService publishes ProjectCreated on projects.projects.v1.project-created | the payload carries projectId, tenantId, key and region; CostUsageService opens the default budget of the project (OpenProjectBudget), WorkflowEngineService correlates the signal (CorrelateSignal), StudioBff refreshes its view (RefreshProjectView) and AuditService records the evidence (RecordEvidence); each consumer handles it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-443 | enriched | | SCN-ProjectService-011 | event | ProjectService publishes ProjectStateChanged on projects.projects.v1.project-state-changed | the payload carries projectId, tenantId, fromState and toState, changedBy when a member caused the transition and the reason stated with a suspension or a resumption (D117); RunControlService refuses new runs with 409 and cancels the open ones when the project is Suspended, Closing or Closed, and for a Closing project confirms with ProjectRunsSettled once no non-terminal run remains (GateRunsByProject), IntegrationService revokes the project grants on Closing (RevokeProjectGrants), ArtifactService exports or deletes on Closing and confirms it with ProjectDataOffboarded (ExportOrDeleteOnClosing) and KnowledgeIngestionService exports or deletes on Closing (OffboardProjectSources), StudioBff refreshes its view (RefreshProjectView) and AuditService records the evidence (RecordEvidence); each consumer handles it exactly once, idempotent on the event id; the announcement of Closing also triggers the ProjectOffboardingWorker | the transport is unavailable or a consumer throws | AIFACTORY-US-449 | enriched | | SCN-ProjectService-012 | event | ProjectService publishes MembershipChanged on projects.memberships.v1.membership-changed | the payload carries projectId, tenantId, subjectId, role and change; ApprovalPolicyService re-evaluates eligibility (InvalidateEligibilityCache), StudioBff refreshes its view (RefreshProjectView) and AuditService records the access change (RecordEvidence); each consumer handles it exactly once, idempotent on the event id; a redelivered event of the Identity service changes no row and publishes nothing, and an event for a tenant scope, which holds Platform admin and a tenant-wide Observer, changes no row and publishes nothing | the transport is unavailable or a consumer throws; or the event of the Identity service reaches the inbox before project-sql holds the project, as the first Workspace admin assignment of CreateProject can | AIFACTORY-US-458 | enriched | | SCN-ProjectService-013 | event | ProjectService publishes DelegationChanged on projects.delegations.v1.delegation-changed | the payload carries delegationId, projectId, tenantId, granteeId, role and change; ApprovalPolicyService re-evaluates eligibility (InvalidateEligibilityCache), StudioBff refreshes its view (RefreshProjectView) and AuditService records the delegation (RecordEvidence); each consumer handles it exactly once, idempotent on the event id; one expiry is announced once, whether the expiry event of the Identity service or the reconciler comes first (idempotent on delegationId plus expiresAt); connectsoft.factory.projects.delegations_active follows the unexpired, unrevoked rows | the transport is unavailable or a consumer throws | AIFACTORY-US-447 | enriched | | SCN-ProjectService-014 | event | ProjectService publishes SourceScopeChanged on projects.scope.v1.source-scope-changed | the payload carries projectId, tenantId and the resulting entries, each entry rendered as its kind and its reference joined by a colon and without its connection id; RunControlService uses the changed scope for runs accepted from now on while the snapshot a running run pinned is unchanged (RefreshSourceScope), and KnowledgeIngestionService registers or disables sources (ReconcileProjectSources); each consumer handles it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-448 | enriched |

QualityScoreService

Service in BC-22; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-QualityScoreService-001 | endpoint | GET /factory/evaluation/suites with scope factory.evaluation.read | the response is 200 with the active suites of that target in the caller tenant, each with its thresholds per profile, pinned dataset version, baseline rule and budgets; no suite of another tenant is listed and nothing is written | the caller's scope lacks factory.evaluation.read | AIFACTORY-US-1090 | enriched | | SCN-QualityScoreService-002 | endpoint | POST /factory/evaluation/runs with scope factory.evaluation.run | the response is 202; the EvaluationRun is Queued with the suite, its version, the target, the baseline and the dataset snapshot reference resolved through FeedbackService, and the EvaluationStarted outbox record is written in the same transaction; a repeated call with the same key and body returns the same evaluation and changes nothing | the same key with a different body, a suite that is not active, a target release that does not resolve for the tenant, a caller without the scope, or AgentRegistryService or FeedbackService unreachable | AIFACTORY-US-1091 | enriched | | SCN-QualityScoreService-003 | endpoint | GET /factory/evaluation/runs/{evaluationId} with scope factory.evaluation.read | the response is 200 with the state, the per-metric results for target and baseline, the verdict, the cost, the duration and the evidence reference; nothing is written | the evaluation belongs to another tenant or does not exist, or the caller's scope lacks factory.evaluation.read | AIFACTORY-US-1092 | enriched | | SCN-QualityScoreService-004 | endpoint | POST /factory/evaluation/runs/{evaluationId}/waive with scope factory.evaluation.waive | the response is 200; the verdict becomes Waived with the approval id, the evidence names the reason, the approver and the approval, and EvaluationCompleted with the verdict Waived is written in the same transaction; the other path then changes nothing, and a call on the evaluation already Waived by that approval answers 200 with the recorded state | the bound approval is still pending or none exists yet, the evaluation is not Completed or its verdict is Passed, it belongs to another tenant or does not exist, or the scope is missing | AIFACTORY-US-1095 | enriched | | SCN-QualityScoreService-005 | endpoint | GET /factory/asset-releases/{releaseId}/evaluations with scope factory.evaluation.read | the response is 200 with the evaluations of the release and their verdicts, the evidence that Asset Publication reads; nothing is written | the release has no evaluation in the caller's tenant or belongs to another tenant, or the scope is missing | AIFACTORY-US-1094 | enriched | | SCN-QualityScoreService-006 | endpoint | gRPC Evaluation.GetVerdict (internal, none streaming) | the reply carries release-manifest-v1 with the latest verdict and the evidence reference for that release and suite; the method is a read, nothing is written and the same request answers the same | the release has no evaluation in the forwarded tenant or belongs to another tenant, the caller has no workload identity, the workload token lacks the service scope naming QualityScoreService, or the request fails validation | AIFACTORY-US-1094 | enriched | | SCN-QualityScoreService-007 | endpoint | gRPC Evaluation.RunSuite (internal, none streaming) | the reply carries ack-v1, one EvaluationRun is Queued for that release with its kind kept on the run and EvaluationStarted is written in the same transaction; a retried request with the same release, suite and kind while that evaluation is Queued, Running or Scoring queues no second evaluation | the caller has no workload identity, the workload token lacks the service scope naming QualityScoreService, or the request fails validation | AIFACTORY-US-1091 | enriched | | SCN-QualityScoreService-008 | event | QualityScoreService publishes EvaluationSuiteActivated on evaluation.suites.v1.evaluation-suite-activated | the payload carries suiteId, version, tenantId and target; StudioBff (RefreshEvaluationSuiteView) and AuditService (RecordEvidence) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-1090 | enriched | | SCN-QualityScoreService-009 | event | QualityScoreService publishes EvaluationStarted on evaluation.runs.v1.evaluation-started | the payload carries evaluationId, tenantId, suiteId, targetReleaseId and baselineReleaseId; StudioBff (RefreshEvaluationRunView) handles it exactly once, idempotent on the event id; SuiteRunner submits the tasks once each through SubmitRun with a service token that holds factory.runs.submit and names the evaluation project, each run recording QualityScoreService as its submitting service, and the run moves from Queued to Running | the transport is unavailable or a consumer throws | AIFACTORY-US-1091 | enriched | | SCN-QualityScoreService-010 | event | QualityScoreService publishes EvaluationCompleted on evaluation.runs.v1.evaluation-completed | the payload carries evaluationId, tenantId, suiteId, targetReleaseId, verdict, evidenceRef and kind; AgentRegistryService (RecordEvaluationEvidence), ModelRouterService (ImportCapabilityEvidence), FeedbackService (RaiseFromEvaluation), StudioBff (RefreshEvaluationRunView) and AuditService (RecordEvidence) each handle it exactly once, idempotent on the event id | the transport is unavailable or a consumer throws, or ArtifactService cannot store the evidence | AIFACTORY-US-1092 | enriched | | SCN-QualityScoreService-011 | event | QualityScoreService publishes EvaluationFailed on evaluation.runs.v1.evaluation-failed | the payload carries evaluationId, tenantId and reason; StudioBff (RefreshEvaluationRunView) handles it exactly once, idempotent on the event id; no further task of the evaluation is submitted and a late task result writes nothing | the transport is unavailable or a consumer throws | AIFACTORY-US-1093 | enriched | | SCN-QualityScoreService-012 | event | QualityScoreService publishes DriftDetected on evaluation.runs.v1.drift-detected | the payload carries tenantId, targetReleaseId, metric, evaluated and observed; StudioBff (RefreshEvaluationRunView), AlertRuleService (FireFromDrift) and FeedbackService (RaiseFromDrift) each handle it exactly once, idempotent on the event id; a second trigger for the same release and window publishes nothing | the transport is unavailable or a consumer throws, or both attempts of the worker fail | AIFACTORY-US-1096 | enriched |

ReleaseService

Service in BC-24; first delivered in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ReleaseService-001 | endpoint | GET /factory/delivery/releases with scope factory.delivery.read | the response is 200 with only the matching releases of the caller's tenant and projects in scope, each with its components and provenance; releases of another tenant never appear (ADR-0015) and nothing is written | 403: the caller's scope lacks factory.delivery.read | AIFACTORY-US-1288 | enriched | | SCN-ReleaseService-002 | endpoint | GET /factory/delivery/releases/{releaseId} with scope factory.delivery.read | the response is 200 with the components and their digests, targets and publication evidence, the SBOM, the attestations, the pipeline run, the proposals and the generating asset releases; nothing is written | 403: the caller's scope lacks factory.delivery.read; 404: the releaseId is unknown or belongs to another tenant | AIFACTORY-US-1288 | enriched | | SCN-ReleaseService-003 | endpoint | POST /factory/delivery/releases with scope factory.delivery.release | the response is 201; the ProductRelease moves from Assembling to Candidate (ComponentsResolved) with commit, pipeline run, proposals, generating assets, SBOM and attestation references and one component per result with digest, target and publication Pending, and ReleaseCreated is written in that transaction; a repeated call with the same key and body returns the same release and changes nothing | 403: the scope lacks factory.delivery.release; 409: the same key with a different body or a version that already exists for the product; 422: the run did not succeed, a component has no digest, provenance is missing, or attestations are missing while Delivery:Releases:RequireAttestations is true; ArtifactService is unavailable | AIFACTORY-US-1289 | enriched | | SCN-ReleaseService-004 | endpoint | POST /factory/delivery/releases/{releaseId}/withdraw with scope factory.delivery.release | the response is 200; the release moves to Withdrawn (Withdraw) and ReleaseWithdrawn is written in that transaction; every later promotion is blocked and nothing already deployed is revoked; a repeated withdrawal of a Withdrawn release answers 200 and writes nothing | 403: the scope lacks factory.delivery.release; 404: the release is unknown or belongs to another tenant; 409: the release is Superseded | AIFACTORY-US-1292 | enriched | | SCN-ReleaseService-005 | endpoint | gRPC Releases.GetRelease (internal, none streaming) | the reply carries the release with its state, version, commit, components with digests and publication evidence and the SBOM and attestation references, typed release-manifest-v1; a Withdrawn or Candidate release is answered in that state; the method is of class read and writes nothing | the caller has no workload identity, the token lacks factory.delivery.read, the request names no release id, or the release is unknown or belongs to another tenant | AIFACTORY-US-1293 | enriched | | SCN-ReleaseService-006 | event | ReleaseService publishes ReleaseCreated on releases.products.v1.release-created | the payload carries releaseId, tenantId, projectId, productId, version and commit; the PublicationVerifier of the service starts from it, and each consumer (AuditService, and StudioBff and DashboardService in their increments) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1289 | enriched | | SCN-ReleaseService-007 | event | ReleaseService publishes ReleaseReady on releases.products.v1.release-ready | the payload carries releaseId, tenantId, projectId, productId, version and components; each consumer (EnvironmentPromotionService (EnablePromotion), WorkflowEngineService, AuditService, and FleetRolloutService, StudioBff and StudioNotificationService in their increments) handles it exactly once, idempotent on the event id; the ReleaseNotesWriter of the service drafts the notes from it | the transport is unavailable or the consumer throws; or a component never appears in its registry or feed, or the read of ConnectorRegistryService does not answer, and the six attempts of the verifier are exhausted | AIFACTORY-US-1291 | enriched | | SCN-ReleaseService-008 | event | ReleaseService publishes ReleaseWithdrawn on releases.products.v1.release-withdrawn | the payload carries releaseId, tenantId, productId, version and reason; each consumer (EnvironmentPromotionService (BlockPromotion), AuditService, and StudioBff in its increment) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1292 | enriched |

RepositoryIntelligenceService

Service in BC-39; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-RepositoryIntelligenceService-001 | endpoint | GET /factory/repositories/{sourceId}/indexes with scope factory.knowledge.read | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-RepositoryIntelligenceService-002 | endpoint | POST /factory/repositories/{sourceId}/indexes/rebuild with scope factory.knowledge.admin | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-RepositoryIntelligenceService-003 | endpoint | gRPC RepositoryIntelligence.ListFiles (internal, none streaming) | the reply is the typed reply message of the method: the entries of that one workspace that match, each with path, kind (file, directory or link) and length, a link whose target lies outside the root being listed as a link and never followed, paged with a continuation token, citing the workspaceRef and leaving revision empty, because the thin delivery reads the workspace of the run and no repository index; the method is of class read, so nothing is written and no event is published, and a repeated call over the unchanged workspace returns the same entries, while a call made after a file was added or changed returns the new state, because nothing is kept between calls | INVALID_ARGUMENT: no workspaceRef, arguments that do not match the shape of the tool, a sandbox.workspaceId of the invocation that differs from the workspaceRef, no tenant, project or run in the invocation, or a path that leaves the workspace; NOT_FOUND: the workspaceRef, the tenant, the project or the run is not the one of the lease that mounted the workspace, the answer of ADR-0015 amendment D113 for a workspace of another tenant and, by the rule of the workspace view, the same answer for a workspace of another run or project of the same tenant and for an unknown one; DEADLINE_EXCEEDED: the call does not finish within the deadline the executor passes; UNAVAILABLE: the mounted workspace cannot be read; the statuses UNAUTHENTICATED and PERMISSION_DENIED belong to the deployed service of I5, which validates a workload token, and the component in the sandbox never answers them | AIFACTORY-US-817 | enriched | | SCN-RepositoryIntelligenceService-004 | endpoint | gRPC RepositoryIntelligence.SearchText (internal, none streaming) | the reply is the typed reply message of the method: one match per occurrence in the text files of that one workspace, found through the generic-text analyzer, each as a path with its line range, paged, with no file content beyond the matched ranges, citing the workspaceRef and leaving revision empty; nothing is written and no event is published, and a repeated call over the unchanged workspace returns the same matches, while a call made after a file was added or changed returns the new matches, because nothing is kept between calls | INVALID_ARGUMENT: no workspaceRef, arguments that do not match the shape of the tool, a sandbox.workspaceId of the invocation that differs from the workspaceRef, no text to search for, no tenant, project or run in the invocation, or a path filter that leaves the workspace; NOT_FOUND: the workspaceRef, the tenant, the project or the run is not the one of the lease that mounted the workspace, the answer of ADR-0015 amendment D113 for a workspace of another tenant and, by the rule of the workspace view, the same answer for a workspace of another run or project of the same tenant and for an unknown one; DEADLINE_EXCEEDED: the call does not finish within the deadline the executor passes; UNAVAILABLE: the mounted workspace cannot be read; the statuses UNAUTHENTICATED and PERMISSION_DENIED belong to the deployed service of I5, which validates a workload token, and the component in the sandbox never answers them | AIFACTORY-US-817 | enriched | | SCN-RepositoryIntelligenceService-005 | endpoint | gRPC RepositoryIntelligence.SearchSymbols (internal, none streaming) | the reply is the typed reply message of the method: the matching symbols of that one workspace, computed on demand by the enabled analyzers and not read from an index, each with name, kind, path, start line, end line and container, paged, citing the workspaceRef and leaving revision empty; the analysis reads source files and project files as data only, executes no target, task or script of the workspace, restores no package and holds no cache, so a call made after a write returns the new state; when a project does not load, a file does not bind or a reference leaves the root of the workspace, the reply is marked partial and names what was not analysed, and a language no enabled analyzer covers yields an empty result that names it; no row is written to Symbols and no event is published | INVALID_ARGUMENT: no workspaceRef, arguments that do not match the shape of the tool, a sandbox.workspaceId of the invocation that differs from the workspaceRef, no symbol to look for, or no tenant, project or run in the invocation; NOT_FOUND: the workspaceRef, the tenant, the project or the run is not the one of the lease that mounted the workspace, the answer of ADR-0015 amendment D113 for a workspace of another tenant and, by the rule of the workspace view, the same answer for a workspace of another run or project of the same tenant and for an unknown one; DEADLINE_EXCEEDED: the analysis does not finish within the deadline of the call; UNAVAILABLE: the mounted workspace cannot be read; the statuses UNAUTHENTICATED and PERMISSION_DENIED belong to the deployed service of I5, which validates a workload token, and the component in the sandbox never answers them | AIFACTORY-US-818 | enriched | | SCN-RepositoryIntelligenceService-006 | endpoint | gRPC RepositoryIntelligence.FindReferences (internal, none streaming) | the reply is the typed reply message of the method: the references and the callers of the symbol within that one workspace, computed on demand by the enabled analyzers, each as a path with its line range, paged, citing the workspaceRef and leaving revision empty; a reply over a workspace of which a project did not load is marked partial and names it; nothing is written and no event is published, and a repeated call over the unchanged workspace returns the same locations, while a call made after a symbol was added returns the new state and no entry of an earlier analysis | INVALID_ARGUMENT: no workspaceRef, arguments that do not match the shape of the tool, a sandbox.workspaceId of the invocation that differs from the workspaceRef, no symbol, or no tenant, project or run in the invocation; NOT_FOUND: the workspaceRef, the tenant, the project or the run is not the one of the lease that mounted the workspace, the answer of ADR-0015 amendment D113 for a workspace of another tenant and, by the rule of the workspace view, the same answer for a workspace of another run or project of the same tenant and for an unknown one; DEADLINE_EXCEEDED: the analysis does not finish within the deadline of the call; UNAVAILABLE: the mounted workspace cannot be read; the statuses UNAUTHENTICATED and PERMISSION_DENIED belong to the deployed service of I5, which validates a workload token, and the component in the sandbox never answers them | AIFACTORY-US-818 | enriched | | SCN-RepositoryIntelligenceService-007 | endpoint | gRPC RepositoryIntelligence.ReadRange (internal, none streaming) | the reply is the typed reply message of the method: the lines of that file of that one workspace, at most Knowledge:Repositories:MaxRangeLines lines per answer; a request wider than the cap returns the first lines of the range up to the cap and names the range it returned, so the caller asks for the next range and no call returns a whole repository; the reply cites the workspaceRef and leaves revision empty; nothing is written and no event is published | INVALID_ARGUMENT: no workspaceRef, arguments that do not match the shape of the tool, a sandbox.workspaceId of the invocation that differs from the workspaceRef, a range whose start lies after its end or before line one, a path that leaves the workspace, or no tenant, project or run in the invocation; NOT_FOUND: the workspaceRef, the tenant, the project or the run is not the one of the lease that mounted the workspace, the answer of ADR-0015 amendment D113 for a workspace of another tenant and, by the rule of the workspace view, the same answer for a workspace of another run or project of the same tenant and for an unknown one, or the path does not exist in the workspace; DEADLINE_EXCEEDED: the call does not finish within the deadline the executor passes; UNAVAILABLE: the mounted workspace cannot be read; the statuses UNAUTHENTICATED and PERMISSION_DENIED belong to the deployed service of I5, which validates a workload token, and the component in the sandbox never answers them | AIFACTORY-US-817 | enriched | | SCN-RepositoryIntelligenceService-008 | endpoint | gRPC RepositoryIntelligence.GetDependencies (internal, none streaming) | the reply is the typed reply message of the method: the edges of that path or symbol within that one workspace, computed on demand by the enabled analyzers, each with its kind (project, package, call or test coverage), from, to and, for a package, its version, paged, citing the workspaceRef and leaving revision empty; the version of a package edge is the version a file of the workspace declares, because the analysis restores no package and executes no target of the workspace; a reply over a workspace of which a project did not load, or whose project reference leaves the root, is marked partial and names it; no row is written to DependencyEdges and no event is published | INVALID_ARGUMENT: no workspaceRef, arguments that do not match the shape of the tool, a sandbox.workspaceId of the invocation that differs from the workspaceRef, neither a path nor a symbol, a path that leaves the workspace, or no tenant, project or run in the invocation; NOT_FOUND: the workspaceRef, the tenant, the project or the run is not the one of the lease that mounted the workspace, the answer of ADR-0015 amendment D113 for a workspace of another tenant and, by the rule of the workspace view, the same answer for a workspace of another run or project of the same tenant and for an unknown one; DEADLINE_EXCEEDED: the analysis does not finish within the deadline of the call; UNAVAILABLE: the mounted workspace cannot be read; the statuses UNAUTHENTICATED and PERMISSION_DENIED belong to the deployed service of I5, which validates a workload token, and the component in the sandbox never answers them | AIFACTORY-US-818 | enriched | | SCN-RepositoryIntelligenceService-009 | endpoint | gRPC RepositoryIntelligence.GetHistory (internal, none streaming) | the reply is the typed reply message of the method: the status of the paths of that one workspace that were added, modified, deleted or renamed against the base the workspace view reads from the version control metadata of the mounted workspace, and the hunks of the named or of all changed paths as line ranges with their lines, paged with at most Knowledge:Repositories:MaxRangeLines lines per answer, a reuse of that option as the page cap of a diff that is a reading of the thin delivery; the ownership part (history, churn and owners of a path) is present, empty and well-formed, because the thin delivery builds no index set; a workspace without a base yields an empty status and diff and the reply says so; the reply cites the workspaceRef and leaves revision empty; the workspace and its version control state are never changed, nothing is written and no event is published | INVALID_ARGUMENT: no workspaceRef, arguments that do not match the shape of the tool, a sandbox.workspaceId of the invocation that differs from the workspaceRef, a request that names two revisions in place of a workspace, which the thin delivery does not hold, a path that leaves the workspace, or no tenant, project or run in the invocation; NOT_FOUND: the workspaceRef, the tenant, the project or the run is not the one of the lease that mounted the workspace, the answer of ADR-0015 amendment D113 for a workspace of another tenant and, by the rule of the workspace view, the same answer for a workspace of another run or project of the same tenant and for an unknown one; DEADLINE_EXCEEDED: the call does not finish within the deadline the executor passes; UNAVAILABLE: the mounted workspace cannot be read; the statuses UNAUTHENTICATED and PERMISSION_DENIED belong to the deployed service of I5, which validates a workload token, and the component in the sandbox never answers them | AIFACTORY-US-819 | enriched | | SCN-RepositoryIntelligenceService-010 | event | RepositoryIntelligenceService publishes RepositoryIndexed on repo-intelligence.indexes.v1.repository-indexed | the payload carries indexSetId, tenantId, sourceId, revision, fileCount; each consumer (StudioBff (RefreshRepositoryIndexSetView), ContextBuilderService (RefreshIndexCatalog), VectorMemoryService (IndexChunks)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-RepositoryIntelligenceService-011 | event | RepositoryIntelligenceService publishes RepositoryIndexFailed on repo-intelligence.indexes.v1.repository-index-failed | the payload carries indexSetId, tenantId, sourceId, revision, reason; each consumer (StudioBff (RefreshRepositoryIndexSetView)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 |

RetentionResidencyService

Service in BC-42; first delivered in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-RetentionResidencyService-001 | endpoint | GET /factory/data/retention with scope factory.data.read | the response is 200 with the effective retention of every store class and classification for the tenant of the token: the tenant rule for runs of internal and the platform default elsewhere, each with its expiry action and legal-hold exemption; no rule of another tenant appears; nothing is written | 403: the caller's scope lacks factory.data.read | AIFACTORY-US-1452 | enriched | | SCN-RetentionResidencyService-002 | endpoint | PUT /factory/data/retention/{storeClass}/{classification} with scope factory.data.admin | the first call answers 200, the rule of the tenant holds 180 days and RetentionRuleChanged is written in the same transaction; the repeat answers 200 and writes nothing, as the natural idempotency of the operation requires | a value above the platform default of the class, an audit value below 2555 days or with an action other than redact, an unknown class or classification, a caller without the scope, or a Workspace admin setting a platform default | AIFACTORY-US-1452 | enriched | | SCN-RetentionResidencyService-003 | endpoint | GET /factory/data/residency with scope factory.data.read | the response is 200 with the region, the allowed regions, the allowed engines per store class and the model data residency of the tenant of the token; a tenant without a rule is answered with the default region of the installation; nothing is written | 403: the caller's scope lacks factory.data.read | AIFACTORY-US-1453 | enriched | | SCN-RetentionResidencyService-004 | endpoint | PUT /factory/data/residency with scope factory.data.admin | the first call answers 200, the rule exists and ResidencyRuleChanged is written in the same transaction; the repeat answers 200 and writes nothing; the engine change in the same region answers 200 and writes one more event | a region the installation does not offer, an allowed list without the region, an engine that is not a profile of its class, a change of region of a tenant that already has one, or a caller without the scope | AIFACTORY-US-1453 | enriched | | SCN-RetentionResidencyService-005 | endpoint | POST /factory/data/orders with scope factory.data.admin | each order answers 202 with its id, is Issued with dueAt at the issue plus DataEvent:Retention:DeletionWindowDays, writes DeletionOrderIssued in the same transaction and is recorded as evidence with AuditService; the tenant deletion records its approvalId; the repeat returns the first 202 and changes nothing; an Export of a held scope is accepted, since an export deletes nothing | a tenant deletion without a granted approval, a deletion or purge of a scope under an active legal hold, the same key with a different body, a scope of another tenant, a caller without the scope or without the Workspace admin or Platform admin role, or RunControlService (for a tenant deletion) or AuditService does not answer | AIFACTORY-US-1455 | enriched | | SCN-RetentionResidencyService-006 | endpoint | GET /factory/data/orders/{orderId} with scope factory.data.read | the response is 200 with the kind, scope, state AwaitingAcknowledgements, due moment, and each task with its owning service, state, receipt reference and acknowledgement moment; for an export the bundle reference is included; nothing is written | the caller lacks factory.data.read, the order belongs to another tenant, or no order has that id | AIFACTORY-US-1456 | enriched | | SCN-RetentionResidencyService-007 | endpoint | POST /factory/data/orders/{orderId}/acknowledge with scope factory.data.acknowledge | the first call answers 200 and the task of the owner taken from the workload identity is acknowledged with the receipt and moment; when it was the last open task the order is Completed and DeletionOrderCompleted is written in the same transaction; the repeat answers 200 and changes nothing | the caller lacks factory.data.acknowledge, the order belongs to another tenant, or the order has no task for the calling owner | AIFACTORY-US-1456 | enriched | | SCN-RetentionResidencyService-008 | endpoint | gRPC Retention.EvaluateResidency (internal, none streaming) | the reply residency-evaluation-v1 allows the first candidate; for the second it is not allowed and carries the region, the allowed regions and the reason of the refusing rule, and connectsoft.factory.data_event.residency_violations is incremented by tenant and kind; the method is of class read and writes nothing else | the caller has no workload identity or the request fails validation | AIFACTORY-US-1454 | enriched | | SCN-RetentionResidencyService-009 | event | RetentionResidencyService publishes RetentionRuleChanged on data-foundations.retention.v1.retention-rule-changed | the payload carries ruleId, tenantId, storeClass, classification and retentionDays; every consumer the model lists handles it once, idempotent on the event id, among them ArtifactService (ApplyRetentionRule), whose rule for the class artifacts then replaces its default retention of one year for that tenant, and StudioBff and AuditService; an unchanged repeat of the rule publishes nothing | the transport is unavailable or a consumer throws | AIFACTORY-US-1452 | enriched | | SCN-RetentionResidencyService-010 | event | RetentionResidencyService publishes ResidencyRuleChanged on data-foundations.residency.v1.residency-rule-changed | the payload carries tenantId, region and modelDataResidency; StoreProfileService (ApplyResidencyRule), ModelRouterService (ApplyResidencyRule), StudioBff (RefreshResidencyRuleView) and AuditService (RecordEvidence) each handle it once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-1453 | enriched | | SCN-RetentionResidencyService-011 | event | RetentionResidencyService publishes DeletionOrderIssued on data-foundations.orders.v1.deletion-order-issued | the payload carries orderId, tenantId, kind, scope and dueAt; OrderDispatcher opens one task per owning service once per order and owner, Exporter acts on an Export order, and each owning service the model lists handles it once through ExecuteDeletionOrder, or AuditService through RedactOnDeletionOrder, idempotent on the event id, then acknowledges its task | the transport is unavailable or a consumer throws | AIFACTORY-US-1455 | enriched | | SCN-RetentionResidencyService-012 | event | RetentionResidencyService publishes DeletionOrderCompleted on data-foundations.orders.v1.deletion-order-completed | the payload carries orderId, tenantId and completedAt; FactoryCommercialService (CloseSubscriptionOnDeletion), StudioBff (RefreshGovernanceOrderView), FleetIncidentService (DeletionDone) and AuditService (RecordEvidence) each handle it once, idempotent on the event id; connectsoft.factory.data_event.order_completion_days records the time by kind | the transport is unavailable or a consumer throws | AIFACTORY-US-1456 | enriched | | SCN-RetentionResidencyService-013 | event | RetentionResidencyService publishes ExportCompleted on data-foundations.orders.v1.export-completed | the payload carries orderId, tenantId, exportRef and format; StudioBff (RefreshGovernanceOrderView), StudioNotificationService (NotifyRequester), FleetIncidentService (ExportReady) and AuditService (RecordEvidence) each handle it once, idempotent on the event id; the export deleted nothing | the transport is unavailable, a consumer throws, or ArtifactService does not answer before the archive is stored | AIFACTORY-US-1457 | enriched | | SCN-RetentionResidencyService-014 | event | RetentionResidencyService publishes LegalHoldChanged on data-foundations.orders.v1.legal-hold-changed | the payload carries orderId, tenantId, scope and active; every consumer the model lists handles it once, idempotent on the event id, among them ArtifactService (ApplyLegalHold), which then spares the held artifacts in its sweep and in every deletion, and the ApplyLegalHold handlers the feature retention-residency-service builds in the repositories of the earlier owners (D137), which suspend deletion and retention expiry of the held scope; later deletion orders of the held scope are refused with 409 and the retention sweep excludes it | the transport is unavailable or a consumer throws | AIFACTORY-US-1455 | enriched |

RunControlService

Service in BC-03; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-RunControlService-001 | endpoint | POST /factory/runs with scope factory.runs.write | the response is 202 with run-accepted-v1 and the run location; connectsoft.factory.runs.accepted is incremented; a repeated call with the same Idempotency-Key and the same inputHash returns the same run and changes nothing | 400: the body fails validation or carries a parent field, parentRunId or parentAttemptId, which only RunControl.SubmitChildRun takes (D121); 403: the caller lacks factory.runs.write or is not a member of the project in scope; 409: the same Idempotency-Key arrives with a different inputHash, the project is suspended, closing or closed (GateRunsByProject), the alias points at a deprecated release (BlockNewPins), the release the submission would pin is Revoked, since a revoked release is never pinned (ApplyRevocationPolicy, D119), which stays the answer while the alias of the submission points at a Revoked release and until an administrator moves the alias (D121), the environment that environmentId names is retired (GateRunsByEnvironment), or that environment is of production class while the pinned release is not Published (the production gate, D117); each of these five gates is answered with a problem body that names the gate and reads the last announced state, and for an environment the announced class kept beside it, from the table GateStates without a call to another service, the production gate comparing that class with the state of the release that the resolution at this submission returned; a submission without environmentId is never gated by an environment; or ArtifactService is unreachable, so that the snapshot cannot be stored and the submission fails fast, no run being accepted without a stored snapshot (D121) | AIFACTORY-US-005 | enriched | | SCN-RunControlService-002 | endpoint | GET /factory/runs/{runId} with scope factory.runs.read | the response is 200 with run-view-v1 carrying the run state and version, the pinned releaseId, policyRevision and snapshotId, the steps in ordinal order with the attempts of each, the current lease of the open attempt and the pending approval requests; nothing is written | 403: the caller's scope lacks factory.runs.read; 404: no run with that runId exists in the caller's tenant and project; a run of another tenant is not found under the tenant row filter of the service and is answered 404, the same answer as for a runId that does not exist (ADR-0015) | AIFACTORY-US-161 | enriched | | SCN-RunControlService-003 | endpoint | GET /factory/runs with scope factory.runs.read | the response is 200 with run-list-v1 holding only the runs of the caller's trusted tenant and the projects in scope, each with its state and freshness, paged; runs of other tenants never appear (row-filter isolation, ADR-0015); nothing is written | the identity platform cannot validate the token or the control store is unavailable | AIFACTORY-US-161 | enriched | | SCN-RunControlService-024 | endpoint | POST /factory/runs/{runId}/decisions/{decisionId}/answer with scope factory.runs.operate | Run Control passes the answer once to the waiting attempt through Runtime.AnswerDecision of AgentRuntimeService under its workload identity and answers 200 once the runtime acknowledged; the run keeps its state and Run Control writes no row and publishes no event; the same answer repeated is answered 200 without a second effect (D137) | a run of another tenant or outside the trusted scope, a decision the open attempt did not ask for, another answer of an answered decision or a decision of kind Approval, or AgentRuntimeService does not answer | AIFACTORY-US-1491 | enriched | | SCN-RunControlService-004 | endpoint | POST /factory/runs/{runId}/cancel with scope factory.runs.write | the response is 202; RunStateChanged is written in the same transaction as the transition; the final Cancelled state is observed once every attempt has settled, never assumed; completed external effects stay visible and are never rolled back silently; a repeated cancel of a run already Cancelling returns 202 and records no second intent | 403: the caller's scope lacks factory.runs.write; 404: the run does not exist in the caller's tenant and project, which is also the answer for a run of another tenant (ADR-0015); 409: the run is already Completed, Failed or Cancelled | AIFACTORY-US-162 | enriched | | SCN-RunControlService-005 | endpoint | POST /factory/approvals/{approvalId}/decision with scope factory.approvals.decide | the response is 200; ApprovalDecided and RunStateChanged are written in the same transaction: an approval moves the request to Approved and the run from WaitingForApproval to Running, a rejection moves the request to Rejected and the run to Failed with failure class policy-denied, and a request-changes decision moves the request to ChangesRequested (trigger RequestChanges) and returns the run to Running (trigger ChangesRequested) with the reviewer's reason carried in ApprovalDecided as feedback for the lease holder; for a run-level spend approval, the request of action class spend opened on SpendApprovalRequired, an approval returns the run from WaitingForApproval to Accepted (trigger SpendApprovalGranted), where its first attempt is dispatched once BudgetReserved arrives, a rejection fails it with failure class policy-denied (trigger ApprovalRejectedOrExpired), and ApprovalDecided carries the proposal kind spend and the estimatedUsd the decision authorizes (D117); a spend approval decided while its run is Held leaves the run Held when it is approved, the run proceeding once the environment is active again, and fails it from Held when it is rejected (D119); for an operator decision the choice retry moves the request to Approved, returns the run to Running (trigger OperatorChoseRetryOrCompensate) and has a new attempt of the step dispatched, one more beyond maxAttempts when the declared maximum was reached, retry being open again on a later operator decision of the step (D121), the choice compensate moves it to Approved, returns the run to Running the same way and settles the step Failed with StepSettled, the choice fail moves it to Rejected, settles the step Failed and fails the run (trigger OperatorChoseFailOrDecisionExpired) with the failure class of the attempt that caused the request, which is uncertain for an Uncertain outcome (D121), and ApprovalDecided carries the proposal kind operator-decision, the choice and the stepRunId (D119) and, for a decision on an uncertain tool effect, the finding (D121); connectsoft.factory.approvals.pending_age records the age of the request at decision | 400: the decision on an operator decision on an uncertain tool effect, the request that keeps an uncertainToolInvocationId, carries no finding, whatever its choice (D123); 403: the scope lacks factory.approvals.decide, the roles do not satisfy the approverRule, or the caller requested the run and the request is of kind approval, a proposal or a spend, while the requester is not refused on the operator decision of that run (D121); 404: no request with that approvalId exists in the caller's tenant, which is also the answer for a request of another tenant (ADR-0015); 409: the quoted version does not match because a second decision was submitted concurrently, or the request is already decided, Stale or Cancelled with its cancelled or failed run; 410: the request passed expiresAt and is Expired; a request-changes decision on a spend approval is refused, because ChangesRequested does not apply to it (D117), and so are a choice of retry, compensate or fail on a request of kind approval and an approve, reject or request-changes decision on an operator decision, each with 409 (D119), and so is the choice retry on an operator decision that an Uncertain outcome of a tool call caused when the decision carries the finding applied, because a retry is accepted only with the finding not-applied (D121); 503: ToolAdapterService does not answer the call of ConfirmToolEffect that records the finding of a decision which would otherwise be accepted (D123) | AIFACTORY-US-166, AIFACTORY-US-546, AIFACTORY-US-657, AIFACTORY-US-726, AIFACTORY-US-1492 | enriched | | SCN-RunControlService-006 | endpoint | GET /factory/approvals with scope factory.approvals.read | the response is 200 with approval-list-v1 holding the pending and decided requests of the caller's tenant that are visible to the caller's roles, each with actionClass, proposalHash, expiresAt, state and version; requests of other tenants never appear; nothing is written | the identity platform cannot validate the token or the control store is unavailable | AIFACTORY-US-166 | enriched | | SCN-RunControlService-007 | endpoint | gRPC RunControl.AcquireLease (internal, none streaming) | the reply carries lease-v1 with the leaseId, an expiresAt set from RunControl:Leases:DurationSeconds and the fencingToken of the lease, together with the task handoff by reference, that is taskContractRef and taskContractHash of the task contract of the attempt (agent-task-contract-v1) and snapshotRef and snapshotHash of the resolved execution snapshot of the run (resolved-execution-snapshot-v1), never their content, which the runtime reads from ArtifactService by reference and verifies against the hash (D119); the first call on the Unclaimed lease records the worker's identity as holder, moves the lease to Claimed and replaces the claim-timeout expiresAt with the lease duration; a later call by the same holder renews the lease by extending expiresAt; exactly one current lease exists per attempt and the grant is written once; a retried attempt of the step gets the same taskContractRef and taskContractHash, because the task contract describes the step and no attempt, and the attempt receives its ids and the reference of the snapshot in this answer (D123) | the caller has no workload identity, the request fails validation, the attempt is unknown, belongs to another tenant or is already settled, the lease is Claimed by another holder, or the claim names a superseded lease, one that is no longer the current lease of the attempt, as after the earlier lease expired unclaimed and the attempt was dispatched again (D119) | AIFACTORY-US-163 | enriched | | SCN-RunControlService-022 | endpoint | gRPC RunControl.SubmitChildRun (internal, none streaming) | the reply carries run-accepted-v1; the child gets no reservation of its own, CostUsageService reserving nothing on a RunAccepted that carries parentRunId, its usage is recorded with the child run id and counts on the reservation of the parent run, and RunControlService waits for no BudgetReserved and opens no spend approval for it, so that its first attempt is dispatched once its first step is ready, that is when StepReady announces it (D121, D123); in everything else the child is a run like any other; the same idempotency key with the same input returns the same child run and writes nothing; the outcome of the child reaches its caller through RunCompleted, RunFailed and RunCancelled, which carry its runId, RunCompleted with the optional outputRef through which the parent reads the result (D121), and no further event announces it; when the parent run ends Failed or Cancelled, a cancellation intent with a reason that names the parent run and with the actor system is recorded for each of its open child runs and each follows the cancellation path of CancelRun, while a parent that ends Completed cancels nothing | the caller has no workload identity (Unauthenticated); the request fails validation, as without parentRunId (InvalidArgument); the parent run does not exist in the tenant of the caller, which is also the case of a parent of another tenant (NOT_FOUND, ADR-0015); the parent is already Completed, Failed, Cancelled or Cancelling, for which the answer is the status FAILED_PRECONDITION and no child run exists (D121), or parentAttemptId is not an attempt of the parent (FailedPrecondition); ArtifactService is unreachable, so that the snapshot cannot be stored and the call fails fast, no run being accepted without a stored snapshot (D121); the same idempotency key arrives with another input (conflict) | AIFACTORY-US-656 | enriched | | SCN-RunControlService-008 | endpoint | gRPC RunControl.ReportAttemptOutcome (internal, none streaming) | the reply carries ack-v1 accepted; the attempt is settled with outcome, outcomeHash, failureClass and settledAt, the lease moves to Released, and AttemptOutcomeRecorded with any RunStateChanged is written in the same transaction; an outcome that settles the step also writes StepSettled there, and a terminal failure under the failure policy Escalate or an Uncertain outcome on a step of class shared-write or above opens an operator decision with ApprovalRequested and leaves the step unsettled (D119), and the ApprovalRequest of that operator decision keeps the tool invocation that an Uncertain outcome marks in uncertainToolInvocationId, which makes it the operator decision on an uncertain tool effect, while a request opened for any other cause keeps none (D123); a terminal failure under another failure policy settles the step Failed with StepSettled and does not fail the run, which fails when WorkflowEngineService reports WorkflowRunFailed (D121); connectsoft.factory.attempts.duration records the dispatch-to-settle duration | the caller has no workload identity (Unauthenticated); the request fails validation (InvalidArgument); the fencing token is stale because a newer lease exists (FailedPrecondition, audited); the attempt is already settled (reply ack-v1 with the conflict outcome, audited) | AIFACTORY-US-164, AIFACTORY-US-657, AIFACTORY-US-726 | enriched | | SCN-RunControlService-009 | endpoint | gRPC RunControl.RequestApproval (internal, none streaming) | the reply carries approval-ref-v1 with the approvalId and expiresAt; the Pending ApprovalRequest, the run transition from Running to WaitingForApproval and the ApprovalRequested and RunStateChanged outbox records are committed in one transaction; a request accepted from WaitingForApproval opens the new Pending request for the current proposalHash and writes ApprovalRequested while the run stays WaitingForApproval; the approval-expiry reminder of the RunGrain is scheduled; a repeated request from the same attempt for the same proposalHash returns the existing reference | the caller has no workload identity, the request fails validation, the fencing token is stale, PolicyEngineService is unavailable (fail-fast), or a request of the step is still Pending for another proposalHash | AIFACTORY-US-165, AIFACTORY-US-1492 | enriched | | SCN-RunControlService-010 | endpoint | gRPC RunControl.WatchRun (internal, server streaming) | the server stream delivers one run-event-v1 per run and approval state change of that run, in commit order, and ends when the run reaches Completed, Failed or Cancelled or the caller cancels; nothing is written | the caller has no workload identity, the request fails validation, or the run does not exist in the named scope, which is also the case of a run of another tenant | AIFACTORY-US-161 | enriched | | SCN-RunControlService-011 | event | RunControlService publishes RunAccepted on run-control.runs.v1.run-accepted | the payload carries runId, tenantId, projectId, workflowId, releaseId, policyRevision, modelProfileId and requestedBy and, for a child run only, the optional parentRunId (D121); WorkflowEngineService starts the workflow run (StartWorkflowRun), CostUsageService reserves the run budget (ReserveForRun), or for a child run, which the parentRunId marks, reserves nothing and notes it under the reservation of its parent run (D121), StudioBff (RefreshRunView) and DashboardService (ProjectRun) refresh their views; each consumer handles it exactly once, idempotent on the event id; connectsoft.factory.outbox.lag records the time from commit to publication | the transport is unavailable or a consumer throws | AIFACTORY-US-005 | enriched | | SCN-RunControlService-012 | event | RunControlService publishes RunStateChanged on run-control.runs.v1.run-state-changed | the payload carries runId, tenantId, fromState, toState and cause; StudioBff (RefreshRunView) and DashboardService (ProjectRun) each handle it exactly once, idempotent on the event id; a terminal transition is additionally announced by RunCompleted, RunFailed or RunCancelled | the transport is unavailable or a consumer throws | AIFACTORY-US-161, AIFACTORY-US-168 | enriched | | SCN-RunControlService-013 | event | RunControlService publishes RunCompleted on run-control.runs.v1.run-completed | the payload carries runId, tenantId, outcomeHash and the optional outputRef, the reference of the outcome of the run in ArtifactService beside its hash, through which the parent of a child run reads the result (D121); CostUsageService settles the reservation (SettleReservation), ArtifactService seals the run artifacts (SealRunArtifacts), MemoryPromotionService collects observations (CollectObservations) and StudioBff refreshes the view (RefreshRunView); each consumer handles it exactly once, idempotent on the event id; the Completed run refuses every later transition | the transport is unavailable or a consumer throws | AIFACTORY-US-167 | enriched | | SCN-RunControlService-014 | event | RunControlService publishes RunFailed on run-control.runs.v1.run-failed | the payload carries runId, tenantId, failureClass (transient, permanent, policy-denied, validation, cancellation or uncertain) and reason; CostUsageService settles the reservation (SettleReservation), GenerationRecipeService reverts to the approved recipe (RevertToApproved), StudioBff (RefreshRunView) and DashboardService (ProjectRun) refresh their views; each consumer handles it exactly once, idempotent on the event id; the Failed run refuses every later transition | the transport is unavailable or a consumer throws | AIFACTORY-US-167, AIFACTORY-US-168 | enriched | | SCN-RunControlService-015 | event | RunControlService publishes RunCancelled on run-control.runs.v1.run-cancelled | the payload carries runId, tenantId, reason and requestedBy from the intent, the reason being budget-exceeded for a run stopped on BudgetExceeded (D117) and release-revoked for a run stopped by the in-flight policy drain or revoke of a revoked release (D123); AgentRuntimeService observes the cancellation (ObserveCancellation), WorkflowEngineService cancels the workflow run (CancelWorkflowRun), CostUsageService settles or releases the reservation (SettleOrRelease), GenerationRecipeService returns the recipe of the run from Executing to Approved (RevertToApproved, D123), StudioBff refreshes the view (RefreshRunView) and AuditService records the cancellation with the recorded intent and the settled attempts as evidence (RecordEvidence); each consumer handles it exactly once, idempotent on the event id; completed external effects stay visible and are never rolled back silently | the transport is unavailable or a consumer throws | AIFACTORY-US-162, AIFACTORY-US-547 | enriched | | SCN-RunControlService-021 | event | RunControlService publishes ProjectRunsSettled on run-control.runs.v1.project-runs-settled | the payload carries projectId and tenantId; ProjectService writes to its off-boarding journal that no non-terminal run of the closing project remains (RecordRunsSettled), one of the two confirmations its transition to Closed waits for, and handles the event exactly once, idempotent on the event id; the event is published once for the closing of a project, a redelivered announcement publishes no second one, and none is published for a project that is Suspended or Active | the transport is unavailable or the consumer throws; or a run of the closing project is still Accepted, Held, Running, WaitingForApproval or Cancelling | AIFACTORY-US-548 | enriched | | SCN-RunControlService-023 | event | RunControlService publishes StepSettled on run-control.steps.v1.step-settled | the payload carries runId, tenantId, the stepRunId of the engine that the step keeps from StepReady, the stepId of RunControlService (D121), finalState, attemptCount, when the final state is Failed, the failureClass of the last attempt and, for a step whose settling attempt reported an output, the outputRef of that attempt (D121); WorkflowEngineService records the final state of the step run and applies the failure policy of a step settled Failed, Fail or Compensate, and reports WorkflowRunFailed, on which alone RunControlService fails the run (ApplyStepSettled, D121), exactly once, idempotent on the event id, and treats no step as settled before this event; a step that is still open writes nothing, which holds for a Failed attempt that is retried, for a lease that expired unclaimed and is dispatched again and for a step with a Pending operator decision, and the choice retry keeps the step open with a new attempt | the transport is unavailable or the consumer throws; or the cause of the settlement is reported or delivered a second time | AIFACTORY-US-658 | enriched | | SCN-RunControlService-016 | event | RunControlService publishes AttemptDispatched on run-control.attempts.v1.attempt-dispatched | the payload carries runId, stepId, attemptId, leaseId, fencingToken, agentId and skillId; AgentRuntimeService claims and starts the attempt (ClaimAndStart) and DashboardService projects it (ProjectAttempt); each consumer handles it exactly once, idempotent on the event id; no second non-terminal attempt exists for the step and no step of a WaitingForApproval, Cancelling or Held run is dispatched, and from I2 no step of a project that HoldDispatchOnQuota holds after QuotaExceeded of an attempt lease (D140) | the transport is unavailable or a consumer throws | AIFACTORY-US-163 | enriched | | SCN-RunControlService-017 | event | RunControlService publishes AttemptOutcomeRecorded on run-control.attempts.v1.attempt-outcome-recorded | the payload carries runId, stepId, attemptId, outcome, failureClass and outcomeHash; WorkflowEngineService updates the projection of its step run and advances nothing on this event (AdvanceOnOutcome, D121), CostUsageService records the attempt usage (RecordAttemptUsage), QualityScoreService collects it (CollectOutcome) and DashboardService projects it (ProjectAttempt); each consumer handles it exactly once, idempotent on the event id; the event also triggers the RunDispatcher to dispatch the next Pending step, or the retry of a Failed attempt below maxAttempts when its failureClass is transient and the sideEffectClass of the Step is read or sandbox, or shared-write with idempotent true because the step of the pinned workflow definition declares an idempotency key; any other Failed attempt fails the step terminally, which settles the step Failed and does not fail the run (D121), unless the failure policy of the step is Escalate, which opens an operator decision instead; the engine learns that a step is settled from StepSettled and not from this event (D119) and advances the run on StepSettled alone (D121) | the transport is unavailable or a consumer throws | AIFACTORY-US-164, AIFACTORY-US-167 | enriched | | SCN-RunControlService-018 | event | RunControlService publishes LeaseExpired on run-control.leases.v1.lease-expired | the payload carries attemptId, leaseId and the optional holder, the worker identity for a Claimed lease and empty for an Unclaimed one; AgentRuntimeService abandons the attempt (AbandonAttempt), SecretBrokerService revokes the issuances of the lease (RevokeLeaseIssuances) and DashboardService projects it (ProjectLease); each consumer handles it exactly once, idempotent on the event id; connectsoft.factory.leases.expired is incremented; a TimedOut attempt below maxAttempts is re-dispatched with a new fencing token, an Uncertain attempt of a side-effecting step is never retried automatically and opens an operator decision for the Operator of the project, on which the run waits (D119), and an outcome later reported under the expired token is rejected and audited; an Unclaimed lease that passed its expiresAt, its creation plus RunControl:Leases:ClaimTimeoutSeconds, without a claim is moved to Expired by the same reconciler and its attempt is dispatched again under a new fencing token without counting against maxAttempts | the transport is unavailable or a consumer throws | AIFACTORY-US-164 | enriched | | SCN-RunControlService-019 | event | RunControlService publishes ApprovalRequested on run-control.approvals.v1.approval-requested | the payload carries approvalId, runId, stepId, which is absent for a run-level spend approval, tenantId, actionClass, proposalHash, approverRule, expiresAt and the optional kind, which is operator-decision for an operator decision and absent for an approval (D119); StudioBff refreshes the approval request view (RefreshApprovalRequestView), StudioNotificationService notifies the project (NotifyProject) and AuditService records the evidence (RecordEvidence); each consumer handles it exactly once, idempotent on the event id; the request appears in the Studio approvals inbox within the approval-surfacing objective of the service | the transport is unavailable or a consumer throws | AIFACTORY-US-165, AIFACTORY-US-546, AIFACTORY-US-657, AIFACTORY-US-1492 | enriched | | SCN-RunControlService-020 | event | RunControlService publishes ApprovalDecided on run-control.approvals.v1.approval-decided | the payload carries approvalId, runId, tenantId, state, decidedBy, reason, projectId, proposalKind, proposalHash, proposalDescriptor, proposalReference and, for a spend approval, the estimatedUsd the decision authorizes and, for an operator decision, the choice and the stepRunId (D119) and, when an Uncertain outcome of a tool call caused it, the finding, applied or not-applied (D121), no event being written for a decision on an uncertain tool effect that DecideApproval answered 400, for a missing finding, or 503, because ToolAdapterService did not answer the call of ConfirmToolEffect (D123); AgentRuntimeService resumes the attempt after an approval (ResumeAfterApproval), WorkflowEngineService advances on the decision (AdvanceOnDecision) and correlates the approval (CorrelateApproval), AgentRegistryService publishes on approval (PublishOnApproval), and CostUsageService reserves the approved estimate of a spend approval, also while its run is Held (D119), and publishes BudgetReserved, releases nothing for a Rejected or Expired one and ignores the decisions of other proposal kinds (ReserveOnSpendApproval); each consumer handles it exactly once, idempotent on the event id; an Approved spend approval returns the run from WaitingForApproval to Accepted, and a Rejected or Expired one fails it with failure class policy-denied and is never requested again (D117); a spend approval decided while its run is Held leaves the run Held when Approved and fails it from Held when Rejected or Expired (D119); for an operator decision the choice retry returns the run to Running with a new attempt of the step, one more beyond maxAttempts when the declared maximum was reached (D121), the choice compensate returns it to Running with the step settled Failed, which WorkflowEngineService compensates on this event, and the choice fail or an Expired request settles the step Failed and fails the run, the choice fail with the failure class of the attempt that caused the request and the Expired request with the failure class policy-denied (D121), an expired operator decision never being requested again (D119); a ChangesRequested decision returns the run to Running with the reviewer's reason as feedback for the lease holder; a Rejected request fails the run with failure class policy-denied; after Expired the onExpiry (fail or re-request) and reRequestsLeft the request carries, copied from the ApprovalRule when the request was made, settle whether the run fails with failure class policy-denied (fail, or re-request with reRequestsLeft at 0) or a new request is opened with reRequestsLeft counted down by one, and a request made while no approval rule was supplied carries fail, so the run fails; after Stale the run stays WaitingForApproval until a new approval is requested; an expired, stale, duplicate or wrong-tenant decision never advances the run | the transport is unavailable or a consumer throws | AIFACTORY-US-165, AIFACTORY-US-166, AIFACTORY-US-546, AIFACTORY-US-657, AIFACTORY-US-726, AIFACTORY-US-1492 | enriched |

RuntimeCloudHost

Service in BC-25; first delivered in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-RuntimeCloudHost-001 | endpoint | GET /runtime-cloud/health with scope factory.health.read | liveness answers 200 without a token; the detail answers 200 with the state of each fronted service and of the identity platform; a fronted service that does not answer is reported unavailable in the detail while the answer stays 200, its routes answer 503 with a retry hint and the routes of the other services keep serving; nothing is written, because the gateway holds no state | the identity platform is unreachable, a call for the detail carries no token or lacks factory.health.read | AIFACTORY-US-1086 | enriched | | SCN-RuntimeCloudHost-002 | endpoint | GET /runtime-cloud/meta/targets with scope factory.meta.read | the response is 200 with each configured target by identifier and kind, an empty list when the deployment supplied none, and the runner version stated as not reported, inventing no value; the reply never holds a credential or a connection secret and nothing is written; an entry without an identifier or a kind fails startup with the entry named | no token, a token without factory.meta.read, or the identity platform unreachable with no valid signing key left | AIFACTORY-US-1086 | enriched | | SCN-RuntimeCloudHost-003 | route-class | a request to a production route fronted by RuntimeCloudHost (ExecutionCapacityService, IaCProvisioningService, RuntimeEnvironmentService) | the gate stays in the fronted service, which asks the policy decision of PolicyEngineService or carries the approval of a promotion, requests and awaits the approval through RunControlService and writes its own audit evidence; the gateway evaluates no policy, holds no approval and refuses nothing for a missing approval; the answer of the fronted service, a 202, 200 or 201, a 409, a 422, the 403 of a missing role or the 404 of a resource of another tenant, returns unchanged with the correlation id | no token, an expired token, a user token issued for another gateway, or a token without the scope of the operation | AIFACTORY-US-1085 | enriched | | SCN-RuntimeCloudHost-004 | route-class | a request to a read route fronted by RuntimeCloudHost (ExecutionCapacityService, IaCProvisioningService, RuntimeEnvironmentService) | the fronted service serves the response with no side effect and applies its own tenant filter and role policies; its answer, the 403 of a missing role and the 404 of a resource of another tenant included, returns unchanged with the correlation id; on a gRPC read route the tenant-id and project metadata are forwarded unchanged; the gateway keeps nothing of the call | no token, an expired token, an identity token, a user token issued for another gateway, a token without the scope, a workload token on a REST route or a user token on a gRPC route, or the fronted service does not answer | AIFACTORY-US-1083 | enriched | | SCN-RuntimeCloudHost-005 | route-class | a request to a shared-write route fronted by RuntimeCloudHost (ExecutionCapacityService, IaCProvisioningService) | SetQuota and CancelProvisioning are naturally idempotent and the lease methods follow the idempotency rule of ExecutionCapacityService, so a repeated call is applied once by the fronted service; the gateway stores no key, no lease and no result, replays nothing after a replica crash, and returns the answer, a 409 or 422 of the service among them, unchanged with the correlation id | no token, an expired token or a token without the scope, a user token on a lease route, or the fronted service does not answer | AIFACTORY-US-1084 | enriched |

RuntimeEnvironmentService

Service in BC-25; first delivered in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-RuntimeEnvironmentService-001 | endpoint | GET /factory/environments/{environmentId}/inventory with scope factory.runtime.read | the response is 200 with every observed workload with kind, version, replicas, endpoints, health and configuration and secret bindings as references, the current release, the applied specification version, the observation time and the staleness; no secret value is in the reply and nothing is written | the caller lacks the scope or a role in the project, or the environment belongs to another tenant or is unknown | AIFACTORY-US-1078 | enriched | | SCN-RuntimeEnvironmentService-002 | endpoint | GET /factory/environments/{environmentId}/drift with scope factory.runtime.read | the response is 200 with both open and resolved findings, each with kind, resource, declared and observed values as references, detection and resolution time and its proposal; no secret value is in the reply and nothing is written | the caller lacks the scope or a role in the project, or the environment belongs to another tenant or is unknown | AIFACTORY-US-1078 | enriched | | SCN-RuntimeEnvironmentService-003 | endpoint | POST /factory/environments/{environmentId}/observe with scope factory.runtime.operate | both answers are 202 and one observation runs, reading the cluster and cloud APIs and never writing to infrastructure; a changed observed state is recorded with its ObservedStateChanged outbox row in the same transaction | the caller lacks the scope or holds only a role below Operator or not comparable with it, the environment belongs to another tenant or is unknown, or the cluster does not answer | AIFACTORY-US-1077 | enriched | | SCN-RuntimeEnvironmentService-004 | endpoint | GET /factory/reconciliation/proposals with scope factory.runtime.read | the response is 200 with the matching proposals of the projects the caller holds a role in, each with direction, destructive flag, state and plan summary; no proposal of another project or tenant appears and nothing is written | 403: the caller's scope lacks factory.runtime.read | AIFACTORY-US-1080 | enriched | | SCN-RuntimeEnvironmentService-005 | endpoint | POST /factory/reconciliation/proposals/{proposalId}/decide with scope factory.runtime.operate | the response is 200; the proposal is Accepted or Rejected with decidedBy, an accepted proposal receives a new provisioningRunId stored on it, and the ReconciliationDecided outbox row is written in the same transaction; the service writes nothing to infrastructure, an accepted proposal leads to a provisioning run that IaCProvisioningService creates under that id; the decision already recorded, repeated, returns 200 and changes nothing, also once an accepted proposal is Applied | a rejection without a reason, an unknown decision value or a malformed body, a different decision on a proposal that is no longer Proposed, a missing scope or a role below Operator or not comparable with it, or a proposal of another tenant or an unknown one | AIFACTORY-US-1081 | enriched | | SCN-RuntimeEnvironmentService-006 | endpoint | gRPC Inventory.GetObservedState (internal, none streaming) | the reply holds the observed state with its observation time and stale false or true beside the ack-v1 members, and nothing is written, because the method is of class read | no workload identity, a token without the scope, an invalid request or an environment of another tenant | AIFACTORY-US-1078 | enriched | | SCN-RuntimeEnvironmentService-007 | event | RuntimeEnvironmentService publishes ObservedStateChanged on provisioning.inventory.v1.observed-state-changed | the payload carries environmentId, tenantId, projectId, the optional currentReleaseId, changes and stale, with no secret value; this service proves the publication, and each consumer the model lists, FleetInventoryService, EnvironmentService, EnvironmentPromotionService, SloService, StudioBff and DashboardService, proves its handling idempotent on the event id in its own suite | the transport is unavailable | AIFACTORY-US-1077 | enriched | | SCN-RuntimeEnvironmentService-008 | event | RuntimeEnvironmentService publishes RuntimeDriftDetected on provisioning.inventory.v1.runtime-drift-detected | the payload carries findingId, tenantId, environmentId, kind and resource; a later observation that no longer shows a finding resolves it and no operation resolves one by hand; this service proves the publication, and each consumer the model lists, AlertRuleService, StudioBff, AuditService and DashboardService, proves its handling idempotent on the event id in its own suite | the transport is unavailable, or the current specification cannot be read, the observation is stale or the Config Platform does not answer | AIFACTORY-US-1079 | enriched | | SCN-RuntimeEnvironmentService-009 | event | RuntimeEnvironmentService publishes ReconciliationProposed on provisioning.inventory.v1.reconciliation-proposed | the payload carries proposalId, tenantId, environmentId, direction and destructive; a destructive or production proposal always waits for an Operator, and a non-destructive one is auto-accepted with a new provisioningRunId only when the option allows it and the policy decision of PolicyEngineService, asked with the domain Deployment, the action kind publication with the target reconciliation-auto-accept and the class production, answers allow; this service proves the publication, and each consumer the model lists, StudioBff, StudioNotificationService and AuditService, proves its handling idempotent on the event id in its own suite | the transport is unavailable, or the policy decision answers allow-with-constraints, allow-with-approval, deny, INVALID_ARGUMENT, FAILED_PRECONDITION or UNAVAILABLE | AIFACTORY-US-1080 | enriched | | SCN-RuntimeEnvironmentService-010 | event | RuntimeEnvironmentService publishes ReconciliationDecided on provisioning.inventory.v1.reconciliation-decided | the payload carries proposalId, tenantId, environmentId, state and, for an accepted proposal, the provisioningRunId under which IaCProvisioningService creates the run of kind Reconciliation; a later ProvisioningApplied carrying that provisioningRunId moves the proposal to Applied once; this service proves the publication, and each consumer the model lists, IaCProvisioningService, StudioBff and AuditService, proves its handling idempotent on the event id in its own suite | the transport is unavailable, or the provisioning run fails or an applied event carries another provisioningRunId | AIFACTORY-US-1081 | enriched |

SecretBrokerService

Service in BC-40; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-SecretBrokerService-001 | endpoint | GET /factory/secret-references with scope factory.secrets.admin | the response is 200 with the references of the tenant of the caller in pages, each with kind, owner, purposes, maxTtlSeconds, rotationDays, lastRotatedAt, whether a rotation is due, revoked and the number of its Issued issuances; no value and no vaultRef is returned, no reference of another tenant appears, and nothing is written | 403: the token lacks factory.secrets.admin | AIFACTORY-US-954 | enriched | | SCN-SecretBrokerService-002 | endpoint | POST /factory/secret-references with scope factory.secrets.admin | the response is 201 with the metadata of the reference; a repeated call with the same Idempotency-Key and the same body returns the same result and changes nothing | 400: the body fails validation, carries an unknown member or names no rotationDays, or the key header is missing (a code the model omits); 403: the token lacks factory.secrets.admin; 409: the same Idempotency-Key arrives with another body, or the tenant already holds a reference with that referenceId | AIFACTORY-US-954 | enriched | | SCN-SecretBrokerService-003 | endpoint | POST /factory/secret-references/{referenceId}/rotate with scope factory.secrets.admin | the response is 200 with the metadata of the reference; the next issuance reads the new version and the old one is never read again; a repeated call with the same Idempotency-Key and the same body returns the same result and changes nothing | 403: the token lacks factory.secrets.admin; 404: no reference with that referenceId exists in the tenant of the caller, a reference of another tenant being answered the same (ADR-0015); 400: the new version or the key header is missing; 409: the same key arrives with another body, or the reference is revoked (400 and 409 are codes the model omits) | AIFACTORY-US-957 | enriched | | SCN-SecretBrokerService-004 | endpoint | POST /factory/secret-references/{referenceId}/revoke with scope factory.secrets.admin | the response is 200; the reference is never issued from or rotated again and no operation clears revoked; a repeated call answers 200 and changes nothing | 403: the token lacks factory.secrets.admin; 404: no reference with that referenceId exists in the tenant of the caller, a reference of another tenant being answered the same (ADR-0015); 400: the reason is missing (a code the model omits) | AIFACTORY-US-958 | enriched | | SCN-SecretBrokerService-005 | endpoint | GET /factory/runs/{runId}/issuances with scope factory.runs.read | the response is 200 with the issuances of the run as metadata only: issuance identifier, reference identifier, purpose, subject, scope, policy decision identifier, state, issuedAt, expiresAt and revokedAt; no credential and no vaultRef is returned, and nothing is written | 403: the token lacks factory.runs.read, or the caller holds in the project the subjects name no role or only a role other than Operator and Observer, Reviewer for example, and no tenant-wide role; 404: the tenant of the caller holds no issuance for that runId, which is the one answer for a run that does not exist, a run of another tenant and a run for which no credential was issued, because the service keeps no runs (ADR-0015) | AIFACTORY-US-960 | enriched | | SCN-SecretBrokerService-006 | endpoint | gRPC SecretBroker.Issue (internal, none streaming) | the reply carries the scope in the shape of execution-scope-v1 together with the credential, the issuance identifier and the expiry; the credential is delivered once and is in no row, event, evidence record, log record or metric; a repeated request is a new issuance and the first is never delivered again; connectsoft.factory.secrets.issuances, connectsoft.factory.secrets.live_issuances and connectsoft.factory.secrets.issue_latency are recorded | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope, the subject names another workload identity, the purpose is outside allowedPurposes, or the policy outcome is not allow, which includes a purpose no rule of the bundle allows, since such an action is denied; INVALID_ARGUMENT: the lifetime is above maxTtlSeconds, the purpose is tool-call without an invocation, its run or its attempt, or the purpose is sandbox without a sandbox lease; NOT_FOUND: the reference does not exist or belongs to another tenant (ADR-0015); FAILED_PRECONDITION: the reference is revoked, or Policy.Decide refuses the request with a status that is no decision, which takes the failure class permanent; UNAVAILABLE with the failure class transient: PolicyEngineService, Key Vault or the identity platform does not answer | AIFACTORY-US-955 | enriched | | SCN-SecretBrokerService-007 | endpoint | gRPC SecretBroker.Revoke (internal, none streaming) | the reply carries ack-v1; connectsoft.factory.secrets.live_issuances falls; a revocation of an issuance that is already Revoked or Expired is acknowledged and changes nothing; a provider that does not answer leaves the issuance Revoked, and the credential ends at expiresAt at the latest | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope; INVALID_ARGUMENT: the issuance identifier is missing; NOT_FOUND: the issuance does not exist or belongs to another tenant (ADR-0015) | AIFACTORY-US-956 | enriched | | SCN-SecretBrokerService-008 | endpoint | gRPC SecretBroker.Verify (internal, none streaming) | the reply carries ack-v1 and says whether the reference was verified and, when it was not, why: the vault object is missing, disabled or outside its validity, the exchange was refused, or the reference is revoked, which is answered without a vault call; no Issuance is created, no event or evidence record is written and no credential or vaultRef is returned | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope; INVALID_ARGUMENT: the reference is missing; NOT_FOUND: the reference does not exist or belongs to another tenant (ADR-0015); UNAVAILABLE with the failure class transient: Key Vault or the identity platform does not answer | AIFACTORY-US-959 | enriched | | SCN-SecretBrokerService-009 | event | SecretBrokerService publishes SecretReferenceRegistered on secret-broker.references.v1.secret-reference-registered | the payload carries referenceId, tenantId, kind, ownerKind and ownerId and no vaultRef; AuditService records it as evidence (RecordEvidence) and StudioBff refreshes its view (RefreshSecretReferenceView), each exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-954 | enriched | | SCN-SecretBrokerService-010 | event | SecretBrokerService publishes SecretRotated on secret-broker.references.v1.secret-rotated | the payload carries referenceId, tenantId and rotatedAt and no vault version; IntegrationService (RefreshConnectionCredential), ModelRouterService (RefreshProviderCredential) and ComputePoolService (RefreshPoolCredential) use the new version for their next calls and AuditService records the event as evidence (RecordEvidence), each exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-957 | enriched | | SCN-SecretBrokerService-011 | event | SecretBrokerService publishes SecretReferenceRevoked on secret-broker.references.v1.secret-reference-revoked | the payload carries referenceId, tenantId and reason; IntegrationService suspends the connections that depend on the reference (SuspendConnection), ModelRouterService takes the deployments out of routing (DisableDeploymentOnRevocation), ComputePoolService drains the pools (DrainPoolOnRevocation), ToolAdapterService refuses the tools that name it (DisableToolsOnRevocation) and AuditService records the event as evidence (RecordEvidence), each exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-958 | enriched | | SCN-SecretBrokerService-012 | event | SecretBrokerService publishes CredentialIssued on secret-broker.issuances.v1.credential-issued | the payload carries issuanceId, tenantId, referenceId, purpose, expiresAt, policyDecisionId and, when the subject names a run, runId; it is metadata only and holds no credential and no vaultRef; AuditService, its one consumer, records it as the one audit entry of the issuance (RecordEvidence), exactly once, idempotent on the event id (D126, D135) | the transport is unavailable or a consumer throws | AIFACTORY-US-955 | enriched | | SCN-SecretBrokerService-013 | event | SecretBrokerService publishes CredentialRevoked on secret-broker.issuances.v1.credential-revoked | the payload carries issuanceId, tenantId and reason; AuditService records it as evidence (RecordEvidence) exactly once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-956 | enriched |

SloService

Service in BC-21; first delivered in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-SloService-001 | endpoint | GET /factory/slos with scope factory.operations.read | the response is 200 with the objectives of the trusted tenant only, each with target and window and with the state, value, remaining error budget and burn rate of its latest measurement, and nothing is written | 403: the caller's scope lacks factory.operations.read | AIFACTORY-US-1129 | enriched | | SCN-SloService-002 | endpoint | PUT /factory/slos/{subjectKind}/{subjectId}/{kind} with scope factory.operations.admin | the response is 200, one active SloDefinition exists for the tenant, subject kind, subject and kind with the values of the body, and the SloDefined outbox record is written in the same transaction; the measurement starts with the next evaluation, and a repeat of the same body changes nothing and publishes nothing | 403: the caller's scope lacks factory.operations.admin, or a caller without the Platform admin role addresses the subject kind platform, or the subject kind tenant names another tenant; 409: the target is looser than the platform baseline of Observability:Slo:PlatformBaseline for its kind, such as an availability below 0.995 | AIFACTORY-US-1129 | enriched | | SCN-SloService-003 | endpoint | GET /factory/health/services with scope factory.operations.read | the response is 200 with the hosts of the trusted tenant and the shared hosts, each with state, dependency states, ready replicas and observedAt; no host of another tenant is returned and nothing is written | 403: the caller's scope lacks factory.operations.read | AIFACTORY-US-1131 | enriched | | SCN-SloService-004 | event | SloService publishes SloDefined on operations.slos.v1.slo-defined | the payload carries sloId, tenantId, subjectKind, subjectId, kind and target; the consumers StudioBff (RefreshSloDefinitionView) and AuditService (RecordEvidence) handle it in their own suites, idempotent on the event id | the transport is unavailable | AIFACTORY-US-1129 | enriched | | SCN-SloService-005 | event | SloService publishes SloBreached on operations.slos.v1.slo-breached | the payload carries sloId, tenantId, subjectKind, subjectId, kind, value and state; an evaluation that keeps the state publishes nothing; the consumers AlertRuleService (FireFromSlo), StudioBff (RefreshSloDefinitionView) and, from I7, FleetInventoryService (MarkDegraded) and FleetRolloutService (HaltOnGuard) handle it in their own suites, idempotent on the event id; the handler ProjectSloDefinition of DashboardService is not registered while the owner decides the projections the model does not hold | the transport is unavailable | AIFACTORY-US-1130 | enriched | | SCN-SloService-006 | event | SloService publishes SloRecovered on operations.slos.v1.slo-recovered | the payload carries sloId, tenantId and kind; the error budget never grew within the window; the consumers AlertRuleService (ResolveFromSlo), StudioBff (RefreshSloDefinitionView) and, from I7, FleetInventoryService (MarkRecovered) handle it in their own suites, idempotent on the event id | the transport is unavailable | AIFACTORY-US-1130 | enriched | | SCN-SloService-007 | event | SloService publishes ServiceHealthChanged on operations.health.v1.service-health-changed | the payload carries hostId, tenantId, fromState and toState; an unchanged rollup publishes nothing; the consumers AlertRuleService (FireFromHealth) and StudioBff (RefreshServiceHealthView) handle it in their own suites, idempotent on the event id; the handler ProjectServiceHealth of DashboardService is not registered while the owner decides the projections the model does not hold | the transport is unavailable | AIFACTORY-US-1131 | enriched |

StoreProfileService

Service in BC-42; first delivered in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-StoreProfileService-001 | endpoint | GET /factory/data/stores with scope factory.data.read | each response is 200 with the shared stores and the own per-tenant stores of the caller, each with its owning service, profile, region, backup class, schemas and state, without the store of the other tenant and without any key or connection value; nothing is written | 403: the caller's scope lacks factory.data.read | AIFACTORY-US-1466 | enriched | | SCN-StoreProfileService-002 | endpoint | GET /factory/data/store-profiles with scope factory.data.read | the response is 200 with every profile, its store class, topology, engine, adapter library, migration convention, backup class, encryption and whether it is authoritative or derived; nothing is written | 403: the caller's scope lacks factory.data.read | AIFACTORY-US-1466 | enriched | | SCN-StoreProfileService-003 | endpoint | PUT /factory/data/stores/{storeId} with scope factory.data.admin | the first call answers 201 with the binding Planned and StoreBindingChanged written in the same transaction; the transition answers 200 and writes one more event; the repeat answers 200 and writes nothing; the region was checked with Retention.EvaluateResidency before each save and only the key reference is stored | a region or engine the residency of the tenant refuses, a second owner, a schema of another service, a transition the model does not list, an unknown profile, a profile of another class, an unknown key reference, a user caller without the scope or the Platform admin role or a workload token without the service scope, or RetentionResidencyService or SecretBrokerService does not answer | AIFACTORY-US-1468 | enriched | | SCN-StoreProfileService-004 | endpoint | gRPC Stores.ResolveBinding (internal, none streaming) | the reply store-binding-resolution-v1 carries the owning service, the profile, the region, the state Active, the connection reference and the key reference, never a secret value; a Draining binding is answered with its state; the method is of class read and writes nothing | the caller has no workload identity, the request fails validation, the workload neither owns the store nor is provisioning, or the store is a per-tenant store of another tenant or has no binding | AIFACTORY-US-1469 | enriched | | SCN-StoreProfileService-005 | event | StoreProfileService publishes StoreProfileActivated on data-foundations.stores.v1.store-profile-activated | the payload carries profileId, storeClass and topology; StudioBff (RefreshStoreProfileView) and AuditService (RecordEvidence) each handle it once, idempotent on the event id; a start with nothing changed publishes nothing, and a profile that breaks an invariant is refused and publishes nothing | the transport is unavailable or a consumer throws | AIFACTORY-US-1467 | enriched | | SCN-StoreProfileService-006 | event | StoreProfileService publishes StoreBindingChanged on data-foundations.stores.v1.store-binding-changed | the payload carries storeId, tenantId, ownerService, region and state; RetentionResidencyService (CheckResidency), StudioBff (RefreshStoreBindingView) and AuditService (RecordEvidence) each handle it once, idempotent on the event id | the transport is unavailable or a consumer throws | AIFACTORY-US-1468 | enriched |

StudioBff

Service in BC-29; first delivered in I3. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-StudioBff-001 | endpoint | GET /studio/session with scope factory.studio.use | the response is 200 with the scope, the permissions snapshot, the locale, the theme, the reduced-motion preference, the work area and the feature flags; while the Config Platform is absent the flags come from the options of the service and the session is still returned (optional, degrade); a call on an active session refreshes lastSeenAt and starts no second session | 401: no token is presented or the token does not validate; or the identity platform is unreachable, so that a new sign-in cannot be validated (fail-fast) | AIFACTORY-US-032 | enriched | | SCN-StudioBff-002 | endpoint | PUT /studio/session/scope with scope factory.studio.use | the response is 200 with the session under the new scope and the permissions snapshot resolved for it; the StudioSession row is updated and nothing is published, because the command has no result event; a repeat with the same scope changes nothing | 403: the caller lacks factory.studio.use, the identity platform does not issue a token of the user for the named tenant, or the user holds no role in the project; 404: the project or the environment is outside the tenant of the trusted token, whether absent or of another tenant, and the answer never confirms that it exists (D113); or ControlPlaneApi or the identity platform is unreachable | AIFACTORY-US-1361 | enriched | | SCN-StudioBff-003 | endpoint | PUT /studio/session/preferences with scope factory.studio.use | the response is 200 with the session carrying the new preferences; Hebrew renders right to left; the next session of the user starts with them; nothing is published and a repeat with the same values changes nothing | the store studio-sql is unavailable | AIFACTORY-US-1362 | enriched | | SCN-StudioBff-004 | endpoint | GET /studio/screens/{screenId} with scope factory.studio.use | the response is 200 with the composition, the freshness of each source (Fresh, Stale, Degraded or Unknown) and the actions the role of the session may take; every result set is the one the owning platform filtered and the BFF never widens it; a source platform that is down is marked Degraded with its last freshness while the other sources render, and a source not delivered in I3 shows Unknown; nothing is written | 403: the caller lacks factory.studio.use or the roles list of the screen names no role of the session; 404: the screenId is not a screen of the model, or a subject the screen addresses does not exist in the trusted tenant, which is also the answer of the owning platform for a subject of another tenant (ADR-0015) | AIFACTORY-US-1363 | enriched | | SCN-StudioBff-005 | endpoint | POST /studio/commands/{commandId} with scope factory.studio.use | the response is 202, the envelope of the BFF around the answer of the owning service carried unchanged, the 200 of DecideApproval and of AnswerDecision included; connectsoft.factory.studio.commands_forwarded counts the command by outcome; a repeated call with the same Idempotency-Key returns the answer the owning service gives for the repeat, the same result, and changes nothing | 403: the caller lacks factory.studio.use, or the owning service refuses the caller; 422: the commandId is named by no screen or the body fails the schema of the command; 409: RunControlService answers a reused key with another input, a request version that is stale or changed by a concurrent decision, or a request already decided; 410: DecideApproval answers a request past its expiry; 400: DecideApproval answers an invalid decision; 409, 404 or 503: AnswerDecision answers a decision already answered or an approval, a decision the open attempt did not ask for, or an AgentRuntimeService that does not answer; 412: RequestPromotion of EnvironmentPromotionService answers a withdrawn release; 404: the owning service does not find the subject, alike for one of another tenant (D113); or the owning platform is down | AIFACTORY-US-1364 | enriched | | SCN-StudioBff-006 | endpoint | GET /studio/views with scope factory.studio.use | the response is 200 with the caller's own views of that screen and the views shared with the tenant of the session, each with its name, definition and sharedWith; because SavedView has no project field, a view saved with sharedWith project is treated as private to its owner (assumption of AIFACTORY-US-037); private views of other users and views of other tenants never appear (ADR-0015); a view carries a filter definition and no data, so its results stay scoped per viewer; nothing is written | the store studio-sql is unavailable | AIFACTORY-US-037 | enriched | | SCN-StudioBff-007 | endpoint | PUT /studio/views/{viewId} with scope factory.studio.use | the response is 201 for a new view and 200 for an update; a view saved with sharedWith project is stored and treated as private to its owner while SavedView has no project field; saving the same definition again changes nothing and publishes nothing | 403: the caller lacks factory.studio.use or the view is owned by another user; 404: the viewId names a view of another tenant (D113); or the store studio-sql is unavailable | AIFACTORY-US-037 | enriched | | SCN-StudioBff-008 | endpoint | GET /studio/search with scope factory.studio.use | the response is 200 with the merged results, each with its kind and reference, holding only items inside the scope of the session and never one of another tenant (ADR-0015); a source that is down or not delivered in I3, such as alerts, is named as not searched while the others return; nothing is written | the identity platform is unreachable, so that the user token cannot be exchanged for the gateways | AIFACTORY-US-037 | enriched | | SCN-StudioBff-009 | endpoint | GET /studio/health with scope factory.health.read | the response is 200 while the service is ready; a source gateway that is down is listed degraded and the response stays 200, because a composition renders without it; while the identity platform is unreachable and a cached signing key still validates tokens, the identity platform is listed degraded and the response stays 200, so existing sessions continue until their tokens expire (ADR-0015 amendment D117); the sources served by a static stub in I3 (FleetOperationsHost and DataEventFoundations) are listed as such; nothing is written | 503: the service is not ready because studio-sql is unreachable or no cached signing key validates tokens | AIFACTORY-US-1363 | enriched | | SCN-StudioBff-010 | event | StudioBff publishes StudioSessionStarted on studio.sessions.v1.studio-session-started | the payload carries sessionId, tenantId, userId and locale; AuditService (RecordEvidence) handles it exactly once, idempotent on the event id, and DashboardService (ProjectStudioSession) handles it the same way once it is delivered in I4; a call that only refreshes an active session publishes nothing | the transport is unavailable or a consumer throws | AIFACTORY-US-032 | enriched | | SCN-StudioBff-011 | event | StudioBff publishes SavedViewChanged on studio.views.v1.saved-view-changed | the payload carries viewId, tenantId, screenId and sharedWith; StudioRealtimeGateway (PushViews) handles it exactly once, idempotent on the event id, and pushes the change of a view shared with the tenant to the sessions of that tenant with a SavedViews subscription for that screen; the change of a private or project-shared view is not pushed, because the payload names neither the owner nor the project of the view | the transport is unavailable or the consumer throws | AIFACTORY-US-037 | enriched |

StudioNotificationService

Service in BC-29; first delivered in I3. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-StudioNotificationService-001 | endpoint | GET /studio/notifications with scope factory.studio.use | the response is 200 with the caller's own notifications, newest first, each with its kind, subject reference, importance, summary and read and dismissed state, and the unread counts by importance (info, action-required, critical); notifications of other users and of other tenants never appear (ADR-0015) and notifications older than Studio:Notifications:RetentionDays are gone; nothing is written | the store studio-notification-sql is unavailable | AIFACTORY-US-1366 | enriched | | SCN-StudioNotificationService-002 | endpoint | POST /studio/notifications/{notificationId}/read with scope factory.studio.use | the response is 200; the state is kept by the service, so it holds on every device of the user; a repeat changes nothing and keeps the first time; nothing is published | 404: no notification with that id belongs to the caller: it does not exist, it belongs to another user, or it belongs to another tenant, the same answer in each case that never confirms it exists (ADR-0015, D113) | AIFACTORY-US-1366 | enriched | | SCN-StudioNotificationService-003 | endpoint | PUT /studio/notifications/preferences with scope factory.studio.use | the response is 200; later notifications follow the preference; during quiet hours an action-required or critical notification is delivered in-app at once, while the in-app delivery of an info notification is held until quiet hours end and is then released by the first Digester run with its NotificationCreated (assumption of AIFACTORY-US-1367); in I3 every email or chat delivery is recorded as not made with the reason that the channel is unavailable; the Digester groups unread notifications by the digest; a repeat changes nothing and nothing is published | the store studio-notification-sql is unavailable | AIFACTORY-US-1367 | enriched | | SCN-StudioNotificationService-004 | endpoint | gRPC Notifications.Notify (internal, none streaming) | the reply carries ack-v1; a repeated call for the same event creates no second notification for any recipient and returns the same acknowledgement, so the shared-write side effect happens once | the caller has no workload token (UNAUTHENTICATED), its workload token lacks the service scope of StudioNotificationService (PERMISSION_DENIED, D114, D135), the request fails validation (INVALID_ARGUMENT), the project is not found in the tenant of the request, alike for one of another tenant (NOT_FOUND, D113), or recipient resolution through ControlPlaneApi is unavailable (fail-fast) | AIFACTORY-US-1368 | enriched | | SCN-StudioNotificationService-005 | event | StudioNotificationService publishes NotificationCreated on studio.notifications.v1.notification-created | the payload carries notificationId, tenantId, userId, kind and importance; StudioRealtimeGateway (PushNotification) handles it exactly once, idempotent on the event id, and pushes the notice to the open sessions of that user with a Notifications subscription | the transport is unavailable or the consumer throws | AIFACTORY-US-1365 | enriched |

StudioRealtimeGateway

Service in BC-29; first delivered in I3. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-StudioRealtimeGateway-001 | endpoint | GET /studio/realtime/health with scope factory.health.read | the response is 200 while the gateway is ready; an optional upstream in degrade mode that drops, such as the run streams of RunControlService, is listed degraded and the response stays 200; StudioBff, which the confirmation of every new subscription requires (fail-fast), is listed degraded while unreachable and the response stays 200, because open subscriptions keep pushing while new ones are refused; nothing is written | 503: the gateway is not ready because the backplane is unreachable; or the request carries no token (401) or a token without factory.health.read (403) | AIFACTORY-US-1372 | enriched | | SCN-StudioRealtimeGateway-002 | endpoint | gRPC Realtime.Subscribe (bff, server streaming) | the server stream delivers run-event-envelope-v1 items with an increasing sequence until the client unsubscribes, the run is terminal or the session ends; a reconnect resumes from the last sequence and a gap beyond Studio:Realtime:BufferPerConnection requests a full refresh, never a silent skip; the side effect is read and nothing outside the subscription cache is written | the token is missing or invalid (UNAUTHENTICATED); the token lacks factory.studio.use, StudioBff does not confirm the session, or the filter would widen its scope (PERMISSION_DENIED); the negotiation fails validation (INVALID_ARGUMENT); the run does not exist or belongs to another tenant, alike (NOT_FOUND, D113); StudioBff cannot be reached for the confirmation (UNAVAILABLE); or the stream kind needs a source not delivered in I3: RunList and Approvals the operations streams of DashboardService, Alerts AlertRuleService, Rollout and Incident the fleet services (UNAVAILABLE) | AIFACTORY-US-1369 | enriched |

TemplateCatalogHost

Service in BC-14; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-TemplateCatalogHost-001 | endpoint | GET /templates/health with scope factory.health.read | the response is 200; the detail names the identity platform and each fronted service with its state; a fronted service that does not answer is reported as unavailable in the detail and does not turn the answer into 503, because it is an optional dependency and the routes of the other two services keep serving; while the identity platform is unreachable and a cached signing key still validates tokens, the gateway stays in rotation: readiness stays ready, tokens that were already issued keep passing, and from the first failed probe the response is still 200 with the health degraded and a detail that names the identity platform as unreachable (D117); nothing is written | 503: the identity platform, the one required dependency, is unreachable and no valid signing key remains, because none was cached or the cached keys expired, so the gateway cannot validate tokens | AIFACTORY-US-713 | enriched | | SCN-TemplateCatalogHost-002 | endpoint | GET /templates/meta/feeds with scope factory.meta.read | the response is 200 with the package feeds and the template sources configured for this installation, by name and without a credential, as the source reported them; the gateway reads no feed itself, calls no operation of TemplateRegistryService, holds no state and writes nothing | 401: no token or an expired token; 403: the token lacks factory.meta.read; 503: no metadata source is bound, as on a deployed instance of this delivery, or the source does not answer; the identity platform is unreachable and no valid signing key remains to validate the token | AIFACTORY-US-713 | enriched | | SCN-TemplateCatalogHost-003 | route-class | a request to a publication route fronted by TemplateCatalogHost (BlueprintService, TemplateRegistryService) | the fronted service decides the publication action: it submits a Validated blueprint version or a Verified template version to Asset Publication as a release candidate and answers 202, and its answer, including 409 for a version in another state, returns unchanged with the correlation id; the review and the approval by someone other than the submitting subject are decided by AgentRegistryService behind the fronted service; the gateway evaluates no approval, holds no approval reference, demands none of the request and writes nothing | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation, or the caller sends a project header the token does not grant; the route names only a blueprintId or a templateId with a version, so the fronted service answers 403 for a caller whose role or tenant may not submit and 404 for a version of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-712 | enriched | | SCN-TemplateCatalogHost-004 | route-class | a request to a read route fronted by TemplateCatalogHost (BlueprintService, GenerationRecipeService, TemplateRegistryService) | the fronted service answers with no side effect and the response returns unchanged with the correlation id; the gateway keeps no state of the call; connectsoft.factory.templates.host.requests and connectsoft.factory.templates.host.request_duration record the call | 401, over gRPC UNAUTHENTICATED: no token, an expired token, an identity token or a user token issued for another gateway; 403, over gRPC PERMISSION_DENIED: the token lacks the scope of the operation, it is a workload token on a REST route, because no public REST operation names a service scope, or the workload token lacks the service scope of a gRPC route; 400: the call to ListBlueprints or ListRecipes names no projectId; 403: the roles of the token do not grant the project the call names, in the path or in the query parameter, or the caller sends a project header the token does not grant, on any route; a route that names only a resource id is forwarded, and the fronted service answers 403 for a missing role and 404, over gRPC NOT_FOUND, for a blueprint, a recipe or a template version of another tenant (ADR-0015 amendment D113); 503, over gRPC UNAVAILABLE: the fronted service does not answer | AIFACTORY-US-710 | enriched | | SCN-TemplateCatalogHost-005 | route-class | a request to a shared-write route fronted by TemplateCatalogHost (BlueprintService, GenerationRecipeService, TemplateRegistryService) | the fronted service applies the request once under its own idempotency rule, by key where the operation declares key-header and by the natural key of what it writes otherwise, and its answer, including the refusal of a key reused with another body and every domain refusal, returns unchanged with the correlation id; the gateway stores neither the key nor a result, so a replica that crashes during the call loses nothing and the caller retries with the same key | 401, over gRPC UNAUTHENTICATED: no token, an expired token, an identity token or a user token issued for another gateway; 403, over gRPC PERMISSION_DENIED: the token lacks the scope of the operation or the workload token lacks the service scope; 400: the body of a call to CreateBlueprintVersion or DraftRecipe names no projectId; 403: the roles of the token do not grant the project that body member names, or the caller sends a project header the token does not grant, on any route; the fronted service answers 403 for a missing role, and for a caller of DiscoverTemplates whose tenant is not the platform tenant, and 404, over gRPC NOT_FOUND, for a resource of another tenant (ADR-0015 amendment D113); 503, over gRPC UNAVAILABLE: the fronted service does not answer | AIFACTORY-US-711 | enriched |

TemplateRegistryService

Service in BC-14; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-TemplateRegistryService-001 | endpoint | GET /factory/templates with scope factory.catalog.read | the response is 200 with the template versions of the platform tenant and of the tenant of the caller, each with template id, version, layer, state and switches and with the field consumers as an empty list until the owner decides what a consumer of a template version is, paged (the generated template catalog at run time); versions of other tenants never appear (row-filter isolation, ADR-0015); nothing is written and no other service is called, so the read keeps answering from the last pinned rows while a feed or a connector is unreachable | 401: no token or an expired token; 403: the token lacks factory.catalog.read; template-registry-sql is unavailable | AIFACTORY-US-706 | enriched | | SCN-TemplateRegistryService-002 | endpoint | GET /factory/templates/{templateId}/versions/{version} with scope factory.catalog.read | the response is 200 with the manifest as it was pinned, that is the projects and their roles, the switches with their allowed values, the generated and preserved paths, the pipelines and the docs, with the repository, the commit, the manifest hash and the state, the release id once the version is Published, and the compatibility cells of the version with result and evidence reference; nothing is written | 401: no token or an expired token; 403: the token lacks factory.catalog.read; 404: no version with that templateId and version exists for the caller; a version of another tenant that is not the platform tenant is not found under the tenant row filter of the service and is answered 404, the same answer as for a version that does not exist (ADR-0015) | AIFACTORY-US-706 | enriched | | SCN-TemplateRegistryService-003 | endpoint | GET /factory/libraries with scope factory.catalog.read | the response is 200 with the library versions of the platform tenant and of the tenant of the caller, by area and layer, each with its packages and their versions on the feed, its state and the templates that consume it, paged; a version without a published package is shown Discovered and never Published; versions of other tenants never appear; nothing is written and no other service is called | 401: no token or an expired token; 403: the token lacks factory.catalog.read; template-registry-sql is unavailable | AIFACTORY-US-706 | enriched | | SCN-TemplateRegistryService-004 | endpoint | GET /factory/compatibility with scope factory.catalog.read | the response is 200 with the cells of that subject that belong to the platform tenant or to the tenant of the caller, each with its result (Compatible, CompatibleWithWarnings, Incompatible or Unknown), its evidence reference and the time of the check; a cell without evidence is Unknown and never Compatible; a subject without cells returns an empty list; nothing is written and no other service is called | 401: no token or an expired token; 403: the token lacks factory.catalog.read; template-registry-sql is unavailable | AIFACTORY-US-705 | enriched | | SCN-TemplateRegistryService-005 | endpoint | POST /factory/templates/discover with scope factory.catalog.admin | the response is 202; the pass pins each published version of a template package that is not yet pinned by manifest hash at the commit that package was built from, in state Discovered, and records each new library version, each with its TemplateVersionDiscovered or LibraryVersionDiscovered outbox record in one transaction; a head commit without a published package version creates no version; the pass is idempotent on repository and commit, so a repeated call finds every published package version pinned and changes nothing | 401: no token or an expired token; 403: the token lacks factory.catalog.admin, the caller is a Requester or an Observer, or the token names another tenant than the platform tenant, because through I4 only an administrator of the platform tenant discovers (D123); after the 202, a feed or a template source does not answer | AIFACTORY-US-704 | enriched | | SCN-TemplateRegistryService-006 | endpoint | POST /factory/templates/{templateId}/versions/{version}/publish with scope factory.catalog.admin | the response is 202; the version stays Verified, because the review and the approval by someone other than the submitting subject are decided by Asset Publication and the version becomes Published only when MarkPublished handles AssetReleasePublished; a repeated call sends the same candidate identity again, is answered 202 and writes its own evidence record, and that no second candidate exists is the rule of the release authority, whose releases are unique over tenant, asset kind, asset id and version | 401: no token or an expired token; 403: the token lacks factory.catalog.admin, the caller is a Requester or an Observer, or the caller belongs to another tenant than the platform tenant, because through I4 only an administrator of the platform tenant publishes (D123); 404: the version does not exist or belongs to a tenant that is neither the tenant of the caller nor the platform tenant, the same answer in both cases (ADR-0015); 409: the version is not Verified (it is Discovered, Published, Deprecated or Retired); 503: AgentRegistryService, a required fail-fast dependency, does not answer | AIFACTORY-US-708 | enriched | | SCN-TemplateRegistryService-007 | endpoint | gRPC Catalog.ResolveManifest (internal, none streaming) | the reply carries the pinned manifest of the version, that is the projects and their roles, the switches with their allowed values, the generated and preserved paths, the pipelines and the docs, with the repository, the commit, the manifest hash, the state and the release id once one exists; until the evaluation gate of AgentRegistryService is delivered in I4 a version the catalog has discovered that is not yet Published is served like a Published one, because a recipe may bind it under the Draft allowance (D123); the same template id and version always resolve to the same manifest and hash; nothing is written | UNAUTHENTICATED: the caller has no workload identity; PERMISSION_DENIED: the workload token lacks the service scope, or the token is a user token, which holds no service scope; INVALID_ARGUMENT: the request names no template id or no version; NOT_FOUND: the version does not exist or belongs to another tenant, the same status in both cases (ADR-0015); UNAVAILABLE: template-registry-sql does not answer | AIFACTORY-US-707 | enriched | | SCN-TemplateRegistryService-008 | event | TemplateRegistryService publishes TemplateVersionDiscovered on template-catalog.templates.v1.template-version-discovered | the payload carries templateId, version, layer and commit and the envelope names the platform tenant; the CompatibilityComputer of the service computes the cells of the version, and StudioBff (RefreshTemplateVersionView), AuditService (RecordEvidence) and GenerationRecipeService (TrackTemplates), which keeps the version as one a recipe may bind until I4 (D123), each handle the event exactly once, idempotent on the event id; a pass that finds every published package version pinned publishes nothing, and a head commit without a published package version creates no version and no event | the transport is unavailable or a consumer throws | AIFACTORY-US-704 | enriched | | SCN-TemplateRegistryService-009 | event | TemplateRegistryService publishes TemplateVersionPublished on template-catalog.templates.v1.template-version-published | the payload carries templateId, version, layer and releaseId and the envelope names the platform tenant; StudioBff (RefreshTemplateVersionView), FleetRolloutService (OfferUpgrade), AuditService (RecordEvidence) and GenerationRecipeService (OfferUpgrade) each handle it exactly once, idempotent on the event id; a redelivered AssetReleasePublished publishes nothing twice | the transport is unavailable or a consumer throws | AIFACTORY-US-708 | enriched | | SCN-TemplateRegistryService-010 | event | TemplateRegistryService publishes LibraryVersionDiscovered on template-catalog.libraries.v1.library-version-discovered | the payload carries libraryId, version, area and state and the envelope names the platform tenant; StudioBff (RefreshLibraryVersionView) and GenerationRecipeService (TrackLibraries) each handle it exactly once, idempotent on the event id; a pass that finds the version already recorded publishes nothing | the transport is unavailable or a consumer throws | AIFACTORY-US-704 | enriched | | SCN-TemplateRegistryService-011 | event | TemplateRegistryService publishes CompatibilityChecked on template-catalog.compatibility.v1.compatibility-checked | the payload carries entryId, subjectKind, subjectId, subjectVersion, withKind, withId and result and the envelope names the platform tenant; StudioBff (RefreshCompatibilityEntryView) and GenerationRecipeService (RefreshEvidence) each handle it exactly once, idempotent on the event id; a computation that finds the same cell with the same evidence publishes nothing, and a run that did not succeed or a run of another tenant with the same commit changes no cell and publishes nothing | the transport is unavailable or a consumer throws | AIFACTORY-US-705 | enriched |

ToolAdapterService

Service in BC-08; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ToolAdapterService-001 | endpoint | GET /factory/tools with scope factory.tools.read | the response is 200 with a paged list of the active descriptors of the tenant of the caller and of the platform tenant, each with tool id, version, kind, side-effect class, risk class, the MCP server it is bound to and its health; a descriptor of another tenant never appears; nothing is written | 401: no token is presented; 403: the scope of the caller lacks factory.tools.read | AIFACTORY-US-599 | enriched | | SCN-ToolAdapterService-002 | endpoint | GET /factory/tools/{toolId} with scope factory.tools.read | the response is 200 with the active descriptor: schema reference, authorization required of the caller, secret dependencies as references and never as values, timeout, retry policy, rate limits, audit requirements, kind, side-effect and risk class and health; without a named version the highest active version is returned; nothing is written | 401: no token is presented; 403: the scope of the caller lacks factory.tools.read; 404: the tool id is unknown, has no active descriptor or belongs to another tenant, the same answer in the three cases (ADR-0015) | AIFACTORY-US-599 | enriched | | SCN-ToolAdapterService-003 | endpoint | POST /factory/tools/{toolId}/dry-run with scope factory.tools.read | the response is 200 with the validity of the arguments and every violation with its path, the declared and the effective class, the policy outcome with its reason, whether an approval is needed and the sandbox kind of the descriptor; the need for an approval is read from the outcome of the decision alone: allow-with-approval needs one, allow needs none, allow-with-constraints needs none and lists its constraints, and deny is previewed as a denial at the policy stage; under the default policy propose-change-set needs an approval and blueprint-submit-version for a Draft version needs none (ADR-0026 amendment D64); invalid arguments are a result and not a refusal; no ToolInvocation is written, no idempotency key is consumed, no credential is issued, no sandbox is leased, no tool runs and no event of this service is published | 401: no token is presented; 403: the scope of the caller lacks factory.tools.read; 404: the tool id is unknown, inactive or of another tenant (ADR-0015); PolicyEngineService or EnvironmentService, both fail-fast dependencies, does not answer | AIFACTORY-US-601 | enriched | | SCN-ToolAdapterService-004 | endpoint | GET /factory/runs/{runId}/tool-receipts with scope factory.runs.read | the response is 200 with the receipts of the run, paged in the order the calls were received: for each invocation the tool id and version, the effective class, the policy decision id, the approval id when the call was gated, the outcome (state, failure class or denial stage and reason), the request hash, the result hash and the receipt reference; no argument and no result is inlined; nothing is written | 401: no token is presented; 403: the scope of the caller lacks factory.runs.read or the token grants no role in the project of the run; 404: the service holds no invocation of that run in the tenant of the caller, which is also the answer for a run of another tenant (ADR-0015) and for a run that called no tool, because the executor owns no run | AIFACTORY-US-610 | enriched | | SCN-ToolAdapterService-005 | endpoint | GET /factory/tool-invocations/{invocationId} with scope factory.runs.read | the response is 200 with the scope, the caller kind, the declared and the effective class, the pipeline stages the invocation passed with their times, its sandbox lease with kind, pool, limits and the times it was leased and released, and its receipt; the answer holds hashes and artifact references and never an argument, a result or a credential; nothing is written | 401: no token is presented; 403: the scope of the caller lacks factory.runs.read or the token grants no role in the project of the invocation; 404: the invocation is unknown or of another tenant, the same answer in both cases (ADR-0015) | AIFACTORY-US-610 | enriched | | SCN-ToolAdapterService-006 | endpoint | POST /factory/tool-invocations/{invocationId}/confirm-effect with scope factory.tools.operate | the response is 200; the finding applied moves the invocation from Uncertain to Observed (trigger EffectConfirmedApplied) with a receipt of status Succeeded, and the finding not-applied moves it to Failed (trigger EffectConfirmedNotApplied) with a receipt of status Failed; connectsoft.factory.tools.uncertain is decremented; the same finding posted again returns the same result and writes nothing; nothing is executed or repeated, and a retry of the step, which RunControlService allows only after the finding not-applied, is a new call under a new idempotency key | 401: no token is presented; 403: the token lacks factory.tools.operate, or it is a user token, because no operator acts in the tool service directly and the one caller is RunControlService (D121); 404: the invocation is unknown or of another tenant (ADR-0015); 409: the invocation is not Uncertain, or a different finding is posted for an invocation that a finding already settled | AIFACTORY-US-609 | enriched | | SCN-ToolAdapterService-007 | endpoint | gRPC ToolExecutor.Invoke (internal, server streaming) | the invocation moves Received, Validated, Authorized, Brokered, Executing and Observed; the stream sends progress and ends with the receipt (tool-receipt-v1) of status Succeeded; the sanitized result and the receipt are stored by hash through ArtifactService; ToolInvoked is written in the transaction of the terminal transition; the tool executes once, and the same key with the same request hash returns the existing receipt; a decision of allow, which under the default policy covers the classes read and sandbox and blueprint-submit-version for a Draft version (ADR-0026 amendment D64), executes without an approval, and a decision of allow-with-constraints executes under its constraints, applied to the egress allow list and the limits of the lease, and a constraint that cannot be applied denies the call (D121); connectsoft.factory.tools.invocations and connectsoft.factory.tools.latency record the call | UNAUTHENTICATED: the caller has no workload identity; PERMISSION_DENIED: the token lacks the service scope; INVALID_ARGUMENT: the request is no well-formed tool-invocation-v1; ALREADY_EXISTS: the idempotency key arrives with another request hash; FAILED_PRECONDITION: the fencing token is lower than the highest seen for the run and step, from the same attempt or from a superseded attempt of the step, or the Run Control port reports the run as cancelled or terminal; RESOURCE_EXHAUSTED: the rate limit of the descriptor is exceeded, or no sandbox is granted until the deadline of the call; UNAVAILABLE: the descriptor is unhealthy or a required dependency (PolicyEngineService, EnvironmentService, RunControlService, SecretBrokerService, ExecutionCapacityService, McpServerRegistryService or ArtifactService) does not answer before execution; a pipeline stage denies the call; an error occurs before any effect | AIFACTORY-US-602 | enriched | | SCN-ToolAdapterService-008 | endpoint | gRPC ToolExecutor.Validate (internal, none streaming) | the reply carries the validity of the arguments with every violation, the declared and the effective class, the policy outcome, whether an approval is needed and the sandbox kind; the method is of class read: no ToolInvocation is written, no idempotency key is consumed, no credential is issued, no sandbox is leased, no tool runs and no event is published | UNAUTHENTICATED: the caller has no workload identity; PERMISSION_DENIED: the token lacks the service scope; INVALID_ARGUMENT: the request is no well-formed tool-invocation-v1; NOT_FOUND: the tool is unknown, inactive or of another tenant (ADR-0015); UNAVAILABLE: PolicyEngineService or EnvironmentService does not answer | AIFACTORY-US-601 | enriched | | SCN-ToolAdapterService-009 | endpoint | gRPC ToolExecutor.Interrupt (internal, none streaming) | the reply is ack-v1 with the settled state: Observed when the result had already been observed; Cancelled (trigger InterruptedBeforeEffect) for a call of class read, and for a call of any other class whose executor had not yet handed it to the sandbox or to the owning service, with a receipt of status Cancelled and with ToolInvoked; Uncertain (trigger EffectUnconfirmed) for a call of class sandbox or above that was handed on and whose result was not observed, with a receipt of status Uncertain and ToolEffectUncertain; a repeated interrupt returns the same answer and writes nothing; an Uncertain invocation is never executed again | UNAUTHENTICATED: the caller has no workload identity; PERMISSION_DENIED: the token lacks the service scope; INVALID_ARGUMENT: the request names no invocation id; NOT_FOUND: the invocation is unknown or of another tenant (ADR-0015); the invocation is already terminal or still waits before execution | AIFACTORY-US-608 | enriched | | SCN-ToolAdapterService-010 | event | ToolAdapterService publishes ToolDescriptorActivated on tool-execution.descriptors.v1.tool-descriptor-activated | the payload carries toolId, version, tenantId, sideEffectClass and kind; the publisher proves the outbox record, the envelope and the payload; each consumer (StudioBff, AuditService, DashboardService) handles it once, idempotent on the event id, in its own suite | the transport is unavailable; the release event or the seed entry that caused the activation is delivered or loaded again | AIFACTORY-US-599 | enriched | | SCN-ToolAdapterService-011 | event | ToolAdapterService publishes ToolDescriptorRetired on tool-execution.descriptors.v1.tool-descriptor-retired | the payload carries toolId, version, tenantId and reason; from then on a call to the descriptor is denied at the schema stage as inactive; each consumer (StudioBff, AuditService) handles the event once, idempotent on the event id, in its own suite | the transport is unavailable; the event that caused the retirement is delivered again | AIFACTORY-US-599 | enriched | | SCN-ToolAdapterService-012 | event | ToolAdapterService publishes ToolInvoked on tool-execution.invocations.v1.tool-invoked | the payload carries invocationId, tenantId, projectId, runId, attemptId, toolId, toolVersion, effectiveClass, state, policyDecisionId, approvalId, requestHash and resultHash and never an argument or a result; CostUsageService records the tool usage from it and decides whether a failed or cancelled invocation is metered; each consumer (CostUsageService, AuditService, DashboardService, QualityScoreService) handles it once, idempotent on the event id, in its own suite | the transport is unavailable | AIFACTORY-US-602 | enriched | | SCN-ToolAdapterService-013 | event | ToolAdapterService publishes ToolInvocationDenied on tool-execution.invocations.v1.tool-invocation-denied | the payload carries invocationId, tenantId, toolId, reason and stage; the reason is redacted and repeats no argument; the event, the reason and the receipt of a call to a descriptor of another tenant equal those of a call to an unknown tool id apart from the ids, so the descriptor is never confirmed, and the attempt takes the failure class permanent for both (ADR-0015); the receipt carries the status Denied; after the refusing stage no credential was issued, no sandbox was leased and nothing executed; connectsoft.factory.tools.denials counts the denial by stage and reason; each consumer (StudioBff, AuditService, DashboardService) handles the event once, idempotent on the event id, in its own suite | the transport is unavailable; the denied call is repeated under the same idempotency key | AIFACTORY-US-603 | enriched | | SCN-ToolAdapterService-014 | event | ToolAdapterService publishes ToolEffectUncertain on tool-execution.invocations.v1.tool-effect-uncertain | the payload carries invocationId, tenantId, runId, attemptId, toolId and effectiveClass; connectsoft.factory.tools.uncertain is incremented; the service never repeats the call: the attempt ends with the outcome Uncertain, which marks this invocation in uncertainToolInvocationId of attempt-outcome-v1 (D123), and waits for nothing, the Operator decides in RunControlService through the operator decision it opens (D119), whose approval request keeps that id (D123), and RunControlService records the finding, applied or not-applied, through ConfirmToolEffect (D121); each consumer (AgentRuntimeService, StudioBff, StudioNotificationService, AuditService) handles the event once, idempotent on the event id, in its own suite | the transport is unavailable; the reconciler runs again for the same invocation and state | AIFACTORY-US-608 | enriched | | SCN-ToolAdapterService-015 | event | ToolAdapterService publishes SandboxLeased on tool-execution.sandboxes.v1.sandbox-leased | the payload carries leaseId, invocationId, tenantId, kind and poolId and no credential value; connectsoft.factory.tools.sandboxes_open is incremented; the consumer (DashboardService) handles the event once, idempotent on the event id, in its own suite | the transport is unavailable; before the event exists, SecretBrokerService does not answer or capacity denies the lease until the deadline of the call | AIFACTORY-US-605 | enriched | | SCN-ToolAdapterService-016 | event | ToolAdapterService publishes SandboxReleased on tool-execution.sandboxes.v1.sandbox-released | the payload carries leaseId, tenantId and reason; connectsoft.factory.tools.sandboxes_open is decremented; the release ends the sandbox and its credentials and leaves the workspace of the run in place, which ExecutionCapacityService owns and removes on a terminal run event (D121), so a later lease of the same run mounts the same workspaceRef; the minutes of the lease are reported through Usage.RecordUsage on the meter sandbox.minutes with the lease id as the source receipt; each consumer (SecretBrokerService, which revokes the issuances of the sandbox, ExecutionCapacityService, which frees the capacity, and DashboardService) handles the event once, idempotent on the event id, in its own suite | the transport is unavailable; the reaper runs again for the same lease id; CostUsageService does not answer | AIFACTORY-US-605 | enriched |

ToolExecutorHost

Service in BC-08; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ToolExecutorHost-001 | endpoint | GET /tools/health with scope factory.health.read | the response is 200; the detail names the identity platform and each fronted service with its state; a fronted service that does not answer is reported as unavailable in the detail and does not turn the answer into 503, because it is an optional dependency and the routes of the other service keep serving; while the identity platform is unreachable and a cached signing key still validates tokens, the gateway stays in rotation: readiness stays ready, tokens that were already issued keep passing, and from the first failed probe the response is still 200 with the health degraded and a detail that names the identity platform as unreachable (D117); nothing is written | 503: the identity platform, the one required dependency, is unreachable and no valid signing key remains, because none was cached or the cached keys expired, so the gateway cannot validate tokens | AIFACTORY-US-616 | enriched | | SCN-ToolExecutorHost-002 | endpoint | GET /tools/meta/capabilities with scope factory.meta.read | the response is 200 with the capabilities of the executor: the transports the gateway routes, from Tools:Mcp:Transports, and native, the sandbox kinds available and the descriptor schema versions the executor supports; nothing is written | 401: no token or an expired token; 403: the token lacks factory.meta.read; the identity platform is unreachable and no valid signing key remains to validate the token | AIFACTORY-US-616 | enriched | | SCN-ToolExecutorHost-003 | route-class | a request to a publication route fronted by ToolExecutorHost (McpServerRegistryService) | McpServerRegistryService decides the publication action: a server is activated only when its handshake and discovery succeeded, its bindings are approved and, for a server without authentication, the exception of a Platform admin is recorded; the answer of the service, including 409 and 412, returns unchanged with the correlation id; the gateway evaluates no approval, holds no approval reference, reads no registration and writes nothing | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; 404: the fronted service answers it for a server of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-614 | enriched | | SCN-ToolExecutorHost-004 | route-class | a request to a read route fronted by ToolExecutorHost (McpServerRegistryService, ToolAdapterService) | the fronted service answers with no side effect and the response returns unchanged with the correlation id; the gateway keeps no state of the call; connectsoft.factory.tools.host.requests and connectsoft.factory.tools.host.request_duration record the call with its service, transport and route | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation or is a workload token on a public REST route, over gRPC PERMISSION_DENIED for a workload token without the service scope; every route of this platform addresses a tool, a run, an invocation or a server by its id, so the fronted service answers 403 for a missing project role and 404, over gRPC NOT_FOUND, for a resource of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-612 | enriched | | SCN-ToolExecutorHost-005 | route-class | a request to a sandbox route fronted by ToolExecutorHost (McpServerRegistryService, ToolAdapterService) | the fronted service performs the sandbox action inside its own bounds, a dry run that executes nothing or a discovery that lists capabilities into bindings without activating a server, and its answer returns unchanged with the correlation id; the gateway adds no gate of its own to the class and keeps no state | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation; 404: the fronted service answers it for a tool or a server that is unknown or of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-612 | enriched | | SCN-ToolExecutorHost-006 | route-class | a request to a shared-write route fronted by ToolExecutorHost (McpServerRegistryService, ToolAdapterService) | the fronted service applies the request once under its own idempotency rule and its answer, including its 409 for a key reused with a different body or for a different finding on an invocation that a finding already settled, returns unchanged with the correlation id; the gateway stores neither a key nor a result and writes no event and no audit evidence, so after a replica crash nothing is replayed and the caller repeats the call and receives the result of the one application | 401: no token, an expired token, an identity token or a user token issued for another gateway; 403: the token lacks the scope of the operation, or it is a user token on the internal route of ConfirmToolEffect; the fronted service answers 403 for a missing project role and 404 for an invocation of another tenant (ADR-0015 amendment D113); 503: the fronted service does not answer | AIFACTORY-US-613 | enriched |

VectorMemoryService

Service in BC-11; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-VectorMemoryService-001 | endpoint | POST /factory/knowledge/search with scope factory.knowledge.read | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-VectorMemoryService-002 | endpoint | POST /factory/knowledge/graph/query with scope factory.knowledge.read | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-VectorMemoryService-003 | endpoint | GET /factory/knowledge/collections/{collectionId}/indexes with scope factory.knowledge.read | the response is 200 | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-VectorMemoryService-004 | endpoint | POST /factory/knowledge/collections/{collectionId}/indexes/rebuild with scope factory.knowledge.admin | the response is 202; a repeated call with the same idempotency key returns the same result and changes nothing | 403: the caller's scope lacks the required right | — | exempt until I5 | | SCN-VectorMemoryService-005 | endpoint | gRPC Retrieval.Retrieve (internal, none streaming) | the method resolves what the scope may retrieve from once through Ingestion.GetSourceScope, which it calls with its own workload token and never with the token of its caller, and returns the reply message of its contract with zero candidates, no citation and no index revision, an empty, well-formed result; it consults no index, no vector backend and no model profile, records no RetrievalQuery, writes no outbox record and publishes no RetrievalExecuted; a repeated call returns the same empty reply | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope; INVALID_ARGUMENT: no query, no tenant or project in the forwarded scope, or a number of candidates below one; UNAVAILABLE: KnowledgeIngestionService, a required fail-fast dependency, does not answer within the deadline of the call or answers UNAVAILABLE or DEADLINE_EXCEEDED; INTERNAL: KnowledgeIngestionService refuses the credentials of this service or answers another error | AIFACTORY-US-820 | enriched | | SCN-VectorMemoryService-006 | endpoint | gRPC Retrieval.ExpandGraph (internal, none streaming) | the method resolves what the scope may read once through Ingestion.GetSourceScope, which it calls with its own workload token and never with the token of its caller, and returns the reply message of its contract with zero facts and zero neighbours, each list present and empty; a call without an entity is well-formed and receives the same empty reply, and an entity that no fact names yields no neighbour and is not an error; it writes no row to GraphFacts, no outbox record and no GraphFactsUpdated; a repeated call returns the same empty reply | UNAUTHENTICATED: no workload identity; PERMISSION_DENIED: the token lacks the service scope; INVALID_ARGUMENT: no graph domain, an unknown domain, a validity that ends before it starts, or no tenant or project in the forwarded scope; UNAVAILABLE: KnowledgeIngestionService, a required fail-fast dependency, does not answer within the deadline of the call or answers UNAVAILABLE or DEADLINE_EXCEEDED; INTERNAL: KnowledgeIngestionService refuses the credentials of this service or answers another error | AIFACTORY-US-821 | enriched | | SCN-VectorMemoryService-007 | event | VectorMemoryService publishes IndexRevisionReady on retrieval.indexes.v1.index-revision-ready | the payload carries indexRevisionId, tenantId, collectionId, kind, revision; each consumer (StudioBff (RefreshIndexRevisionView), ContextBuilderService (RefreshIndexCatalog)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-VectorMemoryService-008 | event | VectorMemoryService publishes IndexRevisionRetired on retrieval.indexes.v1.index-revision-retired | the payload carries indexRevisionId, tenantId, collectionId; no modelled consumer exists yet, the event is retained for projections | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-VectorMemoryService-009 | event | VectorMemoryService publishes IndexDegraded on retrieval.indexes.v1.index-degraded | the payload carries indexRevisionId, tenantId, kind; each consumer (ContextBuilderService (MarkDegraded)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-VectorMemoryService-010 | event | VectorMemoryService publishes GraphFactsUpdated on retrieval.graph.v1.graph-facts-updated | the payload carries tenantId, domain, added, closed, sourceId; each consumer (ContextBuilderService (InvalidateGraphCache)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 | | SCN-VectorMemoryService-011 | event | VectorMemoryService publishes RetrievalExecuted on retrieval.queries.v1.retrieval-executed | the payload carries queryId, tenantId, runId, resultCount, latencyMs; each consumer (QualityScoreService (CollectRetrievalStats)) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | — | exempt until I5 |

WebhookGatewayService

Service in BC-17; first delivered in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-WebhookGatewayService-001 | endpoint | POST /webhooks/{ingressRef} with scope factory.webhooks.receive | the response is 202 with the inboundId; the InboundDelivery is recorded with outcome Verified, dedupKey, payloadRef and payloadHash, and the InboundDeliveryVerified outbox record is written in the same transaction; a repeated delivery with the same deduplication key inside the window returns the same inboundId and captures, records and publishes nothing, and a repeat that arrives over the rate limit is answered 429 and accepted with the same inboundId on a later retry inside the window | an unknown or inactive ingress identity, more deliveries in a minute than Integration:Webhooks:RatePerMinutePerIngress, a body over the size limit, a signature that does not verify with the secret of the connection of the entry, a signature made with the secret of another tenant, a body that fails validation, an event time outside the replay window, ArtifactService, SecretBrokerService, the cache or the store webhook-gateway-sql that does not answer, or SecretBrokerService refusing the issuance | AIFACTORY-US-1478 | enriched | | SCN-WebhookGatewayService-002 | endpoint | GET /webhooks/health with scope factory.health.read | the response is 200 while the process runs and, for readiness, while webhook-gateway-sql is migrated and reachable, the cache answers and ArtifactService and SecretBrokerService answer; nothing is written | the store webhook-gateway-sql, the cache, ArtifactService or SecretBrokerService unavailable | AIFACTORY-US-1476 | enriched | | SCN-WebhookGatewayService-003 | event | WebhookGatewayService publishes InboundDeliveryVerified on connectors.ingress.v1.inbound-delivery-verified | the payload carries inboundId, tenantId, subscriptionId, connectorId, externalId, dedupKey, payloadRef and payloadHash and never the payload, the signature or the signing secret; the consumer ConnectorRegistryService (RecordAndDispatch) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1478 | enriched | | SCN-WebhookGatewayService-004 | event | WebhookGatewayService publishes InboundDeliveryRejected on connectors.ingress.v1.inbound-delivery-rejected | the payload carries inboundId, tenantId, ingressRef and outcome and nothing of the payload or the signature; the consumer AuditService (RecordEvidence) handles it exactly once, idempotent on the event id | the transport is unavailable or the consumer throws | AIFACTORY-US-1479 | enriched |

WorkflowEngineService

Service in BC-38; first delivered in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-WorkflowEngineService-001 | endpoint | POST /runtime/workflow-definitions/validate with scope factory.assets.write | the response is 200 for a valid document; nothing is written and no event is published; the declared failure policy is taken as it stands and none is derived | 400: the body is not a WorkflowDefinition of the schema or fails a validation rule (a cycle outside a bounded loop, an agent, tool or human step without sideEffectClass or failurePolicy, Retry on a shared-write step without idempotencyKey or on a step of a class above shared-write, a human step without approval, an unresolved schema reference, a fan-out above the limit); 403: the caller's scope lacks factory.assets.write | AIFACTORY-US-498 | enriched | | SCN-WorkflowEngineService-002 | endpoint | GET /runtime/workflow-runs/{runId} with scope factory.runs.read | the response is 200 with the engine projection of the run: its state, definitionReleaseId, graphHash and lastOutcomeSequence, the steps and edges of the pinned definition, every step run with its state, iteration, attempt ids, the attempt count and, for a failed step, the failure class it keeps from StepSettled, output reference and, for a step of kind SubWorkflow, the id of its child run, the timer entries and the compensation entries; nothing is written; the authoritative run state stays in RunControlService (ADR-0014) | 403: the caller's scope lacks factory.runs.read; 404: no run with that runId exists in the caller's tenant; a run of another tenant is not found under the tenant row filter of the service and is answered 404, the same answer as for a runId that does not exist (ADR-0015) | AIFACTORY-US-504 | enriched | | SCN-WorkflowEngineService-003 | endpoint | GET /runtime/workflow-definitions/{definitionId}/versions with scope factory.assets.read | the response is 200 with the loaded versions of the definition, each with version, releaseId, graphHash and loadedAt; nothing is written | 403: the caller's scope lacks factory.assets.read; 404: no loaded version of that definitionId is readable by the caller's tenant; a definition loaded only for another tenant is answered 404, the same answer as for a definitionId that does not exist (ADR-0015) | AIFACTORY-US-498 | enriched | | SCN-WorkflowEngineService-004 | endpoint | gRPC WorkflowEngine.PlanNextSteps (internal, none streaming) | the reply, which the model describes by agent-task-contract-v1, names the ready steps with their input mappings and action classes; the method is of class read and writes nothing; a repeated call with the same sequence returns the same steps; the engine dispatches nothing, Run Control creates the step and the attempt | the caller has no workload identity (UNAUTHENTICATED), the token lacks the service scope (PERMISSION_DENIED), the request names no run or is otherwise invalid (INVALID_ARGUMENT), or the run does not exist in the forwarded tenant, a run of another tenant included (NOT_FOUND, ADR-0015) | AIFACTORY-US-499 | enriched | | SCN-WorkflowEngineService-005 | endpoint | gRPC WorkflowEngine.GetRunGraph (internal, none streaming) | the reply carries the current engine projection of the run, the same content as GetWorkflowRunGraph returns (the model names run-event-envelope-v1 as the reply descriptor); the method is of class read and writes nothing; two calls with no Advance between them return the same projection | the caller has no workload identity (UNAUTHENTICATED), the token lacks the service scope (PERMISSION_DENIED), the request carries no run id (INVALID_ARGUMENT), or the run does not exist in the forwarded tenant, a run of another tenant included (NOT_FOUND, ADR-0015) | AIFACTORY-US-504 | enriched | | SCN-WorkflowEngineService-006 | event | WorkflowEngineService publishes WorkflowDefinitionLoaded on workflows.definitions.v1.workflow-definition-loaded | the payload carries releaseId, tenantId, definitionId, version and graphHash; DashboardService projects it (ProjectWorkflowDefinitionVersion) exactly once, idempotent on the event id; a loaded version is immutable and a second load of the same releaseId writes no second event | the release fails load validation or its manifest hash cannot be verified; AgentRegistryService, PolicyEngineService or ArtifactService is unavailable; or the transport is unavailable or the consumer throws | AIFACTORY-US-498 | enriched | | SCN-WorkflowEngineService-007 | event | WorkflowEngineService publishes WorkflowRunStarted on workflows.runs.v1.workflow-run-started | the payload carries runId, tenantId, definitionReleaseId and graphHash; StudioBff (RefreshWorkflowRunView) and DashboardService (ProjectWorkflowRun) each handle it exactly once, idempotent on the event id; the engine changed no state of Run Control | the pinned release cannot be loaded because AgentRegistryService is unavailable; or the transport is unavailable or a consumer throws | AIFACTORY-US-499 | enriched | | SCN-WorkflowEngineService-008 | event | WorkflowEngineService publishes StepReady on workflows.runs.v1.step-ready | the payload carries runId, tenantId, stepRunId, stepId, kind, actionClass, idempotent, inputRef, failurePolicy and, for an agent or tool step, taskContractRef and taskContractHash, both absent for a Human step; RunControlService (CreateStepAndDispatch) creates the step idempotently on stepRunId, copies actionClass to Step.sideEffectClass and idempotent to Step.idempotent, keeps stepRunId and failurePolicy on the step, where they name the step in StepSettled and decide whether a terminal failure opens an operator decision, keeps the reference and the hash of the task contract on the step for every attempt of it, and dispatches the attempt of an Agent or Tool step or opens the approval of a Human step; DashboardService (ProjectWorkflowRun) projects it; each consumer handles it exactly once, idempotent on the event id; the engine itself dispatches nothing | ArtifactService is unreachable when the task contract must be stored; the engine stops between applying the settlement of a step and emitting StepReady; or the transport is unavailable or a consumer throws | AIFACTORY-US-499 | enriched | | SCN-WorkflowEngineService-009 | event | WorkflowEngineService publishes StepRunStateChanged on workflows.runs.v1.step-run-state-changed | the payload carries runId, tenantId, stepRunId, stepId, fromState and toState; StudioBff (RefreshWorkflowRunView) and DashboardService (ProjectWorkflow) each handle it exactly once, idempotent on the event id | the same outcome or the same StepSettled is delivered twice; an outcome of any kind, Succeeded included, arrives without a StepSettled; ArtifactService is unavailable when the Advance needs a recorded output; or the transport is unavailable or a consumer throws | AIFACTORY-US-500 | enriched | | SCN-WorkflowEngineService-010 | event | WorkflowEngineService publishes TimerFired on workflows.runs.v1.timer-fired | the payload carries runId, tenantId, timerId and stepRunId; DashboardService (ProjectWorkflowRun) handles it exactly once, idempotent on the event id; connectsoft.factory.workflows.timers_pending goes down by one | the reminder is lost; the timer fires after its step already advanced or after the run was cancelled; the timeout of a step fires while its step run is still open; or the transport is unavailable or the consumer throws | AIFACTORY-US-502 | enriched | | SCN-WorkflowEngineService-011 | event | WorkflowEngineService publishes CompensationStarted on workflows.runs.v1.compensation-started | the payload carries runId, tenantId and entries, the number of planned entries; StudioBff (RefreshWorkflowRunView), AuditService (RecordEvidence) and DashboardService (ProjectWorkflowRun) each handle it exactly once, idempotent on the event id; connectsoft.factory.workflows.compensations counts the compensation | a compensation step fails; or the transport is unavailable or a consumer throws | AIFACTORY-US-501 | enriched | | SCN-WorkflowEngineService-012 | event | WorkflowEngineService publishes WorkflowRunCompleted on workflows.runs.v1.workflow-run-completed | the payload carries runId, tenantId and outputRef; RunControlService (CompleteRun) records the run as Completed and carries that reference as the outputRef of its RunCompleted, through which a parent reads the result of a child run, StudioBff (RefreshWorkflowRunView) and DashboardService (ProjectWorkflowRun) follow; each consumer handles it exactly once, idempotent on the event id; exactly one terminal event exists for the workflow run | an outcome arrives for the Completed run; or the transport is unavailable or a consumer throws | AIFACTORY-US-500 | enriched | | SCN-WorkflowEngineService-013 | event | WorkflowEngineService publishes WorkflowRunFailed on workflows.runs.v1.workflow-run-failed | the payload carries runId, tenantId, failedStepId, failureClass and compensated, true only when every compensation entry is Compensated; RunControlService (FailRun) records the run as Failed with the reported class, and after a failed step this report alone fails the run; StudioBff (RefreshWorkflowRunView) and DashboardService (ProjectWorkflowRun) follow; each consumer handles it exactly once, idempotent on the event id | the pinned release was refused by load validation; a compensation step failed; Run Control failed the run itself and published RunFailed; or the transport is unavailable or a consumer throws | AIFACTORY-US-501 | enriched | | SCN-WorkflowEngineService-014 | event | WorkflowEngineService publishes WorkflowRunCancelled on workflows.runs.v1.workflow-run-cancelled | the payload carries runId, tenantId and openStepRuns, the number of step runs that were open; DashboardService (ProjectWorkflowRun) handles it exactly once, idempotent on the event id | the cancellation arrives for a run that is already Completed, Failed or Cancelled or that the projection does not hold; a timer of the cancelled run still fires; or the transport is unavailable or the consumer throws | AIFACTORY-US-503 | enriched | | SCN-WorkflowEngineService-015 | event | WorkflowEngineService publishes ReadinessSatisfied on workflows.readiness.v1.readiness-satisfied | the payload carries correlationId, tenantId, projectId, operation, workflowReleaseId, bundleFingerprint and bundleRef; StudioBff (RefreshReadinessCorrelationView) and DashboardService (ProjectReadinessCorrelation) each handle it exactly once, idempotent on the event id; the run is about to be submitted through SubmitRun | the predicate of the signal does not hold (passed false, another kind or descriptor, a version not of project scope, another tenant or project); the same member arrives twice; or the transport is unavailable or a consumer throws | AIFACTORY-US-505, AIFACTORY-US-009 | enriched | | SCN-WorkflowEngineService-016 | event | WorkflowEngineService publishes ReadinessRunSubmitted on workflows.readiness.v1.readiness-run-submitted | the payload carries correlationId, tenantId, projectId, operation, runId and idempotencyKey; StudioBff (RefreshReadinessCorrelationView), AuditService (RecordEvidence) and DashboardService (ProjectReadinessCorrelation) each handle it exactly once, idempotent on the event id; exactly one run exists for the key and connectsoft.factory.workflows.readiness_submissions counts the outcome | SubmitRun answers with a timeout or an uncertain response; SubmitRun answers 409 for the key with a different input hash; a signal arrives after the correlation is Submitted; or the transport is unavailable or a consumer throws | AIFACTORY-US-009 | enriched | | SCN-WorkflowEngineService-017 | event | WorkflowEngineService publishes ReadinessSuperseded on workflows.readiness.v1.readiness-superseded | the payload carries correlationId, tenantId, projectId, supersededBy, set when a newer correlation replaced it, and reason; StudioBff (RefreshReadinessCorrelationView) and DashboardService (ProjectReadinessCorrelation) each handle it exactly once, idempotent on the event id; a Submitted correlation is never superseded or mutated | the reconciler runs twice for the same correlation and version; or the transport is unavailable or a consumer throws | AIFACTORY-US-009 | enriched |

api-contracts

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-api-contracts-001 | step | the engine marks step derive-operations (agent) of api-contracts ready | the outputs operations (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-api-contracts-002 | step | the engine marks step draft-contracts (agent) of api-contracts ready | the outputs contracts (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-api-contracts-003 | step | the engine marks step lint (tool) of api-contracts ready | the outputs lint-report (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT10M or its retry policy (fixed, 3 attempts) is exhausted | — | derived | | SCN-api-contracts-004 | step | the engine marks step store (agent) of api-contracts ready | the outputs api-contracts (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived |

api-gateway-blueprint

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-api-gateway-blueprint-001 | step | the engine marks step derive-routes (agent) of api-gateway-blueprint ready | the outputs route-plan (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-api-gateway-blueprint-002 | step | the engine marks step draft-api-gateway-blueprint (agent) of api-gateway-blueprint ready | the outputs api-gateway-blueprint-draft (blueprint-api-gateway-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-api-gateway-blueprint-003 | step | the engine marks step submit-version (tool) of api-gateway-blueprint ready | the outputs version-ref (blueprint-version-ref-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT2M or its retry policy (fixed, 2 attempts) is exhausted | — | derived | | SCN-api-gateway-blueprint-004 | step | the engine marks step validate (tool) of api-gateway-blueprint ready | the outputs validation-receipt (blueprint-validation-receipt-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT5M or its retry policy (fixed, 2 attempts) is exhausted | — | derived | | SCN-api-gateway-blueprint-005 | step | the engine marks step check-valid (condition) of api-gateway-blueprint ready | the step completes with exactly one outcome recorded under the run envelope | the step exceeds its timeout PT1M or its retry policy (none, 0 attempts) is exhausted | — | derived | | SCN-api-gateway-blueprint-006 | outcome | the condition check-valid of api-gateway-blueprint evaluates false | the target step re-runs with the findings as feedback and the iteration is counted on the run | the iteration limit is reached | — | derived |

application-design

Workflow definition; placed in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-application-design-001 | step | the engine marks step discover-use-cases (agent) of application-design ready | the output use-cases (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, and design-ports becomes ready with it mapped as its use-cases input | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1149 | enriched | | SCN-application-design-002 | step | the engine marks step design-ports (agent) of application-design ready | the output ports (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, every use case having its input port and every output port an adapter the module's switches provide, and plan-telemetry becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1149 | enriched | | SCN-application-design-003 | step | the engine marks step plan-telemetry (agent) of application-design ready | the output span-plan (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome and exactly one span per use case, and assemble-design becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1150 | enriched | | SCN-application-design-004 | step | the engine marks step assemble-design (agent) of application-design ready | the output application-design (application-design-v1) is recorded once under the run envelope with exactly one new ArtifactStored that carries the descriptor application-design-v1; the run completes with application-design as its output, WorkflowRunCompleted is emitted once and Run Control records exactly one Completed outcome (ADR-0014), so a generation recipe can pin it | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1151 | enriched |

architecture-decomposition

Workflow definition; placed in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-architecture-decomposition-001 | step | the engine marks step identify-contexts (agent) of architecture-decomposition ready | the output context-candidates (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, and model-domains becomes ready with it mapped as its context-candidates input | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1141 | enriched | | SCN-architecture-decomposition-002 | step | the engine marks step model-domains (agent) of architecture-decomposition ready | the output domain-models (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome and one model per candidate context, and draft-service-blueprint becomes ready with it mapped as its domain-models input | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1141 | enriched | | SCN-architecture-decomposition-003 | step | the engine marks step draft-service-blueprint (agent) of architecture-decomposition ready | the output service-blueprint-draft (blueprint-service-v1) is recorded once under the run envelope with exactly one attempt outcome, and submit-version becomes ready with it mapped as document | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1142 | enriched | | SCN-architecture-decomposition-004 | step | the engine marks step submit-version (tool) of architecture-decomposition ready | the output version-ref (blueprint-version-ref-v1 with blueprintId, version, kind Service, documentHash and state Draft) is recorded once under the run envelope, the audit record carries blueprintId, version, kind and documentHash, and validate becomes ready | the attempt settles Failed with failure class transient (BlueprintService was unreachable before any effect) and the retry budget of the declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the attempt settles Failed with any other failure class (BlueprintService refused the document); or the attempt settles Uncertain (timeout PT2M after the call was dispatched, no receipt); or the gating approval is rejected or expires | AIFACTORY-US-1143 | enriched | | SCN-architecture-decomposition-005 | step | the engine marks step validate (tool) of architecture-decomposition ready | the output validation-receipt (blueprint-validation-receipt-v1 with passed, documentHash, findings and validationReportRef) is recorded once under the run envelope whether validation passed or not; BlueprintService moves the version from Draft to Validated when it records ValidationPassed for that exact document hash, emits BlueprintValidated with passed true or false, and after a pass derives the context map and the per-context domain models and emits ContextMapDerived and DomainModelDerived; the step succeeds in both cases and check-valid becomes ready | the step exceeds its timeout PT5M, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the version reference belongs to another tenant; a receipt with passed false is not a failure of this step | AIFACTORY-US-1143 | enriched | | SCN-architecture-decomposition-006 | step | the engine marks step check-valid (condition) of architecture-decomposition ready | when the condition holds the step completes with exactly one outcome, the run completes with service-blueprint and validation-receipt as its outputs, WorkflowRunCompleted is emitted once and Run Control records exactly one Completed outcome; when it does not hold the engine takes the on_false branch to draft-service-blueprint with the receipt as feedback (the outcome scenario of this step) | the receipt is missing or unreadable, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-1144 | enriched | | SCN-architecture-decomposition-007 | outcome | the condition check-valid of architecture-decomposition evaluates false | draft-service-blueprint, submit-version and validate re-run in order with the findings as feedback; the revised document gets its own Draft version and its own receipt, and the iteration count on the run rises by one | the receipt is still passed false after the second iteration (max_iterations 2 reached) | AIFACTORY-US-1144 | enriched |

backend-library-blueprint

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-backend-library-blueprint-001 | step | the engine marks step identify-shared-kernels (agent) of backend-library-blueprint ready | the outputs kernel-plan (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-backend-library-blueprint-002 | step | the engine marks step draft-backend-library-blueprint (agent) of backend-library-blueprint ready | the outputs backend-library-blueprint-draft (blueprint-backend-library-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-backend-library-blueprint-003 | step | the engine marks step submit-version (tool) of backend-library-blueprint ready | the outputs version-ref (blueprint-version-ref-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT2M or its retry policy (fixed, 2 attempts) is exhausted | — | derived | | SCN-backend-library-blueprint-004 | step | the engine marks step validate (tool) of backend-library-blueprint ready | the outputs validation-receipt (blueprint-validation-receipt-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT5M or its retry policy (fixed, 2 attempts) is exhausted | — | derived | | SCN-backend-library-blueprint-005 | step | the engine marks step check-valid (condition) of backend-library-blueprint ready | the step completes with exactly one outcome recorded under the run envelope | the step exceeds its timeout PT1M or its retry policy (none, 0 attempts) is exhausted | — | derived | | SCN-backend-library-blueprint-006 | outcome | the condition check-valid of backend-library-blueprint evaluates false | the target step re-runs with the findings as feedback and the iteration is counted on the run | the iteration limit is reached | — | derived |

behaviour-simulation

Workflow definition; placed in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-behaviour-simulation-001 | step | the engine marks step prepare-sandbox (tool) of behaviour-simulation ready | the output environment (execution-scope-v1) naming the sandbox the product runs in is recorded once under the run envelope with exactly one attempt outcome, and run-scenarios becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is spent | AIFACTORY-US-1236 | enriched | | SCN-behaviour-simulation-002 | step | the engine marks step run-scenarios (agent) of behaviour-simulation ready | the output scenario-results (artifact-v1) with a verdict and a trace per scenario is recorded once under the run envelope with exactly one attempt outcome; a failed scenario is a result and not a step failure, and score becomes ready | the step exceeds its timeout PT2H, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1236 | enriched | | SCN-behaviour-simulation-003 | step | the engine marks step score (agent) of behaviour-simulation ready | the output evaluation-records (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, each record citing the scenario result it scores, and store-results becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1237 | enriched | | SCN-behaviour-simulation-004 | step | the engine marks step store-results (agent) of behaviour-simulation ready | the output simulation-results (artifact-v1) is recorded once under the run envelope with exactly one new ArtifactStored; the run completes with simulation-results as its output, WorkflowRunCompleted is emitted once and Run Control records Completed exactly once; the lineage edge of the output and whether the evaluation records are stored as well follow the owner's decision | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1237 | enriched |

capability-gap-analysis

Workflow definition; placed in I5. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-capability-gap-analysis-001 | step | the engine marks step inventory-needs (agent) of capability-gap-analysis ready | the outputs needs (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-capability-gap-analysis-002 | step | the engine marks step query-estate (tool) of capability-gap-analysis ready | the outputs evidence (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-capability-gap-analysis-003 | step | the engine marks step classify-gaps (agent) of capability-gap-analysis ready | the outputs gap-report (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-capability-gap-analysis-004 | step | the engine marks step store-report (agent) of capability-gap-analysis ready | the outputs stored-gap-report (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived |

compliance-check

Workflow definition; placed in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-compliance-check-001 | step | the engine marks step select-rule-sets (agent) of compliance-check ready | the output rule-sets (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, and the fan-out fan-out-scans becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1231 | enriched | | SCN-compliance-check-002 | step | the engine marks step fan-out-scans (parallel) of compliance-check ready | the step completes with exactly one outcome under the run envelope and StepReady is emitted for scan-code and scan-infrastructure in the same advance | the evaluation exceeds its timeout PT1M (the step is never retried, none, 0 attempts) | AIFACTORY-US-1232 | enriched | | SCN-compliance-check-003 | step | the engine marks step scan-code (agent) of compliance-check ready | the output code-findings (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, naming for every finding the rule, the severity and the file or dependency it concerns | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1232 | enriched | | SCN-compliance-check-004 | step | the engine marks step scan-infrastructure (agent) of compliance-check ready | the output infrastructure-findings (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, naming for every finding the rule, the severity and the resource of the Infrastructure Blueprint it concerns | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1232 | enriched | | SCN-compliance-check-005 | step | the engine marks step join-scans (parallel) of compliance-check ready | the step completes with exactly one outcome under the run envelope and raise-findings becomes ready with both findings outputs mapped; a join whose branch was settled Failed never completes, because that branch already failed the run | the evaluation exceeds its timeout PT1M (the step is never retried, none, 0 attempts) | AIFACTORY-US-1232 | enriched | | SCN-compliance-check-006 | step | the engine marks step raise-findings (agent) of compliance-check ready | the output findings (findings-v1) is recorded once under the run envelope with exactly one attempt outcome and critical equal to the count of the findings of severity critical; AuditService records each finding once as an open finding and publishes FindingRaised once per recorded finding, and block-on-critical becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent; or the document's critical count differs from the findings of severity critical it lists | AIFACTORY-US-1233 | enriched | | SCN-compliance-check-007 | step | the engine marks step block-on-critical (condition) of compliance-check ready | with critical 0 the condition completes the step with exactly one outcome and the run with findings as its output, WorkflowRunCompleted emitted once and Run Control recording Completed exactly once; with critical above 0 the run fails with the findings as evidence, WorkflowRunFailed names block-on-critical and Run Control records Failed exactly once, so that no promotion can proceed on this generation (D133) | the recorded output is missing or unreadable, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-1233 | enriched |

database-blueprint

Workflow definition; placed in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-database-blueprint-001 | step | the engine marks step derive-stores (agent) of database-blueprint ready | the output store-plan (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, and draft-database-blueprint becomes ready with it mapped as its store-plan input; a product without persistence yields a store plan with no stores and the run continues to the draft, whose outcome for that case is pending the owner | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1152 | enriched | | SCN-database-blueprint-002 | step | the engine marks step draft-database-blueprint (agent) of database-blueprint ready | the output database-blueprint-draft (blueprint-database-v1) is recorded once under the run envelope with exactly one attempt outcome, and submit-version becomes ready with it mapped as document; for a store plan without stores no schema-valid draft is asserted: the workflow summary says the blueprint then declares no stores, while blueprint-database-v1 requires owningModule, storeClass, profile, backupClass, tables and migrations, a conflict pending the owner | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1152 | enriched | | SCN-database-blueprint-003 | step | the engine marks step submit-version (tool) of database-blueprint ready | the output version-ref (blueprint-version-ref-v1 with blueprintId, version, kind Database, documentHash and state Draft) is recorded once under the run envelope, the audit record carries blueprintId, version, kind and documentHash, and validate becomes ready | the attempt settles Failed with failure class transient and the retry budget of the declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the attempt settles Failed with any other failure class; or the attempt settles Uncertain (timeout PT2M after the call was dispatched, no receipt); or the gating approval is rejected or expires | AIFACTORY-US-1153 | enriched | | SCN-database-blueprint-004 | step | the engine marks step validate (tool) of database-blueprint ready | the output validation-receipt (blueprint-validation-receipt-v1) is recorded once under the run envelope whether validation passed or not; BlueprintService moves the version from Draft to Validated when it records ValidationPassed for that exact document hash and emits BlueprintValidated with passed true or false; the step succeeds in both cases and check-valid becomes ready | the step exceeds its timeout PT5M, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the version reference belongs to another tenant; a receipt with passed false is not a failure of this step | AIFACTORY-US-1153 | enriched | | SCN-database-blueprint-005 | step | the engine marks step check-valid (condition) of database-blueprint ready | when the condition holds the step completes with exactly one outcome, the run completes with database-blueprint and validation-receipt as its outputs, WorkflowRunCompleted is emitted once and Run Control records exactly one Completed outcome; when it does not hold the engine takes the on_false branch to draft-database-blueprint with the receipt as feedback (the outcome scenario of this step) | the receipt is missing or unreadable, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-1154 | enriched | | SCN-database-blueprint-006 | outcome | the condition check-valid of database-blueprint evaluates false | draft-database-blueprint, submit-version and validate re-run in order with the findings as feedback; the revised document gets its own Draft version and its own receipt, and the iteration count on the run rises by one | the receipt is still passed false after the second iteration (max_iterations 2 reached) | AIFACTORY-US-1154 | enriched |

debt-review

Workflow definition; placed in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-debt-review-001 | step | the engine marks step collect-signals (agent) of debt-review ready | the output signals (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, built from the analyzer results alone when no review comments were supplied, and classify-debt becomes ready with it mapped as review-findings | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1234 | enriched | | SCN-debt-review-002 | step | the engine marks step classify-debt (agent) of debt-review ready | the output debt-items (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, every item citing the signal it comes from, and raise-findings becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1234 | enriched | | SCN-debt-review-003 | step | the engine marks step raise-findings (agent) of debt-review ready | the output debt-findings (findings-v1) is recorded once under the run envelope with exactly one attempt outcome and critical equal to the count of the findings of severity critical; AuditService records each finding once as an open finding and publishes FindingRaised once per recorded finding; the run completes with debt-findings as its output, WorkflowRunCompleted is emitted once and Run Control records Completed exactly once | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent; or the document's critical count differs from the findings of severity critical it lists | AIFACTORY-US-1235 | enriched |

delivery-run

Workflow definition; placed in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-delivery-run-001 | step | the engine marks step evaluate-results (agent) of delivery-run ready | the output evaluation (artifact-v1) with the count blocking and every blocking failure named by its typed result is recorded once under the run envelope with exactly one attempt outcome, and gates-passed becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1184 | enriched | | SCN-delivery-run-002 | step | the engine marks step gates-passed (condition) of delivery-run ready | when the condition holds the step completes with exactly one outcome under the run envelope and prepare-release becomes ready; when it does not hold the definition declares no branch, so the engine fails the run with the evaluation as its evidence, WorkflowRunFailed names gates-passed, and no release manifest is prepared and no promotion requested | the evaluation is missing or unreadable, or the evaluation of the condition exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-1184 | enriched | | SCN-delivery-run-003 | step | the engine marks step prepare-release (agent) of delivery-run ready | the output release-manifest (release-manifest-v1) is recorded once under the run envelope with exactly one attempt outcome, becomes the run output, and request-promotion becomes ready with it mapped as release | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1185 | enriched | | SCN-delivery-run-004 | step | the engine marks step request-promotion (agent) of delivery-run ready | for a non-production target one promotion is requested and PromotionRequested names the run; the output promotion-request (artifact-v1) with the target environment and the flag isProduction is recorded once under the run envelope with exactly one attempt outcome, and approve-production is reached; for a production target the promotion gate of EnvironmentPromotionService requests the one production approval bound to the release id and environment, which approve-production waits on (D133); a request without a strategy is refused with 422 (D135); that deploy-environment is production class inside this shared-write step is reported as an open question | attempts settle Failed with failure class transient until the retry budget of the declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted, which holds for this shared-write step because it declares an idempotency key (D114); the promotion is refused or ends Rejected because the release is not Ready in ReleaseService or a gate fails; an attempt settles Failed with any other failure class or exceeds PT30M; or an attempt settles Uncertain | AIFACTORY-US-1186 | enriched | | SCN-delivery-run-005 | step | the engine marks step approve-production (human) of delivery-run ready | an approving ApprovalDecided that names the gate for that release id and environment completes the step with exactly one outcome under the run envelope and the run completes with release-manifest as its output; no second production approval is requested | the decision rejects the gate, the request expires and the on-expiry rule of the pinned policy revision leaves no re-request, or the step exceeds its timeout P7D; a human step is never retried (failure_policy Fail) | AIFACTORY-US-1186 | enriched |

documentation-blueprint

Workflow definition; placed in I5. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-documentation-blueprint-001 | step | the engine marks step plan-documentation (agent) of documentation-blueprint ready | the outputs documentation-plan (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-documentation-blueprint-002 | step | the engine marks step draft-documentation-blueprint (agent) of documentation-blueprint ready | the outputs documentation-blueprint-draft (blueprint-documentation-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-documentation-blueprint-003 | step | the engine marks step submit-version (tool) of documentation-blueprint ready | the outputs version-ref (blueprint-version-ref-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT2M or its retry policy (fixed, 2 attempts) is exhausted | — | derived | | SCN-documentation-blueprint-004 | step | the engine marks step validate (tool) of documentation-blueprint ready | the outputs validation-receipt (blueprint-validation-receipt-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT5M or its retry policy (fixed, 2 attempts) is exhausted | — | derived | | SCN-documentation-blueprint-005 | step | the engine marks step check-valid (condition) of documentation-blueprint ready | the step completes with exactly one outcome recorded under the run envelope | the step exceeds its timeout PT1M or its retry policy (none, 0 attempts) is exhausted | — | derived | | SCN-documentation-blueprint-006 | outcome | the condition check-valid of documentation-blueprint evaluates false | the target step re-runs with the findings as feedback and the iteration is counted on the run | the iteration limit is reached | — | derived |

documentation-sync

Workflow definition; placed in I5. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-documentation-sync-001 | step | the engine marks step regenerate-site (agent) of documentation-sync ready | the outputs generated-docs (change-set-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-documentation-sync-002 | step | the engine marks step write-deltas (agent) of documentation-sync ready | the outputs doc-change-set (change-set-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-documentation-sync-003 | step | the engine marks step validate-build (tool) of documentation-sync ready | the outputs validation-results (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT15M or its retry policy (fixed, 3 attempts) is exhausted | — | derived | | SCN-documentation-sync-004 | step | the engine marks step approve-proposal (human) of documentation-sync ready | the step completes with exactly one outcome recorded under the run envelope | the step exceeds its timeout P7D or its retry policy (none, 0 attempts) is exhausted | — | derived | | SCN-documentation-sync-005 | step | the engine marks step propose-change-set (tool) of documentation-sync ready | the outputs documentation-change-proposal (pull-request-proposal-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (fixed, 2 attempts) is exhausted | — | derived |

frontend-blueprint

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-frontend-blueprint-001 | step | the engine marks step derive-composition (agent) of frontend-blueprint ready | the outputs composition (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-frontend-blueprint-002 | step | the engine marks step draft-frontend-blueprint (agent) of frontend-blueprint ready | the outputs frontend-blueprint-draft (blueprint-frontend-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-frontend-blueprint-003 | step | the engine marks step submit-version (tool) of frontend-blueprint ready | the outputs version-ref (blueprint-version-ref-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT2M or its retry policy (fixed, 2 attempts) is exhausted | — | derived | | SCN-frontend-blueprint-004 | step | the engine marks step validate (tool) of frontend-blueprint ready | the outputs validation-receipt (blueprint-validation-receipt-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT5M or its retry policy (fixed, 2 attempts) is exhausted | — | derived | | SCN-frontend-blueprint-005 | step | the engine marks step check-valid (condition) of frontend-blueprint ready | the step completes with exactly one outcome recorded under the run envelope | the step exceeds its timeout PT1M or its retry policy (none, 0 attempts) is exhausted | — | derived | | SCN-frontend-blueprint-006 | outcome | the condition check-valid of frontend-blueprint evaluates false | the target step re-runs with the findings as feedback and the iteration is counted on the run | the iteration limit is reached | — | derived |

gateway-generation

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-gateway-generation-001 | step | the engine marks step map-routes (agent) of gateway-generation ready | the outputs route-map (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-gateway-generation-002 | step | the engine marks step scaffold-gateway (agent) of gateway-generation ready | the outputs change-set (change-set-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-gateway-generation-003 | step | the engine marks step build-and-test (tool) of gateway-generation ready | the outputs validation-results (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT20M or its retry policy (fixed, 3 attempts) is exhausted | — | derived | | SCN-gateway-generation-004 | step | the engine marks step record-outputs (agent) of gateway-generation ready | the outputs generated-outputs (change-set-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived |

generate-libraries

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-generate-libraries-001 | step | the engine marks step scaffold-library (agent) of generate-libraries ready | the outputs scaffold (change-set-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-generate-libraries-002 | step | the engine marks step implement-kernel (agent) of generate-libraries ready | the outputs change-set (change-set-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-generate-libraries-003 | step | the engine marks step build-and-test (tool) of generate-libraries ready | the outputs validation-results (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (fixed, 3 attempts) is exhausted | — | derived | | SCN-generate-libraries-004 | step | the engine marks step record-outputs (agent) of generate-libraries ready | the outputs generated-outputs (change-set-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived |

generate-product

Workflow definition; placed in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-generate-product-001 | step | the engine marks step resolve-recipe (tool) of generate-product ready | the outputs module-plan (artifact-v1), module-blueprints (blueprint-module-v1), application-designs (application-design-v1), domain-model (artifact-v1), database-blueprints, frontend-blueprints and ux-blueprint are recorded once under the run envelope with exactly one attempt outcome and scaffold-modules becomes ready; no blueprint outside the recipe's pins is read. Recipes.GetApprovedRecipe answers one artifact-v1 reference to the recipe document and the model names no component that maps it onto the seven outputs, and that an input the plan does not need (such as the Frontend and UX Blueprints of a plan without a shell or microfrontend module) is recorded empty is an assumption; both are pending the owner | the recipe is neither Approved nor Executing (FailedPrecondition) or belongs to another tenant (NOT_FOUND, the same answer as for a recipe that does not exist); or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the step exceeds its timeout PT2M | AIFACTORY-US-1155 | enriched | | SCN-generate-product-002 | step | the engine marks step scaffold-modules (agent) of generate-product ready | the output scaffold (change-set-v1) is recorded once under the run envelope with exactly one attempt outcome, listing every created file with its change kind and carrying the hash of the change set; no module is scaffolded from another template version than its pin, and fan-out-fill becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1156 | enriched | | SCN-generate-product-003 | step | the engine marks step fan-out-fill (parallel) of generate-product ready | every branch whose guard holds becomes ready, a branch whose guard does not hold is recorded Skipped by the engine without an attempt, and the fan-out records exactly one outcome under the run envelope; on a pass back from check-build the branches that run carry the validation results as feedback | the scaffold or the module plan is missing, or the fan-out exceeds its timeout PT1M (never retried, none, 0 attempts) | AIFACTORY-US-1157 | enriched | | SCN-generate-product-004 | step | the engine marks step fill-backend (agent) of generate-product ready | the output backend-change-set (change-set-v1) is recorded once under the run envelope with exactly one attempt outcome, holding one handler per use case and no handler without a use case, and the branch counts toward join-fill | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1158 | enriched | | SCN-generate-product-005 | step | the engine marks step fill-frontend (agent) of generate-product ready | when the guard holds the output frontend-change-set (change-set-v1) is recorded once under the run envelope with exactly one attempt outcome; when it does not hold the step is Skipped, no change set is recorded and join-fill counts the branch as satisfied (ADR-0027, D68) | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1159 | enriched | | SCN-generate-product-006 | step | the engine marks step fill-database (agent) of generate-product ready | when the guard holds the output database-change-set (change-set-v1) is recorded once under the run envelope with exactly one attempt outcome; when it does not hold the step is Skipped, no change set is recorded and join-fill counts the branch as satisfied (ADR-0027, D68) | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1159 | enriched | | SCN-generate-product-007 | step | the engine marks step join-fill (parallel) of generate-product ready | when every branch that ran succeeded the join completes with exactly one outcome under the run envelope and build-and-test becomes ready with the change sets of those branches | one branch failed, or the join exceeds its timeout PT1M (never retried, none, 0 attempts) | AIFACTORY-US-1157 | enriched | | SCN-generate-product-008 | step | the engine marks step build-and-test (tool) of generate-product ready | the output validation-results (artifact-v1 with passed and the result per module) is recorded once under the run envelope whether the build passed or not; a failing build or test is a successful step output with passed false, not a step failure, and check-build becomes ready | the step exceeds its timeout PT45M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (fixed, 3 attempts, backoff 10s) is exhausted | AIFACTORY-US-016 | enriched | | SCN-generate-product-009 | step | the engine marks step check-build (condition) of generate-product ready | when the condition holds the step completes with exactly one outcome and record-outputs becomes ready; when it does not hold the engine takes the on_false branch to fan-out-fill with the results as feedback (the outcome scenario of this step) | the results are missing or unreadable, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-016 | enriched | | SCN-generate-product-010 | outcome | the condition check-build of generate-product evaluates false | fan-out-fill, the fill branches whose guards hold, join-fill and build-and-test re-run in order with the results as feedback; each produces its own change sets and results, and the iteration count on the run rises by one | the results are still passed false after the second iteration (max_iterations 2 reached) | AIFACTORY-US-016 | enriched | | SCN-generate-product-011 | step | the engine marks step record-outputs (agent) of generate-product ready | the outputs generated-outputs (change-set-v1) and provenance (artifact-v1) are recorded once under the run envelope with exactly one attempt outcome; one GeneratedOutput and one GeneratedOutputRecorded exist per module, the first call of the run moves the recipe from Approved to Executing, and approve-proposal becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted, or an attempt settles Uncertain | AIFACTORY-US-016 | enriched | | SCN-generate-product-012 | step | the engine marks step approve-proposal (human) of generate-product ready | an approving decision bound to the pending hash publishes ApprovalDecided, the run returns to Running, the step completes with exactly one outcome and propose-change-set becomes ready; a decision by the requester of the run is refused and leaves the request pending, and a regenerated change set with a new hash makes the pending request Stale so it never advances the run. A ChangesRequested decision is recorded with its reason and the run does not reach propose-change-set; what regenerates the change set stays open, because Run Control returns such a run to the lease holder and a Human step has none. Until I4 the approval always runs, also under a project policy that would allow autonomous proposals; from I4 the step carries a policy guard that the engine evaluates through PolicyEngineService before StepReady, and an answer allow records the step run Skipped and opens no approval (D133) | the request is rejected, or it expires after P7D (it fails on expiry while no approval rule is supplied, D115), or the run is cancelled or fails while the request is Pending | AIFACTORY-US-1160 | enriched | | SCN-generate-product-013 | step | the engine marks step propose-change-set (tool) of generate-product ready | the proposal is recorded in PullRequestOpen, the output change-proposal (pull-request-proposal-v1) is recorded once under the run envelope, ChangeProposalOpened names the run, the run completes with generated-outputs and change-proposal as its outputs, WorkflowRunCompleted is emitted once, Run Control records exactly one Completed outcome, and the recipe moves from Executing to Generated with GenerationCompleted published once (D133) | an attempt settles Failed, or settles Uncertain (timeout PT30M after the call was dispatched, no answer) | AIFACTORY-US-1161 | enriched |

guides-generation

Workflow definition; placed in I5. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-guides-generation-001 | step | the engine marks step outline (agent) of guides-generation ready | the outputs outline (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-guides-generation-002 | step | the engine marks step draft (agent) of guides-generation ready | the outputs drafts (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-guides-generation-003 | step | the engine marks step self-review (agent) of guides-generation ready | the outputs review-notes (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-guides-generation-004 | step | the engine marks step store-drafts (agent) of guides-generation ready | the outputs guide-drafts (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived |

infrastructure-plan

Workflow definition; placed in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-infrastructure-plan-001 | step | the engine marks step derive-topology (agent) of infrastructure-plan ready | the output topology (artifact-v1) with the deployment profile, regions, stores and pools and the NFR class they follow is recorded once under the run envelope with exactly one attempt outcome, and draft-blueprint becomes ready with it mapped as topology | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1197 | enriched | | SCN-infrastructure-plan-002 | step | the engine marks step draft-blueprint (agent) of infrastructure-plan ready | the output infrastructure-blueprint (blueprint-infrastructure-v1) is recorded once under the run envelope with exactly one attempt outcome, and submit-version becomes ready with it mapped as document | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1197 | enriched | | SCN-infrastructure-plan-003 | step | the engine marks step submit-version (tool) of infrastructure-plan ready | the output version-ref (blueprint-version-ref-v1 with blueprintId, version, kind Infrastructure, documentHash and state Draft) is recorded once under the run envelope, the audit record carries blueprintId, version, kind and documentHash, and validate becomes ready | the attempt settles Failed with failure class transient and the retry budget of the declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the attempt settles Failed with any other failure class (BlueprintService refused the document); or the attempt settles Uncertain (timeout PT2M after the call was dispatched, no receipt); or the gating approval is rejected or expires | AIFACTORY-US-1198 | enriched | | SCN-infrastructure-plan-004 | step | the engine marks step validate (tool) of infrastructure-plan ready | the output validation-receipt (blueprint-validation-receipt-v1 with passed, documentHash, findings and validationReportRef) is recorded once under the run envelope whether validation passed or not; BlueprintService moves the version from Draft to Validated when it records ValidationPassed for that exact document hash, leaves it Draft when the receipt fails, and emits BlueprintValidated with passed true or false; the step succeeds in both cases and check-valid becomes ready | the step exceeds its timeout PT5M, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the version reference belongs to another tenant; a receipt with passed false is not a failure of this step | AIFACTORY-US-1198 | enriched | | SCN-infrastructure-plan-005 | step | the engine marks step check-valid (condition) of infrastructure-plan ready | when the condition holds the step completes with exactly one outcome under the run envelope and generate-pulumi becomes ready, so no program is generated from a blueprint that has not passed; when it does not hold the engine takes the on_false branch to draft-blueprint with the receipt as feedback (the outcome scenario of this step) | the receipt is missing or unreadable, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-1199 | enriched | | SCN-infrastructure-plan-006 | outcome | the condition check-valid of infrastructure-plan evaluates false | draft-blueprint, submit-version and validate re-run in order with the findings as feedback; the revised document gets its own Draft version and its own receipt, and the iteration count on the run rises by one | the receipt is still passed false after the second iteration (max_iterations 2 reached) | AIFACTORY-US-1199 | enriched | | SCN-infrastructure-plan-007 | step | the engine marks step generate-pulumi (agent) of infrastructure-plan ready | the output pulumi-program (change-set-v1) with its diff reference and hash is recorded once under the run envelope with exactly one attempt outcome, nothing leaves the isolated workspace, and preview becomes ready with it mapped | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1200 | enriched | | SCN-infrastructure-plan-008 | step | the engine marks step preview (tool) of infrastructure-plan ready | the output preview-report (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, every destructive operation of the diff is reported as a finding, and record-outputs becomes ready with it mapped | the step exceeds its timeout PT20M, an attempt settles Failed with a failure class other than transient (a denied command included), which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted | AIFACTORY-US-1200 | enriched | | SCN-infrastructure-plan-009 | step | the engine marks step record-outputs (agent) of infrastructure-plan ready | the output generated-outputs (change-set-v1) is recorded once under the run envelope with exactly one new ArtifactStored; the run completes with infrastructure-blueprint, pulumi-program and validation-receipt as its outputs, WorkflowRunCompleted is emitted once and Run Control records exactly one Completed outcome (ADR-0014) | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1201 | enriched |

milestone-lifecycle

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-milestone-lifecycle-001 | step | the engine marks step collect-runs (agent) of milestone-lifecycle ready | the outputs runs (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-milestone-lifecycle-002 | step | the engine marks step verify-evidence (agent) of milestone-lifecycle ready | the outputs verification (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-milestone-lifecycle-003 | step | the engine marks step all-passed (condition) of milestone-lifecycle ready | the step completes with exactly one outcome recorded under the run envelope | the step exceeds its timeout PT1M or its retry policy (none, 0 attempts) is exhausted | — | derived | | SCN-milestone-lifecycle-004 | step | the engine marks step package-release (agent) of milestone-lifecycle ready | the outputs release (release-manifest-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived |

module-blueprints

Workflow definition; placed in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-module-blueprints-001 | step | the engine marks step fan-out-contexts (parallel) of module-blueprints ready | under the assumed binding one branch per context is started and draft-module becomes ready in each, and the fan-out records exactly one outcome under the run envelope | the context map is missing or has no context, or the fan-out exceeds its timeout PT1M (never retried, none, 0 attempts) | AIFACTORY-US-1145 | enriched | | SCN-module-blueprints-002 | step | the engine marks step draft-module (agent) of module-blueprints ready | the output module-blueprint-draft (blueprint-module-v1) of the branch is recorded once under the run envelope with exactly one attempt outcome, and the branch's submit-version becomes ready with it mapped as document | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1146 | enriched | | SCN-module-blueprints-003 | step | the engine marks step submit-version (tool) of module-blueprints ready | the output version-ref (blueprint-version-ref-v1 with blueprintId, version, kind Module, documentHash and state Draft) of the branch is recorded once under the run envelope, the audit record carries blueprintId, version, kind and documentHash, and the branch's validate becomes ready | the attempt settles Failed with failure class transient and the retry budget of the declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the attempt settles Failed with any other failure class; or the attempt settles Uncertain (timeout PT2M after the call was dispatched, no receipt); or the gating approval is rejected or expires | AIFACTORY-US-1147 | enriched | | SCN-module-blueprints-004 | step | the engine marks step validate (tool) of module-blueprints ready | the output validation-receipt (blueprint-validation-receipt-v1) of the branch is recorded once under the run envelope whether validation passed or not; BlueprintService moves the version from Draft to Validated when it records ValidationPassed for that exact document hash and emits BlueprintValidated with passed true or false; the step succeeds in both cases and the branch's check-valid becomes ready | the step exceeds its timeout PT5M, or attempts settle Failed with failure class transient, among them the answer Unavailable while the template registry cannot resolve the manifest, until the retry budget of its declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the version reference belongs to another tenant; a receipt with passed false is not a failure of this step | AIFACTORY-US-1147 | enriched | | SCN-module-blueprints-005 | step | the engine marks step check-valid (condition) of module-blueprints ready | when the condition holds the branch completes with exactly one outcome and counts toward join; when it does not hold the engine takes the on_false branch to the branch's draft-module with the receipt as feedback (the outcome scenario of this step) | the receipt is missing or unreadable, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-1148 | enriched | | SCN-module-blueprints-006 | outcome | the condition check-valid of module-blueprints evaluates false | draft-module, submit-version and validate of that branch re-run in order with the findings as feedback; the revised document gets its own Draft version and its own receipt and the iteration is counted on the run; whether max_iterations applies per branch or per run is not stated by the definition or by WorkflowEngineService and is pending the owner | the receipt of the branch is still passed false after the second iteration (max_iterations 2 reached) | AIFACTORY-US-1148 | enriched | | SCN-module-blueprints-007 | step | the engine marks step join (parallel) of module-blueprints ready | when every branch passed the join completes with exactly one outcome, the run completes with module-blueprints (one validated Module Blueprint per context) and validation-receipt as its outputs, WorkflowRunCompleted is emitted once and Run Control records exactly one Completed outcome | one branch failed, or the join exceeds its timeout PT1M (never retried, none, 0 attempts) | AIFACTORY-US-1145 | enriched |

observability-blueprint

Workflow definition; placed in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-observability-blueprint-001 | step | the engine marks step derive-signals (agent) of observability-blueprint ready | the output signal-plan (artifact-v1) covering every module and every published operation is recorded once under the run envelope with exactly one attempt outcome, and draft-observability-blueprint becomes ready with it mapped as signal-plan | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1202 | enriched | | SCN-observability-blueprint-002 | step | the engine marks step draft-observability-blueprint (agent) of observability-blueprint ready | the output observability-blueprint-draft (blueprint-observability-v1) is recorded once under the run envelope with exactly one attempt outcome, and submit-version becomes ready with it mapped as document | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1202 | enriched | | SCN-observability-blueprint-003 | step | the engine marks step submit-version (tool) of observability-blueprint ready | the output version-ref (blueprint-version-ref-v1 with blueprintId, version, kind Observability, documentHash and state Draft) is recorded once under the run envelope, the audit record carries blueprintId, version, kind and documentHash, and validate becomes ready | the attempt settles Failed with failure class transient and the retry budget of the declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the attempt settles Failed with any other failure class (BlueprintService refused the document); or the attempt settles Uncertain (timeout PT2M after the call was dispatched, no receipt); or the gating approval is rejected or expires | AIFACTORY-US-1203 | enriched | | SCN-observability-blueprint-004 | step | the engine marks step validate (tool) of observability-blueprint ready | the output validation-receipt (blueprint-validation-receipt-v1 with passed, documentHash, findings and validationReportRef) is recorded once under the run envelope whether validation passed or not; BlueprintService moves the version from Draft to Validated when it records ValidationPassed for that exact document hash, leaves it Draft when the receipt fails, and emits BlueprintValidated with passed true or false; the step succeeds in both cases and check-valid becomes ready | the step exceeds its timeout PT5M, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the version reference belongs to another tenant; a receipt with passed false is not a failure of this step | AIFACTORY-US-1203 | enriched | | SCN-observability-blueprint-005 | step | the engine marks step check-valid (condition) of observability-blueprint ready | when the condition holds the step completes with exactly one outcome and, being the last step, the run completes with the passing draft as observability-blueprint and its receipt as validation-receipt, WorkflowRunCompleted is emitted once and Run Control records exactly one Completed outcome (ADR-0014); when it does not hold the engine takes the on_false branch to draft-observability-blueprint with the receipt as feedback (the outcome scenario of this step) | the receipt is missing or unreadable, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-1204 | enriched | | SCN-observability-blueprint-006 | outcome | the condition check-valid of observability-blueprint evaluates false | draft-observability-blueprint, submit-version and validate re-run in order with the findings as feedback; the revised document gets its own Draft version and its own receipt, and the iteration count on the run rises by one | the receipt is still passed false after the second iteration (max_iterations 2 reached) | AIFACTORY-US-1204 | enriched |

pipeline-blueprint

Workflow definition; placed in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-pipeline-blueprint-001 | step | the engine marks step derive-stages (agent) of pipeline-blueprint ready | the output stage-plan (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, and draft-pipeline-blueprint becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1244 | enriched | | SCN-pipeline-blueprint-002 | step | the engine marks step draft-pipeline-blueprint (agent) of pipeline-blueprint ready | the output pipeline-blueprint-draft (blueprint-pipeline-v1) is recorded once under the run envelope with exactly one attempt outcome, and submit-version becomes ready with it mapped as document | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1244 | enriched | | SCN-pipeline-blueprint-003 | step | the engine marks step submit-version (tool) of pipeline-blueprint ready | the output version-ref (blueprint-version-ref-v1 with blueprintId, version, kind, documentHash and state Draft) is recorded once under the run envelope, the audit record carries blueprintId, version, kind and documentHash, and validate becomes ready | the attempt settles Failed with failure class transient and the retry budget of the declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is spent; or the attempt settles Failed with any other failure class; or the attempt settles Uncertain (timeout PT2M after the call was dispatched, no receipt); or the gating approval is rejected or expires | AIFACTORY-US-1245 | enriched | | SCN-pipeline-blueprint-004 | step | the engine marks step validate (tool) of pipeline-blueprint ready | the output validation-receipt (blueprint-validation-receipt-v1) is recorded once under the run envelope whether validation passed or not; BlueprintService itself moves the version from Draft to Validated when it records ValidationPassed for that exact document hash and leaves it Draft when the receipt fails, and emits BlueprintValidated with passed true or false; the step succeeds in both cases and check-valid becomes ready | the step exceeds its timeout PT5M, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is spent; or the version reference belongs to another tenant; a receipt with passed false is not a failure of this step | AIFACTORY-US-1245 | enriched | | SCN-pipeline-blueprint-005 | step | the engine marks step check-valid (condition) of pipeline-blueprint ready | when the condition holds the step completes with exactly one outcome, the run completes with the run output pipeline-blueprint bound to the validated BlueprintVersion that steps.submit-version.version-ref of the passing iteration names and validation-receipt bound to its receipt (D133), WorkflowRunCompleted is emitted once and Run Control records Completed exactly once; when it does not hold the engine takes the on_false branch to draft-pipeline-blueprint with the receipt as feedback (the outcome scenario of this step) | the receipt is missing or unreadable, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-1246 | enriched | | SCN-pipeline-blueprint-006 | outcome | the condition check-valid of pipeline-blueprint evaluates false | draft-pipeline-blueprint, submit-version and validate re-run in order with the findings as feedback; the revised document gets its own Draft version and its own receipt, and the iteration count on the run rises by one | the receipt is still passed false after the second iteration (max_iterations 2 reached) | AIFACTORY-US-1246 | enriched |

plan-run

Workflow definition; placed in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-plan-run-001 | step | the engine marks step classify-intent (agent) of plan-run ready | the output intent (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, and the condition select-definition becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1241 | enriched | | SCN-plan-run-002 | step | the engine marks step select-definition (condition) of plan-run ready | the step completes with exactly one outcome under the run envelope; when the condition holds the when guard of compose-plan does not hold and the engine records that step Skipped (ADR-0027), and under the model as it stands validate-plan then reads an absent steps.compose-plan.plan, fails with evidence and the run ends Failed with WorkflowRunFailed naming validate-plan; when it does not hold compose-plan becomes ready | the recorded intent is missing or unreadable, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-1241 | enriched | | SCN-plan-run-003 | step | the engine marks step compose-plan (agent) of plan-run ready | the output plan (workflow-definition-v1) is recorded once under the run envelope with exactly one attempt outcome, and the condition validate-plan becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1242 | enriched | | SCN-plan-run-004 | step | the engine marks step validate-plan (condition) of plan-run ready | under the model as it stands the valid member is absent from workflow-definition-v1, so the condition fails with evidence, WorkflowRunFailed names validate-plan and Run Control records Failed exactly once; once the owner decides which act sets the verdict, a valid plan completes the step with exactly one outcome and makes start-steps ready, and an invalid plan fails the run with the validation report as its evidence and the failure class validation | the recorded plan is missing or unreadable or lacks the verdict, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-1242 | enriched | | SCN-plan-run-005 | step | the engine marks step start-steps (tool) of plan-run ready | the step completes with exactly one outcome under the run envelope, StepReady is emitted once for each root step of the plan, and the run completes with plan as its output, WorkflowRunCompleted emitted once and Run Control recording Completed exactly once | an attempt settles Failed with any failure class or exceeds its timeout PT1M (failure policy Fail, none, 0 attempts) | AIFACTORY-US-1243 | enriched |

preview-environment

Workflow definition; placed in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-preview-environment-001 | step | the engine marks step resolve-change (agent) of preview-environment ready | the output change-set (artifact-v1) with the buildable change set and the touched modules is recorded once under the run envelope with exactly one attempt outcome, and approve-preview becomes ready with it as its proposal | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1187 | enriched | | SCN-preview-environment-002 | step | the engine marks step approve-preview (human) of preview-environment ready | an approving ApprovalDecided bound to that hash completes the step with exactly one outcome under the run envelope and request-preview becomes ready; a regenerated change set makes the pending request Stale | the decision rejects the preview, the request expires and the on-expiry rule of the pinned policy revision leaves no re-request, or the step exceeds its timeout P2D; a human step is never retried (failure_policy Fail) | AIFACTORY-US-1187 | enriched | | SCN-preview-environment-003 | step | the engine marks step request-preview (agent) of preview-environment ready | the output preview-environment (artifact-v1) with the identity and address of the environment is recorded once under the run envelope with exactly one attempt outcome, becomes the run output, and time-to-live is reached | an attempt settles Failed or exceeds its timeout PT30M; the definition declares an exponential retry budget of 3 attempts, but a Failed attempt of a shared-write step without an idempotency key is never retried (D113, D114); or an attempt settles Uncertain | AIFACTORY-US-1188 | enriched | | SCN-preview-environment-004 | step | the engine marks step time-to-live (timer) of preview-environment ready | when the timer is due TimerFired is emitted once, the projection returns to Running, the step completes with exactly one outcome under the run envelope and teardown becomes ready; a timer that fires after its step already advanced is a no-op | the run is cancelled or failed by Run Control while it waits for the timer | AIFACTORY-US-1189 | enriched | | SCN-preview-environment-005 | step | the engine marks step teardown (compensation) of preview-environment ready | the step completes with exactly one outcome under the run envelope, the run completes with preview-environment as its output, WorkflowRunCompleted is emitted once and Run Control records exactly one Completed outcome (ADR-0014) | attempts settle Failed with failure class transient until the retry budget (fixed, 3 attempts, backoff 10s) is exhausted, an attempt fails with any other failure class, or the step exceeds its timeout PT30M | AIFACTORY-US-1189 | enriched |

product-plan

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-product-plan-001 | step | the engine marks step derive-features (agent) of product-plan ready | the outputs feature-hierarchy (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-product-plan-002 | step | the engine marks step scope-editions (agent) of product-plan ready | the outputs editions (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-product-plan-003 | step | the engine marks step dependency-view (agent) of product-plan ready | the outputs dependency-view (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-product-plan-004 | step | the engine marks step store-artifacts (agent) of product-plan ready | the outputs product-plan (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived |

project-bootstrap

Workflow definition; placed in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-project-bootstrap-001 | step | the engine marks step plan-bootstrap (agent) of project-bootstrap ready | the output bootstrap-plan (artifact-v1) naming every repository, pipeline definition and board, with lineage to the project scope, is recorded once under the run envelope with exactly one attempt outcome, and scaffold-resources becomes ready with it mapped as bootstrap-plan; nothing is created in the system of record | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1181 | enriched | | SCN-project-bootstrap-002 | step | the engine marks step scaffold-resources (agent) of project-bootstrap ready | the output change-set (change-set-v1) with its diff reference and hash, holding a scaffold for every planned resource, is recorded once under the run envelope with exactly one attempt outcome, and approve-shared-write becomes ready with that change set as its proposal; nothing is written to the system of record | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1181 | enriched | | SCN-project-bootstrap-003 | step | the engine marks step approve-shared-write (human) of project-bootstrap ready | an approving ApprovalDecided bound to that hash completes the step with exactly one outcome under the run envelope and apply-bootstrap becomes ready; a regenerated change set makes the pending request Stale and it never advances the run | the decision rejects the change set, the request expires and the on-expiry rule of the pinned policy revision leaves no re-request, or the step exceeds its timeout P7D; a human step is never retried (failure_policy Fail) | AIFACTORY-US-1182 | enriched | | SCN-project-bootstrap-004 | step | the engine marks step apply-bootstrap (tool) of project-bootstrap ready | the proposal is recorded once in PullRequestOpen; the output bootstrap-change-proposal (pull-request-proposal-v1) is recorded once under the run envelope with exactly one attempt outcome, and record-trace becomes ready with it mapped | an attempt settles Failed or exceeds its timeout PT30M; the definition declares a fixed retry budget of 2 attempts, but a Failed attempt of a shared-write step without an idempotency key is never retried (D113, D114); or an attempt settles Uncertain | AIFACTORY-US-1182 | enriched | | SCN-project-bootstrap-005 | step | the engine marks step record-trace (agent) of project-bootstrap ready | the output trace-scaffolding (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome; the run completes with bootstrap-change-proposal and trace-scaffolding as its outputs, WorkflowRunCompleted is emitted once and Run Control records exactly one Completed outcome (ADR-0014) | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the declared retry budget (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1183 | enriched |

release

Workflow definition; placed in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-release-001 | step | the engine marks step verify-readiness (agent) of release ready | the output readiness (artifact-v1) with the verdict over those four checks and its member passed is recorded once under the run envelope with exactly one attempt outcome, and the condition check-readiness becomes ready over it; a negative verdict stops the release there (D133) | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1190 | enriched | | SCN-release-007 | step | the engine marks step check-readiness (condition) of release ready | on passed true the step completes with exactly one outcome recorded under the run envelope and promote-staging becomes ready; on passed false the release stops here, WorkflowRunFailed names check-readiness with the readiness verdict as evidence, RunFailed follows once, promote-staging never becomes ready and nothing is promoted (D133) | the verdict is missing or unreadable, or the evaluation exceeds its timeout PT1M; a condition is never retried | AIFACTORY-US-1190 | enriched | | SCN-release-002 | step | the engine marks step promote-staging (agent) of release ready | the output staging-promotion (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, and bake becomes ready | attempts settle Failed with failure class transient until the retry budget of the declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted, which holds for this shared-write step because it declares an idempotency key (D114); an attempt settles Failed with any other failure class or exceeds PT30M; or an attempt settles Uncertain | AIFACTORY-US-1190 | enriched | | SCN-release-003 | step | the engine marks step bake (timer) of release ready | when the window is due TimerFired is emitted once, the projection returns to Running, the step completes with exactly one outcome under the run envelope and only then does promote-production become ready (D139); a timer that fires after its step already advanced is a no-op | a guard is breached during the bake window; or the run is cancelled or failed by Run Control while it waits for the bake window | AIFACTORY-US-1191 | enriched | | SCN-release-005 | step | the engine marks step promote-production (agent) of release ready | one production promotion is requested and PromotionRequested names the run; no second production approval is requested; the output production-promotion (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, and approve-production becomes ready to wait on the gate | an attempt settles Failed or exceeds its timeout PT30M, which is never retried; or an attempt settles Uncertain | AIFACTORY-US-1192 | enriched | | SCN-release-004 | step | the engine marks step approve-production (human) of release ready | an approving ApprovalDecided that names the gate for the release id and the production environment completes the step with exactly one outcome under the run envelope, EnvironmentPromotionService hands the promotion off through PromotionApproved and verify becomes ready; no second production approval is requested | the decision rejects the gate, the request expires and the on-expiry rule of the pinned policy revision leaves no re-request, or the step exceeds its timeout P7D; a human step is never retried (failure_policy Fail) | AIFACTORY-US-1192 | enriched | | SCN-release-006 | step | the engine marks step verify (agent) of release ready | the output promotion-evidence (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome; the run completes with it as its output, WorkflowRunCompleted is emitted once and Run Control records exactly one Completed outcome (ADR-0014) | the verification fails, which is a failure class other than transient and is never retried, the step exceeds its timeout PT30M, or attempts settle Failed with failure class transient until the declared retry budget (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1193 | enriched |

requirements-alignment

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-requirements-alignment-001 | step | the engine marks step elicit-requirements (agent) of requirements-alignment ready | the outputs requirements (requirements-v1), business-rules (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-requirements-alignment-002 | step | the engine marks step refine-backlog (agent) of requirements-alignment ready | the outputs backlog (backlog-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-requirements-alignment-003 | step | the engine marks step draft-alignment-memo (agent) of requirements-alignment ready | the outputs alignment-memo (alignment-memo-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-requirements-alignment-004 | step | the engine marks step approve-memo (human) of requirements-alignment ready | the step completes with exactly one outcome recorded under the run envelope | the step exceeds its timeout P7D or its retry policy (none, 0 attempts) is exhausted | — | derived |

saga-design

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-saga-design-001 | step | the engine marks step identify-flows (agent) of saga-design ready | the outputs flows (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-saga-design-002 | step | the engine marks step design-compensation (agent) of saga-design ready | the outputs compensations (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-saga-design-003 | step | the engine marks step draft-definitions (agent) of saga-design ready | the outputs workflow-definitions (workflow-definition-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-saga-design-004 | step | the engine marks step validate (condition) of saga-design ready | the step completes with exactly one outcome recorded under the run envelope | the step exceeds its timeout PT2M or its retry policy (none, 0 attempts) is exhausted | — | derived |

security-blueprint

Workflow definition; placed in I2. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-security-blueprint-001 | step | the engine marks step model-threats (agent) of security-blueprint ready | the output threat-model (artifact-v1) covering every bounded context of the Service Blueprint is recorded once under the run envelope with exactly one attempt outcome, and draft-security-blueprint becomes ready with it mapped as threat-model | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1194 | enriched | | SCN-security-blueprint-002 | step | the engine marks step draft-security-blueprint (agent) of security-blueprint ready | the output security-blueprint-draft (blueprint-security-v1), mapping every modelled threat to a control and every operation to a scope and a role, is recorded once under the run envelope with exactly one attempt outcome, and submit-version becomes ready with it mapped as document | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-1194 | enriched | | SCN-security-blueprint-003 | step | the engine marks step submit-version (tool) of security-blueprint ready | the output version-ref (blueprint-version-ref-v1 with blueprintId, version, kind Security, documentHash and state Draft) is recorded once under the run envelope, the audit record carries blueprintId, version, kind and documentHash, and validate becomes ready | the attempt settles Failed with failure class transient and the retry budget of the declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the attempt settles Failed with any other failure class (BlueprintService refused the document); or the attempt settles Uncertain (timeout PT2M after the call was dispatched, no receipt); or the gating approval is rejected or expires | AIFACTORY-US-1195 | enriched | | SCN-security-blueprint-004 | step | the engine marks step validate (tool) of security-blueprint ready | the output validation-receipt (blueprint-validation-receipt-v1 with passed, documentHash, findings and validationReportRef) is recorded once under the run envelope whether validation passed or not; BlueprintService moves the version from Draft to Validated when it records ValidationPassed for that exact document hash, leaves it Draft when the receipt fails, and emits BlueprintValidated with passed true or false; the step succeeds in both cases and check-valid becomes ready | the step exceeds its timeout PT5M, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the version reference belongs to another tenant; a receipt with passed false is not a failure of this step | AIFACTORY-US-1195 | enriched | | SCN-security-blueprint-005 | step | the engine marks step check-valid (condition) of security-blueprint ready | when the condition holds the step completes with exactly one outcome and, being the last step, the run completes with the passing draft as security-blueprint and its receipt as validation-receipt, WorkflowRunCompleted is emitted once and Run Control records exactly one Completed outcome (ADR-0014); when it does not hold the engine takes the on_false branch to draft-security-blueprint with the receipt as feedback (the outcome scenario of this step) | the receipt is missing or unreadable, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-1196 | enriched | | SCN-security-blueprint-006 | outcome | the condition check-valid of security-blueprint evaluates false | draft-security-blueprint, submit-version and validate re-run in order with the findings as feedback; the revised document gets its own Draft version and its own receipt, and the iteration count on the run rises by one | the receipt is still passed false after the second iteration (max_iterations 2 reached) | AIFACTORY-US-1196 | enriched |

sprint-execution

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-sprint-execution-001 | step | the engine marks step load-plan (agent) of sprint-execution ready | the outputs items (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-sprint-execution-002 | step | the engine marks step run-item (sub-workflow) of sprint-execution ready | the outputs item-outcomes (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout P14D or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-sprint-execution-003 | step | the engine marks step review-item (agent) of sprint-execution ready | the outputs acceptance (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (fixed, 2 attempts) is exhausted | — | derived | | SCN-sprint-execution-004 | step | the engine marks step close-sprint (agent) of sprint-execution ready | the outputs sprint-evidence (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived |

test-plan

Workflow definition; placed in I4. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-test-plan-001 | step | the engine marks step derive-scenarios (agent) of test-plan ready | the output scenarios (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, and coverage-matrix becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1238 | enriched | | SCN-test-plan-002 | step | the engine marks step coverage-matrix (agent) of test-plan ready | the output coverage-matrix (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, and draft-test-blueprint becomes ready | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1238 | enriched | | SCN-test-plan-003 | step | the engine marks step draft-test-blueprint (agent) of test-plan ready | the output test-blueprint-draft (blueprint-test-v1) is recorded once under the run envelope with exactly one attempt outcome, and submit-version becomes ready with it mapped as document | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is spent | AIFACTORY-US-1238 | enriched | | SCN-test-plan-004 | step | the engine marks step submit-version (tool) of test-plan ready | the output version-ref (blueprint-version-ref-v1 with blueprintId, version, kind, documentHash and state Draft) is recorded once under the run envelope, the audit record carries blueprintId, version, kind and documentHash, and validate becomes ready | the attempt settles Failed with failure class transient and the retry budget of the declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is spent; or the attempt settles Failed with any other failure class; or the attempt settles Uncertain (timeout PT2M after the call was dispatched, no receipt); or the gating approval is rejected or expires | AIFACTORY-US-1239 | enriched | | SCN-test-plan-005 | step | the engine marks step validate (tool) of test-plan ready | the output validation-receipt (blueprint-validation-receipt-v1) is recorded once under the run envelope whether validation passed or not; BlueprintService itself moves the version from Draft to Validated when it records ValidationPassed for that exact document hash and leaves it Draft when the receipt fails, and emits BlueprintValidated with passed true or false; the step succeeds in both cases and check-valid becomes ready | the step exceeds its timeout PT5M, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is spent; or the version reference belongs to another tenant; a receipt with passed false is not a failure of this step | AIFACTORY-US-1239 | enriched | | SCN-test-plan-006 | step | the engine marks step check-valid (condition) of test-plan ready | when the condition holds the step completes with exactly one outcome, the run completes with the run output test-blueprint bound to the validated BlueprintVersion that steps.submit-version.version-ref of the passing iteration names and validation-receipt bound to its receipt (D133), WorkflowRunCompleted is emitted once and Run Control records Completed exactly once; when it does not hold the engine takes the on_false branch to draft-test-blueprint with the receipt as feedback (the outcome scenario of this step) | the receipt is missing or unreadable, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-1240 | enriched | | SCN-test-plan-007 | outcome | the condition check-valid of test-plan evaluates false | draft-test-blueprint, submit-version and validate re-run in order with the findings as feedback; the revised document gets its own Draft version and its own receipt, and the iteration count on the run rises by one | the receipt is still passed false after the second iteration (max_iterations 2 reached) | AIFACTORY-US-1240 | enriched |

ux-blueprint

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ux-blueprint-001 | step | the engine marks step map-journeys (agent) of ux-blueprint ready | the outputs journeys-draft (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-ux-blueprint-002 | step | the engine marks step draft-ux-blueprint (agent) of ux-blueprint ready | the outputs ux-blueprint-draft (blueprint-ux-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT45M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-ux-blueprint-003 | step | the engine marks step submit-version (tool) of ux-blueprint ready | the outputs version-ref (blueprint-version-ref-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT2M or its retry policy (fixed, 2 attempts) is exhausted | — | derived | | SCN-ux-blueprint-004 | step | the engine marks step validate (tool) of ux-blueprint ready | the outputs validation-receipt (blueprint-validation-receipt-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT5M or its retry policy (fixed, 2 attempts) is exhausted | — | derived | | SCN-ux-blueprint-005 | step | the engine marks step check-valid (condition) of ux-blueprint ready | the step completes with exactly one outcome recorded under the run envelope | the step exceeds its timeout PT1M or its retry policy (none, 0 attempts) is exhausted | — | derived | | SCN-ux-blueprint-006 | outcome | the condition check-valid of ux-blueprint evaluates false | the target step re-runs with the findings as feedback and the iteration is counted on the run | the iteration limit is reached | — | derived | | SCN-ux-blueprint-007 | step | the engine marks step coverage-matrix (agent) of ux-blueprint ready | the outputs coverage-matrix (ux-coverage-matrix-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-ux-blueprint-008 | step | the engine marks step check-coverage (condition) of ux-blueprint ready | the step completes with exactly one outcome recorded under the run envelope | the step exceeds its timeout PT1M or its retry policy (none, 0 attempts) is exhausted | — | derived | | SCN-ux-blueprint-009 | outcome | the condition check-coverage of ux-blueprint evaluates false | the target step re-runs with the findings as feedback and the iteration is counted on the run | the iteration limit is reached | — | derived | | SCN-ux-blueprint-010 | step | the engine marks step handoff-pack (agent) of ux-blueprint ready | the outputs handoff-pack (ux-handoff-pack-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived |

ux-discovery

Workflow definition; placed in I6. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-ux-discovery-001 | step | the engine marks step synthesize-research (agent) of ux-discovery ready | the outputs research-insights (research-insights-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-ux-discovery-002 | step | the engine marks step extract-actors (agent) of ux-discovery ready | the outputs actors (artifact-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-ux-discovery-003 | step | the engine marks step build-personas (agent) of ux-discovery ready | the outputs personas (personas-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived | | SCN-ux-discovery-004 | step | the engine marks step seed-journeys (agent) of ux-discovery ready | the outputs journey-seeds (journey-seeds-v1), hypotheses (ux-hypotheses-v1) are recorded once as artifacts under the run envelope | the step exceeds its timeout PT30M or its retry policy (exponential, 3 attempts) is exhausted | — | derived |

vision-to-blueprint

Workflow definition; placed in I1. | Id | Kind | Trigger | Then | Failure | Traced by | State | |---|---|---|---|---|---|---| | SCN-vision-to-blueprint-001 | step | the engine marks step clarify-intent (agent) of vision-to-blueprint ready | the output assumptions (artifact-v1) is recorded once under the run envelope with exactly one attempt outcome, and draft-vision becomes ready with that artifact mapped as its assumptions input | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-181 | enriched | | SCN-vision-to-blueprint-002 | step | the engine marks step draft-vision (agent) of vision-to-blueprint ready | the output vision-blueprint-draft (blueprint-vision-v1) is recorded once under the run envelope with exactly one attempt outcome, and submit-version becomes ready with it mapped as document | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-181 | enriched | | SCN-vision-to-blueprint-003 | step | the engine marks step submit-version (tool) of vision-to-blueprint ready | the output version-ref (blueprint-version-ref-v1 with blueprintId, version, kind, documentHash and state Draft) is recorded once under the run envelope, the audit record carries blueprintId, version, kind and documentHash, and validate becomes ready | the attempt settles Failed with failure class transient (BlueprintService was unreachable before any effect) and the retry budget of the declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the attempt settles Failed with any other failure class (BlueprintService refused the document); or the attempt settles Uncertain (timeout PT2M after the call was dispatched, no receipt); or the gating approval is rejected or expires | AIFACTORY-US-182 | enriched | | SCN-vision-to-blueprint-004 | step | the engine marks step validate (tool) of vision-to-blueprint ready | the output validation-receipt (blueprint-validation-receipt-v1 with passed, documentHash, findings and validationReportRef) is recorded once under the run envelope whether validation passed or not; BlueprintService itself moves the version from Draft to Validated with validationReportRef set when it records ValidationPassed for that exact document hash and leaves it Draft when the receipt fails, and emits BlueprintValidated with passed true or false and the documentHash; the step succeeds in both cases and check-valid becomes ready | the step exceeds its timeout PT5M, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (fixed, 2 attempts, backoff 10s) is exhausted; or the version reference belongs to another tenant; a receipt with passed false is not a failure of this step | AIFACTORY-US-182 | enriched | | SCN-vision-to-blueprint-005 | step | the engine marks step check-valid (condition) of vision-to-blueprint ready | when the condition holds the step completes with exactly one outcome under the run envelope and store-artifacts becomes ready; when it does not hold the engine takes the on_false branch to draft-vision with the receipt as feedback (the outcome scenario of this step) | the receipt is missing or unreadable, or the evaluation exceeds its timeout PT1M (the condition is never retried, none, 0 attempts) | AIFACTORY-US-183 | enriched | | SCN-vision-to-blueprint-006 | outcome | the condition check-valid of vision-to-blueprint evaluates false | draft-vision, submit-version and validate re-run in order with the findings as feedback; the revised document gets its own Draft version and its own receipt, and the iteration count on the run rises by one | the receipt is still passed false after the second iteration (max_iterations 2 reached) | AIFACTORY-US-183 | enriched | | SCN-vision-to-blueprint-007 | step | the engine marks step store-artifacts (agent) of vision-to-blueprint ready | the output vision-blueprint (blueprint-vision-v1) is recorded once under the run envelope with exactly one new ArtifactStored, its lineage carrying an edge to the prompt (inputKind run-input, relation derived-from), to the assumptions artifact recorded by clarify-intent (inputKind artifact, relation derived-from, not stored again) and to the validation receipt (inputKind receipt, relation validated-by); the field validationRef of the stored Artifact references the validation of the validated version steps.submit-version.version-ref by the validationReportRef of the receipt, and no lineage edge is written for the version reference; the run completes with vision-blueprint and validation-receipt as its outputs, WorkflowRunCompleted is emitted once and Run Control records exactly one Completed outcome (ADR-0014); the validated version is not submitted for publication | the step exceeds its timeout PT30M, an attempt settles Failed with a failure class other than transient, which is never retried, or attempts settle Failed with failure class transient until the retry budget of its declared failure_policy Retry (exponential, 3 attempts, backoff 30s) is exhausted | AIFACTORY-US-184 | enriched |