claude-flow-novice 2.18.6 → 2.18.7

package/claude-assets/skills/cfn-agent-tooling/lib/linter/lint-agents.sh

@@ -1,271 +0,0 @@
-#!/usr/bin/env bash
-#
-# Agent Validation Linter
-# Enforces validation pattern compliance across all agent profiles
-#
-# Usage:
-#   ./.claude/skills/agent-validation-linter/lint-agents.sh [OPTIONS]
-#
-# Options:
-#   --fix          Auto-fix agents that can be automatically corrected
-#   --strict       Fail on any violations (exit code 1)
-#   --summary      Show summary only (no detailed output)
-#   --agent <path> Lint specific agent file
-#
-# Exit Codes:
-#   0 - All agents compliant or --strict not set
-#   1 - Violations found and --strict mode enabled
-
-set -euo pipefail
-
-# Configuration
-AGENTS_DIR=".claude/agents/cfn-dev-team"
-VALIDATION_SKILL_PATH=".claude/skills/json-validation/validate-success-criteria.sh"
-REQUIRED_SOURCE_PATTERN='source .claude/skills/json-validation/validate-success-criteria.sh'
-REQUIRED_VALIDATION_CALL='validate_success_criteria'
-
-# Options
-FIX_MODE=false
-STRICT_MODE=false
-SUMMARY_ONLY=false
-SPECIFIC_AGENT=""
-
-# Counters
-TOTAL_AGENTS=0
-COMPLIANT_AGENTS=0
-VIOLATIONS_FOUND=0
-AUTO_FIXED=0
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Parse arguments
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --fix)
-            FIX_MODE=true
-            shift
-            ;;
-        --strict)
-            STRICT_MODE=true
-            shift
-            ;;
-        --summary)
-            SUMMARY_ONLY=true
-            shift
-            ;;
-        --agent)
-            SPECIFIC_AGENT="$2"
-            shift 2
-            ;;
-        --help)
-            echo "Usage: $0 [OPTIONS]"
-            echo ""
-            echo "Options:"
-            echo "  --fix          Auto-fix agents that can be automatically corrected"
-            echo "  --strict       Fail on any violations (exit code 1)"
-            echo "  --summary      Show summary only (no detailed output)"
-            echo "  --agent <path> Lint specific agent file"
-            echo ""
-            echo "Checks:"
-            echo "  1. Validation skill is sourced"
-            echo "  2. validate_success_criteria() is called"
-            echo "  3. Inline validation code is removed (if using centralized skill)"
-            echo "  4. Provider configuration is present"
-            exit 0
-            ;;
-        *)
-            echo "Unknown option: $1"
-            echo "Use --help for usage information"
-            exit 1
-            ;;
-    esac
-done
-
-# Lint a single agent file
-lint_agent() {
-    local agent_file="$1"
-    local agent_name
-    agent_name=$(basename "$agent_file" .md)
-
-    TOTAL_AGENTS=$((TOTAL_AGENTS + 1))
-
-    local violations=()
-    local can_auto_fix=true
-
-    # Check 1: Validation skill is sourced
-    if ! grep -q "$REQUIRED_SOURCE_PATTERN" "$agent_file"; then
-        violations+=("Missing centralized validation skill source")
-        # Can auto-fix by injecting source statement
-    fi
-
-    # Check 2: validate_success_criteria() is called
-    if ! grep -q "$REQUIRED_VALIDATION_CALL" "$agent_file"; then
-        violations+=("Missing validate_success_criteria() call")
-        # Can auto-fix by adding call after source
-    fi
-
-    # Check 3: No inline validation code (old pattern)
-    if grep -q 'echo "\$AGENT_SUCCESS_CRITERIA" | jq -e' "$agent_file" 2>/dev/null; then
-        violations+=("Contains inline validation code (should use centralized skill)")
-        can_auto_fix=false  # Manual review needed for refactoring
-    fi
-
-    # Check 4: Provider configuration present
-    if ! grep -q "PROVIDER_PARAMETERS" "$agent_file"; then
-        violations+=("Missing provider configuration (PROVIDER_PARAMETERS)")
-        # Can auto-fix by adding default provider config
-    fi
-
-    # Report violations
-    if [[ ${#violations[@]} -eq 0 ]]; then
-        COMPLIANT_AGENTS=$((COMPLIANT_AGENTS + 1))
-        if [[ "$SUMMARY_ONLY" == "false" ]]; then
-            echo -e "${GREEN}✓${NC} $agent_name"
-        fi
-        return 0
-    else
-        VIOLATIONS_FOUND=$((VIOLATIONS_FOUND + ${#violations[@]}))
-
-        if [[ "$SUMMARY_ONLY" == "false" ]]; then
-            echo -e "${RED}✗${NC} $agent_name"
-            for violation in "${violations[@]}"; do
-                echo -e "  ${YELLOW}⚠${NC}  $violation"
-            done
-
-            if [[ "$FIX_MODE" == "true" && "$can_auto_fix" == "true" ]]; then
-                echo -e "  ${BLUE}🔧${NC}  Auto-fixing..."
-                auto_fix_agent "$agent_file" "${violations[@]}"
-            elif [[ "$FIX_MODE" == "true" && "$can_auto_fix" == "false" ]]; then
-                echo -e "  ${YELLOW}⚠${NC}   Cannot auto-fix (manual review required)"
-            fi
-        fi
-        return 1
-    fi
-}
-
-# Auto-fix agent violations
-auto_fix_agent() {
-    local agent_file="$1"
-    shift
-    local violations=("$@")
-
-    local fixed=false
-
-    # Create backup
-    cp "$agent_file" "${agent_file}.bak"
-
-    for violation in "${violations[@]}"; do
-        case "$violation" in
-            "Missing centralized validation skill source")
-                # Find Success Criteria Awareness section and inject source
-                if grep -q "## Success Criteria" "$agent_file"; then
-                    # Insert after "### 1. Read Success Criteria" or similar
-                    sed -i '/### 1\. Read Success Criteria/a\\n```bash\n# Source centralized validation skill\nsource .claude/skills/json-validation/validate-success-criteria.sh\n\n# Validate on startup (exits on invalid JSON)\nvalidate_success_criteria || exit 1\n```\n' "$agent_file"
-                    fixed=true
-                fi
-                ;;
-
-            "Missing validate_success_criteria() call")
-                # Add call if source exists but call doesn't
-                if grep -q "$REQUIRED_SOURCE_PATTERN" "$agent_file" && ! grep -q "$REQUIRED_VALIDATION_CALL" "$agent_file"; then
-                    sed -i "/source.*validate-success-criteria\.sh/a\\validate_success_criteria || exit 1" "$agent_file"
-                    fixed=true
-                fi
-                ;;
-
-            "Missing provider configuration (PROVIDER_PARAMETERS)")
-                # Insert provider parameters after frontmatter
-                if grep -q "^---$" "$agent_file"; then
-                    # Find the closing --- of frontmatter
-                    sed -i '/^---$/,/^---$/{
-                        /^---$/a\\n<!-- PROVIDER_PARAMETERS\nprovider: zai\nmodel: glm-4.6\n-->
-                    }' "$agent_file"
-                    fixed=true
-                fi
-                ;;
-        esac
-    done
-
-    if [[ "$fixed" == "true" ]]; then
-        AUTO_FIXED=$((AUTO_FIXED + 1))
-        echo -e "  ${GREEN}✓${NC}  Fixed $(basename "$agent_file")"
-        # Remove backup on successful fix
-        rm "${agent_file}.bak"
-    else
-        # Restore from backup if no fixes applied
-        mv "${agent_file}.bak" "$agent_file"
-    fi
-}
-
-# Main execution
-echo "Agent Validation Linter"
-echo "======================="
-echo ""
-
-if [[ -n "$SPECIFIC_AGENT" ]]; then
-    # Lint specific agent
-    if [[ ! -f "$SPECIFIC_AGENT" ]]; then
-        echo -e "${RED}Error:${NC} Agent file not found: $SPECIFIC_AGENT"
-        exit 1
-    fi
-    lint_agent "$SPECIFIC_AGENT"
-else
-    # Lint all agents
-    echo "Scanning: $AGENTS_DIR/**/*.md"
-    echo ""
-
-    # Find all agent markdown files
-    while IFS= read -r agent_file; do
-        # Skip README files
-        if [[ "$(basename "$agent_file")" == "README.md" || "$(basename "$agent_file")" == "CLAUDE.md" ]]; then
-            continue
-        fi
-
-        lint_agent "$agent_file"
-    done < <(find "$AGENTS_DIR" -type f -name "*.md")
-fi
-
-# Print summary
-echo ""
-echo "======================="
-echo "Summary"
-echo "======================="
-echo -e "Total agents scanned:  $TOTAL_AGENTS"
-echo -e "${GREEN}Compliant:${NC}             $COMPLIANT_AGENTS"
-
-NON_COMPLIANT=$((TOTAL_AGENTS - COMPLIANT_AGENTS))
-if [[ $NON_COMPLIANT -gt 0 ]]; then
-    echo -e "${RED}Non-compliant:${NC}         $NON_COMPLIANT"
-    echo -e "${YELLOW}Total violations:${NC}      $VIOLATIONS_FOUND"
-else
-    echo -e "Non-compliant:         0"
-fi
-
-if [[ "$FIX_MODE" == "true" && "$AUTO_FIXED" -gt 0 ]]; then
-    echo -e "${BLUE}Auto-fixed:${NC}            $AUTO_FIXED"
-fi
-
-# Calculate compliance rate
-if [[ $TOTAL_AGENTS -gt 0 ]]; then
-    COMPLIANCE_RATE=$(awk "BEGIN {printf \"%.1f\", ($COMPLIANT_AGENTS / $TOTAL_AGENTS) * 100}")
-    echo -e "Compliance rate:       ${COMPLIANCE_RATE}%"
-fi
-
-echo ""
-
-# Exit with appropriate code
-if [[ "$STRICT_MODE" == "true" && $NON_COMPLIANT -gt 0 ]]; then
-    echo -e "${RED}✗ STRICT MODE: Violations found${NC}"
-    exit 1
-elif [[ $NON_COMPLIANT -gt 0 ]]; then
-    echo -e "${YELLOW}⚠ Violations found (use --fix to auto-correct)${NC}"
-    exit 0
-else
-    echo -e "${GREEN}✓ All agents compliant${NC}"
-    exit 0
-fi

package/claude-assets/skills/cfn-cerebras-mcp/SKILL.md

@@ -1,58 +0,0 @@
-# Cerebras MCP Code Generation
-
-Fast code generation via `mcp__cerebras-mcp__write` tool.
-
-## When to Use
-
-Use for generating or modifying code files when speed matters. Prompt must be SHORTER than expected output.
-
-## Usage
-
-```
-mcp__cerebras-mcp__write:
-  file_path: /absolute/path/to/file.ts
-  prompt: |
-    Function: validateEmail(email: string): boolean
-    Steps:
-    - Regex test /^[^@]+@[^@]+\.[^@]+$/
-    - Return boolean result
-    Imports: none
-    Errors: none
-  context_files:
-    - /path/to/related/file.ts
-```
-
-## Prompt Format (Blueprint Style)
-
-```
-File: /path/to/file.ts
-Function: functionName(params): returnType
-Steps:
-- Step 1
-- Step 2
-Imports: import { X } from './y'
-Errors: throw new Error("message")
-```
-
-## Rules
-
-1. **Prompt < Output**: Blueprint must be shorter than generated code
-2. **Always include context_files**: When code needs imports from existing files
-3. **Absolute paths only**: Use full paths, not relative
-4. **One file per call**: Generate/modify single file
-
-## Bad vs Good
-
-**Bad** (verbose):
-```
-I need you to create a function that validates email addresses.
-The function should take an email string as input and return true
-if valid or false if invalid...
-```
-
-**Good** (blueprint):
-```
-Function: validateEmail(email: string): boolean
-- Regex: /^[^@]+@[^@]+\.[^@]+$/
-- Return: true if match, false otherwise
-```

package/claude-assets/skills/cfn-config/SKILL.md

@@ -1,52 +0,0 @@
----
-name: cfn-config
-description: Configuration management and environment sanitization
-version: 1.0.0
-tags: [mega-skill, config, environment, sanitization]
-status: production
----
-
-# Config Skill (Mega-Skill)
-
-**Version:** 1.0.0
-**Purpose:** Configuration management and environment sanitization
-**Status:** Production
-**Consolidates:** cfn-config-management, cfn-environment-sanitization
-
----
-
-## Overview
-
-This mega-skill provides configuration handling:
-- **Management** - Configuration file management and updates
-- **Sanitization** - Environment variable sanitization and validation
-
----
-
-## Directory Structure
-
-```
-config/
-├── SKILL.md
-├── lib/
-│   ├── management/       # From cfn-config-management
-│   └── sanitization/     # From cfn-environment-sanitization
-└── cli/
-```
-
----
-
-## Migration Paths
-
-| Old Path | New Path |
-|----------|----------|
-| cfn-config-management/ | config/lib/management/ |
-| cfn-environment-sanitization/ | config/lib/sanitization/ |
-
----
-
-## Version History
-
-### 1.0.0 (2025-12-02)
-- Consolidated 2 config skills into mega-skill
-

package/claude-assets/skills/cfn-config/lib/management/README.md

@@ -1,42 +0,0 @@
-# Configuration Management Skill
-
-## Prerequisites
-- Node.js 18+
-- jq
-- ajv-cli
-
-## Installation
-```bash
-npm install -g ajv-cli
-```
-
-## Configuration Commands
-```bash
-# Get a configuration value
-./manage-config.sh get redis.host
-
-# Set a configuration value
-./manage-config.sh set agent.log_level "debug"
-
-# List all configurations
-./manage-config.sh list
-
-# Reset to defaults
-./manage-config.sh reset
-```
-
-## Dependency Check
-```bash
-./check-dependencies.sh
-```
-
-## Permissions
-```bash
-chmod +x manage-config.sh
-chmod +x check-dependencies.sh
-```
-
-## Security Notes
-- Configuration is stored in `~/.claude-flow-config.json`
-- Validated against JSON schema
-- Atomic updates prevent race conditions

package/claude-assets/skills/cfn-config/lib/management/SKILL.md

@@ -1,34 +0,0 @@
-# Configuration Management Skill
-
-## Overview
-This skill provides a robust, type-safe configuration management system for the Claude Flow Novice project.
-
-## Key Features
-- Type-safe configuration management
-- Schema validation
-- Export/Import configurations
-- Centralized configuration storage
-- Dependency checking
-
-## Interfaces
-- Get configuration values
-- Set configuration values
-- List all configurations
-- Reset to defaults
-- Validate configuration schema
-
-## Usage Guidelines
-- Always validate configuration before setting
-- Use TypeScript for type safety
-- Leverage JSON schema for validation
-- Minimal external dependencies
-
-## Integration
-- Accessible via CLI
-- Supports agent-based configuration updates
-- Redis coordination for distributed config management
-
-## Security Considerations
-- Sanitize input
-- Prevent arbitrary code execution
-- Validate configuration schemas strictly

package/claude-assets/skills/cfn-config/lib/management/check-dependencies.sh

@@ -1,56 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# Dependency Checker for Config Management
-
-# Required and optional dependencies
-REQUIRED_DEPENDENCIES=("jq")
-OPTIONAL_DEPENDENCIES=("ajv")
-
-check_dependency() {
-    if ! command -v "$1" &> /dev/null; then
-        echo "Dependency not found: $1"
-        return 1
-    fi
-}
-
-install_optional_dependencies() {
-    local missing_optional=()
-
-    for dep in "${OPTIONAL_DEPENDENCIES[@]}"; do
-        if ! check_dependency "$dep"; then
-            missing_optional+=("$dep")
-        fi
-    done
-
-    if [ ${#missing_optional[@]} -gt 0 ]; then
-        echo "Note: Optional dependencies not found: ${missing_optional[*]}"
-        echo "Some advanced features may be limited."
-        return 0  # Not a hard failure
-    fi
-}
-
-main() {
-    local missing_required=()
-
-    # Check required dependencies
-    for dep in "${REQUIRED_DEPENDENCIES[@]}"; do
-        if ! check_dependency "$dep"; then
-            missing_required+=("$dep")
-        fi
-    done
-
-    if [ ${#missing_required[@]} -gt 0 ]; then
-        echo "ERROR: Missing critical dependencies: ${missing_required[*]}"
-        echo "Please install these dependencies to use the config management skill."
-        exit 1
-    fi
-
-    # Check optional dependencies (non-blocking)
-    install_optional_dependencies
-
-    echo "Dependencies check passed."
-    exit 0
-}
-
-main "$@"

package/claude-assets/skills/cfn-config/lib/management/config.json

@@ -1,32 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "title": "Claude Flow Novice Configuration",
-    "type": "object",
-    "properties": {
-        "redis": {
-            "type": "object",
-            "properties": {
-                "host": {"type": "string", "default": "localhost"},
-                "port": {"type": "number", "default": 6379},
-                "password": {"type": "string"}
-            },
-            "required": ["host", "port"]
-        },
-        "agent": {
-            "type": "object",
-            "properties": {
-                "default_strategy": {"type": "string", "default": "development"},
-                "max_concurrent_agents": {"type": "number", "default": 5},
-                "log_level": {"type": "string", "enum": ["debug", "info", "warn", "error"], "default": "info"}
-            }
-        },
-        "security": {
-            "type": "object",
-            "properties": {
-                "enabled": {"type": "boolean", "default": true},
-                "max_retry_attempts": {"type": "number", "default": 3}
-            }
-        }
-    },
-    "required": ["redis", "agent"]
-}

package/claude-assets/skills/cfn-config/lib/management/manage-config.sh

@@ -1,113 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# Config Management CLI Wrapper with Nested Support
-
-CONFIG_FILE="${HOME}/.claude-flow-config.json"
-SCHEMA_FILE="/mnt/c/Users/masha/Documents/claude-flow-novice/.claude/skills/cfn-config-management/config.json"
-
-# Validate JSON against schema
-validate_config() {
-    if command -v ajv &> /dev/null; then
-        ajv validate -s "$SCHEMA_FILE" -d "$1"
-    else
-        echo "Warning: JSON schema validation skipped. Install 'ajv' for full validation."
-        return 0
-    fi
-}
-
-# Get nested configuration value
-get_config() {
-    local key="$1"
-    jq -r "$key" "$CONFIG_FILE" 2>/dev/null || echo "Key not found: $key"
-}
-
-# Set nested configuration value with advanced handling
-set_config() {
-    local key="$1"
-    local value="$2"
-
-    # Temp file for atomic write
-    temp_file=$(mktemp)
-
-    # Handle nested key updates
-    jq "$key = $value" "$CONFIG_FILE" > "$temp_file"
-
-    # Validate before overwriting
-    if validate_config "$temp_file"; then
-        mv "$temp_file" "$CONFIG_FILE"
-        echo "Configuration updated successfully."
-    else
-        rm "$temp_file"
-        echo "Invalid configuration. Update rejected."
-        exit 1
-    fi
-}
-
-# Merge configurations
-merge_config() {
-    local config_to_merge="$1"
-
-    # Temp file for atomic write
-    temp_file=$(mktemp)
-
-    # Deep merge using jq
-    jq -s '.[0] * .[1]' "$CONFIG_FILE" "$config_to_merge" > "$temp_file"
-
-    # Validate before overwriting
-    if validate_config "$temp_file"; then
-        mv "$temp_file" "$CONFIG_FILE"
-        echo "Configuration merged successfully."
-    else
-        rm "$temp_file"
-        echo "Invalid merged configuration. Update rejected."
-        exit 1
-    fi
-}
-
-# List all configurations
-list_config() {
-    cat "$CONFIG_FILE"
-}
-
-# Reset to defaults
-reset_config() {
-    cp "$SCHEMA_FILE" "$CONFIG_FILE"
-    echo "Configuration reset to defaults."
-}
-
-# Create config file if it doesn't exist
-ensure_config_file() {
-    if [ ! -f "$CONFIG_FILE" ]; then
-        reset_config
-    fi
-}
-
-# Main command dispatcher
-main() {
-    ensure_config_file
-
-    case "$1" in
-        get)
-            get_config "$2"
-            ;;
-        set)
-            set_config "$2" "$3"
-            ;;
-        merge)
-            merge_config "$2"
-            ;;
-        list)
-            list_config
-            ;;
-        reset)
-            reset_config
-            ;;
-        *)
-            echo "Usage: $0 {get|set|merge|list|reset} [key] [value]"
-            exit 1
-            ;;
-    esac
-}
-
-main "$@"