TMI Wiki

Welcome. This site exposes the handover documentation for the Treefera Market Insights commodity_hindcast pipeline alongside the existing repo wiki, all under one navigable viewer.

If you've landed here without context: commodity_hindcast produces county-level yield hindcasts and forward-looking forecasts for US row crops (corn, soybean, wheat) and international commodities (Brazilian soy, Indian wheat, Ghanaian cocoa). See Wiki › commodity_hindcast › Overview for the business rationale.

Pick your track

The handover is organised around three audiences. Pick the one that matches your role and follow its sequence; everything cross-links so you can deviate when needed.

User Support

You don't write code; you investigate client questions and triage tickets.

1. Data lineage — where every input comes from
2. Risk register — Critical and High only
3. Runbook › Forecast per init — how a forecast is produced
4. Hindcast vs forecast — the distinction
5. Contacts — who to escalate to

QA / Operations

You validate runs and approve releases.

1. Runbook › Full hindcast rerun — verifying a hindcast
2. Runbook › QA-to-prod sync — promotion procedure
3. Sign-off checklist — acceptance criteria
4. Risk register — full read; what to flag
5. Risk heatmap — visual summary

Technical / Engineering

You write code; you debug; you ship.

1. ADRs — five load-bearing design choices (start with ADR-001)
2. Runbooks — all five operational procedures (start with forecast-per-init)
3. Access — credentials, env vars, dashboards
4. Wiki › Domain model — entity-relationship reference
5. Wiki › commodity_hindcast — full technical reference

What's where

Tab	What it contains
Handover	Time-bounded handover artefacts: ADRs, runbooks (each with its failure-mode flowchart), risks, contacts, sign-off, and the implementation plan
Wiki	Long-lived reference: domain model, pipelines, concepts, code subsystems, entity catalogue

Conventions

• All Python invocations use uv run — never bare python or pip.
• All paths are S3-safe via cloudpathlib.AnyPath.
• INPUT_DATA_DIR must be set; helpers raise if it isn't.
• British English throughout.

Status

This handover pack was drafted on 2026-05-08 through an Actor/Critic orchestration. See Implementation plan for the audit trail and Placeholders for the unknown items the outgoing engineer needs to fill before sign-off.