specweave 0.12.6 → 0.13.0

package/dist/core/increment/discipline-checker.js

@@ -0,0 +1,274 @@
+/**
+ * Discipline Checker - Validates increment discipline rules
+ *
+ * Enforces the iron rule: Cannot start increment N+1 until increment N is DONE
+ * Checks WIP limits, incomplete work, and emergency interrupt rules
+ */
+import { IncrementStatusDetector } from '../increment-status.js';
+import { ConfigManager } from '../config-manager.js';
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Checks increment discipline compliance
+ */
+export class DisciplineChecker {
+    /**
+     * Create a new DisciplineChecker
+     *
+     * @param projectRoot - Root directory of the project
+     * @param customLimits - Optional custom limits (overrides config)
+     */
+    constructor(projectRoot = process.cwd(), customLimits) {
+        this.projectRoot = projectRoot;
+        this.detector = new IncrementStatusDetector(projectRoot);
+        // Load limits from config or use defaults
+        if (customLimits) {
+            this.limits = customLimits;
+        }
+        else {
+            const configManager = new ConfigManager(projectRoot);
+            const config = configManager.load();
+            this.limits = config.limits || this.getDefaultLimits();
+        }
+    }
+    /**
+     * Get default discipline limits
+     */
+    getDefaultLimits() {
+        return {
+            maxActiveIncrements: 1,
+            hardCap: 2,
+            allowEmergencyInterrupt: true,
+            typeBehaviors: {
+                canInterrupt: ['hotfix', 'bug'],
+                autoAbandonDays: {
+                    experiment: 14,
+                },
+            },
+        };
+    }
+    /**
+     * Validate increment discipline
+     *
+     * @param options - Validation options
+     * @returns ValidationResult with compliance status and violations
+     */
+    async validate(options) {
+        const violations = [];
+        try {
+            // Phase 1: Detect all increments
+            const allIncrements = await this.getAllIncrements();
+            // Phase 2: Count by status and get status map
+            const { statusCounts, statusMap } = this.countByStatus(allIncrements);
+            // Phase 3: Find incomplete increments (active or paused, not completed/abandoned)
+            const incomplete = allIncrements.filter((inc) => {
+                const status = statusMap.get(inc.id) || 'active';
+                return inc.exists && (status === 'active' || status === 'paused');
+            });
+            // Phase 4: Validate rules
+            this.validateHardCap(statusCounts.active, violations);
+            this.validateWIPLimit(statusCounts.active, violations);
+            // Note: validateIncompleteWork is used during increment creation, not here
+            // Having active increments is OK as long as they're under WIP limits
+            this.validateEmergencyRules(allIncrements, statusCounts.active, violations);
+            // Build result
+            const result = {
+                compliant: violations.length === 0,
+                violations,
+                increments: statusCounts,
+                config: {
+                    maxActiveIncrements: this.limits.maxActiveIncrements,
+                    hardCap: this.limits.hardCap,
+                    allowEmergencyInterrupt: this.limits.allowEmergencyInterrupt,
+                },
+                timestamp: new Date().toISOString(),
+            };
+            return result;
+        }
+        catch (error) {
+            // Handle errors gracefully
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            violations.push({
+                type: 'metadata_inconsistency',
+                message: `Error during validation: ${errorMessage}`,
+                suggestion: 'Check .specweave/increments/ directory structure',
+                severity: 'error',
+            });
+            return {
+                compliant: false,
+                violations,
+                increments: {
+                    total: 0,
+                    active: 0,
+                    paused: 0,
+                    completed: 0,
+                    abandoned: 0,
+                },
+                config: {
+                    maxActiveIncrements: this.limits.maxActiveIncrements,
+                    hardCap: this.limits.hardCap,
+                    allowEmergencyInterrupt: this.limits.allowEmergencyInterrupt,
+                },
+                timestamp: new Date().toISOString(),
+            };
+        }
+    }
+    /**
+     * Get all increments with status information
+     */
+    async getAllIncrements() {
+        const incrementsDir = path.join(this.projectRoot, '.specweave', 'increments');
+        // Check if increments directory exists
+        if (!fs.existsSync(incrementsDir)) {
+            return [];
+        }
+        // Get all increment directories
+        const entries = fs.readdirSync(incrementsDir);
+        const incrementDirs = entries.filter((entry) => {
+            const fullPath = path.join(incrementsDir, entry);
+            return fs.statSync(fullPath).isDirectory() && /^\d{4}/.test(entry);
+        });
+        // Get status for each increment
+        const statuses = [];
+        for (const dir of incrementDirs) {
+            try {
+                const status = await this.detector.getStatus(dir);
+                if (status.exists) {
+                    statuses.push(status);
+                }
+            }
+            catch (error) {
+                // Skip increments that fail to load
+                continue;
+            }
+        }
+        return statuses;
+    }
+    /**
+     * Count increments by status
+     */
+    countByStatus(increments) {
+        let active = 0;
+        let paused = 0;
+        let completed = 0;
+        let abandoned = 0;
+        const statusMap = new Map();
+        for (const inc of increments) {
+            const metadataPath = path.join(this.projectRoot, '.specweave', 'increments', inc.id, 'metadata.json');
+            // Try to read metadata.json for status
+            let status = 'active'; // default
+            try {
+                if (fs.existsSync(metadataPath)) {
+                    const metadata = fs.readJsonSync(metadataPath);
+                    status = metadata.status || 'active';
+                }
+                else {
+                    // No metadata, determine by completion
+                    status = inc.isComplete ? 'completed' : 'active';
+                }
+            }
+            catch (error) {
+                // Error reading metadata, fall back to completion check
+                status = inc.isComplete ? 'completed' : 'active';
+            }
+            // Store status in map
+            statusMap.set(inc.id, status);
+            // Count by status
+            switch (status) {
+                case 'active':
+                    active++;
+                    break;
+                case 'paused':
+                    paused++;
+                    break;
+                case 'completed':
+                    completed++;
+                    break;
+                case 'abandoned':
+                    abandoned++;
+                    break;
+                default:
+                    active++; // Unknown status, treat as active
+            }
+        }
+        return {
+            statusCounts: {
+                total: increments.length,
+                active,
+                paused,
+                completed,
+                abandoned,
+            },
+            statusMap,
+        };
+    }
+    /**
+     * Validate hard cap rule (never > 2 active)
+     */
+    validateHardCap(activeCount, violations) {
+        if (activeCount > this.limits.hardCap) {
+            violations.push({
+                type: 'hard_cap_exceeded',
+                message: `Hard cap exceeded: ${activeCount} active increments (maximum: ${this.limits.hardCap})`,
+                suggestion: `Complete or pause at least ${activeCount - this.limits.hardCap} increment(s). Use /specweave:done <id> or /specweave:pause <id>`,
+                severity: 'error',
+                context: {
+                    activeCount,
+                    hardCap: this.limits.hardCap,
+                    excess: activeCount - this.limits.hardCap,
+                },
+            });
+        }
+    }
+    /**
+     * Validate WIP limit rule (recommended limit)
+     */
+    validateWIPLimit(activeCount, violations) {
+        if (activeCount > this.limits.maxActiveIncrements && activeCount <= this.limits.hardCap) {
+            violations.push({
+                type: 'wip_limit_exceeded',
+                message: `WIP limit exceeded: ${activeCount} active increments (recommended: ${this.limits.maxActiveIncrements})`,
+                suggestion: `Consider completing one increment before starting new work. Research shows ${activeCount} concurrent tasks reduces productivity by 20-40%.`,
+                severity: 'warning',
+                context: {
+                    activeCount,
+                    recommended: this.limits.maxActiveIncrements,
+                },
+            });
+        }
+    }
+    /**
+     * Validate no incomplete work rule
+     */
+    validateIncompleteWork(incomplete, violations) {
+        if (incomplete.length > 0) {
+            incomplete.forEach((inc) => {
+                violations.push({
+                    type: 'incomplete_work',
+                    message: `Incomplete increment: ${inc.id} (${inc.percentComplete}% complete, ${inc.pendingTasks.length} tasks remaining)`,
+                    suggestion: `Complete increment ${inc.id} before starting new work. Use /specweave:done ${inc.id} or /specweave:close ${inc.id}`,
+                    severity: 'error',
+                    incrementId: inc.id,
+                    context: {
+                        percentComplete: inc.percentComplete,
+                        pendingTasks: inc.pendingTasks.length,
+                        totalTasks: inc.totalTasks,
+                    },
+                });
+            });
+        }
+    }
+    /**
+     * Validate emergency interrupt rules
+     *
+     * If 2 active increments, at least one must be hotfix/bug
+     */
+    validateEmergencyRules(allIncrements, activeCount, violations) {
+        if (activeCount === 2 && this.limits.allowEmergencyInterrupt) {
+            // TODO: Check if at least one is hotfix/bug type
+            // This requires reading metadata.json for type field
+            // For now, we'll skip this validation
+        }
+    }
+}
+//# sourceMappingURL=discipline-checker.js.map

package/dist/core/increment/discipline-checker.js.map

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

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

@@ -0,0 +1,33 @@
+/**
+ * Metadata Validator - Validates increment metadata consistency
+ *
+ * Ensures metadata.json accurately reflects increment reality:
+ * - Status matches task completion
+ * - Timestamps are present and valid
+ * - GitHub sync data is consistent
+ */
+export interface MetadataValidationResult {
+    valid: boolean;
+    incrementId: string;
+    issues: MetadataIssue[];
+}
+export interface MetadataIssue {
+    type: 'missing_file' | 'invalid_json' | 'status_mismatch' | 'missing_timestamp' | 'github_mismatch';
+    message: string;
+    severity: 'error' | 'warning';
+    suggestion?: string;
+}
+export declare class MetadataValidator {
+    private projectRoot;
+    private detector;
+    constructor(projectRoot?: string);
+    /**
+     * Validate metadata for a specific increment
+     */
+    validate(incrementId: string): Promise<MetadataValidationResult>;
+    /**
+     * Validate all increments
+     */
+    validateAll(): Promise<Map<string, MetadataValidationResult>>;
+}
+//# sourceMappingURL=metadata-validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-validator.d.ts","sourceRoot":"","sources":["../../../src/core/increment/metadata-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;IACpG,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAA0B;gBAE9B,WAAW,GAAE,MAAsB;IAK/C;;OAEG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA2HtE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;CAoBpE"}

package/dist/core/increment/metadata-validator.js

@@ -0,0 +1,147 @@
+/**
+ * Metadata Validator - Validates increment metadata consistency
+ *
+ * Ensures metadata.json accurately reflects increment reality:
+ * - Status matches task completion
+ * - Timestamps are present and valid
+ * - GitHub sync data is consistent
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { IncrementStatusDetector } from '../increment-status.js';
+export class MetadataValidator {
+    constructor(projectRoot = process.cwd()) {
+        this.projectRoot = projectRoot;
+        this.detector = new IncrementStatusDetector(projectRoot);
+    }
+    /**
+     * Validate metadata for a specific increment
+     */
+    async validate(incrementId) {
+        const issues = [];
+        const metadataPath = path.join(this.projectRoot, '.specweave', 'increments', incrementId, 'metadata.json');
+        // Check file exists
+        if (!await fs.pathExists(metadataPath)) {
+            issues.push({
+                type: 'missing_file',
+                message: `metadata.json not found for increment ${incrementId}`,
+                severity: 'warning',
+                suggestion: 'Metadata file will be created automatically when needed'
+            });
+            return { valid: false, incrementId, issues };
+        }
+        // Parse JSON
+        let metadata;
+        try {
+            metadata = await fs.readJson(metadataPath);
+        }
+        catch (error) {
+            issues.push({
+                type: 'invalid_json',
+                message: `metadata.json is invalid JSON: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                severity: 'error',
+                suggestion: 'Fix JSON syntax or delete file to regenerate'
+            });
+            return { valid: false, incrementId, issues };
+        }
+        // Get actual status from tasks.md
+        const actualStatus = await this.detector.getStatus(incrementId);
+        // Validate status field
+        if (!metadata.status) {
+            issues.push({
+                type: 'status_mismatch',
+                message: 'Missing status field in metadata.json',
+                severity: 'error',
+                suggestion: 'Add status field: "active", "paused", "completed", or "abandoned"'
+            });
+        }
+        else if (metadata.status === 'completed' && !actualStatus.isComplete) {
+            issues.push({
+                type: 'status_mismatch',
+                message: `Status is "completed" but ${actualStatus.pendingTasks.length} tasks remain`,
+                severity: 'error',
+                suggestion: `Either complete remaining tasks or change status to "active"`
+            });
+        }
+        else if (metadata.status === 'active' && actualStatus.isComplete) {
+            issues.push({
+                type: 'status_mismatch',
+                message: 'All tasks complete but status is still "active"',
+                severity: 'warning',
+                suggestion: 'Update status to "completed" or close increment via /specweave:done'
+            });
+        }
+        // Validate timestamps
+        if (metadata.status === 'completed' && !metadata.completed) {
+            issues.push({
+                type: 'missing_timestamp',
+                message: 'Status is "completed" but no completion timestamp',
+                severity: 'warning',
+                suggestion: 'Add "completed" field with ISO timestamp'
+            });
+        }
+        if (metadata.status === 'paused' && !metadata.paused) {
+            issues.push({
+                type: 'missing_timestamp',
+                message: 'Status is "paused" but no pause timestamp',
+                severity: 'warning',
+                suggestion: 'Add "paused" field with ISO timestamp'
+            });
+        }
+        // Validate GitHub sync
+        if (metadata.github?.issue) {
+            const issueNumber = metadata.github.issue;
+            // Check if gh CLI is available
+            try {
+                const { execSync } = require('child_process');
+                execSync('gh --version', { stdio: 'ignore' });
+                // Check issue state
+                const issueState = execSync(`gh issue view ${issueNumber} --json state --jq '.state'`, { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+                if (issueState === 'CLOSED' && metadata.status !== 'completed' && metadata.status !== 'abandoned') {
+                    issues.push({
+                        type: 'github_mismatch',
+                        message: `GitHub issue #${issueNumber} is closed but increment status is "${metadata.status}"`,
+                        severity: 'warning',
+                        suggestion: 'Update increment status to match GitHub issue state'
+                    });
+                }
+                else if (issueState === 'OPEN' && metadata.status === 'completed') {
+                    issues.push({
+                        type: 'github_mismatch',
+                        message: `Increment is completed but GitHub issue #${issueNumber} is still open`,
+                        severity: 'warning',
+                        suggestion: `Close GitHub issue manually or run post-increment-completion hook`
+                    });
+                }
+            }
+            catch (error) {
+                // gh CLI not available or issue not found - skip check
+            }
+        }
+        return {
+            valid: issues.filter(i => i.severity === 'error').length === 0,
+            incrementId,
+            issues
+        };
+    }
+    /**
+     * Validate all increments
+     */
+    async validateAll() {
+        const results = new Map();
+        const incrementsDir = path.join(this.projectRoot, '.specweave', 'increments');
+        if (!await fs.pathExists(incrementsDir)) {
+            return results;
+        }
+        const entries = await fs.readdir(incrementsDir, { withFileTypes: true });
+        const incrementDirs = entries
+            .filter(entry => entry.isDirectory())
+            .filter(entry => /^\d{4}-/.test(entry.name));
+        for (const dir of incrementDirs) {
+            const result = await this.validate(dir.name);
+            results.set(dir.name, result);
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=metadata-validator.js.map

package/dist/core/increment/metadata-validator.js.map

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

package/dist/core/increment/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Types for increment discipline validation
+ *
+ * These types support the strict enforcement of increment discipline,
+ * preventing multiple active increments and ensuring completion tracking.
+ */
+/**
+ * Severity level for validation violations
+ */
+export type ViolationSeverity = 'error' | 'warning' | 'info';
+/**
+ * Type of validation violation detected
+ */
+export type ViolationType = 'hard_cap_exceeded' | 'wip_limit_exceeded' | 'incomplete_work' | 'emergency_violation' | 'metadata_inconsistency' | 'github_sync_failed';
+/**
+ * A single validation violation with details
+ */
+export interface ValidationViolation {
+    /** Type of violation */
+    type: ViolationType;
+    /** Human-readable error message */
+    message: string;
+    /** Suggested fix or action */
+    suggestion: string;
+    /** Severity level */
+    severity: ViolationSeverity;
+    /** Affected increment ID (if applicable) */
+    incrementId?: string;
+    /** Additional context data */
+    context?: Record<string, any>;
+}
+/**
+ * Result of discipline validation check
+ */
+export interface ValidationResult {
+    /** Whether the project is compliant with discipline rules */
+    compliant: boolean;
+    /** List of violations found (empty if compliant) */
+    violations: ValidationViolation[];
+    /** Summary of increment statuses */
+    increments: {
+        total: number;
+        active: number;
+        paused: number;
+        completed: number;
+        abandoned: number;
+    };
+    /** Configuration used for validation */
+    config: {
+        maxActiveIncrements: number;
+        hardCap: number;
+        allowEmergencyInterrupt: boolean;
+    };
+    /** Timestamp when check was performed */
+    timestamp: string;
+}
+/**
+ * Options for discipline check command
+ */
+export interface DisciplineCheckOptions {
+    /** Show detailed increment information */
+    verbose?: boolean;
+    /** Output results as JSON */
+    json?: boolean;
+    /** Attempt to auto-fix violations (future feature) */
+    fix?: boolean;
+    /** Project root directory */
+    projectRoot?: string;
+}
+/**
+ * Configuration for increment discipline limits
+ */
+export interface DisciplineLimits {
+    /** Recommended maximum active increments (default: 1) */
+    maxActiveIncrements: number;
+    /** Absolute maximum active increments (default: 2, never exceeded) */
+    hardCap: number;
+    /** Allow hotfix/bug to interrupt and create 2nd active (default: true) */
+    allowEmergencyInterrupt: boolean;
+    /** Type-specific behaviors */
+    typeBehaviors?: {
+        /** Types that can interrupt to create 2nd active */
+        canInterrupt: string[];
+        /** Auto-abandon after N days of inactivity */
+        autoAbandonDays?: Record<string, number>;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/increment/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/increment/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,oBAAoB,GACpB,iBAAiB,GACjB,qBAAqB,GACrB,wBAAwB,GACxB,oBAAoB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,IAAI,EAAE,aAAa,CAAC;IAEpB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IAEnB,qBAAqB;IACrB,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IAEnB,oDAAoD;IACpD,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAElC,oCAAoC;IACpC,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,wCAAwC;IACxC,MAAM,EAAE;QACN,mBAAmB,EAAE,MAAM,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,uBAAuB,EAAE,OAAO,CAAC;KAClC,CAAC;IAEF,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,sDAAsD;IACtD,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,mBAAmB,EAAE,MAAM,CAAC;IAE5B,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAEhB,0EAA0E;IAC1E,uBAAuB,EAAE,OAAO,CAAC;IAEjC,8BAA8B;IAC9B,aAAa,CAAC,EAAE;QACd,oDAAoD;QACpD,YAAY,EAAE,MAAM,EAAE,CAAC;QAEvB,8CAA8C;QAC9C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC1C,CAAC;CACH"}

package/dist/core/increment/types.js

@@ -0,0 +1,8 @@
+/**
+ * Types for increment discipline validation
+ *
+ * These types support the strict enforcement of increment discipline,
+ * preventing multiple active increments and ensuring completion tracking.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/increment/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/increment/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/qa/qa-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"qa-runner.d.ts","sourceRoot":"","sources":["../../../src/core/qa/qa-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EACL,QAAQ,EAER,SAAS,EAIV,MAAM,YAAY,CAAC;AAIpB;;;;;;GAMG;AACH,wBAAsB,KAAK,CACzB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,SAAc,GACtB,OAAO,CAAC,QAAQ,CAAC,CAsInB"}
+{"version":3,"file":"qa-runner.d.ts","sourceRoot":"","sources":["../../../src/core/qa/qa-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EACL,QAAQ,EAER,SAAS,EAIV,MAAM,YAAY,CAAC;AAIpB;;;;;;GAMG;AACH,wBAAsB,KAAK,CACzB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,SAAc,GACtB,OAAO,CAAC,QAAQ,CAAC,CAwInB"}

package/dist/core/qa/qa-runner.js

@@ -26,10 +26,11 @@ export async function runQA(incrementId, options = {}) {
     console.log(chalk.blue.bold(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`));
     console.log(chalk.gray(`Mode: ${mode.toUpperCase()}`));
     console.log(chalk.gray(`Timestamp: ${new Date().toISOString()}\n`));
-    // Validate increment exists
-    const incrementPath = path.join(process.cwd(), '.specweave', 'increments', incrementId);
-    if (!fs.existsSync(incrementPath)) {
-        throw new Error(`Increment ${incrementId} not found at ${incrementPath}`);
+    // Resolve increment path (find directory starting with 4-digit ID)
+    const incrementsDir = path.join(process.cwd(), '.specweave', 'increments');
+    const incrementPath = resolveIncrementPath(incrementsDir, incrementId);
+    if (!incrementPath) {
+        throw new Error(`Increment ${incrementId} not found in ${incrementsDir}`);
     }
     // Step 1: Rule-based validation (always first, always free)
     const spinner = ora('Running rule-based validation (120 checks)...').start();
@@ -245,6 +246,23 @@ async function runAIQualityAssessment(incrementId, incrementPath, mode) {
         risk_assessment: mockRisks,
     };
 }
+/**
+ * Resolve increment path from 4-digit ID
+ * Finds the full directory name (e.g., "0018-strict-increment-discipline-enforcement")
+ * given just the 4-digit prefix (e.g., "0018")
+ */
+function resolveIncrementPath(incrementsDir, incrementId) {
+    if (!fs.existsSync(incrementsDir)) {
+        return null;
+    }
+    const entries = fs.readdirSync(incrementsDir);
+    const matchingDir = entries.find((entry) => {
+        const fullPath = path.join(incrementsDir, entry);
+        // Match directories starting with the 4-digit ID
+        return fs.statSync(fullPath).isDirectory() && entry.startsWith(incrementId);
+    });
+    return matchingDir ? path.join(incrementsDir, matchingDir) : null;
+}
 /**
  * Estimate token usage for AI assessment
  */