specweave 0.16.7 → 0.16.11

package/dist/src/core/increment/active-increment-manager.js

@@ -0,0 +1,153 @@
+/**
+ * Active Increment Manager
+ *
+ * Manages the `.specweave/state/active-increment.json` file which tracks
+ * the currently active increment for status line display.
+ *
+ * **Critical**: This file MUST be updated whenever increment status changes:
+ * - When new increment is created → Set as active
+ * - When increment is completed → Clear or set to next active
+ * - When increment is paused → Set to next active (or clear if none)
+ * - When increment is resumed → Set as active
+ *
+ * Part of increment 0021: Fix Active Increment Tracking
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { IncrementStatus } from '../types/increment-metadata.js';
+import { MetadataManager } from './metadata-manager.js';
+/**
+ * Active Increment Manager
+ *
+ * Central authority for managing which increment is currently active.
+ */
+export class ActiveIncrementManager {
+    constructor(rootDir = process.cwd()) {
+        this.rootDir = rootDir;
+        this.stateFile = path.join(rootDir, '.specweave/state/active-increment.json');
+    }
+    /**
+     * Get the currently active increment ID
+     * Returns null if no increment is active
+     */
+    getActive() {
+        try {
+            if (!fs.existsSync(this.stateFile)) {
+                return null;
+            }
+            const content = fs.readFileSync(this.stateFile, 'utf-8');
+            const state = JSON.parse(content);
+            return state.id || null;
+        }
+        catch (error) {
+            // File read/parse error = no active increment
+            return null;
+        }
+    }
+    /**
+     * Set the active increment
+     * Validates that the increment exists and is actually active
+     */
+    setActive(incrementId) {
+        // Validate increment exists
+        const metadata = MetadataManager.read(incrementId);
+        // Validate increment is actually active
+        if (metadata.status !== IncrementStatus.ACTIVE) {
+            throw new Error(`Cannot set ${incrementId} as active: status is ${metadata.status}, not active`);
+        }
+        // Write state file atomically
+        const state = { id: incrementId };
+        this.writeState(state);
+    }
+    /**
+     * Clear the active increment (no increment is active)
+     */
+    clearActive() {
+        const state = { id: null };
+        this.writeState(state);
+    }
+    /**
+     * Smart update: Set active increment to next available active increment,
+     * or clear if none are active.
+     *
+     * This is called when:
+     * - An increment is completed
+     * - An increment is paused
+     * - An increment is abandoned
+     *
+     * Logic:
+     * 1. Get all active increments
+     * 2. If any exist, set the first one as active
+     * 3. Otherwise, clear active state
+     */
+    smartUpdate() {
+        const activeIncrements = MetadataManager.getActive();
+        if (activeIncrements.length > 0) {
+            // Set first active increment as the active one
+            // (Could be improved with "most recently active" logic)
+            this.setActive(activeIncrements[0].id);
+        }
+        else {
+            // No active increments
+            this.clearActive();
+        }
+    }
+    /**
+     * Validate that the active increment pointer is correct
+     * Fixes stale pointers automatically
+     *
+     * Returns true if valid/fixed, false if invalid and couldn't fix
+     */
+    validate() {
+        const currentActive = this.getActive();
+        // No active increment = valid (nothing to validate)
+        if (currentActive === null) {
+            return true;
+        }
+        try {
+            // Check if increment still exists
+            const metadata = MetadataManager.read(currentActive);
+            // Check if increment is actually active
+            if (metadata.status !== IncrementStatus.ACTIVE) {
+                // Stale pointer! Fix it automatically
+                console.warn(`⚠️  Active increment pointer is stale: ${currentActive} is ${metadata.status}`);
+                this.smartUpdate();
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            // Increment doesn't exist = stale pointer
+            console.warn(`⚠️  Active increment pointer is invalid: ${currentActive} not found`);
+            this.smartUpdate();
+            return false;
+        }
+    }
+    /**
+     * Write state file atomically (temp file → rename)
+     */
+    writeState(state) {
+        // Ensure state directory exists
+        const stateDir = path.dirname(this.stateFile);
+        if (!fs.existsSync(stateDir)) {
+            fs.mkdirSync(stateDir, { recursive: true });
+        }
+        // Atomic write: temp file → rename
+        const tempFile = `${this.stateFile}.tmp`;
+        fs.writeFileSync(tempFile, JSON.stringify(state, null, 2), 'utf-8');
+        fs.renameSync(tempFile, this.stateFile);
+    }
+    /**
+     * Get state file path (for testing)
+     */
+    getStateFilePath() {
+        return this.stateFile;
+    }
+    /**
+     * Check if state file exists (for testing)
+     */
+    exists() {
+        return fs.existsSync(this.stateFile);
+    }
+}
+//# sourceMappingURL=active-increment-manager.js.map

package/dist/src/core/increment/active-increment-manager.js.map

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

package/dist/src/core/increment/discipline-checker.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 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 { ValidationResult, DisciplineLimits, DisciplineCheckOptions } from './types.js';
+/**
+ * Checks increment discipline compliance
+ */
+export declare class DisciplineChecker {
+    private projectRoot;
+    private limits;
+    private detector;
+    /**
+     * Create a new DisciplineChecker
+     *
+     * @param projectRoot - Root directory of the project
+     * @param customLimits - Optional custom limits (overrides config)
+     */
+    constructor(projectRoot?: string, customLimits?: DisciplineLimits);
+    /**
+     * Get default discipline limits
+     */
+    private getDefaultLimits;
+    /**
+     * Validate increment discipline
+     *
+     * @param options - Validation options
+     * @returns ValidationResult with compliance status and violations
+     */
+    validate(options?: DisciplineCheckOptions): Promise<ValidationResult>;
+    /**
+     * Get all increments with status information
+     */
+    private getAllIncrements;
+    /**
+     * Count increments by status
+     */
+    private countByStatus;
+    /**
+     * Validate hard cap rule (never > 2 active)
+     */
+    private validateHardCap;
+    /**
+     * Validate WIP limit rule (recommended limit)
+     */
+    private validateWIPLimit;
+    /**
+     * Validate no incomplete work rule
+     */
+    private validateIncompleteWork;
+    /**
+     * Validate emergency interrupt rules
+     *
+     * If 2 active increments, at least one must be hotfix/bug
+     */
+    private validateEmergencyRules;
+}
+//# sourceMappingURL=discipline-checker.d.ts.map

package/dist/src/core/increment/discipline-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discipline-checker.d.ts","sourceRoot":"","sources":["../../../../src/core/increment/discipline-checker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,gBAAgB,EAEhB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,QAAQ,CAA0B;IAE1C;;;;;OAKG;gBACS,WAAW,GAAE,MAAsB,EAAE,YAAY,CAAC,EAAE,gBAAgB;IAchF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuE3E;;OAEG;YACW,gBAAgB;IAgC9B;;OAEG;IACH,OAAO,CAAC,aAAa;IA0ErB;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;CAW/B"}

package/dist/src/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/src/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":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,uBAAuB,EAAmB,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAOrD,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAK5B;;;;;OAKG;IACH,YAAY,cAAsB,OAAO,CAAC,GAAG,EAAE,EAAE,YAA+B;QAC9E,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,uBAAuB,CAAC,WAAW,CAAC,CAAC;QAEzD,0CAA0C;QAC1C,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAI,MAAM,CAAC,MAAc,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,OAAO;YACL,mBAAmB,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC;YACV,uBAAuB,EAAE,IAAI;YAC7B,aAAa,EAAE;gBACb,YAAY,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;gBAC/B,eAAe,EAAE;oBACf,UAAU,EAAE,EAAE;iBACf;aACF;SACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAgC;QAC7C,MAAM,UAAU,GAA0B,EAAE,CAAC;QAE7C,IAAI,CAAC;YACH,iCAAiC;YACjC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAEpD,8CAA8C;YAC9C,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;YAEtE,kFAAkF;YAClF,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CACrC,CAAC,GAAG,EAAE,EAAE;gBACN,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC;gBACjD,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,QAAQ,CAAC,CAAC;YACpE,CAAC,CACF,CAAC;YAEF,0BAA0B;YAC1B,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACtD,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACvD,2EAA2E;YAC3E,qEAAqE;YACrE,IAAI,CAAC,sBAAsB,CAAC,aAAa,EAAE,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAE5E,eAAe;YACf,MAAM,MAAM,GAAqB;gBAC/B,SAAS,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;gBAClC,UAAU;gBACV,UAAU,EAAE,YAAY;gBACxB,MAAM,EAAE;oBACN,mBAAmB,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB;oBACpD,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;oBAC5B,uBAAuB,EAAE,IAAI,CAAC,MAAM,CAAC,uBAAuB;iBAC7D;gBACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;YAEF,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,2BAA2B;YAC3B,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAE3D,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,wBAAwB;gBAC9B,OAAO,EAAE,4BAA4B,YAAY,EAAE;gBACnD,UAAU,EAAE,kDAAkD;gBAC9D,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YAEH,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,UAAU;gBACV,UAAU,EAAE;oBACV,KAAK,EAAE,CAAC;oBACR,MAAM,EAAE,CAAC;oBACT,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,CAAC;oBACZ,SAAS,EAAE,CAAC;iBACb;gBACD,MAAM,EAAE;oBACN,mBAAmB,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB;oBACpD,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;oBAC5B,uBAAuB,EAAE,IAAI,CAAC,MAAM,CAAC,uBAAuB;iBAC7D;gBACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB;QAC5B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;QAE9E,uCAAuC;QACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,gCAAgC;QAChC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAC9C,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAa,EAAE,EAAE;YACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;YACjD,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,gCAAgC;QAChC,MAAM,QAAQ,GAAsB,EAAE,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAClD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAClB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,oCAAoC;gBACpC,SAAS;YACX,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,UAA6B;QAUjD,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE5C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAC5B,IAAI,CAAC,WAAW,EAChB,YAAY,EACZ,YAAY,EACZ,GAAG,CAAC,EAAE,EACN,eAAe,CAChB,CAAC;YAEF,uCAAuC;YACvC,IAAI,MAAM,GAAG,QAAQ,CAAC,CAAC,UAAU;YACjC,IAAI,CAAC;gBACH,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;oBAChC,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;oBAC/C,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACN,uCAAuC;oBACvC,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;gBACnD,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,wDAAwD;gBACxD,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;YACnD,CAAC;YAED,sBAAsB;YACtB,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAE9B,kBAAkB;YAClB,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,QAAQ;oBACX,MAAM,EAAE,CAAC;oBACT,MAAM;gBACR,KAAK,QAAQ;oBACX,MAAM,EAAE,CAAC;oBACT,MAAM;gBACR,KAAK,WAAW;oBACd,SAAS,EAAE,CAAC;oBACZ,MAAM;gBACR,KAAK,WAAW;oBACd,SAAS,EAAE,CAAC;oBACZ,MAAM;gBACR;oBACE,MAAM,EAAE,CAAC,CAAC,kCAAkC;YAChD,CAAC;QACH,CAAC;QAED,OAAO;YACL,YAAY,EAAE;gBACZ,KAAK,EAAE,UAAU,CAAC,MAAM;gBACxB,MAAM;gBACN,MAAM;gBACN,SAAS;gBACT,SAAS;aACV;YACD,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CACrB,WAAmB,EACnB,UAAiC;QAEjC,IAAI,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACtC,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,sBAAsB,WAAW,gCAAgC,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG;gBAChG,UAAU,EAAE,8BAA8B,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,kEAAkE;gBAC7I,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE;oBACP,WAAW;oBACX,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;oBAC5B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO;iBAC1C;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,WAAmB,EACnB,UAAiC;QAEjC,IAAI,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,IAAI,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxF,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,uBAAuB,WAAW,oCAAoC,IAAI,CAAC,MAAM,CAAC,mBAAmB,GAAG;gBACjH,UAAU,EAAE,8EAA8E,WAAW,mDAAmD;gBACxJ,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE;oBACP,WAAW;oBACX,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB;iBAC7C;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACK,sBAAsB,CAC5B,UAA6B,EAC7B,UAAiC;QAEjC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACzB,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,yBAAyB,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,eAAe,eAAe,GAAG,CAAC,YAAY,CAAC,MAAM,mBAAmB;oBACzH,UAAU,EAAE,sBAAsB,GAAG,CAAC,EAAE,kDAAkD,GAAG,CAAC,EAAE,wBAAwB,GAAG,CAAC,EAAE,EAAE;oBAChI,QAAQ,EAAE,OAAO;oBACjB,WAAW,EAAE,GAAG,CAAC,EAAE;oBACnB,OAAO,EAAE;wBACP,eAAe,EAAE,GAAG,CAAC,eAAe;wBACpC,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC,MAAM;wBACrC,UAAU,EAAE,GAAG,CAAC,UAAU;qBAC3B;iBACF,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,sBAAsB,CAC5B,aAAgC,EAChC,WAAmB,EACnB,UAAiC;QAEjC,IAAI,WAAW,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC;YAC7D,iDAAiD;YACjD,qDAAqD;YACrD,sCAAsC;QACxC,CAAC;IACH,CAAC;CACF"}

package/dist/src/core/increment/limits.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Increment Limits
+ *
+ * Type-based limits for concurrent active increments.
+ * Part of increment 0007: Smart Status Management
+ */
+import { IncrementType, IncrementMetadata } from '../types/increment-metadata';
+/**
+ * Limit check result
+ */
+export interface LimitCheckResult {
+    /** Whether the limit is exceeded */
+    exceeded: boolean;
+    /** Current count of active increments of this type */
+    current: number;
+    /** Maximum allowed (null = unlimited) */
+    limit: number | null;
+    /** Warning message if limit exceeded */
+    warning?: string;
+    /** Severity level: info, warning, error */
+    severity: 'info' | 'warning' | 'error';
+    /** Suggested actions */
+    suggestions?: string[];
+    /** Active increments of this type */
+    activeIncrements?: IncrementMetadata[];
+}
+/**
+ * Context switching cost warning
+ */
+export interface ContextSwitchWarning {
+    /** Whether warning should be shown */
+    show: boolean;
+    /** Estimated productivity cost (%) */
+    productivityCost: string;
+    /** Message to display */
+    message: string;
+    /** Options for user */
+    options: Array<{
+        label: string;
+        value: string;
+        description: string;
+    }>;
+}
+/**
+ * Check if creating a new increment would exceed type-based limits
+ */
+export declare function checkIncrementLimits(type: IncrementType): LimitCheckResult;
+/**
+ * Check all increment types and return warnings
+ */
+export declare function checkAllLimits(): Record<IncrementType, LimitCheckResult>;
+/**
+ * Get context switching warning for starting a new increment
+ */
+export declare function getContextSwitchWarning(newType: IncrementType): ContextSwitchWarning;
+/**
+ * Get summary of all limits
+ */
+export declare function getLimitsSummary(): string;
+/**
+ * Check if starting a new increment of this type would be allowed
+ * (considering limits)
+ */
+export declare function canStartIncrement(type: IncrementType): {
+    allowed: boolean;
+    reason?: string;
+};
+//# sourceMappingURL=limits.d.ts.map

package/dist/src/core/increment/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../../../src/core/increment/limits.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,aAAa,EAGb,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAElB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAEvC,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,IAAI,EAAE,OAAO,CAAC;IAEd,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,uBAAuB;IACvB,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CAwC1E;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAQxE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,oBAAoB,CAuDpF;AA0GD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAgBzC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAW5F"}