# Stage H — Submission & Revision (H1–H4)

This stage packages the work for submission and hardens it against reviewer objections.

## Canonical outputs (contract paths)

- `H1` → submission auxiliary package:
  - `submission/cover_letter.md`
  - `submission/submission_checklist.md`
  - `submission/title_page.md`
  - `submission/highlights.md`
  - `submission/suggested_reviewers.md`
  - `submission/author_contributions_credit.md`
  - `submission/funding_statement.md`
  - `submission/coi_statement.md`
  - `submission/data_availability.md`
  - `submission/ai_disclosure.md`
  - `submission/supplementary_inventory.md`
- `H2` → `revision/` (includes at least `revision/response_matrix.md`, `revision/response_letter.md`)
- `H2_5` → `revision/reviewer_empathy_check.md`
- `H3` → `revision/peer_review_simulation.md`
- `H4` → `revision/fatal_flaw_analysis.md`

## Quality gate focus

- `Q3` (reporting completeness) should be satisfied before H1.

---

## H1 — Submission Package

**Definition of done**
- Cover letter matches venue conventions and clearly states contribution
- Submission checklist is complete (format, anonymity, declarations)
- Reporting checklist status is “ready” (`G1/G2` done)
- All required supplemental files are accounted for (data/code availability)

Write into:
- `submission/cover_letter.md`
- `submission/submission_checklist.md`
- `submission/title_page.md`
- `submission/highlights.md`
- `submission/suggested_reviewers.md`
- `submission/author_contributions_credit.md`
- `submission/funding_statement.md`
- `submission/coi_statement.md`
- `submission/data_availability.md`
- `submission/ai_disclosure.md`
- `submission/supplementary_inventory.md`

---

## H2 — Rebuttal / Revision Response

**Definition of done**
- Every reviewer point is addressed exactly once in a response matrix
- Responses cite where the manuscript changed (section/page/line) when possible
- Tone is neutral, grateful, and non-defensive

Write into:
- `revision/response_matrix.md`
- `revision/response_letter.md`

---

## H2_5 — Reviewer Empathy Check

This is a tone + completeness sanity check *before* sending responses.

**Definition of done**
- No dismissive language
- Each response contains: acknowledgement → action taken → evidence/location

Write into: `revision/reviewer_empathy_check.md`.

---

## H3 — Peer Review Simulation

Run parallel reviewer personas (methodologist, domain expert, “Reviewer 2”) and merge findings.

**Definition of done**
- Distinct personas produce independent reviews
- Findings are deduplicated and ranked by severity (fatal/major/minor)
- Each major finding has an action item

Write into: `revision/peer_review_simulation.md`.

---

## H4 — Fatal Flaw Analysis

Constructive desk-reject analysis: what would cause immediate rejection and how to remediate.

**Definition of done**
- 3–10 potential fatal flaws listed with evidence
- Each flaw has a mitigation plan and “if we can’t fix, we must re-scope” note

Write into: `revision/fatal_flaw_analysis.md`.
