Migration v3.2 → v3.3
Why v3.3 Exists
A live run intended for v3.2 was generated by a stale v3.1 runtime. Subsequent review also found that forecast bridges could be circular, commercial biopharma aliases could bypass LOE stress, peak-profit risk could avoid normalization, and data quality could remain too high without cash, TTM-period, ROIC, or EBITDA evidence.
v3.3 makes those failures mechanically detectable.
Breaking Changes
skill version: 3.3.0
snapshot schema: 3
screening audit schema: 3
contract revision: 3.3
runtime fingerprint: ug-v3.3-driver-bridge-bounded-pool-20260828Old audits and snapshots are not resumable. Regenerate them.
Required Changes
- Replace the complete skill directory and
.skillpackage from the same release. - Verify all helper scripts with
--version. - Regenerate listing, discovery, broad-screen, checkpoint, and final artifacts.
- Add
runtimemetadata to every audit/snapshot. - Add a valid generation audit for bounded pools.
- Rebuild forecasts from operating drivers rather than a preselected numerator.
- Add TTM-period source IDs, cash classification, ROIC/EBITDA evidence, and sector/cycle evidence.
- Use normalized
commercial_biopharmasector semantics or a supported alias. - Rerun all tests and the strict final smoke test.
Candidate Data Changes
- Forecast drivers now require sufficient information to independently calculate the metric.
- Adjusted forecasts must tie both GAAP and adjustment portions to the reconciliation.
- Cash classification records
corporate_cash, eligible marketable securities, restricted/customer funds, and normalization method. - TTM cash-flow methods require source IDs for reported TTM or each construction period.
peak_profit_risk=truerequires normalization.- Commercial biopharma requires product concentration and LOE evidence.
Package Migration
Delete any installed same-name older skill before installing v3.3. Confirm the package SHA-256 and --version output after installation. Do not trust a filename alone.