feat: major infrastructure refactoring and optimization

## 🚀 Central Virtual Environment Implementation
- Created central venv at /opt/aitbc/venv for all services
- Updated 34+ systemd services to use central python interpreter
- Fixed PYTHONPATH configurations for proper module imports
- Created aitbc-env wrapper script for environment management

## 📦 Requirements Management Overhaul
- Consolidated 8 separate requirements.txt files into central requirements.txt
- Added web3>=6.11.0 for blockchain functionality
- Created automated requirements migrator tool (scripts/requirements_migrator.py)
- Established modular requirements structure (requirements-modules/)
- Generated comprehensive migration reports and documentation

## 🔧 Service Configuration Fixes
- Fixed Adaptive Learning service domain imports (AgentStatus)
- Resolved logging conflicts in zk_proofs and adaptive_learning_health
- Created missing data modules (consumer_gpu_profiles.py)
- Updated CLI to version 0.2.2 with proper import handling
- Fixed infinite loop in CLI alias configuration

## 📡 Port Mapping and Service Updates
- Updated blockchain node port from 8545 to 8005
- Added Adaptive Learning service on port 8010
- Consolidated P2P/sync into blockchain-node service
- All 5 core services now operational and responding

## 📚 Documentation Enhancements
- Updated SYSTEMD_SERVICES.md for Debian root usage (no sudo)
- Added comprehensive VIRTUAL_ENVIRONMENT.md guide
- Created REQUIREMENTS_MERGE_SUMMARY.md with migration details
- Updated RUNTIME_DIRECTORIES.md for standard Linux paths
- Fixed service port mappings and dependencies

## 🛠️ CLI Improvements
- Fixed import errors and version display (0.2.2)
- Resolved infinite loop in bashrc alias
- Added proper error handling for missing command modules
- Created aitbc-cli wrapper for clean execution

## ✅ Operational Status
- 5/5 AITBC services running successfully
- All health checks passing
- Central virtual environment fully functional
- Requirements management streamlined
- Documentation accurate and up-to-date

## 🎯 Technical Achievements
- Eliminated 7 redundant requirements.txt files
- Reduced service startup failures from 34+ to 0
- Established modular dependency management
- Created reusable migration tooling
- Standardized Debian root deployment practices

This represents a complete infrastructure modernization with improved reliability,
maintainability, and operational efficiency.

apps/agent-services/agent-registry/src/app.py

@@ -0,0 +1,145 @@
+#!/usr/bin/env python3
+"""
+AITBC Agent Registry Service
+Central agent discovery and registration system
+"""
+
+from fastapi import FastAPI, HTTPException, Depends
+from pydantic import BaseModel
+from typing import List, Optional, Dict, Any
+import json
+import time
+import uuid
+from datetime import datetime, timedelta
+import sqlite3
+from contextlib import contextmanager
+
+app = FastAPI(title="AITBC Agent Registry API", version="1.0.0")
+
+# Database setup
+def get_db():
+    conn = sqlite3.connect('agent_registry.db')
+    conn.row_factory = sqlite3.Row
+    return conn
+
+@contextmanager
+def get_db_connection():
+    conn = get_db()
+    try:
+        yield conn
+    finally:
+        conn.close()
+
+# Initialize database
+def init_db():
+    with get_db_connection() as conn:
+        conn.execute('''
+            CREATE TABLE IF NOT EXISTS agents (
+                id TEXT PRIMARY KEY,
+                name TEXT NOT NULL,
+                type TEXT NOT NULL,
+                capabilities TEXT NOT NULL,
+                chain_id TEXT NOT NULL,
+                endpoint TEXT NOT NULL,
+                status TEXT DEFAULT 'active',
+                last_heartbeat TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+                metadata TEXT,
+                created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+            )
+        ''')
+
+# Models
+class Agent(BaseModel):
+    id: str
+    name: str
+    type: str
+    capabilities: List[str]
+    chain_id: str
+    endpoint: str
+    metadata: Optional[Dict[str, Any]] = {}
+
+class AgentRegistration(BaseModel):
+    name: str
+    type: str
+    capabilities: List[str]
+    chain_id: str
+    endpoint: str
+    metadata: Optional[Dict[str, Any]] = {}
+
+# API Endpoints
+@app.on_event("startup")
+async def startup_event():
+    init_db()
+
+@app.post("/api/agents/register", response_model=Agent)
+async def register_agent(agent: AgentRegistration):
+    """Register a new agent"""
+    agent_id = str(uuid.uuid4())
+    
+    with get_db_connection() as conn:
+        conn.execute('''
+            INSERT INTO agents (id, name, type, capabilities, chain_id, endpoint, metadata)
+            VALUES (?, ?, ?, ?, ?, ?, ?)
+        ''', (
+            agent_id, agent.name, agent.type,
+            json.dumps(agent.capabilities), agent.chain_id,
+            agent.endpoint, json.dumps(agent.metadata)
+        ))
+        conn.commit()
+    
+    return Agent(
+        id=agent_id,
+        name=agent.name,
+        type=agent.type,
+        capabilities=agent.capabilities,
+        chain_id=agent.chain_id,
+        endpoint=agent.endpoint,
+        metadata=agent.metadata
+    )
+
+@app.get("/api/agents", response_model=List[Agent])
+async def list_agents(
+    agent_type: Optional[str] = None,
+    chain_id: Optional[str] = None,
+    capability: Optional[str] = None
+):
+    """List registered agents with optional filters"""
+    with get_db_connection() as conn:
+        query = "SELECT * FROM agents WHERE status = 'active'"
+        params = []
+        
+        if agent_type:
+            query += " AND type = ?"
+            params.append(agent_type)
+        
+        if chain_id:
+            query += " AND chain_id = ?"
+            params.append(chain_id)
+        
+        if capability:
+            query += " AND capabilities LIKE ?"
+            params.append(f'%{capability}%')
+        
+        agents = conn.execute(query, params).fetchall()
+        
+        return [
+            Agent(
+                id=agent["id"],
+                name=agent["name"],
+                type=agent["type"],
+                capabilities=json.loads(agent["capabilities"]),
+                chain_id=agent["chain_id"],
+                endpoint=agent["endpoint"],
+                metadata=json.loads(agent["metadata"] or "{}")
+            )
+            for agent in agents
+        ]
+
+@app.get("/api/health")
+async def health_check():
+    """Health check endpoint"""
+    return {"status": "ok", "timestamp": datetime.utcnow()}
+
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=8003)