specweave 0.18.1 → 0.20.1

package/dist/src/core/increment/duplicate-detector.js

@@ -0,0 +1,276 @@
+/**
+ * Duplicate Detector - Scan filesystem and detect duplicate increments
+ *
+ * Detects increments that exist in multiple locations (active, archive, abandoned)
+ * or have the same increment number with different names.
+ *
+ * Part of increment 0033: Duplicate Increment Prevention System
+ */
+import fs from 'fs-extra';
+import * as path from 'path';
+import { glob } from 'glob';
+/**
+ * Scan all increment folders and detect duplicates
+ */
+export async function detectAllDuplicates(rootDir) {
+    const incrementsDir = path.join(rootDir, '.specweave', 'increments');
+    // Check if increments directory exists
+    if (!await fs.pathExists(incrementsDir)) {
+        return {
+            duplicates: [],
+            totalChecked: 0,
+            duplicateCount: 0
+        };
+    }
+    // Scan all locations in parallel
+    const [active, archived, abandoned] = await Promise.all([
+        scanDirectory(incrementsDir, false),
+        scanDirectory(path.join(incrementsDir, '_archive'), false),
+        scanDirectory(path.join(incrementsDir, '_abandoned'), false)
+    ]);
+    // Group by increment number
+    const byNumber = new Map();
+    const allIncrements = [...active, ...archived, ...abandoned];
+    for (const inc of allIncrements) {
+        const number = extractIncrementNumber(inc.name);
+        if (!number)
+            continue; // Skip non-increment folders
+        if (!byNumber.has(number)) {
+            byNumber.set(number, []);
+        }
+        byNumber.get(number).push(inc);
+    }
+    // Find duplicates (increment number exists in >1 location or >1 name)
+    const duplicates = [];
+    byNumber.forEach((locations, number) => {
+        if (locations.length > 1) {
+            // Duplicate found!
+            const winner = selectWinner(locations);
+            duplicates.push({
+                incrementNumber: number,
+                locations,
+                recommendedWinner: winner,
+                losingVersions: locations.filter(l => l !== winner),
+                resolutionReason: explainWinner(winner, locations)
+            });
+        }
+    });
+    return {
+        duplicates,
+        totalChecked: allIncrements.length,
+        duplicateCount: duplicates.length
+    };
+}
+/**
+ * Detect duplicates for a specific increment number
+ *
+ * Returns ALL increments that have the given number, even if there's only one.
+ * This is used for validation before creating a new increment.
+ */
+export async function detectDuplicatesByNumber(incrementNumber, rootDir) {
+    const incrementsDir = path.join(rootDir, '.specweave', 'increments');
+    // Check if increments directory exists
+    if (!await fs.pathExists(incrementsDir)) {
+        return [];
+    }
+    // Normalize increment number (pad to 4 digits)
+    const normalizedNumber = incrementNumber.padStart(4, '0');
+    // Scan all locations in parallel
+    const [active, archived, abandoned] = await Promise.all([
+        scanDirectory(incrementsDir, false),
+        scanDirectory(path.join(incrementsDir, '_archive'), false),
+        scanDirectory(path.join(incrementsDir, '_abandoned'), false)
+    ]);
+    // Combine all increments and filter by number
+    const allIncrements = [...active, ...archived, ...abandoned];
+    const matchingIncrements = allIncrements.filter(inc => {
+        const number = extractIncrementNumber(inc.name);
+        return number === normalizedNumber;
+    });
+    return matchingIncrements;
+}
+/**
+ * Scan a directory for increment folders
+ */
+async function scanDirectory(dir, throwOnError = false) {
+    try {
+        // Check if directory exists
+        if (!await fs.pathExists(dir)) {
+            return [];
+        }
+        // Find all directories matching increment pattern (####-*)
+        const pattern = path.join(dir, '[0-9][0-9][0-9][0-9]-*');
+        const allPaths = await glob(pattern);
+        const locations = [];
+        for (const incPath of allPaths) {
+            try {
+                const stats = await fs.stat(incPath);
+                if (!stats.isDirectory())
+                    continue;
+                const name = path.basename(incPath);
+                // Skip nested .specweave folders
+                if (incPath.includes('.specweave/increments/.specweave')) {
+                    continue;
+                }
+                // Read metadata
+                const metadataPath = path.join(incPath, 'metadata.json');
+                let metadata = {
+                    status: 'unknown',
+                    lastActivity: new Date(stats.mtime).toISOString()
+                };
+                if (await fs.pathExists(metadataPath)) {
+                    try {
+                        metadata = await fs.readJson(metadataPath);
+                    }
+                    catch (error) {
+                        // Skip corrupted metadata (will be caught by validation)
+                    }
+                }
+                // Count files recursively
+                const allFiles = await glob(path.join(incPath, '**/*'));
+                const fileCount = allFiles.filter(async (f) => {
+                    try {
+                        const fstats = await fs.stat(f);
+                        return fstats.isFile();
+                    }
+                    catch {
+                        return false;
+                    }
+                }).length;
+                // Calculate total size
+                let totalSize = 0;
+                for (const file of allFiles) {
+                    try {
+                        const fstats = await fs.stat(file);
+                        if (fstats.isFile()) {
+                            totalSize += fstats.size;
+                        }
+                    }
+                    catch {
+                        // Skip files we can't read
+                    }
+                }
+                // Check for reports folder
+                const reportsDir = path.join(incPath, 'reports');
+                const hasReports = await fs.pathExists(reportsDir);
+                // Check for GitHub link in metadata
+                const hasGitHubLink = metadata.github && metadata.github.issue;
+                locations.push({
+                    path: incPath,
+                    name,
+                    status: metadata.status || 'unknown',
+                    lastActivity: metadata.lastActivity || new Date(stats.mtime).toISOString(),
+                    fileCount,
+                    totalSize,
+                    hasReports,
+                    hasGitHubLink
+                });
+            }
+            catch (error) {
+                // Skip increments we can't read
+                if (throwOnError)
+                    throw error;
+            }
+        }
+        return locations;
+    }
+    catch (error) {
+        if (throwOnError)
+            throw error;
+        return [];
+    }
+}
+/**
+ * Extract increment number from increment name (e.g., "0001-feature" → "0001")
+ */
+function extractIncrementNumber(name) {
+    const match = name.match(/^(\d{4})-/);
+    return match ? match[1] : null;
+}
+/**
+ * Select winning version based on priority rules
+ */
+function selectWinner(locations) {
+    // Priority 1: Active status > Completed > Paused > Backlog > Abandoned
+    const statusPriority = {
+        active: 5,
+        completed: 4,
+        paused: 3,
+        backlog: 2,
+        abandoned: 1,
+        unknown: 0
+    };
+    // Sort by priority
+    const sorted = [...locations].sort((a, b) => {
+        // 1. Status priority
+        const aPriority = statusPriority[a.status] || 0;
+        const bPriority = statusPriority[b.status] || 0;
+        if (bPriority !== aPriority)
+            return bPriority - aPriority;
+        // 2. Most recent activity
+        const aTime = new Date(a.lastActivity).getTime();
+        const bTime = new Date(b.lastActivity).getTime();
+        if (bTime !== aTime)
+            return bTime - aTime;
+        // 3. Most complete (more files)
+        if (b.fileCount !== a.fileCount)
+            return b.fileCount - a.fileCount;
+        // 4. Location preference (active > _archive > _abandoned)
+        const locationScore = (loc) => {
+            if (loc.path.includes('_abandoned'))
+                return 1;
+            if (loc.path.includes('_archive'))
+                return 2;
+            return 3; // active
+        };
+        return locationScore(b) - locationScore(a);
+    });
+    return sorted[0];
+}
+/**
+ * Explain why this version won
+ */
+function explainWinner(winner, all) {
+    const reasons = [];
+    const statusPriority = {
+        active: 5,
+        completed: 4,
+        paused: 3,
+        backlog: 2,
+        abandoned: 1,
+        unknown: 0
+    };
+    // Check status
+    const winnerStatusPriority = statusPriority[winner.status] || 0;
+    const hasLowerStatus = all.some(loc => loc !== winner && (statusPriority[loc.status] || 0) < winnerStatusPriority);
+    if (hasLowerStatus) {
+        reasons.push(`Higher status (${winner.status})`);
+    }
+    // Check recency
+    const winnerTime = new Date(winner.lastActivity).getTime();
+    const hasOlderActivity = all.some(loc => loc !== winner && new Date(loc.lastActivity).getTime() < winnerTime);
+    if (hasOlderActivity) {
+        const date = new Date(winner.lastActivity).toISOString().split('T')[0];
+        reasons.push(`Most recent activity (${date})`);
+    }
+    // Check completeness
+    const hasFewerFiles = all.some(loc => loc !== winner && loc.fileCount < winner.fileCount);
+    if (hasFewerFiles) {
+        reasons.push(`Most complete (${winner.fileCount} files)`);
+    }
+    // Check location
+    const winnerLocation = winner.path.includes('_abandoned') ? 'abandoned' :
+        winner.path.includes('_archive') ? 'archive' : 'active';
+    const hasWorseLocation = all.some(loc => {
+        const locLocation = loc.path.includes('_abandoned') ? 'abandoned' :
+            loc.path.includes('_archive') ? 'archive' : 'active';
+        const locationPriority = { active: 3, archive: 2, abandoned: 1 };
+        return locationPriority[locLocation] <
+            locationPriority[winnerLocation];
+    });
+    if (hasWorseLocation) {
+        reasons.push(`In ${winnerLocation} location`);
+    }
+    return reasons.length > 0 ? reasons.join(', ') : 'Default selection';
+}
+//# sourceMappingURL=duplicate-detector.js.map

package/dist/src/core/increment/duplicate-detector.js.map

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

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

@@ -0,0 +1,90 @@
+/**
+ * Increment Archiver - Smart archiving system for completed increments
+ *
+ * Keeps the increments folder clean by archiving old/completed increments
+ * while preserving active work and maintaining full history.
+ */
+export interface ArchiveOptions {
+    keepLast?: number;
+    olderThanDays?: number;
+    archiveCompleted?: boolean;
+    preserveActive?: boolean;
+    dryRun?: boolean;
+    increments?: string[];
+    pattern?: string;
+}
+export interface ArchiveResult {
+    archived: string[];
+    skipped: string[];
+    errors: string[];
+    totalSize: number;
+}
+export declare class IncrementArchiver {
+    private logger;
+    private config;
+    private rootDir;
+    private incrementsDir;
+    private archiveDir;
+    private abandonedDir;
+    constructor(rootDir: string);
+    /**
+     * Archive increments based on options
+     */
+    archive(options?: ArchiveOptions): Promise<ArchiveResult>;
+    /**
+     * Get all increment directories (excluding _archive and _abandoned)
+     */
+    private getIncrements;
+    /**
+     * Filter increments based on archive options
+     */
+    private filterIncrements;
+    /**
+     * Determine if an increment should be archived
+     */
+    private shouldArchive;
+    /**
+     * Archive a single increment
+     */
+    private archiveIncrement;
+    /**
+     * Get metadata for an increment
+     */
+    private getMetadata;
+    /**
+     * Check if increment has uncommitted changes
+     */
+    private hasUncommittedChanges;
+    /**
+     * Update references after archiving
+     */
+    private updateReferences;
+    /**
+     * Calculate total size of archived increments
+     */
+    private calculateSize;
+    /**
+     * Get directory size recursively
+     */
+    private getDirectorySize;
+    /**
+     * Restore an increment from archive
+     */
+    restore(increment: string): Promise<void>;
+    /**
+     * List archived increments
+     */
+    listArchived(): Promise<string[]>;
+    /**
+     * Get archive statistics
+     */
+    getStats(): Promise<{
+        active: number;
+        archived: number;
+        abandoned: number;
+        totalSize: number;
+        oldestActive: string | null;
+        newestArchived: string | null;
+    }>;
+}
+//# sourceMappingURL=increment-archiver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"increment-archiver.d.ts","sourceRoot":"","sources":["../../../../src/core/increment/increment-archiver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,MAAM;IAS3B;;OAEG;IACG,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAmDnE;;OAEG;YACW,aAAa;IAsB3B;;OAEG;YACW,gBAAgB;IAkD9B;;OAEG;YACW,aAAa;IAkD3B;;OAEG;YACW,gBAAgB;IAkC9B;;OAEG;YACW,WAAW;IAczB;;OAEG;YACW,qBAAqB;IAMnC;;OAEG;YACW,gBAAgB;IA2B9B;;OAEG;YACW,aAAa;IAa3B;;OAEG;YACW,gBAAgB;IAc9B;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC/C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BvC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;CAuBH"}