specweave 0.32.0 → 0.32.3

package/dist/src/sync/jira-reconciler.js

@@ -0,0 +1,405 @@
+/**
+ * JIRA Reconciler (NEW in v0.33.0)
+ *
+ * Reconciles JIRA issue states with increment metadata.json statuses.
+ * Fixes drift between local SpecWeave state and JIRA:
+ * - Closes issues for completed increments that are still open
+ * - Reopens issues for in-progress increments that are closed
+ *
+ * Mirrors the GitHub reconciler pattern for consistency.
+ *
+ * Triggered by:
+ * - /specweave-jira:reconcile command (manual)
+ * - SessionStart hook (automatic, if configured)
+ * - post-increment-status-change.sh (on resume/abandon)
+ */
+import { promises as fs, existsSync } from 'fs';
+import path from 'path';
+import { consoleLogger } from '../utils/logger.js';
+/**
+ * JIRA Status Mapping
+ */
+const JIRA_STATUSES = {
+    CLOSED: ['Done', 'Closed', 'Resolved', "Won't Do"],
+    OPEN: ['To Do', 'In Progress', 'In Review', 'Open', 'Reopened'],
+};
+export class JiraReconciler {
+    constructor(options) {
+        this.domain = '';
+        this.auth = '';
+        this.projectRoot = options.projectRoot;
+        this.dryRun = options.dryRun ?? false;
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Main reconciliation entry point
+     */
+    async reconcile() {
+        const result = {
+            scanned: 0,
+            mismatches: 0,
+            closed: 0,
+            reopened: 0,
+            errors: [],
+            details: [],
+        };
+        try {
+            // 1. Check if JIRA sync is enabled
+            const config = await this.loadConfig();
+            const canUpdate = config.sync?.settings?.canUpdateExternalItems ?? false;
+            const canUpdateStatus = config.sync?.settings?.canUpdateStatus ?? false;
+            const jiraEnabled = config.sync?.jira?.enabled ?? false;
+            if (!canUpdate || !jiraEnabled) {
+                this.logger.log('ℹ️  JIRA sync is disabled - skipping reconciliation');
+                this.logger.log('   Enable with: canUpdateExternalItems=true AND sync.jira.enabled=true');
+                return result;
+            }
+            if (!canUpdateStatus) {
+                this.logger.log('ℹ️  JIRA status updates are disabled - skipping reconciliation');
+                this.logger.log('   Enable with: canUpdateStatus=true');
+                return result;
+            }
+            // 2. Verify JIRA credentials
+            if (!this.initCredentials()) {
+                result.errors.push('JIRA credentials not configured');
+                this.logger.error('❌ JIRA credentials not found. Set JIRA_API_TOKEN and JIRA_EMAIL environment variables.');
+                return result;
+            }
+            // 3. Scan all non-archived increments
+            const increments = await this.scanIncrements();
+            result.scanned = increments.length;
+            this.logger.log(`\n📊 Scanning ${increments.length} increment(s) for JIRA state drift...\n`);
+            // 4. Check and fix each increment
+            for (const inc of increments) {
+                await this.reconcileIncrement(inc, result);
+            }
+            // 5. Report summary
+            this.logger.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            this.logger.log('📊 JIRA RECONCILIATION SUMMARY');
+            this.logger.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            this.logger.log(`   Increments scanned:  ${result.scanned}`);
+            this.logger.log(`   Mismatches found:    ${result.mismatches}`);
+            this.logger.log(`   Issues closed:       ${result.closed}`);
+            this.logger.log(`   Issues reopened:     ${result.reopened}`);
+            this.logger.log(`   Errors:              ${result.errors.length}`);
+            if (this.dryRun) {
+                this.logger.log('\n   ⚠️  DRY RUN - No changes were made');
+            }
+            this.logger.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+            return result;
+        }
+        catch (error) {
+            result.errors.push(`Reconciliation error: ${error.message}`);
+            this.logger.error('❌ Reconciliation failed:', error.message);
+            return result;
+        }
+    }
+    /**
+     * Reconcile a single increment
+     */
+    async reconcileIncrement(inc, result) {
+        const status = inc.metadataStatus;
+        // Determine expected JIRA state
+        const shouldBeClosed = status === 'completed' || status === 'abandoned';
+        const shouldBeOpen = status === 'in-progress' || status === 'active' || status === 'planning';
+        // Check main issue
+        if (inc.issue) {
+            await this.reconcileIssue(inc.incrementId, inc.issue.key, shouldBeClosed, shouldBeOpen, status, result);
+        }
+        // Check User Story issues
+        for (const us of inc.userStoryIssues) {
+            await this.reconcileIssue(`${inc.incrementId}/${us.userStoryId}`, us.issueKey, shouldBeClosed, shouldBeOpen, status, result);
+        }
+    }
+    /**
+     * Reconcile a single issue
+     */
+    async reconcileIssue(context, issueKey, shouldBeClosed, shouldBeOpen, metadataStatus, result) {
+        try {
+            // Get current JIRA state
+            const issue = await this.getIssue(issueKey);
+            const currentStatus = issue?.fields?.status?.name ?? 'Unknown';
+            const isCurrentlyClosed = JIRA_STATUSES.CLOSED.includes(currentStatus);
+            // Check for mismatch
+            if (shouldBeClosed && !isCurrentlyClosed) {
+                // Should be closed but is open
+                result.mismatches++;
+                this.logger.log(`  ❌ Issue ${issueKey} (${context}): ${currentStatus} but should be CLOSED (status=${metadataStatus})`);
+                if (!this.dryRun) {
+                    const comment = `h2. 🔄 Auto-Reconciled by SpecWeave
+
+This issue was closed by SpecWeave reconciliation.
+
+*Reason*: Increment status is \`${metadataStatus}\` but JIRA issue was still open.
+
+----
+🤖 Auto-reconciled by SpecWeave`;
+                    await this.transitionIssue(issueKey, 'Done', comment);
+                    result.closed++;
+                    this.logger.log(`     ✅ Closed issue ${issueKey}`);
+                }
+                else {
+                    this.logger.log(`     [DRY RUN] Would close issue ${issueKey}`);
+                }
+                result.details.push({
+                    incrementId: context,
+                    action: this.dryRun ? 'skip' : 'close',
+                    issueKey,
+                    reason: `Status=${metadataStatus}, JIRA=${currentStatus}`,
+                });
+            }
+            else if (shouldBeOpen && isCurrentlyClosed) {
+                // Should be open but is closed
+                result.mismatches++;
+                this.logger.log(`  ❌ Issue ${issueKey} (${context}): CLOSED but should be OPEN (status=${metadataStatus})`);
+                if (!this.dryRun) {
+                    const comment = `h2. 🔄 Auto-Reconciled by SpecWeave
+
+This issue was reopened by SpecWeave reconciliation.
+
+*Reason*: Increment status is \`${metadataStatus}\` but JIRA issue was closed.
+This typically happens when an increment was resumed after being paused/completed.
+
+----
+🤖 Auto-reconciled by SpecWeave`;
+                    await this.transitionIssue(issueKey, 'To Do', comment);
+                    result.reopened++;
+                    this.logger.log(`     ✅ Reopened issue ${issueKey}`);
+                }
+                else {
+                    this.logger.log(`     [DRY RUN] Would reopen issue ${issueKey}`);
+                }
+                result.details.push({
+                    incrementId: context,
+                    action: this.dryRun ? 'skip' : 'reopen',
+                    issueKey,
+                    reason: `Status=${metadataStatus}, JIRA=${currentStatus}`,
+                });
+            }
+            else {
+                // State matches
+                this.logger.log(`  ✅ Issue ${issueKey} (${context}): State matches (${currentStatus})`);
+                result.details.push({
+                    incrementId: context,
+                    action: 'skip',
+                    issueKey,
+                    reason: 'State matches',
+                });
+            }
+        }
+        catch (error) {
+            result.errors.push(`Issue ${issueKey}: ${error.message}`);
+            result.details.push({
+                incrementId: context,
+                action: 'error',
+                issueKey,
+                reason: error.message,
+            });
+        }
+    }
+    /**
+     * Scan increments directory for non-archived increments
+     */
+    async scanIncrements() {
+        const incrementsPath = path.join(this.projectRoot, '.specweave', 'increments');
+        const results = [];
+        if (!existsSync(incrementsPath)) {
+            return results;
+        }
+        const entries = await fs.readdir(incrementsPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name === '_archive' || entry.name.startsWith('.'))
+                continue;
+            const incrementPath = path.join(incrementsPath, entry.name);
+            const metadataPath = path.join(incrementPath, 'metadata.json');
+            if (!existsSync(metadataPath))
+                continue;
+            try {
+                const metadataContent = await fs.readFile(metadataPath, 'utf-8');
+                const metadata = JSON.parse(metadataContent);
+                // Check for JIRA issue link (support both new and legacy naming)
+                const jiraSync = metadata.external_sync?.jira || metadata.external_ids?.jira;
+                if (!jiraSync?.issueKey && !jiraSync?.epic)
+                    continue;
+                const state = {
+                    incrementId: entry.name,
+                    incrementPath,
+                    metadataStatus: metadata.status || 'unknown',
+                    featureId: metadata.featureId,
+                    issue: {
+                        key: jiraSync.issueKey || jiraSync.epic,
+                        url: jiraSync.issueUrl,
+                    },
+                    userStoryIssues: [],
+                };
+                // Extract user story issues if present
+                if (jiraSync.stories && Array.isArray(jiraSync.stories)) {
+                    for (const story of jiraSync.stories) {
+                        if (story.issueKey || story.key) {
+                            state.userStoryIssues.push({
+                                userStoryId: story.id || story.userStoryId,
+                                issueKey: story.issueKey || story.key,
+                            });
+                        }
+                    }
+                }
+                results.push(state);
+            }
+            catch {
+                // Skip invalid metadata
+            }
+        }
+        return results;
+    }
+    /**
+     * Load config.json
+     */
+    async loadConfig() {
+        const configPath = path.join(this.projectRoot, '.specweave', 'config.json');
+        try {
+            const content = await fs.readFile(configPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return {};
+        }
+    }
+    /**
+     * Initialize JIRA credentials
+     */
+    initCredentials() {
+        const token = process.env.JIRA_API_TOKEN;
+        const email = process.env.JIRA_EMAIL;
+        this.domain = process.env.JIRA_DOMAIN || '';
+        if (!token || !email || !this.domain) {
+            return false;
+        }
+        this.auth = Buffer.from(`${email}:${token}`).toString('base64');
+        return true;
+    }
+    /**
+     * Get issue from JIRA API
+     */
+    async getIssue(issueKey) {
+        const url = `https://${this.domain}/rest/api/3/issue/${issueKey}`;
+        const response = await fetch(url, {
+            headers: {
+                Authorization: `Basic ${this.auth}`,
+                Accept: 'application/json',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to get issue: ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get available transitions for an issue
+     */
+    async getTransitions(issueKey) {
+        const url = `https://${this.domain}/rest/api/3/issue/${issueKey}/transitions`;
+        const response = await fetch(url, {
+            headers: {
+                Authorization: `Basic ${this.auth}`,
+                Accept: 'application/json',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to get transitions: ${response.status}`);
+        }
+        const data = await response.json();
+        return data.transitions || [];
+    }
+    /**
+     * Transition issue to new status and add comment
+     */
+    async transitionIssue(issueKey, targetStatus, comment) {
+        // First, add comment
+        await this.addComment(issueKey, comment);
+        // Get available transitions
+        const transitions = await this.getTransitions(issueKey);
+        // Find transition matching target status
+        const transition = transitions.find((t) => t.name.toLowerCase() === targetStatus.toLowerCase() ||
+            t.to?.name?.toLowerCase() === targetStatus.toLowerCase());
+        if (!transition) {
+            // Try common alternatives
+            const alternatives = targetStatus === 'Done'
+                ? ['Closed', 'Resolved', 'Complete']
+                : ['Open', 'Reopened', 'In Progress'];
+            const altTransition = transitions.find((t) => alternatives.some(alt => t.name.toLowerCase() === alt.toLowerCase() ||
+                t.to?.name?.toLowerCase() === alt.toLowerCase()));
+            if (!altTransition) {
+                throw new Error(`No transition found to "${targetStatus}". Available: ${transitions.map((t) => t.name).join(', ')}`);
+            }
+            await this.doTransition(issueKey, altTransition.id);
+        }
+        else {
+            await this.doTransition(issueKey, transition.id);
+        }
+    }
+    /**
+     * Execute transition
+     */
+    async doTransition(issueKey, transitionId) {
+        const url = `https://${this.domain}/rest/api/3/issue/${issueKey}/transitions`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                Authorization: `Basic ${this.auth}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                transition: { id: transitionId },
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to transition issue: ${response.status} - ${error}`);
+        }
+    }
+    /**
+     * Add comment to issue
+     */
+    async addComment(issueKey, comment) {
+        const url = `https://${this.domain}/rest/api/3/issue/${issueKey}/comment`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                Authorization: `Basic ${this.auth}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                body: {
+                    type: 'doc',
+                    version: 1,
+                    content: [
+                        {
+                            type: 'paragraph',
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: comment,
+                                },
+                            ],
+                        },
+                    ],
+                },
+            }),
+        });
+        if (!response.ok) {
+            // Non-fatal, just log warning
+            this.logger.log(`     ⚠️  Failed to add comment to ${issueKey}`);
+        }
+    }
+}
+/**
+ * Convenience function for quick reconciliation
+ */
+export async function reconcileJira(projectRoot = process.cwd(), dryRun = false) {
+    const reconciler = new JiraReconciler({ projectRoot, dryRun });
+    return reconciler.reconcile();
+}
+export default JiraReconciler;
+//# sourceMappingURL=jira-reconciler.js.map

package/dist/src/sync/jira-reconciler.js.map

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

package/dist/src/types/dashboard-cache.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Type definitions for Dashboard Cache system
+ *
+ * Pre-computed state cache for O(1) status command reads.
+ * Updated incrementally on file changes, not rebuilt on every query.
+ *
+ * @see spec.md 0117-instant-dashboard-cache
+ */
+/**
+ * Current cache schema version
+ * Increment when making breaking schema changes
+ */
+export declare const DASHBOARD_CACHE_VERSION = 1;
+/**
+ * Cache file location
+ */
+export declare const DASHBOARD_CACHE_PATH = ".specweave/state/dashboard.json";
+/**
+ * Task completion stats for an increment
+ */
+export interface TaskStats {
+    total: number;
+    completed: number;
+}
+/**
+ * Acceptance criteria stats for an increment
+ */
+export interface ACStats {
+    total: number;
+    completed: number;
+}
+/**
+ * Increment status values
+ */
+export type IncrementStatus = 'backlog' | 'planned' | 'active' | 'paused' | 'ready_for_review' | 'completed' | 'abandoned';
+/**
+ * Increment type values
+ */
+export type IncrementType = 'feature' | 'hotfix' | 'bug' | 'refactor' | 'experiment' | 'change-request';
+/**
+ * Priority values
+ */
+export type Priority = 'P0' | 'P1' | 'P2' | 'P3';
+/**
+ * Cached data for a single increment
+ */
+export interface CachedIncrement {
+    /** Increment status */
+    status: IncrementStatus;
+    /** Increment type */
+    type: IncrementType;
+    /** Priority level */
+    priority: Priority;
+    /** Task completion stats */
+    tasks: TaskStats;
+    /** Acceptance criteria completion stats */
+    acs: ACStats;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last activity timestamp */
+    lastActivity: string;
+    /** User story IDs in this increment */
+    userStories: string[];
+    /** Increment title (for display) */
+    title?: string;
+    /** Project ID */
+    project?: string;
+}
+/**
+ * Summary counts by status
+ */
+export interface StatusSummary {
+    total: number;
+    active: number;
+    paused: number;
+    backlog: number;
+    planned: number;
+    ready_for_review: number;
+    completed: number;
+    abandoned: number;
+    archived: number;
+}
+/**
+ * Counts by type
+ */
+export interface TypeCounts {
+    feature: number;
+    hotfix: number;
+    bug: number;
+    refactor: number;
+    experiment: number;
+    'change-request': number;
+}
+/**
+ * Counts by priority
+ */
+export interface PriorityCounts {
+    P0: number;
+    P1: number;
+    P2: number;
+    P3: number;
+}
+/**
+ * Summary statistics across all increments
+ */
+export interface DashboardSummary extends StatusSummary {
+    byType: TypeCounts;
+    byPriority: PriorityCounts;
+}
+/**
+ * Background job info
+ */
+export interface CachedJob {
+    id: string;
+    type: string;
+    status: 'running' | 'paused' | 'completed' | 'failed';
+    progress?: number;
+    message?: string;
+    startedAt: string;
+    updatedAt: string;
+}
+/**
+ * Jobs section of cache
+ */
+export interface JobsCache {
+    running: CachedJob[];
+    paused: CachedJob[];
+    failed: CachedJob[];
+    completedCount: number;
+}
+/**
+ * Cost tracking section of cache
+ */
+export interface CostsCache {
+    totalTokens: number;
+    totalCost: number;
+    totalSavings: number;
+    byIncrement: Record<string, {
+        tokens: number;
+        cost: number;
+        savings: number;
+    }>;
+}
+/**
+ * Source file mtimes for stale detection
+ */
+export interface SourceMtimes {
+    [incrementId: string]: {
+        metadata?: number;
+        tasks?: number;
+        spec?: number;
+    };
+}
+/**
+ * Complete dashboard cache structure
+ */
+export interface DashboardCache {
+    /** Schema version for migrations */
+    version: number;
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Per-increment cached data */
+    increments: Record<string, CachedIncrement>;
+    /** Aggregated summary statistics */
+    summary: DashboardSummary;
+    /** Background jobs state */
+    jobs: JobsCache;
+    /** Cost tracking data */
+    costs: CostsCache;
+    /** Source file mtimes for stale detection */
+    mtimes?: SourceMtimes;
+}
+/**
+ * Change types for incremental updates
+ */
+export type CacheChangeType = 'metadata' | 'tasks' | 'spec' | 'jobs';
+/**
+ * Create an empty dashboard cache
+ */
+export declare function createEmptyCache(): DashboardCache;
+//# sourceMappingURL=dashboard-cache.d.ts.map

package/dist/src/types/dashboard-cache.d.ts.map

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

package/dist/src/types/dashboard-cache.js

@@ -0,0 +1,65 @@
+/**
+ * Type definitions for Dashboard Cache system
+ *
+ * Pre-computed state cache for O(1) status command reads.
+ * Updated incrementally on file changes, not rebuilt on every query.
+ *
+ * @see spec.md 0117-instant-dashboard-cache
+ */
+/**
+ * Current cache schema version
+ * Increment when making breaking schema changes
+ */
+export const DASHBOARD_CACHE_VERSION = 1;
+/**
+ * Cache file location
+ */
+export const DASHBOARD_CACHE_PATH = '.specweave/state/dashboard.json';
+/**
+ * Create an empty dashboard cache
+ */
+export function createEmptyCache() {
+    return {
+        version: DASHBOARD_CACHE_VERSION,
+        updatedAt: new Date().toISOString(),
+        increments: {},
+        summary: {
+            total: 0,
+            active: 0,
+            paused: 0,
+            backlog: 0,
+            planned: 0,
+            ready_for_review: 0,
+            completed: 0,
+            abandoned: 0,
+            archived: 0,
+            byType: {
+                feature: 0,
+                hotfix: 0,
+                bug: 0,
+                refactor: 0,
+                experiment: 0,
+                'change-request': 0,
+            },
+            byPriority: {
+                P0: 0,
+                P1: 0,
+                P2: 0,
+                P3: 0,
+            },
+        },
+        jobs: {
+            running: [],
+            paused: [],
+            failed: [],
+            completedCount: 0,
+        },
+        costs: {
+            totalTokens: 0,
+            totalCost: 0,
+            totalSavings: 0,
+            byIncrement: {},
+        },
+    };
+}
+//# sourceMappingURL=dashboard-cache.js.map

package/dist/src/types/dashboard-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-cache.js","sourceRoot":"","sources":["../../../src/types/dashboard-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,iCAAiC,CAAC;AA8LtE;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,OAAO,EAAE,uBAAuB;QAChC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU,EAAE,EAAE;QACd,OAAO,EAAE;YACP,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,gBAAgB,EAAE,CAAC;YACnB,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE;gBACN,OAAO,EAAE,CAAC;gBACV,MAAM,EAAE,CAAC;gBACT,GAAG,EAAE,CAAC;gBACN,QAAQ,EAAE,CAAC;gBACX,UAAU,EAAE,CAAC;gBACb,gBAAgB,EAAE,CAAC;aACpB;YACD,UAAU,EAAE;gBACV,EAAE,EAAE,CAAC;gBACL,EAAE,EAAE,CAAC;gBACL,EAAE,EAAE,CAAC;gBACL,EAAE,EAAE,CAAC;aACN;SACF;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;YACV,cAAc,EAAE,CAAC;SAClB;QACD,KAAK,EAAE;YACL,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,CAAC;YACZ,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,EAAE;SAChB;KACF,CAAC;AACJ,CAAC"}