wogiflow 1.0.0

package/scripts/flow-health

@@ -0,0 +1,185 @@
+#!/bin/bash
+
+# Wogi Flow - Health Check
+# Verifies workflow files are in sync and properly configured
+
+set -e
+
+WORKFLOW_DIR=".workflow"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+echo -e "${CYAN}Wogi Flow Health Check${NC}"
+echo "========================"
+echo ""
+
+issues=0
+warnings=0
+
+# Check required files exist
+echo -e "${CYAN}Checking required files...${NC}"
+
+required_files=(
+    "$WORKFLOW_DIR/config.json"
+    "$WORKFLOW_DIR/state/ready.json"
+    "$WORKFLOW_DIR/state/request-log.md"
+    "$WORKFLOW_DIR/state/app-map.md"
+    "$WORKFLOW_DIR/state/decisions.md"
+    "$WORKFLOW_DIR/state/progress.md"
+    "CLAUDE.md"
+)
+
+for file in "${required_files[@]}"; do
+    if [ -f "$file" ]; then
+        echo -e "  ${GREEN}✓${NC} $file"
+    else
+        echo -e "  ${RED}✗${NC} $file - MISSING"
+        issues=$((issues + 1))
+    fi
+done
+
+# Check required directories
+echo ""
+echo -e "${CYAN}Checking directories...${NC}"
+
+required_dirs=(
+    "$WORKFLOW_DIR/state/components"
+    "$WORKFLOW_DIR/specs"
+    "$WORKFLOW_DIR/changes"
+    "$WORKFLOW_DIR/bugs"
+    "$WORKFLOW_DIR/archive"
+    "agents"
+    "scripts"
+)
+
+for dir in "${required_dirs[@]}"; do
+    if [ -d "$dir" ]; then
+        echo -e "  ${GREEN}✓${NC} $dir/"
+    else
+        echo -e "  ${RED}✗${NC} $dir/ - MISSING"
+        issues=$((issues + 1))
+    fi
+done
+
+# Check config.json is valid JSON
+echo ""
+echo -e "${CYAN}Validating config.json...${NC}"
+
+if [ -f "$WORKFLOW_DIR/config.json" ]; then
+    if python3 -c "import json, sys; json.load(open(sys.argv[1]))" "$WORKFLOW_DIR/config.json" 2>/dev/null; then
+        echo -e "  ${GREEN}✓${NC} Valid JSON"
+    else
+        echo -e "  ${RED}✗${NC} Invalid JSON syntax"
+        issues=$((issues + 1))
+    fi
+fi
+
+# Check ready.json is valid JSON
+echo ""
+echo -e "${CYAN}Validating ready.json...${NC}"
+
+if [ -f "$WORKFLOW_DIR/state/ready.json" ]; then
+    if python3 -c "import json, sys; json.load(open(sys.argv[1]))" "$WORKFLOW_DIR/state/ready.json" 2>/dev/null; then
+        echo -e "  ${GREEN}✓${NC} Valid JSON"
+    else
+        echo -e "  ${RED}✗${NC} Invalid JSON syntax"
+        issues=$((issues + 1))
+    fi
+fi
+
+# Check app-map vs actual components
+echo ""
+echo -e "${CYAN}Checking app-map sync...${NC}"
+
+if [ -d "src/components" ]; then
+    component_count=$(find src/components -name "*.tsx" -o -name "*.jsx" 2>/dev/null | wc -l)
+    mapped_count=$(grep -c "^|" "$WORKFLOW_DIR/state/app-map.md" 2>/dev/null || echo 0)
+    mapped_count=$((mapped_count - 3)) # Subtract header rows
+    
+    if [ $mapped_count -lt 0 ]; then mapped_count=0; fi
+    
+    echo -e "  Components in src/: $component_count"
+    echo -e "  Components in app-map: $mapped_count"
+    
+    if [ $component_count -gt $((mapped_count + 5)) ]; then
+        echo -e "  ${YELLOW}⚠${NC} App-map may be out of sync"
+        echo -e "    Run: ./scripts/flow update-map scan src/components"
+        warnings=$((warnings + 1))
+    else
+        echo -e "  ${GREEN}✓${NC} App-map appears in sync"
+    fi
+else
+    echo -e "  ${YELLOW}⚠${NC} src/components/ not found (may be OK for new projects)"
+fi
+
+# Check git status
+echo ""
+echo -e "${CYAN}Checking git status...${NC}"
+
+if [ -d ".git" ]; then
+    uncommitted=$(git status --porcelain 2>/dev/null | wc -l)
+    if [ $uncommitted -eq 0 ]; then
+        echo -e "  ${GREEN}✓${NC} Working directory clean"
+    else
+        echo -e "  ${YELLOW}⚠${NC} $uncommitted uncommitted changes"
+        warnings=$((warnings + 1))
+    fi
+else
+    echo -e "  ${YELLOW}⚠${NC} Not a git repository"
+    warnings=$((warnings + 1))
+fi
+
+# Check request-log recent activity
+echo ""
+echo -e "${CYAN}Checking request-log...${NC}"
+
+if [ -f "$WORKFLOW_DIR/state/request-log.md" ]; then
+    entry_count=$(grep -c "^### R-" "$WORKFLOW_DIR/state/request-log.md" 2>/dev/null || echo 0)
+    echo -e "  Total entries: $entry_count"
+    
+    if [ $entry_count -gt 0 ]; then
+        last_entry=$(grep "^### R-" "$WORKFLOW_DIR/state/request-log.md" | tail -1)
+        echo -e "  Last entry: $last_entry"
+    fi
+fi
+
+# Check agents exist
+echo ""
+echo -e "${CYAN}Checking agents...${NC}"
+
+core_agents=("orchestrator" "developer" "reviewer" "tester")
+optional_agents=("accessibility" "security" "performance" "docs" "design-system" "onboarding")
+
+for agent in "${core_agents[@]}"; do
+    if [ -f "agents/$agent.md" ]; then
+        echo -e "  ${GREEN}✓${NC} $agent.md"
+    else
+        echo -e "  ${RED}✗${NC} $agent.md - MISSING (core agent)"
+        issues=$((issues + 1))
+    fi
+done
+
+for agent in "${optional_agents[@]}"; do
+    if [ -f "agents/$agent.md" ]; then
+        echo -e "  ${GREEN}✓${NC} $agent.md (optional)"
+    fi
+done
+
+# Summary
+echo ""
+echo "========================"
+
+if [ $issues -eq 0 ] && [ $warnings -eq 0 ]; then
+    echo -e "${GREEN}✓ Workflow is healthy!${NC}"
+elif [ $issues -eq 0 ]; then
+    echo -e "${YELLOW}⚠ $warnings warning(s), but no critical issues${NC}"
+else
+    echo -e "${RED}✗ $issues issue(s), $warnings warning(s)${NC}"
+    echo ""
+    echo "Run './scripts/flow init' to fix missing files"
+fi

package/scripts/flow-health.js

@@ -0,0 +1,413 @@
+#!/usr/bin/env node
+
+/**
+ * Wogi Flow - Health Check
+ *
+ * Verifies workflow files are in sync and properly configured.
+ */
+
+const path = require('path');
+const {
+  PATHS,
+  PROJECT_ROOT,
+  fileExists,
+  dirExists,
+  validateJson,
+  countAppMapComponents,
+  countRequestLogEntries,
+  getLastRequestLogEntry,
+  getGitStatus,
+  countFiles,
+  color,
+  printSection,
+  success,
+  warn,
+  error,
+  validatePermissions
+} = require('./flow-utils');
+
+function main() {
+  console.log(color('cyan', 'Wogi Flow Health Check'));
+  console.log('========================');
+  console.log('');
+
+  let issues = 0;
+  let warnings = 0;
+
+  // Check required files
+  printSection('Checking required files...');
+
+  const requiredFiles = [
+    { path: PATHS.config, name: '.workflow/config.json' },
+    { path: PATHS.ready, name: '.workflow/state/ready.json' },
+    { path: PATHS.requestLog, name: '.workflow/state/request-log.md' },
+    { path: PATHS.appMap, name: '.workflow/state/app-map.md' },
+    { path: PATHS.decisions, name: '.workflow/state/decisions.md' },
+    { path: PATHS.progress, name: '.workflow/state/progress.md' },
+  ];
+
+  for (const file of requiredFiles) {
+    if (fileExists(file.path)) {
+      console.log(`  ${color('green', '✓')} ${file.name}`);
+    } else {
+      console.log(`  ${color('red', '✗')} ${file.name} - MISSING`);
+      issues++;
+    }
+  }
+
+  // Check CLI-specific rules file
+  let cliType = 'claude-code'; // default
+  if (fileExists(PATHS.config)) {
+    try {
+      const config = require(PATHS.config);
+      cliType = config.cli?.type || 'claude-code';
+    } catch {}
+  }
+
+  const rulesFiles = {
+    'claude-code': { path: path.join(PROJECT_ROOT, 'CLAUDE.md'), name: 'CLAUDE.md' },
+    'gemini-cli': { path: path.join(PROJECT_ROOT, 'GEMINI.md'), name: 'GEMINI.md' },
+    'opencode': { path: path.join(PROJECT_ROOT, '.opencode', 'config.json'), name: '.opencode/config.json' }
+  };
+
+  const rulesFile = rulesFiles[cliType] || rulesFiles['claude-code'];
+  if (fileExists(rulesFile.path)) {
+    console.log(`  ${color('green', '✓')} ${rulesFile.name} (${cliType})`);
+  } else {
+    console.log(`  ${color('red', '✗')} ${rulesFile.name} - MISSING (${cliType})`);
+    issues++;
+  }
+
+  // Check required directories
+  console.log('');
+  printSection('Checking directories...');
+
+  const requiredDirs = [
+    { path: PATHS.components, name: '.workflow/state/components' },
+    { path: PATHS.specs, name: '.workflow/specs' },
+    { path: PATHS.changes, name: '.workflow/changes' },
+    { path: PATHS.bugs, name: '.workflow/bugs' },
+    { path: PATHS.archive, name: '.workflow/archive' },
+    { path: path.join(PROJECT_ROOT, 'agents'), name: 'agents' },
+    { path: path.join(PROJECT_ROOT, 'scripts'), name: 'scripts' },
+  ];
+
+  for (const dir of requiredDirs) {
+    if (dirExists(dir.path)) {
+      console.log(`  ${color('green', '✓')} ${dir.name}/`);
+    } else {
+      console.log(`  ${color('red', '✗')} ${dir.name}/ - MISSING`);
+      issues++;
+    }
+  }
+
+  // Check universal structure directories (optional but recommended)
+  console.log('');
+  printSection('Checking universal structure...');
+
+  const universalDirs = [
+    { path: path.join(PROJECT_ROOT, '.workflow', 'models'), name: '.workflow/models' },
+    { path: path.join(PROJECT_ROOT, '.workflow', 'bridges'), name: '.workflow/bridges' },
+    { path: path.join(PROJECT_ROOT, '.workflow', 'templates'), name: '.workflow/templates' },
+  ];
+
+  for (const dir of universalDirs) {
+    if (dirExists(dir.path)) {
+      console.log(`  ${color('green', '✓')} ${dir.name}/`);
+    } else {
+      console.log(`  ${color('yellow', '○')} ${dir.name}/ - not found (run 'flow migrate' to add)`);
+      warnings++;
+    }
+  }
+
+  // Check model registry
+  const registryPath = path.join(PROJECT_ROOT, '.workflow', 'models', 'registry.json');
+  if (fileExists(registryPath)) {
+    const result = validateJson(registryPath);
+    if (result.valid) {
+      console.log(`  ${color('green', '✓')} Model registry valid`);
+    } else {
+      console.log(`  ${color('red', '✗')} Model registry invalid JSON`);
+      issues++;
+    }
+  }
+
+  // Check knowledge files (optional - generated by onboard)
+  console.log('');
+  printSection('Checking knowledge files...');
+
+  // Use paths from PATHS constant (defined in flow-utils.js)
+  const knowledgeFiles = [
+    { path: PATHS.stackMd, name: 'stack.md', category: 'stack' },
+    { path: PATHS.architectureMd, name: 'architecture.md', category: 'architecture' },
+    { path: PATHS.testingMd, name: 'testing.md', category: 'testing' },
+  ];
+
+  // Try to load drift detection
+  let driftStatus = null;
+  try {
+    const { checkAllDrift } = require('./flow-knowledge-sync');
+    driftStatus = checkAllDrift();
+  } catch {
+    // Knowledge sync not available
+  }
+
+  for (const file of knowledgeFiles) {
+    if (fileExists(file.path)) {
+      // Check sync status if available
+      const categoryStatus = driftStatus?.categories?.[file.category];
+      if (categoryStatus?.status === 'drifted') {
+        console.log(`  ${color('yellow', '⚠')} ${file.name} - out of sync (${categoryStatus.reason})`);
+        warnings++;
+      } else {
+        console.log(`  ${color('green', '✓')} ${file.name}`);
+      }
+    } else {
+      console.log(`  ${color('yellow', '○')} ${file.name} - not found (run 'flow onboard' to generate)`);
+      warnings++;
+    }
+  }
+
+  // Show sync recommendation if drift detected
+  if (driftStatus?.anyDrift) {
+    console.log('');
+    console.log(`    ${color('dim', "Run 'flow knowledge-sync regenerate' to update")}`);
+  }
+
+  // Validate config.json
+  console.log('');
+  printSection('Validating config.json...');
+
+  if (fileExists(PATHS.config)) {
+    const result = validateJson(PATHS.config);
+    if (result.valid) {
+      console.log(`  ${color('green', '✓')} Valid JSON`);
+    } else {
+      console.log(`  ${color('red', '✗')} Invalid JSON syntax`);
+      issues++;
+    }
+  }
+
+  // Validate ready.json
+  console.log('');
+  printSection('Validating ready.json...');
+
+  if (fileExists(PATHS.ready)) {
+    const result = validateJson(PATHS.ready);
+    if (result.valid) {
+      console.log(`  ${color('green', '✓')} Valid JSON`);
+    } else {
+      console.log(`  ${color('red', '✗')} Invalid JSON syntax`);
+      issues++;
+    }
+  }
+
+  // Check enforcement settings
+  console.log('');
+  printSection('Checking enforcement...');
+
+  const claudeMdPath = path.join(PROJECT_ROOT, 'CLAUDE.md');
+  if (fileExists(claudeMdPath)) {
+    const fs = require('fs');
+    const claudeMdContent = fs.readFileSync(claudeMdPath, 'utf-8');
+    const claudeMdSize = fs.statSync(claudeMdPath).size;
+    const sizeKb = Math.round(claudeMdSize / 1024);
+
+    // Check CLAUDE.md size (should be under 20KB for reliable loading)
+    if (sizeKb <= 20) {
+      console.log(`  ${color('green', '✓')} CLAUDE.md size: ${sizeKb}KB (under 20KB limit)`);
+    } else {
+      console.log(`  ${color('yellow', '⚠')} CLAUDE.md size: ${sizeKb}KB (over 20KB - may get truncated)`);
+      warnings++;
+    }
+
+    // Check if enforcement section is at top (within first 100 lines)
+    const lines = claudeMdContent.split('\n').slice(0, 100);
+    const hasEnforcementAtTop = lines.some(line =>
+      line.includes('MANDATORY') && line.includes('Task Gating')
+    );
+
+    if (hasEnforcementAtTop) {
+      console.log(`  ${color('green', '✓')} Enforcement section: FOUND at top of CLAUDE.md`);
+    } else {
+      console.log(`  ${color('yellow', '⚠')} Enforcement section not found at top of CLAUDE.md`);
+      warnings++;
+    }
+  }
+
+  // Check strict mode in config
+  if (fileExists(PATHS.config)) {
+    const configResult = validateJson(PATHS.config);
+    if (configResult.valid) {
+      try {
+        const config = JSON.parse(require('fs').readFileSync(PATHS.config, 'utf-8'));
+        if (config.enforcement?.strictMode === true) {
+          console.log(`  ${color('green', '✓')} Strict mode: ENABLED`);
+        } else if (config.enforcement?.strictMode === false) {
+          console.log(`  ${color('yellow', '⚠')} Strict mode: DISABLED (Claude may skip task creation)`);
+          warnings++;
+        } else {
+          console.log(`  ${color('yellow', '⚠')} Strict mode: NOT CONFIGURED (add enforcement section to config.json)`);
+          warnings++;
+        }
+      } catch (err) {
+        console.log(`  ${color('yellow', '⚠')} Could not parse config.json for strict mode check`);
+        warnings++;
+      }
+    }
+  }
+
+  // Check app-map sync
+  console.log('');
+  printSection('Checking app-map sync...');
+
+  const srcComponents = path.join(PROJECT_ROOT, 'src', 'components');
+  if (dirExists(srcComponents)) {
+    const componentCount = countFiles(srcComponents, ['.tsx', '.jsx']);
+    const mappedCount = countAppMapComponents();
+
+    console.log(`  Components in src/: ${componentCount}`);
+    console.log(`  Components in app-map: ${mappedCount}`);
+
+    if (componentCount > mappedCount + 5) {
+      console.log(`  ${color('yellow', '⚠')} App-map may be out of sync`);
+      console.log('    Run: ./scripts/flow update-map scan src/components');
+      warnings++;
+    } else {
+      console.log(`  ${color('green', '✓')} App-map appears in sync`);
+    }
+  } else {
+    console.log(`  ${color('yellow', '⚠')} src/components/ not found (may be OK for new projects)`);
+  }
+
+  // Check permission rules (Claude Code specific)
+  console.log('');
+  printSection('Checking permission rules...');
+
+  const settingsPath = path.join(PROJECT_ROOT, '.claude', 'settings.local.json');
+  if (fileExists(settingsPath)) {
+    try {
+      const settings = JSON.parse(require('fs').readFileSync(settingsPath, 'utf-8'));
+      const permissions = settings.permissions?.allow || [];
+
+      // Use shared validation function
+      const validation = validatePermissions(permissions);
+
+      console.log(`  Total rules: ${validation.analysis.total}`);
+
+      // Show duplicates (warning)
+      if (validation.analysis.duplicates.length > 0) {
+        console.log(`  ${color('yellow', '⚠')} ${validation.analysis.duplicates.length} duplicate rule(s) found`);
+        for (const dup of validation.analysis.duplicates.slice(0, 3)) {
+          console.log(`    - ${dup}`);
+        }
+        warnings++;
+      } else {
+        console.log(`  ${color('green', '✓')} No duplicate rules`);
+      }
+
+      // Show overly broad rules (issue)
+      if (validation.analysis.overbroad.length > 0) {
+        console.log(`  ${color('yellow', '⚠')} ${validation.analysis.overbroad.length} overly broad rule(s)`);
+        for (const ob of validation.analysis.overbroad) {
+          console.log(`    - ${ob}`);
+        }
+        warnings++;
+      }
+
+      // Show shadowed rules (info only)
+      if (validation.analysis.shadowed.length > 0) {
+        console.log(`  ${color('dim', 'ℹ')} ${validation.analysis.shadowed.length} rule(s) shadowed by wildcards (OK but redundant)`);
+      }
+
+      // Check for respectGitignore
+      if (settings.respectGitignore === true) {
+        console.log(`  ${color('green', '✓')} respectGitignore: enabled`);
+      } else {
+        console.log(`  ${color('yellow', '○')} respectGitignore: not set`);
+      }
+
+    } catch (err) {
+      console.log(`  ${color('yellow', '⚠')} Could not parse settings.local.json`);
+      warnings++;
+    }
+  } else {
+    console.log(`  ${color('yellow', '○')} .claude/settings.local.json not found (run 'flow bridge sync')`);
+  }
+
+  // Check git status
+  console.log('');
+  printSection('Checking git status...');
+
+  const git = getGitStatus();
+  if (git.isRepo) {
+    if (git.clean) {
+      console.log(`  ${color('green', '✓')} Working directory clean`);
+    } else {
+      console.log(`  ${color('yellow', '⚠')} ${git.uncommitted} uncommitted changes`);
+      warnings++;
+    }
+  } else {
+    console.log(`  ${color('yellow', '⚠')} Not a git repository`);
+    warnings++;
+  }
+
+  // Check request-log
+  console.log('');
+  printSection('Checking request-log...');
+
+  if (fileExists(PATHS.requestLog)) {
+    const entryCount = countRequestLogEntries();
+    console.log(`  Total entries: ${entryCount}`);
+
+    if (entryCount > 0) {
+      const lastEntry = getLastRequestLogEntry();
+      if (lastEntry) {
+        console.log(`  Last entry: ${lastEntry}`);
+      }
+    }
+  }
+
+  // Check agents
+  console.log('');
+  printSection('Checking agents...');
+
+  const agentsDir = path.join(PROJECT_ROOT, 'agents');
+  const coreAgents = ['orchestrator', 'developer', 'reviewer', 'tester'];
+  const optionalAgents = ['accessibility', 'security', 'performance', 'docs', 'design-system', 'onboarding'];
+
+  for (const agent of coreAgents) {
+    const agentPath = path.join(agentsDir, `${agent}.md`);
+    if (fileExists(agentPath)) {
+      console.log(`  ${color('green', '✓')} ${agent}.md`);
+    } else {
+      console.log(`  ${color('red', '✗')} ${agent}.md - MISSING (core agent)`);
+      issues++;
+    }
+  }
+
+  for (const agent of optionalAgents) {
+    const agentPath = path.join(agentsDir, `${agent}.md`);
+    if (fileExists(agentPath)) {
+      console.log(`  ${color('green', '✓')} ${agent}.md (optional)`);
+    }
+  }
+
+  // Summary
+  console.log('');
+  console.log('========================');
+
+  if (issues === 0 && warnings === 0) {
+    console.log(color('green', '✓ Workflow is healthy!'));
+  } else if (issues === 0) {
+    console.log(color('yellow', `⚠ ${warnings} warning(s), but no critical issues`));
+  } else {
+    console.log(color('red', `✗ ${issues} issue(s), ${warnings} warning(s)`));
+    console.log('');
+    console.log("Run './scripts/flow init' to fix missing files");
+  }
+
+  process.exit(issues > 0 ? 1 : 0);
+}
+
+main();