Move wiki content to docs/ and add GitHub Action for wiki sync

Summary:
Move all GitHub Wiki pages into docs/ directory in the main repo so documentation is version-controlled alongside code and goes through code review.

Changes:
- Add docs/ directory with all wiki pages (Home, Installation, Usage Guide, Web Interface Guide, Developer Guide, Code Formatting, FAQ, Environment Variables Reference, Python API Reference, Reproducer Guide)
- Add docs/_Sidebar.md for wiki sidebar navigation
- Internal cross-references updated to use .md extensions (works in GitHub markdown renderer)
- Add .github/workflows/sync-wiki.yml GitHub Action that syncs docs/ to the wiki on push to main, stripping .md extensions from links for wiki compatibility
- Fix deprecated TRITON_TRACE_GZIP references → TRITON_TRACE_COMPRESSION across all docs
- Add missing environment variables: TRITON_TRACE_LAUNCH_WITHIN_PROFILING, TRITON_TRACE_COMPRESSION, TRITONPARSE_TENSOR_SAVE_SKIP_RUNS, TRITONPARSE_TENSOR_SAVE_MAX_RUNS
- Update Python API signatures for init(), TritonParseManager, reproduce(), unified_parse() with new parameters
- Add documentation for diff, bisect, and compat-build CLI subcommands
- Update project structure in Developer Guide to reflect current codebase
- Fix outdated test commands: replace pytest and python -m unittest tests.test_tritonparse with make test / make test-cuda (matching CI run-tests.sh)
- Update Makefile test targets from pytest to python -m unittest discover

Reviewed By: xuzhao9

Differential Revision: D102010588

fbshipit-source-id: 1e0236707ddb8d18cb784af9305b2ea61fb72e8a

Author: FindHao

.github/workflows/sync-wiki.yml

@@ -0,0 +1,51 @@
+name: Sync docs to Wiki
+
+on:
+    push:
+        branches: [main]
+        paths:
+            - "docs/**"
+    workflow_dispatch:
+
+permissions:
+    contents: write
+
+jobs:
+    sync-wiki:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout main repo
+              uses: actions/checkout@v4
+
+            - name: Checkout wiki repo
+              uses: actions/checkout@v4
+              with:
+                  repository: ${{ github.repository }}.wiki
+                  path: wiki
+                  token: ${{ secrets.GITHUB_TOKEN }}
+
+            - name: Sync docs to wiki
+              run: |
+                  # Copy all docs files into the wiki checkout
+                  rsync -av --delete --exclude '.git' docs/ wiki/
+
+                  # Transform links: strip .md extension from internal wiki-style links
+                  # e.g., (01.-Installation.md) -> (01.-Installation)
+                  # e.g., (01.-Installation.md#anchor) -> (01.-Installation#anchor)
+                  cd wiki
+                  for f in *.md; do
+                    sed -i -E 's/\]\(([0-9]{2}\.-[A-Za-z0-9_-]+)\.md(#[^)]*)?)/](\1\2)/g' "$f"
+                  done
+
+            - name: Push to wiki
+              run: |
+                  cd wiki
+                  git config user.name "github-actions[bot]"
+                  git config user.email "github-actions[bot]@users.noreply.github.com"
+                  git add -A
+                  if git diff --cached --quiet; then
+                    echo "No changes to sync"
+                  else
+                    git commit -m "Sync docs from main repo ($(date -u +%Y-%m-%dT%H:%M:%SZ))"
+                    git push
+                  fi

Makefile

@@ -31,11 +31,11 @@ format-check:
 # Testing targets
 test:
 	@echo "Running tests (CPU only)..."
-	pytest tests/ -v -m "not cuda"
+	python -m unittest discover -s tests/cpu -t . -v
 
 test-cuda:
 	@echo "Running all tests (including CUDA)..."
-	pytest tests/ -v
+	python -m unittest discover -s tests -t . -v
 
 # Utility targets
 clean:

docs/01.-Installation.md

@@ -0,0 +1,250 @@
+This guide covers all installation scenarios for TritonParse, from basic usage to full development setup.
+
+## 📋 Prerequisites
+
+### System Requirements
+- **Python** >= 3.10
+- **Operating System**: Linux, macOS, or Windows (with WSL recommended)
+- **GPU Required** (Triton depends on GPU):
+  - **NVIDIA GPUs**: CUDA 11.8+
+  - **AMD GPUs**: ROCm 5.0+ (supports MI100, MI200, MI300 series)
+- **Node.js** >= 22.0.0 (for website development only)
+
+> ⚠️ **Important**: GPU is required to generate traces because Triton kernels can only run on GPU hardware. The web interface can view existing traces without GPU.
+
+---
+
+## 🔧 Install Required Dependencies
+
+All installation options require PyTorch and Triton. Complete these steps first before choosing your installation option below.
+
+### Step 1: Install PyTorch with GPU Support
+
+#### For NVIDIA GPUs (CUDA)
+```bash
+# Install PyTorch nightly with CUDA 12.8 support (recommended)
+pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu128
+
+# Alternative: Install stable PyTorch with CUDA support
+pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
+```
+
+#### For AMD GPUs (ROCm)
+```bash
+# Install PyTorch nightly with ROCm support (recommended)
+pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm6.2
+
+# Alternative: Install stable PyTorch with ROCm support
+pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.1
+```
+
+### Step 2: Verify GPU Setup
+```bash
+# Verify PyTorch and GPU
+python -c "import torch; print(f'PyTorch: {torch.__version__}')"
+python -c "import torch; print(f'GPU available: {torch.cuda.is_available()}')"
+python -c "import torch; print(f'GPU device: {torch.cuda.get_device_name(0) if torch.cuda.is_available() else \"No GPU\"}')"
+
+# Verify Triton (bundled with PyTorch)
+python -c "import triton; print(f'Triton: {triton.__version__}')"
+```
+
+> 💡 **Note**: Triton is bundled with PyTorch nightly and recent stable releases. No separate installation is needed.
+
+---
+
+## 🎯 Installation Options
+
+Now choose your installation method based on your needs:
+
+### Option 1: PyPI Installation (Recommended for Most Users)
+**Quick installation from Python Package Index**
+
+```bash
+# Install nightly version (recommended, latest features)
+pip install -U --pre tritonparse
+
+# OR install stable version
+pip install tritonparse
+```
+
+### Option 2: Install from Source
+
+```bash
+# Clone and install
+git clone https://github.com/meta-pytorch/tritonparse.git
+cd tritonparse
+pip install -e .
+
+# OR install directly from GitHub without cloning
+pip install git+https://github.com/meta-pytorch/tritonparse.git
+```
+
+**Additional setup for contributors:**
+
+```bash
+# For Python development: install formatting tools (black, usort, ruff)
+make install-dev
+
+# For website development: install Node.js dependencies (requires Node.js >= 22.0.0)
+cd website && npm install
+npm run dev  # Start dev server at http://localhost:5173
+```
+
+---
+
+## ✅ Verify Installation
+
+Test that TritonParse is working correctly:
+
+```bash
+# Navigate to tests directory
+cd tests  # or cd tritonparse/tests if you didn't clone
+
+# Run example test
+TORCHINDUCTOR_FX_GRAPH_CACHE=0 python test_add.py
+```
+
+**Expected output:**
+```bash
+Triton kernel executed successfully
+Torch compiled function executed successfully
+================================================================================
+📁 TRITONPARSE PARSING RESULTS
+================================================================================
+📂 Parsed files directory: /scratch/findhao/tritonparse/tests/parsed_output
+📊 Total files generated: 2
+...
+✅ Parsing completed successfully!
+================================================================================
+```
+
+### Using the Web Interface
+1. Generate trace files using the Python API (see [Usage Guide](02.-Usage-Guide.md))
+2. Visit [https://meta-pytorch.org/tritonparse/](https://meta-pytorch.org/tritonparse/)
+3. Load your trace files (.ndjson or .gz format)
+
+### Additional Commands for Development
+
+**For Python development (Option 3):**
+```bash
+# Check code formatting
+make format-check
+
+# Run linting
+make lint-check
+
+# Run tests
+make test
+```
+
+**For website development (Option 4):**
+```bash
+npm run dev          # Development server
+npm run build        # Production build
+npm run build:single # Standalone HTML build
+npm run preview      # Preview production build
+```
+
+---
+
+## 🐛 Troubleshooting
+
+### Common Issues
+
+#### 1. GPU Not Available
+**Error:** "CUDA not available" or "ROCm not available"
+
+**Diagnosis:**
+```bash
+python -c "import torch; print(f'GPU available: {torch.cuda.is_available()}')"
+python -c "import torch; print(f'Device count: {torch.cuda.device_count()}')"
+```
+
+**Solution:** Reinstall PyTorch with GPU support following [Step 1](#step-1-install-pytorch-with-gpu-support) above.
+
+#### 2. Triton Installation Issues
+**Error:** "No module named 'triton'" or "Triton version mismatch"
+
+**Solution:**
+```bash
+pip uninstall -y pytorch-triton triton || true
+pip install --upgrade triton
+```
+
+#### 3. Permission Issues
+**Error:** Permission denied during installation
+
+**Solution:** Use a virtual environment
+```bash
+python -m venv tritonparse-env
+source tritonparse-env/bin/activate  # Linux/Mac
+# OR
+tritonparse-env\Scripts\activate  # Windows
+```
+
+#### 4. Development Tools Not Found
+**Error:** "black not found" or similar
+
+**Solution:**
+```bash
+make install-dev
+# OR manually: pip install black usort ruff
+```
+
+#### 5. Website Build Issues
+**Error:** Node.js version too old
+
+**Solution:**
+```bash
+# Update Node.js to >= 22.0.0
+conda install 'nodejs>=22.0.0' -c conda-forge
+
+# Clear cache and reinstall
+rm -rf node_modules package-lock.json
+npm install
+```
+
+### Useful Environment Variables
+
+> 💡 **See [Environment Variables Reference](07.-Environment-Variables-Reference.md)** for complete documentation of all variables.
+
+```bash
+# TritonParse
+export TRITONPARSE_DEBUG=1                   # Enable debug logging
+export TRITON_TRACE_COMPRESSION=gzip          # Enable gzip compression
+export TRITON_TRACE=/path/to/traces          # Custom trace directory
+export TRITON_TRACE_LAUNCH=1                 # Enable launch tracing
+export TRITONPARSE_MORE_TENSOR_INFORMATION=1 # Collect tensor statistics
+
+# PyTorch/TorchInductor
+export TORCHINDUCTOR_FX_GRAPH_CACHE=0        # Disable FX graph cache (for testing)
+export TORCH_LOGS="+dynamo,+inductor"        # Enable PyTorch debug logs
+
+# GPU control
+export CUDA_VISIBLE_DEVICES=0                # Limit to specific GPU (NVIDIA)
+export ROCR_VISIBLE_DEVICES=0                # Limit to specific GPU (AMD)
+export CUDA_LAUNCH_BLOCKING=1                # Synchronous CUDA execution (for debugging)
+```
+
+### Getting Help
+
+If you encounter issues:
+
+1. Check the [Troubleshooting section](#-troubleshooting) above
+2. Review the [FAQ](06.-FAQ.md) for frequently asked questions
+3. Search [GitHub Issues](https://github.com/meta-pytorch/tritonparse/issues)
+4. Open a new issue with system info (`python --version`, `pip list`) and error messages
+
+---
+
+## 🚀 Next Steps
+
+After successful installation:
+
+1. **Read the [Usage Guide](02.-Usage-Guide.md)** to learn how to generate traces
+2. **Explore the [Web Interface Guide](03.-Web-Interface-Guide.md)** to master the visualization
+3. **Check out [Basic Examples](02.-Usage-Guide.md#example-complete-triton-kernel)** for practical usage scenarios
+4. **Review the [Environment Variables Reference](07.-Environment-Variables-Reference.md)** for configuration options
+5. **See the [Python API Reference](08.-Python-API-Reference.md)** for complete API documentation
+6. **Join the [GitHub Discussions](https://github.com/meta-pytorch/tritonparse/discussions)** for community support