RFC 0004 — Approval surface v1

Purpose

Define what reviewers are approving in a stable way.

Fields (approval_surface_v1)

schema: "helix.approval.surface.v1"
canonicalization_id: "json.c14n.v1"

bundle_core_digest: "sha256:…"
policy_digest: "sha256:…"
decision_summary_digest: "sha256:…"  # digest of a normalized decision JSON extracted from bundle
backend_fingerprint_digest: "sha256:…"

receipts_seen:
  run_receipt_digest: "sha256:…"

render_hints:
  ui_version: string

Approval surface digest definition

sha256 over canonical JSON bytes of approval_surface_v1.

Reference schema

• schemas/hub/approval_surface_v1.schema.json
• src/helix/schema/hub/approval_surface_v1.schema.json