Activation Contract
Load when changing how any runtime (Claude Code, OpenCode, Codex, future) invokes an RDD reviewer, refuter, or fix validator, or when touching reviewer prompts, lens evidence, result schemas, adapters, or transport capability policy.
Hard Rules
- One Go provider contract owns binding, frozen evidence, lens mandate, prompt, result schema, byte budget, JSON extraction, and admission. Start from existing native sources (
reviewLensContextBlock, ReviewerResultSchema, RunReviewCaptureResult, CaptureAdmittedReviewerResult); never build a parallel system.
- Adapters only invoke the reviewer and return raw bytes plus a transport error. An adapter must never parse bindings, rebuild prompts, copy schemas, apply local budgets, parse JSON, capture or preserve results, hold retry state, or decide blocking.
- Runtime output is advisory: it cannot create authority, mutate review state, mint a receipt, or open a gate. Only Go admission does.
- Byte budget refuses before invocation; never truncate. Malformed, truncated, or incomplete input never becomes PASS, complete, or a clean receipt.
- No OpenCode restart, child isolation, special session, or
OPENCODE_DISABLE_* variables. An ordinary running session is sufficient.
- The RDD semantic pipeline is untouchable: lens selection, severity meanings, candidate causality, refuter adjudication, bounded correction, verification, terminal receipt, and read-only review-context evaluation. These are review-lifecycle concerns only; ordinary repository policy owns delivery.
- Refuter and fix validator consume the same provider contract. A validator that could not inspect produced no verdict — surface a blocked decision; never record it as failed (that irreversibly consumes the single correction).
- Capability advertisement requires shared-contract conformance plus organic runtime proof. Codex stays unadvertised until both positive and fail-closed proofs pass.
- Transport failures never consume a correction budget, duplicate a capture, or strand a lineage.
- Historical receipts stay readable; never rewrite
provider_command or runtime_interception descriptors.
Decision Gates
| Condition |
Action |
| Logic fits "prompt/evidence/schema/validation" |
It belongs in the Go contract, never an adapter. |
| Adapter cannot expose raw final output |
Runtime stays typed unavailable; no artifact-parser workaround. |
| Cutover slice exceeds 1000 lines/PR |
Chained PRs on the tracker; advertisement flip lands last. |
| Shared prompt changes any semantic outcome |
STOP; regression against baseline blocks the slice. |
Slice touches negotiated START / repository_context |
Coordinate with the deferred Wave 7 switch-removal finding first. |
Execution Steps
- Freeze the boundary: contract-level tests around current native prompt/evidence/schema/admission.
- Extract the Go provider contract; differential-test against current admission.
- Add adapter-minimality static guards (no binding types, prompt text, schema copies, budgets, parsers, capture, retry in adapters) — from the first adapter slice, not last.
- Cut Claude + OpenCode over without an advertised intermediate path; delete the OpenCode plugin and isolation machinery in the same release slice.
- Prove Codex organically before advertising; retire historical transport code last.
- Gate every slice on the bench journey corpus diff: all journeys unchanged.
Output Contract
Report per slice: contract surface touched, adapter minimality guard status, bench corpus diff result, semantic regression result, capability advertisement state, and any unresolved maintainer decision (e.g. receipt provider_contract descriptor).
References
references/shared-advisory-transport-proposal.md — full proposal: architecture, deletion candidates, test plan, risks.references/issue-impact-matrix.md — per-issue dispositions under the shared contract; a maintainer condition in an issue's own thread always outranks its row.
1---2name: rdd-advisory-transport3description: Trigger: reviewer transport, advisory transport, review adapter, lens prompt/schema, OpenCode reviewer plugin, Codex reviewer, ReviewProviderContract. Enforce the shared Go advisory reviewer transport contract.4license: Apache-2.05---6
7## Activation Contract
8
9Load when changing how any runtime (Claude Code, OpenCode, Codex, future) invokes an RDD reviewer, refuter, or fix validator, or when touching reviewer prompts, lens evidence, result schemas, adapters, or transport capability policy.
10
11## Hard Rules
12
13- One Go provider contract owns binding, frozen evidence, lens mandate, prompt, result schema, byte budget, JSON extraction, and admission. Start from existing native sources (`reviewLensContextBlock`, `ReviewerResultSchema`, `RunReviewCaptureResult`, `CaptureAdmittedReviewerResult`); never build a parallel system.
14- Adapters only invoke the reviewer and return raw bytes plus a transport error. An adapter must never parse bindings, rebuild prompts, copy schemas, apply local budgets, parse JSON, capture or preserve results, hold retry state, or decide blocking.
15- Runtime output is advisory: it cannot create authority, mutate review state, mint a receipt, or open a gate. Only Go admission does.
16- Byte budget refuses before invocation; never truncate. Malformed, truncated, or incomplete input never becomes PASS, complete, or a clean receipt.
17- No OpenCode restart, child isolation, special session, or `OPENCODE_DISABLE_*` variables. An ordinary running session is sufficient.
18- The RDD semantic pipeline is untouchable: lens selection, severity meanings, candidate causality, refuter adjudication, bounded correction, verification, terminal receipt, and read-only review-context evaluation. These are review-lifecycle concerns only; ordinary repository policy owns delivery.
19- Refuter and fix validator consume the same provider contract. A validator that could not inspect produced no verdict — surface a blocked decision; never record it as failed (that irreversibly consumes the single correction).
20- Capability advertisement requires shared-contract conformance plus organic runtime proof. Codex stays unadvertised until both positive and fail-closed proofs pass.
21- Transport failures never consume a correction budget, duplicate a capture, or strand a lineage.
22- Historical receipts stay readable; never rewrite `provider_command` or `runtime_interception` descriptors.
23
24## Decision Gates
25
26| Condition | Action |
27| --- | --- |
28| Logic fits "prompt/evidence/schema/validation" | It belongs in the Go contract, never an adapter. |
29| Adapter cannot expose raw final output | Runtime stays typed unavailable; no artifact-parser workaround. |
30| Cutover slice exceeds 1000 lines/PR | Chained PRs on the tracker; advertisement flip lands last. |
31| Shared prompt changes any semantic outcome | STOP; regression against baseline blocks the slice. |
32| Slice touches negotiated START / `repository_context` | Coordinate with the deferred Wave 7 switch-removal finding first. |
33
34## Execution Steps
35
361. Freeze the boundary: contract-level tests around current native prompt/evidence/schema/admission.
372. Extract the Go provider contract; differential-test against current admission.
383. Add adapter-minimality static guards (no binding types, prompt text, schema copies, budgets, parsers, capture, retry in adapters) — from the first adapter slice, not last.
394. Cut Claude + OpenCode over without an advertised intermediate path; delete the OpenCode plugin and isolation machinery in the same release slice.
405. Prove Codex organically before advertising; retire historical transport code last.
416. Gate every slice on the bench journey corpus diff: all journeys unchanged.
42
43## Output Contract
44
45Report per slice: contract surface touched, adapter minimality guard status, bench corpus diff result, semantic regression result, capability advertisement state, and any unresolved maintainer decision (e.g. receipt `provider_contract` descriptor).
46
47## References
48
49- `references/shared-advisory-transport-proposal.md` — full proposal: architecture, deletion candidates, test plan, risks.
50- `references/issue-impact-matrix.md` — per-issue dispositions under the shared contract; a maintainer condition in an issue's own thread always outranks its row.
gabrielmoreira