specweave 1.0.256 → 1.0.259

package/plugins/specweave/hooks/v2/handlers/universal-auto-create-dispatcher.sh

@@ -0,0 +1,181 @@
+#!/bin/bash
+# Universal Auto-Create Dispatcher (v1.0.256+)
+#
+# Creates per-user-story items in ALL enabled providers when spec.md is written.
+# - GitHub: delegates to existing github-auto-create-handler.sh (backward compatible)
+# - JIRA/ADO: calls src/core/universal-auto-create.ts via Node.js
+#
+# Usage: universal-auto-create-dispatcher.sh <INCREMENT_ID>
+# Called by: safe_run_background in post-tool-use.sh
+
+set +e  # Never crash Claude Code
+
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
+# ============================================================================
+# PROJECT ROOT
+# ============================================================================
+
+find_project_root() {
+  local dir="$1"
+  while [ "$dir" != "/" ]; do
+    [ -d "$dir/.specweave" ] && echo "$dir" && return 0
+    dir="$(dirname "$dir")"
+  done
+  return 1
+}
+
+PROJECT_ROOT="$(find_project_root "$(pwd)")"
+[[ -z "$PROJECT_ROOT" ]] && exit 0
+cd "$PROJECT_ROOT" 2>/dev/null || exit 0
+
+# ============================================================================
+# ARGUMENTS
+# ============================================================================
+
+INC_ID="$1"
+[[ -z "$INC_ID" ]] && exit 0
+[[ ! "$INC_ID" =~ ^[0-9]{4}[A-Za-z0-9_-]*$ ]] && exit 0
+
+SPEC_PATH="$PROJECT_ROOT/.specweave/increments/$INC_ID/spec.md"
+METADATA_PATH="$PROJECT_ROOT/.specweave/increments/$INC_ID/metadata.json"
+CONFIG_PATH="$PROJECT_ROOT/.specweave/config.json"
+
+[[ ! -f "$SPEC_PATH" ]] && exit 0
+[[ ! -f "$CONFIG_PATH" ]] && exit 0
+
+# ============================================================================
+# LOGGING
+# ============================================================================
+
+LOGS_DIR="$PROJECT_ROOT/.specweave/logs"
+LOG_FILE="$LOGS_DIR/universal-auto-create.log"
+mkdir -p "$LOGS_DIR" 2>/dev/null || true
+
+log() {
+  echo "[$(date '+%Y-%m-%d %H:%M:%S')] [auto-create] $1" >> "$LOG_FILE" 2>/dev/null || true
+}
+
+# ============================================================================
+# DEBOUNCE (10s window — spec.md gets edited rapidly during planning)
+# ============================================================================
+
+STATE_DIR="$PROJECT_ROOT/.specweave/state"
+mkdir -p "$STATE_DIR" 2>/dev/null || true
+DEBOUNCE_FILE="$STATE_DIR/.auto-create-pending-$INC_ID"
+
+if [[ -f "$DEBOUNCE_FILE" ]]; then
+  if [[ "$(uname)" == "Darwin" ]]; then
+    AGE=$(($(date +%s) - $(stat -f%m "$DEBOUNCE_FILE" 2>/dev/null || echo 0)))
+  else
+    AGE=$(($(date +%s) - $(stat -c%Y "$DEBOUNCE_FILE" 2>/dev/null || echo 0)))
+  fi
+  [[ $AGE -lt 10 ]] && exit 0
+fi
+
+echo "$(date +%s)" > "$DEBOUNCE_FILE" 2>/dev/null || true
+sleep 10
+
+# After sleeping, check if a newer invocation took over
+if [[ -f "$DEBOUNCE_FILE" ]]; then
+  CURRENT_SIGNAL=$(cat "$DEBOUNCE_FILE" 2>/dev/null || echo 0)
+  SIGNAL_AGE=$(( $(date +%s) - CURRENT_SIGNAL ))
+  (( SIGNAL_AGE > 11 )) && exit 0
+fi
+rm -f "$DEBOUNCE_FILE" 2>/dev/null || true
+
+# ============================================================================
+# CHECK PROVIDERS
+# ============================================================================
+
+command -v jq >/dev/null 2>&1 || exit 0
+
+GH_ENABLED=$(jq -r '.sync.github.enabled // false' "$CONFIG_PATH" 2>/dev/null)
+JIRA_ENABLED=$(jq -r '.sync.jira.enabled // false' "$CONFIG_PATH" 2>/dev/null)
+ADO_ENABLED=$(jq -r '.sync.ado.enabled // false' "$CONFIG_PATH" 2>/dev/null)
+
+if [[ "$GH_ENABLED" != "true" && "$JIRA_ENABLED" != "true" && "$ADO_ENABLED" != "true" ]]; then
+  log "No providers enabled. Skipping."
+  exit 0
+fi
+
+# Check auto-create is enabled
+AUTO_CREATE=$(jq -r '.sync.autoCreateOnIncrement // .sync.autoSync // .hooks.post_increment_planning.auto_create_github_issue // false' "$CONFIG_PATH" 2>/dev/null)
+if [[ "$AUTO_CREATE" != "true" ]]; then
+  log "Auto-create disabled in config. Skipping."
+  exit 0
+fi
+
+log "Creating external items for $INC_ID (github=$GH_ENABLED jira=$JIRA_ENABLED ado=$ADO_ENABLED)"
+
+# ============================================================================
+# GITHUB: Delegate to existing handler (backward compatible)
+# ============================================================================
+
+if [[ "$GH_ENABLED" == "true" ]]; then
+  GITHUB_HANDLER="${PROJECT_ROOT}/plugins/specweave-github/hooks/github-auto-create-handler.sh"
+  if [[ -f "$GITHUB_HANDLER" ]]; then
+    log "Delegating GitHub auto-create to existing handler"
+    bash "$GITHUB_HANDLER" "$INC_ID" &
+    GH_PID=$!
+  else
+    log "GitHub handler not found: $GITHUB_HANDLER"
+  fi
+fi
+
+# ============================================================================
+# JIRA/ADO: Call TypeScript module for per-user-story creation
+# ============================================================================
+
+if [[ "$JIRA_ENABLED" == "true" || "$ADO_ENABLED" == "true" ]]; then
+  command -v node &>/dev/null || { log "Node.js not found. Skipping JIRA/ADO."; exit 0; }
+
+  CREATE_MODULE="$PROJECT_ROOT/dist/src/core/universal-auto-create.js"
+  if [[ ! -f "$CREATE_MODULE" ]]; then
+    log "Module not found at $CREATE_MODULE. Skipping JIRA/ADO."
+  else
+    # Build config JSON for the TypeScript module
+    JIRA_DOMAIN=$(jq -r '.sync.jira.domain // .issueTracker.domain // ""' "$CONFIG_PATH" 2>/dev/null)
+    JIRA_PROJECT_KEY=$(jq -r '.sync.jira.projectKey // .issueTracker.projects[0].key // ""' "$CONFIG_PATH" 2>/dev/null)
+    ADO_ORG=$(jq -r '.sync.ado.organization // .issueTracker.organization_ado // ""' "$CONFIG_PATH" 2>/dev/null)
+    ADO_PROJECT=$(jq -r '.sync.ado.project // .issueTracker.project // ""' "$CONFIG_PATH" 2>/dev/null)
+
+    OUTPUT=$(node --input-type=module -e "
+import { createExternalIssuesForIncrement } from '${CREATE_MODULE}';
+
+const config = {
+  sync: {
+    jira: { enabled: ${JIRA_ENABLED} },
+    ado: { enabled: ${ADO_ENABLED} },
+  },
+  jira: { domain: '${JIRA_DOMAIN}', projectKey: '${JIRA_PROJECT_KEY}' },
+  ado: { organization: '${ADO_ORG}', project: '${ADO_PROJECT}' },
+};
+
+try {
+  const result = await createExternalIssuesForIncrement(
+    '${INC_ID}', '${SPEC_PATH}', '${METADATA_PATH}', config,
+  );
+  console.log(JSON.stringify(result, null, 2));
+} catch (err) {
+  console.error('Universal auto-create error:', err.message || err);
+  process.exit(1);
+}
+" 2>&1)
+    EXIT_CODE=$?
+
+    if [[ $EXIT_CODE -ne 0 ]]; then
+      log "JIRA/ADO creation failed (exit $EXIT_CODE): $OUTPUT"
+    else
+      log "JIRA/ADO creation completed: $OUTPUT"
+    fi
+  fi
+fi
+
+# Wait for GitHub handler if started
+if [[ -n "${GH_PID:-}" ]]; then
+  wait "$GH_PID" 2>/dev/null || true
+fi
+
+log "Universal auto-create finished for $INC_ID"
+exit 0

package/plugins/specweave/lib/hooks/sync-living-docs.js

@@ -27,10 +27,12 @@ async function syncLivingDocs(incrementId) {
       console.error("   To fix: Check .specweave/config.json for syntax errors");
       config = { sync: { settings: {} } };
     }
-    const syncEnabled = config.hooks?.post_task_completion?.sync_living_docs ?? false;
+    const syncEnabled = config.hooks?.post_increment_done?.sync_living_docs
+      ?? config.hooks?.post_task_completion?.sync_living_docs // legacy fallback
+      ?? false;
     if (!syncEnabled) {
       console.log("\u2139\uFE0F  Living docs sync disabled in config");
-      console.log("   To enable: Set hooks.post_task_completion.sync_living_docs = true");
+      console.log("   To enable: Set hooks.post_increment_done.sync_living_docs = true");
       return;
     }
     console.log("\u2705 Living docs sync enabled");

package/plugins/specweave/scripts/skill-context.sh

@@ -0,0 +1,160 @@
+#!/bin/sh
+# skill-context.sh — Project context loader for DCI blocks
+#
+# Usage: .specweave/scripts/skill-context.sh [skill-name]
+# Output: Key-value pairs grouped by section ([config], [project], [increment])
+# Exit: Always 0 (graceful degradation)
+#
+# Performance: <100ms target. Single jq call for config, grep for metadata.
+# Skill name argument is reserved for future skill-specific filtering.
+
+CONFIG=".specweave/config.json"
+HAS_JQ=false
+command -v jq >/dev/null 2>&1 && HAS_JQ=true
+
+# --- Parse all config values in ONE jq call ---
+# ASSUMPTION: No config value contains literal '|' (pipe).
+# If this changes, switch to per-field jq calls (~120ms slower).
+_test_mode="" _test_enforce="" _deep_interview="" _auto_max=""
+_multi_project="" _org=""
+
+if [ -f "$CONFIG" ]; then
+  if $HAS_JQ; then
+    _raw=$(jq -r '
+      def v: if . == null then "" else tostring end;
+      [
+        (.testing.defaultTestMode | v),
+        (.testing.tddEnforcement | v),
+        (.planning.deepInterview.enabled | v),
+        (.auto.maxRetries | v),
+        (.multiProject.enabled | v),
+        (.sync.github.owner | v)
+      ] | join("|")
+    ' "$CONFIG" 2>/dev/null) || _raw=""
+
+    IFS='|' read -r _test_mode _test_enforce _deep_interview _auto_max _multi_project _org <<EOF
+$_raw
+EOF
+  else
+    # grep fallback (best-effort, no jq available)
+    # sed strips key prefix, quotes, and whitespace to extract raw value
+    _test_mode=$(grep -o '"defaultTestMode"[^,}]*' "$CONFIG" 2>/dev/null | head -1 | sed 's/[^:]*:[[:space:]]*//;s/^"//;s/"$//')
+    _test_enforce=$(grep -o '"tddEnforcement"[^,}]*' "$CONFIG" 2>/dev/null | head -1 | sed 's/[^:]*:[[:space:]]*//;s/^"//;s/"$//')
+    _auto_max=$(grep -o '"maxRetries"[^,}]*' "$CONFIG" 2>/dev/null | head -1 | sed 's/[^:]*:[[:space:]]*//;s/[^0-9]//g')
+    _org=$(grep -o '"owner"[^,}]*' "$CONFIG" 2>/dev/null | head -1 | sed 's/[^:]*:[[:space:]]*//;s/^"//;s/"$//')
+  fi
+fi
+
+# --- [config] section ---
+emit_config() {
+  [ -f "$CONFIG" ] || return 0
+
+  # Only emit header if at least one field has a value
+  [ -n "$_test_mode" ] || [ -n "$_test_enforce" ] || \
+    [ -n "$_deep_interview" ] || [ -n "$_auto_max" ] || return 0
+
+  echo "[config]"
+  [ -n "$_test_mode" ] && echo "testing.mode=$_test_mode"
+  [ -n "$_test_enforce" ] && echo "testing.enforcement=$_test_enforce"
+  [ -n "$_deep_interview" ] && echo "planning.deepInterview=$_deep_interview"
+  [ -n "$_auto_max" ] && echo "auto.maxIterations=$_auto_max"
+
+  return 0
+}
+
+# --- [project] section ---
+emit_project() {
+  tech=""
+
+  # Detect from filesystem markers (builtins only, no subprocesses)
+  [ -f "package.json" ] && tech="${tech}node,"
+  [ -f "tsconfig.json" ] && tech="${tech}typescript,"
+  { [ -f "requirements.txt" ] || [ -f "pyproject.toml" ]; } && tech="${tech}python,"
+  [ -f "go.mod" ] && tech="${tech}go,"
+  [ -f "Cargo.toml" ] && tech="${tech}rust,"
+  { [ -f "pom.xml" ] || [ -f "build.gradle" ]; } && tech="${tech}java,"
+
+  # Shell glob for C# — no subprocess needed
+  _saved="$1"
+  _found_cs=false
+  set -- *.csproj
+  [ -e "$1" ] && _found_cs=true
+  set -- *.sln
+  [ -e "$1" ] && _found_cs=true
+  $_found_cs && tech="${tech}csharp,"
+  set -- "$_saved"
+
+  # Detect React/Next/Vue from package.json (one grep each, fast)
+  if [ -f "package.json" ]; then
+    grep -q '"react"' package.json 2>/dev/null && tech="${tech}react,"
+    grep -q '"next"' package.json 2>/dev/null && tech="${tech}nextjs,"
+    grep -q '"vue"' package.json 2>/dev/null && tech="${tech}vue,"
+  fi
+
+  # Strip trailing comma
+  tech="${tech%,}"
+
+  # Use pre-parsed config values (no extra subprocess)
+  multi="false"
+  [ "$_multi_project" = "true" ] && multi="true"
+
+  [ -z "$tech" ] && [ "$multi" = "false" ] && [ -z "$_org" ] && return 0
+
+  echo "[project]"
+  [ -n "$tech" ] && echo "tech=$tech"
+  echo "multi-repo=$multi"
+  [ -n "$_org" ] && echo "org=$_org"
+
+  return 0
+}
+
+# --- [increment] section ---
+emit_increment() {
+  inc_dir=".specweave/increments"
+  [ -d "$inc_dir" ] || return 0
+
+  # Find active increment. Fast grep pre-filter eliminates non-candidates,
+  # then jq verifies precisely (handles single-line JSON, avoids false
+  # matches on previousStatus). Without jq, grep alone is best-effort.
+  active=""
+  for meta in "$inc_dir"/*/metadata.json; do
+    [ -f "$meta" ] || continue
+    # Fast pre-filter: skip files that don't mention in-progress at all
+    grep -q '"in-progress"' "$meta" 2>/dev/null || continue
+    # Precise check: jq validates the status field specifically
+    if $HAS_JQ; then
+      jq -e '.status == "in-progress"' "$meta" >/dev/null 2>&1 || continue
+    fi
+    active=$(basename "$(dirname "$meta")")
+    break
+  done
+
+  [ -z "$active" ] && return 0
+
+  # Calculate completion from tasks.md
+  completion=""
+  tasks_file="$inc_dir/$active/tasks.md"
+  if [ -f "$tasks_file" ]; then
+    total=$(grep -c '^\- \[' "$tasks_file" 2>/dev/null) || true
+    done_count=$(grep -c '^\- \[x\]' "$tasks_file" 2>/dev/null) || true
+    total=${total:-0}
+    done_count=${done_count:-0}
+    if [ "$total" -gt 0 ] 2>/dev/null; then
+      completion=$((done_count * 100 / total))
+    fi
+  fi
+
+  echo "[increment]"
+  echo "active=$active"
+  echo "status=in-progress"
+  [ -n "$completion" ] && echo "completion=${completion}%"
+
+  return 0
+}
+
+# --- Main ---
+emit_config
+emit_project
+emit_increment
+
+exit 0

package/plugins/specweave/skills/architect/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: System architect for scalable, maintainable technical designs and architectural decisions. Use when designing system architecture, writing ADRs (Architecture Decision Records), or planning microservices and database structures. Covers trade-off analysis, component diagrams, and technology selection.
+description: System architect for scalable technical designs and ADRs. Use for system architecture, microservices, database design, trade-off analysis, component diagrams, tech selection.
 ---
 
 # Architect

package/plugins/specweave/skills/archive-increments/SKILL.md

@@ -22,11 +22,20 @@ Expert at keeping the `.specweave/increments/` folder clean and organized throug
 .specweave/increments/
 ├── 0023-0032 (Active)          ← Last 10 increments
 ├── _archive/                   ← Completed/old increments
-│   ├── 0001-0022              ← Historical increments
-│   └── 0029                   ← Abandoned experiments
-└── _abandoned/                 ← Failed/obsolete increments
+├── _abandoned/                 ← Failed/obsolete increments
+├── _paused/                    ← Paused increments (blocked on dependency)
+└── _backlog/                   ← Planned but not started (future work)
 ```
 
+Only these 4 underscore folders are recognized lifecycle folders. Unknown folders (e.g. `_analysis`, `_temp`) are flagged by `specweave doctor` and auto-cleaned by `specweave update`.
+
+### Auto-Archive Trigger (v1.0.257+)
+
+When `archiving.autoArchiveThreshold` (default: 10) numbered increment directories exist:
+- **Interactive mode**: LLM is prompted to suggest `specweave archive --keep-last 10`
+- **Auto mode**: Archiving runs automatically in the background
+- **Rate-limited**: Once per day to avoid noise
+
 ### Smart Detection Rules
 
 #### Never Archive
@@ -87,6 +96,7 @@ Expert at keeping the `.specweave/increments/` folder clean and organized throug
   "archiving": {
     "keepLast": 10,              // Keep last 10 increments
     "autoArchive": false,        // Manual by default
+    "autoArchiveThreshold": 10,  // Suggest archive when >= 10 increments
     "archiveAfterDays": 60,      // Archive after 60 days
     "preserveActive": true,      // Never archive active
     "archiveCompleted": false    // Manual control