adaptive-memory-multi-model-router 1.2.2 → 1.3.1

package/src/skills/test-tmlpd.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+# TMLPD Test Script - Verify TreeQuest Multi-LLM Parallel Deployment setup
+
+set -e
+
+echo "🚀 TMLPD Skill Verification"
+echo "=============================="
+echo ""
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+# Check TreeQuest installation
+echo -n "📦 Checking TreeQuest installation... "
+if command -v treequest &> /dev/null; then
+    echo -e "${GREEN}✓ Installed${NC}"
+    treequest version 2>/dev/null || treequest --version 2>/dev/null || echo "Version: unknown"
+else
+    echo -e "${RED}✗ TreeQuest CLI not found${NC}"
+    echo "  Install with: pip install treequest-ai"
+    exit 1
+fi
+
+echo ""
+echo "🔍 Testing Providers..."
+echo "----------------------"
+
+# Test if treequest test works
+echo -n "   Running provider tests... "
+if treequest test &> /dev/null; then
+    echo -e "${GREEN}✓ Test command works${NC}"
+else
+    echo -e "${YELLOW}⚠ Test completed with warnings${NC}"
+fi
+
+# Check configuration
+echo ""
+echo -n "⚙️  Checking TreeQuest configuration... "
+if [ -f ~/.config/treequest/config.yaml ]; then
+    echo -e "${GREEN}✓ Config file exists${NC}"
+    echo "   Location: ~/.config/treequest/config.yaml"
+else
+    echo -e "${YELLOW}⚠ Config not found${NC}"
+    echo "  Run: treequest init"
+fi
+
+# Verify skill files
+echo ""
+echo "📝 Verifying TMLPD Skill Files..."
+echo "--------------------------------"
+
+SKILL_FILES=(
+    "~/.claude/skills/TMLPD.md"
+    "~/.claude/skills/TMLPD-QUICKREF.md"
+    "~/.claude/skills/tmlpd-category.yaml"
+    "~/.claude/skills/tmlpd-phase.yaml"
+    "~/.claude/skills/tmlpd-monitoring.yaml"
+)
+
+for file in "${SKILL_FILES[@]}"; do
+    expanded_file="${file/#\~/$HOME}"
+    if [ -f "$expanded_file" ]; then
+        echo -e "${GREEN}✓${NC} $file"
+    else
+        echo -e "${RED}✗${NC} $file (missing)"
+    fi
+done
+
+echo ""
+echo "💡 Quick Start Commands:"
+echo "----------------------"
+echo ""
+echo "  # From any project:"
+echo "  cd /path/to/project"
+echo "  /TMLPD"
+echo ""
+echo "  # Or use treequest directly:"
+echo "  treequest-parallel --agents=4 --mode=category"
+echo ""
+echo "  # Check system status:"
+echo "  treequest status"
+echo ""
+
+echo "📚 Documentation:"
+echo "---------------"
+echo "  Full Guide:    ~/.claude/skills/TMLPD.md"
+echo "  Quick Ref:     ~/.claude/skills/TMLPD-QUICKREF.md"
+echo "  Configs:       ~/.claude/skills/tmlpd-*.yaml"
+echo ""
+
+# Get provider count
+if command -v treequest &> /dev/null; then
+    echo "🔌 Provider Status:"
+    echo "-----------------"
+    treequest status 2>/dev/null || echo "  Run 'treequest status' for details"
+fi
+
+echo ""
+echo -e "${GREEN}✓ TMLPD Skill Ready!${NC}"
+echo ""
+echo "Next Steps:"
+echo "  1. Copy a config template to your project"
+echo "  2. Customize for your needs"
+echo "  3. Run: treequest-parallel --config=tmlpd-config.yaml"
+echo ""

package/src/skills/tmlpd-category.yaml

@@ -0,0 +1,67 @@
+deployment:
+  name: "TMLPD Category Parallelization"
+  description: "Split tasks by category across specialized LLM providers"
+
+  agents:
+    - id: "frontend-agent"
+      provider: "anthropic"
+      model: "claude-sonnet-4-20250514"
+      focus: "UI components, styling, animations, responsive design"
+      task_pattern: "task-frontend-*|task-ui-*|task-accessibility-*"
+      priority: "high"
+      max_concurrent: 3
+
+    - id: "backend-agent"
+      provider: "openai"
+      model: "gpt-4-turbo"
+      focus: "API endpoints, database operations, business logic"
+      task_pattern: "task-backend-*|task-api-*|task-database-*"
+      priority: "high"
+      max_concurrent: 3
+
+    - id: "testing-agent"
+      provider: "google"
+      model: "gemini-2.0-flash-exp"
+      focus: "Unit tests, integration tests, e2e tests, test coverage"
+      task_pattern: "task-testing-*|task-test-*|task-validation-*"
+      priority: "medium"
+      max_concurrent: 5
+
+    - id: "docs-agent"
+      provider: "perplexity"
+      model: "llama-3.1-sonar-large-128k-online"
+      focus: "Documentation, README files, API docs, guides"
+      task_pattern: "task-docs-*|task-documentation-*|task-readme-*"
+      priority: "low"
+      max_concurrent: 4
+
+  coordination:
+    sync_interval: 300        # 5 minutes between syncs
+    conflict_resolution: "timestamp"
+    merge_strategy: "git-merge"
+    load_balancing: "dynamic"
+    checkpoint_interval: 600  # Save progress every 10 minutes
+
+  cost_optimization:
+    enabled: true
+    budget_limit: 50.00      # USD total budget
+    prefer_cached: true
+    alert_threshold: 0.80    # Alert at 80% of budget
+
+  error_handling:
+    retry_policy: "exponential_backoff"
+    max_retries: 3
+    fallback_on_failure: true
+    timeout_per_task: 300    # 5 minutes per task
+
+  output:
+    directory: ".tmlpd-output"
+    logs: "tmlpd-logs.json"
+    metrics: "tmlpd-metrics.json"
+    checkpoints: ".tmlpd-checkpoints"
+    verbose: true
+
+  monitoring:
+    dashboard_enabled: true
+    metrics_port: 8080
+    real_time_updates: true

package/src/skills/tmlpd-monitoring.yaml

@@ -0,0 +1,188 @@
+deployment:
+  name: "TMLPD Monitoring Configuration"
+  description: "Advanced monitoring and metrics for TreeQuest parallel deployments"
+
+  monitoring:
+    # Real-time Dashboard
+    dashboard:
+      enabled: true
+      port: 8080
+      refresh_interval: 5  # seconds
+      auto_start: true
+
+    # Metrics Collection
+    metrics:
+      enabled: true
+      collection_interval: 10  # seconds
+      retention_days: 30
+      export_formats:
+        - json
+        - prometheus
+
+    # Performance Tracking
+    performance:
+      track_latency: true
+      track_throughput: true
+      track_cost: true
+      track_errors: true
+      track_success_rate: true
+
+    # Agent Health
+    agent_health:
+      check_interval: 30  # seconds
+      timeout_threshold: 120  # seconds
+      restart_on_failure: true
+      max_restart_attempts: 3
+
+    # Alerts & Notifications
+    alerts:
+      enabled: true
+      channels:
+        - type: "console"
+          enabled: true
+        - type: "file"
+          enabled: true
+          path: ".tmlpd-alerts.log"
+        - type: "webhook"
+          enabled: false
+          url: "https://hooks.example.com/alerts"
+
+      rules:
+        - name: "high_error_rate"
+          condition: "error_rate > 0.10"
+          severity: "warning"
+          message: "Error rate exceeds 10%"
+
+        - name: "budget_exceeded"
+          condition: "cost > budget_limit * 0.90"
+          severity: "critical"
+          message: "Approaching budget limit"
+
+        - name: "agent_unresponsive"
+          condition: "last_heartbeat > 180"
+          severity: "warning"
+          message: "Agent unresponsive for 3 minutes"
+
+        - name: "task_stalled"
+          condition: "task_duration > 1800"
+          severity: "info"
+          message: "Task running for 30+ minutes"
+
+  # Logging Configuration
+  logging:
+    level: "info"  # debug, info, warn, error
+    format: "json"
+    outputs:
+      - type: "console"
+        enabled: true
+        colorize: true
+      - type: "file"
+        enabled: true
+        path: ".tmlpd-logs/deployment.log"
+        rotation:
+          enabled: true
+          max_size_mb: 100
+          max_files: 10
+
+    # Structured Logging Fields
+    fields:
+      - timestamp
+      - agent_id
+      - task_id
+      - provider
+      - model
+      - status
+      - duration_ms
+      - cost_usd
+      - error_message
+
+  # Metrics Export Configuration
+  export:
+    prometheus:
+      enabled: true
+      port: 9090
+      path: "/metrics"
+
+    json:
+      enabled: true
+      path: ".tmlpd-metrics/current-metrics.json"
+      pretty_print: true
+
+    csv:
+      enabled: false
+      path: ".tmlpd-metrics/history.csv"
+
+  # Visualization
+  visualization:
+    chart_types:
+      - "tasks_completed_over_time"
+      - "cost_accumulation"
+      - "agent_utilization"
+      - "error_rate_by_provider"
+      - "latency_distribution"
+
+    report_generation:
+      enabled: true
+      interval: 300  # every 5 minutes
+      output_dir: ".tmlpd-reports"
+
+  # Custom Metrics
+  custom_metrics:
+    - name: "tasks_per_minute"
+      type: "gauge"
+      description: "Tasks completed per minute per agent"
+
+    - name: "average_cost_per_task"
+      type: "gauge"
+      description: "Average cost per completed task"
+
+    - name: "provider_success_rate"
+      type: "gauge"
+      labels: ["provider"]
+      description: "Success rate by LLM provider"
+
+    - name: "parallel_efficiency"
+      type: "gauge"
+      description: "Ratio of parallel to sequential execution time"
+
+  # Performance Baselines
+  baselines:
+    established: false
+    calibration_runs: 5
+    auto_adjust: true
+
+    expected_metrics:
+      tasks_per_minute: 2.0
+      cost_per_task: 0.05
+      error_rate: 0.02
+      agent_utilization: 0.85
+
+  # Health Checks
+  health_checks:
+    enabled: true
+    interval: 60  # seconds
+
+    checks:
+      - name: "api_connectivity"
+        type: "external"
+        url: "https://api.anthropic.com/v1/messages"
+
+      - name: "disk_space"
+        type: "system"
+        threshold_gb: 5
+
+      - name: "memory_usage"
+        type: "system"
+        threshold_percent: 85
+
+      - name: "agent_heartbeat"
+        type: "internal"
+        timeout_seconds: 30
+
+  # Debug Mode
+  debug:
+    enabled: false
+    trace_requests: true
+    log_request_body: true
+    log_response_body: false
+    save_raw_responses: false

package/src/skills/tmlpd-phase.yaml

@@ -0,0 +1,132 @@
+deployment:
+  name: "TMLPD Phase Parallelization"
+  description: "Execute project phases in parallel across multiple LLM providers"
+
+  agents:
+    - id: "phase1-architect"
+      provider: "anthropic"
+      model: "claude-opus-4"
+      phase: 1
+      phase_name: "Architecture & Planning"
+      focus: "System architecture, project structure, design patterns"
+      task_pattern: "phase-1-*|arch-*|design-*"
+      dependencies: []
+      priority: "critical"
+      max_concurrent: 2
+
+    - id: "phase2-core-features"
+      provider: "anthropic"
+      model: "claude-sonnet-4-20250514"
+      phase: 2
+      phase_name: "Core Features"
+      focus: "Primary feature implementation, core logic"
+      task_pattern: "phase-2-core-*|feature-*"
+      dependencies: ["phase1-architect"]
+      priority: "high"
+      max_concurrent: 3
+
+    - id: "phase2-secondary-features"
+      provider: "openai"
+      model: "gpt-4-turbo"
+      phase: 2
+      phase_name: "Secondary Features"
+      focus: "Secondary features, utilities, helpers"
+      task_pattern: "phase-2-secondary-*|utility-*"
+      dependencies: ["phase1-architect"]
+      priority: "medium"
+      max_concurrent: 4
+
+    - id: "phase3-testing"
+      provider: "google"
+      model: "gemini-2.5-pro"
+      phase: 3
+      phase_name: "Testing & Validation"
+      focus: "Comprehensive testing suite, validation, quality assurance"
+      task_pattern: "phase-3-*|test-*|validate-*"
+      dependencies: ["phase2-core-features", "phase2-secondary-features"]
+      priority: "high"
+      max_concurrent: 5
+
+    - id: "phase4-deployment"
+      provider: "anthropic"
+      model: "claude-sonnet-4-20250514"
+      phase: 4
+      phase_name: "Deployment & DevOps"
+      focus: "CI/CD, deployment scripts, production readiness"
+      task_pattern: "phase-4-deploy-*|devops-*|ci-cd-*"
+      dependencies: ["phase3-testing"]
+      priority: "critical"
+      max_concurrent: 2
+
+    - id: "phase4-documentation"
+      provider: "perplexity"
+      model: "llama-3.1-sonar-large-128k-online"
+      phase: 4
+      phase_name: "Documentation"
+      focus: "User guides, API documentation, README files"
+      task_pattern: "phase-4-docs-*|doc-*|guide-*"
+      dependencies: ["phase3-testing"]
+      priority: "medium"
+      max_concurrent: 3
+
+  coordination:
+    phase_gating: true              # Wait for phase completion
+    wait_for_dependencies: true     # Respect task dependencies
+    sync_interval: 180              # 3 minutes between syncs
+    conflict_resolution: "priority-based"
+    merge_strategy: "sequential-phases"
+    load_balancing: "work-stealing"
+    checkpoint_interval: 420        # 7 minutes
+
+  cost_optimization:
+    enabled: true
+    budget_limit: 100.00            # USD for full project
+    per_phase_budget:
+      phase-1: 15.00
+      phase-2: 40.00
+      phase-3: 25.00
+      phase-4: 20.00
+    prefer_cached: true
+    alert_threshold: 0.75
+
+  error_handling:
+    retry_policy: "exponential_backoff"
+    max_retries: 3
+    fallback_on_failure: true
+    timeout_per_task: 600           # 10 minutes per task
+    rollback_on_failure: false      # Don't rollback entire phase on single failure
+
+  output:
+    directory: ".tmlpd-phases"
+    logs: "phase-logs.json"
+    metrics: "phase-metrics.json"
+    checkpoints: ".tmlpd-phase-checkpoints"
+    phase_reports: "phase-reports"
+    verbose: true
+
+  monitoring:
+    dashboard_enabled: true
+    metrics_port: 8080
+    real_time_updates: true
+    phase_progress_tracking: true
+
+  quality_gates:
+    phase_1_exit_criteria:
+      - "Architecture document approved"
+      - "Project structure created"
+      - "Dependencies identified"
+
+    phase_2_exit_criteria:
+      - "All features implemented"
+      - "Code coverage > 80%"
+      - "No critical bugs"
+
+    phase_3_exit_criteria:
+      - "Test suite passes"
+      - "All tests passing"
+      - "Performance benchmarks met"
+
+    phase_4_exit_criteria:
+      - "Deployment scripts tested"
+      - "Documentation complete"
+      - "Production ready"

package/src/state/__init__.py

@@ -0,0 +1,17 @@
+"""
+TMLPD State Module
+
+This module provides lightweight JSON-based checkpointing for state management.
+"""
+
+from .simple_checkpoint import (
+    SimpleCheckpoint,
+    save_checkpoint,
+    load_checkpoint
+)
+
+__all__ = [
+    "SimpleCheckpoint",
+    "save_checkpoint",
+    "load_checkpoint"
+]