# Evaluator-Ready Artifact

**Template owner:** Epistemic Output Layer (S4). **Library:** Private RAM. **Emit:** bridge/ram-to-evaluator-handoff/.

This is the final artifact skeleton. Sections appear in this order. The three-axis block per claim, the Surprise Register section, and the Search Ledger section are ALL required. Validation at Phase E rejects any emit missing a section or containing a collapsed axis.

---

## Header

- **run_id:** `<string>`
- **question_id:** `<string>`
- **question_text:** `<string>`
- **decision_context_descriptor:** `<string or axis-not-computable reason>`
- **invoked_disciplines:** `[systematic-review | scoping-review | realist-review | content-analysis | qualitative-synthesis | secondary-data-analysis | competitive-intelligence | comparative-analysis | discourse-analysis | historiography | research-auditor, ...]`
- **warrant_rationale:** `<string, from Warrant & Saturation Governor>`
- **stopping_reason:** `<warrant-met | saturation | nothing-found-after-expand | charter-bound | escalated>`
- **artifact_tag:** `evaluator-ready=true`
- **emit_timestamp_utc:** `<ISO-8601>`
- **component_versions:** `{S1: ..., S2: ..., S3: ..., S4: ..., S5: ..., S6: ..., S7: ..., S8: ...}`
- **packet_checksums:** `{orchestrator_packet: sha256, surprise_register: sha256, search_ledger: sha256}`

---

## Claim Decomposition (from Claim-Typing Engine)

- Decomposition tree (as S5 emitted). Each claim node shows `claim_id`, `claim_text`, `claim_type`, `decomposition_parent`.

---

## Per-Claim Blocks

For EVERY claim, render this block. Axes in canonical order. No collapse.

### Claim <claim_id>: <claim_text>

- **claim_type:** `<descriptive | causal | predictive | normative | interpretive>`
- **decomposition_parent:** `<claim_id or root>`

#### Axis 1 -- Evidence
- **strength_band:** `<weak | moderate | strong | defensible-null>`
- **supporting_source_count:** `<integer>`
- **independent_method_count:** `<integer>`
- **contradiction_record:** `[ { source_ref, contradiction_text, pass_id }, ... ]`
- **fitness_distribution:** `{ min, median, max }`
- **rationale:** `<string>`

#### Axis 2 -- Transportability
- **slot:** `<sampling_representativeness | mechanism_context_coupling | covariate_shift_and_mechanism | value_commensurability | reader_relevance_proxy>`
- **score:** `<low | moderate | high | axis-not-computable>`
- **rationale:** `<slot-grounded string>`
- **subscores:** `{ ... claim-type-specific; PIET-T or CERQual as applicable ... }`
- **type_coded_caveat:** `<value-commensurability-required | reader-judgment-required | null>`   **// inline; NEVER footnote**
- **reason (if axis-not-computable):** `<string>`

#### Axis 3 -- Decision
- **band:** `<act-on | act-with-caveat | hold | seek-more-evidence | defensible-null>`
- **dominant_constraint:** `<evidence | transportability | both | none>`
- **rationale:** `<multi-sentence string; Register entries may EXPAND but MUST NOT tiebreak>`
- **action_caveats:** `[ string, ... ]`
- **register_bindings:** `[ anomaly_id, ... ]`

#### Methodology trace (per claim or per discipline, inherited from invoked discipline skeleton)
- Per invoked discipline: method tag, corpora consulted, method-specific findings structure (preserved from native skeleton per `DISCIPLINE_SKELETON_OVERLAY.md`).

---

## Surprise Register Section (TOP-LEVEL)

Every anomaly entry. Grouped by binding:
- **Claim-bound anomalies:** entries whose `claim_id` is non-null. Each entry renders with:
  - `anomaly_id`, `entry_kind` (anomaly|contradiction|meta-anomaly|charter-amendment-request), `writer_component`, `write_timestamp_utc`, `source_refs`, `description`, `provenance.rationale`, `expansion_directive`, `downstream_effect`.
- **Unbound anomalies:** entries with `claim_id: null`. Rendered with `unbound-anomaly` flag plus same fields.

If the register is empty, render: "No anomalies surfaced this run." Absence-of-evidence is logged, not hidden.

This section is a top-level block, NEVER a footnote. Register entries EXPAND inquiry; they do NOT adjudicate the decision axis (E4).

---

## Search Ledger Section (TOP-LEVEL; S4 RENDER AUTHORITY)

Every record, all four kinds. See `references/RAM_SEARCH_LEDGER_RENDER_SPEC.md` for layout.

### Queries (every-query)
Per entry: `query_id | writer | pass | corpus_target | timestamp_utc | claim_id | query_text | rationale`.

### Accepted sources (every-accepted)
Per entry: `source_id | query_id | fitness_verdict_ref | integrity_verdict_ref | admiralty_input | claim_id | timestamp_utc`.

### Rejected sources (every-rejected)
Per entry: `source_id | query_id | rejection_reason | reviewer_flag | timestamp_utc`.

### Skipped avenues (every-skipped)
Per entry: `avenue | skip_reason | claim_id | writer | timestamp_utc`.

No summarization. No collapsing. No dropping for brevity (E3).

---

## Degraded-Mode Section (only if triggered)

If any writer failed, any axis was `axis-not-computable`, any register incident occurred, or any error class fired during this run: render a Degraded-Mode section enumerating:
- Error class triggered (E1 ... E8 from SKILL.md Section 4).
- Component that emitted the failure.
- Remediation attempted.
- Whether artifact is `output-defect-blocking-emit` flagged on any claim.

---

## Reopen-Ready Metadata

- **component_versions** (repeated from header for audit integrity).
- **packet_checksums** (repeated).
- **decision_context_descriptor** (repeated).
- **register_id**, **ledger_id** back-references to state paths for Evaluator audit hooks (read-only from Evaluator side).

---

## Validation Checklist (Phase E; MUST pass before emit)

- [ ] Every claim has three axis blocks OR at least one `axis-not-computable` with reason.
- [ ] No `overall`, `composite`, or single trust score field anywhere.
- [ ] Axis order is evidence -> transportability -> decision for every claim.
- [ ] Surprise Register and Search Ledger are present as top-level sections.
- [ ] Search Ledger is non-empty (or explanatory note present for legitimate no-retrieval run).
- [ ] Type-coded caveats present for every normative and interpretive claim.
- [ ] Per-discipline skeleton recognizable in structure.
- [ ] Methodology trace present with >=1 discipline.
- [ ] Artifact tagged `evaluator-ready=true`.
