Troubleshooting

PanLL Troubleshooting

Quick Fixes

just doctor    # Diagnose all issues
just heal      # Auto-repair common problems

Common Issues

"Port 8000 already in use"

lsof -i :8000    # Find what's using it
kill <PID>        # Kill the process
deno task dev     # Restart

ReScript compilation errors

npx rescript clean && npx rescript build

Gossamer binary not found

Ensure Gossamer is built:

cd ~/Documents/hyperpolymath-repos/gossamer
cargo build --release

VeriSimDB connection refused

systemctl --user start verisimdb-007    # Start the instance
curl http://localhost:8094/health        # Verify health

BoJ cartridge not responding

# Check BoJ server status
curl http://localhost:3007/health

# Restart if needed
cd ~/Documents/hyperpolymath-repos/boj-server
deno task start

Panel stuck in "Broken" state

1. Open the Wiring Inspector panel
2. Find the broken panel and check its obligations
3. Fix the failing constraint
4. Re-run verification: the PCC will re-evaluate

Tests failing

just test                    # Run all tests
deno test --filter "panel"   # Run specific panel tests

Performance Issues

Slow panel rendering

• Check Vexometer readings — high friction may indicate too many panels open
• Close unused panels
• Check VeriSimDB query performance: curl http://localhost:8094/api/v1/metrics

High memory usage

• ReScript build artifacts can grow large: npx rescript clean
• Check for leaking event listeners in PanelBus
• Monitor with: deno task dev --inspect

Getting Help

just help-me    # Opens feedback channel with diagnostic context

Or file an issue: https://github.com/hyperpolymath/panll/issues/new