agileflow 2.71.0 → 2.72.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agileflow",
-  "version": "2.71.0",
+  "version": "2.72.0",
   "description": "AI-driven agile development system for Claude Code, Cursor, Windsurf, and more",
   "keywords": [
     "agile",

package/scripts/init.sh

@@ -0,0 +1,76 @@
+#!/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/scripts/resume-session.sh

@@ -0,0 +1,121 @@
+#!/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/validate-tokens.sh

@@ -0,0 +1,73 @@
+#!/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/scripts/worktree-create.sh

@@ -0,0 +1,111 @@
+#!/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}"