Tracking: v0.2.5 campaign¶
Status: Closed — v0.2.5 shipped with git tag v0.2.5; narrative docs/releases/v0.2.5.md; CHANGELOG [0.2.5]. Next milestone: not yet defined (see [Unreleased] in CHANGELOG).
Roadmap (frozen): docs/roadmap/v0.2.5.md · Prior release: docs/releases/v0.2.4.md · Implementation log: docs/implementation-log.md · Docs site handbook: docs/workflows/docs-site.md.
Objective (original)¶
Deliver v0.2.5 so that evidence packs and reports are publication-quality for reviewers, comparison workflows stay clear, deduplication improves generated Markdown, validation ergonomics stay sharp, and the MkDocs site remains navigable—without unrelated feature surface.
Completed items¶
| Stream | Evidence |
|---|---|
| Pack presentation | derive_pack_publication_hints, INDEX.md reviewer-first sections; campaign_result_pack schema optional fields; examples/campaign_result_packs/ regenerated — implementation log 2026-04-19. |
| Comparison refinement | ## At a glance, ## Analysis deltas, FT/browser compact blocks, member overlap early — campaign_compare_core, compare renderers; tests/test_campaign_compare_core.py — 2026-04-17. |
| Report polish | Campaign summary, semantic, comparative Markdown dedup and intros — 2026-04-19; tests/test_report_markdown_readability.py. |
| Drift & validation UX | Three layers in verification.md; schema-drift-contracts-inventory.md — 2026-04-17. |
| Docs site | mkdocs.yml Publication & reports; docs-site.md; index.md — 2026-04-17. |
Open questions (initial) — disposition¶
| Topic | Disposition |
|---|---|
| Executive vs appendix | Ongoing design tension; not a v0.2.5 exit blocker — may revisit in a later milestone. |
Pack versioning / alwm_version churn |
Documented where relevant; no further v0.2.5 action required. |
Recommended merge order (historical)¶
- Contracts — schemas,
artifacts.py, drift tests when JSON shapes change. - Renderers — Markdown generators after stable analysis JSON.
- Examples — regenerate committed trees when output changes.
- Workflows / MkDocs — README, AGENTS,
docs/workflows/,mkdocs.ymlin the same pass or follow-up.
Cross-cutting: docs/workflows/multi-agent-parallel.md for parallel agents.
See also¶
- docs/roadmap/v0.2.0.md — fingerprints + campaigns arc.
- docs/tracking/v0.2.4-campaign.md — closed v0.2.4 tracking.