CommodityWatch methodology changelog

CommodityWatch / Methodology / Changelog

Versioned methodology notes.

This page exists so changes to formulas, source coverage, and classification rules are visible in one place instead of being folded silently into the product.

2026-05-24

iShares ETF source update: direct tonnage, historical backfill method.

The iShares product pages for IAU and SLV migrated to a new Walrus server-rendered component framework in May 2026. The previous parser (relying on div.product-data-item elements) stopped resolving data. The parser now reads from the KeyFundFactsV3 component embedded in the static HTML, which publishes tonnes directly — no calculation required for current and ongoing observations.

The source continues to publish with an inherent T+2 lag (iShares publication schedule, not a pipeline delay). This has not changed.

Historical IAU and SLV data prior to the series start in this system is not available via a programmatic iShares API — the historical performance download requires a browser-authenticated session. When historical observations are backfilled from the iShares manual download, tonnes are derived from reported ounces of metal where available, or from shares outstanding × a per-share ratio extrapolated backwards using each fund's annual expense rate (IAU 0.25%/yr, SLV 0.50%/yr) anchored to a known current observation. The anchor date and ratio are stored in each backfilled observation's provenance note.

2026-05-24

PriceWatch TimesFM projection pilot.

Added the PriceWatch-only TimesFM projection pilot. Projections are generated only when the optional projection step runs after PriceWatch data updates, stored as 12M runs in data/commodities.db, and sliced into 1M, 3M, 6M, and 12M preset horizons when requested in the detail chart.

The methodology now identifies TimesFM 2.5 with checkpoint google/timesfm-2.5-200m-pytorch, cadence regularization, 80% interval storage, audit-only run history, and the non-advice warning shown in the UI.

What Will Be Logged

The changes that alter interpretation, not cosmetic edits.

New metrics

New derived series, new denominators, or new seasonal-context conventions.

Source changes

Provider additions, removals, licensing changes, or swaps between overlapping sources.

Taxonomy revisions

Demand-tier changes, category remaps, or headline-classification policy changes.

Retirements

Metrics or series removed because the source became unreliable, restricted, or misleading.

Back to the main notes

Return to the Methodology page for the current live conventions and source policy.