agileflow 3.4.3 → 4.0.0-alpha.1

package/scripts/auto-self-improve.js

@@ -1,326 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * auto-self-improve.js - Automatic Agent Expertise Updates
- *
- * This script runs as a Stop hook and automatically updates agent
- * expertise files based on work performed during the session.
- *
- * How it works:
- * 1. Reads session-state.json to find which agent was active
- * 2. Analyzes git diff to see what changed
- * 3. Detects patterns, new files, significant changes
- * 4. Generates a learning entry
- * 5. Appends to the agent's expertise.yaml
- *
- * Usage (as Stop hook):
- *   node scripts/auto-self-improve.js
- */
-
-const fs = require('fs');
-const path = require('path');
-const { execFileSync } = require('child_process');
-
-// Shared utilities
-const { c } = require('../lib/colors');
-const { getProjectRoot } = require('../lib/paths');
-const { safeReadJSON, safeReadFile, safeWriteFile, tryOptional } = require('../lib/errors');
-
-// Agents that have expertise files
-const AGENTS_WITH_EXPERTISE = [
-  'accessibility',
-  'adr-writer',
-  'analytics',
-  'api',
-  'ci',
-  'compliance',
-  'database',
-  'datamigration',
-  'design',
-  'devops',
-  'documentation',
-  'epic-planner',
-  'integrations',
-  'mentor',
-  'mobile',
-  'monitoring',
-  'performance',
-  'product',
-  'qa',
-  'readme-updater',
-  'refactor',
-  'research',
-  'security',
-  'testing',
-  'ui',
-];
-
-// File patterns that suggest domain expertise
-const DOMAIN_PATTERNS = {
-  database: [/schema/, /migration/, /\.sql$/, /prisma/, /drizzle/, /sequelize/],
-  api: [/\/api\//, /controller/, /route/, /endpoint/, /graphql/],
-  ui: [/component/, /\.tsx$/, /\.jsx$/, /styles/, /\.css$/, /\.scss$/],
-  testing: [/\.test\./, /\.spec\./, /__tests__/, /jest/, /vitest/],
-  security: [/auth/, /password/, /token/, /jwt/, /oauth/, /permission/],
-  ci: [/\.github\/workflows/, /\.gitlab-ci/, /dockerfile/i, /docker-compose/],
-  documentation: [/\.md$/, /readme/i, /docs\//, /jsdoc/],
-  performance: [/cache/, /optimize/, /performance/, /benchmark/],
-  devops: [/deploy/, /kubernetes/, /k8s/, /terraform/, /ansible/],
-};
-
-// Read session state
-function getSessionState(rootDir) {
-  const statePath = path.join(rootDir, 'docs/09-agents/session-state.json');
-  const result = safeReadJSON(statePath, { defaultValue: {} });
-  return result.ok ? result.data : {};
-}
-
-// Get git diff summary
-function getGitDiff(rootDir) {
-  try {
-    // Get list of changed files (staged and unstaged)
-    const diffFiles = execFileSync('git', ['diff', '--name-only', 'HEAD'], {
-      cwd: rootDir,
-      encoding: 'utf8',
-      stdio: ['pipe', 'pipe', 'pipe'],
-    })
-      .trim()
-      .split('\n')
-      .filter(Boolean);
-
-    // Get staged files
-    const stagedFiles = execFileSync('git', ['diff', '--cached', '--name-only'], {
-      cwd: rootDir,
-      encoding: 'utf8',
-      stdio: ['pipe', 'pipe', 'pipe'],
-    })
-      .trim()
-      .split('\n')
-      .filter(Boolean);
-
-    // Get untracked files
-    const untrackedFiles = execFileSync('git', ['ls-files', '--others', '--exclude-standard'], {
-      cwd: rootDir,
-      encoding: 'utf8',
-      stdio: ['pipe', 'pipe', 'pipe'],
-    })
-      .trim()
-      .split('\n')
-      .filter(Boolean);
-
-    // Combine all
-    const allFiles = [...new Set([...diffFiles, ...stagedFiles, ...untrackedFiles])];
-
-    // Get diff stats
-    let additions = 0;
-    let deletions = 0;
-    tryOptional(() => {
-      const stats = execFileSync('git', ['diff', '--shortstat', 'HEAD'], {
-        cwd: rootDir,
-        encoding: 'utf8',
-        stdio: ['pipe', 'pipe', 'pipe'],
-      });
-      const addMatch = stats.match(/(\d+) insertion/);
-      const delMatch = stats.match(/(\d+) deletion/);
-      if (addMatch) additions = parseInt(addMatch[1]);
-      if (delMatch) deletions = parseInt(delMatch[1]);
-    }, 'git diff stats');
-
-    return {
-      files: allFiles,
-      additions,
-      deletions,
-      hasChanges: allFiles.length > 0,
-    };
-  } catch (e) {
-    return { files: [], additions: 0, deletions: 0, hasChanges: false };
-  }
-}
-
-// Detect which domain the changes relate to
-function detectDomain(files) {
-  const domainScores = {};
-
-  for (const file of files) {
-    for (const [domain, patterns] of Object.entries(DOMAIN_PATTERNS)) {
-      for (const pattern of patterns) {
-        if (pattern.test(file.toLowerCase())) {
-          domainScores[domain] = (domainScores[domain] || 0) + 1;
-        }
-      }
-    }
-  }
-
-  // Return domain with highest score
-  const sorted = Object.entries(domainScores).sort((a, b) => b[1] - a[1]);
-  return sorted.length > 0 ? sorted[0][0] : null;
-}
-
-// Generate learning summary from changes
-function generateLearningSummary(diff, activeAgent) {
-  const { files, additions, deletions } = diff;
-
-  if (files.length === 0) return null;
-
-  // Categorize files
-  const newFiles = files.filter(f => !f.includes('/'));
-  const testFiles = files.filter(f => /\.(test|spec)\.[jt]sx?$/.test(f));
-  const configFiles = files.filter(f => /\.(json|yaml|yml|toml|config\.)/.test(f));
-  const codeFiles = files.filter(f => /\.[jt]sx?$/.test(f) && !testFiles.includes(f));
-
-  // Build summary
-  const parts = [];
-
-  if (codeFiles.length > 0) {
-    const dirs = [...new Set(codeFiles.map(f => path.dirname(f)))];
-    parts.push(`Modified ${codeFiles.length} code file(s) in: ${dirs.slice(0, 3).join(', ')}`);
-  }
-
-  if (testFiles.length > 0) {
-    parts.push(`Updated ${testFiles.length} test file(s)`);
-  }
-
-  if (configFiles.length > 0) {
-    parts.push(`Changed config: ${configFiles.slice(0, 2).join(', ')}`);
-  }
-
-  if (additions > 50 || deletions > 50) {
-    parts.push(`Significant changes: +${additions}/-${deletions} lines`);
-  }
-
-  return parts.length > 0 ? parts.join('. ') : null;
-}
-
-// Find expertise file for agent
-function getExpertisePath(rootDir, agent) {
-  // Try installed location first
-  const installedPath = path.join(rootDir, '.agileflow', 'experts', agent, 'expertise.yaml');
-  if (fs.existsSync(installedPath)) return installedPath;
-
-  // Try source location
-  const sourcePath = path.join(
-    rootDir,
-    'packages',
-    'cli',
-    'src',
-    'core',
-    'experts',
-    agent,
-    'expertise.yaml'
-  );
-  if (fs.existsSync(sourcePath)) return sourcePath;
-
-  return null;
-}
-
-// Append learning to expertise file
-function appendLearning(expertisePath, learning) {
-  const readResult = safeReadFile(expertisePath);
-  if (!readResult.ok) return false;
-
-  let content = readResult.data;
-
-  // Find the learnings section
-  const learningsMatch = content.match(/^learnings:\s*$/m);
-
-  if (!learningsMatch) {
-    // No learnings section, add it at the end
-    content += `\n\nlearnings:\n${learning}`;
-  } else {
-    // Find where to insert (after "learnings:" line)
-    const insertPos = learningsMatch.index + learningsMatch[0].length;
-    content = content.slice(0, insertPos) + '\n' + learning + content.slice(insertPos);
-  }
-
-  const writeResult = safeWriteFile(expertisePath, content);
-  return writeResult.ok;
-}
-
-// Format learning as YAML
-function formatLearning(summary, files, detectedDomain) {
-  const date = new Date().toISOString().split('T')[0];
-  const topFiles = files
-    .slice(0, 5)
-    .map(f => `      - ${f}`)
-    .join('\n');
-
-  return `  - date: "${date}"
-    auto_generated: true
-    context: "Session work - ${detectedDomain || 'general'} domain"
-    insight: "${summary.replace(/"/g, '\\"')}"
-    files_touched:
-${topFiles}`;
-}
-
-// Main function
-function main() {
-  const rootDir = getProjectRoot();
-  const state = getSessionState(rootDir);
-  const diff = getGitDiff(rootDir);
-
-  // Check if there were any changes
-  if (!diff.hasChanges) {
-    return; // Silent exit - no changes to learn from
-  }
-
-  // Detect which agent was active
-  let activeAgent = null;
-
-  // Check session state for active command
-  if (state.active_command?.name) {
-    const name = state.active_command.name.replace('agileflow-', '');
-    if (AGENTS_WITH_EXPERTISE.includes(name)) {
-      activeAgent = name;
-    }
-  }
-
-  // If no agent from session, detect from file changes
-  if (!activeAgent) {
-    activeAgent = detectDomain(diff.files);
-  }
-
-  // If still no agent, skip
-  if (!activeAgent || !AGENTS_WITH_EXPERTISE.includes(activeAgent)) {
-    return; // Silent exit - can't determine which agent to update
-  }
-
-  // Find expertise file
-  const expertisePath = getExpertisePath(rootDir, activeAgent);
-  if (!expertisePath) {
-    return; // Silent exit - no expertise file found
-  }
-
-  // Generate learning summary
-  const summary = generateLearningSummary(diff, activeAgent);
-  if (!summary) {
-    return; // Silent exit - no meaningful summary
-  }
-
-  // Format and append learning
-  const learningYaml = formatLearning(summary, diff.files, activeAgent);
-  const success = appendLearning(expertisePath, learningYaml);
-
-  if (success) {
-    console.log('');
-    console.log(`${c.green}✓ Auto-learned:${c.reset} ${c.dim}${activeAgent}${c.reset}`);
-    console.log(`${c.dim}  ${summary}${c.reset}`);
-    console.log(
-      `${c.dim}  → Updated ${path.basename(path.dirname(expertisePath))}/expertise.yaml${c.reset}`
-    );
-    console.log('');
-  }
-}
-
-// Run if executed directly
-if (require.main === module) {
-  try {
-    main();
-  } catch (e) {
-    // Silent fail - don't break the workflow
-    if (process.env.DEBUG) {
-      console.error('auto-self-improve error:', e.message);
-    }
-  }
-}
-
-module.exports = { main, detectDomain, generateLearningSummary };

package/scripts/automation-run-due.js

@@ -1,128 +0,0 @@
-#!/usr/bin/env node
-/**
- * automation-run-due.js - Run all due automations
- *
- * This script is spawned by the SessionStart hook to run
- * due automations in the background without blocking the welcome display.
- *
- * Usage:
- *   node automation-run-due.js [--verbose]
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-// Resolve paths for automation modules
-let automationRunner;
-try {
-  automationRunner = require('./lib/automation-runner.js');
-} catch (e) {
-  console.error('Automation runner not available:', e.message);
-  process.exit(1);
-}
-
-const { getProjectRoot, getBusLogPath } = require('../lib/paths');
-
-// Parse arguments
-const verbose = process.argv.includes('--verbose') || process.argv.includes('-v');
-
-/**
- * Log to bus/log.jsonl
- */
-function logToBus(rootDir, message) {
-  try {
-    const busPath = getBusLogPath(rootDir);
-    const dir = path.dirname(busPath);
-
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-
-    const entry = {
-      ts: new Date().toISOString(),
-      from: 'AUTOMATION',
-      type: 'automation',
-      ...message,
-    };
-
-    fs.appendFileSync(busPath, JSON.stringify(entry) + '\n');
-  } catch (e) {
-    // Silently fail
-  }
-}
-
-/**
- * Main entry point
- */
-async function main() {
-  const rootDir = getProjectRoot();
-  const runner = automationRunner.getAutomationRunner({ rootDir });
-
-  // Log start
-  logToBus(rootDir, {
-    action: 'run_due_started',
-    timestamp: new Date().toISOString(),
-  });
-
-  if (verbose) {
-    console.log('[Automation] Checking for due automations...');
-  }
-
-  try {
-    const { ran, results } = await runner.runDue();
-
-    if (ran === 0) {
-      if (verbose) {
-        console.log('[Automation] No automations due.');
-      }
-      return;
-    }
-
-    // Log results
-    const successful = results.filter(r => r.success).length;
-    const failed = results.filter(r => !r.success).length;
-
-    logToBus(rootDir, {
-      action: 'run_due_completed',
-      ran,
-      successful,
-      failed,
-      results: results.map(r => ({
-        id: r.id,
-        success: r.success,
-        duration_ms: r.duration_ms,
-        error: r.error,
-      })),
-    });
-
-    if (verbose) {
-      console.log(
-        `[Automation] Ran ${ran} automation(s): ${successful} succeeded, ${failed} failed`
-      );
-      for (const result of results) {
-        const status = result.success ? '✓' : '✗';
-        console.log(`  ${status} ${result.id} (${result.duration_ms}ms)`);
-        if (result.error) {
-          console.log(`    Error: ${result.error}`);
-        }
-      }
-    }
-  } catch (error) {
-    logToBus(rootDir, {
-      action: 'run_due_error',
-      error: error.message,
-    });
-
-    if (verbose) {
-      console.error('[Automation] Error:', error.message);
-    }
-    process.exit(1);
-  }
-}
-
-main().catch(error => {
-  console.error('Unexpected error:', error);
-  process.exit(1);
-});

package/scripts/babysit-clear-restore.js

@@ -1,154 +0,0 @@
-#!/usr/bin/env node
-/**
- * babysit-clear-restore.js - SessionStart hook for babysit context preservation
- *
- * When context is cleared (e.g., after plan approval), this hook:
- * 1. Detects source="clear" from Claude Code's SessionStart event
- * 2. Checks if /babysit is active in session-state.json
- * 3. If both, outputs the COMPACT_SUMMARY from the babysit command file
- * 4. Sets last_precompact_at so the welcome script preserves active_commands
- *
- * This eliminates the need to manually embed babysit rules in plan files (Rule #6).
- * The hook automatically injects the rules into the fresh context after clear.
- *
- * Exit codes:
- *   0 = Success (always - SessionStart hooks should never block)
- *
- * Input: JSON on stdin with { source: "startup"|"resume"|"clear"|"compact", ... }
- * Output: Babysit compact summary to stdout (appears as system-reminder)
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const STDIN_TIMEOUT_MS = 3000;
-
-function findProjectRoot() {
-  let dir = process.cwd();
-  while (dir !== '/') {
-    if (fs.existsSync(path.join(dir, '.agileflow'))) return dir;
-    if (fs.existsSync(path.join(dir, 'docs', '09-agents'))) return dir;
-    dir = path.dirname(dir);
-  }
-  return process.cwd();
-}
-
-const ROOT = findProjectRoot();
-
-function getSessionState() {
-  const statePath = path.join(ROOT, 'docs', '09-agents', 'session-state.json');
-  try {
-    if (fs.existsSync(statePath)) {
-      return JSON.parse(fs.readFileSync(statePath, 'utf8'));
-    }
-  } catch (e) {
-    // Silently fail
-  }
-  return null;
-}
-
-function isBabysitActive(state) {
-  if (!state) return false;
-  const activeCommands = state.active_commands || [];
-  return activeCommands.some(cmd => cmd.name === 'babysit');
-}
-
-function setPrecompactTimestamp(state) {
-  const statePath = path.join(ROOT, 'docs', '09-agents', 'session-state.json');
-  try {
-    state.last_precompact_at = new Date().toISOString();
-    fs.writeFileSync(statePath, JSON.stringify(state, null, 2) + '\n');
-  } catch (e) {
-    // Silently fail
-  }
-}
-
-function getBabysitCompactSummary() {
-  // Search for the babysit command file in known locations
-  const locations = [
-    path.join(ROOT, 'packages', 'cli', 'src', 'core', 'commands', 'babysit.md'),
-    path.join(ROOT, '.agileflow', 'commands', 'babysit.md'),
-    path.join(ROOT, '.claude', 'commands', 'agileflow', 'babysit.md'),
-  ];
-
-  for (const filePath of locations) {
-    try {
-      if (!fs.existsSync(filePath)) continue;
-      const content = fs.readFileSync(filePath, 'utf8');
-      const match = content.match(
-        /<!-- COMPACT_SUMMARY_START[\s\S]*?-->([\s\S]*?)<!-- COMPACT_SUMMARY_END -->/
-      );
-      if (match) {
-        return match[1].trim();
-      }
-    } catch (e) {
-      // Try next location
-    }
-  }
-  return null;
-}
-
-// Read stdin for hook event data
-let inputData = '';
-
-process.stdin.setEncoding('utf8');
-
-process.stdin.on('data', chunk => {
-  inputData += chunk;
-});
-
-process.stdin.on('end', () => {
-  try {
-    const input = JSON.parse(inputData);
-    const source = input.source;
-
-    // Only act on "clear" events (context cleared after plan approval, /clear, etc.)
-    if (source !== 'clear') {
-      process.exit(0);
-      return;
-    }
-
-    const state = getSessionState();
-    if (!isBabysitActive(state)) {
-      process.exit(0);
-      return;
-    }
-
-    // Set last_precompact_at so the welcome script preserves active_commands
-    // instead of clearing them (it checks this timestamp)
-    setPrecompactTimestamp(state);
-
-    // Output the babysit compact summary
-    const summary = getBabysitCompactSummary();
-    if (summary) {
-      console.log('## ACTIVE COMMAND: /agileflow:babysit (restored after context clear)');
-      console.log('');
-      console.log(summary);
-    } else {
-      // Fallback: output minimal babysit rules if command file not found
-      console.log('## /agileflow:babysit IS ACTIVE (restored after context clear)');
-      console.log('');
-      console.log('MANDATORY RULES:');
-      console.log('1. ALWAYS end responses with AskUserQuestion tool (specific options, not text)');
-      console.log('2. Use EnterPlanMode for non-trivial tasks');
-      console.log('3. Delegate complex work to domain experts via Task tool');
-      console.log('4. Track progress with TaskCreate/TaskUpdate for multi-step work');
-      console.log(
-        '5. ALWAYS suggest logic audit post-implementation (after tests pass, make Recommended)'
-      );
-    }
-  } catch (e) {
-    // Parse failed or other error - fail open
-  }
-  process.exit(0);
-});
-
-// Handle no stdin (direct invocation or timeout)
-process.stdin.on('error', () => {
-  process.exit(0);
-});
-
-// Timeout safety - don't hang
-setTimeout(() => {
-  process.exit(0);
-}, STDIN_TIMEOUT_MS);

package/scripts/babysit-context-restore.js

@@ -1,89 +0,0 @@
-#!/usr/bin/env node
-/**
- * babysit-context-restore.js - UserPromptSubmit hook
- *
- * Backup mechanism to restore babysit context after plan mode clears context.
- * When user selects "Clear context and bypass permissions" after ExitPlanMode,
- * this hook fires on the next user prompt and reminds Claude of babysit rules.
- *
- * The primary mechanism is embedding rules in the plan file (Rule #6).
- * This hook is a backup for edge cases where plan file approach might miss.
- *
- * Usage: Called automatically as UserPromptSubmit hook
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// Find session-state.json - try multiple locations
-function findSessionState() {
-  const locations = [
-    'docs/09-agents/session-state.json',
-    path.join(process.env.CLAUDE_PROJECT_DIR || '.', 'docs/09-agents/session-state.json'),
-  ];
-
-  for (const loc of locations) {
-    if (fs.existsSync(loc)) {
-      return loc;
-    }
-  }
-  return null;
-}
-
-function main() {
-  const sessionStatePath = findSessionState();
-  if (!sessionStatePath) return;
-
-  try {
-    const state = JSON.parse(fs.readFileSync(sessionStatePath, 'utf8'));
-
-    // Check if restoration is pending
-    if (!state.babysit_pending_restore) return;
-
-    // Output restoration context
-    console.log('');
-    console.log('\x1b[36m╔══════════════════════════════════════════════════════════════╗\x1b[0m');
-    console.log(
-      '\x1b[36m║\x1b[0m  \x1b[1m\x1b[33m/babysit CONTEXT RESTORED\x1b[0m                                   \x1b[36m║\x1b[0m'
-    );
-    console.log('\x1b[36m╠══════════════════════════════════════════════════════════════╣\x1b[0m');
-    console.log(
-      '\x1b[36m║\x1b[0m  /agileflow:babysit was active before context clear.         \x1b[36m║\x1b[0m'
-    );
-    console.log(
-      '\x1b[36m║\x1b[0m  These rules are MANDATORY:                                  \x1b[36m║\x1b[0m'
-    );
-    console.log(
-      '\x1b[36m║\x1b[0m                                                              \x1b[36m║\x1b[0m'
-    );
-    console.log(
-      '\x1b[36m║\x1b[0m  1. ALWAYS end responses with AskUserQuestion tool           \x1b[36m║\x1b[0m'
-    );
-    console.log(
-      '\x1b[36m║\x1b[0m  2. Use EnterPlanMode before non-trivial tasks               \x1b[36m║\x1b[0m'
-    );
-    console.log(
-      '\x1b[36m║\x1b[0m  3. Delegate complex work to domain experts                  \x1b[36m║\x1b[0m'
-    );
-    console.log(
-      '\x1b[36m║\x1b[0m  4. Track progress with TaskCreate/TaskUpdate for 3+ step tasks          \x1b[36m║\x1b[0m'
-    );
-    console.log(
-      '\x1b[36m║\x1b[0m                                                              \x1b[36m║\x1b[0m'
-    );
-    console.log(
-      '\x1b[36m║\x1b[0m  For full context: /agileflow:babysit                        \x1b[36m║\x1b[0m'
-    );
-    console.log('\x1b[36m╚══════════════════════════════════════════════════════════════╝\x1b[0m');
-    console.log('');
-
-    // Clear the flag (one-time restoration)
-    state.babysit_pending_restore = false;
-    state.babysit_restored_at = new Date().toISOString();
-    fs.writeFileSync(sessionStatePath, JSON.stringify(state, null, 2) + '\n');
-  } catch (e) {
-    // Silently fail - don't break user's workflow
-  }
-}
-
-main();