specweave 0.22.13 → 0.23.0

package/plugins/specweave/lib/vendor/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/plugins/specweave/lib/vendor/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/plugins/specweave/lib/vendor/core/increment/metadata-manager.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Metadata Manager
+ *
+ * Handles CRUD operations for increment metadata (status, type, timestamps).
+ * Part of increment 0007: Smart Status Management
+ */
+import { IncrementMetadata, IncrementMetadataExtended, IncrementStatus, IncrementType } from '../types/increment-metadata.js';
+import { Logger } from '../../utils/logger.js';
+/**
+ * Error thrown when metadata operations fail
+ */
+export declare class MetadataError extends Error {
+    incrementId: string;
+    cause?: Error;
+    constructor(message: string, incrementId: string, cause?: Error);
+}
+/**
+ * Metadata Manager
+ *
+ * Provides CRUD operations and queries for increment metadata
+ */
+export declare class MetadataManager {
+    /**
+     * Logger instance (injectable for testing)
+     */
+    private static logger;
+    /**
+     * Set logger instance (primarily for testing with silentLogger)
+     *
+     * @param logger - Logger instance to use
+     */
+    static setLogger(logger: Logger): void;
+    /**
+     * Get metadata file path for increment
+     */
+    private static getMetadataPath;
+    /**
+     * Get increment directory path
+     */
+    private static getIncrementPath;
+    /**
+     * Check if metadata file exists
+     */
+    static exists(incrementId: string): boolean;
+    /**
+     * Read metadata from file
+     * Creates default metadata if file doesn't exist (lazy initialization)
+     */
+    static read(incrementId: string): IncrementMetadata;
+    /**
+     * Reserved increment IDs that cannot be used
+     * These are status values, special folders, and state files
+     */
+    private static readonly RESERVED_INCREMENT_IDS;
+    /**
+     * Validate increment ID is not a reserved name
+     * Throws if ID is reserved
+     */
+    private static validateNotReserved;
+    /**
+     * Validate increment before creation (check for duplicates and reserved names)
+     * Throws if duplicates exist in other locations or ID is reserved
+     */
+    static validateBeforeCreate(incrementId: string, rootDir?: string): Promise<void>;
+    /**
+     * Write metadata to file
+     * Uses atomic write (temp file → rename)
+     */
+    static write(incrementId: string, metadata: IncrementMetadata): void;
+    /**
+     * Delete metadata file
+     */
+    static delete(incrementId: string): void;
+    /**
+     * Update increment status
+     * Validates transition and updates timestamps
+     *
+     * **CRITICAL**: Also updates active increment state automatically!
+     *
+     * NOTE: This method is now SYNCHRONOUS to ensure spec.md is updated
+     * before returning. This prevents race conditions in tests and ensures
+     * data consistency.
+     */
+    static updateStatus(incrementId: string, newStatus: IncrementStatus, reason?: string): IncrementMetadata;
+    /**
+     * Update spec.md status synchronously (used by updateStatus)
+     *
+     * This is a private helper to avoid async/await in updateStatus() which would
+     * break backward compatibility with callers expecting sync behavior.
+     */
+    private static updateSpecMdStatusSync;
+    /**
+     * Update increment type
+     */
+    static updateType(incrementId: string, type: IncrementType): IncrementMetadata;
+    /**
+     * Touch increment (update lastActivity)
+     */
+    static touch(incrementId: string): IncrementMetadata;
+    /**
+     * Get all increments
+     */
+    static getAll(): IncrementMetadata[];
+    /**
+     * Get increments by status
+     */
+    static getByStatus(status: IncrementStatus): IncrementMetadata[];
+    /**
+     * Get active increments (FAST: cache-first strategy)
+     *
+     * **PERFORMANCE UPGRADE**: Uses ActiveIncrementManager cache instead of scanning all increments
+     * - Old: Scan 31 metadata files (~50ms)
+     * - New: Read 1 cache file + 1-2 metadata files (~5ms) = **10x faster**
+     *
+     * Fallback to full scan if cache is stale or missing
+     */
+    static getActive(): IncrementMetadata[];
+    /**
+     * Get backlog increments
+     */
+    static getBacklog(): IncrementMetadata[];
+    /**
+     * Get paused increments
+     */
+    static getPaused(): IncrementMetadata[];
+    /**
+     * Get completed increments
+     */
+    static getCompleted(): IncrementMetadata[];
+    /**
+     * Get abandoned increments
+     */
+    static getAbandoned(): IncrementMetadata[];
+    /**
+     * Get increments by type
+     */
+    static getByType(type: IncrementType): IncrementMetadata[];
+    /**
+     * Get stale increments (paused >7 days or active >30 days)
+     */
+    static getStale(): IncrementMetadata[];
+    /**
+     * Get increments that should be auto-abandoned (experiments inactive >14 days)
+     */
+    static getShouldAutoAbandon(): IncrementMetadata[];
+    /**
+     * Get extended metadata with computed fields (progress, age, etc.)
+     */
+    static getExtended(incrementId: string): IncrementMetadataExtended;
+    /**
+     * Validate metadata schema
+     */
+    static validate(metadata: IncrementMetadata): boolean;
+    /**
+     * Check if status transition is allowed
+     */
+    static canTransition(from: IncrementStatus, to: IncrementStatus): boolean;
+    /**
+     * Get human-readable status transition error message
+     */
+    static getTransitionError(from: IncrementStatus, to: IncrementStatus): string;
+}
+//# sourceMappingURL=metadata-manager.d.ts.map