Skip to content

See docs/DISCLAIMER_SNIPPET.md

CI Sprint Plan

This document proposes tasks to stabilize the ci.yml workflow so every job completes successfully.

Goals

  • Remove unsupported Python versions.
  • Ensure dependency locks match available packages.
  • Validate Docker builds on the highest supported Python release.
  • Verify docs and platform smoke tests run on Windows and macOS.

Proposed Tasks

  1. Update Python Matrix
  2. Limit the matrix to 3.11–3.13. Python 3.14 is not available on GitHub Actions yet.
  3. Refresh Lock Files
  4. Re‑generate requirements.lock and related lock files with a supported ortools version.
  5. Check Dockerfile Base Image
  6. Align the base Python image with the CI version and verify that all wheels are available.
  7. Run Pre‑commit Hooks
  8. Execute pre-commit run --all-files locally before dispatching the workflow.
  9. Manual Trigger Only
  10. Keep the workflow configured for manual workflow_dispatch runs by the repository owner.
  11. Monitor Asset Integrity
  12. Validate Pyodide and web client assets with scripts/fetch_assets.py --verify-only.
  13. Run scripts/check_insight_sri.py docs/alpha_agi_insight_v1 to ensure the generated insight.bundle.js digest matches the integrity attribute in index.html.
  14. Fix Offline Checks
  15. Rebuild the Insight bundle to update the service worker integrity hash.
  16. Ensure scripts/verify_insight_offline.py passes without console errors.
  17. Cross‑platform Smoke Tests
  18. Confirm windows-smoke and macos-smoke jobs install Node dependencies and run pytest -m smoke without failures.

This sprint ensures that all jobs (✅ Pytest, Windows/Mac smoke tests, Docs build, Docker build, Deploy) execute without skipping and that the published artifacts are reproducible.