specweave 0.32.2 → 0.32.3

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

@@ -0,0 +1,335 @@
+/**
+ * Azure DevOps Reconciler (NEW in v0.33.0)
+ *
+ * Reconciles ADO work item states with increment metadata.json statuses.
+ * Fixes drift between local SpecWeave state and ADO:
+ * - Closes work items for completed increments that are still active
+ * - Reactivates work items for in-progress increments that are closed
+ *
+ * Mirrors the GitHub reconciler pattern for consistency.
+ *
+ * Triggered by:
+ * - /specweave-ado: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';
+/**
+ * ADO Status Mapping
+ */
+const ADO_STATUSES = {
+    CLOSED: ['Closed', 'Done', 'Resolved', 'Removed'],
+    ACTIVE: ['Active', 'New', 'In Progress', 'Committed'],
+};
+export class AdoReconciler {
+    constructor(options) {
+        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 ADO sync is enabled
+            const config = await this.loadConfig();
+            const canUpdate = config.sync?.settings?.canUpdateExternalItems ?? false;
+            const adoEnabled = config.sync?.ado?.enabled ?? false;
+            if (!canUpdate || !adoEnabled) {
+                this.logger.log('ℹ️  ADO sync is disabled - skipping reconciliation');
+                this.logger.log('   Enable with: canUpdateExternalItems=true AND sync.ado.enabled=true');
+                return result;
+            }
+            // 2. Verify ADO credentials
+            const hasCredentials = this.hasAdoCredentials();
+            if (!hasCredentials) {
+                result.errors.push('ADO credentials not configured');
+                this.logger.error('❌ ADO PAT not found. Set AZURE_DEVOPS_PAT environment variable.');
+                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 ADO 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('📊 ADO RECONCILIATION SUMMARY');
+            this.logger.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            this.logger.log(`   Increments scanned:   ${result.scanned}`);
+            this.logger.log(`   Mismatches found:     ${result.mismatches}`);
+            this.logger.log(`   Work items closed:    ${result.closed}`);
+            this.logger.log(`   Work items 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 ADO state
+        const shouldBeClosed = status === 'completed' || status === 'abandoned';
+        const shouldBeActive = status === 'in-progress' || status === 'active' || status === 'planning';
+        // Check main work item
+        if (inc.workItem) {
+            await this.reconcileWorkItem(inc.incrementId, inc.workItem.id, shouldBeClosed, shouldBeActive, status, result);
+        }
+        // Check User Story work items
+        for (const us of inc.userStoryWorkItems) {
+            await this.reconcileWorkItem(`${inc.incrementId}/${us.userStoryId}`, us.workItemId, shouldBeClosed, shouldBeActive, status, result);
+        }
+    }
+    /**
+     * Reconcile a single work item
+     */
+    async reconcileWorkItem(context, workItemId, shouldBeClosed, shouldBeActive, metadataStatus, result) {
+        try {
+            // Get current ADO state
+            const workItem = await this.getWorkItem(workItemId);
+            const currentState = workItem?.fields?.['System.State'] ?? 'Unknown';
+            const isCurrentlyClosed = ADO_STATUSES.CLOSED.includes(currentState);
+            // Check for mismatch
+            if (shouldBeClosed && !isCurrentlyClosed) {
+                // Should be closed but is active
+                result.mismatches++;
+                this.logger.log(`  ❌ Work Item #${workItemId} (${context}): ${currentState} but should be CLOSED (status=${metadataStatus})`);
+                if (!this.dryRun) {
+                    const comment = `## 🔄 Auto-Reconciled by SpecWeave
+
+This work item was closed by SpecWeave reconciliation.
+
+**Reason**: Increment status is \`${metadataStatus}\` but ADO work item was still active.
+
+---
+🤖 Auto-reconciled by SpecWeave`;
+                    await this.updateWorkItemState(workItemId, 'Closed', comment);
+                    result.closed++;
+                    this.logger.log(`     ✅ Closed work item #${workItemId}`);
+                }
+                else {
+                    this.logger.log(`     [DRY RUN] Would close work item #${workItemId}`);
+                }
+                result.details.push({
+                    incrementId: context,
+                    action: this.dryRun ? 'skip' : 'close',
+                    workItemId,
+                    reason: `Status=${metadataStatus}, ADO=${currentState}`,
+                });
+            }
+            else if (shouldBeActive && isCurrentlyClosed) {
+                // Should be active but is closed
+                result.mismatches++;
+                this.logger.log(`  ❌ Work Item #${workItemId} (${context}): CLOSED but should be ACTIVE (status=${metadataStatus})`);
+                if (!this.dryRun) {
+                    const comment = `## 🔄 Auto-Reconciled by SpecWeave
+
+This work item was reactivated by SpecWeave reconciliation.
+
+**Reason**: Increment status is \`${metadataStatus}\` but ADO work item was closed.
+This typically happens when an increment was resumed after being paused/completed.
+
+---
+🤖 Auto-reconciled by SpecWeave`;
+                    await this.updateWorkItemState(workItemId, 'Active', comment);
+                    result.reopened++;
+                    this.logger.log(`     ✅ Reactivated work item #${workItemId}`);
+                }
+                else {
+                    this.logger.log(`     [DRY RUN] Would reactivate work item #${workItemId}`);
+                }
+                result.details.push({
+                    incrementId: context,
+                    action: this.dryRun ? 'skip' : 'reopen',
+                    workItemId,
+                    reason: `Status=${metadataStatus}, ADO=${currentState}`,
+                });
+            }
+            else {
+                // State matches
+                this.logger.log(`  ✅ Work Item #${workItemId} (${context}): State matches (${currentState})`);
+                result.details.push({
+                    incrementId: context,
+                    action: 'skip',
+                    workItemId,
+                    reason: 'State matches',
+                });
+            }
+        }
+        catch (error) {
+            result.errors.push(`Work item #${workItemId}: ${error.message}`);
+            result.details.push({
+                incrementId: context,
+                action: 'error',
+                workItemId,
+                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 ADO work item link
+                const adoSync = metadata.external_sync?.ado;
+                if (!adoSync?.workItemId)
+                    continue;
+                const state = {
+                    incrementId: entry.name,
+                    incrementPath,
+                    metadataStatus: metadata.status || 'unknown',
+                    featureId: metadata.featureId,
+                    workItem: {
+                        id: adoSync.workItemId,
+                        url: adoSync.workItemUrl,
+                    },
+                    userStoryWorkItems: [],
+                };
+                // Extract user story work items if present
+                if (adoSync.userStories && Array.isArray(adoSync.userStories)) {
+                    for (const us of adoSync.userStories) {
+                        if (us.workItemId) {
+                            state.userStoryWorkItems.push({
+                                userStoryId: us.id || us.userStoryId,
+                                workItemId: us.workItemId,
+                            });
+                        }
+                    }
+                }
+                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 {};
+        }
+    }
+    /**
+     * Check if ADO credentials are configured
+     */
+    hasAdoCredentials() {
+        return !!(process.env.AZURE_DEVOPS_PAT || process.env.AZURE_DEVOPS_TOKEN);
+    }
+    /**
+     * Get work item from ADO API
+     */
+    async getWorkItem(workItemId) {
+        const org = process.env.AZURE_DEVOPS_ORG;
+        const pat = process.env.AZURE_DEVOPS_PAT || process.env.AZURE_DEVOPS_TOKEN;
+        if (!org || !pat) {
+            throw new Error('ADO credentials not configured');
+        }
+        const url = `https://dev.azure.com/${org}/_apis/wit/workitems/${workItemId}?api-version=7.1`;
+        const auth = Buffer.from(`:${pat}`).toString('base64');
+        const response = await fetch(url, {
+            headers: {
+                Authorization: `Basic ${auth}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to get work item: ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Update work item state in ADO
+     */
+    async updateWorkItemState(workItemId, newState, comment) {
+        const org = process.env.AZURE_DEVOPS_ORG;
+        const pat = process.env.AZURE_DEVOPS_PAT || process.env.AZURE_DEVOPS_TOKEN;
+        if (!org || !pat) {
+            throw new Error('ADO credentials not configured');
+        }
+        const url = `https://dev.azure.com/${org}/_apis/wit/workitems/${workItemId}?api-version=7.1`;
+        const auth = Buffer.from(`:${pat}`).toString('base64');
+        const operations = [
+            {
+                op: 'add',
+                path: '/fields/System.State',
+                value: newState,
+            },
+            {
+                op: 'add',
+                path: '/fields/System.History',
+                value: comment,
+            },
+        ];
+        const response = await fetch(url, {
+            method: 'PATCH',
+            headers: {
+                Authorization: `Basic ${auth}`,
+                'Content-Type': 'application/json-patch+json',
+            },
+            body: JSON.stringify(operations),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to update work item: ${response.status} - ${error}`);
+        }
+    }
+}
+/**
+ * Convenience function for quick reconciliation
+ */
+export async function reconcileAdo(projectRoot = process.cwd(), dryRun = false) {
+    const reconciler = new AdoReconciler({ projectRoot, dryRun });
+    return reconciler.reconcile();
+}
+export default AdoReconciler;
+//# sourceMappingURL=ado-reconciler.js.map

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

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

package/dist/src/sync/jira-reconciler.d.ts

@@ -0,0 +1,106 @@
+/**
+ * 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 { Logger } from '../utils/logger.js';
+export interface JiraReconcileOptions {
+    projectRoot: string;
+    dryRun?: boolean;
+    logger?: Logger;
+}
+export interface IncrementJiraState {
+    incrementId: string;
+    incrementPath: string;
+    metadataStatus: string;
+    featureId?: string;
+    issue?: {
+        key: string;
+        url?: string;
+    };
+    userStoryIssues: Array<{
+        userStoryId: string;
+        issueKey: string;
+    }>;
+}
+export interface JiraReconcileResult {
+    scanned: number;
+    mismatches: number;
+    closed: number;
+    reopened: number;
+    errors: string[];
+    details: Array<{
+        incrementId: string;
+        action: 'close' | 'reopen' | 'skip' | 'error';
+        issueKey: string;
+        reason: string;
+    }>;
+}
+export declare class JiraReconciler {
+    private projectRoot;
+    private dryRun;
+    private logger;
+    private domain;
+    private auth;
+    constructor(options: JiraReconcileOptions);
+    /**
+     * Main reconciliation entry point
+     */
+    reconcile(): Promise<JiraReconcileResult>;
+    /**
+     * Reconcile a single increment
+     */
+    private reconcileIncrement;
+    /**
+     * Reconcile a single issue
+     */
+    private reconcileIssue;
+    /**
+     * Scan increments directory for non-archived increments
+     */
+    private scanIncrements;
+    /**
+     * Load config.json
+     */
+    private loadConfig;
+    /**
+     * Initialize JIRA credentials
+     */
+    private initCredentials;
+    /**
+     * Get issue from JIRA API
+     */
+    private getIssue;
+    /**
+     * Get available transitions for an issue
+     */
+    private getTransitions;
+    /**
+     * Transition issue to new status and add comment
+     */
+    private transitionIssue;
+    /**
+     * Execute transition
+     */
+    private doTransition;
+    /**
+     * Add comment to issue
+     */
+    private addComment;
+}
+/**
+ * Convenience function for quick reconciliation
+ */
+export declare function reconcileJira(projectRoot?: string, dryRun?: boolean): Promise<JiraReconcileResult>;
+export default JiraReconciler;
+//# sourceMappingURL=jira-reconciler.d.ts.map

package/dist/src/sync/jira-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-reconciler.d.ts","sourceRoot":"","sources":["../../../src/sync/jira-reconciler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,MAAM,EAAiB,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,eAAe,EAAE,KAAK,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;QAC9C,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAUD,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,IAAI,CAAc;gBAEd,OAAO,EAAE,oBAAoB;IAMzC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAqE/C;;OAEG;YACW,kBAAkB;IAmChC;;OAEG;YACW,cAAc;IA+F5B;;OAEG;YACW,cAAc;IA4D5B;;OAEG;YACW,UAAU;IAWxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;YACW,QAAQ;IAiBtB;;OAEG;YACW,cAAc;IAkB5B;;OAEG;YACW,eAAe;IAwC7B;;OAEG;YACW,YAAY;IAoB1B;;OAEG;YACW,UAAU;CAiCzB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,GAAE,MAAsB,EACnC,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAG9B;AAED,eAAe,cAAc,CAAC"}