specweave 0.32.0 → 0.32.3

package/plugins/specweave-jira/commands/status.md

@@ -0,0 +1,215 @@
+---
+name: specweave-jira:status
+description: Check JIRA sync status for SpecWeave increment
+---
+
+# JIRA Status Command
+
+**Usage**: `/specweave-jira:status <increment-id>`
+
+**Purpose**: Display JIRA sync status and issue details for an increment
+
+---
+
+## Command Behavior
+
+When user runs this command, Claude should:
+
+### 1. Read Increment Metadata
+
+```typescript
+// Load increment metadata
+const metadataPath = `.specweave/increments/${incrementId}/metadata.json`;
+const metadata = JSON.parse(await fs.readFile(metadataPath, 'utf-8'));
+
+// Check for linked JIRA issue (check both standard and legacy paths)
+const jiraSync = metadata?.external_sync?.jira || metadata?.external_ids?.jira;
+const issueKey = jiraSync?.issueKey || jiraSync?.epic;
+
+if (!issueKey) {
+  console.log(`
+⚠️ No JIRA issue linked
+
+This increment is not linked to a JIRA issue.
+Create one with: /specweave-jira:create ${incrementId}
+`);
+  return;
+}
+```
+
+### 2. Resolve JIRA Profile
+
+```typescript
+// Priority: increment profile > global defaultProfile > activeProfile
+let profileName = jiraSync?.profile;
+if (!profileName) {
+  const config = JSON.parse(await fs.readFile('.specweave/config.json', 'utf-8'));
+  profileName = config?.sync?.defaultProfile ?? config?.sync?.activeProfile;
+}
+
+const profileConfig = config?.sync?.profiles?.[profileName];
+const { domain, projectKey } = profileConfig?.config || {};
+```
+
+### 3. Read Local Task Status
+
+```typescript
+// Check tasks.md for completion
+const tasksPath = `.specweave/increments/${incrementId}/tasks.md`;
+const tasksContent = await fs.readFile(tasksPath, 'utf-8');
+
+const totalTasks = (tasksContent.match(/### T-\d+/g) || []).length;
+const completedTasks = (tasksContent.match(/\[x\] completed/gi) || []).length;
+const completion = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
+```
+
+### 4. Invoke JIRA Manager Agent (Optional - For Live Status)
+
+```
+Use Task tool with subagent_type: "specweave-jira:jira-manager:jira-manager"
+
+Prompt: "Check JIRA sync status for increment {increment-id}.
+
+Issue Key: {issueKey}
+Profile: {profileName} (domain: {domain})
+
+Steps:
+1. GET issue from JIRA API: /rest/api/3/issue/{issueKey}
+2. Extract: status, priority, assignee, sprint, story points
+3. Compare local vs JIRA status
+4. Detect any sync issues or drift
+5. Display comprehensive status"
+```
+
+### 5. Display Status
+
+```
+JIRA Sync Status
+================
+Increment: {increment-id}
+Issue: {issueKey}
+URL: https://{domain}/browse/{issueKey}
+Status: {jiraStatus}
+Completion: {completion}% ({completedTasks}/{totalTasks} tasks)
+Last Synced: {lastSyncedAt} ({relativeTime})
+Sync Enabled: ✅
+
+Profile: {profileName}
+  Domain: {domain}
+  Project: {projectKey}
+
+Next Sync: Automatic on task completion
+```
+
+---
+
+## Example Output
+
+### Issue Linked
+
+```
+User: /specweave-jira:status 0005-payment-integration
+
+Claude:
+JIRA Sync Status
+================
+Increment: 0005-payment-integration
+Issue: MYPROJ-123
+URL: https://company.atlassian.net/browse/MYPROJ-123
+Status: In Progress
+Completion: 60% (6/10 tasks)
+Last Synced: 2025-12-07 10:30:00 (5 minutes ago)
+Sync Enabled: ✅
+
+Profile: jira-my-project
+  Domain: company.atlassian.net
+  Project: MYPROJ
+
+Priority: High
+Assignee: john.doe
+Sprint: Sprint 42
+
+Next Sync: Automatic on task completion
+```
+
+### No Issue Linked
+
+```
+User: /specweave-jira:status 0005
+
+Claude:
+JIRA Sync Status
+================
+Increment: 0005-payment-integration
+
+⚠️ No JIRA issue linked
+
+This increment is not linked to a JIRA issue.
+Create one with: /specweave-jira:create 0005-payment-integration
+```
+
+### Sync Issues Detected
+
+```
+User: /specweave-jira:status 0005
+
+Claude:
+JIRA Sync Status
+================
+Increment: 0005-payment-integration
+Issue: MYPROJ-123
+URL: https://company.atlassian.net/browse/MYPROJ-123
+Status: In Progress
+Completion: 60% (6/10 tasks)
+Last Synced: 2025-12-05 10:30:00 (2 days ago)
+Sync Enabled: ✅
+
+⚠️ Sync Issues Detected:
+  - Local status: in_progress, JIRA status: Done
+  - Status drift detected - run /specweave-jira:pull to sync
+
+Profile: jira-my-project
+  Domain: company.atlassian.net
+  Project: MYPROJ
+```
+
+---
+
+## Status Information Displayed
+
+| Field | Source | Description |
+|-------|--------|-------------|
+| Issue | metadata.json | JIRA issue key (e.g., PROJ-123) |
+| URL | Constructed | Direct link to JIRA issue |
+| Status | JIRA API | Current issue status |
+| Completion | tasks.md | Local completion percentage |
+| Last Synced | metadata.json | Timestamp of last sync |
+| Profile | metadata/config | Which JIRA profile is used |
+| Priority | JIRA API | Issue priority |
+| Assignee | JIRA API | Current assignee |
+| Sprint | JIRA API | Current sprint assignment |
+
+---
+
+## Drift Detection
+
+The status command detects common sync issues:
+
+| Issue | Detection | Resolution |
+|-------|-----------|------------|
+| Status drift | Local vs JIRA status mismatch | `/specweave-jira:pull` |
+| Stale sync | Last synced > 24 hours ago | `/specweave-jira:sync` |
+| Missing issue | Issue deleted in JIRA | `/specweave-jira:create` |
+| Permission denied | canUpdateExternalItems=false | Read-only mode note |
+
+---
+
+## Related
+
+| Command | Purpose |
+|---------|---------|
+| `/specweave-jira:pull` | Pull changes from JIRA |
+| `/specweave-jira:push` | Push progress to JIRA |
+| `/specweave-jira:sync` | Two-way sync |
+| `/specweave-jira:create` | Create JIRA issue |
+| `/specweave-jira:close` | Close issue when complete |

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

@@ -0,0 +1,134 @@
+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) {
+  const { specPath, domain, project, dryRun = false, verbose = false } = options;
+  try {
+    const baseSpec = await parseSpecContent(specPath);
+    if (!baseSpec) {
+      return {
+        success: false,
+        action: "error",
+        error: "Failed to parse spec content"
+      };
+    }
+    if (verbose) {
+      console.log(`\u{1F4C4} Parsed spec: ${baseSpec.identifier.compact}`);
+    }
+    const specId = baseSpec.identifier.full || baseSpec.identifier.compact;
+    const rootDir = await findSpecWeaveRoot(specPath);
+    const mapper = new SpecIncrementMapper(rootDir);
+    const mapping = await mapper.mapSpecToIncrements(specId);
+    if (verbose) {
+      console.log(`\u{1F517} Found ${mapping.increments.length} related increments`);
+    }
+    const taskMapping = buildTaskMapping(mapping.increments);
+    const architectureDocs = await findArchitectureDocs(rootDir, specId);
+    const enhancedSpec = {
+      ...baseSpec,
+      summary: baseSpec.description,
+      taskMapping,
+      architectureDocs
+    };
+    const builder = new EnhancedContentBuilder();
+    const description = builder.buildExternalDescription(enhancedSpec);
+    if (verbose) {
+      console.log(`\u{1F4DD} Generated description: ${description.length} characters`);
+    }
+    if (dryRun) {
+      console.log("\u{1F50D} DRY RUN - Would create/update epic with:");
+      console.log(`   Summary: ${baseSpec.title}`);
+      console.log(`   Description length: ${description.length}`);
+      return {
+        success: true,
+        action: "no-change",
+        tasksLinked: taskMapping?.tasks.length || 0
+      };
+    }
+    if (!dryRun && (!domain || !project)) {
+      return {
+        success: false,
+        action: "error",
+        error: "JIRA domain/project not specified (required for actual sync)"
+      };
+    }
+    const result = {
+      success: true,
+      action: dryRun ? "no-change" : "created",
+      // Assume create if not dry run
+      tasksLinked: taskMapping?.tasks.length || 0
+    };
+    if (domain && project && !dryRun) {
+      result.epicKey = `SPEC-001`;
+      result.epicUrl = `https://${domain}/browse/SPEC-001`;
+      if (verbose) {
+        console.log(`\u26A0\uFE0F  JIRA API integration not implemented in this file`);
+        console.log(`   Use jira-spec-sync.ts for actual JIRA synchronization`);
+      }
+    }
+    return result;
+  } catch (error) {
+    return {
+      success: false,
+      action: "error",
+      error: error.message
+    };
+  }
+}
+async function findSpecWeaveRoot(specPath) {
+  let currentDir = path.dirname(specPath);
+  while (true) {
+    const specweaveDir = path.join(currentDir, ".specweave");
+    try {
+      await fs.access(specweaveDir);
+      return currentDir;
+    } catch {
+      const parentDir = path.dirname(currentDir);
+      if (parentDir === currentDir) {
+        throw new Error(".specweave directory not found");
+      }
+      currentDir = parentDir;
+    }
+  }
+}
+function buildTaskMapping(increments) {
+  if (increments.length === 0) return void 0;
+  const firstIncrement = increments[0];
+  const tasks = firstIncrement.tasks.map((task) => ({
+    id: task.id,
+    title: task.title,
+    userStories: task.userStories
+  }));
+  return {
+    incrementId: firstIncrement.id,
+    tasks,
+    tasksUrl: `tasks.md`
+    // JIRA doesn't support external links in same way
+  };
+}
+async function findArchitectureDocs(rootDir, specId) {
+  const docs = [];
+  const archDir = path.join(rootDir, ".specweave/docs/internal/architecture");
+  try {
+    const adrDir = path.join(archDir, "adr");
+    try {
+      const adrs = await fs.readdir(adrDir);
+      const relatedAdrs = adrs.filter((file) => file.includes(specId.replace("spec-", "")));
+      for (const adr of relatedAdrs) {
+        docs.push({
+          type: "adr",
+          path: path.join(adrDir, adr),
+          title: adr.replace(".md", "").replace(/-/g, " ")
+        });
+      }
+    } catch {
+    }
+  } catch {
+  }
+  return docs;
+}
+export {
+  syncSpecToJiraWithEnhancedContent
+};