--- name: synthesize description: Thesis report synthesis — turn a thesis's markdown artifacts into its letter-size thesis-report.html. Three-step loop — pack (deterministic Python bundle of all sources), author (the LLM writes report/content.html from the pack — narrative, tables and citations are LLM judgment), assemble (deterministic validation, template injection, Q50 pins, Q47 overflow gate). Spec 046 Q46–Q50. role: kit market_data_stage: none allowed_tools: [] retrieval_scope: structured_only --- # agentii.synthesize The single-point HTML generation step (spec 046 Q46–Q50): ONE `thesis-report.html` per thesis, authored from the markdown artifacts. Analysis skills emit markdown only (Q49); the report is assembled here, at the synthesis step, after the cross-stock synthesis (`_cross/*_synthesis.md`) exists. ## When to run - After the synthesis tasks complete (the `_cross/` deliverable is written). - When `converge` emits an `html_stale` finding (sources or template moved). - On explicit request, or once at thesis completion (Q50 regeneration triggers). ## The loop (three steps) ```bash cd agentii-investment-intelligence # 1. PACK — deterministic bundle of every source, verbatim (no timestamps): python3 scripts/synthesize_report.py pack --thesis # 2. AUTHOR — read /report-input.md and write /report/content.html # (the LLM step — the report's actual content is YOUR judgment, see contract). # 3. ASSEMBLE — validate + inject + gate: python3 scripts/synthesize_report.py assemble --thesis --check-only # fit loop python3 scripts/synthesize_report.py assemble --thesis # deliver ``` `assemble --check-only` prints each page's estimated height against the letter limit and writes nothing — iterate on `content.html` until **font tier 0** passes. Tiers 1–2 (10pt / 9pt) are a safety net, not a target. If all tiers fail, the assembler degrades: `thesis-report.md` (the full pack, a real markdown report) + an HTML draft carrying a red DRAFT banner (Q47 failure semantics). ## content.html contract (the assembler hard-gates every rule) You author **only the page sequence** — a fragment, never a document: 1. One or more `

…

` blocks, no nesting. The cover is page 1 and is template-owned: **do not author it** — the assembler fills title / claim / pins / universe / generated / TOC from the thesis itself. 2. Fragment only — ``, ``, ``, ``, `