wogiflow 1.0.0

package/scripts/flow-watch

@@ -0,0 +1,168 @@
+#!/bin/bash
+
+# Wogi Flow - File Watcher
+# Runs validation automatically when files change
+# Usage: ./scripts/flow-watch (run in separate terminal)
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+RED='\033[0;31m'
+DIM='\033[2m'
+NC='\033[0m'
+
+show_help() {
+    echo "Wogi Flow - File Watcher"
+    echo ""
+    echo "Automatically runs validation when files change."
+    echo "Run this in a separate terminal alongside Claude Code."
+    echo ""
+    echo "Usage: flow watch [options]"
+    echo ""
+    echo "Options:"
+    echo "  --dir DIR      Directory to watch (default: src)"
+    echo "  --ext EXT      Extensions to watch (default: ts,tsx,js,jsx)"
+    echo "  --no-lint      Skip eslint"
+    echo "  --no-types     Skip typecheck"
+    echo "  --help         Show this help"
+    echo ""
+}
+
+WATCH_DIR="src"
+EXTENSIONS="ts,tsx,js,jsx"
+RUN_LINT=true
+RUN_TYPES=true
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dir)
+            WATCH_DIR="$2"
+            shift 2
+            ;;
+        --ext)
+            EXTENSIONS="$2"
+            shift 2
+            ;;
+        --no-lint)
+            RUN_LINT=false
+            shift
+            ;;
+        --no-types)
+            RUN_TYPES=false
+            shift
+            ;;
+        --help|-h)
+            show_help
+            exit 0
+            ;;
+        *)
+            shift
+            ;;
+    esac
+done
+
+# Check for required tools
+check_requirements() {
+    if ! command -v npx &> /dev/null; then
+        echo -e "${RED}npx not found. Please install Node.js${NC}"
+        exit 1
+    fi
+
+    # Check for nodemon or fswatch or inotifywait
+    if command -v nodemon &> /dev/null; then
+        WATCHER="nodemon"
+    elif command -v fswatch &> /dev/null; then
+        WATCHER="fswatch"
+    elif command -v inotifywait &> /dev/null; then
+        WATCHER="inotify"
+    else
+        echo -e "${YELLOW}No file watcher found. Installing nodemon...${NC}"
+        npm install -g nodemon
+        WATCHER="nodemon"
+    fi
+}
+
+run_validation() {
+    local file="$1"
+    echo ""
+    echo -e "${CYAN}━━━ File Changed: $file ━━━${NC}"
+    echo ""
+
+    local has_errors=false
+
+    # TypeScript check
+    if [ "$RUN_TYPES" = true ]; then
+        echo -e "${CYAN}Running typecheck...${NC}"
+        if ! npx tsc --noEmit 2>&1 | head -30; then
+            has_errors=true
+        else
+            echo -e "${GREEN}✓ Types OK${NC}"
+        fi
+    fi
+
+    # ESLint
+    if [ "$RUN_LINT" = true ] && [ -n "$file" ]; then
+        echo -e "${CYAN}Running eslint...${NC}"
+        if ! npx eslint "$file" --fix 2>&1 | head -20; then
+            has_errors=true
+        else
+            echo -e "${GREEN}✓ Lint OK${NC}"
+        fi
+    fi
+
+    if [ "$has_errors" = true ]; then
+        echo -e "${RED}━━━ Errors Found ━━━${NC}"
+    else
+        echo -e "${GREEN}━━━ All Checks Passed ━━━${NC}"
+    fi
+    echo ""
+}
+
+start_watching() {
+    echo -e "${CYAN}"
+    echo "╔═══════════════════════════════════════════════════════════════╗"
+    echo "║              Wogi Flow - File Watcher                         ║"
+    echo "╚═══════════════════════════════════════════════════════════════╝"
+    echo -e "${NC}"
+    echo ""
+    echo "Watching: $WATCH_DIR"
+    echo "Extensions: $EXTENSIONS"
+    echo "Typecheck: $RUN_TYPES"
+    echo "Lint: $RUN_LINT"
+    echo ""
+    echo -e "${DIM}Press Ctrl+C to stop${NC}"
+    echo ""
+
+    case $WATCHER in
+        nodemon)
+            npx nodemon \
+                --watch "$WATCH_DIR" \
+                --ext "$EXTENSIONS" \
+                --exec "bash -c 'echo \"Change detected\" && npx tsc --noEmit 2>&1 | head -20 && echo \"\" '"
+            ;;
+        fswatch)
+            fswatch -r "$WATCH_DIR" | while read file; do
+                if [[ "$file" =~ \.(ts|tsx|js|jsx)$ ]]; then
+                    run_validation "$file"
+                fi
+            done
+            ;;
+        inotify)
+            inotifywait -m -r -e modify,create "$WATCH_DIR" --format '%w%f' | while read file; do
+                if [[ "$file" =~ \.(ts|tsx|js|jsx)$ ]]; then
+                    run_validation "$file"
+                fi
+            done
+            ;;
+    esac
+}
+
+check_requirements
+start_watching

package/scripts/flow-workflow-steps.js

@@ -0,0 +1,521 @@
+#!/usr/bin/env node
+
+/**
+ * Wogi Flow - Modular Workflow Steps
+ *
+ * Configurable plug-in steps that run at various points in the task workflow.
+ * Developers can enable/disable steps via config or interactive setup.
+ *
+ * Usage:
+ *   const { runSteps, listSteps, getStepConfig } = require('./flow-workflow-steps');
+ *   await runSteps('afterTask', { taskId: 'TASK-001', files: [...] });
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { getProjectRoot, colors, getConfig } = require('./flow-utils');
+
+const PROJECT_ROOT = getProjectRoot();
+
+// ============================================================
+// Step Registry - All available workflow steps
+// ============================================================
+
+/**
+ * Step definitions with metadata
+ * Each step has:
+ *   - name: Unique identifier
+ *   - description: Human-readable description
+ *   - category: Grouping for UI
+ *   - defaultMode: Default mode (block/warn/prompt/auto)
+ *   - defaultWhen: Default execution point
+ *   - defaultEnabled: Whether enabled by default
+ *   - handler: Function that executes the step
+ *   - configKey: Legacy config key for backwards compatibility
+ */
+const STEP_REGISTRY = {
+  regressionTest: {
+    name: 'regressionTest',
+    description: 'Test random completed tasks to catch regressions',
+    category: 'testing',
+    defaultMode: 'warn',
+    defaultWhen: 'afterTask',
+    defaultEnabled: true,
+    configKey: 'regressionTesting',
+    handlerPath: './flow-step-regression',
+  },
+  browserTest: {
+    name: 'browserTest',
+    description: 'Suggest browser tests for UI changes',
+    category: 'testing',
+    defaultMode: 'prompt',
+    defaultWhen: 'afterTask',
+    defaultEnabled: true,
+    triggerFor: ['*.tsx', '*.jsx', '*.vue', '*.svelte'],
+    configKey: 'browserTesting',
+    handlerPath: './flow-step-browser',
+  },
+  securityScan: {
+    name: 'securityScan',
+    description: 'Run npm audit and security checks',
+    category: 'quality',
+    defaultMode: 'block',
+    defaultWhen: 'beforeCommit',
+    defaultEnabled: true,
+    configKey: 'security',
+    handlerPath: './flow-step-security',
+  },
+  updateKnowledgeBase: {
+    name: 'updateKnowledgeBase',
+    description: 'Document learnings in knowledge base',
+    category: 'documentation',
+    defaultMode: 'prompt',
+    defaultWhen: 'afterTask',
+    defaultEnabled: false,
+    handlerPath: './flow-step-knowledge',
+  },
+  updateChangelog: {
+    name: 'updateChangelog',
+    description: 'Add entry to CHANGELOG.md',
+    category: 'documentation',
+    defaultMode: 'prompt',
+    defaultWhen: 'beforeCommit',
+    defaultEnabled: false,
+    handlerPath: './flow-step-changelog',
+  },
+  codeComplexityCheck: {
+    name: 'codeComplexityCheck',
+    description: 'Flag functions exceeding complexity threshold',
+    category: 'quality',
+    defaultMode: 'warn',
+    defaultWhen: 'afterTask',
+    defaultEnabled: false,
+    defaultConfig: { threshold: 10 },
+    handlerPath: './flow-step-complexity',
+  },
+  coverageCheck: {
+    name: 'coverageCheck',
+    description: 'Ensure test coverage meets threshold',
+    category: 'quality',
+    defaultMode: 'warn',
+    defaultWhen: 'beforeCommit',
+    defaultEnabled: false,
+    defaultConfig: { minCoverage: 80 },
+    handlerPath: './flow-step-coverage',
+  },
+  codeSimplifier: {
+    name: 'codeSimplifier',
+    description: 'AI-powered code simplification suggestions (qualitative)',
+    category: 'quality',
+    defaultMode: 'prompt',
+    defaultWhen: 'afterTask',
+    defaultEnabled: false,
+    defaultConfig: {
+      maxFunctionLines: 50,
+      maxNestingDepth: 3,
+      suggestExtraction: true,
+    },
+    handlerPath: './flow-step-simplifier',
+  },
+  codeReview: {
+    name: 'codeReview',
+    description: 'Hybrid code review (multi-agent for big/high-risk)',
+    category: 'quality',
+    defaultMode: 'warn',
+    defaultWhen: 'afterTask',
+    defaultEnabled: false,
+    defaultConfig: {
+      multiAgentThreshold: 5,
+      highRiskPatterns: ['auth', 'payment', 'security', 'crypto'],
+      confidenceThreshold: 80,
+    },
+    handlerPath: './flow-step-review',
+  },
+  prTestAnalyzer: {
+    name: 'prTestAnalyzer',
+    description: 'Analyze test coverage and quality for modified files',
+    category: 'testing',
+    defaultMode: 'warn',
+    defaultWhen: 'beforeCommit',
+    defaultEnabled: true,
+    defaultConfig: {
+      checkCoverage: true,
+      checkQuality: true,
+      minCoverageForModified: 70,
+    },
+    handlerPath: './flow-step-pr-tests',
+  },
+  silentFailureHunter: {
+    name: 'silentFailureHunter',
+    description: 'Detect empty catch blocks and swallowed errors',
+    category: 'quality',
+    defaultMode: 'warn',
+    defaultWhen: 'afterTask',
+    defaultEnabled: false,
+    defaultConfig: {
+      checkEmptyCatch: true,
+      checkLogOnlyCatch: true,
+      checkUnhandledAsync: true,
+      checkPromiseChains: true,
+    },
+    handlerPath: './flow-step-silent-failures',
+  },
+  commentAnalyzer: {
+    name: 'commentAnalyzer',
+    description: 'Analyze comment quality (TODOs, stale, JSDoc accuracy)',
+    category: 'quality',
+    defaultMode: 'warn',
+    defaultWhen: 'afterTask',
+    defaultEnabled: false,
+    defaultConfig: {
+      flagTodo: true,
+      flagFixme: true,
+      checkJsdoc: true,
+      flagCommentedCode: true,
+      flagStale: true,
+    },
+    handlerPath: './flow-step-comments',
+  },
+};
+
+// Lazy load handlers to avoid circular dependencies
+function getHandler(stepName) {
+  const step = STEP_REGISTRY[stepName];
+  if (!step) return null;
+
+  // Lazy load the handler from handlerPath
+  if (!step._handler && step.handlerPath) {
+    try {
+      step._handler = require(step.handlerPath);
+    } catch (err) {
+      // Handler not implemented yet
+      if (process.env.DEBUG) {
+        console.warn(`[DEBUG] Failed to load handler for ${stepName}: ${err.message}`);
+      }
+      return null;
+    }
+  }
+  return step._handler;
+}
+
+// ============================================================
+// Configuration Resolution
+// ============================================================
+
+/**
+ * Get step configuration, merging defaults with user config
+ * Supports legacy config keys for backwards compatibility
+ */
+function getStepConfig(stepName) {
+  const config = getConfig();
+  const stepDef = STEP_REGISTRY[stepName];
+
+  if (!stepDef) {
+    return null;
+  }
+
+  // Check new workflowSteps config first
+  const workflowSteps = config.workflowSteps || {};
+  const userConfig = workflowSteps[stepName] || {};
+
+  // Fall back to legacy config if workflowSteps not defined for this step
+  let legacyEnabled = null;
+  let legacyConfig = {};
+
+  if (stepDef.configKey && !workflowSteps[stepName]) {
+    const legacySection = config[stepDef.configKey];
+    if (legacySection) {
+      legacyEnabled = legacySection.enabled !== false;
+      legacyConfig = legacySection;
+    }
+  }
+
+  return {
+    enabled: userConfig.enabled ?? legacyEnabled ?? stepDef.defaultEnabled,
+    mode: userConfig.mode || stepDef.defaultMode,
+    when: userConfig.when || stepDef.defaultWhen,
+    triggerFor: userConfig.triggerFor || stepDef.triggerFor,
+    config: { ...stepDef.defaultConfig, ...legacyConfig, ...userConfig.config },
+  };
+}
+
+/**
+ * Get all steps with their resolved configuration
+ */
+function getAllSteps() {
+  const steps = {};
+  for (const stepName of Object.keys(STEP_REGISTRY)) {
+    steps[stepName] = {
+      ...STEP_REGISTRY[stepName],
+      ...getStepConfig(stepName),
+    };
+  }
+  return steps;
+}
+
+// ============================================================
+// Step Execution
+// ============================================================
+
+/**
+ * Run all enabled steps for a given execution point
+ *
+ * @param {string} when - Execution point: 'afterTask', 'beforeCommit', 'afterCommit', 'onSessionEnd'
+ * @param {object} context - Context object with taskId, files, etc.
+ * @returns {object} - { success: boolean, results: { stepName: { passed, message, blocked } } }
+ */
+async function runSteps(when, context = {}) {
+  const results = {};
+  let allPassed = true;
+  let blocked = false;
+
+  const allSteps = getAllSteps();
+
+  for (const [stepName, step] of Object.entries(allSteps)) {
+    // Skip disabled steps
+    if (!step.enabled) {
+      continue;
+    }
+
+    // Skip steps not for this execution point
+    if (step.when !== when) {
+      continue;
+    }
+
+    // Check file trigger patterns
+    if (step.triggerFor && context.files) {
+      const hasMatchingFile = context.files.some(file => {
+        return step.triggerFor.some(pattern => {
+          const ext = pattern.replace('*', '');
+          return file.endsWith(ext);
+        });
+      });
+      if (!hasMatchingFile) {
+        continue;
+      }
+    }
+
+    // Get handler
+    const handler = getHandler(stepName);
+    if (!handler || typeof handler.run !== 'function') {
+      results[stepName] = { passed: true, skipped: true, message: 'Handler not implemented' };
+      continue;
+    }
+
+    // Execute step
+    console.log(colors.cyan + `\n[${stepName}] ` + colors.reset + step.description);
+
+    try {
+      const result = await handler.run({
+        ...context,
+        stepConfig: step.config,
+        mode: step.mode,
+      });
+
+      results[stepName] = result;
+
+      // Handle result based on mode
+      if (!result.passed) {
+        if (step.mode === 'block') {
+          console.log(colors.red + `  BLOCKED: ${result.message}` + colors.reset);
+          blocked = true;
+          allPassed = false;
+        } else if (step.mode === 'warn') {
+          console.log(colors.yellow + `  WARNING: ${result.message}` + colors.reset);
+          // Warnings don't block, but track that something failed
+        } else if (step.mode === 'prompt') {
+          // Prompts are handled by the handler itself
+        }
+      } else {
+        console.log(colors.green + `  PASSED` + colors.reset);
+      }
+
+    } catch (error) {
+      results[stepName] = { passed: false, error: error.message };
+      console.log(colors.red + `  ERROR: ${error.message}` + colors.reset);
+
+      if (step.mode === 'block') {
+        blocked = true;
+        allPassed = false;
+      }
+    }
+  }
+
+  return { success: allPassed, blocked, results };
+}
+
+// ============================================================
+// CLI Helpers
+// ============================================================
+
+/**
+ * List all steps with their status
+ */
+function listSteps() {
+  const allSteps = getAllSteps();
+  const byCategory = {};
+
+  for (const [stepName, step] of Object.entries(allSteps)) {
+    const category = step.category || 'other';
+    if (!byCategory[category]) {
+      byCategory[category] = [];
+    }
+    byCategory[category].push({ name: stepName, ...step });
+  }
+
+  return byCategory;
+}
+
+/**
+ * Print step list to console
+ */
+function printSteps() {
+  const byCategory = listSteps();
+
+  console.log(colors.cyan + '\nWorkflow Steps\n' + colors.reset);
+
+  for (const [category, steps] of Object.entries(byCategory)) {
+    console.log(colors.yellow + `${category.charAt(0).toUpperCase() + category.slice(1)}:` + colors.reset);
+
+    for (const step of steps) {
+      const status = step.enabled ? colors.green + '[ON]' : colors.dim + '[OFF]';
+      const mode = step.enabled ? ` (${step.mode})` : '';
+      console.log(`  ${status}${colors.reset} ${step.name}${mode} - ${step.description}`);
+    }
+    console.log('');
+  }
+}
+
+/**
+ * Enable a step
+ */
+function enableStep(stepName) {
+  if (!STEP_REGISTRY[stepName]) {
+    return { success: false, error: `Unknown step: ${stepName}` };
+  }
+
+  const configPath = path.join(PROJECT_ROOT, '.workflow', 'config.json');
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+
+  if (!config.workflowSteps) {
+    config.workflowSteps = {};
+  }
+
+  if (!config.workflowSteps[stepName]) {
+    config.workflowSteps[stepName] = {};
+  }
+
+  config.workflowSteps[stepName].enabled = true;
+
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  return { success: true };
+}
+
+/**
+ * Disable a step
+ */
+function disableStep(stepName) {
+  if (!STEP_REGISTRY[stepName]) {
+    return { success: false, error: `Unknown step: ${stepName}` };
+  }
+
+  const configPath = path.join(PROJECT_ROOT, '.workflow', 'config.json');
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+
+  if (!config.workflowSteps) {
+    config.workflowSteps = {};
+  }
+
+  if (!config.workflowSteps[stepName]) {
+    config.workflowSteps[stepName] = {};
+  }
+
+  config.workflowSteps[stepName].enabled = false;
+
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  return { success: true };
+}
+
+/**
+ * Get step definitions for interactive setup
+ */
+function getStepDefinitions() {
+  return Object.entries(STEP_REGISTRY).map(([name, step]) => ({
+    name,
+    description: step.description,
+    category: step.category,
+    defaultEnabled: step.defaultEnabled,
+    defaultMode: step.defaultMode,
+    defaultWhen: step.defaultWhen,
+    defaultConfig: step.defaultConfig,
+  }));
+}
+
+// ============================================================
+// CLI Entry Point
+// ============================================================
+
+if (require.main === module) {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  switch (command) {
+    case 'list':
+      printSteps();
+      break;
+
+    case 'enable':
+      if (!args[1]) {
+        console.log(colors.red + 'Usage: flow step enable <stepName>' + colors.reset);
+        process.exit(1);
+      }
+      const enableResult = enableStep(args[1]);
+      if (enableResult.success) {
+        console.log(colors.green + `Enabled step: ${args[1]}` + colors.reset);
+      } else {
+        console.log(colors.red + enableResult.error + colors.reset);
+        process.exit(1);
+      }
+      break;
+
+    case 'disable':
+      if (!args[1]) {
+        console.log(colors.red + 'Usage: flow step disable <stepName>' + colors.reset);
+        process.exit(1);
+      }
+      const disableResult = disableStep(args[1]);
+      if (disableResult.success) {
+        console.log(colors.green + `Disabled step: ${args[1]}` + colors.reset);
+      } else {
+        console.log(colors.red + disableResult.error + colors.reset);
+        process.exit(1);
+      }
+      break;
+
+    default:
+      console.log(`
+Workflow Steps CLI
+
+Usage:
+  flow step list              List all steps with status
+  flow step enable <name>     Enable a step
+  flow step disable <name>    Disable a step
+      `);
+  }
+}
+
+// ============================================================
+// Exports
+// ============================================================
+
+module.exports = {
+  runSteps,
+  listSteps,
+  printSteps,
+  enableStep,
+  disableStep,
+  getStepConfig,
+  getAllSteps,
+  getStepDefinitions,
+  STEP_REGISTRY,
+};