Contributing

Quick Start

# Clone and set up
git clone https://github.com/wilcompute/W33-Theory.git
cd W33-Theory
./scripts/bootstrap_repo_env.sh
source .venv/bin/activate  # Windows: .venv\Scripts\Activate.ps1
make doctor

# Run the test suite
python -m pytest tests/test_e8_embedding.py -q

Pre-commit Hooks

This repo uses black and isort for formatting. Install hooks with:

pip install pre-commit && pre-commit install

Adding a New Pillar

1. Create a verification script: scripts/w33_<pillar_name>.py
   • Include if __name__ == '__main__': guard
   • Print key results with clear labels
2. Add a test class to tests/test_e8_embedding.py
   • Use scope="class" fixtures for expensive setup
   • 3-5 tests per pillar, each testing one key claim
3. Update the pillar table in README.md

Guidelines

• Every claim must be computationally verified
• Avoid heavy computation at import time
• scripts.w33_permrep_association.analyze_gap_permrep_association will attempt to recover a full transitive orbit by searching alternate base points if the provided base yields an incomplete orbit — prefer calling the function directly rather than invoking its CLI fallback in tests.
• Use json.dump(..., indent=2, default=str) for serialization
• Keep assertions tight: use np.isclose or pytest.approx with explicit tolerances