Files
aitbc/scripts/SCRIPTS_ORGANIZATION.md
aitbc e4f1a96172
Some checks failed
Blockchain Synchronization Verification / sync-verification (push) Failing after 8s
CLI Tests / test-cli (push) Successful in 10s
Contract Performance Benchmarks / benchmark-gas-usage (push) Successful in 1m22s
Contract Performance Benchmarks / benchmark-execution-time (push) Successful in 1m11s
Contract Performance Benchmarks / benchmark-throughput (push) Successful in 1m13s
Cross-Chain Functionality Tests / test-cross-chain-sync (push) Failing after 5s
Cross-Chain Functionality Tests / test-cross-chain-transactions (push) Successful in 5s
Cross-Chain Functionality Tests / test-cross-chain-bridge (push) Has been skipped
Cross-Chain Functionality Tests / test-multi-chain-consensus (push) Failing after 3s
Cross-Chain Functionality Tests / aggregate-results (push) Has been skipped
Cross-Node Transaction Testing / transaction-test (push) Successful in 5s
Deploy to Testnet / deploy-testnet (push) Successful in 1m14s
Contract Performance Benchmarks / compare-benchmarks (push) Has been cancelled
Documentation Validation / validate-docs (push) Failing after 10s
Multi-Node Stress Testing / stress-test (push) Has been cancelled
Node Failover Simulation / failover-test (push) Has been cancelled
Security Scanning / security-scan (push) Has been cancelled
Smart Contract Tests / test-solidity (map[name:aitbc-contracts path:contracts]) (push) Has been cancelled
Smart Contract Tests / test-solidity (map[name:aitbc-token path:packages/solidity/aitbc-token]) (push) Has been cancelled
Smart Contract Tests / test-foundry (push) Has been cancelled
Smart Contract Tests / lint-solidity (push) Has been cancelled
Smart Contract Tests / deploy-contracts (push) Has been cancelled
Documentation Validation / validate-policies-strict (push) Successful in 3s
Integration Tests / test-service-integration (push) Failing after 45s
Multi-Chain Island Architecture Tests / test-multi-chain-island (push) Failing after 2s
Multi-Node Blockchain Health Monitoring / health-check (push) Successful in 5s
P2P Network Verification / p2p-verification (push) Successful in 3s
Production Tests / Production Integration Tests (push) Failing after 7s
Python Tests / test-python (push) Failing after 46s
Staking Tests / test-staking-service (push) Failing after 2s
Staking Tests / test-staking-integration (push) Has been skipped
Staking Tests / test-staking-contract (push) Has been skipped
Staking Tests / run-staking-test-runner (push) Has been skipped
Systemd Sync / sync-systemd (push) Successful in 21s
API Endpoint Tests / test-api-endpoints (push) Failing after 12m19s
ci: standardize pytest invocation and add security scanning
- Changed pytest calls to use `venv/bin/python -m pytest` with explicit config
- Added `--rootdir "$PWD"` and `--import-mode=importlib` for consistent imports
- Fixed PYTHONPATH to use absolute paths with $PWD prefix
- Added smart contract security scanning for Solidity files
- Added Circom circuit security checks for ZK proof circuits
- Added ZK proof implementation security validation
- Added contracts/** to security scanning workflow
2026-05-11 13:46:42 +02:00

163 lines
6.1 KiB
Markdown

# Scripts Directory Organization
## Overview
The AITBC scripts directory has been reorganized into functional categories for better maintainability and navigation.
## Directory Structure
### 📁 github/
GitHub and Git-related operations
- `all-prs-merged-summary.md` - Summary of merged pull requests
- `gitea-changes-review.md` - Gitea repository changes review
- `github-push-ready-summary.md` - GitHub push readiness summary
- `pr40-resolution-complete.md` - PR #40 resolution documentation
- `solve-github-prs.sh` - GitHub PR resolution script
- `solve-prs-with-poetry.sh` - PR resolution with Poetry dependency management
### 📁 sync/
Synchronization and data replication
- `bulk_sync.sh` - Bulk synchronization operations
- `fast_bulk_sync.sh` - Fast bulk synchronization
- `sync_detector.sh` - Synchronization detection and monitoring
- `sync-systemd.sh` - SystemD service synchronization
### 📁 security/
Security and audit operations
- `security_audit.py` - Comprehensive security audit script
- `security_monitor.sh` - Security monitoring and alerting
### 📁 monitoring/
System and service monitoring
- `health_check.sh` - System health checks
- `log_monitor.sh` - Log file monitoring
- `network_monitor.sh` - Network monitoring
- `monitor-prs.py` - Pull request monitoring
- `nightly_health_check.sh` - Nightly health check automation
- `production_monitoring.sh` - Production environment monitoring
### 📁 maintenance/
System maintenance and cleanup
- `cleanup-root-directory.sh` - Root directory cleanup
- `final-cleanup.sh` - Final cleanup operations
- `performance_tune.sh` - Performance tuning
- `weekly_maintenance.sh` - Weekly maintenance tasks
### 📁 deployment/
Deployment and provisioning
- `build-release.sh` - Release building automation
- `deploy_hermes_dao.py` - hermes DAO deployment
- `provision_node.sh` - Node provisioning
- `complete-agent-protocols.sh` - Complete agent protocols deployment
- `deploy.sh` - General deployment script
- `production-deploy.sh` - Production deployment
- `implement-agent-protocols.sh` - Agent protocols implementation
- `implement-ai-trading-analytics.sh` - AI trading analytics implementation
### 📁 testing/
Testing and quality assurance
- `comprehensive_e2e_test_fixed.py` - Comprehensive E2E testing
- `test_workflow.sh` - Workflow testing
- `debug-services.sh` - Service debugging
- `drain_test.py` - Drain testing
- `qa-cycle.py` - QA cycle automation
- `quick_test.py` - Quick testing
- `run_all_tests.sh` - All tests runner
- `run_test.py` - Test runner
- `scalability_validation.py` - Scalability validation
- `simple-test.sh` - Simple testing
- `test-all-services.sh` - All services testing
- `test-permissions.sh` - Permission testing
### 📁 utils/
Utility scripts and helpers
- `deploy_common.sh` - Shared deployment bootstrap helpers
- `link-systemd.sh` - SystemD linking
- `manage-services.sh` - Service management
- `requirements_migrator.py` - Requirements migration
- `setup.sh` - System setup
- `workspace-manager.sh` - Workspace management
- `check-aitbc-services.sh` - AITBC services checking
- `check-documentation-requirements.sh` - Documentation requirements checking
- `claim-task.py` - Task claiming
- `clean-sudoers-fix.sh` - Sudoers cleanup
- `cleanup_fake_gpus_db.py` - Fake GPU database cleanup
- `cleanup_fake_gpus.py` - Fake GPU cleanup
- `complete-permission-fix.sh` - Complete permission fixes
- `create_structured_issue.py` - Structured issue creation
- `deploy_enhanced_genesis.py` - Enhanced genesis deployment
- `detect-aitbc-user.sh` - AITBC user detection
- `end_to_end_workflow.py` - End-to-end workflow
- `final-sudoers-fix.sh` - Final sudoers fixes
- `fix_database_persistence.py` - Database persistence fixes
- `fix_gpu_release.py` - GPU release fixes
- `fix-permissions.sh` - Permission fixes
- `fix-startup-issues.sh` - Startup issue fixes
- `fix-sudoers-syntax.sh` - Sudoers syntax fixes
- `generate-api-keys.py` - API key generation
- `git_helper.sh` - Git helper functions
- `git-pre-commit-hook.sh` - Git pre-commit hook
- `init_production_genesis.py` - Production genesis initialization
- `keystore.py` - Keystore management
- `organize-dev-logs.sh` - Development logs organization
- `pr-conflict-resolution-summary.md` - PR conflict resolution summary
- `quick-fix.sh` - Quick fixes
- `run_comprehensive_planning_cleanup.py` - Comprehensive planning cleanup
- `run_documentation_conversion.sh` - Documentation conversion
- `run_enhanced_planning_analysis.py` - Enhanced planning analysis
- `run_enhanced_planning_cleanup.py` - Enhanced planning cleanup
- `run_master_planning_cleanup.py` - Master planning cleanup
- `run_planning_cleanup.py` - Planning cleanup
- `run_production_node.py` - Production node runner
- `security_hardening.sh` - Security hardening
- `setup-dev-permissions.sh` - Development permissions setup
- `setup_production.py` - Production setup
- `sync.sh` - Synchronization
- `update-docs.sh` - Documentation updates
- `validate-requirements.sh` - Requirements validation
- `verify-codebase-update.sh` - Codebase update verification
- `verify-production-advanced.sh` - Advanced production verification
## Usage
### Quick Reference
```bash
# GitHub operations
./scripts/github/solve-github-prs.sh
# System monitoring
./scripts/monitoring/health_check.sh
# Deployment
./scripts/deployment/build-release.sh
# Testing
./scripts/testing/comprehensive_e2e_test_fixed.py
# Security
./scripts/security/security_audit.py
# Maintenance
./scripts/maintenance/weekly_maintenance.sh
```
### Finding Scripts
Use this README to locate the appropriate script for your needs:
1. Identify the category (GitHub, sync, security, etc.)
2. Navigate to the relevant directory
3. Run the appropriate script
## Benefits
1. **Better Organization**: Scripts grouped by functionality
2. **Easier Navigation**: Clear directory structure
3. **Maintainability**: Related scripts grouped together
4. **Scalability**: Easy to add new scripts to appropriate categories
5. **Documentation**: Clear descriptions of each script's purpose
## Maintenance
- Add new scripts to appropriate functional directories
- Update this README when adding new categories or scripts
- Keep script descriptions current and accurate