specweave 0.28.24 → 0.28.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.28.24",
+  "version": "0.28.25",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave-ado/lib/ado-multi-project-sync.js

@@ -373,7 +373,6 @@ ${userStory.technicalContext}
         return mapping.task || "Task";
       case "Subtask":
         return mapping.task || "Task";
-      // ADO doesn't have subtasks, use Task
       default:
         return "User Story";
     }

package/plugins/specweave-jira/lib/enhanced-jira-sync.js

@@ -1,6 +1,6 @@
-import { EnhancedContentBuilder } from "../../../dist/src/core/sync/enhanced-content-builder.js";
-import { SpecIncrementMapper } from "../../../dist/src/core/sync/spec-increment-mapper.js";
-import { parseSpecContent } from "../../../dist/src/core/spec-content-sync.js";
+import { EnhancedContentBuilder } from "../../../src/core/sync/enhanced-content-builder.js";
+import { SpecIncrementMapper } from "../../../src/core/sync/spec-increment-mapper.js";
+import { parseSpecContent } from "../../../src/core/spec-content-sync.js";
 import * as path from "path";
 import * as fs from "fs/promises";
 async function syncSpecToJiraWithEnhancedContent(options) {

package/plugins/specweave-release/commands/specweave-release-npm.md

@@ -1,6 +1,6 @@
 ---
 name: specweave-release:npm
-description: Bump patch version, create git tag, and trigger npm publish via GitHub Actions. Automates the complete release workflow with pre-flight checks, version bumping, tag creation, and GitHub Actions triggering. Use --only flag for quick local release (bumps version, builds, publishes to npm directly - NO git push, NO pipeline). Add --push to --only for complete local release with git sync.
+description: Bump patch version, create git tag, and trigger npm publish via GitHub Actions. Automates the complete release workflow with pre-flight checks, version bumping, tag creation, and GitHub Actions triggering. Use --only flag for quick local release (bumps version, builds, publishes to npm directly - NO git push, NO pipeline). Add --push to --only for complete local release with git sync. Use --only --local for FASTEST local-only version bump (no npm publish, no git, just version increment for local testing).
 ---
 
 # /specweave-release:npm - NPM Release Automation
@@ -14,22 +14,27 @@ You are the NPM Release Assistant. Your job is to automate the patch version rel
 | `/specweave-release:npm` | Bump → Push → **CI publishes** | Standard release (CI handles npm) |
 | `/specweave-release:npm --only` | Bump → Build → **Publish locally** → NO push | Quick local release, push later |
 | `/specweave-release:npm --only --push` | Bump → Build → **Publish locally** → Push | Complete local release + git sync |
+| `/specweave-release:npm --only --local` | **Bump ONLY** → NO build, NO publish, NO git | FASTEST: Local testing only |
 
 ## Detecting Mode
 
 Check flags in the command invocation:
 
 ```
---only         → Direct publish to npm (bypass CI)
+--only --local → Version bump ONLY (no build, no publish, no git) - FASTEST
 --only --push  → Direct publish + push to git after
+--only         → Direct publish to npm (bypass CI)
 (no flags)     → Default: push to git, CI publishes
 ```
 
 **Flag Detection Order:**
 1. Check for `--only` flag
-2. If `--only` present, check for `--push` flag
-3. Route to appropriate workflow section
+2. If `--only` present, check for `--local` flag → LOCAL MODE (fastest)
+3. If `--only` present, check for `--push` flag → DIRECT MODE + PUSH
+4. If `--only` only → DIRECT MODE
+5. No flags → DEFAULT MODE
 
+**If `--only --local`**: Use LOCAL MODE (section "Local Mode Workflow") - FASTEST!
 **If `--only --push`**: Use DIRECT MODE WITH PUSH (section "Direct Mode + Push Workflow")
 **If `--only` only**: Use DIRECT MODE (section "Direct Mode Workflow")
 **If no flags**: Use DEFAULT MODE (continue with steps below)
@@ -400,6 +405,9 @@ Show the user:
 
 # Complete local release (publish + push)
 /specweave-release:npm --only --push
+
+# FASTEST: Version bump only (no publish, no git, no build)
+/specweave-release:npm --only --local
 ```
 
 | Scenario | Command | NPM Published By | Git Pushed |
@@ -407,3 +415,85 @@ Show the user:
 | Normal release | (no flags) | GitHub Actions | ✅ Yes |
 | Quick local, push later | `--only` | You (local) | ❌ No |
 | Complete local release | `--only --push` | You (local) | ✅ Yes |
+| **FASTEST local test** | `--only --local` | ❌ None | ❌ No |
+
+---
+
+## LOCAL MODE WORKFLOW (--only --local flags) - FASTEST!
+
+Use this workflow when BOTH `--only` AND `--local` flags are detected. This is the **fastest possible** version bump - NO npm publish, NO git operations, NO build. Just increment the version number for local testing.
+
+**Use case**: You need to quickly test a new version locally without publishing anywhere. Perfect for:
+- Testing version-dependent features
+- Local development iterations
+- Quick version bumps before a real release
+
+### 1. Minimal Pre-flight Check
+
+```bash
+# Just verify current version (no git checks needed!)
+node -p "require('./package.json').version"
+```
+
+**NO git checks** - we're not committing or pushing anything!
+
+### 2. Bump Version (NO git commit, NO tag)
+
+```bash
+# Bump version WITHOUT creating git commit or tag
+npm version patch --no-git-tag-version
+```
+
+**What this does**:
+- Updates `package.json` version ONLY
+- Updates `package-lock.json` version ONLY
+- NO git commit created
+- NO git tag created
+- INSTANT (< 1 second)
+
+### 3. Report Results (Local Mode)
+
+Show the user:
+```markdown
+⚡ **FAST local version bump!**
+
+📦 **Version**: X.Y.Z → X.Y.(Z+1)
+
+**What happened**:
+- ✅ package.json version bumped
+- ✅ package-lock.json updated
+- ⏭️ NO git commit (use `git add . && git commit` later)
+- ⏭️ NO git tag (use `git tag vX.Y.Z` later)
+- ⏭️ NO npm publish (use `npm publish` later)
+- ⏭️ NO build (use `npm run rebuild` later)
+
+**Next steps when ready to release**:
+1. Build: `npm run rebuild`
+2. Test: `npm test`
+3. Commit: `git add . && git commit -m "chore: bump version to X.Y.Z"`
+4. Tag: `git tag vX.Y.Z`
+5. Publish: `npm publish`
+6. Push: `git push origin develop --follow-tags`
+
+**Or use**: `/specweave-release:npm --only --push` for full release
+```
+
+## Local Mode Safety Rules
+
+- ✅ FASTEST possible - single npm command
+- ✅ NO network operations (no npm publish, no git push)
+- ✅ NO disk-heavy operations (no build)
+- ✅ Safe to run multiple times (just increments version)
+- ⚠️ Remember: version is NOT published or committed!
+- ⚠️ Run `npm run rebuild` before testing locally
+
+## Success Criteria (Local Mode)
+
+✅ Version bumped in package.json
+✅ Version bumped in package-lock.json
+⏭️ NO git commit
+⏭️ NO git tag
+⏭️ NO npm publish
+⏭️ NO build
+
+**Time**: < 1 second

package/plugins/specweave/hooks/docs-changed.sh.backup

@@ -1,79 +0,0 @@
-#!/bin/bash
-
-# SpecWeave Docs-Changed Hook
-# Runs after file changes are detected
-# Detects if documentation was changed during implementation
-# Triggers review workflow if needed
-
-set -e
-
-# Find project root by searching upward for .specweave/ directory
-# Works regardless of where hook is installed (source or .claude/hooks/)
-find_project_root() {
-  local dir="$1"
-  while [ "$dir" != "/" ]; do
-    if [ -d "$dir/.specweave" ]; then
-      echo "$dir"
-      return 0
-    fi
-    dir="$(dirname "$dir")"
-  done
-  # Fallback: try current directory
-  if [ -d "$(pwd)/.specweave" ]; then
-    pwd
-  else
-    echo "$(pwd)"
-  fi
-}
-
-PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
-cd "$PROJECT_ROOT"
-
-# Colors
-RED='\033[0;31m'
-YELLOW='\033[1;33m'
-NC='\033[0m'
-
-# Get changed files (git)
-if ! git rev-parse --git-dir > /dev/null 2>&1; then
-  # Not a git repository, skip
-  exit 0
-fi
-
-CHANGED_FILES=$(git diff --name-only HEAD 2>/dev/null || echo "")
-
-if [ -z "$CHANGED_FILES" ]; then
-  # No changes
-  exit 0
-fi
-
-# Check if any documentation files changed
-DOC_CHANGES=$(echo "$CHANGED_FILES" | grep -E '\.specweave/(docs|increments/.*/.*\.md)' || true)
-
-if [ -n "$DOC_CHANGES" ]; then
-  echo -e "${RED}⚠️  Documentation changed during implementation${NC}"
-  echo ""
-  echo "📋 Files changed:"
-  echo "$DOC_CHANGES" | sed 's/^/   /'
-  echo ""
-  echo -e "${YELLOW}🔔 Recommended actions:${NC}"
-  echo "  1. Review documentation changes"
-  echo "  2. Update tasks.md if architecture changed"
-  echo "  3. Type /review-docs to see full impact"
-  echo ""
-
-  # Play notification sound
-  case "$(uname -s)" in
-    Darwin)
-      afplay /System/Library/Sounds/Ping.aiff 2>/dev/null &
-      ;;
-    Linux)
-      paplay /usr/share/sounds/freedesktop/stereo/dialog-warning.oga 2>/dev/null || true
-      ;;
-  esac
-
-  # Log to hooks log
-  LOGS_DIR=".specweave/logs"
-  mkdir -p "$LOGS_DIR"
-  echo "[$(date)] Documentation changed: $DOC_CHANGES" >> "$LOGS_DIR/hooks.log"
-fi

package/plugins/specweave/hooks/human-input-required.sh.backup

@@ -1,75 +0,0 @@
-#!/bin/bash
-
-# SpecWeave Human-Input-Required Hook
-# Runs when Claude needs clarification or approval
-#
-# Actions:
-# 1. Play notification sound (Ping.aiff)
-# 2. Log the question/requirement
-# 3. Record in current increment's work log (if applicable)
-
-set -e
-
-# Find project root by searching upward for .specweave/ directory
-# Works regardless of where hook is installed (source or .claude/hooks/)
-find_project_root() {
-  local dir="$1"
-  while [ "$dir" != "/" ]; do
-    if [ -d "$dir/.specweave" ]; then
-      echo "$dir"
-      return 0
-    fi
-    dir="$(dirname "$dir")"
-  done
-  # Fallback: try current directory
-  if [ -d "$(pwd)/.specweave" ]; then
-    pwd
-  else
-    echo "$(pwd)"
-  fi
-}
-
-PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
-cd "$PROJECT_ROOT"
-
-# Get question/requirement (passed as argument or default)
-QUESTION="${1:-User input required}"
-
-echo "❓ Human input required"
-
-# 1. Play notification sound (cross-platform)
-play_sound() {
-  case "$(uname -s)" in
-    Darwin)
-      afplay /System/Library/Sounds/Ping.aiff 2>/dev/null &
-      ;;
-    Linux)
-      paplay /usr/share/sounds/freedesktop/stereo/dialog-question.oga 2>/dev/null || \
-      aplay /usr/share/sounds/alsa/Side_Left.wav 2>/dev/null || true
-      ;;
-    MINGW*|MSYS*|CYGWIN*)
-      powershell -c "(New-Object Media.SoundPlayer 'C:\Windows\Media\notify.wav').PlaySync();" 2>/dev/null || true
-      ;;
-  esac
-}
-
-play_sound &
-
-# 2. Log to main hooks log
-LOGS_DIR=".specweave/logs"
-mkdir -p "$LOGS_DIR"
-echo "[$(date)] Human input required: $QUESTION" >> "$LOGS_DIR/hooks.log"
-
-# 3. Log to current work context (if exists)
-CURRENT_WORK=$(find .specweave/work -maxdepth 1 -type d -name "current-*" | head -1 || true)
-
-if [ -n "$CURRENT_WORK" ] && [ -d "$CURRENT_WORK" ]; then
-    echo "" >> "$CURRENT_WORK/notes.md"
-    echo "## Input Required ($(date +%Y-%m-%d\ %H:%M))" >> "$CURRENT_WORK/notes.md"
-    echo "" >> "$CURRENT_WORK/notes.md"
-    echo "$QUESTION" >> "$CURRENT_WORK/notes.md"
-    echo "" >> "$CURRENT_WORK/notes.md"
-    echo "📝 Logged to $CURRENT_WORK/notes.md"
-fi
-
-echo "✅ Hook complete"

package/plugins/specweave/hooks/post-first-increment.sh.backup

@@ -1,61 +0,0 @@
-#!/usr/bin/env bash
-# SpecWeave Post-First-Increment Hook
-#
-# Triggers after the first increment is completed
-# Congratulates the user on completing their first increment
-#
-# NON-INTERACTIVE: Just shows a message (hooks run in background)
-
-set -euo pipefail
-
-# Get project root (where .specweave/ lives)
-PROJECT_ROOT="$(pwd)"
-
-# Check if .specweave directory exists
-if [ ! -d ".specweave" ]; then
-  # Not in SpecWeave project, skip
-  exit 0
-fi
-
-# Check if this is the first increment completion
-# Count completed increments in .specweave/increments/
-COMPLETED_COUNT=0
-if [ -d ".specweave/increments" ]; then
-  # Count directories that have COMPLETION-REPORT.md or completion metadata
-  for inc_dir in .specweave/increments/[0-9][0-9][0-9][0-9]-*/; do
-    if [ -d "$inc_dir" ]; then
-      if [ -f "${inc_dir}reports/COMPLETION-REPORT.md" ] || \
-         [ -f "${inc_dir}COMPLETION-SUMMARY.md" ] || \
-         ([ -f "${inc_dir}metadata.json" ] && grep -q '"status".*"completed"' "${inc_dir}metadata.json" 2>/dev/null); then
-        COMPLETED_COUNT=$((COMPLETED_COUNT + 1))
-      fi
-    fi
-  done
-fi
-
-# Only trigger on first completion
-if [ "$COMPLETED_COUNT" -ne 1 ]; then
-  exit 0
-fi
-
-# Show congratulations message (non-interactive)
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "🎉 Congratulations! You completed your first increment!"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-echo "✅ Your increment has been documented in:"
-echo "   .specweave/increments/[increment-id]/"
-echo ""
-echo "📚 View your documentation:"
-echo "   - Specs: .specweave/docs/internal/specs/"
-echo "   - Architecture: .specweave/docs/internal/architecture/"
-echo ""
-echo "🚀 Next steps:"
-echo "   - Review your increment: /specweave:status"
-echo "   - Start next increment: /specweave:increment \"feature name\""
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-exit 0

package/plugins/specweave/hooks/post-increment-change.sh.backup

@@ -1,98 +0,0 @@
-#!/bin/bash
-
-# SpecWeave Post-Increment-Change Hook
-# Runs automatically after increment files (spec.md, plan.md, tasks.md) are modified
-#
-# Trigger: File watcher or git hook (pre-commit/post-commit)
-# Purpose: Sync increment file changes to GitHub issues
-#
-# What it does:
-# 1. Detects which file changed (spec.md, plan.md, tasks.md)
-# 2. Invokes GitHub sync for increment changes
-# 3. Updates GitHub issue with scope/plan/task changes
-#
-# Usage:
-#   ./post-increment-change.sh <incrementId> <changedFile>
-#
-# Example:
-#   ./post-increment-change.sh 0015-hierarchical-sync spec.md
-
-set -e
-
-# Find project root
-find_project_root() {
-  local dir="$1"
-  while [ "$dir" != "/" ]; do
-    if [ -d "$dir/.specweave" ]; then
-      echo "$dir"
-      return 0
-    fi
-    dir="$(dirname "$dir")"
-  done
-  pwd
-}
-
-PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
-cd "$PROJECT_ROOT" 2>/dev/null || true
-
-# Configuration
-LOGS_DIR=".specweave/logs"
-DEBUG_LOG="$LOGS_DIR/hooks-debug.log"
-
-mkdir -p "$LOGS_DIR" 2>/dev/null || true
-
-# Arguments
-INCREMENT_ID="$1"
-CHANGED_FILE="$2"
-
-if [ -z "$INCREMENT_ID" ] || [ -z "$CHANGED_FILE" ]; then
-  echo "Usage: $0 <incrementId> <changedFile>" >&2
-  echo "Example: $0 0015-hierarchical-sync spec.md" >&2
-  exit 1
-fi
-
-echo "[$(date)] 📝 Increment file changed: $CHANGED_FILE" >> "$DEBUG_LOG" 2>/dev/null || true
-
-# Validate changed file
-case "$CHANGED_FILE" in
-  spec.md|plan.md|tasks.md)
-    ;;
-  *)
-    echo "[$(date)] ⚠️  Unknown file type: $CHANGED_FILE (skipping sync)" >> "$DEBUG_LOG" 2>/dev/null || true
-    exit 0
-    ;;
-esac
-
-# Check if Node.js available
-if ! command -v node &> /dev/null; then
-  echo "[$(date)] ⚠️  Node.js not found, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
-  exit 0
-fi
-
-# Check if GitHub CLI available
-if ! command -v gh &> /dev/null; then
-  echo "[$(date)] ℹ️  GitHub CLI not found, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
-  exit 0
-fi
-
-# Check if authenticated
-if ! gh auth status &> /dev/null; then
-  echo "[$(date)] ℹ️  GitHub CLI not authenticated, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
-  exit 0
-fi
-
-# Sync to GitHub
-echo "[$(date)] 🔄 Syncing $CHANGED_FILE changes to GitHub..." >> "$DEBUG_LOG" 2>/dev/null || true
-
-node dist/plugins/specweave-github/lib/github-sync-increment-changes.js "$INCREMENT_ID" "$CHANGED_FILE" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
-  echo "[$(date)] ⚠️  Failed to sync increment changes (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
-}
-
-echo "[$(date)] ✅ Post-increment-change hook complete" >> "$DEBUG_LOG" 2>/dev/null || true
-
-# Update status line cache (increment changed)
-HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-bash "$HOOK_DIR/lib/update-status-line.sh" 2>/dev/null || true
-
-# Return success (non-blocking)
-exit 0