agileflow 3.4.3 → 4.0.0-alpha.1

package/scripts/lib/json-utils.sh

@@ -1,162 +0,0 @@
-#!/bin/bash
-# AgileFlow JSON Utilities - Bash Edition
-#
-# Source this file: source "$(dirname "${BASH_SOURCE[0]}")/lib/json-utils.sh"
-#
-# Provides safe JSON parsing functions with error handling.
-
-# Source colors from canonical source if not already loaded
-UTILS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-if [[ -z "$RESET" ]] && [[ -f "$UTILS_DIR/colors.sh" ]]; then
-  source "$UTILS_DIR/colors.sh"
-fi
-
-# ============================================================================
-# Safe JSON Parsing
-# ============================================================================
-
-# safeJsonParse - Parse JSON file safely with validation
-# Returns the extracted value or a default if parsing fails.
-# Logs errors to stderr but doesn't crash the script.
-#
-# Usage:
-#   value=$(safeJsonParse "/path/to/file.json" ".key.path" "default_value")
-#   value=$(safeJsonParse "$FILE" ".archival.enabled" "true")
-#
-# Arguments:
-#   $1 - File path to parse
-#   $2 - jq query path (e.g., ".key.subkey")
-#   $3 - Default value if parse fails (required for safety)
-#
-safeJsonParse() {
-  local file="$1"
-  local query="$2"
-  local default="$3"
-
-  # Validate arguments
-  if [[ -z "$file" ]] || [[ -z "$query" ]]; then
-    echo "$default"
-    return 0
-  fi
-
-  # Check file exists
-  if [[ ! -f "$file" ]]; then
-    echo "$default"
-    return 0
-  fi
-
-  # Check file is readable
-  if [[ ! -r "$file" ]]; then
-    echo -e "\033[0;31m[json-utils] Cannot read file: $file\033[0m" >&2
-    echo "$default"
-    return 0
-  fi
-
-  # Try jq first (preferred, more robust)
-  if command -v jq &> /dev/null; then
-    local result
-    result=$(jq -r "$query // empty" "$file" 2>/dev/null)
-    if [[ -n "$result" ]] && [[ "$result" != "null" ]]; then
-      echo "$result"
-      return 0
-    fi
-  fi
-
-  # Fallback to Node.js if jq unavailable or failed
-  if command -v node &> /dev/null; then
-    local result
-    # Security: Pass file path via environment variable
-    result=$(JSON_FILE="$file" JSON_QUERY="$query" node -pe "
-      try {
-        const fs = require('fs');
-        const content = fs.readFileSync(process.env.JSON_FILE, 'utf8');
-        const data = JSON.parse(content);
-        const keys = process.env.JSON_QUERY.replace(/^\\./, '').split('.');
-        let result = data;
-        for (const key of keys) {
-          if (result && typeof result === 'object' && key in result) {
-            result = result[key];
-          } else {
-            result = null;
-            break;
-          }
-        }
-        result !== null && result !== undefined ? String(result) : '';
-      } catch (e) {
-        '';
-      }
-    " 2>/dev/null)
-
-    if [[ -n "$result" ]]; then
-      echo "$result"
-      return 0
-    fi
-  fi
-
-  # If both methods fail, return default
-  echo "$default"
-  return 0
-}
-
-# safeJsonValidate - Check if file contains valid JSON
-# Returns 0 if valid, 1 if invalid
-#
-# Usage:
-#   if safeJsonValidate "/path/to/file.json"; then
-#     echo "Valid JSON"
-#   fi
-#
-safeJsonValidate() {
-  local file="$1"
-
-  if [[ ! -f "$file" ]] || [[ ! -r "$file" ]]; then
-    return 1
-  fi
-
-  # Try jq first
-  if command -v jq &> /dev/null; then
-    jq empty "$file" 2>/dev/null
-    return $?
-  fi
-
-  # Fallback to Node.js
-  if command -v node &> /dev/null; then
-    JSON_FILE="$file" node -e "
-      try {
-        const fs = require('fs');
-        JSON.parse(fs.readFileSync(process.env.JSON_FILE, 'utf8'));
-        process.exit(0);
-      } catch {
-        process.exit(1);
-      }
-    " 2>/dev/null
-    return $?
-  fi
-
-  # If neither tool available, assume invalid
-  return 1
-}
-
-# safeJsonRead - Read entire JSON file safely
-# Returns the JSON content or empty object if read fails
-#
-# Usage:
-#   content=$(safeJsonRead "/path/to/file.json")
-#
-safeJsonRead() {
-  local file="$1"
-
-  if [[ ! -f "$file" ]] || [[ ! -r "$file" ]]; then
-    echo "{}"
-    return 0
-  fi
-
-  # Validate JSON first
-  if ! safeJsonValidate "$file"; then
-    echo -e "\033[0;31m[json-utils] Invalid JSON in: $file\033[0m" >&2
-    echo "{}"
-    return 0
-  fi
-
-  cat "$file"
-}

package/scripts/lib/lifecycle-detector.js

@@ -1,125 +0,0 @@
-#!/usr/bin/env node
-/**
- * lifecycle-detector.js
- *
- * Determines the current workflow phase based on project signals.
- * Used by smart-detect.js to filter feature recommendations by phase.
- *
- * Phases (in order):
- *   pre-story      → No active story, selecting what to work on
- *   planning        → Story selected, planning implementation approach
- *   implementation  → Actively writing code, files changed
- *   post-impl       → Code done, reviewing/testing/documenting
- *   pre-pr          → Ready to create PR, final checks
- */
-
-'use strict';
-
-const PHASES = ['pre-story', 'planning', 'implementation', 'post-impl', 'pre-pr'];
-
-/**
- * Detect the current lifecycle phase from project signals.
- *
- * @param {Object} signals - Gathered project signals
- * @param {Object} signals.story - Current story info { id, status, owner }
- * @param {Object} signals.git - Git state { branch, filesChanged, isClean, onFeatureBranch }
- * @param {Object} signals.session - Session state { planModeActive, activeCommands }
- * @param {Object} signals.tests - Test state { passing, hasTestSetup }
- * @returns {{ phase: string, confidence: number, reason: string }}
- */
-function detectLifecyclePhase(signals = {}) {
-  const { story: rawStory, git: rawGit, session: rawSession, tests: rawTests } = signals;
-  const story = rawStory || {};
-  const git = rawGit || {};
-  const session = rawSession || {};
-  const tests = rawTests || {};
-
-  // Phase 5: pre-pr
-  // Story in-progress, tests passing, git clean (or nearly), on feature branch
-  if (
-    story.status === 'in-progress' &&
-    tests.passing === true &&
-    git.isClean &&
-    git.onFeatureBranch
-  ) {
-    return {
-      phase: 'pre-pr',
-      confidence: 0.9,
-      reason: 'Tests passing, clean git, on feature branch',
-    };
-  }
-
-  // Phase 4: post-impl
-  // Story in-progress, tests passing (or test files exist), still has some changes
-  if (story.status === 'in-progress' && tests.passing === true && git.filesChanged > 0) {
-    return {
-      phase: 'post-impl',
-      confidence: 0.8,
-      reason: 'Tests passing but uncommitted changes remain',
-    };
-  }
-
-  // Phase 3: implementation
-  // Story in-progress AND files changed (git status non-empty)
-  if (story.status === 'in-progress' && git.filesChanged > 0) {
-    return {
-      phase: 'implementation',
-      confidence: 0.85,
-      reason: `Actively coding (${git.filesChanged} files changed)`,
-    };
-  }
-
-  // Phase 2: planning
-  // Story selected/in-progress but no files changed yet, OR plan mode active
-  if (session.planModeActive) {
-    return {
-      phase: 'planning',
-      confidence: 0.9,
-      reason: 'Plan mode is active',
-    };
-  }
-
-  if (story.status === 'in-progress' && (git.filesChanged || 0) === 0) {
-    return {
-      phase: 'planning',
-      confidence: 0.7,
-      reason: 'Story in-progress but no files changed yet',
-    };
-  }
-
-  // Phase 1: pre-story (default)
-  // No current story OR story is ready (not yet started)
-  return {
-    phase: 'pre-story',
-    confidence: story.id ? 0.6 : 0.9,
-    reason: story.id
-      ? `Story ${story.id} not yet started (status: ${story.status || 'unknown'})`
-      : 'No active story',
-  };
-}
-
-/**
- * Get features relevant to a given phase.
- * Returns the set of feature categories that apply.
- *
- * @param {string} phase - Lifecycle phase name
- * @returns {string[]} Array of phase names whose features are relevant
- */
-function getRelevantPhases(phase) {
-  // Each phase also includes adjacent phase features (for smooth transitions)
-  const phaseMap = {
-    'pre-story': ['pre-story'],
-    planning: ['pre-story', 'planning'],
-    implementation: ['planning', 'implementation'],
-    'post-impl': ['implementation', 'post-impl'],
-    'pre-pr': ['post-impl', 'pre-pr'],
-  };
-
-  return phaseMap[phase] || ['pre-story'];
-}
-
-module.exports = {
-  PHASES,
-  detectLifecyclePhase,
-  getRelevantPhases,
-};

package/scripts/lib/model-profiles.js

@@ -1,118 +0,0 @@
-/**
- * model-profiles.js - Model resolution for audit subagents
- *
- * Resolves which model (haiku/sonnet/opus) to use for agent subagents.
- * Models are specified inline via command arguments (MODEL=opus).
- *
- * Resolution order:
- *   1. Explicit MODEL= argument (highest priority)
- *   2. Agent frontmatter model (from .md file)
- *   3. Fallback: 'haiku'
- *
- * Usage:
- *   const { resolveModel, estimateCost } = require('./model-profiles');
- *   const model = resolveModel('opus', 'haiku');  // returns 'opus'
- *   const model2 = resolveModel(null, 'sonnet');  // returns 'sonnet'
- *   const model3 = resolveModel(null, null);       // returns 'haiku'
- */
-
-const VALID_MODELS = ['haiku', 'sonnet', 'opus'];
-
-/**
- * Resolve which model to use for a given agent.
- *
- * Resolution order:
- *   1. Explicit model argument (MODEL= from command)
- *   2. Agent frontmatter model
- *   3. Fallback: 'haiku'
- *
- * @param {string} [explicitModel] - MODEL= argument value
- * @param {string} [frontmatterModel] - Model from agent .md frontmatter
- * @returns {string} Model name: 'haiku', 'sonnet', or 'opus'
- */
-function resolveModel(explicitModel, frontmatterModel) {
-  // 1. Explicit MODEL= argument
-  if (explicitModel && VALID_MODELS.includes(explicitModel.toLowerCase())) {
-    return explicitModel.toLowerCase();
-  }
-
-  // 2. Frontmatter model
-  if (frontmatterModel && VALID_MODELS.includes(frontmatterModel.toLowerCase())) {
-    return frontmatterModel.toLowerCase();
-  }
-
-  // 3. Fallback
-  return 'haiku';
-}
-
-/**
- * Validate a model name.
- *
- * @param {string} model - Model name to validate
- * @returns {boolean} True if valid
- */
-function isValidModel(model) {
-  return !!model && VALID_MODELS.includes(model.toLowerCase());
-}
-
-/**
- * Estimate cost multiplier for a model relative to haiku baseline.
- *
- * @param {string} model - Model name
- * @param {number} [analyzerCount=5] - Number of analyzers
- * @param {number} [partitions=1] - Number of partitions (extreme mode)
- * @returns {{ multiplier: number, model: string, perAnalyzerCost: string, totalEstimate: string, partitions?: number, totalSessions?: number }}
- */
-function estimateCost(model, analyzerCount, partitions) {
-  let MODEL_PRICING;
-  try {
-    MODEL_PRICING = require('./team-events').MODEL_PRICING;
-  } catch (_) {
-    MODEL_PRICING = {
-      haiku: { input: 0.8, output: 4.0 },
-      sonnet: { input: 3.0, output: 15.0 },
-      opus: { input: 15.0, output: 75.0 },
-    };
-  }
-
-  const count = analyzerCount || 5;
-  const partCount = typeof partitions === 'number' && partitions > 1 ? partitions : 1;
-  const resolved = resolveModel(model);
-  const pricing = MODEL_PRICING[resolved] || MODEL_PRICING.haiku;
-  const haikuPricing = MODEL_PRICING.haiku;
-
-  const multiplier = pricing.output / haikuPricing.output;
-  const perAnalyzerCostNum =
-    (pricing.input * 50000) / 1_000_000 + (pricing.output * 10000) / 1_000_000;
-  const perAnalyzer = `$${perAnalyzerCostNum.toFixed(3)}`;
-
-  // For extreme mode: each partition has a coordinator + all analyzers as sub-agents
-  // Estimated cost per partition coordinator session in USD (~10k input + 2k output at haiku rates)
-  const coordinatorCostUSD = 0.05;
-  const totalSessions = partCount * count;
-  const totalCost =
-    partCount > 1
-      ? partCount * coordinatorCostUSD + totalSessions * perAnalyzerCostNum
-      : count * perAnalyzerCostNum;
-
-  const result = {
-    multiplier: Math.round(multiplier * 100) / 100,
-    model: resolved,
-    perAnalyzerCost: perAnalyzer,
-    totalEstimate: `~$${totalCost.toFixed(2)}`,
-  };
-
-  if (partCount > 1) {
-    result.partitions = partCount;
-    result.totalSessions = totalSessions;
-  }
-
-  return result;
-}
-
-module.exports = {
-  VALID_MODELS,
-  resolveModel,
-  isValidModel,
-  estimateCost,
-};

package/scripts/lib/portable-tasks-cli.js

@@ -1,274 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * portable-tasks-cli.js - CLI wrapper for portable task tracking
- *
- * Usage:
- *   node portable-tasks-cli.js list [--status=pending] [--owner=AG-API] [--json]
- *   node portable-tasks-cli.js add --subject="..." [--description="..."] [--owner=...] [--status=pending]
- *   node portable-tasks-cli.js update T-001 --status=completed
- *   node portable-tasks-cli.js get T-001
- *   node portable-tasks-cli.js delete T-001
- *
- * Exit codes:
- *   0 = Success
- *   1 = Error
- */
-
-const path = require('path');
-const {
-  loadTasks,
-  addTask,
-  updateTask,
-  deleteTask,
-  getTask,
-  listTasks,
-} = require('./portable-tasks');
-
-// Get project directory (current working directory)
-const projectDir = process.cwd();
-
-/**
- * Parse command-line arguments into command and options
- * @returns {Object} { command, taskId, options }
- */
-function parseArgs() {
-  const args = process.argv.slice(2);
-  if (args.length === 0) {
-    return { command: 'help' };
-  }
-
-  const command = args[0];
-  const taskId = args[1] && !args[1].startsWith('--') ? args[1] : null;
-
-  const options = {};
-  for (let i = taskId ? 2 : 1; i < args.length; i++) {
-    const arg = args[i];
-    if (arg.startsWith('--')) {
-      const eqIndex = arg.indexOf('=');
-      const key = eqIndex === -1 ? arg.substring(2) : arg.substring(2, eqIndex);
-      const value = eqIndex === -1 ? undefined : arg.substring(eqIndex + 1);
-      options[key] = value === undefined ? true : value;
-    }
-  }
-
-  return { command, taskId, options };
-}
-
-/**
- * Format task for human-readable output
- */
-function formatTaskHuman(task) {
-  let output = `${task.id} [${task.status}] ${task.title}`;
-  if (task.owner) output += ` (${task.owner})`;
-  if (task.blockedBy) output += ` [blocked by ${task.blockedBy}]`;
-  return output;
-}
-
-/**
- * Run a command
- */
-function run() {
-  const { command, taskId, options } = parseArgs();
-
-  switch (command) {
-    case 'list':
-    case 'ls': {
-      const tasks = listTasks(projectDir, {
-        status: options.status,
-        owner: options.owner,
-        includeCompleted:
-          options['include-completed'] === true || options['include-completed'] === 'true',
-      });
-
-      if (options.json) {
-        console.log(JSON.stringify(tasks, null, 2));
-      } else {
-        if (tasks.length === 0) {
-          console.log('No tasks found');
-        } else {
-          tasks.forEach(task => console.log(formatTaskHuman(task)));
-        }
-      }
-      process.exit(0);
-      break;
-    }
-
-    case 'add': {
-      if (!options.subject) {
-        console.error('[ERROR] --subject is required');
-        process.exit(1);
-      }
-
-      const result = addTask(projectDir, {
-        subject: options.subject,
-        description: options.description,
-        owner: options.owner,
-        status: options.status || 'pending',
-        story: options.story,
-        blockedBy: options['blocked-by'],
-      });
-
-      if (result.ok) {
-        console.log(`Created: ${result.taskId}`);
-        process.exit(0);
-      } else {
-        console.error(`[ERROR] ${result.error}`);
-        process.exit(1);
-      }
-      break;
-    }
-
-    case 'update': {
-      if (!taskId) {
-        console.error('[ERROR] Task ID is required (e.g., T-001)');
-        process.exit(1);
-      }
-
-      const task = getTask(projectDir, taskId);
-      if (!task) {
-        console.error(`[ERROR] Task ${taskId} not found`);
-        process.exit(1);
-      }
-
-      const updates = {};
-      if (options.status && typeof options.status === 'string') updates.status = options.status;
-      if (options.description !== undefined && typeof options.description === 'string')
-        updates.description = options.description;
-      if (options.owner !== undefined && typeof options.owner === 'string')
-        updates.owner = options.owner;
-      if (options.title !== undefined && typeof options.title === 'string')
-        updates.title = options.title;
-      if (options.story !== undefined && typeof options.story === 'string')
-        updates.story = options.story;
-      if (options['blocked-by'] !== undefined && typeof options['blocked-by'] === 'string')
-        updates.blockedBy = options['blocked-by'];
-
-      if (Object.keys(updates).length === 0) {
-        console.error('[ERROR] No updates specified');
-        process.exit(1);
-      }
-
-      const result = updateTask(projectDir, taskId, updates);
-      if (result.ok) {
-        console.log(`Updated: ${taskId}`);
-        process.exit(0);
-      } else {
-        console.error(`[ERROR] ${result.error}`);
-        process.exit(1);
-      }
-      break;
-    }
-
-    case 'get': {
-      if (!taskId) {
-        console.error('[ERROR] Task ID is required (e.g., T-001)');
-        process.exit(1);
-      }
-
-      const task = getTask(projectDir, taskId);
-      if (!task) {
-        console.error(`[ERROR] Task ${taskId} not found`);
-        process.exit(1);
-      }
-
-      if (options.json) {
-        console.log(JSON.stringify(task, null, 2));
-      } else {
-        console.log(formatTaskHuman(task));
-        if (task.description) console.log(`  Description: ${task.description}`);
-        if (task.story) console.log(`  Story: ${task.story}`);
-        if (task.created) console.log(`  Created: ${task.created}`);
-        if (task.completed) console.log(`  Completed: ${task.completed}`);
-      }
-      process.exit(0);
-      break;
-    }
-
-    case 'delete':
-    case 'rm': {
-      if (!taskId) {
-        console.error('[ERROR] Task ID is required (e.g., T-001)');
-        process.exit(1);
-      }
-
-      const task = getTask(projectDir, taskId);
-      if (!task) {
-        console.error(`[ERROR] Task ${taskId} not found`);
-        process.exit(1);
-      }
-
-      const result = deleteTask(projectDir, taskId);
-      if (result.ok) {
-        console.log(`Deleted: ${taskId}`);
-        process.exit(0);
-      } else {
-        console.error(`[ERROR] ${result.error}`);
-        process.exit(1);
-      }
-      break;
-    }
-
-    case 'help':
-    case '-h':
-    case '--help': {
-      console.log(`
-Portable Task Tracking - File-based task management for all IDEs
-
-Usage:
-  portable-tasks-cli.js list [OPTIONS]
-  portable-tasks-cli.js add --subject="..." [OPTIONS]
-  portable-tasks-cli.js update <TASK_ID> --status=... [OPTIONS]
-  portable-tasks-cli.js get <TASK_ID>
-  portable-tasks-cli.js delete <TASK_ID>
-
-Commands:
-  list (ls)       List tasks (default: active only)
-  add             Create a new task
-  update          Update an existing task
-  get             Show task details
-  delete (rm)     Delete a task
-  help            Show this message
-
-List Options:
-  --status=<status>              Filter by status (pending, in_progress, completed, blocked)
-  --owner=<owner>                Filter by owner (e.g., AG-API, AG-UI)
-  --include-completed            Include completed tasks (default: false)
-  --json                         Output as JSON
-
-Add Options:
-  --subject=<text>               Task title (required)
-  --description=<text>           Task description
-  --owner=<owner>                Task owner (e.g., AG-API)
-  --status=<status>              Initial status (default: pending)
-  --story=<story-id>             Link to story (e.g., US-0040)
-  --blocked-by=<task-id>         Block this task (e.g., T-001)
-
-Update Options:
-  --status=<status>              New status
-  --description=<text>           New description
-  --owner=<owner>                New owner
-  --title=<text>                 New title
-  --story=<story-id>             Update story link
-  --blocked-by=<task-id>         Update blocker
-
-Examples:
-  node portable-tasks-cli.js list
-  node portable-tasks-cli.js list --status=pending --owner=AG-API
-  node portable-tasks-cli.js add --subject="Write tests" --owner=AG-CI
-  node portable-tasks-cli.js update T-001 --status=completed
-  node portable-tasks-cli.js get T-001 --json
-      `);
-      process.exit(0);
-      break;
-    }
-
-    default: {
-      console.error(`[ERROR] Unknown command: ${command}`);
-      console.log('Run with --help for usage');
-      process.exit(1);
-    }
-  }
-}
-
-run();