claude-flow-novice 2.10.5 → 2.10.7

package/claude-assets/skills/cfn-transparency-middleware/wrap-agent.sh

@@ -0,0 +1,132 @@
+#!/usr/bin/env bash
+# Transparency Middleware Wrapper
+# Wraps agent execution with automatic memory capture
+
+# Strict error handling
+set -euo pipefail
+
+# Logging configuration
+LOG_DIR="/var/log/claude-flow/transparency-middleware"
+TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
+
+# Validate input arguments
+if [[ $# -lt 3 ]]; then
+    echo "Error: Insufficient arguments" >&2
+    echo "Usage: $0 <AGENT_ROLE> <AGENT_ID> <TASK_ID> [ADDITIONAL_ARGS...]" >&2
+    exit 1
+fi
+
+# Parse arguments
+AGENT_ROLE="$1"
+AGENT_ID="$2"
+TASK_ID="$3"
+shift 3  # Remove first three arguments, leaving any additional args
+
+# Create log directory if it doesn't exist
+mkdir -p "${LOG_DIR}/${TASK_ID}"
+
+# Initialize middleware and pre-execution hooks
+initialize_middleware() {
+    node -e "
+    import {TransparencyMiddleware} from '.claude/skills/cfn-cfn-.claude/skills/cfn-cfn-.claude/skills/cfn-cfn-src/middleware/transparency-middleware.js';
+    const middleware = new TransparencyMiddleware();
+    await middleware.initialize({
+        agentRole: '${AGENT_ROLE}',
+        agentId: '${AGENT_ID}',
+        taskId: '${TASK_ID}'
+    });
+    await middleware.preExecutionHook();
+    " || {
+        echo "Middleware initialization failed" >&2
+        exit 2
+    }
+}
+
+# Capture execution metrics
+execute_agent() {
+    local log_file="${LOG_DIR}/${TASK_ID}/${AGENT_ID}_${TIMESTAMP}.log"
+    local metrics_file="${LOG_DIR}/${TASK_ID}/${AGENT_ID}_${TIMESTAMP}_metrics.json"
+
+    # Start time capture
+    local start_time=$(date +%s.%N)
+
+    # Execute the actual agent command with all remaining arguments
+    # Redirect output to log file
+    if ! "$@" 2>&1 | tee "${log_file}"; then
+        local exit_code=${PIPESTATUS[0]}
+
+        # Capture error metrics
+        node -e "
+        import fs from 'fs';
+        import {TransparencyMiddleware} from '.claude/skills/cfn-cfn-.claude/skills/cfn-cfn-.claude/skills/cfn-cfn-src/middleware/transparency-middleware.js';
+        const middleware = new TransparencyMiddleware();
+
+        const metrics = {
+            taskId: '${TASK_ID}',
+            agentId: '${AGENT_ID}',
+            agentRole: '${AGENT_ROLE}',
+            startTime: ${start_time},
+            endTime: $(date +%s.%N),
+            exitCode: ${exit_code},
+            status: 'FAILED'
+        };
+
+        await middleware.postExecutionHook(metrics);
+        fs.writeFileSync('${metrics_file}', JSON.stringify(metrics, null, 2));
+        " || echo "Error tracking failed"
+
+        return ${exit_code}
+    fi
+
+    # Capture successful execution metrics
+    node -e "
+    import fs from 'fs';
+    import {TransparencyMiddleware} from '.claude/skills/cfn-cfn-.claude/skills/cfn-cfn-.claude/skills/cfn-cfn-src/middleware/transparency-middleware.js';
+    const middleware = new TransparencyMiddleware();
+
+    const metrics = {
+        taskId: '${TASK_ID}',
+        agentId: '${AGENT_ID}',
+        agentRole: '${AGENT_ROLE}',
+        startTime: ${start_time},
+        endTime: $(date +%s.%N),
+        exitCode: 0,
+        status: 'SUCCESS'
+    };
+
+    await middleware.postExecutionHook(metrics);
+    fs.writeFileSync('${metrics_file}', JSON.stringify(metrics, null, 2));
+    " || echo "Metrics tracking failed"
+}
+
+# Main execution flow
+main() {
+    # Initialize middleware before execution
+    initialize_middleware
+
+    # Execute agent with remaining arguments
+    execute_agent "$@"
+}
+
+# Execute main function and capture its exit status
+main "$@"
+exit_status=$?
+
+# Signal completion to Redis coordination
+redis-cli lpush "swarm:${TASK_ID}:${AGENT_ID}:done" "complete" > /dev/null
+
+# Invoke waiting mode report
+./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh report \
+  --task-id "${TASK_ID}" \
+  --agent-id "${AGENT_ID}" \
+  --confidence 0.80 \
+  --iteration 1
+
+# Enter waiting mode
+./.claude/skills/cfn-redis-coordination/invoke-waiting-mode.sh enter \
+  --task-id "${TASK_ID}" \
+  --agent-id "${AGENT_ID}" \
+  --context "iteration-1-complete"
+
+# Exit with original command's exit status
+exit ${exit_status}

package/claude-assets/skills/cfn-validation-templates/SKILL.md

@@ -0,0 +1,47 @@
+# Validation Templates Skill
+
+**Version:** 1.0.0
+**Purpose:** Domain-specific validation criteria for CFN Loop v3
+
+## Overview
+
+Provides predefined validation criteria for 6 task domains. Loop 2 validators use these to assess Loop 3 output quality.
+
+## Templates
+
+- `software.json` - Software development validation
+- `content.json` - Content creation validation
+- `research.json` - Research & analysis validation
+- `design.json` - Design & UX validation
+- `infrastructure.json` - Infrastructure & DevOps validation
+- `data.json` - Data engineering validation
+
+## Usage
+
+```bash
+# Load template for task type
+VALIDATION_CRITERIA=$(cat ./.claude/skills/validation-templates/software.json)
+
+# Extract critical criteria
+CRITICAL=$(echo "$VALIDATION_CRITERIA" | jq '.validation_criteria.critical[]')
+```
+
+## Criteria Levels
+
+**Critical** - Must pass for PROCEED decision
+- Blockers, security issues, core functionality
+- Examples: Tests pass, no vulnerabilities, build succeeds
+
+**Important** - Should pass but can iterate
+- Quality standards, coverage, documentation
+- Examples: Coverage ≥ 80%, linter clean, docs updated
+
+**Nice to Have** - Optional improvements
+- Optimizations, tech debt, enhancements
+- Examples: Performance improved, refactored code
+
+## Integration
+
+Used by:
+- `.claude/agents/cfn-v3-coordinator.md` - Load validation criteria
+- Loop 2 validator agents - Assess Loop 3 output

package/claude-assets/skills/cfn-validation-templates/content.json

@@ -0,0 +1,38 @@
+{
+  "domain": "content-creation",
+  "validation_criteria": {
+    "critical": [
+      "Content is original (no plagiarism)",
+      "Factually accurate (sources verified)",
+      "Meets minimum word count or length requirement",
+      "No spelling or grammar errors",
+      "Complies with legal/regulatory requirements"
+    ],
+    "important": [
+      "Readability score ≥ target (Flesch-Kincaid, etc.)",
+      "Brand voice and tone consistent",
+      "SEO keywords properly integrated (if applicable)",
+      "Target audience appropriately addressed",
+      "Clear structure with headings, paragraphs, lists",
+      "Call-to-action included (if applicable)",
+      "Links and references valid"
+    ],
+    "nice_to_have": [
+      "Engaging storytelling or narrative",
+      "Multimedia elements suggested (images, videos)",
+      "Meta descriptions and titles optimized",
+      "Internal/external linking strategy",
+      "Conversion optimization techniques used"
+    ]
+  },
+  "success_metrics": {
+    "gate_threshold": 0.75,
+    "consensus_threshold": 0.90
+  },
+  "deliverable_requirements": [
+    "Content file created (markdown, doc, html)",
+    "No plagiarism detected",
+    "Factual accuracy verified",
+    "Brand guidelines followed"
+  ]
+}

package/claude-assets/skills/cfn-validation-templates/data.json

@@ -0,0 +1,38 @@
+{
+  "domain": "data-engineering",
+  "validation_criteria": {
+    "critical": [
+      "Data pipeline executes successfully",
+      "Data quality checks pass (completeness, accuracy, consistency)",
+      "Schema validation successful",
+      "No data loss or corruption",
+      "Performance SLAs met"
+    ],
+    "important": [
+      "Data lineage documented",
+      "Error handling and retry logic implemented",
+      "Idempotency ensured (re-runnable without duplicates)",
+      "Monitoring and alerting configured",
+      "Data privacy compliance (PII handling, encryption)",
+      "Partitioning strategy appropriate",
+      "Testing coverage adequate (unit, integration)"
+    ],
+    "nice_to_have": [
+      "Pipeline performance optimized",
+      "Cost efficiency analyzed",
+      "Data catalog entries created",
+      "Data quality metrics tracked over time",
+      "Pipeline documentation comprehensive"
+    ]
+  },
+  "success_metrics": {
+    "gate_threshold": 0.75,
+    "consensus_threshold": 0.90
+  },
+  "deliverable_requirements": [
+    "Pipeline code/configuration",
+    "Data quality validation passed",
+    "Schema documentation",
+    "Performance test results"
+  ]
+}

package/claude-assets/skills/cfn-validation-templates/design.json

@@ -0,0 +1,38 @@
+{
+  "domain": "design",
+  "validation_criteria": {
+    "critical": [
+      "Meets accessibility standards (WCAG 2.1 AA minimum)",
+      "Responsive across target devices/screen sizes",
+      "User flows complete and logical",
+      "Core functionality clearly represented",
+      "Brand guidelines followed"
+    ],
+    "important": [
+      "Design system consistency maintained",
+      "Typography hierarchy clear and effective",
+      "Color contrast ratios meet standards (4.5:1 minimum)",
+      "Touch targets meet minimum size (44x44px)",
+      "Loading states and error states designed",
+      "User testing feedback incorporated",
+      "Component library updated"
+    ],
+    "nice_to_have": [
+      "Microinteractions and animations enhance UX",
+      "Dark mode variant provided",
+      "Print styles considered",
+      "Performance budget respected (image optimization)",
+      "Design tokens documented"
+    ]
+  },
+  "success_metrics": {
+    "gate_threshold": 0.75,
+    "consensus_threshold": 0.90
+  },
+  "deliverable_requirements": [
+    "Design files (Figma, Sketch, Adobe XD)",
+    "Exported assets (if applicable)",
+    "Design specifications document",
+    "Accessibility audit passed"
+  ]
+}

package/claude-assets/skills/cfn-validation-templates/infrastructure.json

@@ -0,0 +1,38 @@
+{
+  "domain": "infrastructure",
+  "validation_criteria": {
+    "critical": [
+      "Infrastructure deploys successfully",
+      "Security posture meets requirements (no exposed secrets, proper IAM)",
+      "Backup and disaster recovery configured",
+      "Monitoring and alerting operational",
+      "Cost within budget"
+    ],
+    "important": [
+      "Infrastructure as Code (IaC) properly structured",
+      "Scalability requirements met",
+      "High availability configured (if required)",
+      "Logging configured and centralized",
+      "Network security groups/firewalls configured",
+      "SSL/TLS certificates valid",
+      "Compliance requirements met (GDPR, HIPAA, etc.)"
+    ],
+    "nice_to_have": [
+      "Auto-scaling configured",
+      "Cost optimization opportunities identified",
+      "Multi-region failover configured",
+      "Performance benchmarks established",
+      "Infrastructure documentation comprehensive"
+    ]
+  },
+  "success_metrics": {
+    "gate_threshold": 0.75,
+    "consensus_threshold": 0.90
+  },
+  "deliverable_requirements": [
+    "IaC files (Terraform, CloudFormation, etc.)",
+    "Deployment successful",
+    "Security scan passed",
+    "Cost estimate provided"
+  ]
+}

package/claude-assets/skills/cfn-validation-templates/research.json

@@ -0,0 +1,38 @@
+{
+  "domain": "research",
+  "validation_criteria": {
+    "critical": [
+      "Research question clearly stated",
+      "Methodology described and appropriate",
+      "Sources cited with proper attribution",
+      "Findings supported by evidence",
+      "No fabricated or falsified data"
+    ],
+    "important": [
+      "Sample size adequate for conclusions",
+      "Statistical methods appropriate and correct",
+      "Limitations acknowledged",
+      "Reproducible methodology",
+      "Peer-reviewed sources prioritized",
+      "Bias assessed and addressed",
+      "Ethical considerations addressed"
+    ],
+    "nice_to_have": [
+      "Novel insights or contributions",
+      "Comprehensive literature review",
+      "Data visualizations clear and effective",
+      "Future research directions suggested",
+      "Practical implications discussed"
+    ]
+  },
+  "success_metrics": {
+    "gate_threshold": 0.75,
+    "consensus_threshold": 0.90
+  },
+  "deliverable_requirements": [
+    "Research report or paper",
+    "Bibliography with cited sources",
+    "Data analysis artifacts (if applicable)",
+    "Methodology documentation"
+  ]
+}

package/claude-assets/skills/cfn-validation-templates/software.json

@@ -0,0 +1,38 @@
+{
+  "domain": "software-development",
+  "validation_criteria": {
+    "critical": [
+      "All tests pass (unit, integration, e2e)",
+      "Security scan shows no CRITICAL or HIGH vulnerabilities",
+      "Build succeeds without errors",
+      "No syntax or runtime errors",
+      "Core functionality works as specified"
+    ],
+    "important": [
+      "Code coverage ≥ 80%",
+      "No linter errors or warnings",
+      "Documentation updated (README, API docs, inline comments)",
+      "Error handling implemented",
+      "Edge cases covered in tests",
+      "No hardcoded secrets or credentials",
+      "Follows project coding standards"
+    ],
+    "nice_to_have": [
+      "Performance benchmarks improved or maintained",
+      "Tech debt reduced (code complexity, duplication)",
+      "Accessibility standards met (WCAG 2.1 AA)",
+      "Logging and monitoring added",
+      "Code is well-refactored and maintainable"
+    ]
+  },
+  "success_metrics": {
+    "gate_threshold": 0.75,
+    "consensus_threshold": 0.90
+  },
+  "deliverable_requirements": [
+    "Source code files created/modified",
+    "Test files with passing tests",
+    "Documentation updated",
+    "No critical security issues"
+  ]
+}

package/claude-assets/skills/cfn-web-portal/DESIGN.md

@@ -0,0 +1,117 @@
+# Web Portal Skills Wrapper: Design Specification
+
+## Architecture Overview
+
+### WebSocket Coordination Patterns
+- Core Implementation: Redis pub/sub with Socket.IO
+- Event Types: 
+  * agent_update
+  * metrics_update
+  * event_stream
+  * connection_status
+
+### API Endpoints
+1. Authentication
+   - `/api/auth/login`
+   - `/api/auth/logout`
+   - `/api/auth/refresh`
+
+2. Metrics
+   - `/api/metrics/current`
+   - `/api/metrics/historical`
+
+3. Agents
+   - `/api/agents/status`
+   - `/api/agents/hierarchy`
+
+4. Events
+   - `/api/events/stream`
+   - `/api/events/timeline`
+
+## Skill Wrapper Interface Scripts
+
+### 1. `invoke-portal-start.sh`
+- Lifecycle management for web portal server
+- Redis-coordinated startup sequence
+- Health check integration
+
+### 2. `invoke-portal-metrics.sh`
+- Retrieve current and historical metrics
+- Aggregate metrics from multiple sources
+- Store metrics in SQLite memory with project-level ACL
+
+### 3. `invoke-portal-dashboard.sh`
+- Fetch dashboard data
+- WebSocket coordination for real-time updates
+- Implement filtering and data transformation
+
+### 4. `invoke-portal-agents.sh`
+- Agent status retrieval
+- Hierarchical agent state management
+- Confidence and performance tracking
+
+### 5. `invoke-portal-events.sh`
+- Event timeline generation
+- Filter and aggregate events
+- Support for historical and real-time event streams
+
+### 6. `invoke-portal-stop.sh`
+- Graceful server shutdown
+- Clear WebSocket connections
+- Store final metrics and state
+
+## Security Considerations
+- Use project-level SQLite memory ACL
+- Implement rate limiting
+- WebSocket authentication
+- Secure event filtering
+- Payload size validation
+
+## Performance Optimizations
+- Compression for large payloads
+- Efficient Redis pub/sub patterns
+- Minimal API call overhead
+- Caching strategies for frequently accessed data
+
+## Test Suite Structure
+- 8 comprehensive test scripts
+- Cover each invoke script
+- Validate coordination mechanisms
+- Performance and security testing
+
+## Redis Coordination Channels
+- `web-portal:metrics`
+- `web-portal:agents`
+- `web-portal:events`
+- `web-portal:lifecycle`
+
+## Confidence Scoring Mechanism
+\`\`\`typescript
+interface PortalSkillConfidence {
+  overall: number;  // 0.0 - 1.0
+  metrics: number;
+  agents: number;
+  events: number;
+  performance: number;
+}
+\`\`\`
+
+## Metrics Collection Strategy
+- 5-minute rolling window
+- Per-agent and aggregate metrics
+- Confidence-based data validation
+
+## Error Handling
+- Graceful degradation
+- Retry mechanisms
+- Detailed error logging
+- Fallback data strategies
+
+## Integrations
+- Slash command `/launch-web-dashboard`
+- CFN Loop validation hooks
+- Swarm coordination primitives
+
+---
+
+Confidence Score: 0.87