oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 6 Packages Projects Releases Wiki Activity
Files
a06595eccb89dcb426caeede323d01caeee4427a
aitbc/ai-memory/failures/debugging-notes.md
aitbc 0c60fc5542
Some checks failed
AITBC CI/CD Pipeline / lint-and-test (3.11) (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / lint-and-test (3.12) (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / lint-and-test (3.13) (pull_request) Has been cancelled
Details
Security Scanning / Bandit Security Scan (apps/coordinator-api/src) (pull_request) Has been cancelled
Details
Security Scanning / Bandit Security Scan (cli/aitbc_cli) (pull_request) Has been cancelled
Details
Security Scanning / Bandit Security Scan (packages/py/aitbc-core/src) (pull_request) Has been cancelled
Details
Security Scanning / Bandit Security Scan (packages/py/aitbc-crypto/src) (pull_request) Has been cancelled
Details
Security Scanning / Bandit Security Scan (packages/py/aitbc-sdk/src) (pull_request) Has been cancelled
Details
Security Scanning / Bandit Security Scan (tests) (pull_request) Has been cancelled
Details
Security Scanning / CodeQL Security Analysis (javascript) (pull_request) Has been cancelled
Details
Security Scanning / CodeQL Security Analysis (python) (pull_request) Has been cancelled
Details
Security Scanning / Dependency Security Scan (pull_request) Has been cancelled
Details
Security Scanning / Container Security Scan (pull_request) Has been cancelled
Details
Security Scanning / OSSF Scorecard (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / test-cli (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / test-services (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / test-production-services (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / security-scan (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / build (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / deploy-staging (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / deploy-production (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / performance-test (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / docs (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / release (pull_request) Has been cancelled
Details
AITBC CI/CD Pipeline / notify (pull_request) Has been cancelled
Details
Security Scanning / Security Summary Report (pull_request) Has been cancelled
Details
feat: add production setup and infrastructure improvements 
- Add production genesis initialization scripts
- Add keystore management for production
- Add production node runner
- Add setup production automation
- Add AI memory system for development tracking
- Add translation cache service
- Add development heartbeat monitoring
- Update blockchain RPC router
- Update coordinator API main configuration
- Update secure pickle service
- Update claim task script
- Update blockchain service configuration
- Update gitignore for production files
2026-03-18 15:22:24 +00:00

2.3 KiB
Raw Blame History

Debugging Playbook

Structured checklists for diagnosing common subsystem failures.

CLI Command Fails with ImportError

  1. Confirm service module exists: ls apps/coordinator-api/src/app/services/
  2. Check services/__init__.py exists.
  3. Verify command module adds apps/coordinator-api/src to sys.path.
  4. Test import manually: 
    python3 -c "import sys; sys.path.insert(0, 'apps/coordinator-api/src'); from app.services.trading_surveillance import start_surveillance"
  5. If missing dependencies, install coordinator-api requirements.

Blockchain Node Not Starting

  1. Check virtualenv: source apps/blockchain-node/.venv/bin/activate
  2. Verify database file exists: apps/blockchain-node/data/chain.db
    • If missing, run genesis generation: python scripts/make_genesis.py
  3. Check .env configuration (ports, keys).
  4. Test RPC health: curl http://localhost:8026/health
  5. Review logs: tail -f apps/blockchain-node/logs/*.log (if configured)

Package Installation Fails (pip)

  1. Ensure README.md exists in package root.
  2. Check pyproject.toml for required fields: name, version, description.
  3. Install dependencies first: pip install -r requirements.txt if present.
  4. Try editable install: pip install -e . with verbose: pip install -v -e .

Git Push Permission Denied

  1. Verify SSH key added to Gitea account.
  2. Confirm remote URL is SSH, not HTTPS.
  3. Test connection: ssh -T git@gitea.bubuit.net.
  4. Ensure token has push permission if using HTTPS.

CI Pipeline Not Running

  1. Check .github/workflows/ exists and YAML syntax is valid.
  2. Confirm branch protection allows CI.
  3. Check Gitea Actions enabled (repository settings).
  4. Ensure Python version matrix includes active versions (3.11, 3.12, 3.13).

Tests Fail with ImportError in aitbc-core

  1. Confirm package installed: pip list | grep aitbc-core.
  2. If not installed: pip install -e ./packages/py/aitbc-core.
  3. Ensure tests can import aitbc.logging: python3 -c "from aitbc.logging import get_logger".

PR Cannot Be Merged (stuck)

  1. Check if all required approvals present.
  2. Verify CI status is success on the PR head commit.
  3. Ensure no merge conflicts (Gitea shows mergeable: true).
  4. If outdated, rebase onto latest main and push.