agileflow 2.94.1 → 2.95.0

package/scripts/damage-control/write-tool-damage-control.js

@@ -1,254 +1,19 @@
 #!/usr/bin/env node
 
 /**
- * write-tool-damage-control.js - Enforce path protection for Write tool
+ * write-tool-damage-control.js - PreToolUse hook for Write tool
  *
- * This PreToolUse hook runs before every Write tool execution.
- * It checks the file path against patterns.yaml to block writes
- * to protected paths.
- *
- * Path protection levels:
- *   zeroAccessPaths: Cannot read, write, edit, or delete
- *   readOnlyPaths: Can read, cannot write or delete
- *   noDeletePaths: Can read and write, cannot delete (Write is allowed)
+ * Validates file paths against access control patterns in damage-control-patterns.yaml
+ * before allowing file writes. Part of AgileFlow's damage control system.
  *
  * Exit codes:
- *   0 = Allow write to proceed
- *   2 = Block write
- *
- * Usage (as PreToolUse hook):
- *   node .claude/hooks/damage-control/write-tool-damage-control.js
+ *   0 - Allow operation
+ *   2 - Block operation
  *
- * Environment:
- *   CLAUDE_TOOL_INPUT - JSON string with tool input (contains "file_path")
- *   CLAUDE_PROJECT_DIR - Project root directory
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// ANSI colors for output
-const c = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  red: '\x1b[31m',
-  yellow: '\x1b[33m',
-  cyan: '\x1b[36m',
-};
-
-// Exit codes
-const EXIT_ALLOW = 0;
-const EXIT_BLOCK = 2;
-
-/**
- * Load path protection rules from patterns.yaml
- */
-function loadPathRules(projectDir) {
-  const locations = [
-    path.join(projectDir, '.claude/hooks/damage-control/patterns.yaml'),
-    path.join(projectDir, '.agileflow/hooks/damage-control/patterns.yaml'),
-    path.join(projectDir, 'patterns.yaml'),
-  ];
-
-  for (const loc of locations) {
-    if (fs.existsSync(loc)) {
-      try {
-        const content = fs.readFileSync(loc, 'utf8');
-        return parsePathRules(content);
-      } catch (e) {
-        console.error(`Warning: Could not parse ${loc}: ${e.message}`);
-      }
-    }
-  }
-
-  return getDefaultPathRules();
-}
-
-/**
- * Parse path rules from YAML content
+ * Usage: Configured as PreToolUse hook in .claude/settings.json
  */
-function parsePathRules(content) {
-  const rules = {
-    zeroAccessPaths: [],
-    readOnlyPaths: [],
-    noDeletePaths: [],
-  };
-
-  let currentSection = null;
-
-  const lines = content.split('\n');
-
-  for (const line of lines) {
-    if (line.trim().startsWith('#') || line.trim() === '') continue;
-
-    if (line.match(/^zeroAccessPaths:/)) {
-      currentSection = 'zeroAccessPaths';
-      continue;
-    }
-    if (line.match(/^readOnlyPaths:/)) {
-      currentSection = 'readOnlyPaths';
-      continue;
-    }
-    if (line.match(/^noDeletePaths:/)) {
-      currentSection = 'noDeletePaths';
-      continue;
-    }
-    if (line.match(/^(bashToolPatterns|askPatterns|agileflowPatterns|config):/)) {
-      currentSection = null;
-      continue;
-    }
-
-    if (currentSection && rules[currentSection]) {
-      const pathMatch = line.match(/^\s+-\s*['"]?(.+?)['"]?\s*$/);
-      if (pathMatch) {
-        rules[currentSection].push(pathMatch[1]);
-      }
-    }
-  }
-
-  return rules;
-}
-
-/**
- * Default path rules if patterns.yaml not found
- */
-function getDefaultPathRules() {
-  return {
-    zeroAccessPaths: ['~/.ssh/', '~/.aws/credentials', '.env', '.env.local', '.env.production'],
-    readOnlyPaths: ['/etc/', '~/.bashrc', '~/.zshrc', 'package-lock.json', 'yarn.lock', '.git/'],
-    noDeletePaths: ['.agileflow/', '.claude/', 'docs/09-agents/status.json', 'CLAUDE.md'],
-  };
-}
-
-/**
- * Expand home directory in path
- */
-function expandHome(filePath) {
-  if (filePath.startsWith('~/')) {
-    return path.join(process.env.HOME || '', filePath.slice(2));
-  }
-  return filePath;
-}
-
-/**
- * Check if a file path matches a pattern
- */
-function pathMatches(filePath, pattern) {
-  const expandedPattern = expandHome(pattern);
-  const normalizedFile = path.normalize(filePath);
-  const normalizedPattern = path.normalize(expandedPattern);
-
-  // Exact match
-  if (normalizedFile === normalizedPattern) return true;
-
-  // Directory prefix match
-  if (pattern.endsWith('/')) {
-    if (normalizedFile.startsWith(normalizedPattern)) return true;
-  }
-
-  // Glob pattern (**)
-  if (pattern.includes('**/')) {
-    const globPart = pattern.split('**/')[1];
-    if (normalizedFile.includes(globPart)) return true;
-  }
-
-  // Wildcard at end
-  if (pattern.endsWith('*')) {
-    const prefix = normalizedPattern.slice(0, -1);
-    if (normalizedFile.startsWith(prefix)) return true;
-  }
-
-  // Basename match
-  if (!pattern.includes('/') && !pattern.includes(path.sep)) {
-    const basename = path.basename(normalizedFile);
-    if (basename === pattern) return true;
-    if (pattern.endsWith('*')) {
-      const patternBase = pattern.slice(0, -1);
-      if (basename.startsWith(patternBase)) return true;
-    }
-  }
-
-  return false;
-}
-
-/**
- * Check if file path is protected for writing
- * Returns: { blocked: boolean, reason: string, level: string }
- */
-function checkPath(filePath, rules) {
-  // Check zero access paths (blocked completely)
-  for (const pattern of rules.zeroAccessPaths) {
-    if (pathMatches(filePath, pattern)) {
-      return {
-        blocked: true,
-        reason: `Path is in zero-access protected list: ${pattern}`,
-        level: 'zero-access',
-      };
-    }
-  }
-
-  // Check read-only paths (cannot write)
-  for (const pattern of rules.readOnlyPaths) {
-    if (pathMatches(filePath, pattern)) {
-      return {
-        blocked: true,
-        reason: `Path is read-only: ${pattern}`,
-        level: 'read-only',
-      };
-    }
-  }
-
-  // noDeletePaths allows writing, only blocks deletion
-  // so we don't block writes here
-
-  return { blocked: false, reason: null, level: null };
-}
-
-/**
- * Main entry point
- */
-function main() {
-  const toolInput = process.env.CLAUDE_TOOL_INPUT;
-  const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-
-  if (!toolInput) {
-    process.exit(EXIT_ALLOW);
-  }
-
-  let input;
-  try {
-    input = JSON.parse(toolInput);
-  } catch (e) {
-    console.error('Error parsing CLAUDE_TOOL_INPUT:', e.message);
-    process.exit(EXIT_ALLOW);
-  }
-
-  const filePath = input.file_path;
-  if (!filePath) {
-    process.exit(EXIT_ALLOW);
-  }
-
-  // Resolve to absolute path
-  const absolutePath = path.isAbsolute(filePath) ? filePath : path.join(projectDir, filePath);
-
-  // Load rules
-  const rules = loadPathRules(projectDir);
-
-  // Check path
-  const result = checkPath(absolutePath, rules);
-
-  if (result.blocked) {
-    console.error(`${c.red}${c.bold}BLOCKED${c.reset}: ${result.reason}`);
-    console.error(`${c.yellow}File: ${filePath}${c.reset}`);
-    console.error(`${c.cyan}This file is protected by damage control (${result.level}).${c.reset}`);
-    process.exit(EXIT_BLOCK);
-  }
-
-  process.exit(EXIT_ALLOW);
-}
 
-if (require.main === module) {
-  main();
-}
+const { createPathHook } = require('../lib/damage-control-utils');
 
-module.exports = { checkPath, loadPathRules, pathMatches };
+// Run the hook using factory
+createPathHook('write')();

package/scripts/generate-colors.js

@@ -0,0 +1,314 @@
+#!/usr/bin/env node
+
+/**
+ * generate-colors.js - Generate color files from YAML config
+ *
+ * Reads config/colors.yaml and generates:
+ *   - lib/colors.js (JavaScript module)
+ *   - scripts/lib/colors.sh (Bash script)
+ *
+ * Usage:
+ *   node scripts/generate-colors.js
+ *   node scripts/generate-colors.js --check  # Verify files are up-to-date
+ *
+ * This ensures a single source of truth for all color definitions.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { safeLoad } = require('../lib/yaml-utils');
+
+const ROOT = path.resolve(__dirname, '..');
+const CONFIG_PATH = path.join(ROOT, 'config', 'colors.yaml');
+const JS_OUTPUT = path.join(ROOT, 'lib', 'colors.generated.js');
+const SH_OUTPUT = path.join(ROOT, 'scripts', 'lib', 'colors.generated.sh');
+
+/**
+ * Load colors configuration from YAML
+ * @returns {Object} Colors configuration
+ */
+function loadConfig() {
+  const content = fs.readFileSync(CONFIG_PATH, 'utf8');
+  return safeLoad(content);
+}
+
+/**
+ * Generate JavaScript module content
+ * @param {Object} config - Colors configuration
+ * @returns {string} JavaScript module content
+ */
+function generateJS(config) {
+  const lines = [
+    '/**',
+    ' * colors.generated.js - Auto-generated from config/colors.yaml',
+    ' *',
+    ' * DO NOT EDIT THIS FILE DIRECTLY.',
+    ' * Run: node scripts/generate-colors.js',
+    ' *',
+    ` * Generated: ${new Date().toISOString()}`,
+    ' */',
+    '',
+    "'use strict';",
+    '',
+  ];
+
+  // Brand color
+  lines.push(`// Brand color`);
+  lines.push(`const BRAND_HEX = '${config.brand.hex}';`);
+  lines.push('');
+
+  // Modifiers
+  lines.push('// Modifiers');
+  lines.push('const modifiers = {');
+  for (const [name, code] of Object.entries(config.modifiers)) {
+    lines.push(`  ${name}: '\\x1b[${code}m',`);
+  }
+  lines.push('};');
+  lines.push('');
+
+  // Standard colors
+  lines.push('// Standard ANSI colors');
+  lines.push('const standard = {');
+  for (const [name, code] of Object.entries(config.standard)) {
+    lines.push(`  ${name}: '\\x1b[${code}m',`);
+  }
+  lines.push('};');
+  lines.push('');
+
+  // Bright colors
+  lines.push('// Bright ANSI colors');
+  lines.push('const bright = {');
+  for (const [name, code] of Object.entries(config.bright)) {
+    lines.push(`  bright${name.charAt(0).toUpperCase() + name.slice(1)}: '\\x1b[${code}m',`);
+  }
+  lines.push('};');
+  lines.push('');
+
+  // 256-color palette
+  lines.push('// 256-color palette');
+  lines.push('const palette256 = {');
+  for (const [name, def] of Object.entries(config.palette256)) {
+    const comment = def.comment ? ` // ${def.comment}` : '';
+    lines.push(`  ${name}: '\\x1b[${def.code}m',${comment}`);
+  }
+  lines.push('};');
+  lines.push('');
+
+  // Background colors
+  lines.push('// Background colors');
+  lines.push('const backgrounds = {');
+  for (const [name, code] of Object.entries(config.backgrounds)) {
+    lines.push(`  bg${name.charAt(0).toUpperCase() + name.slice(1)}: '\\x1b[${code}m',`);
+  }
+  lines.push('};');
+  lines.push('');
+
+  // Brand color ANSI
+  lines.push('// Brand color ANSI');
+  lines.push(`const brand = '\\x1b[${config.brand.ansi}m';`);
+  lines.push('');
+
+  // High contrast colors
+  lines.push('// High-contrast mode colors (WCAG AAA)');
+  lines.push('const highContrast = {');
+  for (const [name, code] of Object.entries(config.highContrast)) {
+    lines.push(`  ${name}: '\\x1b[${code}m',`);
+  }
+  lines.push('};');
+  lines.push('');
+
+  // Combined cStandard object (for backward compatibility)
+  lines.push('// Combined standard color palette');
+  lines.push('const cStandard = {');
+  lines.push('  ...modifiers,');
+  lines.push('  ...standard,');
+  lines.push('  ...bright,');
+  lines.push('  ...palette256,');
+  lines.push('  ...backgrounds,');
+  lines.push('  brand,');
+  lines.push(`  orange: brand, // Alias`);
+  lines.push('  // Semantic aliases');
+  for (const [semantic, target] of Object.entries(config.semantic)) {
+    lines.push(`  ${semantic}: standard.${target},`);
+  }
+  lines.push('};');
+  lines.push('');
+
+  // Exports
+  lines.push('module.exports = {');
+  lines.push('  BRAND_HEX,');
+  lines.push('  modifiers,');
+  lines.push('  standard,');
+  lines.push('  bright,');
+  lines.push('  palette256,');
+  lines.push('  backgrounds,');
+  lines.push('  brand,');
+  lines.push('  highContrast,');
+  lines.push('  cStandard,');
+  lines.push('};');
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+/**
+ * Generate Bash script content
+ * @param {Object} config - Colors configuration
+ * @returns {string} Bash script content
+ */
+function generateSH(config) {
+  const lines = [
+    '#!/bin/bash',
+    '# colors.generated.sh - Auto-generated from config/colors.yaml',
+    '#',
+    '# DO NOT EDIT THIS FILE DIRECTLY.',
+    '# Run: node scripts/generate-colors.js',
+    '#',
+    `# Generated: ${new Date().toISOString()}`,
+    '#',
+    '# Usage: source "$(dirname "${BASH_SOURCE[0]}")/colors.generated.sh"',
+    '',
+    '# ============================================================================',
+    '# Modifiers',
+    '# ============================================================================',
+  ];
+
+  for (const [name, code] of Object.entries(config.modifiers)) {
+    lines.push(`${name.toUpperCase()}="\\033[${code}m"`);
+  }
+  lines.push('');
+
+  lines.push('# ============================================================================');
+  lines.push('# Standard ANSI Colors');
+  lines.push('# ============================================================================');
+  for (const [name, code] of Object.entries(config.standard)) {
+    lines.push(`${name.toUpperCase()}="\\033[${code}m"`);
+  }
+  lines.push('');
+
+  lines.push('# ============================================================================');
+  lines.push('# Bright Variants');
+  lines.push('# ============================================================================');
+  for (const [name, code] of Object.entries(config.bright)) {
+    lines.push(`BRIGHT_${name.toUpperCase()}="\\033[${code}m"`);
+  }
+  lines.push('');
+
+  lines.push('# ============================================================================');
+  lines.push('# Semantic Aliases');
+  lines.push('# ============================================================================');
+  for (const [semantic, target] of Object.entries(config.semantic)) {
+    lines.push(`${semantic.toUpperCase()}="$${target.toUpperCase()}"`);
+  }
+  lines.push('');
+
+  lines.push('# ============================================================================');
+  lines.push('# 256-Color Palette');
+  lines.push('# ============================================================================');
+  for (const [name, def] of Object.entries(config.palette256)) {
+    const varName = name.replace(/([A-Z])/g, '_$1').toUpperCase();
+    const comment = def.comment ? `  # ${def.comment}` : '';
+    lines.push(`${varName}="\\033[${def.code}m"${comment}`);
+  }
+  lines.push('');
+
+  lines.push('# ============================================================================');
+  lines.push('# Brand Color');
+  lines.push('# ============================================================================');
+  lines.push(`BRAND="\\033[${config.brand.ansi}m"`);
+  lines.push('ORANGE="$BRAND"  # Alias');
+  lines.push('');
+
+  lines.push('# ============================================================================');
+  lines.push('# Background Colors');
+  lines.push('# ============================================================================');
+  for (const [name, code] of Object.entries(config.backgrounds)) {
+    lines.push(`BG_${name.toUpperCase()}="\\033[${code}m"`);
+  }
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+/**
+ * Main function
+ */
+function main() {
+  const checkMode = process.argv.includes('--check');
+
+  console.log('🎨 Color Generator');
+  console.log('==================');
+  console.log(`Config: ${CONFIG_PATH}`);
+
+  // Load configuration
+  const config = loadConfig();
+  console.log('✓ Loaded colors.yaml');
+
+  // Generate content
+  const jsContent = generateJS(config);
+  const shContent = generateSH(config);
+
+  if (checkMode) {
+    // Check if files are up-to-date
+    let upToDate = true;
+
+    try {
+      const existingJS = fs.readFileSync(JS_OUTPUT, 'utf8');
+      // Compare without timestamp line
+      const normalizeJS = content =>
+        content
+          .split('\n')
+          .filter(line => !line.includes('Generated:'))
+          .join('\n');
+      if (normalizeJS(existingJS) !== normalizeJS(jsContent)) {
+        console.log('✗ lib/colors.generated.js is out of date');
+        upToDate = false;
+      } else {
+        console.log('✓ lib/colors.generated.js is up to date');
+      }
+    } catch {
+      console.log('✗ lib/colors.generated.js does not exist');
+      upToDate = false;
+    }
+
+    try {
+      const existingSH = fs.readFileSync(SH_OUTPUT, 'utf8');
+      const normalizeSH = content =>
+        content
+          .split('\n')
+          .filter(line => !line.includes('Generated:'))
+          .join('\n');
+      if (normalizeSH(existingSH) !== normalizeSH(shContent)) {
+        console.log('✗ scripts/lib/colors.generated.sh is out of date');
+        upToDate = false;
+      } else {
+        console.log('✓ scripts/lib/colors.generated.sh is up to date');
+      }
+    } catch {
+      console.log('✗ scripts/lib/colors.generated.sh does not exist');
+      upToDate = false;
+    }
+
+    if (!upToDate) {
+      console.log('\nRun: node scripts/generate-colors.js');
+      process.exit(1);
+    }
+    console.log('\n✓ All color files are up to date');
+    return;
+  }
+
+  // Write files
+  fs.writeFileSync(JS_OUTPUT, jsContent);
+  console.log(`✓ Generated ${JS_OUTPUT}`);
+
+  fs.writeFileSync(SH_OUTPUT, shContent);
+  console.log(`✓ Generated ${SH_OUTPUT}`);
+
+  console.log('\n✓ Color generation complete!');
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = { loadConfig, generateJS, generateSH };

package/scripts/lib/colors.generated.sh

@@ -0,0 +1,82 @@
+#!/bin/bash
+# colors.generated.sh - Auto-generated from config/colors.yaml
+#
+# DO NOT EDIT THIS FILE DIRECTLY.
+# Run: node scripts/generate-colors.js
+#
+# Generated: 2026-01-29T08:28:33.726Z
+#
+# Usage: source "$(dirname "${BASH_SOURCE[0]}")/colors.generated.sh"
+
+# ============================================================================
+# Modifiers
+# ============================================================================
+RESET="\033[0m"
+BOLD="\033[1m"
+DIM="\033[2m"
+ITALIC="\033[3m"
+UNDERLINE="\033[4m"
+
+# ============================================================================
+# Standard ANSI Colors
+# ============================================================================
+RED="\033[31m"
+GREEN="\033[32m"
+YELLOW="\033[33m"
+BLUE="\033[34m"
+MAGENTA="\033[35m"
+CYAN="\033[36m"
+WHITE="\033[37m"
+BLACK="\033[30m"
+
+# ============================================================================
+# Bright Variants
+# ============================================================================
+BRIGHT_RED="\033[91m"
+BRIGHT_GREEN="\033[92m"
+BRIGHT_YELLOW="\033[93m"
+BRIGHT_BLUE="\033[94m"
+BRIGHT_MAGENTA="\033[95m"
+BRIGHT_CYAN="\033[96m"
+BRIGHT_WHITE="\033[97m"
+BRIGHT_BLACK="\033[90m"
+
+# ============================================================================
+# Semantic Aliases
+# ============================================================================
+SUCCESS="$GREEN"
+ERROR="$RED"
+WARNING="$YELLOW"
+INFO="$CYAN"
+
+# ============================================================================
+# 256-Color Palette
+# ============================================================================
+MINT_GREEN="\033[38;5;158m"  # Healthy/success states
+PEACH="\033[38;5;215m"  # Warning states
+CORAL="\033[38;5;203m"  # Critical/error states
+LIGHT_GREEN="\033[38;5;194m"  # Session healthy
+LIGHT_YELLOW="\033[38;5;228m"  # Session warning
+LIGHT_PINK="\033[38;5;210m"  # Session critical
+SKY_BLUE="\033[38;5;117m"  # Directories/paths, ready states
+LAVENDER="\033[38;5;147m"  # Model info, story IDs
+SOFT_GOLD="\033[38;5;222m"  # Cost/money
+TEAL="\033[38;5;80m"  # Pending states
+SLATE="\033[38;5;103m"  # Secondary info
+ROSE="\033[38;5;211m"  # Blocked/critical accent
+AMBER="\033[38;5;214m"  # WIP/in-progress accent
+POWDER="\033[38;5;153m"  # Labels/headers
+
+# ============================================================================
+# Brand Color
+# ============================================================================
+BRAND="\033[38;2;232;104;58m"
+ORANGE="$BRAND"  # Alias
+
+# ============================================================================
+# Background Colors
+# ============================================================================
+BG_RED="\033[41m"
+BG_GREEN="\033[42m"
+BG_YELLOW="\033[43m"
+BG_BLUE="\033[44m"