docs(agent-data): accept the seven-command Data Brief P0 contract

[1012839419a-alt]

Parent: #130
Evidence: #137 / 6a6a646418b902195edd98ca880a8aae02390aa9 and the OpenAlice alignment research in the coordinator workspace.

Goal

Turn the data-Agent P0 recommendation into an accepted, implementation-ready platform contract before changing routing or persistence code.

Decisions to record

• Exactly seven P0 Agent commands: capabilities.list, source.readiness, collection.start, run.get (ordered events), records.query, analysis.brief.create, artifact.read.
• One versioned registry is authoritative for MCP first and Provider Chat second; preserve or explicitly version/migrate the five accepted workflow.* commands in ADR-0042.
• REST remains the internal/human domain API; no repository-wide route rewrite.
• analysis.brief.create produces an immutable internal Artifact only. The bundled finite-analysis plugin is optional to the kernel but enabled in the reference distribution; missing plugin is an explicit capability gap.
• P0 analysis is bounded to schema/profile, completeness/duplicate/type quality, extraction/summarization, grouping/comparison/sorting, time trends, and simple anomalies. No arbitrary SQL/notebooks, prediction/causal claims, automatic publishing, or external actions.
• Source Observation / Artifact Manifest extend existing lineage/evidence/artifact authority and preserve source URL/provider, config revision, observed/retrieved/source timestamps, window/limit/truncation, checked/excluded counts, hashes, project/workflow/run/node/tool/transform versions, errors/gaps, and claim ledger.
• Project/RBAC/Execution Grant/idempotency/proposal boundaries fail closed; untrusted content and secrets never enter public events/artifacts.

Execution contract

• Worktree: D:\projects\opencli-agent-data-contract-20260914
• Branch: codex/agent-data-contract-20260914
• Baseline: 6b7c69e0d7f1767d7101336cfeb68e869c772fdf
• Owned paths:
  • _bmad-output/implementation-artifacts/spec-gh-140-agent-data-p0-contract.md
  • docs/opencli-agent-data-operations-platform-PRD.md
  • docs/adr/0042-expose-capabilities-through-an-api-first-agent-loop.md
  • docs/adr/0014-datafoundry-backed-analysis-as-an-optional-plugin.md
• Documentation only; do not change code or tests.

Acceptance

Contract names schemas, compatibility/migration, success/partial/fail semantics, positive and negative acceptance, live canary evidence, and decomposes non-overlapping implementation slices. git diff --check passes and an independent reviewer can implement without inventing product behavior.

[1012839419a-alt]

Draft P0 contract revised and cross-reviewed. Commit: db200d6638760cfcc70004661e2a40d44bb68b0d. It preserves the five workflow commands and defines the seven new commands plus generic AIHOT exposure, then splits implementation into gated A-E slices with non-overlapping owned paths: registry/discovery; collection+ordered runs+Execution Grant; deterministic immutable Data Briefs; artifact/MCP parity; Provider Chat parity. Child Issue bodies are included. Status remains draft; no implementation has started pending approval.

[1012839419a-alt]

Human approval received in the Codex closeout thread on 2026-09-14: A / Approve. Approved scope is contract commit db200d66 and the A-E implementation slices/child-issue drafts it defines: registry/discovery; collection+ordered runs+Execution Grant; deterministic immutable Data Briefs; artifact/MCP parity; Provider Chat parity.