aitbc/docs/12_issues/01_preflight_checklist.md

Preflight Checklist (Before Implementation)

Use this checklist before starting Stage 20 development work.

Tools & Versions

• Circom v2.2.3+ installed (circom --version)
• snarkjs installed globally (snarkjs --help)
• Node.js + npm aligned with repo version (node -v, npm -v)
• Vitest available for JS SDK tests (npx vitest --version)
• Python 3.13+ with pytest (python --version, pytest --version)
• NVIDIA drivers + CUDA installed (nvidia-smi, nvcc --version)
• Ollama installed and running (ollama list)

Environment Sanity

• .env files present/updated for coordinator API
• Virtualenvs active (.venv for Python services)
• npm/yarn install completed in packages/js/aitbc-sdk
• GPU available and visible via nvidia-smi
• Network access for model pulls (Ollama)

Baseline Health Checks

• npm test in packages/js/aitbc-sdk passes
• pytest in apps/coordinator-api passes
• pytest in apps/blockchain-node passes
• pytest in apps/wallet-daemon passes
• pytest in apps/pool-hub passes
• Circom compile sanity: circom apps/zk-circuits/receipt_simple.circom --r1cs -o /tmp/zkcheck

Data & Backup

• Backup current .env files (coordinator, wallet, blockchain-node)
• Snapshot existing ZK artifacts (ptau/zkey) if any
• Note current npm package version for JS SDK

Scope & Branching

• Create feature branch for Stage 20 work
• Confirm scope limited to 01–04 task files plus testing/deployment updates
• Review success metrics in 00_nextMileston.md

Hardware Notes

• Target consumer GPU list ready (e.g., RTX 3060/4070/4090)
• Test host has CUDA drivers matching target GPUs

Rollback Ready

• Plan for reverting npm publish if needed
• Alembic downgrade path verified (if new migrations)
• Feature flags identified for new endpoints

Mark items as checked before starting implementation to avoid mid-task blockers.