agileflow 3.4.3 → 4.0.0-alpha.2

package/scripts/resume-session.sh

@@ -1,121 +0,0 @@
-#!/bin/bash
-# AgileFlow Session Resume Script
-# This script is called by the SessionStart hook to automatically resume sessions.
-# It replicates the functionality of /agileflow:session:resume as a shell script.
-
-set -e
-
-echo "🔄 Resuming AgileFlow Session..."
-echo ""
-
-# Load environment configuration
-if [ ! -f "docs/00-meta/environment.json" ]; then
-  echo "⚠️  Session harness not initialized"
-  echo "   Run /agileflow:session:init to set up session management"
-  exit 0
-fi
-
-# Extract configuration
-TEST_COMMAND=$(jq -r '.test_command // "echo \"No test command configured\""' docs/00-meta/environment.json 2>/dev/null)
-INIT_SCRIPT=$(jq -r '.init_script // "./docs/00-meta/init.sh"' docs/00-meta/environment.json 2>/dev/null)
-VERIFICATION_POLICY=$(jq -r '.verification_policy // "warn"' docs/00-meta/environment.json 2>/dev/null)
-
-# Step 1: Run initialization script
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "🚀 Running Initialization Script..."
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-if [ -f "$INIT_SCRIPT" ] && [ -x "$INIT_SCRIPT" ]; then
-  if bash "$INIT_SCRIPT"; then
-    echo ""
-    echo "✅ Initialization complete"
-  else
-    echo ""
-    echo "⚠️  Initialization script failed (exit code $?)"
-    echo "   Continuing with test verification..."
-  fi
-else
-  echo "⚠️  Init script not found or not executable: $INIT_SCRIPT"
-  echo "   Skipping initialization"
-fi
-
-echo ""
-
-# Step 2: Run test verification
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "🧪 Running Test Verification..."
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-echo "Command: $TEST_COMMAND"
-echo ""
-
-START_TIME=$(date +%s)
-
-if eval "$TEST_COMMAND"; then
-  END_TIME=$(date +%s)
-  DURATION=$((END_TIME - START_TIME))
-  echo ""
-  echo "✅ Tests passing (${DURATION}s)"
-  TEST_STATUS="passing"
-else
-  END_TIME=$(date +%s)
-  DURATION=$((END_TIME - START_TIME))
-  EXIT_CODE=$?
-  echo ""
-  echo "⚠️  Tests failing (exit code $EXIT_CODE, ${DURATION}s)"
-  TEST_STATUS="failing"
-
-  if [ "$VERIFICATION_POLICY" = "block" ]; then
-    echo ""
-    echo "❌ Verification policy: block"
-    echo "   Cannot proceed with failing tests"
-    exit 1
-  else
-    echo ""
-    echo "⚠️  Verification policy: warn"
-    echo "   You can proceed, but tests are failing"
-  fi
-fi
-
-echo ""
-
-# Step 3: Load session context
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "📊 Session Summary"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-# Get baseline info
-BASELINE_COMMIT=$(jq -r '.baseline_commit // "Not established"' docs/00-meta/environment.json 2>/dev/null)
-BASELINE_DATE=$(jq -r '.baseline_established // "N/A"' docs/00-meta/environment.json 2>/dev/null)
-
-# Get current session info
-if [ -f "docs/09-agents/session-state.json" ]; then
-  CURRENT_STORY=$(jq -r '.current_session.current_story // "None"' docs/09-agents/session-state.json 2>/dev/null)
-  ACTIVE_AGENT=$(jq -r '.current_session.active_agent // "None"' docs/09-agents/session-state.json 2>/dev/null)
-else
-  CURRENT_STORY="None"
-  ACTIVE_AGENT="None"
-fi
-
-# Display summary
-echo "Baseline: ${BASELINE_COMMIT:0:7} ($BASELINE_DATE)"
-echo "Status: $TEST_STATUS"
-echo "Active Story: $CURRENT_STORY"
-echo "Active Agent: $ACTIVE_AGENT"
-
-# Get recent commits
-echo ""
-echo "Recent Activity:"
-if git log --oneline -3 2>/dev/null; then
-  :
-else
-  echo "  (Git history unavailable)"
-fi
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "✅ Session Resumed - Ready to work! 🚀"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""

package/scripts/screenshot-verifier.js

@@ -1,215 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * screenshot-verifier.js - Verify all screenshots have been reviewed
- *
- * Part of Visual Mode for UI development. This script checks that all
- * screenshots in a directory have been prefixed with "verified-" to
- * confirm Claude has visually reviewed each one.
- *
- * Usage:
- *   node scripts/screenshot-verifier.js                    # Default: ./screenshots
- *   node scripts/screenshot-verifier.js --path ./e2e/shots # Custom path
- *   node scripts/screenshot-verifier.js --help             # Show help
- *
- * Exit codes:
- *   0 - All screenshots verified (or no screenshots found)
- *   1 - Some screenshots missing verified- prefix
- *   2 - Error (directory not found, etc.)
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// Shared utilities
-const { c } = require('../lib/colors');
-
-// Parse command line arguments
-function parseArgs() {
-  const args = process.argv.slice(2);
-  const options = {
-    path: './screenshots',
-    help: false,
-    quiet: false,
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-
-    if (arg === '--help' || arg === '-h') {
-      options.help = true;
-    } else if (arg === '--quiet' || arg === '-q') {
-      options.quiet = true;
-    } else if (arg === '--path' || arg === '-p') {
-      if (args[i + 1]) {
-        options.path = args[i + 1];
-        i++;
-      }
-    } else if (!arg.startsWith('-')) {
-      // Positional argument - treat as path
-      options.path = arg;
-    }
-  }
-
-  return options;
-}
-
-// Show help message
-function showHelp() {
-  console.log(`
-${c.brand}${c.bold}screenshot-verifier${c.reset} - Verify all screenshots have been reviewed
-
-${c.bold}USAGE${c.reset}
-  node screenshot-verifier.js [OPTIONS] [PATH]
-
-${c.bold}OPTIONS${c.reset}
-  --path, -p <dir>   Directory containing screenshots (default: ./screenshots)
-  --quiet, -q        Only output on failure
-  --help, -h         Show this help message
-
-${c.bold}EXAMPLES${c.reset}
-  node screenshot-verifier.js                       # Check ./screenshots
-  node screenshot-verifier.js ./tests/e2e/shots     # Check custom path
-  node screenshot-verifier.js --path ./shots -q     # Quiet mode
-
-${c.bold}EXIT CODES${c.reset}
-  0 - All screenshots verified (or no screenshots found)
-  1 - Some screenshots missing 'verified-' prefix
-  2 - Error (directory not found, etc.)
-
-${c.bold}VISUAL MODE${c.reset}
-  This script is part of AgileFlow's Visual Mode for UI development.
-
-  Workflow:
-  1. Playwright tests create screenshots in the target directory
-  2. Claude reviews each screenshot visually
-  3. Claude renames verified screenshots with 'verified-' prefix
-  4. This script confirms all screenshots have been reviewed
-
-  The 'verified-' prefix ensures Claude actually looked at each image
-  rather than declaring completion prematurely.
-`);
-}
-
-// Get all image files in directory
-function getImageFiles(dir) {
-  const imageExtensions = ['.png', '.jpg', '.jpeg', '.webp', '.gif'];
-
-  try {
-    const files = fs.readdirSync(dir);
-    return files.filter(file => {
-      const ext = path.extname(file).toLowerCase();
-      return imageExtensions.includes(ext);
-    });
-  } catch (err) {
-    if (err.code === 'ENOENT') {
-      return null; // Directory doesn't exist
-    }
-    throw err;
-  }
-}
-
-// Main verification logic
-function verifyScreenshots(options) {
-  const dir = path.resolve(options.path);
-
-  // Check if directory exists
-  if (!fs.existsSync(dir)) {
-    if (!options.quiet) {
-      console.log(`${c.yellow}No screenshots directory found at: ${dir}${c.reset}`);
-      console.log(`${c.dim}Create the directory or run tests to generate screenshots.${c.reset}`);
-    }
-    return { success: true, total: 0, verified: 0, unverified: [] };
-  }
-
-  // Get all image files
-  const files = getImageFiles(dir);
-
-  if (files === null) {
-    console.error(`${c.red}Error: Could not read directory: ${dir}${c.reset}`);
-    process.exit(2);
-  }
-
-  if (files.length === 0) {
-    if (!options.quiet) {
-      console.log(`${c.yellow}No screenshots found in: ${dir}${c.reset}`);
-    }
-    return { success: true, total: 0, verified: 0, unverified: [] };
-  }
-
-  // Check each file for verified- prefix
-  const verified = [];
-  const unverified = [];
-
-  for (const file of files) {
-    if (file.startsWith('verified-')) {
-      verified.push(file);
-    } else {
-      unverified.push(file);
-    }
-  }
-
-  return {
-    success: unverified.length === 0,
-    total: files.length,
-    verified: verified.length,
-    unverified,
-  };
-}
-
-// Format result output
-function formatResult(result, options) {
-  if (options.quiet && result.success) {
-    return;
-  }
-
-  console.log('');
-
-  if (result.total === 0) {
-    console.log(`${c.yellow}No screenshots to verify${c.reset}`);
-    return;
-  }
-
-  if (result.success) {
-    console.log(`${c.green}${c.bold}All screenshots verified${c.reset}`);
-    console.log(
-      `${c.dim}${result.verified}/${result.total} screenshots have 'verified-' prefix${c.reset}`
-    );
-  } else {
-    console.log(`${c.red}${c.bold}Unverified screenshots found${c.reset}`);
-    console.log(`${c.dim}${result.verified}/${result.total} verified${c.reset}`);
-    console.log('');
-    console.log(`${c.yellow}Missing 'verified-' prefix:${c.reset}`);
-    for (const file of result.unverified) {
-      console.log(`  ${c.red}- ${file}${c.reset}`);
-    }
-    console.log('');
-    console.log(`${c.cyan}To verify: Review each screenshot visually, then rename:${c.reset}`);
-    console.log(`${c.dim}  mv screenshots/example.png screenshots/verified-example.png${c.reset}`);
-  }
-
-  console.log('');
-}
-
-// Main entry point
-function main() {
-  const options = parseArgs();
-
-  if (options.help) {
-    showHelp();
-    process.exit(0);
-  }
-
-  const result = verifyScreenshots(options);
-  formatResult(result, options);
-
-  process.exit(result.success ? 0 : 1);
-}
-
-// Run if called directly
-if (require.main === module) {
-  main();
-}
-
-// Export for testing
-module.exports = { verifyScreenshots, getImageFiles };

package/scripts/session-boundary.js

@@ -1,138 +0,0 @@
-#!/usr/bin/env node
-/**
- * session-boundary.js - PreToolUse hook for Edit/Write session isolation
- *
- * Prevents Claude from editing files outside the active session directory.
- * Used with PreToolUse:Edit and PreToolUse:Write hooks.
- *
- * Exit codes:
- *   0 = Allow the operation
- *   2 = Block with message (shown to Claude)
- *
- * Input: JSON on stdin with tool_input.file_path
- * Output: Error message to stderr if blocking
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// Inline colors (no external dependency)
-const c = {
-  coral: '\x1b[38;5;203m',
-  dim: '\x1b[2m',
-  reset: '\x1b[0m',
-};
-
-const STDIN_TIMEOUT_MS = 4000;
-
-// Find project root by looking for .agileflow directory
-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();
-const SESSION_STATE_PATH = path.join(ROOT, 'docs', '09-agents', 'session-state.json');
-
-// Get active session from session-state.json
-function getActiveSession() {
-  try {
-    if (!fs.existsSync(SESSION_STATE_PATH)) {
-      return null;
-    }
-    const data = JSON.parse(fs.readFileSync(SESSION_STATE_PATH, 'utf8'));
-    return data.active_session || null;
-  } catch (e) {
-    return null;
-  }
-}
-
-// Check if filePath is inside sessionPath
-function isInsideSession(filePath, sessionPath) {
-  const normalizedFile = path.resolve(filePath);
-  const normalizedSession = path.resolve(sessionPath);
-
-  return (
-    normalizedFile.startsWith(normalizedSession + path.sep) || normalizedFile === normalizedSession
-  );
-}
-
-// Output blocked message
-function outputBlocked(filePath, activeSession) {
-  const sessionName = activeSession.nickname
-    ? `"${activeSession.nickname}"`
-    : `Session ${activeSession.id}`;
-
-  console.error(`${c.coral}[SESSION BOUNDARY]${c.reset} Edit blocked`);
-  console.error(`${c.dim}File: ${filePath}${c.reset}`);
-  console.error(`${c.dim}Active session: ${sessionName} (${activeSession.path})${c.reset}`);
-  console.error('');
-  console.error(`${c.dim}The file is outside the active session directory.${c.reset}`);
-  console.error(`${c.dim}Use /agileflow:session:resume to switch sessions first.${c.reset}`);
-}
-
-// Main logic - run with stdin events (async)
-function main() {
-  let inputData = '';
-
-  process.stdin.setEncoding('utf8');
-
-  process.stdin.on('data', chunk => {
-    inputData += chunk;
-  });
-
-  process.stdin.on('end', () => {
-    try {
-      // Parse tool input from Claude Code
-      const hookData = JSON.parse(inputData);
-      const filePath = hookData?.tool_input?.file_path;
-
-      if (!filePath) {
-        // No file path in input - allow
-        process.exit(0);
-      }
-
-      // Get active session
-      const activeSession = getActiveSession();
-
-      if (!activeSession || !activeSession.path) {
-        // No active session set - allow all (normal behavior)
-        process.exit(0);
-      }
-
-      // Check if file is inside active session
-      if (isInsideSession(filePath, activeSession.path)) {
-        // File is inside active session - allow
-        process.exit(0);
-      }
-
-      // File is OUTSIDE active session - BLOCK
-      outputBlocked(filePath, activeSession);
-      process.exit(2);
-    } catch (e) {
-      // Parse error or other issue - fail open
-      process.exit(0);
-    }
-  });
-
-  // Handle no stdin (direct invocation)
-  process.stdin.on('error', () => {
-    process.exit(0);
-  });
-
-  // Set timeout to prevent hanging
-  setTimeout(() => {
-    process.exit(0);
-  }, STDIN_TIMEOUT_MS);
-}
-
-main();

package/scripts/session-coordinator.sh

@@ -1,232 +0,0 @@
-#!/bin/bash
-# session-coordinator.sh - Automatic multi-session coordination
-# Detects concurrent Claude Code sessions and handles conflicts
-
-set -e
-
-SESSIONS_DIR=".agileflow/sessions"
-LOCK_TIMEOUT=3600  # 1 hour - stale session threshold
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-CYAN='\033[0;36m'
-DIM='\033[2m'
-RESET='\033[0m'
-
-# Get current session ID (PID + timestamp for uniqueness)
-SESSION_ID="$$-$(date +%s)"
-SESSION_FILE="$SESSIONS_DIR/session-$SESSION_ID.lock"
-
-# Ensure sessions directory exists
-mkdir -p "$SESSIONS_DIR"
-
-# Function: Check if a PID is still running
-is_pid_alive() {
-    local pid=$1
-    if [[ -z "$pid" ]]; then
-        return 1
-    fi
-    kill -0 "$pid" 2>/dev/null
-}
-
-# Function: Clean up stale sessions
-cleanup_stale_sessions() {
-    local now=$(date +%s)
-
-    for lockfile in "$SESSIONS_DIR"/session-*.lock; do
-        [[ -f "$lockfile" ]] || continue
-
-        # Read lock file
-        local lock_pid=$(grep "^pid=" "$lockfile" 2>/dev/null | cut -d= -f2)
-        local lock_time=$(grep "^started=" "$lockfile" 2>/dev/null | cut -d= -f2)
-
-        # Check if stale (PID dead or too old)
-        if ! is_pid_alive "$lock_pid"; then
-            rm -f "$lockfile"
-            continue
-        fi
-
-        # Check if expired
-        if [[ -n "$lock_time" ]]; then
-            local age=$((now - lock_time))
-            if [[ $age -gt $LOCK_TIMEOUT ]]; then
-                rm -f "$lockfile"
-            fi
-        fi
-    done
-}
-
-# Function: Get list of active sessions
-get_active_sessions() {
-    local sessions=()
-
-    for lockfile in "$SESSIONS_DIR"/session-*.lock; do
-        [[ -f "$lockfile" ]] || continue
-
-        local lock_pid=$(grep "^pid=" "$lockfile" 2>/dev/null | cut -d= -f2)
-
-        if is_pid_alive "$lock_pid"; then
-            local branch=$(grep "^branch=" "$lockfile" 2>/dev/null | cut -d= -f2)
-            local worktree=$(grep "^worktree=" "$lockfile" 2>/dev/null | cut -d= -f2)
-            local story=$(grep "^story=" "$lockfile" 2>/dev/null | cut -d= -f2)
-            sessions+=("$lock_pid:$branch:$worktree:$story")
-        fi
-    done
-
-    printf '%s\n' "${sessions[@]}"
-}
-
-# Function: Register this session
-register_session() {
-    local branch=$(git branch --show-current 2>/dev/null || echo "unknown")
-    local worktree=$(pwd)
-    local story=""
-
-    # Try to get current story from status.json
-    if [[ -f "docs/09-agents/status.json" ]]; then
-        story=$(grep -o '"current_story"[[:space:]]*:[[:space:]]*"[^"]*"' docs/09-agents/status.json 2>/dev/null | cut -d'"' -f4 || echo "")
-    fi
-
-    cat > "$SESSION_FILE" << EOF
-pid=$$
-started=$(date +%s)
-branch=$branch
-worktree=$worktree
-story=$story
-user=$(whoami)
-EOF
-}
-
-# Function: Unregister session (called on exit)
-unregister_session() {
-    rm -f "$SESSION_FILE"
-}
-
-# Function: Create worktree for parallel work
-create_worktree() {
-    local branch_name=$1
-    local worktree_path="../$(basename $(pwd))-$branch_name"
-
-    echo -e "${BLUE}Creating worktree at $worktree_path...${RESET}"
-
-    # Create branch if it doesn't exist
-    if ! git show-ref --verify --quiet "refs/heads/$branch_name"; then
-        git branch "$branch_name"
-    fi
-
-    # Create worktree
-    git worktree add "$worktree_path" "$branch_name" 2>/dev/null || {
-        echo -e "${RED}Failed to create worktree${RESET}"
-        return 1
-    }
-
-    echo -e "${GREEN}✓ Worktree created: $worktree_path${RESET}"
-    echo -e "${CYAN}Run: cd $worktree_path && claude${RESET}"
-
-    echo "$worktree_path"
-}
-
-# Function: Display session status
-show_session_status() {
-    local active_sessions=($(get_active_sessions))
-    local count=${#active_sessions[@]}
-
-    if [[ $count -eq 0 ]]; then
-        echo -e "${GREEN}✓ No other active sessions${RESET}"
-        return 0
-    fi
-
-    echo -e "${YELLOW}⚠ $count other session(s) active:${RESET}"
-    echo ""
-
-    for session in "${active_sessions[@]}"; do
-        IFS=':' read -r pid branch worktree story <<< "$session"
-        echo -e "  ${DIM}PID${RESET} $pid"
-        echo -e "  ${DIM}Branch${RESET} $branch"
-        [[ -n "$story" ]] && echo -e "  ${DIM}Story${RESET} $story"
-        echo -e "  ${DIM}Path${RESET} $worktree"
-        echo ""
-    done
-
-    return 1
-}
-
-# Function: Suggest worktree with command
-suggest_worktree() {
-    local suggested_branch="session-$(date +%Y%m%d-%H%M%S)"
-
-    echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
-    echo -e "${YELLOW}To work in parallel without conflicts:${RESET}"
-    echo ""
-    echo -e "  ${GREEN}Option 1: Create isolated worktree (recommended)${RESET}"
-    echo -e "  ${DIM}git worktree add ../${PWD##*/}-parallel $suggested_branch${RESET}"
-    echo -e "  ${DIM}cd ../${PWD##*/}-parallel && claude${RESET}"
-    echo ""
-    echo -e "  ${GREEN}Option 2: Work on different branch${RESET}"
-    echo -e "  ${DIM}git checkout -b $suggested_branch${RESET}"
-    echo ""
-    echo -e "  ${GREEN}Option 3: Continue anyway (risk conflicts)${RESET}"
-    echo -e "  ${DIM}Touch different files than other session${RESET}"
-    echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
-}
-
-# Main execution
-main() {
-    local mode="${1:-check}"
-
-    case "$mode" in
-        "check")
-            # Clean up stale sessions first
-            cleanup_stale_sessions
-
-            # Check for active sessions
-            if show_session_status; then
-                # No conflicts - register and continue
-                register_session
-                trap unregister_session EXIT
-            else
-                # Conflicts detected - show options
-                suggest_worktree
-
-                # Still register (user may proceed anyway)
-                register_session
-                trap unregister_session EXIT
-            fi
-            ;;
-
-        "register")
-            register_session
-            echo -e "${GREEN}✓ Session registered${RESET}"
-            ;;
-
-        "unregister")
-            unregister_session
-            echo -e "${GREEN}✓ Session unregistered${RESET}"
-            ;;
-
-        "status")
-            cleanup_stale_sessions
-            show_session_status
-            ;;
-
-        "worktree")
-            local branch="${2:-session-$(date +%Y%m%d-%H%M%S)}"
-            create_worktree "$branch"
-            ;;
-
-        "cleanup")
-            cleanup_stale_sessions
-            echo -e "${GREEN}✓ Stale sessions cleaned${RESET}"
-            ;;
-
-        *)
-            echo "Usage: session-coordinator.sh [check|register|unregister|status|worktree|cleanup]"
-            exit 1
-            ;;
-    esac
-}
-
-main "$@"