Add split promotion preflight
GeoIntel CI / docs-smoke (push) Has been cancelled
GeoIntel CI / contract-smoke (push) Has been cancelled

This commit is contained in:
Codex
2026-07-10 13:49:00 +02:00
parent 947ad6784d
commit 3d4bcb1c6e
7 changed files with 157 additions and 6 deletions
+40
View File
@@ -6350,3 +6350,43 @@ Open:
- Run:
- `PROMOTION_POSITIVE_PORTFOLIO_PATH=... bash scripts/run_split_background_promotion_workflow.sh http://192.168.10.150:1202`
- Review the generated split-aware promotion report before any retraining, recalibration or default-model decision.
# Sprint 160 - Split-background promotion preflight
## What changed
- Added `--preflight-only` to `scripts/run_split_background_promotion_workflow.sh`.
- Preflight now checks:
- `PROMOTION_POSITIVE_PORTFOLIO_PATH` exists and is readable.
- `OPERATOR_SAMPLE_MANIFEST_PATH` exists and is readable.
- the manifest contains both `pure_empty_negative` and `sparse_building_context` background categories.
- Python and `curl` are available.
- the runtime frontend API proxy returns the canonical `data` envelope from `/api/v1/projects`.
- Updated operator docs, TODO and changelog with the quick post-redeploy preflight command.
## What was tested
- Red step: `python -m pytest tests/test_sprint159_split_promotion_workflow.py -q` failed because `--preflight-only` was not yet present.
- Ran `python -m pytest tests/test_sprint159_split_promotion_workflow.py -q`: 3 passed.
- Ran `bash -n scripts/run_split_background_promotion_workflow.sh`.
- Ran `python -m pytest tests/test_sprint159_split_promotion_workflow.py tests/test_sprint158_promotion_report_split_background.py -q`: 4 passed.
- Ran `curl.exe -fsS http://192.168.10.150:1202/api/v1/projects`: runtime API proxy returned a canonical `data` envelope.
- Ran `python -m compileall backend/app`.
- Ran `python -m pytest` in `backend`: 447 passed, 17 existing Pydantic namespace warnings.
- Ran `cd frontend && npm run typecheck`.
- Ran `cd frontend && npm run build`.
- Ran `cd backend && python -m alembic heads`: `202606120900 (head)`.
- Ran `cd backend && python -m alembic upgrade head --sql`.
- Ran `bash -n scripts/live_migration_smoke.sh`.
- Ran `bash scripts/run_readiness_check.sh`: passed.
## Known limitations
- Preflight is intentionally non-mutating and does not run inference, create datasets, retrain models, activate defaults, fetch providers, fetch weights or change API/database behavior.
- Full split-background matrix execution still requires redeploying this commit to the Tower/Unraid runtime and running the wrapper in the runtime checkout where the positive portfolio and operator manifest artifacts exist.
## Next recommended pass
- Redeploy/pull on Tower, then run:
- `PROMOTION_POSITIVE_PORTFOLIO_PATH=... OPERATOR_SAMPLE_MANIFEST_PATH=... bash scripts/run_split_background_promotion_workflow.sh --preflight-only http://192.168.10.150:1202`
- If preflight passes, rerun without `--preflight-only` to generate the split summary and split-aware promotion report.