agileflow 2.72.0 → 2.74.0

package/src/core/templates/clear-active-command.js

@@ -1,42 +0,0 @@
-#!/usr/bin/env node
-/**
- * clear-active-command.js - Clears active_command on session start
- *
- * This script runs on SessionStart to reset the active_command field
- * in session-state.json. This ensures that if a user starts a new chat
- * without running a command like /babysit, they won't get stale command
- * rules in their PreCompact output.
- *
- * Usage: Called automatically by SessionStart hook
- */
-
-const fs = require('fs');
-const path = require('path');
-
-function clearActiveCommand() {
-  const sessionStatePath = path.join(process.cwd(), 'docs/09-agents/session-state.json');
-
-  // Skip if session-state.json doesn't exist
-  if (!fs.existsSync(sessionStatePath)) {
-    return;
-  }
-
-  try {
-    const sessionState = JSON.parse(fs.readFileSync(sessionStatePath, 'utf8'));
-
-    // Only update if active_command was set
-    if (sessionState.active_command && sessionState.active_command !== null) {
-      sessionState.active_command = null;
-      fs.writeFileSync(sessionStatePath, JSON.stringify(sessionState, null, 2) + '\n', 'utf8');
-      console.log('Cleared active_command from previous session');
-    }
-  } catch (err) {
-    // Silently ignore errors - don't break session start
-  }
-}
-
-if (require.main === module) {
-  clearActiveCommand();
-}
-
-module.exports = { clearActiveCommand };

package/src/core/templates/init.sh

@@ -1,76 +0,0 @@
-#!/bin/bash
-# AgileFlow Development Environment Initialization
-# Generated by AgileFlow session harness
-# This script sets up your development environment for consistent sessions
-
-set -e
-
-echo "🚀 Initializing development environment..."
-
-# Detect project type and install dependencies
-# This section will be customized based on your project
-
-# Node.js projects
-if [ -f "package-lock.json" ]; then
-  echo "📦 Installing dependencies (npm ci)..."
-  npm ci
-elif [ -f "yarn.lock" ]; then
-  echo "📦 Installing dependencies (yarn)..."
-  yarn install --frozen-lockfile
-elif [ -f "pnpm-lock.yaml" ]; then
-  echo "📦 Installing dependencies (pnpm)..."
-  pnpm install --frozen-lockfile
-elif [ -f "package.json" ]; then
-  echo "📦 Installing dependencies (npm install)..."
-  npm install
-fi
-
-# Python projects
-if [ -f "requirements.txt" ]; then
-  echo "📦 Installing Python dependencies..."
-  pip install -r requirements.txt
-fi
-
-if [ -f "poetry.lock" ]; then
-  echo "📦 Installing Poetry dependencies..."
-  poetry install
-fi
-
-# Rust projects
-if [ -f "Cargo.toml" ]; then
-  echo "📦 Building Rust project..."
-  cargo build
-fi
-
-# Go projects
-if [ -f "go.mod" ]; then
-  echo "📦 Downloading Go modules..."
-  go mod download
-fi
-
-# Run database migrations if applicable
-if [ -f "migrations/run.sh" ]; then
-  echo "🗄️  Running database migrations..."
-  bash migrations/run.sh
-fi
-
-if [ -d "prisma" ] && [ -f "package.json" ]; then
-  if command -v npx &> /dev/null; then
-    echo "🗄️  Running Prisma migrations..."
-    npx prisma migrate deploy 2>/dev/null || echo "⚠️  Prisma migrations skipped"
-  fi
-fi
-
-# Environment setup
-if [ -f ".env.example" ] && [ ! -f ".env" ]; then
-  echo "⚙️  Creating .env from .env.example..."
-  cp .env.example .env
-  echo "⚠️  Please configure .env with your settings"
-fi
-
-echo "✅ Environment initialization complete"
-echo ""
-echo "Next steps:"
-echo "  - Run tests: Check environment.json for test_command"
-echo "  - Start dev server: Check environment.json for dev_server.command"
-echo "  - Review .env: Ensure environment variables are configured"

package/src/core/templates/precompact-context.sh

@@ -1,123 +0,0 @@
-#!/bin/bash
-#
-# AgileFlow PreCompact Hook
-# Outputs critical context that should survive conversation compaction.
-#
-
-# Get current version from package.json
-VERSION=$(node -p "require('./package.json').version" 2>/dev/null || echo "unknown")
-
-# Get current git branch
-BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
-
-# Get current story from status.json
-CURRENT_STORY=""
-WIP_COUNT=0
-if [ -f "docs/09-agents/status.json" ]; then
-  CURRENT_STORY=$(node -p "
-    const s = require('./docs/09-agents/status.json');
-    const stories = Object.entries(s.stories || {})
-      .filter(([,v]) => v.status === 'in_progress')
-      .map(([k,v]) => k + ': ' + v.title)
-      .join(', ');
-    stories || 'None in progress';
-  " 2>/dev/null || echo "Unable to read")
-
-  WIP_COUNT=$(node -p "
-    const s = require('./docs/09-agents/status.json');
-    Object.values(s.stories || {}).filter(v => v.status === 'in_progress').length;
-  " 2>/dev/null || echo "0")
-fi
-
-# Get practices list
-PRACTICES=""
-if [ -d "docs/02-practices" ]; then
-  PRACTICES=$(ls docs/02-practices/*.md 2>/dev/null | head -8 | xargs -I {} basename {} .md | tr '\n' ',' | sed 's/,$//')
-fi
-
-# Get active epics
-EPICS=""
-if [ -d "docs/05-epics" ]; then
-  EPICS=$(ls docs/05-epics/ 2>/dev/null | head -5 | tr '\n' ',' | sed 's/,$//')
-fi
-
-# Detect active commands and extract their Compact Summaries
-COMMAND_SUMMARIES=""
-if [ -f "docs/09-agents/session-state.json" ]; then
-  ACTIVE_COMMANDS=$(node -p "
-    const s = require('./docs/09-agents/session-state.json');
-    (s.active_commands || []).map(c => c.name).join(' ');
-  " 2>/dev/null || echo "")
-
-  for ACTIVE_COMMAND in $ACTIVE_COMMANDS; do
-    [ -z "$ACTIVE_COMMAND" ] && continue
-
-    COMMAND_FILE=""
-    if [ -f "packages/cli/src/core/commands/${ACTIVE_COMMAND}.md" ]; then
-      COMMAND_FILE="packages/cli/src/core/commands/${ACTIVE_COMMAND}.md"
-    elif [ -f ".agileflow/commands/${ACTIVE_COMMAND}.md" ]; then
-      COMMAND_FILE=".agileflow/commands/${ACTIVE_COMMAND}.md"
-    elif [ -f ".claude/commands/agileflow/${ACTIVE_COMMAND}.md" ]; then
-      COMMAND_FILE=".claude/commands/agileflow/${ACTIVE_COMMAND}.md"
-    fi
-
-    if [ ! -z "$COMMAND_FILE" ]; then
-      SUMMARY=$(node -e "
-        const fs = require('fs');
-        const content = fs.readFileSync('$COMMAND_FILE', 'utf8');
-        const match = content.match(/<!-- COMPACT_SUMMARY_START[\\s\\S]*?-->([\\s\\S]*?)<!-- COMPACT_SUMMARY_END -->/);
-        if (match) {
-          console.log('## ACTIVE COMMAND: /agileflow:${ACTIVE_COMMAND}');
-          console.log('');
-          console.log(match[1].trim());
-        }
-      " 2>/dev/null || echo "")
-
-      if [ ! -z "$SUMMARY" ]; then
-        COMMAND_SUMMARIES="${COMMAND_SUMMARIES}
-
-${SUMMARY}"
-      fi
-    fi
-  done
-fi
-
-# Output context
-cat << EOF
-AGILEFLOW PROJECT CONTEXT (preserve during compact):
-
-## Project Status
-- Project: AgileFlow v${VERSION}
-- Branch: ${BRANCH}
-- Active Stories: ${CURRENT_STORY}
-- WIP Count: ${WIP_COUNT}
-
-## Key Files to Check After Compact
-- CLAUDE.md - Project system prompt with conventions
-- README.md - Project overview and setup
-- docs/09-agents/status.json - Story statuses and assignments
-- docs/02-practices/ - Codebase practices (${PRACTICES:-check folder})
-
-## Active Epics
-${EPICS:-Check docs/05-epics/ for epic files}
-
-## Key Conventions (from CLAUDE.md)
-$(grep -A 15 "## Key\|## Critical\|## Important\|CRITICAL:" CLAUDE.md 2>/dev/null | head -20 || echo "- Read CLAUDE.md for project conventions")
-
-## Recent Agent Activity
-$(tail -3 docs/09-agents/bus/log.jsonl 2>/dev/null | head -3 || echo "")
-EOF
-
-# Output active command summaries
-if [ ! -z "$COMMAND_SUMMARIES" ]; then
-  echo "$COMMAND_SUMMARIES"
-fi
-
-cat << EOF
-
-## Post-Compact Actions
-1. Re-read CLAUDE.md if unsure about conventions
-2. Check status.json for current story state
-3. Review docs/02-practices/ for implementation patterns
-4. Check git log for recent changes
-EOF

package/src/core/templates/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/src/core/templates/validate-tokens.sh

@@ -1,73 +0,0 @@
-#!/bin/bash
-
-# AgileFlow Token Validation Script
-# Safely checks if required MCP tokens are present in .env WITHOUT exposing them
-# Security-first approach: shows token lengths, never displays actual values
-
-echo "🔐 Token Validation (Secure Check - No Tokens Exposed)"
-echo "========================================================="
-echo ""
-
-# Check if .env exists
-if [ ! -f .env ]; then
-  echo "❌ .env file NOT found"
-  echo ""
-  echo "To create .env, copy from template:"
-  echo "  cp .env.example .env"
-  echo "Then edit .env and add your real tokens (DO NOT COMMIT)"
-  exit 1
-fi
-
-echo "✅ .env file found"
-echo ""
-
-# Check GitHub token (secure - doesn't print value)
-if grep -q "^GITHUB_PERSONAL_ACCESS_TOKEN=" .env && ! grep -q "GITHUB_PERSONAL_ACCESS_TOKEN=$" .env; then
-  TOKEN_VALUE=$(grep "^GITHUB_PERSONAL_ACCESS_TOKEN=" .env | cut -d'=' -f2)
-  if [ -z "$TOKEN_VALUE" ] || [ "$TOKEN_VALUE" = "your_token_here" ] || [ "$TOKEN_VALUE" = "ghp_placeholder" ]; then
-    echo "⚠️  GITHUB_PERSONAL_ACCESS_TOKEN is set but appears to be placeholder"
-    echo "    → Replace with real token (starts with ghp_)"
-  else
-    echo "✅ GITHUB_PERSONAL_ACCESS_TOKEN is set (length: ${#TOKEN_VALUE})"
-  fi
-else
-  echo "⚠️  GITHUB_PERSONAL_ACCESS_TOKEN not found in .env"
-fi
-
-echo ""
-
-# Check Notion token (secure - doesn't print value)
-if grep -q "^NOTION_TOKEN=" .env && ! grep -q "NOTION_TOKEN=$" .env; then
-  TOKEN_VALUE=$(grep "^NOTION_TOKEN=" .env | cut -d'=' -f2)
-  if [ -z "$TOKEN_VALUE" ] || [ "$TOKEN_VALUE" = "your_token_here" ] || [[ "$TOKEN_VALUE" == *"placeholder"* ]]; then
-    echo "⚠️  NOTION_TOKEN is set but appears to be placeholder"
-    echo "    → Replace with real token (starts with ntn_ or secret_)"
-  else
-    echo "✅ NOTION_TOKEN is set (length: ${#TOKEN_VALUE})"
-  fi
-else
-  echo "ℹ️  NOTION_TOKEN not found in .env (optional if Notion not enabled)"
-fi
-
-echo ""
-echo "🔒 Security Check:"
-
-# Check .gitignore for .mcp.json
-if grep -q '^\\.mcp\\.json$' .gitignore 2>/dev/null; then
-  echo "✅ .mcp.json is in .gitignore"
-else
-  echo "❌ .mcp.json NOT in .gitignore (CRITICAL - must exclude!)"
-fi
-
-# Check .gitignore for .env
-if grep -q '^\\.env$' .gitignore 2>/dev/null; then
-  echo "✅ .env is in .gitignore"
-else
-  echo "❌ .env NOT in .gitignore (CRITICAL - must exclude!)"
-fi
-
-echo ""
-echo "If you added new tokens to .env, remember to:"
-echo "  1. Verify .mcp.json and .env are in .gitignore (NEVER commit them!)"
-echo "  2. 🔴 RESTART Claude Code for MCP servers to load new tokens"
-echo "  3. Test MCP commands after restart"

package/src/core/templates/worktree-create.sh

@@ -1,111 +0,0 @@
-#!/bin/bash
-# AgileFlow Worktree Helper Script
-# Creates a git worktree with proper naming and guidance
-
-set -e  # Exit on error
-
-# Color codes for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Check if running in a git repository
-if ! git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
-    echo -e "${RED}Error: Not in a git repository${NC}"
-    exit 1
-fi
-
-# Check for feature name argument
-if [ $# -eq 0 ]; then
-    echo -e "${RED}Error: Feature name required${NC}"
-    echo ""
-    echo "Usage: $0 <feature-name> [base-branch]"
-    echo ""
-    echo "Examples:"
-    echo "  $0 authentication"
-    echo "  $0 payment-integration"
-    echo "  $0 hotfix-memory-leak main"
-    echo "  $0 experiment-graphql develop"
-    echo ""
-    exit 1
-fi
-
-FEATURE_NAME=$1
-BASE_BRANCH=${2:-main}
-BRANCH_NAME="feature/$FEATURE_NAME"
-REPO_NAME=$(basename "$(git rev-parse --show-toplevel)")
-WORKTREE_PATH="../${REPO_NAME}-${FEATURE_NAME}"
-
-# Check if base branch exists
-if ! git rev-parse --verify "$BASE_BRANCH" > /dev/null 2>&1; then
-    echo -e "${RED}Error: Base branch '$BASE_BRANCH' does not exist${NC}"
-    echo ""
-    echo "Available branches:"
-    git branch -a
-    exit 1
-fi
-
-# Check if worktree path already exists
-if [ -d "$WORKTREE_PATH" ]; then
-    echo -e "${RED}Error: Directory already exists: $WORKTREE_PATH${NC}"
-    echo ""
-    echo "Options:"
-    echo "  1. Remove existing directory: rm -rf $WORKTREE_PATH"
-    echo "  2. Use different feature name"
-    echo "  3. List existing worktrees: git worktree list"
-    exit 1
-fi
-
-# Check if branch already exists
-if git rev-parse --verify "$BRANCH_NAME" > /dev/null 2>&1; then
-    echo -e "${YELLOW}Warning: Branch '$BRANCH_NAME' already exists${NC}"
-    echo "Creating worktree from existing branch..."
-    git worktree add "$WORKTREE_PATH" "$BRANCH_NAME"
-else
-    echo -e "${BLUE}Creating new branch '$BRANCH_NAME' from '$BASE_BRANCH'${NC}"
-    git worktree add -b "$BRANCH_NAME" "$WORKTREE_PATH" "$BASE_BRANCH"
-fi
-
-echo ""
-echo -e "${GREEN}✅ Worktree created successfully!${NC}"
-echo ""
-echo -e "${BLUE}📂 Location:${NC} $WORKTREE_PATH"
-echo -e "${BLUE}🌿 Branch:${NC} $BRANCH_NAME"
-echo -e "${BLUE}📌 Base:${NC} $BASE_BRANCH"
-echo ""
-echo -e "${GREEN}🤖 Next steps:${NC}"
-echo "   1. Open in new editor window:"
-echo -e "      ${YELLOW}code $WORKTREE_PATH${NC}"
-echo ""
-echo "   2. Navigate to worktree:"
-echo -e "      ${YELLOW}cd $WORKTREE_PATH${NC}"
-echo ""
-echo "   3. Start AgileFlow babysit:"
-echo -e "      ${YELLOW}/babysit${NC}"
-echo ""
-echo -e "${YELLOW}⚠️  Important Reminders:${NC}"
-echo "   • Use this worktree for '$FEATURE_NAME' work only"
-echo "   • Avoid concurrent edits to the same epic/stories across worktrees"
-echo "   • Clean up when done: git worktree remove $WORKTREE_PATH"
-echo ""
-echo -e "${BLUE}📚 Documentation:${NC} docs/guides/worktrees.md"
-echo ""
-echo -e "${GREEN}Shared across worktrees:${NC}"
-echo "   • Git history (commits, branches)"
-echo "   • AgileFlow status.json and message bus"
-echo "   • All docs/ files (ADRs, epics, stories)"
-echo ""
-echo -e "${BLUE}Independent in this worktree:${NC}"
-echo "   • Working directory files (src/, etc.)"
-echo "   • Dependencies (node_modules/, .venv/, etc.)"
-echo "   • /babysit AI context"
-echo ""
-
-# List all worktrees
-echo -e "${BLUE}📋 All active worktrees:${NC}"
-git worktree list
-echo ""
-
-echo -e "${GREEN}Happy coding with preserved context! 🚀${NC}"