specweave 0.13.5 → 0.14.0

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

package/plugins/specweave-github/lib/github-board-resolver.js

@@ -1,122 +1,76 @@
-/**
- * GitHub Project Board Resolution for Hierarchical Sync
- *
- * Resolves project board names to board IDs for use in search queries.
- * Supports both GitHub Classic Projects (v1) and Projects v2 (beta).
- */
-import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
-/**
- * Fetch all project boards for a GitHub repository
- *
- * Uses GitHub CLI: gh api repos/{owner}/{repo}/projects
- *
- * @param owner Repository owner
- * @param repo Repository name
- * @returns Array of project boards
- */
-export async function fetchBoardsForRepo(owner, repo) {
-    console.log(`🔍 Fetching project boards for repo: ${owner}/${repo}`);
-    try {
-        const result = await execFileNoThrow('gh', [
-            'api',
-            `repos/${owner}/${repo}/projects`,
-            '--jq',
-            '.[] | {id: .id, name: .name, number: .number, state: .state, html_url: .html_url}',
-            '-H',
-            'Accept: application/vnd.github+json',
-        ]);
-        if (result.status !== 0) {
-            console.error(`❌ Failed to fetch boards for ${owner}/${repo}:`, result.stderr);
-            throw new Error(`GitHub API error: ${result.status} ${result.stderr}`);
-        }
-        // Parse JSONL (one JSON object per line)
-        const boards = result.stdout
-            .trim()
-            .split('\n')
-            .filter(line => line.trim())
-            .map(line => JSON.parse(line));
-        console.log(`✅ Found ${boards.length} board(s) for repo ${owner}/${repo}`);
-        return boards;
-    }
-    catch (error) {
-        console.error(`❌ Error fetching boards for ${owner}/${repo}:`, error.message);
-        throw error;
+import { execFileNoThrow } from "../../../src/utils/execFileNoThrow.js";
+async function fetchBoardsForRepo(owner, repo) {
+  console.log(`\u{1F50D} Fetching project boards for repo: ${owner}/${repo}`);
+  try {
+    const result = await execFileNoThrow("gh", [
+      "api",
+      `repos/${owner}/${repo}/projects`,
+      "--jq",
+      ".[] | {id: .id, name: .name, number: .number, state: .state, html_url: .html_url}",
+      "-H",
+      "Accept: application/vnd.github+json"
+    ]);
+    if (result.status !== 0) {
+      console.error(`\u274C Failed to fetch boards for ${owner}/${repo}:`, result.stderr);
+      throw new Error(`GitHub API error: ${result.status} ${result.stderr}`);
     }
+    const boards = result.stdout.trim().split("\n").filter((line) => line.trim()).map((line) => JSON.parse(line));
+    console.log(`\u2705 Found ${boards.length} board(s) for repo ${owner}/${repo}`);
+    return boards;
+  } catch (error) {
+    console.error(`\u274C Error fetching boards for ${owner}/${repo}:`, error.message);
+    throw error;
+  }
 }
-/**
- * Fetch organization-level project boards
- *
- * Uses GitHub CLI: gh api orgs/{org}/projects
- *
- * @param org Organization name
- * @returns Array of organization project boards
- */
-export async function fetchBoardsForOrg(org) {
-    console.log(`🔍 Fetching project boards for org: ${org}`);
-    try {
-        const result = await execFileNoThrow('gh', [
-            'api',
-            `orgs/${org}/projects`,
-            '--jq',
-            '.[] | {id: .id, name: .name, number: .number, state: .state, html_url: .html_url}',
-            '-H',
-            'Accept: application/vnd.github+json',
-        ]);
-        if (result.status !== 0) {
-            console.error(`❌ Failed to fetch boards for org ${org}:`, result.stderr);
-            throw new Error(`GitHub API error: ${result.status} ${result.stderr}`);
-        }
-        // Parse JSONL
-        const boards = result.stdout
-            .trim()
-            .split('\n')
-            .filter(line => line.trim())
-            .map(line => JSON.parse(line));
-        console.log(`✅ Found ${boards.length} board(s) for org ${org}`);
-        return boards;
-    }
-    catch (error) {
-        console.error(`❌ Error fetching boards for org ${org}:`, error.message);
-        throw error;
+async function fetchBoardsForOrg(org) {
+  console.log(`\u{1F50D} Fetching project boards for org: ${org}`);
+  try {
+    const result = await execFileNoThrow("gh", [
+      "api",
+      `orgs/${org}/projects`,
+      "--jq",
+      ".[] | {id: .id, name: .name, number: .number, state: .state, html_url: .html_url}",
+      "-H",
+      "Accept: application/vnd.github+json"
+    ]);
+    if (result.status !== 0) {
+      console.error(`\u274C Failed to fetch boards for org ${org}:`, result.stderr);
+      throw new Error(`GitHub API error: ${result.status} ${result.stderr}`);
     }
+    const boards = result.stdout.trim().split("\n").filter((line) => line.trim()).map((line) => JSON.parse(line));
+    console.log(`\u2705 Found ${boards.length} board(s) for org ${org}`);
+    return boards;
+  } catch (error) {
+    console.error(`\u274C Error fetching boards for org ${org}:`, error.message);
+    throw error;
+  }
 }
-/**
- * Resolve board names to board numbers (for repo-level projects)
- *
- * @param owner Repository owner
- * @param repo Repository name
- * @param boardNames Array of board names to resolve
- * @returns Map of board name → board number
- */
-export async function resolveBoardNames(owner, repo, boardNames) {
-    if (!boardNames || boardNames.length === 0) {
-        return new Map();
-    }
-    const boards = await fetchBoardsForRepo(owner, repo);
-    const boardMap = new Map();
-    for (const boardName of boardNames) {
-        const board = boards.find((b) => b.name.toLowerCase() === boardName.toLowerCase());
-        if (board) {
-            boardMap.set(boardName, board.number);
-            console.log(`✅ Resolved board "${boardName}" → Number ${board.number}`);
-        }
-        else {
-            console.warn(`⚠️  Board "${boardName}" not found in repo ${owner}/${repo}`);
-            // Don't throw - just skip this board (user may have typo or board was deleted)
-        }
+async function resolveBoardNames(owner, repo, boardNames) {
+  if (!boardNames || boardNames.length === 0) {
+    return /* @__PURE__ */ new Map();
+  }
+  const boards = await fetchBoardsForRepo(owner, repo);
+  const boardMap = /* @__PURE__ */ new Map();
+  for (const boardName of boardNames) {
+    const board = boards.find(
+      (b) => b.name.toLowerCase() === boardName.toLowerCase()
+    );
+    if (board) {
+      boardMap.set(boardName, board.number);
+      console.log(`\u2705 Resolved board "${boardName}" \u2192 Number ${board.number}`);
+    } else {
+      console.warn(`\u26A0\uFE0F  Board "${boardName}" not found in repo ${owner}/${repo}`);
     }
-    return boardMap;
+  }
+  return boardMap;
 }
-/**
- * Get board numbers for a list of board names (helper function)
- *
- * @param owner Repository owner
- * @param repo Repository name
- * @param boardNames Array of board names
- * @returns Array of board numbers (skips boards not found)
- */
-export async function getBoardNumbers(owner, repo, boardNames) {
-    const boardMap = await resolveBoardNames(owner, repo, boardNames);
-    return Array.from(boardMap.values());
+async function getBoardNumbers(owner, repo, boardNames) {
+  const boardMap = await resolveBoardNames(owner, repo, boardNames);
+  return Array.from(boardMap.values());
 }
-//# sourceMappingURL=github-board-resolver.js.map
+export {
+  fetchBoardsForOrg,
+  fetchBoardsForRepo,
+  getBoardNumbers,
+  resolveBoardNames
+};