specweave 0.13.5 → 0.13.6

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

@@ -1,211 +1,183 @@
-/**
- * ADO Project Selector with Pagination
- *
- * Features:
- * - Fetches all ADO projects via API
- * - Interactive multi-select with search
- * - Manual project name entry (comma-separated)
- * - Handles large project lists (50+ projects)
- * - Validates project names
- */
-import inquirer from 'inquirer';
-// ============================================================================
-// ADO Project Fetching
-// ============================================================================
-/**
- * Fetch all ADO projects from API
- */
-export async function fetchAllAdoProjects(client) {
-    console.log('🔍 Fetching Azure DevOps projects...');
-    try {
-        const projects = await client.getProjects();
-        console.log(`✅ Found ${projects.length} Azure DevOps projects\n`);
-        return projects;
-    }
-    catch (error) {
-        console.error('❌ Failed to fetch ADO projects:', error.message);
-        throw error;
-    }
+import inquirer from "inquirer";
+async function fetchAllAdoProjects(client) {
+  console.log("\u{1F50D} Fetching Azure DevOps projects...");
+  try {
+    const projects = await client.getProjects();
+    console.log(`\u2705 Found ${projects.length} Azure DevOps projects
+`);
+    return projects;
+  } catch (error) {
+    console.error("\u274C Failed to fetch ADO projects:", error.message);
+    throw error;
+  }
 }
-// ============================================================================
-// Interactive Project Selection
-// ============================================================================
-/**
- * Interactive project selector with search and pagination
- */
-export async function selectAdoProjects(client, options = {}) {
-    const { allowManualEntry = true, allowSelectAll = true, preSelected = [], minSelection = 1, maxSelection, pageSize = 15, } = options;
-    // Fetch all projects
-    const allProjects = await fetchAllAdoProjects(client);
-    if (allProjects.length === 0) {
-        console.log('⚠️  No Azure DevOps projects found');
-        return {
-            selectedNames: [],
-            method: 'interactive',
-        };
-    }
-    // Show project overview
-    console.log('📋 Available Azure DevOps Projects:\n');
-    console.log(`   Total: ${allProjects.length} projects\n`);
-    // Decide selection method
-    const { selectionMethod } = await inquirer.prompt([
+async function selectAdoProjects(client, options = {}) {
+  const {
+    allowManualEntry = true,
+    allowSelectAll = true,
+    preSelected = [],
+    minSelection = 1,
+    maxSelection,
+    pageSize = 15
+  } = options;
+  const allProjects = await fetchAllAdoProjects(client);
+  if (allProjects.length === 0) {
+    console.log("\u26A0\uFE0F  No Azure DevOps projects found");
+    return {
+      selectedNames: [],
+      method: "interactive"
+    };
+  }
+  console.log("\u{1F4CB} Available Azure DevOps Projects:\n");
+  console.log(`   Total: ${allProjects.length} projects
+`);
+  const { selectionMethod } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "selectionMethod",
+      message: "How would you like to select projects?",
+      choices: [
         {
-            type: 'list',
-            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 names)',
-                    value: 'manual',
-                },
-                ...(allowSelectAll
-                    ? [
-                        {
-                            name: `✨ Select all (${allProjects.length} projects)`,
-                            value: 'all',
-                        },
-                    ]
-                    : []),
-            ],
+          name: `\u{1F4CB} Interactive (browse and select from ${allProjects.length} projects)`,
+          value: "interactive"
         },
-    ]);
-    if (selectionMethod === 'all') {
-        return {
-            selectedNames: allProjects.map((p) => p.name),
-            method: 'all',
-        };
-    }
-    if (selectionMethod === 'manual') {
-        return await manualProjectEntry(allProjects, minSelection, maxSelection);
-    }
-    // Interactive selection
-    return await interactiveProjectSelection(allProjects, preSelected, minSelection, maxSelection, pageSize);
-}
-/**
- * Interactive project selection with checkbox
- */
-async function interactiveProjectSelection(allProjects, preSelected, minSelection, maxSelection, pageSize) {
-    console.log('💡 Use <space> to select, <a> to toggle all, <i> to invert\n');
-    const choices = allProjects.map((p) => ({
-        name: formatProjectChoice(p),
-        value: p.name,
-        checked: preSelected.includes(p.name),
-    }));
-    // Add manual entry option at the end
-    choices.push(new inquirer.Separator(), {
-        name: '✏️  Enter project names manually instead',
-        value: '__MANUAL__',
-        checked: false,
-    });
-    const { selectedNames } = await inquirer.prompt([
         {
-            type: 'checkbox',
-            name: 'selectedNames',
-            message: `Select Azure DevOps 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;
-            },
+          name: "\u270F\uFE0F  Manual entry (type project names)",
+          value: "manual"
         },
-    ]);
-    // Check if user chose manual entry
-    if (selectedNames.includes('__MANUAL__')) {
-        return await manualProjectEntry(allProjects, minSelection, maxSelection);
+        ...allowSelectAll ? [
+          {
+            name: `\u2728 Select all (${allProjects.length} projects)`,
+            value: "all"
+          }
+        ] : []
+      ]
     }
-    console.log(`\n✅ Selected ${selectedNames.length} projects: ${selectedNames.join(', ')}\n`);
+  ]);
+  if (selectionMethod === "all") {
     return {
-        selectedNames,
-        method: 'interactive',
+      selectedNames: allProjects.map((p) => p.name),
+      method: "all"
     };
+  }
+  if (selectionMethod === "manual") {
+    return await manualProjectEntry(allProjects, minSelection, maxSelection);
+  }
+  return await interactiveProjectSelection(
+    allProjects,
+    preSelected,
+    minSelection,
+    maxSelection,
+    pageSize
+  );
 }
-/**
- * Manual project name entry (comma-separated)
- */
-async function manualProjectEntry(allProjects, minSelection, maxSelection) {
-    console.log('\n📝 Enter project names manually\n');
-    console.log('💡 Format: Comma-separated project names (e.g., AI Meme Generator,Project 2,Project 3)\n');
-    if (allProjects.length > 0) {
-        console.log('Available project names:');
-        console.log(allProjects
-            .map((p) => p.name)
-            .join(', ')
-            .substring(0, 100) + (allProjects.length > 20 ? '...' : ''));
-        console.log('');
+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.name,
+    checked: preSelected.includes(p.name)
+  }));
+  choices.push(
+    new inquirer.Separator(),
+    {
+      name: "\u270F\uFE0F  Enter project names manually instead",
+      value: "__MANUAL__",
+      checked: false
     }
-    const { manualNames } = await inquirer.prompt([
-        {
-            type: 'input',
-            name: 'manualNames',
-            message: 'Project names:',
-            validate: (input) => {
-                if (!input.trim()) {
-                    return 'Please enter at least one project name';
-                }
-                const names = input
-                    .split(',')
-                    .map((n) => n.trim())
-                    .filter((n) => n.length > 0);
-                if (names.length < minSelection) {
-                    return `Please enter at least ${minSelection} project name(s)`;
-                }
-                if (maxSelection && names.length > maxSelection) {
-                    return `Please enter at most ${maxSelection} project name(s)`;
-                }
-                return true;
-            },
-        },
-    ]);
-    const selectedNames = manualNames
-        .split(',')
-        .map((n) => n.trim())
-        .filter((n) => n.length > 0);
-    // Warn about unknown projects
-    const knownNames = allProjects.map((p) => p.name);
-    const unknownNames = selectedNames.filter((n) => !knownNames.includes(n));
-    if (unknownNames.length > 0) {
-        console.log(`\n⚠️  Unknown project names (will be used anyway): ${unknownNames.join(', ')}`);
-        console.log('   Make sure these projects exist in your Azure DevOps organization.\n');
+  );
+  const { selectedNames } = await inquirer.prompt([
+    {
+      type: "checkbox",
+      name: "selectedNames",
+      message: `Select Azure DevOps 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;
+      }
     }
-    console.log(`✅ Selected ${selectedNames.length} projects: ${selectedNames.join(', ')}\n`);
-    return {
-        selectedNames,
-        method: 'manual',
-    };
+  ]);
+  if (selectedNames.includes("__MANUAL__")) {
+    return await manualProjectEntry(allProjects, minSelection, maxSelection);
+  }
+  console.log(`
+\u2705 Selected ${selectedNames.length} projects: ${selectedNames.join(", ")}
+`);
+  return {
+    selectedNames,
+    method: "interactive"
+  };
+}
+async function manualProjectEntry(allProjects, minSelection, maxSelection) {
+  console.log("\n\u{1F4DD} Enter project names manually\n");
+  console.log("\u{1F4A1} Format: Comma-separated project names (e.g., AI Meme Generator,Project 2,Project 3)\n");
+  if (allProjects.length > 0) {
+    console.log("Available project names:");
+    console.log(
+      allProjects.map((p) => p.name).join(", ").substring(0, 100) + (allProjects.length > 20 ? "..." : "")
+    );
+    console.log("");
+  }
+  const { manualNames } = await inquirer.prompt([
+    {
+      type: "input",
+      name: "manualNames",
+      message: "Project names:",
+      validate: (input) => {
+        if (!input.trim()) {
+          return "Please enter at least one project name";
+        }
+        const names = input.split(",").map((n) => n.trim()).filter((n) => n.length > 0);
+        if (names.length < minSelection) {
+          return `Please enter at least ${minSelection} project name(s)`;
+        }
+        if (maxSelection && names.length > maxSelection) {
+          return `Please enter at most ${maxSelection} project name(s)`;
+        }
+        return true;
+      }
+    }
+  ]);
+  const selectedNames = manualNames.split(",").map((n) => n.trim()).filter((n) => n.length > 0);
+  const knownNames = allProjects.map((p) => p.name);
+  const unknownNames = selectedNames.filter((n) => !knownNames.includes(n));
+  if (unknownNames.length > 0) {
+    console.log(`
+\u26A0\uFE0F  Unknown project names (will be used anyway): ${unknownNames.join(", ")}`);
+    console.log("   Make sure these projects exist in your Azure DevOps organization.\n");
+  }
+  console.log(`\u2705 Selected ${selectedNames.length} projects: ${selectedNames.join(", ")}
+`);
+  return {
+    selectedNames,
+    method: "manual"
+  };
 }
-// ============================================================================
-// Helpers
-// ============================================================================
-/**
- * Format project choice for display
- */
 function formatProjectChoice(project) {
-    const visibility = project.visibility || 'private';
-    const state = project.state || 'wellFormed';
-    return `${project.name.padEnd(30)} - ${project.description || 'No description'} (${visibility}, ${state})`;
+  const visibility = project.visibility || "private";
+  const state = project.state || "wellFormed";
+  return `${project.name.padEnd(30)} - ${project.description || "No description"} (${visibility}, ${state})`;
 }
-/**
- * Quick project selector - select single project
- */
-export async function selectSingleAdoProject(client, message = 'Select Azure DevOps project:') {
-    const result = await selectAdoProjects(client, {
-        allowManualEntry: true,
-        allowSelectAll: false,
-        minSelection: 1,
-        maxSelection: 1,
-    });
-    return result.selectedNames[0];
+async function selectSingleAdoProject(client, message = "Select Azure DevOps project:") {
+  const result = await selectAdoProjects(client, {
+    allowManualEntry: true,
+    allowSelectAll: false,
+    minSelection: 1,
+    maxSelection: 1
+  });
+  return result.selectedNames[0];
 }
-//# sourceMappingURL=project-selector.js.map
+export {
+  fetchAllAdoProjects,
+  selectAdoProjects,
+  selectSingleAdoProject
+};

package/plugins/specweave-github/hooks/hooks.json

@@ -10,6 +10,17 @@
           }
         ]
       }
+    ],
+    "PostSlashCommand": [
+      {
+        "matcher": "specweave:specweave-done",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-increment-done.sh"
+          }
+        ]
+      }
     ]
   }
 }

package/plugins/specweave-github/hooks/post-increment-done.sh

@@ -0,0 +1,224 @@
+#!/bin/bash
+# Post-Increment-Done Hook - GitHub Plugin
+#
+# Purpose: Automatically syncs living docs spec to GitHub Project when increment closes
+#
+# Triggered by: /specweave:done command completion
+# Event: PostSlashCommand (commandName: "specweave:done")
+#
+# Flow:
+# 1. Increment closes → PM validates
+# 2. Hook fires automatically
+# 3. Syncs living docs spec to GitHub Project
+# 4. Closes GitHub Issue (if exists)
+#
+# Configuration (.specweave/config.json):
+#   "hooks": {
+#     "post_increment_done": {
+#       "sync_to_github_project": true,
+#       "close_github_issue": true,
+#       "update_living_docs_first": true
+#     }
+#   }
+
+set -e
+
+# ============================================================================
+# Configuration & Logging
+# ============================================================================
+
+INCREMENT_ID="$1"
+HOOK_NAME="post-increment-done"
+LOG_DIR=".specweave/logs"
+LOG_FILE="${LOG_DIR}/hooks-debug.log"
+CONFIG_FILE=".specweave/config.json"
+
+# Ensure log directory exists
+mkdir -p "${LOG_DIR}"
+
+# Logging function
+log() {
+  local level="$1"
+  shift
+  local message="$*"
+  local timestamp
+  timestamp=$(date '+%Y-%m-%d %H:%M:%S')
+  echo "[${timestamp}] [${HOOK_NAME}] [${level}] ${message}" | tee -a "${LOG_FILE}"
+}
+
+log "INFO" "=========================================="
+log "INFO" "Post-Increment-Done Hook Started"
+log "INFO" "Increment: ${INCREMENT_ID}"
+log "INFO" "=========================================="
+
+# ============================================================================
+# Validation & Configuration
+# ============================================================================
+
+# Check if increment ID provided
+if [ -z "$INCREMENT_ID" ]; then
+  log "ERROR" "No increment ID provided to hook"
+  exit 0
+fi
+
+# Normalize increment ID to 4-digit format
+# First strip leading zeros to avoid octal interpretation (0019 → 19)
+INCREMENT_ID_NUM=$(echo "$INCREMENT_ID" | sed 's/^0*//')
+# Then normalize to 4-digit format (19 → 0019)
+INCREMENT_ID=$(printf "%04d" "$INCREMENT_ID_NUM" 2>/dev/null || echo "$INCREMENT_ID")
+
+# Find increment directory (format: 0019-name or 0019)
+INCREMENT_DIR=$(find .specweave/increments/ -maxdepth 1 -type d -name "${INCREMENT_ID}*" | head -1)
+
+if [ -z "$INCREMENT_DIR" ] || [ ! -d "$INCREMENT_DIR" ]; then
+  log "WARN" "Increment directory not found for ID: ${INCREMENT_ID}"
+  exit 0
+fi
+
+log "INFO" "Found increment directory: ${INCREMENT_DIR}"
+
+# Read configuration
+if [ ! -f "$CONFIG_FILE" ]; then
+  log "WARN" "Config file not found: ${CONFIG_FILE}"
+  exit 0
+fi
+
+# Check if GitHub Project sync is enabled
+SYNC_ENABLED=$(node -pe "
+  try {
+    const config = require('./${CONFIG_FILE}');
+    config.hooks?.post_increment_done?.sync_to_github_project || false;
+  } catch (e) {
+    false;
+  }
+" 2>/dev/null || echo "false")
+
+log "INFO" "GitHub Project sync enabled: ${SYNC_ENABLED}"
+
+if [ "$SYNC_ENABLED" != "true" ]; then
+  log "INFO" "GitHub Project sync disabled, skipping"
+  exit 0
+fi
+
+# Check if GitHub CLI is available
+if ! command -v gh &> /dev/null; then
+  log "WARN" "GitHub CLI (gh) not found, skipping sync"
+  exit 0
+fi
+
+# Check if gh is authenticated
+if ! gh auth status &> /dev/null; then
+  log "WARN" "GitHub CLI not authenticated, skipping sync"
+  exit 0
+fi
+
+# ============================================================================
+# Find Living Docs Spec
+# ============================================================================
+
+log "INFO" "Finding living docs spec for increment ${INCREMENT_ID}..."
+
+# Pattern 1: spec-NNNN-name.md (e.g., spec-0018-strict-increment-discipline.md)
+SPEC_FILE=$(find .specweave/docs/internal/specs/ -name "spec-${INCREMENT_ID}*.md" 2>/dev/null | head -1)
+
+# Pattern 2: spec-NNN-name.md (e.g., spec-018-strict-increment-discipline.md)
+if [ -z "$SPEC_FILE" ]; then
+  INCREMENT_ID_3DIGIT=$(printf "%03d" "$INCREMENT_ID" 2>/dev/null || echo "$INCREMENT_ID")
+  SPEC_FILE=$(find .specweave/docs/internal/specs/ -name "spec-${INCREMENT_ID_3DIGIT}*.md" 2>/dev/null | head -1)
+fi
+
+# Pattern 3: Check increment spec.md for living docs reference
+if [ -z "$SPEC_FILE" ] && [ -f "${INCREMENT_DIR}/spec.md" ]; then
+  log "INFO" "Checking increment spec.md for living docs reference..."
+  SPEC_REFERENCE=$(grep -E "Living Docs:.*spec-[0-9]+" "${INCREMENT_DIR}/spec.md" | grep -oE "spec-[0-9]+-[a-z-]+" | head -1)
+  if [ -n "$SPEC_REFERENCE" ]; then
+    SPEC_FILE=$(find .specweave/docs/internal/specs/ -name "${SPEC_REFERENCE}.md" 2>/dev/null | head -1)
+  fi
+fi
+
+if [ -z "$SPEC_FILE" ]; then
+  log "WARN" "No living docs spec found for increment ${INCREMENT_ID}"
+  log "INFO" "This is OK for bug/hotfix increments that don't create new specs"
+  exit 0
+fi
+
+log "INFO" "Found living docs spec: ${SPEC_FILE}"
+
+# ============================================================================
+# Sync to GitHub Project
+# ============================================================================
+
+log "INFO" "🔄 Syncing living docs spec to GitHub Project..."
+
+# Extract spec ID from filename (e.g., spec-018-name.md → 018)
+SPEC_ID=$(basename "$SPEC_FILE" | grep -oE "spec-[0-9]+" | grep -oE "[0-9]+")
+
+log "INFO" "Spec ID: ${SPEC_ID}"
+
+# Call the sync-spec command
+# NOTE: This assumes /specweave-github:sync-spec command exists
+# If not implemented yet, this will gracefully fail
+if npx specweave sync-spec "$SPEC_FILE" >> "${LOG_FILE}" 2>&1; then
+  log "INFO" "✅ GitHub Project synced successfully"
+else
+  log "WARN" "Failed to sync to GitHub Project (command may not exist yet)"
+  log "INFO" "Manual sync: /specweave-github:sync-spec ${SPEC_FILE}"
+fi
+
+# ============================================================================
+# Close GitHub Issue (Optional)
+# ============================================================================
+
+CLOSE_ISSUE=$(node -pe "
+  try {
+    const config = require('./${CONFIG_FILE}');
+    config.hooks?.post_increment_done?.close_github_issue || false;
+  } catch (e) {
+    false;
+  }
+" 2>/dev/null || echo "false")
+
+log "INFO" "Close GitHub issue enabled: ${CLOSE_ISSUE}"
+
+if [ "$CLOSE_ISSUE" = "true" ]; then
+  # Check if increment has GitHub issue metadata
+  METADATA_FILE="${INCREMENT_DIR}/.metadata.json"
+
+  if [ -f "$METADATA_FILE" ]; then
+    ISSUE_NUMBER=$(node -pe "
+      try {
+        const metadata = require('./${METADATA_FILE}');
+        metadata.github?.issue || '';
+      } catch (e) {
+        '';
+      }
+    " 2>/dev/null || echo "")
+
+    if [ -n "$ISSUE_NUMBER" ]; then
+      log "INFO" "Closing GitHub issue #${ISSUE_NUMBER}..."
+
+      # Close issue via gh CLI
+      if gh issue close "$ISSUE_NUMBER" --comment "✅ Increment ${INCREMENT_ID} completed and closed" >> "${LOG_FILE}" 2>&1; then
+        log "INFO" "✅ GitHub issue #${ISSUE_NUMBER} closed"
+      else
+        log "WARN" "Failed to close GitHub issue #${ISSUE_NUMBER}"
+      fi
+    else
+      log "INFO" "No GitHub issue found in metadata"
+    fi
+  else
+    log "INFO" "No metadata file found: ${METADATA_FILE}"
+  fi
+fi
+
+# ============================================================================
+# Completion
+# ============================================================================
+
+log "INFO" "=========================================="
+log "INFO" "Post-Increment-Done Hook Completed"
+log "INFO" "Increment: ${INCREMENT_ID}"
+log "INFO" "Spec: ${SPEC_FILE}"
+log "INFO" "=========================================="
+
+exit 0

package/plugins/specweave-github/lib/cli-sync-increment-changes.js

@@ -1,28 +1,17 @@
 #!/usr/bin/env node
-/**
- * CLI wrapper for syncing increment changes to GitHub
- *
- * Usage:
- *   node dist/plugins/specweave-github/lib/cli-sync-increment-changes.js <incrementId> <changedFile>
- *
- * Example:
- *   node dist/plugins/specweave-github/lib/cli-sync-increment-changes.js 0015-hierarchical-sync spec.md
- */
-import { syncIncrementChanges } from './github-sync-increment-changes.js';
+import { syncIncrementChanges } from "./github-sync-increment-changes.js";
 const incrementId = process.argv[2];
 const changedFile = process.argv[3];
 if (!incrementId || !changedFile) {
-    console.error('❌ Usage: cli-sync-increment-changes <incrementId> <changedFile>');
-    console.error('   Example: cli-sync-increment-changes 0015-hierarchical-sync spec.md');
-    process.exit(1);
+  console.error("\u274C Usage: cli-sync-increment-changes <incrementId> <changedFile>");
+  console.error("   Example: cli-sync-increment-changes 0015-hierarchical-sync spec.md");
+  process.exit(1);
 }
-if (!['spec.md', 'plan.md', 'tasks.md'].includes(changedFile)) {
-    console.error(`❌ Invalid file: ${changedFile}`);
-    console.error('   Must be one of: spec.md, plan.md, tasks.md');
-    process.exit(1);
+if (!["spec.md", "plan.md", "tasks.md"].includes(changedFile)) {
+  console.error(`\u274C Invalid file: ${changedFile}`);
+  console.error("   Must be one of: spec.md, plan.md, tasks.md");
+  process.exit(1);
 }
 syncIncrementChanges(incrementId, changedFile).catch((error) => {
-    console.error('❌ Fatal error:', error);
-    // Don't exit with error code - best-effort sync
+  console.error("\u274C Fatal error:", error);
 });
-//# sourceMappingURL=cli-sync-increment-changes.js.map