Notice Versioning: Manifest and Notice Catalog

[TiaTuinstra]

Notice versioning (assignment manifest mode): a new optional mode that maps each client to a specific notice version and language via a JSON assignment manifest. When --notice-assignments <file> is provided and config/notice_versions.yaml exists, the pipeline dispatches each client to the correct template and language individually - enabling a single run to produce overdue, affirmative, and informational notices in mixed languages. When the catalog file is absent, the pipeline behaves identically to before.

Added:

• New pipeline/notice_versioning.py module: NoticeVersionCatalog, NoticeVersion, ResolvedNotice, load_catalog(), validate_eligibility().
• New pipeline/assignment_manifest.py module: ManifestRow, ReconciliationResult, load_manifest(), reconcile(), has_errors(), print_preflight_summary().
• New --notice-assignments PATH CLI argument; language becomes optional (can be omitted when using manifest mode).
• Preflight gate after preprocessing in manifest mode: missing clients, unknown version IDs, and eligibility conflicts (e.g., affirmative notice assigned to a client with vaccines due) are caught before any PDF is generated.
• Per-run assignment metadata file output/metadata/notice_assignments_<run_id>.json written in manifest mode (no PII fields).
• notice_versioning config block in parameters.yaml for allow_unassigned and extra_manifest_rows policy controls.
• Example config/notice_versions.yaml with overdue_standard_v1 and affirmative_schedule_v1.

[codecov]

Codecov Report

❌ Patch coverage is 82.09366% with 65 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
pipeline/preprocess.py	66.66%	22 Missing and 1 partial ⚠️
pipeline/generate_notices.py	60.86%	17 Missing and 1 partial ⚠️
pipeline/orchestrator.py	69.04%	11 Missing and 2 partials ⚠️
pipeline/assignment_manifest.py	95.76%	4 Missing and 1 partial ⚠️
pipeline/config_loader.py	50.00%	2 Missing and 2 partials ⚠️
pipeline/notice_versioning.py	97.40%	1 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!