Add DDD skill-domain contracts, hook lease inventory, replacement ports, artifact-first RPI skill boundaries, and release exact-SHA validation. Demote ao inject to a compatibility adapter and remove prompt-only default hooks.
7.1 KiB
Contracts
Every inter-component boundary in AgentOps is a contract — a versioned, validatable interchange format. These are the interchange files used between skills, the runtime, and external integrations.
-
:material-play-box: Repo Execution Profile
Repo-local bootstrap, validation, tracker, and done-criteria contract for autonomous orchestration.
-
:material-robot: Autodev Program
Repo-local operational contract for bounded autonomous development.
-
:material-database: RPI Run Registry
RPI run registry specification.
-
:material-server: AgentOps Daemon
Architecture boundary for
agentopsd, the daemon ledger, job queue, local trust, projections, and migration from foreground command flows. -
:material-factory: AgentOpsd Control Plane
Production control-plane contract for worker slots, worktree ownership, lifecycle telemetry, validation gates, yield, and operator status.
-
:material-shield-check: Factory Admission
Daemon-owned work-order admission contract for fail-closed local factory pilots and RPI handoff.
-
:material-routes: Routing Policy
Schema-backed model/provider/runtime lane policy, authority levels, and milestone-1 GasCity / Mt. Olympus production-routing guardrails.
-
:material-chart-timeline-variant: Factory Yield Ledger
Baseline/treatment yield observations correlated to routing, validation, manual merge decisions, cost, latency, defects, and artifacts.
-
:material-shield-search: Factory Claim Ledger
Machine-readable posture ledger tying public software-factory claims to evidence level, owner issue, closure gate, and anti-overclaim wording.
-
:material-lock-check: Daemon Idempotency
Submit retry contract for
request_id,idempotency_key, and daemon-submitting CLI helpers. -
:material-file-code: JobSpec OpenAPI v0
Machine-readable OpenAPI contract for the current
agentopsdjob, readiness, ledger replay, projection, and OpenClaw consumer HTTP surface. -
:material-api: GasCity Integration
Public GasCity API/SSE boundary, mutation headers, request IDs, readiness, replay, versioning, and adapter rules.
-
:material-lan-connect: Remote Compute
Product-neutral RemoteTarget, RemoteSession, command ledger, recovery, and GasCity-first remote execution contract.
-
:material-robot-outline: AgentWorker Runtime
Headless Claude/Codex worker session lifecycle contract consumed by wiki/forge and future daemon jobs.
-
:material-application-braces-outline: OpenClaw Consumer API
Read-only projection resources, snapshot versions, mutation gates, and
.agentsnon-ownership rules for OpenClaw clients. -
:material-clipboard-pulse: Eval Environment
Evaluation suite, run, scorecard, baseline, canary, and holdout contract.
-
:material-clipboard-text-clock: Eval Verdict Pipeline
Verdict compiler pipeline from eval run manifests to learning utility and retirement signals.
-
:material-magnify-scan: Retrieval Comparison
Deterministic search-eval backend comparison, promotion thresholds, optional rerank behavior, and deferred vector/graph-store policy.
-
:material-clipboard-check-outline: Release Readiness
8/10 release readiness score, SIL/VIL/HIL evidence, artifact manifest requirements, and HIL waiver policy.
-
:material-brain: MemRL Policy Schema
Deterministic retry/escalation policy profile for memory-reinforcement feedback loops.
-
:material-format-list-numbered: Next-Work Queue
Contract for
.agents/rpi/next-work.jsonl. -
:material-magnify: Finding Registry
Canonical intake-ledger contract for reusable findings.
-
:material-hammer-wrench: Finding Compiler
V2 promotion ladder, executable constraint index, and lifecycle rules.
-
:material-hook: Hook Runtime Contract
Canonical event mapping across Claude, Codex, and manual runtimes.
-
:material-tag-check: Hook Lease Inventory
AgentOps 3.0 hook disposition inventory generated from the live hook manifest.
-
:material-console: Headless Invocation Standards
Required flags, tool allowlists, and timeout strategy for non-interactive Claude/Codex execution.
-
:material-api: Codex Skill API
Source of truth for Codex runtime skill structure, frontmatter, discovery paths, and multi-agent primitives.
-
:material-cube-outline: Context Assembly Interface
Interface contract for adaptive context assembly and token budgeting.
-
:material-vector-polyline: Skill Domain Map
V0 DDD map assigning every shared skill to one primary skill domain with ports, artifacts, and adapters.
-
:material-call-split: Skill Ports and Adapters
V0 skill-boundary vocabulary for inbound ports, outbound ports, adapters, context packets, and guard surfaces.
-
:material-clipboard-check-outline: Skill Lease Audit
V0 lease-on-life audit classifying every shared skill as keep, merge, split, retire, or unknown before any cut is attempted.
-
:material-shield-star: Session Intelligence Trust Model
Artifact eligibility contract for runtime context assembly.
-
:material-moon-waning-crescent: Dream Run
Process model, generator authoring, locking, keep-awake, and artifact floor for private overnight runs.
-
:material-file-chart: Dream Report
Canonical
summary.jsonandsummary.mdschema for Dream outputs. -
:material-alert-octagon: Scope Escape Report
Structured template for agent scope-escape reporting.
-
:material-clipboard-check: Dispatch Checklist
Standard references for agent dispatch prompts.
-
:material-account-multiple-check: Swarm Evidence
Permissive shape covering all historical swarm result files.