ContractSpec docs

OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

Decide a Special Ops review card

Record a human approve/reject decision on a submitted Special Ops review card; tenant- and workspace-scoped, idempotent, audit-emitting.

field.key.label
Decide a Special Ops review card
field.version.label
field.type.label
field.title.label
Decide a Special Ops review card
field.description.label

Record a human approve/reject decision on a submitted Special Ops review card; tenant- and workspace-scoped, idempotent, audit-emitting.

field.tags.label
special-ops,review-card,decide,mutation
field.owners.label
field.stability.label
internal

Records a human review decision (`approved` ∨ `rejected`) on a previously submitted Special Ops review card. Governs the already-shipped `decideReviewCard` repository handler in `api-application-monolith`; authored here (Managed CompanyOS production contracts surface) rather than the `packages/examples/special-ops-cockpit` fixture, which stays a pure demo.

Scope: tenant- and workspace-scoped. The handler resolves the actor session to an access scope and refuses cross-scope mutation (`TENANT_MISMATCH`). Decision is human-only — this is the anti-surveillance human-review boundary, not an automated transition.

Idempotency: `idempotencyKey` is required. Replays return the original result with `idempotentReplay = true`; the underlying evidence receipt is preserved.

Audit: every decision is intended to emit a `managed_companyos_audit_events` row (see `sideEffects.audit`) distinct from the in-memory evidence receipt.

Compatibility intent: **additive** (new operation key, no change to existing contracts).