Files
aitbc/docs/12_issues/01_preflight_checklist.md
AITBC System b033923756 chore: normalize file permissions across repository
- Remove executable permissions from configuration files (.editorconfig, .env.example, .gitignore)
- Remove executable permissions from documentation files (README.md, LICENSE, SECURITY.md)
- Remove executable permissions from web assets (HTML, CSS, JS files)
- Remove executable permissions from data files (JSON, SQL, YAML, requirements.txt)
- Remove executable permissions from source code files across all apps
- Add executable permissions to Python
2026-03-08 11:26:18 +01:00

2.0 KiB
Raw Blame History

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 0104 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.