commodity_hindcast Wiki — Log¶

Each entry starts with ## [YYYY-MM-DD] {ingest|query|lint} | <short title> so the log is greppable.

[2026-05-05] ingest | initial scaffolding¶

Wrote IMPLEMENTATION_PLAN.md, wiki/AGENTS.md, wiki/index.md, wiki/log.md, and the directory skeleton (domain_model/, wiki/{synthesis,entities,concepts,pipelines,sources/{code,configs,docs,prs,commits}}/). No content pages yet.

[2026-05-05] ingest | P1 — domain model¶

Wrote 7 files into domain_model/: README, ENTITIES (~30 entities, 5 tiers), RELATIONSHIPS (~70 relationships), AGGREGATES (7 aggregates), BOUNDED_CONTEXTS (11 contexts + Mermaid context map), ER_DIAGRAM (3 Mermaid diagrams), delta_vs_existing. Critic verdict: ACCEPT-WITH-NOTES (5 minor follow-ups for P7).

[2026-05-05] ingest | P2 — code source pages¶

Wrote 11 source pages into sources/code/, one per subsystem (orchestration, features, regression, detrend, meta_models, stages, diagnostics, plots, delivery, dashboard, lib). Critic verdict: ACCEPT-WITH-NOTES (4 minor follow-ups). Surfaced two layering violations and confirmed CalibrationResult save/load presence — both correct AGGREGATES.md.

[2026-05-05] ingest | P3 — configs, docs, PRs, commits source pages¶

Wrote ~28 source pages: 8 configs (5 commodity YAMLs + ty.toml + LinkML schema + index), 9 docs (README, DESIGN with 35 EARS clauses indexed, TODO, experiments, features-readmes, CLAUDE, in-package domain model + index), 11 PR pages (PR-372/369/363/361/360/353/345/340/339/331 + index), 1 commit timeline. Critic verdict: ACCEPT-WITH-NOTES.

[2026-05-05] ingest | P4 — entity pages¶

Wrote 30 entity pages across 6 batches: Group A core domain (6), Group B config (9), Group C edit-rules+delivery-config (2), Group D pipeline artefacts (5), Group E behavioural roles (5), Group F delivery+validation (3). Confirmed exact base-class names: AbstractRegressionImpl, AbstractDetrend, BuilderFn (Protocol), AbstractBiasCorrector, ReferenceYieldLoader. Documented EditOperation as nested union under EditRuleConfig.

[2026-05-05] ingest | P5 — concept and pipeline pages¶

Wrote 20 pages across 4 batches: Group G model-lifecycle concepts (5: hindcast_vs_forecast, walk_forward_cv, conformal_modes, residual_modes, weather_correction), Group H infrastructure concepts (5: s3_path_safety, input_data_dir_contract, climo_materialisation, mlflow_tracking, adm_levels), Group I training pipelines (5: preflight, feature_build, fit, predict, postprocess), Group J delivery+forecast pipelines (5: evaluate, deliver, forecast, multi_year_forecast, dashboard). Critic verdict: ACCEPT-WITH-NOTES (4 broken cross-refs, 1 wrong DESIGN.md clause number).

[2026-05-05] ingest | P6 — synthesis + index regeneration¶

Regenerated index.md to catalogue all 101 pages on disk. Note: synthesis/overview.md and synthesis/thesis.md were not present on disk at P6 time — the synthesis directory was empty; these are flagged for P7. P7 lint pass scheduled next.

[2026-05-05] lint | P6 follow-up — synthesis pages catalogued¶

Re-scanned wiki tree after parallel-execution race; synthesis/{overview,thesis}.md were written but not catalogued by the original P6 index regeneration. Index updated, total page count corrected from 101 to 103.

[2026-05-05] lint | P7 — lint pass and backlog clearance¶

Applied 17 of 18 explicit backlog items (item 7 verified no-op — no truly bare sources: fields exist). Key fixes: ENTITIES.md EditOperation sub-table, AGGREGATES.md CalibrationResult transient claim corrected, EvaluationConfig removed from config children (not in code), AssembleStressConfig added to ExperimentConfig aggregate, ER_DIAGRAM Diagram 2 HINDCAST_DELIVERY edge added, meta_models.md types.py:14→:16 citation fixed, stages.md fit_production paragraph added, timeline.md commit counts updated (87→90, 111→116), DESIGN.md wiki clause count corrected (35→54), commits/index.md and code/index.md written, corn_usa.md cross-refs verified valid, postprocess.md clause reference updated to DESIGN.md:73, four missing concept/entity pages written (SeasonWindow, conformal_calibration redirect, bias_correction, resolvable_path), adm_levels/multi_year_forecast/forecast See Also entries added. Standard lint scan found 84 broken links (primarily planned-but-not-yet-written pages), 2 orphans (new index files), 3 contradictions (all fixed). LINT_REPORT.md written. Total pages: 109.