specweave 0.12.6 → 0.13.0

package/plugins/specweave-github/lib/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Type definitions for GitHub sync plugin
+ */
+export interface Task {
+    id: string;
+    title: string;
+    priority: 'P0' | 'P1' | 'P2' | 'P3';
+    estimate: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'blocked';
+    githubIssue?: number;
+    assignee?: string;
+    description: string;
+    subtasks?: Subtask[];
+    filesToCreate?: string[];
+    filesToModify?: string[];
+    implementation?: string;
+    acceptanceCriteria?: string[];
+    dependencies?: string[];
+    blocks?: string[];
+    phase?: string;
+}
+export interface Subtask {
+    id: string;
+    description: string;
+    estimate: string;
+    completed: boolean;
+}
+export interface IncrementMetadata {
+    id: string;
+    title: string;
+    version?: string;
+    priority: 'P0' | 'P1' | 'P2' | 'P3';
+    status: 'planning' | 'in-progress' | 'completed' | 'cancelled';
+    github?: {
+        milestone?: number;
+        epic_issue?: number;
+        task_issues?: Record<string, number>;
+        last_sync?: string;
+    };
+}
+export interface GitHubIssue {
+    number: number;
+    title: string;
+    body: string;
+    state: 'open' | 'closed';
+    html_url: string;
+    labels: string[];
+    milestone?: {
+        number: number;
+        title: string;
+    };
+}
+export interface GitHubMilestone {
+    number: number;
+    title: string;
+    description: string;
+    state: 'open' | 'closed';
+}
+export interface SyncResult {
+    milestone?: GitHubMilestone;
+    epic: GitHubIssue;
+    tasks: Array<{
+        taskId: string;
+        issue: GitHubIssue;
+    }>;
+    errors: Array<{
+        taskId?: string;
+        error: string;
+    }>;
+}
+export interface GitHubSyncOptions {
+    force?: boolean;
+    dryRun?: boolean;
+    batchDelay?: number;
+    batchSize?: number;
+    milestoneDays?: number;
+    projectName?: string;
+    fastMode?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/plugins/specweave-github/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"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"}

package/plugins/specweave-github/lib/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for GitHub sync plugin
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/plugins/specweave-github/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/plugins/specweave-jira/.claude-plugin/plugin.json

@@ -16,5 +16,6 @@
     "sync",
     "specweave",
     "project-management"
-  ]
+  ],
+  "hooks": "hooks/hooks.json"
 }

package/plugins/specweave-jira/hooks/README.md

@@ -0,0 +1,201 @@
+# SpecWeave JIRA Plugin Hooks
+
+**Plugin**: `specweave-jira`
+**Location**: `plugins/specweave-jira/hooks/`
+
+---
+
+## Purpose
+
+This hook automatically syncs SpecWeave increment progress to JIRA Issues after each task completion.
+
+**Key Features**:
+- ✅ Updates JIRA issue status based on increment progress
+- ✅ Syncs task completion state to JIRA
+- ✅ Bidirectional sync (local → JIRA)
+- ✅ Non-blocking (failures don't stop core workflow)
+- ✅ Self-contained (no dependencies on core plugin)
+
+---
+
+## Available Hooks
+
+### 1. `post-task-completion.sh`
+
+**Triggers**: After ANY task is marked complete (via TodoWrite tool)
+
+**Preconditions**:
+- ✅ Active increment exists (`.specweave/increments/####/`)
+- ✅ `metadata.json` has `.jira.issue` field
+- ✅ Node.js installed
+- ✅ JIRA sync script exists (`dist/commands/jira-sync.js`)
+- ✅ JIRA API credentials in `.env`
+
+**Actions**:
+1. Reads increment metadata
+2. Calls JIRA sync script (Node.js)
+3. Updates JIRA issue status
+4. Logs all actions to `.specweave/logs/hooks-debug.log`
+
+**Example Flow**:
+```
+Task T-003 completed in tasks.md
+↓
+Hook fires (PostToolUse + TodoWrite matcher)
+↓
+JIRA sync script updates issue PROJ-123
+↓
+Log: "[JIRA] ✅ JIRA sync complete"
+```
+
+**Dependencies**:
+- Node.js 18+
+- JIRA API credentials (`.env`)
+- `jq` for JSON parsing
+
+---
+
+## Configuration
+
+### Hook Registration (`hooks.json`)
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "TodoWrite",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-task-completion.sh"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Metadata Format
+
+Increments must have `metadata.json` with JIRA issue link:
+
+```json
+{
+  "jira": {
+    "issue": "PROJ-123",
+    "url": "https://company.atlassian.net/browse/PROJ-123",
+    "project": "PROJ"
+  }
+}
+```
+
+### Environment Variables
+
+Required in `.env`:
+
+```bash
+JIRA_HOST=https://company.atlassian.net
+JIRA_EMAIL=user@company.com
+JIRA_API_TOKEN=your_api_token_here
+```
+
+---
+
+## Installation
+
+### Automatic (Recommended)
+
+```bash
+npx specweave init my-project
+# Installs all plugins including specweave-jira
+# Hooks auto-register via hooks.json
+```
+
+### Manual (Development)
+
+```bash
+# Install plugin
+/plugin install specweave-jira
+
+# Verify hook registration
+cat ~/.claude/settings.json | grep specweave-jira
+```
+
+---
+
+## Testing
+
+### Test Hook Independently
+
+```bash
+# Test syntax
+bash -n plugins/specweave-jira/hooks/post-task-completion.sh
+
+# Test execution (requires active increment + JIRA issue)
+./plugins/specweave-jira/hooks/post-task-completion.sh
+```
+
+---
+
+## Logging
+
+All JIRA sync actions are logged to:
+
+```
+.specweave/logs/hooks-debug.log
+```
+
+**Example Log Output**:
+```
+[2025-11-10] [JIRA] 🔗 JIRA sync hook fired
+[2025-11-10] [JIRA] 🔄 Syncing to JIRA issue PROJ-123
+[2025-11-10] [JIRA] ✅ JIRA sync complete
+```
+
+**Log Prefixes**:
+- `[JIRA]` - All messages from this hook
+- `🔗` - Hook fired
+- `🔄` - Syncing started
+- `✅` - Success
+- `⚠️` - Warning (non-blocking failure)
+- `ℹ️` - Info (skipped due to precondition)
+
+---
+
+## Architecture
+
+### Separation from Core Plugin
+
+**Before (v0.12.x)**:
+```
+Core hook (500+ lines)
+├── JIRA sync  ← Embedded in core!
+```
+
+**After (v0.13.0+)**:
+```
+Core hook (330 lines)      JIRA plugin hook (150 lines)
+├── Core concerns          ├── Check for JIRA issue
+                           ├── Call Node.js sync script
+                           └── Log actions
+```
+
+**Key Benefits**:
+- ✅ **Optional plugin**: JIRA sync only runs if `specweave-jira` installed
+- ✅ **Independent testing**: Test JIRA sync in isolation
+- ✅ **No core dependencies**: Core plugin doesn't depend on JIRA API
+
+---
+
+## Related Documentation
+
+- **Core Plugin Hooks**: `plugins/specweave/hooks/README.md`
+- **Architecture Analysis**: `.specweave/increments/0018-strict-increment-discipline-enforcement/reports/HOOKS-ARCHITECTURE-ANALYSIS.md`
+- **JIRA Sync Command**: `plugins/specweave-jira/commands/specweave-jira-sync.md`
+
+---
+
+**Version**: v0.13.0+
+**Last Updated**: 2025-11-10

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

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "TodoWrite",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-task-completion.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

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

@@ -0,0 +1,150 @@
+#!/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 -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | 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
+
+# ============================================================================
+# OUTPUT TO CLAUDE
+# ============================================================================
+
+cat <<EOF
+{
+  "continue": true
+}
+EOF

package/plugins/specweave-jira/lib/jira-board-resolver.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Jira Board Resolution for Hierarchical Sync
+ *
+ * Resolves board names to board IDs for use in JQL queries.
+ * Supports Jira Agile (Software) boards.
+ */
+import { JiraClient } from '../../../src/integrations/jira/jira-client.js';
+/**
+ * Jira Board (Agile API)
+ */
+export interface JiraBoard {
+    id: number;
+    name: string;
+    type: 'scrum' | 'kanban' | 'simple';
+    self: string;
+    location?: {
+        projectId: number;
+        projectKey: string;
+        projectName: string;
+    };
+}
+/**
+ * Fetch all boards for a Jira project
+ *
+ * Uses Jira Agile REST API: GET /rest/agile/1.0/board?projectKeyOrId={projectKey}
+ *
+ * @param client JiraClient instance
+ * @param projectKey Jira project key (e.g., "PROJECT-A")
+ * @returns Array of boards in the project
+ */
+export declare function fetchBoardsForProject(client: JiraClient, projectKey: string): Promise<JiraBoard[]>;
+/**
+ * Resolve board names to board IDs
+ *
+ * @param client JiraClient instance
+ * @param projectKey Jira project key
+ * @param boardNames Array of board names to resolve
+ * @returns Map of board name → board ID
+ */
+export declare function resolveBoardNames(client: JiraClient, projectKey: string, boardNames: string[]): Promise<Map<string, number>>;
+/**
+ * Get board IDs for a list of board names (helper function)
+ *
+ * @param client JiraClient instance
+ * @param projectKey Jira project key
+ * @param boardNames Array of board names
+ * @returns Array of board IDs (skips boards not found)
+ */
+export declare function getBoardIds(client: JiraClient, projectKey: string, boardNames: string[]): Promise<number[]>;
+//# sourceMappingURL=jira-board-resolver.d.ts.map

package/plugins/specweave-jira/lib/jira-board-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-board-resolver.d.ts","sourceRoot":"","sources":["jira-board-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,EAAE,CAAC,CAmCtB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAwB9B;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAGnB"}

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

@@ -0,0 +1,84 @@
+/**
+ * Jira Board Resolution for Hierarchical Sync
+ *
+ * Resolves board names to board IDs for use in JQL queries.
+ * Supports Jira Agile (Software) boards.
+ */
+/**
+ * Fetch all boards for a Jira project
+ *
+ * Uses Jira Agile REST API: GET /rest/agile/1.0/board?projectKeyOrId={projectKey}
+ *
+ * @param client JiraClient instance
+ * @param projectKey Jira project key (e.g., "PROJECT-A")
+ * @returns Array of boards in the project
+ */
+export async function fetchBoardsForProject(client, projectKey) {
+    console.log(`🔍 Fetching boards for project: ${projectKey}`);
+    try {
+        // Access private baseUrl and getAuthHeader via reflection (not ideal but necessary)
+        const baseUrl = client.baseUrl;
+        const authHeader = client.getAuthHeader();
+        const url = `${baseUrl}/rest/agile/1.0/board?projectKeyOrId=${projectKey}`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Authorization': authHeader,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            console.error(`❌ Failed to fetch boards for ${projectKey}:`, error);
+            throw new Error(`Jira API error: ${response.status} ${error}`);
+        }
+        const data = await response.json();
+        const boards = data.values || [];
+        console.log(`✅ Found ${boards.length} board(s) for project ${projectKey}`);
+        return boards;
+    }
+    catch (error) {
+        console.error(`❌ Error fetching boards for ${projectKey}:`, error.message);
+        throw error;
+    }
+}
+/**
+ * Resolve board names to board IDs
+ *
+ * @param client JiraClient instance
+ * @param projectKey Jira project key
+ * @param boardNames Array of board names to resolve
+ * @returns Map of board name → board ID
+ */
+export async function resolveBoardNames(client, projectKey, boardNames) {
+    if (!boardNames || boardNames.length === 0) {
+        return new Map();
+    }
+    const boards = await fetchBoardsForProject(client, projectKey);
+    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.id);
+            console.log(`✅ Resolved board "${boardName}" → ID ${board.id}`);
+        }
+        else {
+            console.warn(`⚠️  Board "${boardName}" not found in project ${projectKey}`);
+            // Don't throw - just skip this board (user may have typo or board was deleted)
+        }
+    }
+    return boardMap;
+}
+/**
+ * Get board IDs for a list of board names (helper function)
+ *
+ * @param client JiraClient instance
+ * @param projectKey Jira project key
+ * @param boardNames Array of board names
+ * @returns Array of board IDs (skips boards not found)
+ */
+export async function getBoardIds(client, projectKey, boardNames) {
+    const boardMap = await resolveBoardNames(client, projectKey, boardNames);
+    return Array.from(boardMap.values());
+}
+//# sourceMappingURL=jira-board-resolver.js.map

package/plugins/specweave-jira/lib/jira-board-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-board-resolver.js","sourceRoot":"","sources":["jira-board-resolver.ts"],"names":[],"mappings":"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"}

package/plugins/specweave-jira/lib/jira-hierarchical-sync.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Jira Hierarchical Sync Implementation
+ *
+ * Supports three sync strategies:
+ * 1. Simple: One project, all boards (backward compatible)
+ * 2. Filtered: Multiple projects + specific boards + filters
+ * 3. Custom: Raw JQL query
+ */
+import { SyncProfile, SyncContainer } from '../../../src/core/types/sync-profile.js';
+import { JiraClient, JiraIssue } from '../../../src/integrations/jira/jira-client.js';
+/**
+ * Build hierarchical JQL query from containers
+ *
+ * Example output:
+ * (project=PROJECT-A AND board IN (123, 456) AND labels IN (feature))
+ * OR
+ * (project=PROJECT-B AND board IN (789))
+ *
+ * @param client JiraClient instance
+ * @param containers Array of containers with projects + boards + filters
+ * @returns JQL query string
+ */
+export declare function buildHierarchicalJQL(client: JiraClient, containers: SyncContainer[]): Promise<string>;
+/**
+ * Fetch issues hierarchically based on sync strategy
+ *
+ * @param client JiraClient instance
+ * @param profile Sync profile with strategy
+ * @param timeRange Time range preset
+ * @returns Array of Jira issues
+ */
+export declare function fetchIssuesHierarchical(client: JiraClient, profile: SyncProfile, timeRange?: string): Promise<JiraIssue[]>;
+//# sourceMappingURL=jira-hierarchical-sync.d.ts.map

package/plugins/specweave-jira/lib/jira-hierarchical-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-hierarchical-sync.d.ts","sourceRoot":"","sources":["jira-hierarchical-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EAKd,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAGtF;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,aAAa,EAAE,GAC1B,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAmFD;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,WAAW,EACpB,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,SAAS,EAAE,CAAC,CAqBtB"}