specweave 1.0.464 → 1.0.466

package/dist/plugins/specweave/lib/vendor/core/increment/duplicate-detector.js

@@ -0,0 +1,281 @@
+/**
+ * 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 * as fs from '../../utils/fs-native.js';
+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{3,4})E?-/);
+    return match ? match[1].padStart(4, '0') : null;
+}
+/**
+ * Status priority for winner selection (higher = better)
+ */
+const STATUS_PRIORITY = {
+    active: 5,
+    completed: 4,
+    paused: 3,
+    backlog: 2,
+    abandoned: 1,
+    unknown: 0
+};
+/**
+ * Location priority for winner selection (higher = better)
+ */
+const LOCATION_PRIORITY = {
+    active: 3,
+    archive: 2,
+    abandoned: 1
+};
+/**
+ * Get location type from path
+ */
+function getLocationType(loc) {
+    if (loc.path.includes('_abandoned'))
+        return 'abandoned';
+    if (loc.path.includes('_archive'))
+        return 'archive';
+    return 'active';
+}
+/**
+ * Get status priority for a location
+ */
+function getStatusPriority(loc) {
+    return STATUS_PRIORITY[loc.status] ?? 0;
+}
+/**
+ * Get location priority for a location
+ */
+function getLocationPriority(loc) {
+    return LOCATION_PRIORITY[getLocationType(loc)];
+}
+/**
+ * Select winning version based on priority rules
+ */
+function selectWinner(locations) {
+    const sorted = [...locations].sort((a, b) => {
+        // 1. Status priority
+        const statusDiff = getStatusPriority(b) - getStatusPriority(a);
+        if (statusDiff !== 0)
+            return statusDiff;
+        // 2. Most recent activity
+        const timeDiff = new Date(b.lastActivity).getTime() - new Date(a.lastActivity).getTime();
+        if (timeDiff !== 0)
+            return timeDiff;
+        // 3. Most complete (more files)
+        const fileDiff = b.fileCount - a.fileCount;
+        if (fileDiff !== 0)
+            return fileDiff;
+        // 4. Location preference (active > _archive > _abandoned)
+        return getLocationPriority(b) - getLocationPriority(a);
+    });
+    return sorted[0];
+}
+/**
+ * Explain why this version won
+ */
+function explainWinner(winner, all) {
+    const reasons = [];
+    const winnerStatusPriority = getStatusPriority(winner);
+    const winnerTime = new Date(winner.lastActivity).getTime();
+    const winnerLocation = getLocationType(winner);
+    const winnerLocationPriority = getLocationPriority(winner);
+    // Check status
+    if (all.some(loc => loc !== winner && getStatusPriority(loc) < winnerStatusPriority)) {
+        reasons.push(`Higher status (${winner.status})`);
+    }
+    // Check recency
+    if (all.some(loc => loc !== winner && new Date(loc.lastActivity).getTime() < winnerTime)) {
+        const date = new Date(winner.lastActivity).toISOString().split('T')[0];
+        reasons.push(`Most recent activity (${date})`);
+    }
+    // Check completeness
+    if (all.some(loc => loc !== winner && loc.fileCount < winner.fileCount)) {
+        reasons.push(`Most complete (${winner.fileCount} files)`);
+    }
+    // Check location
+    if (all.some(loc => loc !== winner && getLocationPriority(loc) < winnerLocationPriority)) {
+        reasons.push(`In ${winnerLocation} location`);
+    }
+    return reasons.length > 0 ? reasons.join(', ') : 'Default selection';
+}
+//# sourceMappingURL=duplicate-detector.js.map

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

@@ -0,0 +1,278 @@
+/**
+ * Metadata Manager
+ *
+ * Handles CRUD operations for increment metadata (status, type, timestamps).
+ * Part of increment 0007: Smart Status Management
+ */
+import { IncrementMetadata, IncrementMetadataExtended, IncrementMetadataV2, IncrementStatus, IncrementType, SyncTarget, PrRef } 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 | undefined;
+    constructor(message: string, incrementId: string, cause?: Error | undefined);
+}
+/**
+ * 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
+     *
+     * Uses resolveEffectiveRoot() to find the umbrella root in multi-repo setups,
+     * or the nearest project root in single-repo setups.
+     *
+     * SECURITY: Validates increment ID to prevent path traversal attacks.
+     */
+    private static getMetadataPath;
+    /**
+     * Get increment directory path
+     *
+     * Uses resolveEffectiveRoot() to find the umbrella root in multi-repo setups,
+     * or the nearest project root in single-repo setups.
+     *
+     * SECURITY: Validates increment ID to prevent path traversal attacks.
+     */
+    private static getIncrementPath;
+    /**
+     * Check if metadata file exists
+     */
+    static exists(incrementId: string, rootDir?: string): boolean;
+    /**
+     * Read metadata from file
+     * Creates default metadata if file doesn't exist (lazy initialization)
+     */
+    static read(incrementId: string, rootDir?: 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)
+     *
+     * @param incrementId - Increment ID
+     * @param metadata - Metadata to write
+     * @param rootDir - Optional root directory (defaults to process.cwd())
+     */
+    static write(incrementId: string, metadata: IncrementMetadata, rootDir?: string): void;
+    /**
+     * Delete metadata file
+     */
+    static delete(incrementId: string, rootDir?: 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, rootDir?: 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
+     *
+     * Uses resolveEffectiveRoot() to find umbrella root in multi-repo setups.
+     */
+    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 and auto-correct metadata schema issues.
+     *
+     * Fixes:
+     *  - id: short numeric IDs (e.g. "0399") expanded to full slug using folderName
+     *  - type: non-standard aliases mapped to canonical enum values
+     *  - created/createdAt: legacy field renamed
+     *  - externalLinks: ensured to exist (defaults to {})
+     *  - status/priority/testMode/coverageTarget: sensible defaults applied
+     *
+     * @returns corrected metadata, whether any correction was made, and warnings
+     */
+    private static validateMetadataSchema;
+    /**
+     * 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;
+    /**
+     * Set the external tool sync target for an increment
+     *
+     * This explicitly specifies which sync profile the increment uses.
+     * The sync target provides audit trail and deterministic sync behavior.
+     *
+     * @param incrementId - Increment ID
+     * @param syncTarget - Sync target configuration
+     * @param rootDir - Optional root directory
+     * @returns Updated metadata
+     *
+     * @example
+     * ```typescript
+     * MetadataManager.setSyncTarget('0142-feature', {
+     *   profileId: 'github-frontend',
+     *   provider: 'github',
+     *   derivedFrom: 'project-mapping',
+     *   setAt: new Date().toISOString(),
+     *   sourceProjectId: 'frontend-app'
+     * });
+     * ```
+     */
+    static setSyncTarget(incrementId: string, syncTarget: SyncTarget, rootDir?: string): IncrementMetadataV2;
+    /**
+     * Get the sync target for an increment
+     *
+     * @param incrementId - Increment ID
+     * @param rootDir - Optional root directory
+     * @returns Sync target or undefined if not set
+     */
+    static getSyncTarget(incrementId: string, rootDir?: string): SyncTarget | undefined;
+    /**
+     * Clear the sync target for an increment
+     *
+     * Use this when the external tool configuration changes and
+     * the increment needs to be re-resolved.
+     *
+     * @param incrementId - Increment ID
+     * @param rootDir - Optional root directory
+     * @returns Updated metadata
+     */
+    static clearSyncTarget(incrementId: string, rootDir?: string): IncrementMetadataV2;
+    /**
+     * Check if increment has a sync target configured
+     *
+     * @param incrementId - Increment ID
+     * @param rootDir - Optional root directory
+     * @returns true if sync target is set
+     */
+    static hasSyncTarget(incrementId: string, rootDir?: string): boolean;
+    /**
+     * Add a pull request reference to an increment (v1.0.437+)
+     *
+     * Appends a PrRef to the prRefs array. Deduplicates by repoSlug
+     * (or by branch name for single-repo increments without repoSlug).
+     *
+     * @param incrementId - Increment ID
+     * @param ref - Pull request reference to add
+     * @param rootDir - Optional root directory
+     * @returns Updated metadata
+     */
+    static addPrRef(incrementId: string, ref: PrRef, rootDir?: string): IncrementMetadataV2;
+    /**
+     * Get pull request references for an increment
+     *
+     * @param incrementId - Increment ID
+     * @param rootDir - Optional root directory
+     * @returns Array of PR refs, or empty array if none
+     */
+    static getPrRefs(incrementId: string, rootDir?: string): PrRef[];
+    /**
+     * Get all increments with a specific sync provider
+     *
+     * Useful for bulk operations on all GitHub/JIRA/ADO synced increments.
+     *
+     * @param provider - Provider type ('github', 'jira', 'ado')
+     * @returns Array of increments with that provider configured
+     */
+    static getByProvider(provider: 'github' | 'jira' | 'ado'): IncrementMetadataV2[];
+    /**
+     * Get all increments with a specific sync profile
+     *
+     * @param profileId - Profile ID from config.sync.profiles
+     * @returns Array of increments using that profile
+     */
+    static getByProfile(profileId: string): IncrementMetadataV2[];
+}
+//# sourceMappingURL=metadata-manager.d.ts.map