specweave 1.0.550 → 1.0.552

package/plugins/specweave/hooks/lib/migrate-increment-work.sh

@@ -1,245 +0,0 @@
-#!/bin/bash
-
-# SpecWeave Increment Work Migration Utility
-# Purpose: Smart migration options when WIP limit is reached
-#
-# Options:
-#   1. Transfer work (move incomplete tasks to new increment)
-#   2. Adjust WIP limit (temporarily allow 3 active)
-#   3. Force-close (mark as complete without transferring work)
-
-set +e  # EMERGENCY FIX: Changed from set -euo pipefail to prevent Claude Code crashes
-
-# ============================================================================
-# CONFIGURATION
-# ============================================================================
-
-SPECWEAVE_DIR="${SPECWEAVE_DIR:-.specweave}"
-CONFIG_FILE="$SPECWEAVE_DIR/config.json"
-
-# ============================================================================
-# HELPER FUNCTIONS
-# ============================================================================
-
-# Get incomplete tasks from increment
-get_incomplete_tasks() {
-  local increment_id="$1"
-  local tasks_file="$SPECWEAVE_DIR/increments/$increment_id/tasks.md"
-
-  if [[ ! -f "$tasks_file" ]]; then
-    echo ""
-    return
-  fi
-
-  # Extract unchecked tasks (lines starting with "- [ ]")
-  grep -E "^\s*-\s*\[ \]" "$tasks_file" 2>/dev/null || echo ""
-}
-
-# Count incomplete tasks
-count_incomplete_tasks() {
-  local increment_id="$1"
-  local tasks=$(get_incomplete_tasks "$increment_id")
-
-  if [[ -z "$tasks" ]]; then
-    echo "0"
-  else
-    echo "$tasks" | wc -l | xargs
-  fi
-}
-
-# Transfer work from old increment to new increment
-transfer_work() {
-  local source_increment="$1"
-  local target_increment="$2"
-
-  echo "🔄 Transferring incomplete work from $source_increment to $target_increment..."
-
-  # Get incomplete tasks
-  local incomplete_tasks=$(get_incomplete_tasks "$source_increment")
-
-  if [[ -z "$incomplete_tasks" ]]; then
-    echo "✅ No incomplete tasks to transfer"
-    return 0
-  fi
-
-  local task_count=$(echo "$incomplete_tasks" | wc -l | xargs)
-  echo "   📋 Found $task_count incomplete tasks"
-
-  # Append to target increment's tasks.md
-  local target_tasks="$SPECWEAVE_DIR/increments/$target_increment/tasks.md"
-
-  if [[ ! -f "$target_tasks" ]]; then
-    echo "❌ Target increment tasks.md not found: $target_tasks"
-    return 1
-  fi
-
-  # Add separator and transferred tasks
-  cat >> "$target_tasks" <<EOF
-
----
-
-## 🔄 Transferred from $source_increment
-
-$incomplete_tasks
-
-EOF
-
-  echo "   ✅ Transferred $task_count tasks to $target_tasks"
-
-  # Mark source increment as completed-with-work-transfer
-  local source_metadata="$SPECWEAVE_DIR/increments/$source_increment/metadata.json"
-
-  if [[ -f "$source_metadata" ]]; then
-    node -e "
-      const fs = require('fs');
-      const path = '$source_metadata';
-      const data = JSON.parse(fs.readFileSync(path, 'utf-8'));
-      data.status = 'completed';
-      data.completionNote = 'Work transferred to $target_increment';
-      data.completedAt = new Date().toISOString();
-      data.workTransferredTo = '$target_increment';
-      fs.writeFileSync(path, JSON.stringify(data, null, 2));
-    "
-    echo "   ✅ Updated $source_increment metadata (status: completed, work transferred)"
-  fi
-
-  # Update target increment metadata
-  local target_metadata="$SPECWEAVE_DIR/increments/$target_increment/metadata.json"
-
-  if [[ -f "$target_metadata" ]]; then
-    node -e "
-      const fs = require('fs');
-      const path = '$target_metadata';
-      const data = JSON.parse(fs.readFileSync(path, 'utf-8'));
-      data.workTransferredFrom = data.workTransferredFrom || [];
-      data.workTransferredFrom.push('$source_increment');
-      fs.writeFileSync(path, JSON.stringify(data, null, 2));
-    "
-    echo "   ✅ Updated $target_increment metadata (work received from $source_increment)"
-  fi
-
-  echo "✅ Work transfer complete!"
-  return 0
-}
-
-# Adjust WIP limit temporarily
-adjust_wip_limit() {
-  local new_limit="$1"
-
-  echo "⚠️  Temporarily adjusting WIP limit to $new_limit..."
-
-  if [[ ! -f "$CONFIG_FILE" ]]; then
-    echo "❌ Config file not found: $CONFIG_FILE"
-    return 1
-  fi
-
-  # Update config.json (create backup first)
-  cp "$CONFIG_FILE" "$CONFIG_FILE.bak"
-
-  node -e "
-    const fs = require('fs');
-    const path = '$CONFIG_FILE';
-    const data = JSON.parse(fs.readFileSync(path, 'utf-8'));
-
-    // Ensure limits object exists
-    if (!data.limits) {
-      data.limits = {};
-    }
-
-    // Store original limit
-    if (!data.limits.originalHardCap) {
-      data.limits.originalHardCap = data.limits.hardCap || 2;
-    }
-
-    // Set new limit
-    data.limits.hardCap = parseInt('$new_limit', 10);
-    data.limits.wipAdjustedAt = new Date().toISOString();
-
-    fs.writeFileSync(path, JSON.stringify(data, null, 2));
-  "
-
-  echo "   ✅ WIP limit adjusted to $new_limit"
-  echo "   ⚠️  Remember to revert after completing one increment!"
-  echo "   💡 Run: specweave revert-wip-limit"
-
-  return 0
-}
-
-# Force-close increment
-force_close() {
-  local increment_id="$1"
-
-  echo "⚠️  Force-closing $increment_id..."
-
-  local metadata_file="$SPECWEAVE_DIR/increments/$increment_id/metadata.json"
-
-  if [[ ! -f "$metadata_file" ]]; then
-    echo "❌ Metadata file not found: $metadata_file"
-    return 1
-  fi
-
-  node -e "
-    const fs = require('fs');
-    const path = '$metadata_file';
-    const data = JSON.parse(fs.readFileSync(path, 'utf-8'));
-    data.status = 'completed';
-    data.completionNote = 'Force-closed to start new increment (WIP limit reached)';
-    data.completedAt = new Date().toISOString();
-    data.forceCloseReason = 'wip-limit-reached';
-    fs.writeFileSync(path, JSON.stringify(data, null, 2));
-  "
-
-  echo "   ✅ $increment_id marked as completed (force-closed)"
-  echo "   ⚠️  Incomplete work was not transferred!"
-
-  return 0
-}
-
-# ============================================================================
-# MAIN CLI
-# ============================================================================
-
-case "${1:-}" in
-  transfer)
-    if [[ $# -ne 3 ]]; then
-      echo "Usage: $0 transfer <source_increment> <target_increment>"
-      exit 0  # SAFETY: Never use exit 1 in hooks
-    fi
-    transfer_work "$2" "$3"
-    ;;
-
-  adjust-wip)
-    if [[ $# -ne 2 ]]; then
-      echo "Usage: $0 adjust-wip <new_limit>"
-      exit 0  # SAFETY: Never use exit 1 in hooks
-    fi
-    adjust_wip_limit "$2"
-    ;;
-
-  force-close)
-    if [[ $# -ne 2 ]]; then
-      echo "Usage: $0 force-close <increment_id>"
-      exit 0  # SAFETY: Never use exit 1 in hooks
-    fi
-    force_close "$2"
-    ;;
-
-  count-incomplete)
-    if [[ $# -ne 2 ]]; then
-      echo "Usage: $0 count-incomplete <increment_id>"
-      exit 0  # SAFETY: Never use exit 1 in hooks
-    fi
-    count_incomplete_tasks "$2"
-    ;;
-
-  *)
-    echo "SpecWeave Increment Work Migration Utility"
-    echo ""
-    echo "Usage:"
-    echo "  $0 transfer <source> <target>    # Transfer work from source to target"
-    echo "  $0 adjust-wip <limit>             # Adjust WIP limit temporarily"
-    echo "  $0 force-close <increment>        # Force-close increment"
-    echo "  $0 count-incomplete <increment>   # Count incomplete tasks"
-    exit 0  # SAFETY: Never use exit 1 in hooks
-    ;;
-esac

package/plugins/specweave/hooks/lib/resolve-package.sh

@@ -1,146 +0,0 @@
-#!/bin/bash
-#
-# Resolve SpecWeave Package Location
-#
-# Shared library for hooks to find the specweave package installation.
-# This is CRITICAL for hooks to work on user machines where PROJECT_ROOT
-# doesn't contain dist/src/cli files.
-#
-# Usage:
-#   source "$(dirname "$0")/../lib/resolve-package.sh"
-#   # Then use $SPECWEAVE_PKG variable
-#
-# v1.0.71 - Created to fix hooks hanging on user machines
-
-# =============================================================================
-# resolve_specweave_package - Find the specweave npm package location
-# =============================================================================
-# Searches in this order:
-# 1. CLAUDE_PLUGIN_ROOT environment variable (set by Claude Code for plugins)
-# 2. Relative to calling script (for hooks inside the package)
-# 3. Global npm installation (npm root -g)
-# 4. Local npm installation (which specweave)
-# =============================================================================
-
-resolve_specweave_package() {
-  local caller_dir="${1:-$PWD}"
-
-  # Method 1: CLAUDE_PLUGIN_ROOT (set by Claude Code when running plugin hooks)
-  if [[ -n "${CLAUDE_PLUGIN_ROOT:-}" ]] && [[ -d "${CLAUDE_PLUGIN_ROOT}/dist/src/cli" ]]; then
-    echo "$CLAUDE_PLUGIN_ROOT"
-    return 0
-  fi
-
-  # Method 2: Walk up from caller directory to find package root
-  # Handles various depths: hooks/v2/, hooks/lib/, hooks/v2/handlers/, etc.
-  local search_dir="$caller_dir"
-  local max_depth=6
-  local depth=0
-
-  while [[ "$search_dir" != "/" ]] && [[ $depth -lt $max_depth ]]; do
-    if [[ -d "$search_dir/dist/src/cli" ]] && [[ -f "$search_dir/package.json" ]]; then
-      # Verify it's actually specweave package
-      if grep -q '"name": "specweave"' "$search_dir/package.json" 2>/dev/null; then
-        echo "$search_dir"
-        return 0
-      fi
-    fi
-    search_dir="$(dirname "$search_dir")"
-    depth=$((depth + 1))
-  done
-
-  # Method 3: 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
-
-  # Method 4: Find via which specweave
-  local specweave_bin
-  specweave_bin="$(which specweave 2>/dev/null)"
-  if [[ -n "$specweave_bin" ]]; then
-    # Handle symlinks (npm link, volta, etc.)
-    # Use portable symlink resolution (macOS doesn't have readlink -f)
-    local real_bin
-    if command -v realpath >/dev/null 2>&1; then
-      real_bin="$(realpath "$specweave_bin" 2>/dev/null || echo "$specweave_bin")"
-    elif command -v greadlink >/dev/null 2>&1; then
-      real_bin="$(greadlink -f "$specweave_bin" 2>/dev/null || echo "$specweave_bin")"
-    elif [[ "$(uname)" == "Darwin" ]]; then
-      # macOS fallback: resolve symlink chain manually
-      real_bin="$specweave_bin"
-      while [[ -L "$real_bin" ]]; do
-        local link_target
-        link_target="$(readlink "$real_bin")"
-        if [[ "$link_target" == /* ]]; then
-          real_bin="$link_target"
-        else
-          real_bin="$(dirname "$real_bin")/$link_target"
-        fi
-      done
-      real_bin="$(cd "$(dirname "$real_bin")" && pwd)/$(basename "$real_bin")"
-    else
-      real_bin="$(readlink -f "$specweave_bin" 2>/dev/null || echo "$specweave_bin")"
-    fi
-    local bin_dir="$(dirname "$real_bin")"
-    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
-
-  # Not found
-  return 1
-}
-
-# Auto-resolve when sourced (convenience)
-# Only set if not already set (allows override)
-if [[ -z "${SPECWEAVE_PKG:-}" ]]; then
-  # Get the directory of the script that sourced this
-  _RESOLVE_CALLER_DIR="$(cd "$(dirname "${BASH_SOURCE[1]:-${BASH_SOURCE[0]}}")" && pwd)"
-  SPECWEAVE_PKG="$(resolve_specweave_package "$_RESOLVE_CALLER_DIR")"
-  export SPECWEAVE_PKG
-fi
-
-# =============================================================================
-# find_specweave_script - Find a script file in the specweave package
-# =============================================================================
-# Usage: find_specweave_script "dist/src/cli/register-session.js"
-# Returns: Full path if found, empty string otherwise
-# =============================================================================
-
-find_specweave_script() {
-  local script_path="$1"
-
-  if [[ -n "$SPECWEAVE_PKG" ]] && [[ -f "$SPECWEAVE_PKG/$script_path" ]]; then
-    echo "$SPECWEAVE_PKG/$script_path"
-    return 0
-  fi
-
-  return 1
-}
-
-# =============================================================================
-# run_specweave_cli - Run a CLI script from the specweave package
-# =============================================================================
-# Usage: run_specweave_cli "dist/src/cli/register-session.js" arg1 arg2
-# Returns: Exit code from node, or 1 if script not found
-# =============================================================================
-
-run_specweave_cli() {
-  local script_path="$1"
-  shift
-
-  local full_path
-  full_path="$(find_specweave_script "$script_path")"
-
-  if [[ -z "$full_path" ]]; then
-    echo "ERROR: Script not found: $script_path" >&2
-    return 1
-  fi
-
-  node "$full_path" "$@"
-}

package/plugins/specweave/hooks/lib/scheduler-startup.sh

@@ -1,135 +0,0 @@
-#!/bin/bash
-# scheduler-startup.sh - Execute due sync jobs on session start
-# Called from session-start hook to run overdue scheduled jobs
-#
-# This implements the "pragmatic hybrid" approach:
-# - No background daemon required
-# - Sync runs at Claude Code session boundaries
-# - Respects permission gates (canUpdateExternalItems, etc.)
-#
-# CRITICAL (v0.28.70): NEVER use 'set -e' in hooks - causes Claude Code crashes
-set +e
-
-# Skip if hooks disabled
-[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
-
-# Find project root
-PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
-  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
-done
-
-# Exit if no .specweave/config.json
-[[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && exit 0
-
-# Source resolve-package.sh for dynamic specweave path resolution
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-if [[ -f "$SCRIPT_DIR/resolve-package.sh" ]]; then
-  source "$SCRIPT_DIR/resolve-package.sh"
-fi
-
-# Paths
-SCHEDULED_JOBS_FILE="$PROJECT_ROOT/.specweave/state/scheduled-jobs.json"
-CONFIG_FILE="$PROJECT_ROOT/.specweave/config.json"
-LOG_FILE="$PROJECT_ROOT/.specweave/logs/scheduler.log"
-
-# Ensure logs directory exists
-mkdir -p "$PROJECT_ROOT/.specweave/logs" 2>/dev/null || true
-
-# Check if scheduler is enabled
-if [[ -f "$CONFIG_FILE" ]]; then
-  # Check if sync.orchestration.scheduler.enabled is true
-  SCHEDULER_ENABLED=$(node -e "
-    try {
-      const config = require('$CONFIG_FILE');
-      const enabled = config?.sync?.orchestration?.scheduler?.enabled ?? false;
-      console.log(enabled ? 'true' : 'false');
-    } catch(e) {
-      console.log('false');
-    }
-  " 2>/dev/null || echo "false")
-
-  if [[ "$SCHEDULER_ENABLED" != "true" ]]; then
-    exit 0
-  fi
-
-  # Check autoSyncOnSessionStart (defaults to true)
-  AUTO_SYNC=$(node -e "
-    try {
-      const config = require('$CONFIG_FILE');
-      const auto = config?.sync?.orchestration?.scheduler?.autoSyncOnSessionStart ?? true;
-      console.log(auto ? 'true' : 'false');
-    } catch(e) {
-      console.log('true');
-    }
-  " 2>/dev/null || echo "true")
-
-  if [[ "$AUTO_SYNC" != "true" ]]; then
-    exit 0
-  fi
-fi
-
-# Check if scheduled jobs file exists
-if [[ ! -f "$SCHEDULED_JOBS_FILE" ]]; then
-  exit 0
-fi
-
-# Use node to check for due jobs (robust JSON parsing)
-DUE_JOBS=$(node -e "
-  const fs = require('fs');
-  try {
-    const data = JSON.parse(fs.readFileSync('$SCHEDULED_JOBS_FILE', 'utf-8'));
-    const now = Date.now();
-    const dueJobs = (data.jobs || []).filter(job => {
-      if (!job.schedule.enabled || job.status !== 'idle') return false;
-      if (!job.schedule.nextRun) return true;
-      return new Date(job.schedule.nextRun).getTime() <= now;
-    });
-    console.log(JSON.stringify(dueJobs.map(j => j.id)));
-  } catch(e) {
-    console.log('[]');
-  }
-" 2>/dev/null || echo "[]")
-
-# Exit if no due jobs
-if [[ "$DUE_JOBS" == "[]" ]]; then
-  exit 0
-fi
-
-# Log due jobs
-TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-echo "[$TIMESTAMP] Session start - due jobs: $DUE_JOBS" >> "$LOG_FILE" 2>/dev/null || true
-
-# Execute due sync jobs using the TypeScript executor
-# Resolve executor path via resolve-package.sh (not hardcoded node_modules)
-EXECUTOR_PATH=$(find_specweave_script "dist/src/core/scheduler/session-sync-executor.js" 2>/dev/null)
-if [[ -z "$EXECUTOR_PATH" ]]; then
-  echo '{"error":"Executor not found — specweave package not resolved"}' >> "$LOG_FILE" 2>/dev/null || true
-  exit 0
-fi
-
-RESULT=$(node -e "
-  const { executeSessionSync } = require('$EXECUTOR_PATH');
-  executeSessionSync('$PROJECT_ROOT', { silent: false })
-    .then(r => console.log(r))
-    .catch(e => console.log(JSON.stringify({ error: e.message })));
-" 2>&1) || RESULT='{"error":"Executor not found"}'
-
-# Log result
-echo "[$TIMESTAMP] Execution result: $RESULT" >> "$LOG_FILE" 2>/dev/null || true
-
-# Parse result for system message
-EXECUTED_COUNT=$(echo "$RESULT" | node -e "
-  const data = JSON.parse(require('fs').readFileSync('/dev/stdin', 'utf-8'));
-  console.log(data.executedCount || 0);
-" 2>/dev/null || echo "0")
-
-SUCCESS_COUNT=$(echo "$RESULT" | node -e "
-  const data = JSON.parse(require('fs').readFileSync('/dev/stdin', 'utf-8'));
-  console.log(data.successCount || 0);
-" 2>/dev/null || echo "0")
-
-# Output status message if jobs were executed
-if [[ "$EXECUTED_COUNT" != "0" ]]; then
-  echo "{\"continue\": true, \"systemMessage\": \"📅 Session sync: $SUCCESS_COUNT/$EXECUTED_COUNT sync jobs executed successfully.\"}"
-fi

package/plugins/specweave/hooks/lib/score-increment.sh

@@ -1,87 +0,0 @@
-#!/bin/bash
-# score-increment.sh — Score an increment against a text query using keyword overlap.
-#
-# Usage: score-increment.sh <increment_dir> <query>
-# Output: integer 0-100 (higher = better match)
-#
-# Corpus: increment directory name + metadata title + spec.md overview + task titles
-
-set -e
-
-INCREMENT_DIR="$1"
-QUERY="$2"
-
-if [ -z "$INCREMENT_DIR" ] || [ -z "$QUERY" ]; then
-    echo "0"
-    exit 0
-fi
-
-if [ ! -d "$INCREMENT_DIR" ]; then
-    echo "0"
-    exit 0
-fi
-
-# Build corpus from multiple sources
-CORPUS=""
-
-# 1. Directory name (e.g. "0257-auto-context-aware-selection" → words)
-DIR_NAME=$(basename "$INCREMENT_DIR")
-CORPUS="$CORPUS ${DIR_NAME//-/ }"
-
-# 2. Title from metadata.json
-META_FILE="$INCREMENT_DIR/metadata.json"
-if [ -f "$META_FILE" ]; then
-    TITLE=$(jq -r '.title // .name // ""' "$META_FILE" 2>/dev/null || echo "")
-    CORPUS="$CORPUS $TITLE"
-fi
-
-# 3. First 500 chars of spec.md (overview/problem statement)
-SPEC_FILE="$INCREMENT_DIR/spec.md"
-if [ -f "$SPEC_FILE" ]; then
-    OVERVIEW=$(head -c 500 "$SPEC_FILE" 2>/dev/null || echo "")
-    CORPUS="$CORPUS $OVERVIEW"
-fi
-
-# 4. Task titles from tasks.md (lines starting with ### T-)
-TASKS_FILE="$INCREMENT_DIR/tasks.md"
-if [ -f "$TASKS_FILE" ]; then
-    TASK_TITLES=$(grep '^### T-' "$TASKS_FILE" 2>/dev/null | sed 's/^### T-[0-9]*: //' || echo "")
-    CORPUS="$CORPUS $TASK_TITLES"
-fi
-
-# Normalize corpus: lowercase, non-alphanumeric → space
-CORPUS_LC=$(echo "$CORPUS" | tr '[:upper:]' '[:lower:]' | tr -cs 'a-z0-9' ' ')
-
-# Extract unique query keywords: lowercase, length > 2, skip common stopwords
-STOPWORDS="the and for with from that this are was were has have been will not"
-KEYWORDS=$(echo "$QUERY" | tr '[:upper:]' '[:lower:]' | tr -cs 'a-z0-9' '\n' | \
-    awk 'length > 2' | \
-    grep -vxF -e "the" -e "and" -e "for" -e "with" -e "from" -e "that" -e "this" \
-              -e "are" -e "was" -e "were" -e "has" -e "have" -e "been" -e "will" \
-              -e "not" -e "into" -e "use" -e "its" | \
-    sort -u)
-
-if [ -z "$KEYWORDS" ]; then
-    echo "0"
-    exit 0
-fi
-
-# Count matches
-TOTAL=0
-MATCHED=0
-while IFS= read -r keyword; do
-    [ -z "$keyword" ] && continue
-    TOTAL=$((TOTAL + 1))
-    if echo "$CORPUS_LC" | grep -qw "$keyword" 2>/dev/null; then
-        MATCHED=$((MATCHED + 1))
-    fi
-done <<< "$KEYWORDS"
-
-if [ "$TOTAL" -eq 0 ]; then
-    echo "0"
-    exit 0
-fi
-
-# Score = matched_keywords / total_keywords * 100
-SCORE=$(( MATCHED * 100 / TOTAL ))
-echo "$SCORE"