specweave 0.26.14 → 0.27.0

package/plugins/specweave-jira/hooks/post-task-completion.sh.backup

@@ -0,0 +1,172 @@
+#!/bin/bash
+
+# SpecWeave JIRA Sync Hook
+# Runs after task completion to sync progress to JIRA Issues
+#
+# This hook is part of the specweave-jira plugin and handles:
+# - Syncing task completion state to JIRA issues
+# - Updating JIRA issue status based on increment progress
+#
+# Dependencies:
+# - Node.js for running sync scripts
+# - jq for JSON parsing
+# - metadata.json must have .jira.issue field
+# - JIRA API credentials in .env
+
+set -e
+
+# ============================================================================
+# PROJECT ROOT DETECTION
+# ============================================================================
+
+# Find project root by searching upward for .specweave/ directory
+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" 2>/dev/null || true
+
+# ============================================================================
+# CONFIGURATION
+# ============================================================================
+
+LOGS_DIR=".specweave/logs"
+DEBUG_LOG="$LOGS_DIR/hooks-debug.log"
+
+mkdir -p "$LOGS_DIR" 2>/dev/null || true
+
+# ============================================================================
+# PRECONDITIONS CHECK
+# ============================================================================
+
+echo "[$(date)] [JIRA] 🔗 JIRA sync hook fired" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Detect current increment
+CURRENT_INCREMENT=$(ls -td .specweave/increments/*/ 2>/dev/null | xargs -n1 basename | grep -v "_backlog" | grep -v "_archive" | grep -v "_working" | head -1)
+
+if [ -z "$CURRENT_INCREMENT" ]; then
+  echo "[$(date)] [JIRA] ℹ️  No active increment, skipping JIRA sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check for metadata.json
+METADATA_FILE=".specweave/increments/$CURRENT_INCREMENT/metadata.json"
+
+if [ ! -f "$METADATA_FILE" ]; then
+  echo "[$(date)] [JIRA] ℹ️  No metadata.json for $CURRENT_INCREMENT, skipping JIRA sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check for JIRA issue link
+if ! command -v jq &> /dev/null; then
+  echo "[$(date)] [JIRA] ⚠️  jq not found, skipping JIRA sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+JIRA_ISSUE=$(jq -r '.jira.issue // empty' "$METADATA_FILE" 2>/dev/null)
+
+if [ -z "$JIRA_ISSUE" ]; then
+  echo "[$(date)] [JIRA] ℹ️  No JIRA issue linked to $CURRENT_INCREMENT, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check for Node.js
+if ! command -v node &> /dev/null; then
+  echo "[$(date)] [JIRA] ⚠️  Node.js not found, skipping JIRA sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check for JIRA sync script
+if [ ! -f "dist/commands/jira-sync.js" ]; then
+  echo "[$(date)] [JIRA] ⚠️  jira-sync.js not found, skipping JIRA sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# ============================================================================
+# JIRA SYNC LOGIC
+# ============================================================================
+
+echo "[$(date)] [JIRA] 🔄 Syncing to JIRA issue $JIRA_ISSUE" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Run JIRA sync command (non-blocking)
+node dist/commands/jira-sync.js "$CURRENT_INCREMENT" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+  echo "[$(date)] [JIRA] ⚠️  Failed to sync to JIRA (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+}
+
+echo "[$(date)] [JIRA] ✅ JIRA sync complete" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# ============================================================================
+# SPEC COMMIT SYNC (NEW!)
+# ============================================================================
+
+echo "[$(date)] [JIRA] 🔗 Checking for spec commit sync..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Call TypeScript CLI to sync commits
+if command -v node &> /dev/null && [ -f "$PROJECT_ROOT/dist/cli/commands/sync-spec-commits.js" ]; then
+  echo "[$(date)] [JIRA] 🚀 Running spec commit sync..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+  node "$PROJECT_ROOT/dist/cli/commands/sync-spec-commits.js" \
+    --increment "$PROJECT_ROOT/.specweave/increments/$CURRENT_INCREMENT" \
+    --provider jira \
+    2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+      echo "[$(date)] [JIRA] ⚠️  Spec commit sync failed (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+    }
+
+  echo "[$(date)] [JIRA] ✅ Spec commit sync complete" >> "$DEBUG_LOG" 2>/dev/null || true
+else
+  echo "[$(date)] [JIRA] ℹ️  Spec commit sync not available (node or script not found)" >> "$DEBUG_LOG" 2>/dev/null || true
+fi
+
+# ============================================================================
+# OUTPUT TO CLAUDE
+# ============================================================================
+
+cat <<EOF
+{
+  "continue": true
+}
+EOF

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

@@ -1,6 +1,6 @@
-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 { 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 * as path from "path";
 import * as fs from "fs/promises";
 async function syncSpecToJiraWithEnhancedContent(options) {

package/plugins/specweave-jira/lib/project-selector.js

@@ -1,4 +1,4 @@
-import inquirer from "inquirer";
+import { select, checkbox, input, Separator } from "@inquirer/prompts";
 async function fetchAllJiraProjects(client) {
   console.log("\u{1F50D} Fetching Jira projects...");
   try {
@@ -31,29 +31,25 @@ async function selectJiraProjects(client, options = {}) {
   console.log("\u{1F4CB} Available Jira Projects:\n");
   console.log(`   Total: ${allProjects.length} projects
 `);
-  const { selectionMethod } = await inquirer.prompt([
-    {
-      type: "select",
-      name: "selectionMethod",
-      message: "How would you like to select projects?",
-      choices: [
-        {
-          name: `\u{1F4CB} Interactive (browse and select from ${allProjects.length} projects)`,
-          value: "interactive"
-        },
+  const selectionMethod = await select({
+    message: "How would you like to select projects?",
+    choices: [
+      {
+        name: `\u{1F4CB} Interactive (browse and select from ${allProjects.length} projects)`,
+        value: "interactive"
+      },
+      {
+        name: "\u270F\uFE0F  Manual entry (type project keys)",
+        value: "manual"
+      },
+      ...allowSelectAll ? [
         {
-          name: "\u270F\uFE0F  Manual entry (type project keys)",
-          value: "manual"
-        },
-        ...allowSelectAll ? [
-          {
-            name: `\u2728 Select all (${allProjects.length} projects)`,
-            value: "all"
-          }
-        ] : []
-      ]
-    }
-  ]);
+          name: `\u2728 Select all (${allProjects.length} projects)`,
+          value: "all"
+        }
+      ] : []
+    ]
+  });
   if (selectionMethod === "all") {
     return {
       selectedKeys: allProjects.map((p) => p.key),
@@ -73,39 +69,36 @@ async function selectJiraProjects(client, options = {}) {
 }
 async function interactiveProjectSelection(allProjects, preSelected, minSelection, maxSelection, pageSize) {
   console.log("\u{1F4A1} Use <space> to select, <a> to toggle all, <i> to invert\n");
-  const choices = allProjects.map((p) => ({
-    name: formatProjectChoice(p),
-    value: p.key,
-    checked: preSelected.includes(p.key)
-  }));
-  choices.push(
-    new inquirer.Separator(),
+  const choices = [
+    ...allProjects.map((p) => ({
+      name: formatProjectChoice(p),
+      value: p.key,
+      checked: preSelected.includes(p.key)
+    })),
+    // Add separator and manual entry option at the end
+    new Separator(),
     {
       name: "\u270F\uFE0F  Enter project keys manually instead",
       value: "__MANUAL__",
       checked: false
     }
-  );
-  const { selectedKeys } = await inquirer.prompt([
-    {
-      type: "checkbox",
-      name: "selectedKeys",
-      message: `Select Jira projects (${minSelection}${maxSelection ? `-${maxSelection}` : "+"} required):`,
-      choices,
-      pageSize,
-      loop: false,
-      validate: (selected) => {
-        const actualSelected = selected.filter((k) => k !== "__MANUAL__");
-        if (actualSelected.length < minSelection) {
-          return `Please select at least ${minSelection} project(s)`;
-        }
-        if (maxSelection && actualSelected.length > maxSelection) {
-          return `Please select at most ${maxSelection} project(s)`;
-        }
-        return true;
+  ];
+  const selectedKeys = await checkbox({
+    message: `Select Jira projects (${minSelection}${maxSelection ? `-${maxSelection}` : "+"} required):`,
+    choices,
+    pageSize,
+    loop: false,
+    validate: (selected) => {
+      const actualSelected = selected.filter((k) => k !== "__MANUAL__");
+      if (actualSelected.length < minSelection) {
+        return `Please select at least ${minSelection} project(s)`;
+      }
+      if (maxSelection && actualSelected.length > maxSelection) {
+        return `Please select at most ${maxSelection} project(s)`;
       }
+      return true;
     }
-  ]);
+  });
   if (selectedKeys.includes("__MANUAL__")) {
     return await manualProjectEntry(allProjects, minSelection, maxSelection);
   }
@@ -127,30 +120,26 @@ async function manualProjectEntry(allProjects, minSelection, maxSelection) {
     );
     console.log("");
   }
-  const { manualKeys } = await inquirer.prompt([
-    {
-      type: "input",
-      name: "manualKeys",
-      message: "Project keys:",
-      validate: (input) => {
-        if (!input.trim()) {
-          return "Please enter at least one project key";
-        }
-        const keys = input.split(",").map((k) => k.trim().toUpperCase()).filter((k) => k.length > 0);
-        if (keys.length < minSelection) {
-          return `Please enter at least ${minSelection} project key(s)`;
-        }
-        if (maxSelection && keys.length > maxSelection) {
-          return `Please enter at most ${maxSelection} project key(s)`;
-        }
-        const invalidKeys = keys.filter((k) => !/^[A-Z0-9]+$/.test(k));
-        if (invalidKeys.length > 0) {
-          return `Invalid project key format: ${invalidKeys.join(", ")}. Use uppercase letters/numbers only.`;
-        }
-        return true;
+  const manualKeys = await input({
+    message: "Project keys:",
+    validate: (inputValue) => {
+      if (!inputValue.trim()) {
+        return "Please enter at least one project key";
+      }
+      const keys = inputValue.split(",").map((k) => k.trim().toUpperCase()).filter((k) => k.length > 0);
+      if (keys.length < minSelection) {
+        return `Please enter at least ${minSelection} project key(s)`;
+      }
+      if (maxSelection && keys.length > maxSelection) {
+        return `Please enter at most ${maxSelection} project key(s)`;
       }
+      const invalidKeys = keys.filter((k) => !/^[A-Z0-9]+$/.test(k));
+      if (invalidKeys.length > 0) {
+        return `Invalid project key format: ${invalidKeys.join(", ")}. Use uppercase letters/numbers only.`;
+      }
+      return true;
     }
-  ]);
+  });
   const selectedKeys = manualKeys.split(",").map((k) => k.trim().toUpperCase()).filter((k) => k.length > 0);
   const knownKeys = allProjects.map((p) => p.key);
   const unknownKeys = selectedKeys.filter((k) => !knownKeys.includes(k));

package/plugins/specweave-jira/lib/project-selector.ts

@@ -9,7 +9,7 @@
  * - Validates project keys
  */
 
-import inquirer from 'inquirer';
+import { select, checkbox, input, Separator } from '@inquirer/prompts';
 import { JiraClient } from '../../../src/integrations/jira/jira-client.js';
 
 // ============================================================================
@@ -101,31 +101,27 @@ export async function selectJiraProjects(
   console.log(`   Total: ${allProjects.length} projects\n`);
 
   // Decide selection method
-  const { selectionMethod } = await inquirer.prompt([
-    {
-      type: 'select',
-      name: 'selectionMethod',
-      message: 'How would you like to select projects?',
-      choices: [
-        {
-          name: `📋 Interactive (browse and select from ${allProjects.length} projects)`,
-          value: 'interactive',
-        },
-        {
-          name: '✏️  Manual entry (type project keys)',
-          value: 'manual',
-        },
-        ...(allowSelectAll
-          ? [
-              {
-                name: `✨ Select all (${allProjects.length} projects)`,
-                value: 'all',
-              },
-            ]
-          : []),
-      ],
-    },
-  ]);
+  const selectionMethod = await select({
+    message: 'How would you like to select projects?',
+    choices: [
+      {
+        name: `📋 Interactive (browse and select from ${allProjects.length} projects)`,
+        value: 'interactive' as const,
+      },
+      {
+        name: '✏️  Manual entry (type project keys)',
+        value: 'manual' as const,
+      },
+      ...(allowSelectAll
+        ? [
+            {
+              name: `✨ Select all (${allProjects.length} projects)`,
+              value: 'all' as const,
+            },
+          ]
+        : []),
+    ],
+  });
 
   if (selectionMethod === 'all') {
     return {
@@ -160,45 +156,40 @@ async function interactiveProjectSelection(
 ): Promise<ProjectSelectionResult> {
   console.log('💡 Use <space> to select, <a> to toggle all, <i> to invert\n');
 
-  const choices = allProjects.map((p) => ({
-    name: formatProjectChoice(p),
-    value: p.key,
-    checked: preSelected.includes(p.key),
-  }));
-
-  // Add manual entry option at the end
-  choices.push(
-    new inquirer.Separator(),
+  const choices = [
+    ...allProjects.map((p) => ({
+      name: formatProjectChoice(p),
+      value: p.key,
+      checked: preSelected.includes(p.key),
+    })),
+    // Add separator and manual entry option at the end
+    new Separator(),
     {
       name: '✏️  Enter project keys manually instead',
       value: '__MANUAL__',
       checked: false,
-    } as any
-  );
+    },
+  ];
 
-  const { selectedKeys } = await inquirer.prompt([
-    {
-      type: 'checkbox',
-      name: 'selectedKeys',
-      message: `Select Jira projects (${minSelection}${maxSelection ? `-${maxSelection}` : '+'} required):`,
-      choices,
-      pageSize,
-      loop: false,
-      validate: (selected: string[]) => {
-        const actualSelected = selected.filter((k) => k !== '__MANUAL__');
-
-        if (actualSelected.length < minSelection) {
-          return `Please select at least ${minSelection} project(s)`;
-        }
-
-        if (maxSelection && actualSelected.length > maxSelection) {
-          return `Please select at most ${maxSelection} project(s)`;
-        }
-
-        return true;
-      },
+  const selectedKeys = await checkbox({
+    message: `Select Jira projects (${minSelection}${maxSelection ? `-${maxSelection}` : '+'} required):`,
+    choices,
+    pageSize,
+    loop: false,
+    validate: (selected: readonly string[]) => {
+      const actualSelected = selected.filter((k) => k !== '__MANUAL__');
+
+      if (actualSelected.length < minSelection) {
+        return `Please select at least ${minSelection} project(s)`;
+      }
+
+      if (maxSelection && actualSelected.length > maxSelection) {
+        return `Please select at most ${maxSelection} project(s)`;
+      }
+
+      return true;
     },
-  ]);
+  });
 
   // Check if user chose manual entry
   if (selectedKeys.includes('__MANUAL__')) {
@@ -235,39 +226,35 @@ async function manualProjectEntry(
     console.log('');
   }
 
-  const { manualKeys } = await inquirer.prompt([
-    {
-      type: 'input',
-      name: 'manualKeys',
-      message: 'Project keys:',
-      validate: (input: string) => {
-        if (!input.trim()) {
-          return 'Please enter at least one project key';
-        }
-
-        const keys = input
-          .split(',')
-          .map((k) => k.trim().toUpperCase())
-          .filter((k) => k.length > 0);
-
-        if (keys.length < minSelection) {
-          return `Please enter at least ${minSelection} project key(s)`;
-        }
-
-        if (maxSelection && keys.length > maxSelection) {
-          return `Please enter at most ${maxSelection} project key(s)`;
-        }
-
-        // Validate format (uppercase letters/numbers only)
-        const invalidKeys = keys.filter((k) => !/^[A-Z0-9]+$/.test(k));
-        if (invalidKeys.length > 0) {
-          return `Invalid project key format: ${invalidKeys.join(', ')}. Use uppercase letters/numbers only.`;
-        }
-
-        return true;
-      },
+  const manualKeys = await input({
+    message: 'Project keys:',
+    validate: (inputValue: string) => {
+      if (!inputValue.trim()) {
+        return 'Please enter at least one project key';
+      }
+
+      const keys = inputValue
+        .split(',')
+        .map((k) => k.trim().toUpperCase())
+        .filter((k) => k.length > 0);
+
+      if (keys.length < minSelection) {
+        return `Please enter at least ${minSelection} project key(s)`;
+      }
+
+      if (maxSelection && keys.length > maxSelection) {
+        return `Please enter at most ${maxSelection} project key(s)`;
+      }
+
+      // Validate format (uppercase letters/numbers only)
+      const invalidKeys = keys.filter((k) => !/^[A-Z0-9]+$/.test(k));
+      if (invalidKeys.length > 0) {
+        return `Invalid project key format: ${invalidKeys.join(', ')}. Use uppercase letters/numbers only.`;
+      }
+
+      return true;
     },
-  ]);
+  });
 
   const selectedKeys = manualKeys
     .split(',')