specweave 1.0.71 → 1.0.72

package/plugins/specweave/hooks/v2/session-end.sh

@@ -7,9 +7,51 @@
 #
 # v0.35.3 - Fixed: use set +e for hook safety
 # v0.35.x - Fixed: Don't create .specweave in non-project directories
+# v1.0.71 - Fixed: Use specweave package location, not PROJECT_ROOT/dist
 
 set +e  # CRITICAL: Never use set -e in hooks (causes cascading failures)
 
+# =============================================================================
+# CRITICAL FIX: Resolve specweave package location for CLI scripts
+# =============================================================================
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+resolve_specweave_package() {
+  local hook_dir="$1"
+
+  # From hooks/v2/ go up 4 levels to package root
+  local package_root="$(cd "$hook_dir/../../../.." 2>/dev/null && pwd)"
+
+  if [[ -d "$package_root/dist/src/cli" ]]; then
+    echo "$package_root"
+    return 0
+  fi
+
+  # Fallback: Try global npm installation
+  local npm_root
+  npm_root="$(npm root -g 2>/dev/null)"
+  if [[ -d "$npm_root/specweave/dist/src/cli" ]]; then
+    echo "$npm_root/specweave"
+    return 0
+  fi
+
+  # Fallback: Try which specweave
+  local npx_path
+  npx_path="$(which specweave 2>/dev/null)"
+  if [[ -n "$npx_path" ]]; then
+    local bin_dir="$(dirname "$npx_path")"
+    local pkg_dir="$(cd "$bin_dir/.." 2>/dev/null && pwd)"
+    if [[ -d "$pkg_dir/dist/src/cli" ]]; then
+      echo "$pkg_dir"
+      return 0
+    fi
+  fi
+
+  return 1
+}
+
+SPECWEAVE_PKG="$(resolve_specweave_package "$HOOK_DIR")"
+
 # Find project root by searching upward for .specweave/ directory
 find_specweave_root() {
   local dir="$1"
@@ -30,10 +72,16 @@ if [[ -z "$PROJECT_ROOT" ]]; then
   exit 0
 fi
 
+# If specweave package not found, exit gracefully
+if [[ -z "$SPECWEAVE_PKG" ]]; then
+  echo '{"continue": true}'
+  exit 0
+fi
+
 LOG_DIR="${PROJECT_ROOT}/.specweave/logs/sessions"
 
 # Find session by current PID
-SESSION_INFO=$(node "${PROJECT_ROOT}/dist/src/cli/find-session-by-pid.js" $$ 2>/dev/null || echo "")
+SESSION_INFO=$(node "${SPECWEAVE_PKG}/dist/src/cli/find-session-by-pid.js" $$ 2>/dev/null || echo "")
 
 if [ -z "$SESSION_INFO" ]; then
   # No session found, exit gracefully
@@ -73,7 +121,7 @@ log() {
   fi
 
   # Remove session from registry
-  if node "${PROJECT_ROOT}/dist/src/cli/remove-session.js" "$SESSION_ID" >> "$LOG_FILE" 2>&1; then
+  if node "${SPECWEAVE_PKG}/dist/src/cli/remove-session.js" "$SESSION_ID" >> "$LOG_FILE" 2>&1; then
     log "Session removed from registry: $SESSION_ID"
   else
     log "WARNING: Failed to remove session from registry"

package/plugins/specweave/hooks/v2/session-start.sh

@@ -7,9 +7,64 @@
 #
 # v0.35.3 - Fixed: use set +e for hook safety
 # v0.35.x - Fixed: Don't create .specweave in non-project directories
+# v1.0.71 - Fixed: Use specweave package location, not PROJECT_ROOT/dist
 
 set +e  # CRITICAL: Never use set -e in hooks (causes cascading failures)
 
+# =============================================================================
+# CRITICAL FIX: Resolve specweave package location for CLI scripts
+# =============================================================================
+# Problem: Hooks referenced ${PROJECT_ROOT}/dist/src/cli/*.js which doesn't
+# exist on user machines - they only have npm-installed specweave package.
+#
+# Solution: Find the specweave package via:
+# 1. This hook's own location (hooks are inside the package)
+# 2. Global npm root as fallback
+# =============================================================================
+
+# Get the directory where this hook script lives
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Resolve specweave package root (hooks are at plugins/specweave/hooks/v2/)
+# Walk up: v2 -> hooks -> specweave -> plugins -> package_root
+resolve_specweave_package() {
+  local hook_dir="$1"
+
+  # From hooks/v2/ go up 4 levels to package root
+  local package_root="$(cd "$hook_dir/../../../.." 2>/dev/null && pwd)"
+
+  # Verify it's a valid specweave package (has dist/src/cli/)
+  if [[ -d "$package_root/dist/src/cli" ]]; then
+    echo "$package_root"
+    return 0
+  fi
+
+  # Fallback: Try global npm installation
+  local npm_root
+  npm_root="$(npm root -g 2>/dev/null)"
+  if [[ -d "$npm_root/specweave/dist/src/cli" ]]; then
+    echo "$npm_root/specweave"
+    return 0
+  fi
+
+  # Fallback: Try npx resolution
+  local npx_path
+  npx_path="$(which specweave 2>/dev/null)"
+  if [[ -n "$npx_path" ]]; then
+    # specweave binary is at package/bin/specweave.js, go up one level
+    local bin_dir="$(dirname "$npx_path")"
+    local pkg_dir="$(cd "$bin_dir/.." 2>/dev/null && pwd)"
+    if [[ -d "$pkg_dir/dist/src/cli" ]]; then
+      echo "$pkg_dir"
+      return 0
+    fi
+  fi
+
+  return 1
+}
+
+SPECWEAVE_PKG="$(resolve_specweave_package "$HOOK_DIR")"
+
 # Find project root by searching upward for .specweave/ directory
 find_specweave_root() {
   local dir="$1"
@@ -53,13 +108,21 @@ is_ci_mode() {
 # Main execution
 {
   log "SessionStart hook triggered (PID: $$)"
+  log "SPECWEAVE_PKG resolved to: ${SPECWEAVE_PKG:-NOT_FOUND}"
+
+  # If specweave package not found, skip session tracking (non-fatal)
+  if [[ -z "$SPECWEAVE_PKG" ]]; then
+    log "WARNING: Could not resolve specweave package location - skipping session tracking"
+    echo '{"continue": true}'
+    exit 0
+  fi
 
   # Check if CI mode
   if is_ci_mode; then
     log "CI/non-interactive mode detected - using simplified tracking"
 
     # Register session but skip background processes
-    if node "${PROJECT_ROOT}/dist/src/cli/register-session.js" "$SESSION_ID" $$ "claude-code" >> "$LOG_FILE" 2>&1; then
+    if node "${SPECWEAVE_PKG}/dist/src/cli/register-session.js" "$SESSION_ID" $$ "claude-code" >> "$LOG_FILE" 2>&1; then
       log "Session registered (CI mode): $SESSION_ID"
     else
       log "WARNING: Failed to register session (non-fatal)"
@@ -74,14 +137,15 @@ is_ci_mode() {
   log "Interactive mode detected - full session tracking enabled"
 
   # Register session in registry
-  if node "${PROJECT_ROOT}/dist/src/cli/register-session.js" "$SESSION_ID" $$ "claude-code" >> "$LOG_FILE" 2>&1; then
+  if node "${SPECWEAVE_PKG}/dist/src/cli/register-session.js" "$SESSION_ID" $$ "claude-code" >> "$LOG_FILE" 2>&1; then
     log "Session registered: $SESSION_ID"
   else
     log "WARNING: Failed to register session (non-fatal)"
   fi
 
   # Start heartbeat process in background (detached)
-  nohup bash "${PROJECT_ROOT}/plugins/specweave/scripts/heartbeat.sh" "$SESSION_ID" \
+  # Use SPECWEAVE_PKG for the heartbeat script location
+  nohup bash "${SPECWEAVE_PKG}/plugins/specweave/scripts/heartbeat.sh" "$SESSION_ID" \
     > "${PROJECT_ROOT}/.specweave/logs/heartbeat-${SESSION_ID}.log" 2>&1 &
 
   HEARTBEAT_PID=$!
@@ -89,7 +153,7 @@ is_ci_mode() {
 
   # Add heartbeat PID to session's child PIDs
   if [ -n "$HEARTBEAT_PID" ]; then
-    node "${PROJECT_ROOT}/dist/src/cli/add-child-pid.js" "$SESSION_ID" "$HEARTBEAT_PID" >> "$LOG_FILE" 2>&1 || true
+    node "${SPECWEAVE_PKG}/dist/src/cli/add-child-pid.js" "$SESSION_ID" "$HEARTBEAT_PID" >> "$LOG_FILE" 2>&1 || true
   fi
 
   log "SessionStart hook completed successfully"

package/plugins/specweave/scripts/chunk-prompt.js

@@ -0,0 +1,204 @@
+#!/usr/bin/env node
+/**
+ * Prompt Chunking for Auto Mode
+ *
+ * Analyzes a prompt and generates an increment plan for user approval.
+ *
+ * Usage: node chunk-prompt.js "prompt text" [options]
+ *
+ * Options:
+ *   --yes           Auto-approve plan (skip user approval)
+ *   --json          Output as JSON
+ *   --project-path  Project root path (default: cwd)
+ *
+ * Exit codes:
+ *   0: Success - plan saved to state
+ *   1: Error
+ *   2: Cancelled by user
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// Resolve project root (look for .specweave directory)
+function findProjectRoot(startDir) {
+  let dir = startDir;
+  while (dir !== '/') {
+    if (fs.existsSync(path.join(dir, '.specweave'))) {
+      return dir;
+    }
+    dir = path.dirname(dir);
+  }
+  return startDir;
+}
+
+// Dynamic import of built modules
+async function loadModules(projectPath) {
+  // Try multiple paths for the built modules
+  const possiblePaths = [
+    path.join(projectPath, 'dist/src/core/auto/prompt-chunker.js'),
+    path.join(projectPath, 'node_modules/specweave/dist/src/core/auto/prompt-chunker.js'),
+    // For development
+    path.join(path.dirname(fileURLToPath(import.meta.url)), '../../../dist/src/core/auto/prompt-chunker.js'),
+  ];
+
+  for (const p of possiblePaths) {
+    if (fs.existsSync(p)) {
+      const chunker = await import(p);
+      const plannerPath = p.replace('prompt-chunker', 'increment-planner');
+      const approvalPath = p.replace('prompt-chunker', 'plan-approval');
+      const planner = await import(plannerPath);
+      const approval = await import(approvalPath);
+      return { chunker, planner, approval };
+    }
+  }
+
+  throw new Error('Could not find built modules. Run `npm run build` first.');
+}
+
+// Parse arguments
+const args = process.argv.slice(2);
+let prompt = '';
+let autoApprove = false;
+let jsonOutput = false;
+let projectPath = process.cwd();
+
+for (let i = 0; i < args.length; i++) {
+  const arg = args[i];
+  if (arg === '--yes' || arg === '-y') {
+    autoApprove = true;
+  } else if (arg === '--json') {
+    jsonOutput = true;
+  } else if (arg === '--project-path') {
+    projectPath = args[++i];
+  } else if (arg === '--help' || arg === '-h') {
+    console.log(`
+Prompt Chunking for Auto Mode
+
+Usage: node chunk-prompt.js "prompt text" [options]
+
+Options:
+  --yes, -y       Auto-approve plan (skip user approval)
+  --json          Output as JSON
+  --project-path  Project root path (default: cwd)
+  --help, -h      Show this help
+
+Examples:
+  node chunk-prompt.js "Build e-commerce with auth, products, cart, checkout"
+  node chunk-prompt.js "Build dashboard" --yes
+`);
+    process.exit(0);
+  } else if (!arg.startsWith('-')) {
+    prompt = arg;
+  }
+}
+
+if (!prompt) {
+  console.error('Error: No prompt provided');
+  console.error('Usage: node chunk-prompt.js "prompt text"');
+  process.exit(1);
+}
+
+// Find project root
+projectPath = findProjectRoot(projectPath);
+
+async function main() {
+  try {
+    const { chunker, planner, approval } = await loadModules(projectPath);
+
+    // Analyze prompt
+    const analysis = chunker.analyzePrompt(prompt);
+
+    if (analysis.features.length === 0) {
+      console.error('No features detected in prompt. Please provide a more detailed description.');
+      process.exit(1);
+    }
+
+    // Plan increments
+    const plan = planner.planIncrements(analysis.features);
+
+    // Validate plan
+    const validation = approval.validatePlan(plan);
+    if (!validation.valid) {
+      console.error('Plan validation failed:');
+      for (const issue of validation.issues) {
+        console.error(`  - ${issue}`);
+      }
+      process.exit(1);
+    }
+
+    // Display warnings if any
+    const warnings = validation.issues.filter(i => i.startsWith('Warning:'));
+    if (warnings.length > 0 && !jsonOutput) {
+      console.log('\n⚠️  Warnings:');
+      for (const warning of warnings) {
+        console.log(`   ${warning}`);
+      }
+    }
+
+    // Output plan
+    if (jsonOutput) {
+      console.log(JSON.stringify({
+        prompt,
+        analysis: {
+          totalFeatures: analysis.totalFeatures,
+          totalComplexity: analysis.totalComplexity,
+          recommendedIncrements: analysis.recommendedIncrements,
+        },
+        plan: {
+          increments: plan.increments.map(inc => ({
+            id: inc.id,
+            name: inc.name,
+            estimatedTasks: inc.estimatedTasks,
+            features: inc.features.map(f => f.name),
+            dependencies: inc.dependencies,
+          })),
+          totalTasks: plan.totalTasks,
+          estimatedDuration: plan.estimatedDuration,
+        },
+        autoApprove,
+      }, null, 2));
+    } else {
+      // Display formatted plan
+      console.log(approval.formatPlanDisplay(plan, {
+        showDetails: true,
+        showDependencies: true,
+        format: 'text',
+      }));
+
+      // Show approval prompt
+      if (!autoApprove) {
+        console.log(approval.generateApprovalPrompt(plan));
+      }
+    }
+
+    // Save plan to state
+    approval.savePlanToState(plan, projectPath);
+
+    // Log approval if auto-approved
+    if (autoApprove) {
+      approval.logApprovedPlan(plan, projectPath);
+      console.log('\n✅ Plan auto-approved (--yes flag)');
+    }
+
+    // Output increment IDs for shell script consumption
+    if (!jsonOutput) {
+      console.log('\n📋 Generated Increment IDs:');
+      for (const inc of plan.increments) {
+        console.log(`  ${inc.id}`);
+      }
+    }
+
+    // Write increment IDs to a temp file for shell script to read
+    const idsFile = path.join(projectPath, '.specweave/state/chunked-increments.txt');
+    fs.writeFileSync(idsFile, plan.increments.map(i => i.id).join('\n'));
+
+    process.exit(0);
+  } catch (error) {
+    console.error('Error:', error.message);
+    process.exit(1);
+  }
+}
+
+main();

package/plugins/specweave/scripts/setup-auto.sh

@@ -13,6 +13,8 @@
 #   --skip-gates G1,G2   Pre-approve specific gates
 #   --no-increment       Skip auto-creation of increments (work on existing only)
 #   --no-inc             Alias for --no-increment (short form)
+#   --prompt "text"      Analyze prompt and create increments (intelligent chunking)
+#   --yes                Auto-approve increment plan (skip user approval)
 #   -h, --help           Show this help
 
 set -e
@@ -26,6 +28,8 @@ INCREMENT_IDS=()
 ALL_BACKLOG=false
 SKIP_GATES=""
 NO_INCREMENT=false
+PROMPT=""
+AUTO_APPROVE=false
 
 # Parse arguments
 while [[ $# -gt 0 ]]; do
@@ -62,6 +66,14 @@ while [[ $# -gt 0 ]]; do
             NO_INCREMENT=true
             shift
             ;;
+        --prompt)
+            PROMPT="$2"
+            shift 2
+            ;;
+        --yes|-y)
+            AUTO_APPROVE=true
+            shift
+            ;;
         -h|--help)
             grep '^#' "$0" | grep -v '!/bin/bash' | sed 's/^# //'
             exit 0
@@ -100,6 +112,60 @@ if [ -f "$SESSION_FILE" ]; then
     fi
 fi
 
+# Handle --prompt (intelligent chunking)
+if [ -n "$PROMPT" ]; then
+    echo "🧠 Analyzing prompt for intelligent chunking..."
+    echo ""
+
+    # Find the chunk-prompt.js script
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    CHUNK_SCRIPT="$SCRIPT_DIR/chunk-prompt.js"
+
+    if [ ! -f "$CHUNK_SCRIPT" ]; then
+        echo "❌ chunk-prompt.js not found at $CHUNK_SCRIPT"
+        exit 1
+    fi
+
+    # Run the chunking analysis
+    CHUNK_ARGS=("$PROMPT")
+    if [ "$AUTO_APPROVE" = "true" ]; then
+        CHUNK_ARGS+=("--yes")
+    fi
+    CHUNK_ARGS+=("--project-path" "$PROJECT_ROOT")
+
+    if ! node "$CHUNK_SCRIPT" "${CHUNK_ARGS[@]}"; then
+        echo "❌ Prompt chunking failed"
+        exit 1
+    fi
+
+    # Read generated increment IDs
+    CHUNKED_IDS_FILE="$STATE_DIR/chunked-increments.txt"
+    if [ -f "$CHUNKED_IDS_FILE" ]; then
+        echo ""
+        echo "📋 Plan saved. The increments will be created during execution."
+        echo ""
+
+        # If auto-approve, signal that increments need to be created
+        if [ "$AUTO_APPROVE" = "true" ]; then
+            echo '{"needsIncrementCreation": true, "fromChunking": true, "autoApproved": true, "timestamp": "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}' > "$STATE_DIR/auto-needs-increment.json"
+            echo "✅ Plan auto-approved. Ready to create increments."
+        else
+            echo '{"needsIncrementCreation": true, "fromChunking": true, "autoApproved": false, "timestamp": "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}' > "$STATE_DIR/auto-needs-increment.json"
+            echo ""
+            echo "💡 To proceed:"
+            echo "   1. Review the plan above"
+            echo "   2. Run /sw:auto again to start execution"
+            echo "   3. Or use --yes to auto-approve"
+        fi
+
+        # Exit with code 2 to signal LLM should create increments
+        exit 2
+    else
+        echo "❌ No increments generated from prompt"
+        exit 1
+    fi
+fi
+
 # Build increment queue
 if [ "$ALL_BACKLOG" = "true" ]; then
     # Find all backlog increments, sorted by priority