Repository navigation
Troubleshooting Maintenance
Oxydian edited this page Nov 12, 2026
·
1 revision
This guide aggregates diagnosis steps, quick resolutions for common errors, and periodic maintenance checklists.
- Cause: Previous background Node process still running.
-
Fix (PowerShell):
Get-Process node | Stop-Process -Force
-
Fix: Run automated fixer:
pnpm eslint --fix pnpm prettier --write .
-
Cause: Dummy token in sandbox environment (
HTTP 401: Bad credentials). -
Fix: Prefix command with environment clear:
$env:GITHUB_TOKEN=""; gh pr list
- Cause: Multiple write operations without WAL mode or hung transaction.
-
Fix: Ensure WAL mode is active:
PRAGMA journal_mode = WAL; PRAGMA busy_timeout = 5000;
- Run
pnpm audit:leaksto ensure zero sensitive credential leaks. - Run
pnpm outdatedto identify non-breaking dependency updates. - Clean up SQLite temporary WAL/SHM files if orphaned.
- Verify SCM Outbox Dead Letter Queue:
GET /api/scm/v1/operational/outbox/dlq.
- Vacuum SQLite database:
VACUUM;. - Review Architectural Decision Records in
docs/adr/. - Rotate development API test tokens if applicable.
Atlas Logistics · Enterprise Multimodal Logistics & Freight Forwarding Operating System
Main Repository: xpallares1987-ai/Atlas-Logistics · Licensed Documentation