wire_integration

Flip a registered consumer repo’s .petrova/contract.yaml integration block from pending (or failing) to wired, with a validated evidence object. Generic over integration: ARES, TRACEO, CRUMB, ROCKY, EVA. The evidence schema is enforced per integration (mirrors contracts/contract.schema.json’s integration_ sub-schemas). Refuses to wire an integration that is already wired (use a new verb for re-wiring or evidence updates). Requires a ratifying decision doc at the cited path; that ADR is the human accountability anchor.

Upholds: MR-7 · MR-13 Side effects: Creates a branch petrova/wire-/ in target_repo. Modifies .petrova/contract.yaml (status flip + evidence block). Opens a PR.

Constraints

REPO_IN_REGISTRY — target_repo must appear in registry.yaml.
CONTRACT_EXISTS — .petrova/contract.yaml must exist at target_repo’s default branch (run petrova_onboard first if missing).
INTEGRATION_CURRENTLY_PENDING — integration’s current status in the contract must be pending or failing. Refuses re-wires of wired integrations.
INTEGRATION_APPLICABILITY_NOT_NA — registry.yaml integrations_applicability[] must not be not_applicable for this slug.
DECISION_DOC_EXISTS — ratifying_decision_doc_path must resolve to a markdown file in target_repo’s default branch.
EVIDENCE_VALIDATES — evidence object must satisfy the integration’s evidence sub-schema in contracts/contract.schema.json (e.g. ARES requires org_or_repo_scope; TRACEO requires baseline_id + vtm_path).
FLEETS_ALLOWED_EMPTY — Standard policy gate; human override via PETROVA_ALLOW_HUMAN_OVERRIDE=1.

Input shape

integration string (required) enum: ares, traceo, crumb, rocky, eva — Which integration block to flip.
ratifying_decision_doc_path string (required) — Path to the ADR that authorises this wire transition, in the target repo. Must exist at the default branch when the verb runs.
evidence object (required) — Integration-specific evidence block. Validated per-integration by the verb at apply time against contracts/contract.schema.json’s integration_.evidence sub-schema. ARES requires org_or_repo_scope; TRACEO requires baseline_id + vtm_path; others mirror their respective contract sub-schemas.

Output shape

integration string
prior_status string
new_status string
pr → PRRef
diff_preview → DiffPreview

Example

Input:

{
  "envelope": {
    "verb": "wire_integration",
    "target_repo": "skyflow-hq",
    "idempotency_key": "abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789",
    "dry_run": true,
    "actor": "human:alex@devarno.com",
    "triggered_by": {
      "kind": "human_request",
      "ref": "petrova-codes:baseline-v4-s4-ares-wire"
    }
  },
  "params": {
    "integration": "ares",
    "ratifying_decision_doc_path": "docs/decisions/2026-05-13-wire-ares.md",
    "evidence": {
      "org_or_repo_scope": "org",
      "org_webhook_id": "610141828",
      "ingest_endpoint": "https://ares.devarno.cloud/ingest"
    }
  }
}

Output (n/a):

(none)

Recipe