specweave 0.17.16 → 0.18.0

package/dist/src/core/sync/status-cache.js.map

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

package/dist/src/core/sync/status-mapper.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Status Mapper
+ *
+ * Maps SpecWeave increment statuses to tool-specific statuses for
+ * GitHub, JIRA, and Azure DevOps.
+ *
+ * Supports both simple string mappings and complex mappings with
+ * labels/tags for more granular status representation.
+ */
+export type ExternalTool = 'github' | 'jira' | 'ado';
+export type SpecWeaveStatus = 'planning' | 'active' | 'paused' | 'completed' | 'abandoned';
+export interface StatusMappingConfig {
+    state: string;
+    labels?: string[];
+    tags?: string[];
+}
+export type StatusMappingValue = string | StatusMappingConfig;
+export interface ToolStatusMappings {
+    planning: StatusMappingValue;
+    active: StatusMappingValue;
+    paused: StatusMappingValue;
+    completed: StatusMappingValue;
+    abandoned: StatusMappingValue;
+}
+export interface StatusSyncConfig {
+    enabled: boolean;
+    autoSync?: boolean;
+    promptUser?: boolean;
+    conflictResolution?: 'prompt' | 'last-write-wins' | 'specweave-wins' | 'external-wins';
+    mappings: {
+        github?: ToolStatusMappings;
+        jira?: ToolStatusMappings;
+        ado?: ToolStatusMappings;
+    };
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export interface SyncConfig {
+    sync: {
+        statusSync: StatusSyncConfig;
+    };
+}
+export declare class StatusMapper {
+    private config;
+    constructor(config: SyncConfig);
+    /**
+     * Map SpecWeave status to external tool status
+     */
+    mapToExternal(specweaveStatus: string, tool: ExternalTool): StatusMappingConfig;
+    /**
+     * Map external tool status to SpecWeave status (reverse lookup)
+     */
+    mapFromExternal(externalStatus: string, tool: ExternalTool): SpecWeaveStatus | null;
+    /**
+     * Validate status mapping configuration
+     */
+    validate(): ValidationResult;
+    /**
+     * Get all required SpecWeave statuses
+     */
+    getRequiredStatuses(): SpecWeaveStatus[];
+    /**
+     * Get all supported external tools
+     */
+    getSupportedTools(): ExternalTool[];
+}
+//# sourceMappingURL=status-mapper.d.ts.map

package/dist/src/core/sync/status-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-mapper.d.ts","sourceRoot":"","sources":["../../../../src/core/sync/status-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAE3F,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,mBAAmB,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,QAAQ,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,eAAe,CAAC;IACvF,QAAQ,EAAE;QACR,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,IAAI,CAAC,EAAE,kBAAkB,CAAC;QAC1B,GAAG,CAAC,EAAE,kBAAkB,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE;QACJ,UAAU,EAAE,gBAAgB,CAAC;KAC9B,CAAC;CACH;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,EAAE,UAAU;IAI9B;;OAEG;IACI,aAAa,CAClB,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,YAAY,GACjB,mBAAmB;IAqBtB;;OAEG;IACI,eAAe,CACpB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,YAAY,GACjB,eAAe,GAAG,IAAI;IAkBzB;;OAEG;IACI,QAAQ,IAAI,gBAAgB;IA+BnC;;OAEG;IACI,mBAAmB,IAAI,eAAe,EAAE;IAI/C;;OAEG;IACI,iBAAiB,IAAI,YAAY,EAAE;CAG3C"}

package/dist/src/core/sync/status-mapper.js

@@ -0,0 +1,90 @@
+/**
+ * Status Mapper
+ *
+ * Maps SpecWeave increment statuses to tool-specific statuses for
+ * GitHub, JIRA, and Azure DevOps.
+ *
+ * Supports both simple string mappings and complex mappings with
+ * labels/tags for more granular status representation.
+ */
+export class StatusMapper {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Map SpecWeave status to external tool status
+     */
+    mapToExternal(specweaveStatus, tool) {
+        const mappings = this.config.sync.statusSync.mappings[tool];
+        if (!mappings) {
+            throw new Error(`No status mappings configured for ${tool}`);
+        }
+        const mapping = mappings[specweaveStatus];
+        if (!mapping) {
+            throw new Error(`No mapping for status "${specweaveStatus}" in ${tool}`);
+        }
+        // Normalize to StatusMappingConfig
+        if (typeof mapping === 'string') {
+            return { state: mapping };
+        }
+        return mapping;
+    }
+    /**
+     * Map external tool status to SpecWeave status (reverse lookup)
+     */
+    mapFromExternal(externalStatus, tool) {
+        const mappings = this.config.sync.statusSync.mappings[tool];
+        if (!mappings) {
+            return null;
+        }
+        for (const [specweaveStatus, mapping] of Object.entries(mappings)) {
+            const state = typeof mapping === 'string' ? mapping : mapping.state;
+            if (state === externalStatus) {
+                return specweaveStatus;
+            }
+        }
+        return null; // Unknown external status
+    }
+    /**
+     * Validate status mapping configuration
+     */
+    validate() {
+        const errors = [];
+        const requiredStatuses = [
+            'planning',
+            'active',
+            'paused',
+            'completed',
+            'abandoned'
+        ];
+        for (const tool of ['github', 'jira', 'ado']) {
+            const mappings = this.config.sync.statusSync.mappings[tool];
+            if (!mappings) {
+                errors.push(`No mappings configured for ${tool}`);
+                continue;
+            }
+            for (const status of requiredStatuses) {
+                if (!mappings[status]) {
+                    errors.push(`Missing mapping for "${status}" in ${tool}`);
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+    /**
+     * Get all required SpecWeave statuses
+     */
+    getRequiredStatuses() {
+        return ['planning', 'active', 'paused', 'completed', 'abandoned'];
+    }
+    /**
+     * Get all supported external tools
+     */
+    getSupportedTools() {
+        return ['github', 'jira', 'ado'];
+    }
+}
+//# sourceMappingURL=status-mapper.js.map

package/dist/src/core/sync/status-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-mapper.js","sourceRoot":"","sources":["../../../../src/core/sync/status-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6CH,MAAM,OAAO,YAAY;IAGvB,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,aAAa,CAClB,eAAuB,EACvB,IAAkB;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE5D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,eAAkC,CAAC,CAAC;QAE7D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,0BAA0B,eAAe,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,mCAAmC;QACnC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,eAAe,CACpB,cAAsB,EACtB,IAAkB;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE5D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClE,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;YAEpE,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;gBAC7B,OAAO,eAAkC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,CAAC,0BAA0B;IACzC,CAAC;IAED;;OAEG;IACI,QAAQ;QACb,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,gBAAgB,GAAsB;YAC1C,UAAU;YACV,QAAQ;YACR,QAAQ;YACR,WAAW;YACX,WAAW;SACZ,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAU,EAAE,CAAC;YACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAE5D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;gBAClD,SAAS;YACX,CAAC;YAED,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;gBACtC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBACtB,MAAM,CAAC,IAAI,CAAC,wBAAwB,MAAM,QAAQ,IAAI,EAAE,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,mBAAmB;QACxB,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACI,iBAAiB;QACtB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/src/core/sync/status-sync-engine.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Status Sync Engine
+ *
+ * Core orchestration logic for status synchronization between SpecWeave
+ * increments and external tools (GitHub, JIRA, Azure DevOps).
+ *
+ * Responsibilities:
+ * - Orchestrate bidirectional status sync
+ * - Detect and resolve conflicts
+ * - Map statuses between SpecWeave and external tools
+ * - Respect user preferences (autoSync, promptUser, conflictResolution)
+ */
+import { StatusMappingConfig, ExternalTool, SpecWeaveStatus } from './status-mapper';
+import { StatusConflict, ConflictResolution, ConflictResolutionStrategy } from './conflict-resolver';
+export type SyncDirection = 'to-external' | 'from-external' | 'bidirectional';
+export type SyncAction = 'no-sync-needed' | 'sync-to-external' | 'sync-from-external';
+export interface SyncInput {
+    incrementId: string;
+    tool: ExternalTool;
+    localStatus: SpecWeaveStatus;
+    remoteStatus: string;
+    localTimestamp: string;
+    remoteTimestamp: string;
+}
+export interface SyncResult {
+    success: boolean;
+    direction: SyncDirection;
+    action: SyncAction;
+    conflict: StatusConflict | null;
+    resolution: ConflictResolution | null;
+    externalMapping: StatusMappingConfig | null;
+    error?: string;
+    wasAutomatic?: boolean;
+    wasPrompted?: boolean;
+}
+export interface StatusSyncConfig {
+    sync: {
+        statusSync: {
+            enabled: boolean;
+            autoSync?: boolean;
+            promptUser?: boolean;
+            conflictResolution?: ConflictResolutionStrategy;
+            mappings: {
+                github?: any;
+                jira?: any;
+                ado?: any;
+            };
+        };
+    };
+}
+/**
+ * Bulk sync input (multiple increments)
+ */
+export type BulkSyncInput = SyncInput;
+/**
+ * Bulk sync options
+ */
+export interface BulkSyncOptions {
+    batchSize?: number;
+    delayMs?: number;
+}
+/**
+ * Individual sync result with increment ID
+ */
+export interface BulkSyncItemResult extends SyncResult {
+    incrementId: string;
+}
+/**
+ * Bulk sync result
+ */
+export interface BulkSyncResult {
+    totalItems: number;
+    successCount: number;
+    failureCount: number;
+    results: BulkSyncItemResult[];
+    duration: string;
+}
+export declare class StatusSyncEngine {
+    private mapper;
+    private resolver;
+    private config;
+    constructor(config: StatusSyncConfig);
+    /**
+     * Sync SpecWeave status to external tool (one-way: SpecWeave → External)
+     *
+     * @param input - Sync input with local/remote statuses
+     * @returns Sync result with conflict resolution details
+     */
+    syncToExternal(input: SyncInput): Promise<SyncResult>;
+    /**
+     * Sync external status to SpecWeave (one-way: External → SpecWeave)
+     *
+     * @param input - Sync input with local/remote statuses
+     * @returns Sync result with conflict resolution details
+     */
+    syncFromExternal(input: SyncInput): Promise<SyncResult>;
+    /**
+     * Bidirectional sync (SpecWeave ↔ External)
+     *
+     * Detects conflict and resolves based on strategy.
+     * Syncs in the direction indicated by resolution.
+     *
+     * @param input - Sync input with local/remote statuses
+     * @returns Sync result with conflict resolution details
+     */
+    bidirectionalSync(input: SyncInput): Promise<SyncResult>;
+    /**
+     * Bulk sync multiple increments to external tools
+     *
+     * Batches requests to avoid rate limiting.
+     * Adds delays between batches.
+     * Returns aggregate results with success/failure counts.
+     *
+     * @param inputs - Array of sync inputs
+     * @param options - Bulk sync options (batch size, delay)
+     * @returns Bulk sync result
+     */
+    bulkSyncToExternal(inputs: BulkSyncInput[], options?: BulkSyncOptions): Promise<BulkSyncResult>;
+    /**
+     * Check if auto-sync is enabled
+     *
+     * @returns True if auto-sync is enabled
+     */
+    isAutoSyncEnabled(): boolean;
+    /**
+     * Check if user should be prompted
+     *
+     * @returns True if user should be prompted (default: true)
+     */
+    shouldPromptUser(): boolean;
+    /**
+     * Execute automatic sync without prompting
+     *
+     * Validates that auto-sync is enabled.
+     * Handles errors gracefully (doesn't throw, returns error in result).
+     *
+     * @param input - Sync input
+     * @returns Sync result with wasAutomatic flag
+     */
+    executeAutoSync(input: SyncInput): Promise<SyncResult>;
+    /**
+     * Calculate batches from input array
+     *
+     * @param inputs - Array of inputs
+     * @param batchSize - Size of each batch
+     * @returns Array of batches
+     */
+    private calculateBatches;
+    /**
+     * Delay execution for specified milliseconds
+     *
+     * @param ms - Milliseconds to delay
+     */
+    private delay;
+    /**
+     * Validate that status synchronization is enabled
+     *
+     * @throws Error if sync is disabled
+     */
+    private validateSyncEnabled;
+}
+//# sourceMappingURL=status-sync-engine.d.ts.map

package/dist/src/core/sync/status-sync-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-sync-engine.d.ts","sourceRoot":"","sources":["../../../../src/core/sync/status-sync-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAgB,mBAAmB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,EAAoB,cAAc,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAEvH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,eAAe,GAAG,eAAe,CAAC;AAE9E,MAAM,MAAM,UAAU,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,eAAe,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACtC,eAAe,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE;QACJ,UAAU,EAAE;YACV,OAAO,EAAE,OAAO,CAAC;YACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,UAAU,CAAC,EAAE,OAAO,CAAC;YACrB,kBAAkB,CAAC,EAAE,0BAA0B,CAAC;YAChD,QAAQ,EAAE;gBACR,MAAM,CAAC,EAAE,GAAG,CAAC;gBACb,IAAI,CAAC,EAAE,GAAG,CAAC;gBACX,GAAG,CAAC,EAAE,GAAG,CAAC;aACX,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAMpC;;;;;OAKG;IACU,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAwDlE;;;;;OAKG;IACU,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAuDpE;;;;;;;;OAQG;IACU,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAsDrE;;;;;;;;;;OAUG;IACU,kBAAkB,CAC7B,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC;IAqE1B;;;;OAIG;IACI,iBAAiB,IAAI,OAAO;IAInC;;;;OAIG;IACI,gBAAgB,IAAI,OAAO;IAKlC;;;;;;;;OAQG;IACU,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IA8BnE;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAIb;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;CAK5B"}

package/dist/src/core/sync/status-sync-engine.js

@@ -0,0 +1,347 @@
+/**
+ * Status Sync Engine
+ *
+ * Core orchestration logic for status synchronization between SpecWeave
+ * increments and external tools (GitHub, JIRA, Azure DevOps).
+ *
+ * Responsibilities:
+ * - Orchestrate bidirectional status sync
+ * - Detect and resolve conflicts
+ * - Map statuses between SpecWeave and external tools
+ * - Respect user preferences (autoSync, promptUser, conflictResolution)
+ */
+import { StatusMapper } from './status-mapper';
+import { ConflictResolver } from './conflict-resolver';
+export class StatusSyncEngine {
+    constructor(config) {
+        this.config = config;
+        this.mapper = new StatusMapper(config);
+        this.resolver = new ConflictResolver();
+    }
+    /**
+     * Sync SpecWeave status to external tool (one-way: SpecWeave → External)
+     *
+     * @param input - Sync input with local/remote statuses
+     * @returns Sync result with conflict resolution details
+     */
+    async syncToExternal(input) {
+        this.validateSyncEnabled();
+        const result = {
+            success: false,
+            direction: 'to-external',
+            action: 'no-sync-needed',
+            conflict: null,
+            resolution: null,
+            externalMapping: null
+        };
+        try {
+            // Detect conflict
+            const conflict = await this.resolver.detect({
+                incrementId: input.incrementId,
+                local: input.localStatus,
+                remote: input.remoteStatus,
+                tool: input.tool,
+                localTimestamp: input.localTimestamp,
+                remoteTimestamp: input.remoteTimestamp
+            });
+            result.conflict = conflict;
+            // No conflict - statuses already match
+            if (!conflict) {
+                result.success = true;
+                result.action = 'no-sync-needed';
+                return result;
+            }
+            // Resolve conflict
+            const strategy = this.config.sync.statusSync.conflictResolution || 'last-write-wins';
+            const resolution = await this.resolver.resolve(conflict, strategy);
+            result.resolution = resolution;
+            // Determine action based on resolution
+            if (resolution.action === 'use-local') {
+                result.action = 'sync-to-external';
+                result.externalMapping = this.mapper.mapToExternal(input.localStatus, input.tool);
+            }
+            else {
+                // Resolution says use-remote, but we're syncing TO external
+                // This means external is already correct, no sync needed
+                result.action = 'no-sync-needed';
+            }
+            result.success = true;
+            return result;
+        }
+        catch (error) {
+            result.success = false;
+            result.error = error instanceof Error ? error.message : 'Unknown error';
+            throw error;
+        }
+    }
+    /**
+     * Sync external status to SpecWeave (one-way: External → SpecWeave)
+     *
+     * @param input - Sync input with local/remote statuses
+     * @returns Sync result with conflict resolution details
+     */
+    async syncFromExternal(input) {
+        this.validateSyncEnabled();
+        const result = {
+            success: false,
+            direction: 'from-external',
+            action: 'no-sync-needed',
+            conflict: null,
+            resolution: null,
+            externalMapping: null
+        };
+        try {
+            // Detect conflict
+            const conflict = await this.resolver.detect({
+                incrementId: input.incrementId,
+                local: input.localStatus,
+                remote: input.remoteStatus,
+                tool: input.tool,
+                localTimestamp: input.localTimestamp,
+                remoteTimestamp: input.remoteTimestamp
+            });
+            result.conflict = conflict;
+            // No conflict - statuses already match
+            if (!conflict) {
+                result.success = true;
+                result.action = 'no-sync-needed';
+                return result;
+            }
+            // Resolve conflict
+            const strategy = this.config.sync.statusSync.conflictResolution || 'last-write-wins';
+            const resolution = await this.resolver.resolve(conflict, strategy);
+            result.resolution = resolution;
+            // Determine action based on resolution
+            if (resolution.action === 'use-remote') {
+                result.action = 'sync-from-external';
+            }
+            else {
+                // Resolution says use-local, but we're syncing FROM external
+                // This means local is already correct, no sync needed
+                result.action = 'no-sync-needed';
+            }
+            result.success = true;
+            return result;
+        }
+        catch (error) {
+            result.success = false;
+            result.error = error instanceof Error ? error.message : 'Unknown error';
+            throw error;
+        }
+    }
+    /**
+     * Bidirectional sync (SpecWeave ↔ External)
+     *
+     * Detects conflict and resolves based on strategy.
+     * Syncs in the direction indicated by resolution.
+     *
+     * @param input - Sync input with local/remote statuses
+     * @returns Sync result with conflict resolution details
+     */
+    async bidirectionalSync(input) {
+        this.validateSyncEnabled();
+        const result = {
+            success: false,
+            direction: 'bidirectional',
+            action: 'no-sync-needed',
+            conflict: null,
+            resolution: null,
+            externalMapping: null
+        };
+        try {
+            // Detect conflict
+            const conflict = await this.resolver.detect({
+                incrementId: input.incrementId,
+                local: input.localStatus,
+                remote: input.remoteStatus,
+                tool: input.tool,
+                localTimestamp: input.localTimestamp,
+                remoteTimestamp: input.remoteTimestamp
+            });
+            result.conflict = conflict;
+            // No conflict - statuses already match
+            if (!conflict) {
+                result.success = true;
+                result.action = 'no-sync-needed';
+                return result;
+            }
+            // Resolve conflict
+            const strategy = this.config.sync.statusSync.conflictResolution || 'last-write-wins';
+            const resolution = await this.resolver.resolve(conflict, strategy);
+            result.resolution = resolution;
+            // Determine action based on resolution
+            if (resolution.action === 'use-local') {
+                result.action = 'sync-to-external';
+                result.externalMapping = this.mapper.mapToExternal(input.localStatus, input.tool);
+            }
+            else {
+                result.action = 'sync-from-external';
+            }
+            result.success = true;
+            return result;
+        }
+        catch (error) {
+            result.success = false;
+            result.error = error instanceof Error ? error.message : 'Unknown error';
+            throw error;
+        }
+    }
+    /**
+     * Bulk sync multiple increments to external tools
+     *
+     * Batches requests to avoid rate limiting.
+     * Adds delays between batches.
+     * Returns aggregate results with success/failure counts.
+     *
+     * @param inputs - Array of sync inputs
+     * @param options - Bulk sync options (batch size, delay)
+     * @returns Bulk sync result
+     */
+    async bulkSyncToExternal(inputs, options) {
+        const startTime = Date.now();
+        const batchSize = options?.batchSize || 5;
+        const delayMs = options?.delayMs || 1000;
+        const results = [];
+        let successCount = 0;
+        let failureCount = 0;
+        // Calculate batches
+        const batches = this.calculateBatches(inputs, batchSize);
+        // Process each batch
+        for (let i = 0; i < batches.length; i++) {
+            const batch = batches[i];
+            // Process all items in batch concurrently
+            const batchResults = await Promise.allSettled(batch.map(input => this.syncToExternal(input)));
+            // Collect results
+            for (let j = 0; j < batchResults.length; j++) {
+                const result = batchResults[j];
+                const input = batch[j];
+                if (result.status === 'fulfilled') {
+                    results.push({
+                        ...result.value,
+                        incrementId: input.incrementId
+                    });
+                    if (result.value.success) {
+                        successCount++;
+                    }
+                    else {
+                        failureCount++;
+                    }
+                }
+                else {
+                    // Rejection
+                    results.push({
+                        incrementId: input.incrementId,
+                        success: false,
+                        direction: 'to-external',
+                        action: 'no-sync-needed',
+                        conflict: null,
+                        resolution: null,
+                        externalMapping: null,
+                        error: result.reason.message || 'Unknown error'
+                    });
+                    failureCount++;
+                }
+            }
+            // Add delay between batches (except after last batch)
+            if (i < batches.length - 1) {
+                await this.delay(delayMs);
+            }
+        }
+        const duration = `${Date.now() - startTime}ms`;
+        return {
+            totalItems: inputs.length,
+            successCount,
+            failureCount,
+            results,
+            duration
+        };
+    }
+    /**
+     * Check if auto-sync is enabled
+     *
+     * @returns True if auto-sync is enabled
+     */
+    isAutoSyncEnabled() {
+        return this.config.sync.statusSync.autoSync === true;
+    }
+    /**
+     * Check if user should be prompted
+     *
+     * @returns True if user should be prompted (default: true)
+     */
+    shouldPromptUser() {
+        // Default to true if not specified
+        return this.config.sync.statusSync.promptUser !== false;
+    }
+    /**
+     * Execute automatic sync without prompting
+     *
+     * Validates that auto-sync is enabled.
+     * Handles errors gracefully (doesn't throw, returns error in result).
+     *
+     * @param input - Sync input
+     * @returns Sync result with wasAutomatic flag
+     */
+    async executeAutoSync(input) {
+        // Validate auto-sync is enabled
+        if (!this.isAutoSyncEnabled()) {
+            throw new Error('Auto-sync is disabled');
+        }
+        try {
+            const result = await this.syncToExternal(input);
+            return {
+                ...result,
+                wasAutomatic: true,
+                wasPrompted: false
+            };
+        }
+        catch (error) {
+            // Handle errors gracefully - return error in result
+            // Don't throw to avoid blocking increment completion
+            return {
+                success: false,
+                direction: 'to-external',
+                action: 'no-sync-needed',
+                conflict: null,
+                resolution: null,
+                externalMapping: null,
+                error: error instanceof Error ? error.message : 'Unknown error',
+                wasAutomatic: true,
+                wasPrompted: false
+            };
+        }
+    }
+    /**
+     * Calculate batches from input array
+     *
+     * @param inputs - Array of inputs
+     * @param batchSize - Size of each batch
+     * @returns Array of batches
+     */
+    calculateBatches(inputs, batchSize) {
+        const batches = [];
+        for (let i = 0; i < inputs.length; i += batchSize) {
+            batches.push(inputs.slice(i, i + batchSize));
+        }
+        return batches;
+    }
+    /**
+     * Delay execution for specified milliseconds
+     *
+     * @param ms - Milliseconds to delay
+     */
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Validate that status synchronization is enabled
+     *
+     * @throws Error if sync is disabled
+     */
+    validateSyncEnabled() {
+        if (!this.config.sync.statusSync.enabled) {
+            throw new Error('Status synchronization is disabled');
+        }
+    }
+}
+//# sourceMappingURL=status-sync-engine.js.map