specweave 0.17.15 → 0.18.0

package/dist/src/core/sync/retry-logic.js

@@ -0,0 +1,165 @@
+/**
+ * Retry Logic
+ *
+ * Provides retry functionality with exponential backoff.
+ * Handles transient errors (network, rate limits, timeouts).
+ *
+ * Retry Strategy:
+ * - Max 3 retries
+ * - Exponential backoff: 1s, 2s, 4s
+ * - Special handling for rate limits (wait and retry)
+ *
+ * @module retry-logic
+ */
+/**
+ * Check if error is retryable
+ *
+ * @param error - Error to check
+ * @returns True if error is retryable
+ */
+export function isRetryableError(error) {
+    const message = error.message.toLowerCase();
+    // Network errors
+    if (message.includes('network') ||
+        message.includes('timeout') ||
+        message.includes('econnreset') ||
+        message.includes('enotfound') ||
+        message.includes('econnrefused')) {
+        return true;
+    }
+    // Rate limit errors
+    if (message.includes('rate limit') ||
+        message.includes('429') ||
+        message.includes('too many requests')) {
+        return true;
+    }
+    // Temporary server errors
+    if (message.includes('500') ||
+        message.includes('502') ||
+        message.includes('503') ||
+        message.includes('504')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Extract rate limit wait time from error
+ *
+ * @param error - Error that may contain rate limit info
+ * @returns Wait time in milliseconds, or null if not rate limit error
+ */
+export function extractRateLimitWaitTime(error) {
+    const message = error.message;
+    // GitHub: "Rate limit exceeded. Retry after 60 seconds."
+    const githubMatch = message.match(/retry after (\d+) seconds/i);
+    if (githubMatch) {
+        return parseInt(githubMatch[1]) * 1000;
+    }
+    // JIRA/ADO: "Rate limit exceeded. Retry-After: 120"
+    const retryAfterMatch = message.match(/retry-after:\s*(\d+)/i);
+    if (retryAfterMatch) {
+        return parseInt(retryAfterMatch[1]) * 1000;
+    }
+    // Generic rate limit: default wait 60 seconds
+    if (message.toLowerCase().includes('rate limit')) {
+        return 60 * 1000;
+    }
+    return null;
+}
+/**
+ * Retry function with exponential backoff
+ *
+ * @param fn - Function to retry
+ * @param options - Retry options
+ * @returns Retry result
+ */
+export async function retryWithBackoff(fn, options) {
+    const maxRetries = options?.maxRetries || 3;
+    const initialDelay = options?.initialDelayMs || 1000;
+    const maxDelay = options?.maxDelayMs || 8000;
+    let lastError;
+    let totalDelay = 0;
+    for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
+        try {
+            const result = await fn();
+            return {
+                success: true,
+                result,
+                attempts: attempt,
+                totalDelayMs: totalDelay
+            };
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // If this is the last attempt, don't retry
+            if (attempt > maxRetries) {
+                break;
+            }
+            // Check if error is retryable
+            if (!isRetryableError(lastError)) {
+                // Non-retryable error - fail immediately
+                return {
+                    success: false,
+                    error: lastError,
+                    attempts: attempt,
+                    totalDelayMs: totalDelay
+                };
+            }
+            // Calculate delay
+            let delay = initialDelay * Math.pow(2, attempt - 1);
+            // Check for rate limit wait time
+            const rateLimitWait = extractRateLimitWaitTime(lastError);
+            if (rateLimitWait) {
+                delay = Math.min(rateLimitWait, maxDelay);
+            }
+            else {
+                delay = Math.min(delay, maxDelay);
+            }
+            totalDelay += delay;
+            // Wait before retry
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+    }
+    return {
+        success: false,
+        error: lastError,
+        attempts: maxRetries + 1,
+        totalDelayMs: totalDelay
+    };
+}
+/**
+ * Create error message with retry information
+ *
+ * @param error - Original error
+ * @param attempts - Number of attempts made
+ * @returns Enhanced error message
+ */
+export function createRetryErrorMessage(error, attempts) {
+    return `${error.message} (failed after ${attempts} attempts)`;
+}
+/**
+ * Check if error is permanent (not worth retrying)
+ *
+ * @param error - Error to check
+ * @returns True if error is permanent
+ */
+export function isPermanentError(error) {
+    const message = error.message.toLowerCase();
+    // Authentication/Authorization errors
+    if (message.includes('401') ||
+        message.includes('403') ||
+        message.includes('unauthorized') ||
+        message.includes('forbidden')) {
+        return true;
+    }
+    // Not found errors
+    if (message.includes('404') || message.includes('not found')) {
+        return true;
+    }
+    // Bad request errors
+    if (message.includes('400') || message.includes('bad request')) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=retry-logic.js.map

package/dist/src/core/sync/retry-logic.js.map

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

package/dist/src/core/sync/spec-increment-mapper.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Spec-to-Increment Mapper
+ *
+ * Maps permanent living docs specs to specific increment tasks.
+ * Enables traceability: "Which increment implemented US-001?"
+ */
+export interface TaskInfo {
+    id: string;
+    title: string;
+    incrementId: string;
+    userStories: string[];
+    githubIssue?: number;
+    status?: 'pending' | 'in-progress' | 'completed';
+}
+export interface IncrementInfo {
+    id: string;
+    tasks: TaskInfo[];
+    specId?: string;
+}
+export interface SpecIncrementMapping {
+    specId: string;
+    increments: IncrementInfo[];
+    userStoryMappings: Record<string, TaskInfo[]>;
+}
+export interface TraceabilityReport {
+    specId: string;
+    totalUserStories: number;
+    totalIncrements: number;
+    totalTasks: number;
+    coverage: number;
+    unmappedUserStories: string[];
+    mappingDetails: Record<string, {
+        incrementId: string;
+        taskIds: string[];
+    }[]>;
+}
+export declare class SpecIncrementMapper {
+    private rootDir;
+    constructor(rootDir?: string);
+    /**
+     * Map a spec to all increments that implement it
+     */
+    mapSpecToIncrements(specId: string): Promise<SpecIncrementMapping>;
+    /**
+     * Find all increments that implement a specific user story
+     */
+    findIncrementsByUserStory(userStoryId: string): Promise<IncrementInfo[]>;
+    /**
+     * Get all tasks that implement a specific user story
+     */
+    getTasksForUserStory(userStoryId: string): Promise<TaskInfo[]>;
+    /**
+     * Update spec with increment links in frontmatter (Forward link)
+     */
+    updateSpecWithIncrementLinks(specId: string, incrementId: string): Promise<boolean>;
+    /**
+     * Update increment with spec link in frontmatter (Backward link)
+     */
+    updateIncrementWithSpecLink(incrementId: string, specId: string): Promise<boolean>;
+    /**
+     * Create bidirectional link between spec and increment (atomic operation)
+     */
+    createBidirectionalLink(specId: string, incrementId: string): Promise<{
+        success: boolean;
+        forwardLink: boolean;
+        backwardLink: boolean;
+    }>;
+    /**
+     * Get spec for a given increment (reverse lookup)
+     */
+    getSpecForIncrement(incrementId: string): Promise<string | null>;
+    /**
+     * Validate bidirectional links and detect broken references
+     */
+    validateLinks(): Promise<{
+        valid: boolean;
+        brokenForwardLinks: {
+            specId: string;
+            incrementId: string;
+        }[];
+        brokenBackwardLinks: {
+            incrementId: string;
+            specId: string;
+        }[];
+        orphanedIncrements: string[];
+    }>;
+    /**
+     * Build complete traceability report for a spec
+     */
+    buildTraceabilityReport(specId: string): Promise<TraceabilityReport>;
+    private findIncrementsForSpec;
+    private getTasksFromIncrement;
+    private extractTaskSection;
+    private extractUserStoriesFromTask;
+    private extractGithubIssue;
+    private extractTaskStatus;
+    private findSpecPath;
+    private getUserStoriesFromSpec;
+}
+//# sourceMappingURL=spec-increment-mapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-increment-mapper.d.ts","sourceRoot":"","sources":["../../../../src/core/sync/spec-increment-mapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;CAClD;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC,CAAC;CAC9E;AAED,qBAAa,mBAAmB;IAClB,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,MAAsB;IAEnD;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAuBxE;;OAEG;IACG,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA6B9E;;OAEG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAWpE;;OAEG;IACG,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkCzF;;OAEG;IACG,2BAA2B,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoCxF;;OAEG;IACG,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1E,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC;IAWF;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmBtE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAC7B,KAAK,EAAE,OAAO,CAAC;QACf,kBAAkB,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC9D,mBAAmB,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC/D,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;IA6EF;;OAEG;IACG,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;YA6C5D,qBAAqB;YAsCrB,qBAAqB;IAsCnC,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,0BAA0B;IAkBlC,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,iBAAiB;YAUX,YAAY;YAiCZ,sBAAsB;CAgBrC"}