add files

phases/2-marker-adapter/step2.md

@@ -0,0 +1,39 @@
+# Step 2: marker-block-normalization
+
+## Read First
+- /AGENTS.md
+- /PLAN.md
+- /PROGRESS.md
+- /docs/HARNESS.md
+- /docs/IMPLEMENTATION_PLAN.md
+- /docs/ARCHITECTURE.md
+- /docs/CONVERSION_POLICY.md
+- /phases/0-harness-foundation/step1.md
+- /phases/2-marker-adapter/step0.md
+
+## Task
+Map Marker structured output into the internal block model for headings, paragraphs, lists, tables, figures, captions, and equation candidates.
+
+Prefer structured Marker APIs or JSON-like structures over scraping final Markdown.
+
+## Sprint Contract
+- Done means: fake Marker structures and at least one real or recorded sample shape map into internal block types.
+- Hard thresholds: semantic block roles are preserved; bounding boxes and page numbers survive where available; formula blocks are only marked as candidates for Phase 3.
+- Files owned: `src/pdftomd/marker_adapter.py`, model additions if required, tests, `PROGRESS.md`, phase index.
+- Dependencies: Phase 0 models and Step 0 adapter.
+
+## Acceptance Criteria
+```powershell
+python scripts\validate_workspace.py
+.\venv\python.exe -m pytest tests
+```
+
+## Verification
+1. Run the acceptance commands.
+2. Confirm no final Markdown scraping is required for normal block mapping.
+3. Update `PROGRESS.md` and this phase index.
+
+## Do Not
+- Do not perform Nougat conversion.
+- Do not render Markdown.
+- Do not discard page or bounding-box metadata without a documented reason.