claude-flow-novice 2.15.11 → 2.16.0

package/claude-assets/skills/cfn-loop-output-processing/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@cfn/loop-output-processing",
+  "version": "1.0.0",
+  "description": "Type-safe, consolidated output processing for CFN Loop agents (Loop 2 validators and Loop 3 implementers)",
+  "main": "dist/src/output-processor.js",
+  "types": "dist/src/output-processor.d.ts",
+  "bin": {
+    "process-loop3": "dist/src/cli/process-loop3.js",
+    "process-loop2": "dist/src/cli/process-loop2.js"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "test": "jest --coverage --coverageThreshold='{\"lines\": 90, \"functions\": 90, \"branches\": 85, \"statements\": 90}'",
+    "test:watch": "jest --watch",
+    "test:unit": "jest --testPathPattern=output-processor",
+    "lint": "eslint src tests --ext .ts",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist coverage .jest"
+  },
+  "keywords": [
+    "cfn-loop",
+    "output-processing",
+    "validators",
+    "implementers",
+    "confidence-extraction",
+    "feedback-parsing",
+    "consensus-calculation"
+  ],
+  "author": "CFN Team",
+  "license": "MIT",
+  "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.0.0",
+    "jest": "^29.5.0",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-org/claude-flow-novice.git",
+    "directory": ".claude/skills/cfn-loop-output-processing"
+  }
+}

package/claude-assets/skills/cfn-loop-output-processing/src/cli/process-loop2.ts

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+
+/**
+ * CLI for processing Loop 2 (Validator) agent outputs
+ * Supports single validator processing or consensus calculation
+ *
+ * Usage (single validator):
+ *   npx ts-node src/cli/process-loop2.ts \
+ *     --validator-id "reviewer-1" \
+ *     --output "Validation feedback..." \
+ *     --iteration 1
+ *
+ * Usage (consensus from multiple):
+ *   npx ts-node src/cli/process-loop2.ts \
+ *     --consensus \
+ *     --results-file ./results.json \
+ *     --threshold 0.75
+ *
+ * Output: JSON with Loop2Result or ConsensusResult
+ */
+
+import * as fs from 'fs';
+import {
+  parseLoop2Output,
+  calculateConsensus,
+  Loop2Result,
+  ConsensusResult,
+  formatAsJson,
+  parseJson,
+} from '../output-processor';
+
+interface Loop2Options {
+  validatorId?: string;
+  output?: string;
+  iteration?: number;
+  consensus?: boolean;
+  resultsFile?: string;
+  threshold?: number;
+}
+
+/**
+ * Parse command line arguments
+ */
+function parseArgs(): Loop2Options {
+  const args = process.argv.slice(2);
+  const options: Partial<Loop2Options> = {};
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    switch (arg) {
+      case '--validator-id':
+        options.validatorId = args[++i];
+        break;
+      case '--output':
+        options.output = args[++i];
+        break;
+      case '--output-file':
+        const filePath = args[++i];
+        if (fs.existsSync(filePath)) {
+          options.output = fs.readFileSync(filePath, 'utf-8');
+        } else {
+          throw new Error(`Output file not found: ${filePath}`);
+        }
+        break;
+      case '--iteration':
+        options.iteration = parseInt(args[++i], 10);
+        break;
+      case '--consensus':
+        options.consensus = true;
+        break;
+      case '--results-file':
+        options.resultsFile = args[++i];
+        break;
+      case '--threshold':
+        options.threshold = parseFloat(args[++i]);
+        break;
+      case '--help':
+      case '-h':
+        printHelp();
+        process.exit(0);
+        break;
+      default:
+        console.error(`Unknown option: ${arg}`);
+        process.exit(1);
+    }
+  }
+
+  return options as Loop2Options;
+}
+
+/**
+ * Print help message
+ */
+function printHelp(): void {
+  console.log(`
+Process Loop 2 Validator Output
+
+Usage:
+  npx ts-node src/cli/process-loop2.ts [OPTIONS]
+
+Single Validator Mode:
+  --validator-id <id>          Validator identifier (required)
+  --output <text>              Validator output text (required)
+  --output-file <path>         Alternative: read output from file
+  --iteration <n>              Iteration number (default: 1)
+
+Consensus Mode:
+  --consensus                  Calculate consensus from multiple results
+  --results-file <path>        File containing JSON array of Loop2Result
+  --threshold <n>              Minimum score to pass (default: 0.70)
+
+Other:
+  --help, -h                   Show this help message
+
+Examples:
+  # Process single validator
+  npx ts-node src/cli/process-loop2.ts \\
+    --validator-id "reviewer-1" \\
+    --output "Validation results: confidence 0.85"
+
+  # Calculate consensus
+  npx ts-node src/cli/process-loop2.ts \\
+    --consensus \\
+    --results-file ./validator-results.json \\
+    --threshold 0.75
+`);
+}
+
+/**
+ * Process single validator output
+ */
+function processSingleValidator(options: Loop2Options): Loop2Result {
+  if (!options.validatorId || !options.output) {
+    throw new Error(
+      'Single validator mode requires --validator-id and --output'
+    );
+  }
+
+  return parseLoop2Output(
+    options.output,
+    options.validatorId,
+    options.iteration || 1
+  );
+}
+
+/**
+ * Process consensus from multiple validators
+ */
+function processConsensus(options: Loop2Options): ConsensusResult {
+  if (!options.resultsFile) {
+    throw new Error('Consensus mode requires --results-file');
+  }
+
+  if (!fs.existsSync(options.resultsFile)) {
+    throw new Error(`Results file not found: ${options.resultsFile}`);
+  }
+
+  const content = fs.readFileSync(options.resultsFile, 'utf-8');
+  const results = parseJson<Loop2Result[]>(content);
+
+  if (!Array.isArray(results)) {
+    throw new Error('Results file must contain JSON array of Loop2Result');
+  }
+
+  return calculateConsensus(results, options.threshold || 0.7);
+}
+
+/**
+ * Main entry point
+ */
+async function main(): Promise<void> {
+  try {
+    const options = parseArgs();
+
+    let result: Loop2Result | ConsensusResult;
+
+    if (options.consensus) {
+      result = processConsensus(options);
+    } else {
+      result = processSingleValidator(options);
+    }
+
+    // Output JSON
+    console.log(formatAsJson(result));
+  } catch (error) {
+    console.error(
+      'Error processing Loop 2 output:',
+      error instanceof Error ? error.message : String(error)
+    );
+    process.exit(1);
+  }
+}
+
+main();

package/claude-assets/skills/cfn-loop-output-processing/src/cli/process-loop3.ts

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+
+/**
+ * CLI for processing Loop 3 (Implementer) agent outputs
+ *
+ * Usage:
+ *   npx ts-node src/cli/process-loop3.ts \
+ *     --agent-id "coder-1" \
+ *     --output "Agent output text..." \
+ *     --iteration 1 \
+ *     [--files-changed 5] \
+ *     [--deliverables "file1.ts,file2.ts"]
+ *
+ * Output: JSON with Loop3Result
+ */
+
+import * as fs from 'fs';
+import { parseLoop3Output, formatAsJson } from '../output-processor';
+
+interface Loop3Options {
+  agentId: string;
+  output: string;
+  iteration?: number;
+  filesChanged?: number;
+  deliverables?: string[];
+}
+
+/**
+ * Parse command line arguments
+ */
+function parseArgs(): Loop3Options {
+  const args = process.argv.slice(2);
+  const options: Partial<Loop3Options> = {};
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    switch (arg) {
+      case '--agent-id':
+        options.agentId = args[++i];
+        break;
+      case '--output':
+        options.output = args[++i];
+        break;
+      case '--output-file':
+        // Read output from file if provided
+        const filePath = args[++i];
+        if (fs.existsSync(filePath)) {
+          options.output = fs.readFileSync(filePath, 'utf-8');
+        } else {
+          throw new Error(`Output file not found: ${filePath}`);
+        }
+        break;
+      case '--iteration':
+        options.iteration = parseInt(args[++i], 10);
+        break;
+      case '--files-changed':
+        options.filesChanged = parseInt(args[++i], 10);
+        break;
+      case '--deliverables':
+        options.deliverables = args[++i].split(',');
+        break;
+      case '--help':
+      case '-h':
+        printHelp();
+        process.exit(0);
+        break;
+      default:
+        console.error(`Unknown option: ${arg}`);
+        process.exit(1);
+    }
+  }
+
+  // Validate required fields
+  if (!options.agentId) {
+    console.error('Error: --agent-id is required');
+    printHelp();
+    process.exit(1);
+  }
+
+  if (!options.output) {
+    console.error('Error: --output or --output-file is required');
+    printHelp();
+    process.exit(1);
+  }
+
+  return options as Loop3Options;
+}
+
+/**
+ * Print help message
+ */
+function printHelp(): void {
+  console.log(`
+Process Loop 3 Agent Output
+
+Usage:
+  npx ts-node src/cli/process-loop3.ts [OPTIONS]
+
+Options:
+  --agent-id <id>              Agent identifier (required)
+  --output <text>              Agent output text (required)
+  --output-file <path>         Alternative: read output from file
+  --iteration <n>              Iteration number (default: 1)
+  --files-changed <n>          Number of files changed
+  --deliverables <file,file>   Comma-separated deliverable files
+  --help, -h                   Show this help message
+
+Examples:
+  npx ts-node src/cli/process-loop3.ts \\
+    --agent-id "coder-1" \\
+    --output "Implemented authentication module..." \\
+    --files-changed 5
+
+  npx ts-node src/cli/process-loop3.ts \\
+    --agent-id "coder-1" \\
+    --output-file ./agent-output.txt \\
+    --iteration 2
+`);
+}
+
+/**
+ * Main entry point
+ */
+async function main(): Promise<void> {
+  try {
+    const options = parseArgs();
+
+    const result = parseLoop3Output(
+      options.output,
+      options.agentId,
+      options.iteration || 1,
+      options.filesChanged
+        ? {
+            before: '',
+            after: options.deliverables?.join('\n') || '',
+          }
+        : undefined
+    );
+
+    // Override files changed if provided
+    if (options.filesChanged !== undefined) {
+      result.filesChanged = options.filesChanged;
+    }
+
+    // Output JSON
+    console.log(formatAsJson(result));
+  } catch (error) {
+    console.error(
+      'Error processing Loop 3 output:',
+      error instanceof Error ? error.message : String(error)
+    );
+    process.exit(1);
+  }
+}
+
+main();