← CRD inventorySource 1ea8b8ea8b01
Capability Requirements Document · synchronize-agent-definition-to-runtime

Synchronize an agent definition to runtime

Reconcile a selected canonical agent-definition version with one or more declared runtime targets and preserve verifiable synchronization state.

Status
draft
Version
0.1
Architecture alignment
directly aligned
Adoption
proposed
Known public realizations
none confirmed
Evidence basis
no relevant restricted realization confirmed

Availability: unknown

Inventory note: Runtime copies are not canonical truth.

Core meaning

Capability purpose
Keep deployed agent behavior traceable to canonical owner-governed definitions without treating runtime copies as primary truth.
Meaningful outcome
Each target runtime has a current, pending, failed, intentionally divergent, or rolled-back synchronization result linked to exact source and deployed versions.
Boundaries — includes
source definition version, target runtime identity, rendered artifacts, compatibility checks, planned differences, deployment, verification, failure, retry, rollback, status, and evidence.
Boundaries — excludes
authoring the definition, operating the runtime, changing owner memory, granting permissions outside the definition process, and deploying unrelated application code.
Terms and concepts
A runtime target is the process, machine, provider, service, or configuration surface that consumes an agent definition; it is not the canonical definition itself.

Interaction Contract MLEs

Synchronize one definition version

Actor
An authorized coordinator, deployment process, or owner.
Command / intent
Apply a canonical agent-definition version to declared runtime targets.
Current state
The approved source version, target identities, current deployed versions, expected transformations, compatibility state, and authority are known.
Policies / invariants
Source remains canonical; generated or adapted copies identify their source version and transformation; secrets are referenced rather than copied into portable definitions; partial failure is explicit; successful write without verification is not reported as current; rollback target is retained.
Transition
Compare source and target state, render or transfer approved artifacts, apply them, verify the effective version, and record per-target results or rollback.
Result
Verified current, pending, failed, intentionally different, or rolled-back synchronization state for each target.
Events / effects
May update owner-facing agent status or block incompatible runtime activation without modifying the source definition.
Unknowns
Universal rendering, signing, secret-binding, compatibility, and runtime-verification protocols are not established.

Rules and defaults

Rules / invariants

Unknown / unresolved

Statement provenance

StatementSemantic classEvidence statusSource / note
Canonical agent definitions and runtime copies are separate, and synchronization requires explicit target, version, state, history, and rollback evidence.rule/invariantsourcedJ03–J04.
Canonical source ↗All CRDs