specweave 2.3.0 → 3.0.1

package/dist/src/core/increment/status-change-sync-trigger.js

@@ -1,319 +0,0 @@
-/**
- * Status Change Sync Trigger
- *
- * Automatically triggers living docs and GitHub sync when increment status changes.
- *
- * WHY THIS EXISTS:
- * - Users expect GitHub issues to update automatically when work starts/completes
- * - Manual `sw:sync-progress` is friction
- * - Task completion hook only fires on task changes, not status changes
- *
- * SAFETY GUARDS:
- * - Non-blocking: Uses setTimeout to prevent blocking updateStatus()
- * - Circuit breaker: Prevents sync storms when GitHub is down
- * - Error isolation: Sync failures don't crash status updates
- * - Selective: Only syncs for meaningful transitions
- *
- * ARCHITECTURE:
- * ```
- * MetadataManager.updateStatus()
- *   └─> StatusChangeSyncTrigger.triggerIfNeeded()
- *         ├─ Is transition sync-worthy?
- *         ├─ Circuit breaker open?
- *         ├─> Auto-create issues if missing (v1.0.19+)
- *         ├─> LivingDocsSync.syncIncrement()
- *         └─> Auto-close issues on completion (v1.0.19+)
- * ```
- *
- * v1.0.19 ADDITIONS:
- * - Auto-create external issues if config.sync.autoCreateOnIncrement = true
- * - Auto-close external issues when status → completed
- */
-import { IncrementStatus } from '../types/increment-metadata.js';
-import { SyncCircuitBreaker } from './sync-circuit-breaker.js';
-import { SyncThrottle } from '../sync-throttle.js';
-import { consoleLogger } from '../../utils/logger.js';
-import { resolveEffectiveRoot } from '../../utils/find-project-root.js';
-import { livingDocsEnabled } from '../living-docs/living-docs-enabled.js';
-import { externalSyncConfigured } from '../../sync/external-sync-configured.js';
-export class StatusChangeSyncTrigger {
-    /**
-     * Trigger sync if status transition warrants it
-     *
-     * NON-BLOCKING: Spawns async sync, doesn't wait for result
-     * SAFE: Errors are caught and logged, never thrown
-     *
-     * @param incrementId - Increment ID
-     * @param oldStatus - Previous status
-     * @param newStatus - New status
-     */
-    static async triggerIfNeeded(incrementId, oldStatus, newStatus) {
-        // Skip sync in test environment to prevent real API calls and unhandled rejections
-        if (process.env.NODE_ENV === 'test' || process.env.VITEST) {
-            return;
-        }
-        // Skip when completeIncrement() is running — onIncrementDone() handles sync
-        if (StatusChangeSyncTrigger.suppressForCompletion) {
-            return;
-        }
-        // CRITICAL FIX (2025-11-24): Check if feature_id is null for ACTIVE increments
-        // This handles the case where increment was created directly with "active" status
-        // but living docs sync never ran (no FS-XXX folder created)
-        let forceSync = false;
-        if (newStatus === IncrementStatus.ACTIVE && livingDocsEnabled(resolveEffectiveRoot())) {
-            // Only meaningful when living docs are switched on: with the 2.0 default
-            // (`livingDocs: false`) there is no FS-xxx folder to back-fill, and
-            // announcing a "forced living docs sync" was a straight lie.
-            forceSync = await this.hasMissingFeatureId(incrementId);
-            if (forceSync) {
-                this.logger.log(`📚 Increment ${incrementId} missing feature_id - forcing living docs sync...`);
-            }
-        }
-        // Check if this transition needs sync (or force sync for missing feature_id)
-        if (!forceSync && !this.isSyncWorthy(oldStatus, newStatus)) {
-            return;
-        }
-        // Nothing to sync TO. With the 2.0 defaults (livingDocs: false, no tracker
-        // configured) there is no destination at all, and running the pipeline only
-        // produced the line `✅ Auto-synced increment … to external tools` in a
-        // project whose own `doctor` reports "no external sync enabled".
-        const projectRoot = resolveEffectiveRoot();
-        if (!livingDocsEnabled(projectRoot) && !externalSyncConfigured(projectRoot)) {
-            return;
-        }
-        // Check circuit breaker
-        if (!this.circuitBreaker.canSync()) {
-            this.logger.warn('⚠️  Sync circuit breaker open - skipping auto-sync');
-            this.logger.warn('💡 Run sw:sync-progress manually to retry');
-            return;
-        }
-        // Throttle: skip if another trigger path already fired for this increment
-        const throttle = new SyncThrottle(resolveEffectiveRoot());
-        if (throttle.shouldSkip(incrementId)) {
-            this.logger.log(`⏭️  Sync throttled for ${incrementId} (recent sync in progress)`);
-            return;
-        }
-        // Spawn non-blocking sync (pass newStatus for completion handling)
-        this.spawnAsyncSync(incrementId, newStatus)
-            .catch(error => {
-            this.circuitBreaker.recordFailure();
-            this.logger.error(`❌ Auto-sync failed for ${incrementId}:`, error.message);
-            this.logger.log('💡 Run sw:sync-progress to retry');
-        });
-    }
-    /**
-     * Check if increment has missing feature_id (living docs not synced)
-     * AND spec.md exists (required for sync to work)
-     *
-     * CRITICAL FIX (2025-11-24): Also check spec.md exists
-     * In single-prompt scenarios, feature_id may be null because spec.md
-     * doesn't exist yet. We should only force sync if spec.md is ready.
-     *
-     * @param incrementId - Increment ID
-     * @returns true if feature_id is null/undefined AND spec.md exists
-     */
-    static async hasMissingFeatureId(incrementId) {
-        try {
-            const { promises: fs, existsSync } = await import('fs');
-            const path = await import('path');
-            const incrementPath = path.join(resolveEffectiveRoot(), '.specweave/increments', incrementId);
-            // First check if spec.md exists - if not, sync would fail anyway
-            const specPath = path.join(incrementPath, 'spec.md');
-            if (!existsSync(specPath)) {
-                // spec.md doesn't exist yet - don't force sync
-                // Sync will trigger when spec.md is created
-                return false;
-            }
-            // Now check if feature_id is missing
-            const metadataPath = path.join(incrementPath, 'metadata.json');
-            const content = await fs.readFile(metadataPath, 'utf-8');
-            const metadata = JSON.parse(content);
-            // Check if feature_id is null, undefined, or empty string
-            return !metadata.feature_id;
-        }
-        catch {
-            // File doesn't exist or can't be read - don't force sync
-            return false;
-        }
-    }
-    /**
-     * Check if status transition needs sync
-     *
-     * SYNC-WORTHY TRANSITIONS:
-     * - planning → active (work started)
-     * - active → completed (work finished - legacy direct completion)
-     * - active → ready_for_review (all tasks complete, ready for user confirmation)
-     * - ready_for_review → completed (work approved - v0.28.63+ user confirmation)
-     * - completed → active (work reopened)
-     * - backlog → active (backlog item started)
-     * - paused → active (work resumed)
-     *
-     * NOT SYNC-WORTHY:
-     * - active → paused (temporary pause)
-     * - active → backlog (deprioritized)
-     * - Any → abandoned (cancelled)
-     *
-     * @param oldStatus - Previous status
-     * @param newStatus - New status
-     * @returns true if sync should be triggered
-     */
-    static isSyncWorthy(oldStatus, newStatus) {
-        const transition = `${oldStatus} → ${newStatus}`;
-        const SYNC_WORTHY = [
-            'planned → active', // Work started
-            'planning → active', // 1.x spelling, still seen on disk
-            'active → completed', // Work finished (legacy direct completion)
-            'active → ready_for_review', // All tasks complete, pending user confirmation
-            'ready_for_review → completed', // Work approved (v0.28.63+ user confirmation)
-            'completed → active', // Work reopened
-            'backlog → active', // Backlog item started
-            'paused → active', // Work resumed
-            // Defense-in-depth: catch-up sync for direct-to-completed transitions.
-            // Auto-walk goes through intermediates, but if metadata is edited
-            // directly these ensure sync still happens.
-            'planned → completed', // Direct completion (bypassed CLI)
-            'planning → completed', // 1.x spelling, still seen on disk
-            'backlog → completed', // Direct completion (bypassed CLI)
-            'paused → completed', // Direct completion (bypassed CLI)
-            'paused → ready_for_review' // Paused -> review (valid transition)
-        ];
-        return SYNC_WORTHY.includes(transition);
-    }
-    /**
-     * Spawn async sync (non-blocking)
-     *
-     * Uses setTimeout(..., 0) to ensure updateStatus() returns immediately.
-     * LivingDocsSync will handle GitHub/JIRA/ADO sync based on config.
-     *
-     * v1.0.19: Also handles auto-create if issues don't exist
-     *
-     * @param incrementId - Increment ID
-     * @param newStatus - Optional new status (for completion handling)
-     */
-    static async spawnAsyncSync(incrementId, newStatus) {
-        const projectRoot = resolveEffectiveRoot();
-        // Dynamic import to avoid circular dependency
-        const { LivingDocsSync } = await import('../living-docs/living-docs-sync.js');
-        const externalConfigured = externalSyncConfigured(projectRoot);
-        const synced = [];
-        const syncFn = async () => {
-            // Record throttle BEFORE sync to prevent reentrancy.
-            // Syncs take 10-30s but the throttle window is 5s — recording after
-            // sync allowed new syncs to fire while one was still running,
-            // creating a loop that exhausted GitHub API rate limits.
-            new SyncThrottle(projectRoot).record(incrementId);
-            // v1.0.19: Check if we need to auto-create external issues
-            if (externalConfigured) {
-                await this.autoCreateIfNeeded(projectRoot, incrementId);
-                synced.push('external tools');
-            }
-            // Run living docs sync — 2.0 generates docs only on `livingDocs: 'onDone'`.
-            // (This trigger is how `livingDocs: false` projects still ended up with a
-            // freshly written FEATURE.md at the moment of closure.)
-            if (livingDocsEnabled(projectRoot)) {
-                const sync = new LivingDocsSync(projectRoot, {
-                    logger: this.logger
-                });
-                await sync.syncIncrement(incrementId);
-                synced.push('living docs');
-            }
-            // v1.0.19: Auto-close issues on completion
-            if (externalConfigured && newStatus === IncrementStatus.COMPLETED) {
-                await this.autoCloseExternalIssues(projectRoot, incrementId);
-            }
-            this.circuitBreaker.recordSuccess();
-            // Name only the destinations that were actually written to. Claiming
-            // "external tools" in a project with no tracker configured taught users
-            // to distrust every sync line the CLI prints.
-            if (synced.length > 0) {
-                this.logger.log(`✅ Auto-synced increment ${incrementId} to ${synced.join(' and ')}`);
-            }
-        };
-        // All transitions run synchronously to ensure sync completes
-        // before the process exits. The previous setTimeout(0) pattern
-        // caused sync to be lost when the process exited quickly.
-        await syncFn();
-    }
-    /**
-     * Auto-create external issues if:
-     * 1. config.sync.autoCreateOnIncrement = true
-     * 2. No external issue linked to this increment
-     *
-     * @since v1.0.19
-     */
-    /**
-     * (0348) GitHub issue creation is handled by LivingDocsSync → GitHubFeatureSync chain
-     * (called at line 203 via syncIncrement). This method now only handles JIRA/ADO.
-     */
-    static async autoCreateIfNeeded(projectRoot, incrementId) {
-        try {
-            // Dynamic import to avoid circular dependency
-            const { autoCreateExternalIssue } = await import('../../sync/external-issue-auto-creator.js');
-            // ExternalIssueAutoCreator now skips GitHub (handled by GitHubFeatureSync)
-            // but still handles JIRA/ADO auto-creation
-            const result = await autoCreateExternalIssue(projectRoot, incrementId, this.logger);
-            if (result.success && !result.skipped) {
-                this.logger.log(`📝 Auto-created ${result.provider} issue for ${incrementId}: ${result.issueNumber}`);
-            }
-        }
-        catch (error) {
-            // Non-blocking - log and continue
-            this.logger.warn(`⚠️  Auto-create check failed (non-blocking): ${error}`);
-        }
-    }
-    /**
-     * Auto-close external issues when increment status becomes COMPLETED
-     *
-     * (0348) GitHub closure is handled by GitHubFeatureSync via LivingDocsSync chain
-     * at line 203. SyncCoordinator.syncIncrementClosure() now only handles JIRA/ADO.
-     *
-     * @since v1.0.19
-     */
-    static async autoCloseExternalIssues(projectRoot, incrementId) {
-        try {
-            // Dynamic import to avoid circular dependency
-            const { SyncCoordinator } = await import('../../sync/sync-coordinator.js');
-            const coordinator = new SyncCoordinator({
-                projectRoot,
-                incrementId,
-                logger: this.logger,
-            });
-            // Close GitHub/JIRA/ADO issues with proper completion comments
-            const result = await coordinator.syncIncrementClosure();
-            if (result.success && result.closedIssues.length > 0) {
-                this.logger.log(`🎉 Auto-closed external issues for ${incrementId} (${result.closedIssues.length} closed)`);
-            }
-        }
-        catch (error) {
-            // Non-blocking - log and continue
-            this.logger.warn(`⚠️  Auto-close failed (non-blocking): ${error}`);
-        }
-    }
-    /**
-     * Get circuit breaker state (for diagnostics)
-     */
-    static getCircuitBreakerState() {
-        return this.circuitBreaker.getState();
-    }
-    /**
-     * Reset circuit breaker (for testing/admin)
-     */
-    static resetCircuitBreaker() {
-        this.circuitBreaker.reset();
-    }
-    /**
-     * Set custom logger (for testing)
-     */
-    static setLogger(logger) {
-        this.logger = logger;
-    }
-}
-StatusChangeSyncTrigger.circuitBreaker = new SyncCircuitBreaker();
-StatusChangeSyncTrigger.logger = consoleLogger;
-/**
- * When true, triggerIfNeeded() is a no-op.
- * Set by completeIncrement() to prevent double-sync:
- * onIncrementDone() is the single sync point during completion.
- */
-StatusChangeSyncTrigger.suppressForCompletion = false;
-//# sourceMappingURL=status-change-sync-trigger.js.map

package/dist/src/core/increment/status-change-sync-trigger.js.map

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

package/dist/src/core/increment/task-state-manager.d.ts

@@ -1,75 +0,0 @@
-/**
- * Task State Manager - Single Source of Truth
- *
- * Enforces that implementation checkboxes are the ONLY way to mark tasks complete.
- * Header markers (✅ COMPLETE) are DERIVED and auto-computed from checkboxes.
- *
- * This prevents inconsistencies where:
- * - Header says "✅ COMPLETE" but checkboxes are unchecked
- * - Checkboxes all checked but header missing marker
- *
- * @see .specweave/increments/0037/reports/ULTRATHINK-LONG-TERM-PREVENTION.md
- */
-export interface TaskState {
-    /** Task ID (e.g., "T-001", "T-123-DISCIPLINE") */
-    taskId: string;
-    /** Implementation checkbox statistics */
-    implementationCheckboxes: {
-        total: number;
-        checked: number;
-    };
-    /** Computed completion status (derived from checkboxes) */
-    isComplete: boolean;
-    /** Expected header marker (computed, not manually set) */
-    headerMarker: string | null;
-    /** Whether header and checkboxes match */
-    isConsistent: boolean;
-}
-export interface ValidationResult {
-    /** Whether task is consistent */
-    valid: boolean;
-    /** Error message if validation failed */
-    error?: string;
-    /** Auto-fixed content (if validation failed) */
-    fix?: string;
-}
-export declare class TaskStateManager {
-    /**
-     * Compute task state from SSOT (implementation checkboxes)
-     *
-     * This is the canonical way to determine task completion.
-     * Header markers are DERIVED from this, never trusted directly.
-     */
-    computeTaskState(taskContent: string): TaskState;
-    /**
-     * Validate task consistency
-     *
-     * Checks if header marker matches what checkboxes say.
-     * Returns auto-fix suggestion if inconsistent.
-     */
-    validate(taskContent: string): ValidationResult;
-    /**
-     * Auto-fix header to match SSOT
-     *
-     * Adds or removes "✅ COMPLETE" marker based on checkbox state.
-     * This is the canonical way to sync headers with reality.
-     */
-    autoFixHeader(taskContent: string): string;
-    /**
-     * Extract task ID from content
-     */
-    private extractTaskId;
-    /**
-     * Extract implementation checkboxes from content
-     */
-    private extractImplementationCheckboxes;
-    /**
-     * Extract header marker from content
-     */
-    private extractHeaderMarker;
-    /**
-     * Set header marker in content
-     */
-    private setHeaderMarker;
-}
-//# sourceMappingURL=task-state-manager.d.ts.map

package/dist/src/core/increment/task-state-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"task-state-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/increment/task-state-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IAEf,yCAAyC;IACzC,wBAAwB,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;IAEpB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,0CAA0C;IAC1C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAC;IAEf,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,gBAAgB;IAC3B;;;;;OAKG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAiBhD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB;IAkB/C;;;;;OAKG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAK1C;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAuBvC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,OAAO,CAAC,eAAe;CAWxB"}

package/dist/src/core/increment/task-state-manager.js

@@ -1,117 +0,0 @@
-/**
- * Task State Manager - Single Source of Truth
- *
- * Enforces that implementation checkboxes are the ONLY way to mark tasks complete.
- * Header markers (✅ COMPLETE) are DERIVED and auto-computed from checkboxes.
- *
- * This prevents inconsistencies where:
- * - Header says "✅ COMPLETE" but checkboxes are unchecked
- * - Checkboxes all checked but header missing marker
- *
- * @see .specweave/increments/0037/reports/ULTRATHINK-LONG-TERM-PREVENTION.md
- */
-export class TaskStateManager {
-    /**
-     * Compute task state from SSOT (implementation checkboxes)
-     *
-     * This is the canonical way to determine task completion.
-     * Header markers are DERIVED from this, never trusted directly.
-     */
-    computeTaskState(taskContent) {
-        const taskId = this.extractTaskId(taskContent);
-        const checkboxes = this.extractImplementationCheckboxes(taskContent);
-        const total = checkboxes.length;
-        const checked = checkboxes.filter(c => c.checked).length;
-        const isComplete = total > 0 && checked === total;
-        return {
-            taskId,
-            implementationCheckboxes: { total, checked },
-            isComplete,
-            headerMarker: isComplete ? '✅ COMPLETE' : null,
-            isConsistent: true // By definition, since computed from SSOT
-        };
-    }
-    /**
-     * Validate task consistency
-     *
-     * Checks if header marker matches what checkboxes say.
-     * Returns auto-fix suggestion if inconsistent.
-     */
-    validate(taskContent) {
-        const expectedState = this.computeTaskState(taskContent);
-        const actualMarker = this.extractHeaderMarker(taskContent);
-        const expected = expectedState.headerMarker;
-        const actual = actualMarker;
-        if (actual !== expected) {
-            return {
-                valid: false,
-                error: `Header marker mismatch: expected "${expected}", got "${actual}"`,
-                fix: this.autoFixHeader(taskContent)
-            };
-        }
-        return { valid: true };
-    }
-    /**
-     * Auto-fix header to match SSOT
-     *
-     * Adds or removes "✅ COMPLETE" marker based on checkbox state.
-     * This is the canonical way to sync headers with reality.
-     */
-    autoFixHeader(taskContent) {
-        const state = this.computeTaskState(taskContent);
-        return this.setHeaderMarker(taskContent, state.headerMarker);
-    }
-    /**
-     * Extract task ID from content
-     */
-    extractTaskId(content) {
-        const match = content.match(/^###\s+(T-\d+[-A-Z]*)/m);
-        return match ? match[1] : '';
-    }
-    /**
-     * Extract implementation checkboxes from content
-     */
-    extractImplementationCheckboxes(content) {
-        const checkboxes = [];
-        // Find Implementation section
-        const implMatch = content.match(/\*\*Implementation\*\*:([\s\S]*?)(?=\n\*\*|\n---|$)/);
-        if (!implMatch)
-            return checkboxes;
-        const implSection = implMatch[1];
-        // Extract all checkboxes
-        const checkboxPattern = /-\s*\[([ x])\]\s*(.+)/g;
-        let match;
-        while ((match = checkboxPattern.exec(implSection)) !== null) {
-            checkboxes.push({
-                text: match[2].trim(),
-                checked: match[1] === 'x'
-            });
-        }
-        return checkboxes;
-    }
-    /**
-     * Extract header marker from content
-     */
-    extractHeaderMarker(content) {
-        // Match task header line
-        const headerMatch = content.match(/^###\s+T-\d+[-A-Z]*:?\s+[^\n]+/m);
-        if (!headerMatch)
-            return null;
-        const headerLine = headerMatch[0];
-        // Check if header contains ✅ COMPLETE marker
-        return headerLine.includes('✅ COMPLETE') ? '✅ COMPLETE' : null;
-    }
-    /**
-     * Set header marker in content
-     */
-    setHeaderMarker(content, marker) {
-        // Remove existing marker if present
-        let updated = content.replace(/(###\s+T-\d+[-A-Z]*:?\s+.+?)\s*✅ COMPLETE/m, '$1');
-        // Add new marker if needed
-        if (marker) {
-            updated = updated.replace(/(###\s+T-\d+[-A-Z]*:?\s+[^\n]+)/m, `$1 ${marker}`);
-        }
-        return updated;
-    }
-}
-//# sourceMappingURL=task-state-manager.js.map

package/dist/src/core/increment/task-state-manager.js.map

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

package/dist/src/core/increment-validator.d.ts

@@ -1,55 +0,0 @@
-/**
- * Result of increment number validation
- */
-export interface IncrementValidationResult {
-    /** Whether the increment number is valid */
-    isValid: boolean;
-    /** Warnings about the increment number */
-    warnings: string[];
-    /** Suggestions for better numbering */
-    suggestions: string[];
-    /** Expected sequential number */
-    expectedNumber?: string;
-    /** Number provided by user */
-    providedNumber?: string;
-}
-/**
- * Parses an increment number from an increment ID.
- *
- * @param incrementId - Full increment ID (e.g., "0157-feature-name")
- * @returns Numeric value or null if invalid format
- *
- * @example
- * ```typescript
- * parseIncrementNumber("0157-feature-name") // => 157
- * parseIncrementNumber("invalid") // => null
- * ```
- */
-export declare function parseIncrementNumber(incrementId: string): number | null;
-/**
- * Validates an increment number against existing increments.
- *
- * Checks if the requested number is:
- * - Sequential (expected behavior)
- * - A forward jump (skips numbers)
- * - A backfill (fills gap in numbering)
- *
- * @param requestedNumber - Requested increment number (e.g., "0158")
- * @param existingIncrements - Array of existing increment IDs
- * @returns Validation result with warnings and suggestions
- *
- * @example
- * ```typescript
- * const result = validateIncrementNumber("0160", ["0157-feature", "0158-bug"]);
- * // result.warnings: ["Skipping 1 number (0159)"]
- * // result.suggestions: ["Consider using 0159 for better tracking"]
- * ```
- */
-export declare function validateIncrementNumber(requestedNumber: string, existingIncrements: string[]): IncrementValidationResult;
-/**
- * Logs increment validation results to console.
- *
- * @param result - Validation result from validateIncrementNumber
- */
-export declare function logValidationResult(result: IncrementValidationResult): void;
-//# sourceMappingURL=increment-validator.d.ts.map

package/dist/src/core/increment-validator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"increment-validator.d.ts","sourceRoot":"","sources":["../../../src/core/increment-validator.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMvE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,MAAM,EAAE,GAC3B,yBAAyB,CA4F3B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI,CAoB3E"}