oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 21 Packages Projects Releases Wiki Activity

Update documentation to reflect 12 atomic skills and current service ports
Some checks failed
API Endpoint Tests / test-api-endpoints (push) Successful in 15s
Details
Blockchain Synchronization Verification / sync-verification (push) Failing after 1s
Details
CLI Tests / test-cli (push) Failing after 5s
Details
Cross-Chain Functionality Tests / test-cross-chain-sync (push) Successful in 3s
Details
Cross-Chain Functionality Tests / test-cross-chain-transactions (push) Successful in 4s
Details
Cross-Chain Functionality Tests / test-cross-chain-bridge (push) Has been skipped
Details
Cross-Chain Functionality Tests / test-multi-chain-consensus (push) Successful in 3s
Details
Cross-Chain Functionality Tests / aggregate-results (push) Has been skipped
Details
Cross-Node Transaction Testing / transaction-test (push) Successful in 12s
Details
Deploy to Testnet / deploy-testnet (push) Successful in 1m12s
Details
Documentation Validation / validate-docs (push) Successful in 11s
Details
Documentation Validation / validate-policies-strict (push) Successful in 6s
Details
Integration Tests / test-service-integration (push) Successful in 2m39s
Details
Multi-Node Blockchain Health Monitoring / health-check (push) Successful in 2s
Details
Multi-Node Stress Testing / stress-test (push) Successful in 2s
Details
Node Failover Simulation / failover-test (push) Successful in 2s
Details
P2P Network Verification / p2p-verification (push) Successful in 2s
Details
Package Tests / Python package - aitbc-agent-sdk (push) Failing after 30s
Details
Package Tests / Python package - aitbc-core (push) Successful in 14s
Details
Package Tests / Python package - aitbc-crypto (push) Successful in 8s
Details
Package Tests / Python package - aitbc-sdk (push) Successful in 9s
Details
Package Tests / JavaScript package - aitbc-sdk-js (push) Successful in 7s
Details
Package Tests / JavaScript package - aitbc-token (push) Successful in 19s
Details
Python Tests / test-python (push) Successful in 14s
Details
Security Scanning / security-scan (push) Failing after 31s
Details
Deploy to Testnet / notify-deployment (push) Successful in 2s
Details

Browse Source
This commit is contained in:
aitbc
2026-05-02 14:38:19 +02:00
parent 316dc8e894
commit 27993bee72
106 changed files with 1549 additions and 186 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
.windsurf/meta/REFACTORING_SUMMARY.md
View File

@@ -8,7 +8,7 @@ version: 1.0
## Refactoring Completed
### ✅ **Atomic Skills Created (11/11)**
### ✅ **Atomic Skills Created (12/12)**
#### **AITBC Blockchain Skills (6/6)**
1. **aitbc-wallet-manager** - Wallet creation, listing, balance checking
@@ -18,12 +18,13 @@ version: 1.0
5. **aitbc-node-coordinator** - Cross-node coordination and messaging
6. **aitbc-analytics-analyzer** - Blockchain analytics and performance metrics
#### **OpenClaw Agent Skills (5/5)**
#### **OpenClaw Agent Skills (6/6)**
7. **openclaw-agent-communicator** - Agent message handling and responses
8. **openclaw-session-manager** - Session creation and context management
9. **openclaw-coordination-orchestrator** - Multi-agent workflow coordination
10. **openclaw-performance-optimizer** - Agent performance tuning and optimization
11. **openclaw-error-handler** - Error detection and recovery procedures
12. **openclaw-agent-testing-skill** - Agent communication validation and performance testing
---
@@ -149,12 +150,12 @@ cd /opt/aitbc && source venv/bin/activate && ./aitbc-cli chain
## 🎯 **Next Steps**
### **Complete Remaining Skills (5/11)**
1. Create aitbc-node-coordinator for cross-node operations
2. Create aitbc-analytics-analyzer for performance metrics
3. Create openclaw-coordination-orchestrator for multi-agent workflows
4. Create openclaw-performance-optimizer for agent tuning
5. Create openclaw-error-handler for error recovery
### **Validation and Documentation Follow-Up**
1. Run the canonical 3-node validation harness: [`docs/scenarios/VALIDATION.md`](../../docs/scenarios/VALIDATION.md)
2. Validate all active skills with Cascade Chat/Write modes
3. Confirm @mentions context targeting
4. Verify model routing recommendations
5. Update performance benchmarks and usage guides
### **Integration Testing**
1. Test all skills with Cascade Chat/Write modes
@@ -197,8 +198,8 @@ cd /opt/aitbc && source venv/bin/activate && ./aitbc-cli chain
## 🎉 **Mission Status**
**Phase 1**: ✅ **COMPLETED** - 6/11 atomic skills created
**Phase 2**: ✅ **COMPLETED** - All 11/11 atomic skills created
**Phase 3**: <EFBFBD> **IN PROGRESS** - Integration testing and documentation
**Phase 1**: ✅ **COMPLETED** - 6/12 atomic skills created
**Phase 2**: ✅ **COMPLETED** - All 12/12 atomic skills created
**Phase 3**: ⏳ **IN PROGRESS** - Integration testing and documentation
**Result**: Successfully transformed legacy monolithic skills into atomic, deterministic, structured, and reusable skills with 70% performance improvement and 100% Windsurf compatibility.
**Result**: Successfully transformed legacy monolithic skills into 12 atomic, deterministic, structured, and reusable skills with 70% performance improvement and 100% Windsurf compatibility.

41
.windsurf/meta/SKILL_ANALYSIS.md
View File

@@ -8,7 +8,7 @@ version: 1.0
## Current Skill Analysis
### File: `aitbc-blockchain.md`
### File: `aitbc-blockchain.md` (archived legacy)
#### **IDENTIFIED WEAKNESSES:**
@@ -39,11 +39,22 @@ version: 1.0
5. `aitbc-node-coordinator` - Cross-node coordination and messaging
6. `aitbc-analytics-analyzer` - Blockchain analytics and performance metrics
#### **CURRENT ACTIVE SKILL SET**
The active OpenClaw-style split skills now live in `.windsurf/skills/` and include:
- `openclaw-agent-communicator`
- `openclaw-session-manager`
- `openclaw-coordination-orchestrator`
- `openclaw-performance-optimizer`
- `openclaw-error-handler`
- `openclaw-agent-testing-skill`
---
## Current Skill Analysis
### File: `openclaw-aitbc.md`
### File: `openclaw-aitbc.md` (archived legacy)
#### **IDENTIFIED WEAKNESSES:**
@@ -53,14 +64,23 @@ version: 1.0
#### **RECOMMENDED ACTION:**
- **DELETE** - This skill is deprecated and serves no purpose
- **Migration already completed** - Skills are properly split
- **ARCHIVE** - This skill is deprecated and serves no purpose
- **Migration already completed** - The active skill set now uses the atomic OpenClaw skills listed below
#### **CURRENT ACTIVE SKILL SET**
- `openclaw-agent-communicator`
- `openclaw-session-manager`
- `openclaw-coordination-orchestrator`
- `openclaw-performance-optimizer`
- `openclaw-error-handler`
- `openclaw-agent-testing-skill`
---
## Current Skill Analysis
### File: `openclaw-management.md`
### File: `openclaw-management.md` (archived legacy)
#### **IDENTIFIED WEAKNESSES:**
@@ -84,6 +104,17 @@ version: 1.0
4. `openclaw-performance-optimizer` - Agent performance tuning and optimization
5. `openclaw-error-handler` - Error detection and recovery procedures
#### **CURRENT ACTIVE SKILL SET**
These are the actual active files in `.windsurf/skills/`:
- `openclaw-agent-communicator`
- `openclaw-session-manager`
- `openclaw-coordination-orchestrator`
- `openclaw-performance-optimizer`
- `openclaw-error-handler`
- `openclaw-agent-testing-skill`
---
## Refactoring Strategy

29
.windsurf/plans/OPENCLAW_AITBC_MASTERY_PLAN.md
View File

@@ -1,7 +1,7 @@
---
description: Comprehensive OpenClaw agent training plan for AITBC software mastery from beginner to expert level
title: OPENCLAW_AITBC_MASTERY_PLAN
version: 2.0
version: 2.1
---
# OpenClaw AITBC Mastery Plan
@@ -44,7 +44,7 @@ AITBC Multi-Node Setup:
├── Genesis Node (aitbc) - Port 8006 (Primary, IP: 10.1.223.40)
├── Follower Node (aitbc1) - Port 8006 (Secondary, different IP)
├── CLI Tool: /opt/aitbc/aitbc-cli
├── Services: Coordinator (8001), Exchange (8000), Blockchain RPC (8006 on both nodes)
├── Services: Agent Coordinator (9001), Exchange (8001), Blockchain RPC (8006 on both nodes)
├── AI Operations: Ollama integration, job processing, marketplace
└── Node Synchronization: Gitea-based git pull/push (NOT SCP)
```
@@ -79,7 +79,7 @@ ssh aitbc1 'cd /opt/aitbc && git reset --hard origin/main'
**GitHub Mirror**: `https://github.com/oib/AITBC.git` (push only after milestones)
### <20> **Workflow Integration**
**Multi-Node Workflows**: Comprehensive workflow suite for deployment and operations
**Multi-Node Workflow Integration**: Comprehensive workflow suite for deployment and operations
- **Master Index**: [`/opt/aitbc/.windsurf/workflows/MULTI_NODE_MASTER_INDEX.md`](../workflows/MULTI_NODE_MASTER_INDEX.md)
- **Core Setup**: [`multi-node-blockchain-setup-core.md`](../workflows/multi-node-blockchain-setup-core.md) - Prerequisites and basic node configuration
- **Operations**: [`multi-node-blockchain-operations.md`](../workflows/multi-node-blockchain-operations.md) - Daily operations and monitoring
@@ -89,6 +89,7 @@ ssh aitbc1 'cd /opt/aitbc && git reset --hard origin/main'
- **Reference**: [`multi-node-blockchain-reference.md`](../workflows/multi-node-blockchain-reference.md) - Configuration reference
- **OpenClaw Setup**: [`multi-node-blockchain-setup-openclaw.md`](../workflows/multi-node-blockchain-setup-openclaw.md) - OpenClaw-specific deployment
- **Communication Test**: [`blockchain-communication-test.md`](../workflows/blockchain-communication-test.md) - Cross-node verification
- **Scenario Validation**: [`VALIDATION.md`](../scenarios/VALIDATION.md) - Canonical 3-node validation guide and harness
**Test Phases**: Structured test suite for comprehensive validation
- **Phase 1**: Consensus testing ([`/opt/aitbc/tests/phase1/consensus`](../../tests/phase1/consensus))
@@ -350,7 +351,7 @@ cd /opt/aitbc/scripts/training
# AI service operations (debug mode)
./aitbc-cli ai service list --verbose --output json
./aitbc-cli ai service status --name ollama --debug
./aitbc-cli ai service test --name coordinator --verbose
./aitbc-cli ai service test --name agent-coordinator --verbose
# API integration (non-interactive)
./aitbc-cli api test --endpoint /ai/job --yes --no-confirm
@@ -565,8 +566,8 @@ export NODE_URL=http://<aitbc1-ip>:8006 # Follower node
export CLI_PATH=/opt/aitbc/aitbc-cli
# Service endpoints
export COORDINATOR_URL=http://localhost:8001
export EXCHANGE_URL=http://localhost:8000
export AGENT_COORDINATOR_URL=http://localhost:9001
export EXCHANGE_URL=http://localhost:8001
export OLLAMA_URL=http://localhost:11434
# Authentication
@@ -577,7 +578,7 @@ export WALLET_PASSWORD=<secure_password>
### **Service Dependencies**
- **AITBC CLI**: `/opt/aitbc/aitbc-cli` accessible
- **Blockchain Services**: Port 8006 on both nodes (different IPs)
- **AI Services**: Ollama (11434), Coordinator (8001), Exchange (8000)
- **AI Services**: Ollama (11434), Agent Coordinator (9001), Exchange (8001)
- **Network Connectivity**: Both nodes can communicate
- **Sufficient Balance**: Test wallet with adequate AIT tokens
@@ -709,14 +710,14 @@ chmod +x /opt/aitbc/aitbc-cli
```bash
# Check service status
systemctl status aitbc-blockchain-rpc
systemctl status aitbc-coordinator
systemctl status aitbc-agent-coordinator.service
# Restart services if needed
systemctl restart aitbc-blockchain-rpc
systemctl restart aitbc-coordinator
systemctl restart aitbc-agent-coordinator.service
# Verify ports
netstat -tlnp | grep -E '800[0167]|11434'
netstat -tlnp | grep -E '9001|8001|8006|11434'
```
#### **Node Connectivity Issues**
@@ -745,7 +746,7 @@ curl http://localhost:11434/api/tags
/opt/aitbc/aitbc-cli balance --name openclaw-trainee
# Check AI service status
/opt/aitbc/aitbc-cli ai --service --status --name coordinator
/opt/aitbc/aitbc-cli ai service status --name agent-coordinator
```
#### **Script Execution Timeout**
@@ -889,14 +890,14 @@ systemctl restart aitbc-*
# Verify system health
curl http://10.1.223.40:8006/health
curl http://<aitbc1-ip>:8006/health
curl http://10.1.223.40:9001/health
curl http://10.1.223.40:8001/health
curl http://10.1.223.40:8000/health
```
---
**Training Plan Version**: 1.1
**Last Updated**: 2026-04-02
**Training Plan Version**: 2.1
**Last Updated**: 2026-05-02
**Target Audience**: OpenClaw Agents
**Difficulty**: Beginner to Expert (5 Stages)
**Estimated Duration**: 4 weeks

2
.windsurf/references/ai-operations-reference.md
View File

@@ -247,6 +247,8 @@ python3 /opt/aitbc/plugins/ollama/client_plugin.py --model llama2 --prompt "Gene
## OpenClaw Agent Coordination
> **Canonical validation**: Use [`docs/scenarios/VALIDATION.md`](../../docs/scenarios/VALIDATION.md) and `scripts/workflow/44_comprehensive_multi_node_scenario.sh` for the current 3-node test path.
### OpenClaw AI Agent Setup
```bash
# Initialize OpenClaw AI agent

35
.windsurf/skills/archive/openclaw-aitbc.md
View File

@@ -8,24 +8,21 @@ version: 6.0 - DEPRECATED
⚠️ **This skill has been split into focused skills for better organization:**
## 📚 New Split Skills
## 📚 Current Active OpenClaw Skills
### 1. OpenClaw Agent Management Skill
**File**: `openclaw-management.md`
This legacy bundle now maps to the current atomic OpenClaw skill files:
**Focus**: Pure OpenClaw agent operations, communication, and coordination
- Agent creation and management
- Session-based workflows
- Cross-agent communication
- Performance optimization
- Error handling and debugging
- **`openclaw-agent-communicator.md`** — agent message handling and responses
- **`openclaw-session-manager.md`** — session creation and context management
- **`openclaw-coordination-orchestrator.md`** — multi-agent workflow coordination
- **`openclaw-performance-optimizer.md`** — agent performance tuning and optimization
- **`openclaw-error-handler.md`** — error detection and recovery procedures
- **`openclaw-agent-testing-skill.md`** — agent communication validation and performance testing
**Use for**: Agent orchestration, workflow coordination, multi-agent systems
### 2. AITBC Blockchain Operations Skill
### Archived Blockchain Companion
**File**: `aitbc-blockchain.md`
**Focus**: Pure AITBC blockchain operations and integration
**Focus**: AITBC blockchain operations and integration retained as an archived companion
- Wallet management and transactions
- AI operations and marketplace
- Node coordination and monitoring
@@ -164,7 +161,15 @@ cd /opt/aitbc && source venv/bin/activate
**Recommendation**: Use the new split skills for all new development. This legacy skill is maintained for backward compatibility but will be deprecated in future versions.
## Quick Links to New Skills
## Quick Links to Current Active Skills
- **OpenClaw Agent Communicator**: [../openclaw-agent-communicator.md](../openclaw-agent-communicator.md)
- **OpenClaw Session Manager**: [../openclaw-session-manager.md](../openclaw-session-manager.md)
- **OpenClaw Coordination Orchestrator**: [../openclaw-coordination-orchestrator.md](../openclaw-coordination-orchestrator.md)
- **OpenClaw Performance Optimizer**: [../openclaw-performance-optimizer.md](../openclaw-performance-optimizer.md)
- **OpenClaw Error Handler**: [../openclaw-error-handler.md](../openclaw-error-handler.md)
- **OpenClaw Agent Testing Skill**: [../openclaw-agent-testing-skill.md](../openclaw-agent-testing-skill.md)
## Archived Blockchain Companion
- **OpenClaw Agent Management**: [openclaw-management.md](openclaw-management.md)
- **AITBC Blockchain Operations**: [aitbc-blockchain.md](aitbc-blockchain.md)

20
.windsurf/skills/archive/openclaw-management.md
View File

@@ -8,6 +8,17 @@ version: 1.0
This skill provides comprehensive OpenClaw agent management, communication, and coordination capabilities. Focus on agent operations, session management, and cross-agent workflows.
## Current Active OpenClaw Skills
This archived management skill is now represented by the following active atomic skill files:
- **`openclaw-agent-communicator.md`** — agent message handling and responses
- **`openclaw-session-manager.md`** — session creation and context management
- **`openclaw-coordination-orchestrator.md`** — multi-agent workflow coordination
- **`openclaw-performance-optimizer.md`** — agent performance tuning and optimization
- **`openclaw-error-handler.md`** — error detection and recovery procedures
- **`openclaw-agent-testing-skill.md`** — agent communication validation and performance testing
## Prerequisites
- OpenClaw 2026.3.24+ installed and gateway running
@@ -342,3 +353,12 @@ openclaw config --show --agent main
- Implement proper session cleanup
This OpenClaw Agent Management skill provides the foundation for effective agent coordination, communication, and workflow orchestration across any domain or application.
## Quick Links to Current Active Skills
- **OpenClaw Agent Communicator**: [../openclaw-agent-communicator.md](../openclaw-agent-communicator.md)
- **OpenClaw Session Manager**: [../openclaw-session-manager.md](../openclaw-session-manager.md)
- **OpenClaw Coordination Orchestrator**: [../openclaw-coordination-orchestrator.md](../openclaw-coordination-orchestrator.md)
- **OpenClaw Performance Optimizer**: [../openclaw-performance-optimizer.md](../openclaw-performance-optimizer.md)
- **OpenClaw Error Handler**: [../openclaw-error-handler.md](../openclaw-error-handler.md)
- **OpenClaw Agent Testing Skill**: [../openclaw-agent-testing-skill.md](../openclaw-agent-testing-skill.md)

2
.windsurf/templates/agent-templates.md
View File

@@ -1,5 +1,7 @@
# OpenClaw AITBC Agent Templates
> **Canonical validation**: Use [`docs/scenarios/VALIDATION.md`](../../docs/scenarios/VALIDATION.md) with `scripts/workflow/44_comprehensive_multi_node_scenario.sh` when validating these templates.
## Blockchain Monitor Agent
```json
{

2
.windsurf/templates/workflow-templates.md
View File

@@ -1,5 +1,7 @@
# OpenClaw AITBC Workflow Templates
> **Canonical validation**: For end-to-end node coverage, use [`docs/scenarios/VALIDATION.md`](../../docs/scenarios/VALIDATION.md) and `scripts/workflow/44_comprehensive_multi_node_scenario.sh`.
## Multi-Node Health Check Workflow
```yaml
name: multi-node-health-check

10
.windsurf/workflows/MULTI_NODE_MASTER_INDEX.md
View File

@@ -416,10 +416,12 @@ Two-Node AITBC Blockchain:
## 📚 Additional Resources
### Documentation Files
- **AI Operations Reference**: `openclaw-aitbc/ai-operations-reference.md`
- **Agent Templates**: `openclaw-aitbc/agent-templates.md`
- **Workflow Templates**: `openclaw-aitbc/workflow-templates.md`
- **Setup Scripts**: `openclaw-aitbc/setup.sh`
- **OpenClaw Agent Communicator**: `../skills/openclaw-agent-communicator.md`
- **OpenClaw Coordination Orchestrator**: `../skills/openclaw-coordination-orchestrator.md`
- **OpenClaw Session Manager**: `../skills/openclaw-session-manager.md`
- **OpenClaw Agent Testing**: `../skills/openclaw-agent-testing-skill.md`
- **OpenClaw Error Handler**: `../skills/openclaw-error-handler.md`
- **OpenClaw Performance Optimizer**: `../skills/openclaw-performance-optimizer.md`
### External Resources
- **AITBC Repository**: GitHub repository

2
.windsurf/workflows/OPENCLAW_MASTER_INDEX.md
View File

@@ -240,7 +240,7 @@ OpenClaw Agent Ecosystem:
1. **Agent Recovery**: Restart OpenClaw gateway, check agent status
2. **Network Recovery**: Check node connectivity, restart P2P service
3. **Blockchain Recovery**: Check node sync, verify transaction pool
4. **Service Recovery**: Restart coordinator, Ollama, GPU miner
4. **Service Recovery**: Restart Agent Coordinator, Ollama, GPU miner
## 📚 Additional Resources

9
.windsurf/workflows/archive/ollama-gpu-test.md
View File

@@ -6,6 +6,15 @@ description: Complete Ollama GPU provider test workflow from client submission t
This workflow executes the complete end-to-end test for Ollama GPU inference jobs, including payment processing and blockchain transaction recording.
## Current Active Skill Mapping
This archived workflow maps to these active OpenClaw skills when you need agent coordination or validation support:
- **`openclaw-agent-testing-skill.md`** — agent communication validation and performance testing
- **`openclaw-agent-communicator.md`** — agent message handling and responses
- **`openclaw-coordination-orchestrator.md`** — multi-agent workflow coordination
- **`openclaw-session-manager.md`** — session creation and context management
## Prerequisites
// turbo

10
.windsurf/workflows/archive/test-openclaw-agents.md
View File

@@ -8,6 +8,16 @@ version: 1.0
This module covers OpenClaw agent functionality testing, multi-agent coordination, session management, and agent workflow validation.
## Current Active Skill Mapping
This archived workflow maps to these active split skill files:
- **`openclaw-agent-testing-skill.md`** — agent communication validation and performance testing
- **`openclaw-agent-communicator.md`** — agent message handling and responses
- **`openclaw-session-manager.md`** — session creation and context management
- **`openclaw-coordination-orchestrator.md`** — multi-agent workflow coordination
- **`openclaw-performance-optimizer.md`** — agent performance tuning and optimization
## Prerequisites
### Required Setup

2
.windsurf/workflows/multi-node-blockchain-setup-openclaw.md
View File

@@ -272,7 +272,7 @@ ssh aitbc1 'systemctl is-active aitbc-blockchain-{node,rpc}.service'
openclaw agent --agent main --message "Report multi-node blockchain health" --thinking medium
# Integration test
/opt/aitbc/.windsurf/skills/openclaw-aitbc/setup.sh test
/opt/aitbc/scripts/workflow/44_comprehensive_multi_node_scenario.sh
```
## Documentation