claude-flow-novice 2.18.6 → 2.18.8

package/claude-assets/skills/cfn-skill-management/lib/loader/execute.sh

@@ -1,344 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-
-###############################################################################
-# CFN Skill Loader - Execution Script
-#
-# High-performance skill loading with LRU caching and hash validation.
-# Provides command-line interface for skill loading operations.
-#
-# Usage:
-#   ./execute.sh --agent-type <type> [options]
-#
-# Options:
-#   --agent-type <type>       Agent type to load skills for (required)
-#   --task-context <keywords> Comma-separated context keywords (optional)
-#   --max-skills <num>        Maximum skills to load (default: 20)
-#   --phase <phase>           CFN Loop phase filter (optional)
-#   --no-bootstrap            Exclude bootstrap skills (default: include)
-#   --benchmark               Run performance benchmarks
-#   --iterations <num>        Benchmark iteration count (default: 10)
-#   --clear-cache             Clear skill cache before loading
-#   --preload <skills>        Preload specified skills (comma-separated)
-#   --validate-only           Only validate cached skills, don't load
-#   --stats                   Show cache statistics only
-#   --help                    Show this help message
-#
-# Examples:
-#   # Load skills for backend developer with authentication context
-#   ./execute.sh --agent-type backend-developer --task-context "authentication,api"
-#
-#   # Load Loop 3 skills with limit
-#   ./execute.sh --agent-type tester --phase loop3 --max-skills 10
-#
-#   # Benchmark performance
-#   ./execute.sh --benchmark --iterations 20
-#
-#   # Preload common skills for cache warming
-#   ./execute.sh --preload "cfn-coordination,hook-pipeline,pre-edit-backup"
-#
-###############################################################################
-
-# Default values
-AGENT_TYPE=""
-TASK_CONTEXT=""
-MAX_SKILLS=20
-PHASE=""
-INCLUDE_BOOTSTRAP="true"
-BENCHMARK="false"
-ITERATIONS=10
-CLEAR_CACHE="false"
-PRELOAD_SKILLS=""
-VALIDATE_ONLY="false"
-STATS_ONLY="false"
-
-# Parse arguments
-while [[ $# -gt 0 ]]; do
-  case $1 in
-    --agent-type)
-      AGENT_TYPE="$2"
-      shift 2
-      ;;
-    --task-context)
-      TASK_CONTEXT="$2"
-      shift 2
-      ;;
-    --max-skills)
-      MAX_SKILLS="$2"
-      shift 2
-      ;;
-    --phase)
-      PHASE="$2"
-      shift 2
-      ;;
-    --no-bootstrap)
-      INCLUDE_BOOTSTRAP="false"
-      shift
-      ;;
-    --benchmark)
-      BENCHMARK="true"
-      shift
-      ;;
-    --iterations)
-      ITERATIONS="$2"
-      shift 2
-      ;;
-    --clear-cache)
-      CLEAR_CACHE="true"
-      shift
-      ;;
-    --preload)
-      PRELOAD_SKILLS="$2"
-      shift 2
-      ;;
-    --validate-only)
-      VALIDATE_ONLY="true"
-      shift
-      ;;
-    --stats)
-      STATS_ONLY="true"
-      shift
-      ;;
-    --help)
-      head -n 50 "$0" | grep '^#' | sed 's/^# //'
-      exit 0
-      ;;
-    *)
-      echo "Unknown option: $1"
-      echo "Use --help for usage information"
-      exit 1
-      ;;
-  esac
-done
-
-# Script directory
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
-
-# TypeScript execution helper
-run_typescript() {
-  local code="$1"
-
-  npx tsx -e "
-import { SkillLoader, getGlobalLoader } from '${PROJECT_ROOT}/src/cli/skill-loader';
-import { SkillCacheValidator, getGlobalValidator } from '${PROJECT_ROOT}/src/cli/skill-cache-validator';
-import { DatabaseService } from '${PROJECT_ROOT}/src/lib/database-service';
-import { createLogger } from '${PROJECT_ROOT}/src/lib/logging';
-
-const logger = createLogger('skill-loader-cli');
-
-async function main() {
-  ${code}
-}
-
-main().catch(error => {
-  console.error('ERROR:', error.message);
-  process.exit(1);
-});
-"
-}
-
-# Show cache statistics
-if [[ "$STATS_ONLY" == "true" ]]; then
-  run_typescript "
-    const loader = getGlobalLoader(undefined, logger);
-    const stats = loader.getCacheStats();
-
-    console.log(JSON.stringify({
-      cacheSize: stats.size,
-      maxSize: stats.maxSize,
-      ttlMinutes: stats.ttlMinutes,
-      utilizationPercent: ((stats.size / stats.maxSize) * 100).toFixed(2)
-    }, null, 2));
-  "
-  exit 0
-fi
-
-# Clear cache if requested
-if [[ "$CLEAR_CACHE" == "true" ]]; then
-  echo "Clearing skill cache..."
-  run_typescript "
-    const loader = getGlobalLoader(undefined, logger);
-    loader.clearCache();
-    console.log('Cache cleared successfully');
-  "
-fi
-
-# Preload skills
-if [[ -n "$PRELOAD_SKILLS" ]]; then
-  echo "Preloading skills: $PRELOAD_SKILLS"
-  run_typescript "
-    const skillIds = '${PRELOAD_SKILLS}'.split(',').map(s => s.trim());
-    const loader = getGlobalLoader(undefined, logger);
-
-    await loader.preloadSkills(skillIds);
-
-    const stats = loader.getCacheStats();
-    console.log(\`Preloaded \${skillIds.length} skills. Cache size: \${stats.size}\`);
-  "
-  exit 0
-fi
-
-# Validate cached skills only
-if [[ "$VALIDATE_ONLY" == "true" ]]; then
-  echo "Validating cached skills..."
-  run_typescript "
-    const validator = getGlobalValidator(logger);
-    const loader = getGlobalLoader(undefined, logger);
-
-    const stats = loader.getCacheStats();
-    console.log(\`Validating \${stats.size} cached skills...\`);
-
-    // Note: Actual validation requires access to cache internals
-    // This is a placeholder for the validation logic
-    console.log('Validation completed');
-  "
-  exit 0
-fi
-
-# Run benchmark
-if [[ "$BENCHMARK" == "true" ]]; then
-  echo "Running performance benchmark ($ITERATIONS iterations)..."
-  run_typescript "
-    const dbService = new DatabaseService({
-      sqlite: {
-        type: 'sqlite',
-        database: '${PROJECT_ROOT}/.claude/skills/cfn-redis-coordination/data/cfn-loop.db'
-      }
-    });
-
-    await dbService.connect();
-
-    const loader = new SkillLoader(dbService, logger);
-
-    const coldStartTime = Date.now();
-    const coldResult = await loader.loadContextualSkills({
-      agentType: 'backend-developer',
-      taskContext: ['authentication', 'api'],
-      maxSkills: 20,
-      includeBootstrap: true
-    });
-    const coldDuration = Date.now() - coldStartTime;
-
-    // Warm loads
-    const warmDurations: number[] = [];
-    for (let i = 0; i < ${ITERATIONS}; i++) {
-      const startTime = Date.now();
-      await loader.loadContextualSkills({
-        agentType: 'backend-developer',
-        taskContext: ['authentication', 'api'],
-        maxSkills: 20,
-        includeBootstrap: true
-      });
-      warmDurations.push(Date.now() - startTime);
-    }
-
-    const avgWarmDuration = warmDurations.reduce((a, b) => a + b, 0) / warmDurations.length;
-    const minWarmDuration = Math.min(...warmDurations);
-    const maxWarmDuration = Math.max(...warmDurations);
-
-    console.log(JSON.stringify({
-      coldLoad: {
-        durationMs: coldDuration,
-        skillsLoaded: coldResult.totalSkills,
-        slaTarget: 1000,
-        passedSLA: coldDuration < 1000
-      },
-      warmLoad: {
-        iterations: ${ITERATIONS},
-        avgDurationMs: avgWarmDuration.toFixed(2),
-        minDurationMs: minWarmDuration,
-        maxDurationMs: maxWarmDuration,
-        slaTarget: 100,
-        passedSLA: avgWarmDuration < 100
-      },
-      cache: {
-        hits: coldResult.cacheHitCount,
-        misses: coldResult.cacheMissCount
-      }
-    }, null, 2));
-
-    await dbService.disconnect();
-  "
-  exit 0
-fi
-
-# Load skills (main operation)
-if [[ -z "$AGENT_TYPE" ]]; then
-  echo "ERROR: --agent-type is required"
-  echo "Use --help for usage information"
-  exit 1
-fi
-
-echo "Loading skills for agent type: $AGENT_TYPE"
-
-# Build task context array
-TASK_CONTEXT_ARRAY="[]"
-if [[ -n "$TASK_CONTEXT" ]]; then
-  TASK_CONTEXT_ARRAY="['$(echo "$TASK_CONTEXT" | sed "s/,/', '/g")']"
-fi
-
-# Build phase parameter
-PHASE_PARAM="undefined"
-if [[ -n "$PHASE" ]]; then
-  PHASE_PARAM="'$PHASE'"
-fi
-
-run_typescript "
-  const dbService = new DatabaseService({
-    sqlite: {
-      type: 'sqlite',
-      database: '${PROJECT_ROOT}/.claude/skills/cfn-redis-coordination/data/cfn-loop.db'
-    }
-  });
-
-  try {
-    await dbService.connect();
-  } catch (error) {
-    logger.warn('Database connection failed, using bootstrap skills only');
-  }
-
-  const loader = new SkillLoader(dbService, logger);
-
-  const result = await loader.loadContextualSkills({
-    agentType: '${AGENT_TYPE}',
-    taskContext: ${TASK_CONTEXT_ARRAY},
-    maxSkills: ${MAX_SKILLS},
-    includeBootstrap: ${INCLUDE_BOOTSTRAP},
-    phase: ${PHASE_PARAM}
-  });
-
-  console.log(JSON.stringify({
-    success: true,
-    agentType: '${AGENT_TYPE}',
-    skillsLoaded: result.totalSkills,
-    bootstrapSkills: result.bootstrapCount,
-    agentSkills: result.totalSkills - result.bootstrapCount,
-    loadTimeMs: result.loadTimeMs,
-    cache: {
-      hits: result.cacheHitCount,
-      misses: result.cacheMissCount,
-      hitRate: result.cacheHitCount > 0
-        ? ((result.cacheHitCount / (result.cacheHitCount + result.cacheMissCount)) * 100).toFixed(2) + '%'
-        : 'N/A'
-    },
-    performance: {
-      metColdSLA: result.loadTimeMs < 1000,
-      metWarmSLA: result.cacheHitCount > 0 && result.loadTimeMs < 100
-    },
-    skills: result.skills.map(s => ({
-      id: s.id,
-      name: s.name,
-      version: s.version,
-      namespace: s.namespace,
-      priority: s.priority
-    }))
-  }, null, 2));
-
-  if (dbService) {
-    await dbService.disconnect();
-  }
-"
-
-echo ""
-echo "Skill loading completed successfully"

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

@@ -1,233 +0,0 @@
-# Skill Propagation System - TypeScript Implementation
-
-This is a TypeScript port of the `propagate-skill-update.sh` bash script from the workflow-codification skill.
-
-## Purpose
-
-The Skill Propagation System manages the distribution of skill updates through the CFN Loop infrastructure. It:
-
-- Validates skill metadata and version increments
-- Manages semantic versioning (major/minor/patch)
-- Calculates content hashes to detect actual changes
-- Updates skill records in the SQLite database
-- Records approval history
-- Notifies affected agents of updates
-
-## Architecture
-
-The system is organized into modular, testable components:
-
-### Core Modules
-
-- **`types.ts`** - Type definitions for all interfaces and data structures
-- **`logger.ts`** - Logging abstraction (ConsoleLogger, NoOpLogger)
-- **`version-manager.ts`** - Semantic version parsing and comparison
-- **`metadata-parser.ts`** - YAML frontmatter extraction and validation
-- **`file-system-adapter.ts`** - File operations (read, exists, hash)
-- **`database-adapter.ts`** - SQLite operations with parameterized queries
-- **`skill-validator.ts`** - Parameter and skill validation
-- **`skill-propagator.ts`** - Main orchestration logic
-- **`cli.ts`** - Command-line interface
-
-## Installation
-
-```bash
-cd .claude/skills/cfn-skill-propagation
-npm install
-npm run build
-```
-
-## Usage
-
-### TypeScript API
-
-```typescript
-import { createSkillPropagator } from '@cfn/skill-propagation';
-
-const propagator = await createSkillPropagator();
-
-const result = await propagator.propagate({
-  skillName: 'jwt-authentication',
-  newVersion: '1.0.1',
-  updatePath: './skill-v1.0.1.md',
-  changeType: 'patch',
-  notifyAgents: true,
-});
-
-console.log(result); // PropagationResult
-```
-
-### Command Line
-
-```bash
-# Using the bash wrapper
-./.claude/skills/cfn-skill-propagation/propagate-skill-update.sh \
-  jwt-authentication \
-  1.0.1 \
-  ./skill-v1.0.1.md \
-  patch \
-  true
-
-# Or directly with Node
-node dist/cli.js jwt-authentication 1.0.1 ./skill-v1.0.1.md patch true
-```
-
-### Environment Variables
-
-- `CFN_SKILLS_DB_PATH` - Path to SQLite database (default: `./.claude/skills-database/skills.db`)
-- `PHASE4_POSTGRES_HOST` - PostgreSQL host for Phase 4 integration (optional)
-- `PHASE4_POSTGRES_DB` - PostgreSQL database name (default: `workflow_codification`)
-- `PHASE4_POSTGRES_USER` - PostgreSQL username (optional)
-- `PHASE4_POSTGRES_PASS` - PostgreSQL password (optional)
-- `ENABLE_AGENT_NOTIFICATIONS` - Enable agent notifications (default: `false`)
-- `DEBUG` - Enable debug logging (set to `1`)
-
-## Development
-
-### Build
-
-```bash
-npm run build
-```
-
-### Test
-
-```bash
-# Run tests
-npm test
-
-# Run with coverage
-npm run test:coverage
-
-# Watch mode
-npm test:watch
-```
-
-### Linting
-
-```bash
-npm run lint
-npm run lint:fix
-```
-
-## API
-
-### SkillPropagator
-
-Main class that orchestrates the propagation process:
-
-```typescript
-propagate(options: SkillPropagationOptions): Promise<PropagationResult>
-```
-
-### VersionManager
-
-Semantic version utilities:
-
-- `parseVersion(version: string): VersionInfo`
-- `isValidVersion(version: string): boolean`
-- `compareVersions(current: string, next: string): VersionChangeType`
-- `validateVersionIncrement(current: string, next: string, expected: string): VersionComparisonResult`
-
-### SkillMetadataParser
-
-YAML frontmatter parser:
-
-- `parse(content: string): SkillMetadata`
-- `validate(metadata: SkillMetadata): ValidationResult`
-- `extractField(content: string, fieldName: string): string | null`
-
-### SkillValidator
-
-Input and skill validation:
-
-- `validateParameters(options: SkillPropagationOptions): Promise<ValidationResult>`
-- `validateSkillExists(skillName: string): Promise<boolean>`
-- `validateVersionIncrement(...): Promise<ValidationResult>`
-
-## Migration from Bash
-
-The TypeScript implementation provides complete feature parity with the bash version:
-
-| Feature | Bash | TypeScript |
-|---------|------|-----------|
-| Parameter validation | ✅ | ✅ |
-| Skill lookup | ✅ | ✅ |
-| Version validation | ✅ | ✅ |
-| Content hash calculation | ✅ | ✅ |
-| Metadata parsing | ✅ | ✅ |
-| Database updates | ✅ | ✅ |
-| Approval history | ✅ | ✅ |
-| Agent notifications | ✅ | ✅ |
-| Phase 4 integration | ✅ | ✅ |
-| Error handling | ✅ | ✅ |
-
-### Breaking Changes
-
-None - the TypeScript implementation maintains backward compatibility through the bash wrapper.
-
-## Type Safety
-
-The TypeScript implementation achieves:
-
-- **100% type coverage** - No `any` types
-- **Strict mode enabled** - Full strict TypeScript checking
-- **Discriminated unions** - Type-safe version change detection
-- **Generic constraints** - Proper database adapter abstraction
-
-## Performance
-
-Benchmarks show the TypeScript implementation performs within 20% of the bash version:
-
-- **Validation**: ~10ms (bash: ~8ms)
-- **Database queries**: ~25ms (bash: ~30ms)
-- **Hash calculation**: ~15ms (bash: ~12ms)
-- **Total propagation**: ~60ms (bash: ~50ms)
-
-The slight overhead is due to Node.js startup time and is negligible for typical usage patterns.
-
-## Testing
-
-The implementation includes 60+ tests covering:
-
-- Version parsing and comparison
-- Metadata extraction and validation
-- File system operations
-- Database operations
-- Parameter validation
-- Integration workflows
-- Error scenarios
-
-Coverage targets:
-
-- **Functions**: 80%+
-- **Lines**: 80%+
-- **Branches**: 75%+
-- **Statements**: 80%+
-
-## Error Codes
-
-Exit codes match the original bash implementation:
-
-- `0` - Success
-- `1` - Invalid parameters
-- `2` - File not found
-- `3` - Database error
-- `4` - Skill not found
-- `5` - Version/hash validation error
-- `6` - Database operation error
-
-## Contributing
-
-When modifying the system:
-
-1. Run tests: `npm test`
-2. Check coverage: `npm run test:coverage`
-3. Lint code: `npm run lint:fix`
-4. Build: `npm run build`
-
-## References
-
-- Original bash script: `./.claude/skills/workflow-codification/propagate-skill-update.sh`
-- Phase 4 documentation: `./.claude/skills/workflow-codification/README_PHASE4.md`
-- CFN Loop system: `./.claude/skills/cfn-loop-orchestration/`

package/claude-assets/skills/cfn-skill-management/lib/propagation/package.json

@@ -1,52 +0,0 @@
-{
-  "name": "@cfn/skill-propagation",
-  "version": "1.0.0",
-  "description": "TypeScript implementation of skill propagation system for CFN Loop",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "propagate-skill-update": "dist/cli.js"
-  },
-  "type": "module",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./package.json": "./package.json"
-  },
-  "scripts": {
-    "build": "tsc --project tsconfig.json",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "lint": "eslint src tests --ext .ts",
-    "lint:fix": "eslint src tests --ext .ts --fix",
-    "clean": "rm -rf dist coverage",
-    "prepublishOnly": "npm run build && npm test"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@types/jest": "^29.5.0",
-    "@types/node": "^20.0.0",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
-    "eslint": "^8.50.0",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.1",
-    "typescript": "^5.3.2"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "keywords": [
-    "cfn",
-    "skill",
-    "propagation",
-    "workflow",
-    "codification",
-    "typescript"
-  ],
-  "author": "CFN Team",
-  "license": "MIT"
-}

package/claude-assets/skills/cfn-skill-management/lib/propagation/propagate-skill-update.sh

@@ -1,32 +0,0 @@
-#!/usr/bin/env bash
-#
-# propagate-skill-update.sh - Bash wrapper for TypeScript Skill Propagation System
-#
-# This script provides backward compatibility with the original bash implementation
-# while delegating to the TypeScript implementation for core functionality.
-#
-# Usage:
-#   propagate-skill-update.sh SKILL_NAME NEW_VERSION UPDATE_PATH [CHANGE_TYPE] [NOTIFY_AGENTS]
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
-
-# Export environment variables for TypeScript CLI
-export CFN_SKILLS_DB_PATH="${CFN_SKILLS_DB_PATH:-./.claude/skills-database/skills.db}"
-export PHASE4_POSTGRES_HOST="${PHASE4_POSTGRES_HOST:-}"
-export PHASE4_POSTGRES_DB="${PHASE4_POSTGRES_DB:-workflow_codification}"
-export PHASE4_POSTGRES_USER="${PHASE4_POSTGRES_USER:-}"
-export PHASE4_POSTGRES_PASS="${PHASE4_POSTGRES_PASS:-}"
-export ENABLE_AGENT_NOTIFICATIONS="${ENABLE_AGENT_NOTIFICATIONS:-false}"
-export DEBUG="${DEBUG:-0}"
-
-# Check if TypeScript is compiled
-if [[ ! -f "$SCRIPT_DIR/dist/cli.js" ]]; then
-    echo "[ERROR] TypeScript build not found. Run 'npm run build' in $SCRIPT_DIR" >&2
-    exit 1
-fi
-
-# Run TypeScript implementation
-node "$SCRIPT_DIR/dist/cli.js" "$@"

package/claude-assets/skills/cfn-sprint-execution/SKILL.md

@@ -1,55 +0,0 @@
----
-name: cfn-sprint-execution
-description: Sprint planning, execution, and checkpointing for CFN Loop
-version: 1.0.0
-tags: [mega-skill, sprint, planning, execution, checkpoint]
-status: production
----
-
-# Sprint Execution Skill (Mega-Skill)
-
-**Version:** 1.0.0
-**Purpose:** Sprint planning, execution, and checkpointing for CFN Loop
-**Status:** Production
-**Consolidates:** cfn-sprint-execution, cfn-sprint-planner, cfn-wave-checkpoint
-
----
-
-## Overview
-
-This mega-skill provides complete sprint management:
-- **Planning** - Sprint decomposition and scheduling
-- **Execution** - Sprint task execution and tracking
-- **Checkpoint** - Wave-based progress checkpointing
-
----
-
-## Directory Structure
-
-```
-sprint-execution/
-├── SKILL.md
-├── lib/
-│   ├── planning/         # From cfn-sprint-planner
-│   ├── execution/        # From cfn-sprint-execution
-│   └── checkpoint/       # From cfn-wave-checkpoint
-└── cli/
-```
-
----
-
-## Migration Paths
-
-| Old Path | New Path |
-|----------|----------|
-| cfn-sprint-planner/ | sprint-execution/lib/planning/ |
-| cfn-sprint-execution/ | sprint-execution/lib/execution/ |
-| cfn-wave-checkpoint/ | sprint-execution/lib/checkpoint/ |
-
----
-
-## Version History
-
-### 1.0.0 (2025-12-02)
-- Consolidated 3 sprint-related skills into mega-skill
-