specweave 1.0.464 → 1.0.466

package/dist/plugins/specweave/lib/vendor/core/types/increment-metadata.d.ts

@@ -0,0 +1,442 @@
+/**
+ * Increment Metadata Types
+ *
+ * Defines the schema for increment metadata tracking (status, type, timestamps).
+ * Part of increment 0007: Smart Status Management
+ */
+/**
+ * Increment status enum
+ * Tracks the lifecycle state of an increment
+ */
+export declare enum IncrementStatus {
+    /** Planning phase - spec/plan/tasks being created (does NOT count towards WIP limits) */
+    PLANNING = "planning",
+    /** Currently being worked on */
+    ACTIVE = "active",
+    /** Planned but not ready to start yet (does NOT count towards WIP limits) */
+    BACKLOG = "backlog",
+    /** Temporarily stopped (blocked by external dependency, deprioritized) */
+    PAUSED = "paused",
+    /**
+     * All tasks complete, awaiting user review (v0.28.63+)
+     *
+     * CRITICAL: This is a gating status that prevents auto-completion bugs.
+     * - Auto-transitions to READY_FOR_REVIEW when all tasks completed
+     * - User MUST explicitly run /sw:done to move to COMPLETED
+     * - /sw:next will prompt for confirmation before closure
+     *
+     * Prevents the bug where status becomes "completed" without:
+     * 1. ACs being checked in spec.md
+     * 2. User approval
+     */
+    READY_FOR_REVIEW = "ready_for_review",
+    /** All tasks complete AND user approved - increment finished */
+    COMPLETED = "completed",
+    /** Work abandoned (requirements changed, obsolete, etc.) */
+    ABANDONED = "abandoned"
+}
+/**
+ * Increment type enum
+ * Determines rules and limits applied to the increment
+ */
+export declare enum IncrementType {
+    /** Critical production fix (bypasses all limits) */
+    HOTFIX = "hotfix",
+    /** Standard feature development (limit: 2 active) */
+    FEATURE = "feature",
+    /** Production bug fix with SRE investigation (unlimited, urgent) */
+    BUG = "bug",
+    /** Change request from stakeholders (limit: 2 active) */
+    CHANGE_REQUEST = "change-request",
+    /** Code improvement (limit: 1 active) */
+    REFACTOR = "refactor",
+    /** POC/spike work (unlimited, auto-abandon after 14 days) */
+    EXPERIMENT = "experiment"
+}
+/**
+ * Increment metadata schema
+ * Stored in .specweave/increments/{id}/metadata.json
+ */
+export interface IncrementMetadata {
+    /** Increment ID (e.g., "0007-smart-increment-discipline") */
+    id: string;
+    /** Current status */
+    status: IncrementStatus;
+    /** Increment type */
+    type: IncrementType;
+    /** Creation timestamp (ISO 8601) */
+    created: string;
+    /** Last activity timestamp (ISO 8601) */
+    lastActivity: string;
+    /** Testing mode for this increment (defaults to global config) */
+    testMode?: 'TDD' | 'test-after' | 'manual' | 'none';
+    /** Coverage target percentage (0-100, 0 = no tracking, defaults to global config) */
+    coverageTarget?: number;
+    /** Reason for moving to backlog (only if status = backlog) */
+    backlogReason?: string;
+    /** Timestamp when moved to backlog (ISO 8601) */
+    backlogAt?: string;
+    /** Reason for pausing (only if status = paused) */
+    pausedReason?: string;
+    /** Timestamp when paused (ISO 8601) */
+    pausedAt?: string;
+    /** Reason for abandoning (only if status = abandoned) */
+    abandonedReason?: string;
+    /** Timestamp when abandoned (ISO 8601) */
+    abandonedAt?: string;
+    /**
+     * Timestamp when moved to ready_for_review (ISO 8601)
+     * Set automatically when all tasks are completed
+     * (v0.28.63+)
+     */
+    readyForReviewAt?: string;
+    /**
+     * Timestamp when user approved completion (ISO 8601)
+     * Set only via explicit /sw:done command
+     * (v0.28.63+)
+     */
+    approvedAt?: string;
+}
+/**
+ * Increment metadata with additional computed fields
+ * Used for rich status displays
+ */
+export interface IncrementMetadataExtended extends IncrementMetadata {
+    /** Progress percentage (0-100) */
+    progress?: number;
+    /** Number of completed tasks */
+    completedTasks?: number;
+    /** Total number of tasks */
+    totalTasks?: number;
+    /** Age in days since creation */
+    ageInDays?: number;
+    /** Days since paused (if paused) */
+    daysPaused?: number;
+}
+/**
+ * Valid status transitions
+ * Enforces increment lifecycle rules
+ *
+ * CRITICAL (v0.28.63+): ACTIVE cannot directly transition to COMPLETED!
+ * Must go through READY_FOR_REVIEW first, which requires explicit user approval.
+ * This prevents the auto-completion bug where increments are marked "completed"
+ * without ACs being checked or user confirmation.
+ */
+export declare const VALID_TRANSITIONS: Record<IncrementStatus, IncrementStatus[]>;
+/**
+ * Compute the shortest valid transition path from `from` to `to`.
+ *
+ * Uses BFS over the VALID_TRANSITIONS graph.
+ * Returns the sequence of intermediate + final states (excluding the starting state).
+ * Returns null if no valid path exists.
+ *
+ * Example: computeTransitionPath(PLANNING, COMPLETED)
+ *   => [ACTIVE, READY_FOR_REVIEW, COMPLETED]
+ */
+export declare function computeTransitionPath(from: IncrementStatus, to: IncrementStatus): IncrementStatus[] | null;
+/**
+ * Type-based limits
+ * Maximum active increments per type
+ *
+ * null = unlimited (no limit enforcement)
+ * User can configure per-project in .specweave/config.json
+ */
+export declare const TYPE_LIMITS: Record<IncrementType, number | null>;
+/**
+ * Staleness thresholds (days)
+ * When to warn about stale increments
+ */
+export declare const STALENESS_THRESHOLDS: {
+    /** Warn if paused for more than this many days */
+    PAUSED: number;
+    /** Warn if active for more than this many days */
+    ACTIVE: number;
+    /** Auto-abandon experiments after this many days */
+    EXPERIMENT: number;
+};
+/**
+ * Default metadata for new increments
+ *
+ * NOTE: New increments start in PLANNING status by default.
+ * They auto-transition to ACTIVE when tasks.md is created or first task starts.
+ */
+export declare function createDefaultMetadata(id: string, type?: IncrementType): IncrementMetadata;
+/**
+ * Check if status transition is valid
+ */
+export declare function isValidTransition(from: IncrementStatus, to: IncrementStatus): boolean;
+/**
+ * Check if increment is stale (paused too long or active too long)
+ */
+export declare function isStale(metadata: IncrementMetadata): boolean;
+/**
+ * Check if increment should be auto-abandoned (experiments only)
+ */
+export declare function shouldAutoAbandon(metadata: IncrementMetadata): boolean;
+/**
+ * Statuses that count toward WIP (Work In Progress) limits
+ *
+ * ACTIVE: Currently executing tasks, consumes team capacity
+ * PAUSED: Temporarily blocked but still holding resources/context
+ * READY_FOR_REVIEW: Tasks done, awaiting approval (still blocks capacity)
+ *
+ * Statuses that do NOT count:
+ * - PLANNING: Lightweight spec/planning work, parallel-safe
+ * - BACKLOG: Not started yet
+ * - COMPLETED: Already done (user approved)
+ * - ABANDONED: Cancelled
+ */
+export declare const WIP_COUNTED_STATUSES: IncrementStatus[];
+/**
+ * Check if increment status counts toward WIP (Work In Progress) limits
+ */
+export declare function countsTowardWipLimit(status: IncrementStatus): boolean;
+/**
+ * Validate if a status transition is allowed
+ * @throws Error if transition is invalid
+ */
+export declare function validateTransition(from: IncrementStatus, to: IncrementStatus): void;
+/**
+ * Project scope for a multi-project user story
+ * Defines what portion of the work belongs to each project
+ */
+export interface MultiProjectScope {
+    /** SpecWeave project ID (e.g., "FE", "BE", "Shared") */
+    id: string;
+    /** Description of work scope for this project */
+    scope: string;
+    /** Keywords for this project's portion (for auto-classification) */
+    keywords?: string[];
+    /** Estimated effort percentage (0-100) */
+    effortPercentage?: number;
+}
+/**
+ * Cross-project dependency
+ * Defines dependencies between projects within a user story
+ */
+export interface CrossProjectDependency {
+    /** Project that depends on another */
+    from: string;
+    /** Project being depended upon */
+    to: string;
+    /** Description of the dependency */
+    reason: string;
+    /** Type of dependency */
+    type?: 'blocking' | 'soft' | 'interface';
+}
+/**
+ * Multi-project user story configuration
+ * Used when a single user story spans multiple SpecWeave projects
+ */
+export interface MultiProjectUserStory {
+    /** List of projects this user story touches */
+    projects: MultiProjectScope[];
+    /** Dependencies between projects (optional) */
+    dependencies?: CrossProjectDependency[];
+    /** Primary project (receives the main spec, others get derived specs) */
+    primaryProject?: string;
+    /** How to handle sync - create linked issues in each project's external tool */
+    syncStrategy?: 'linked' | 'primary-only' | 'all';
+}
+/**
+ * External container context for 2-level directory structure
+ * Used for JIRA boards / ADO area paths mapping
+ */
+export interface ExternalContainerContext {
+    /** Container type (e.g., "jira-project", "ado-project") */
+    type: 'jira-project' | 'ado-project' | 'github-org';
+    /** External container ID (e.g., "CORE" for JIRA, "MyProduct" for ADO) */
+    containerId: string;
+    /** Display name */
+    containerName: string;
+    /** Board ID (JIRA only) */
+    boardId?: number;
+    /** Board name (JIRA only) */
+    boardName?: string;
+    /** Area path (ADO only) */
+    areaPath?: string;
+}
+/**
+ * External reference for a single US in a single external tool
+ * @since v0.33.0
+ */
+export interface USExternalRef {
+    /** External tool type */
+    provider: 'github' | 'jira' | 'ado';
+    /** Issue/work item number */
+    issueNumber: number | string;
+    /** Issue URL */
+    url: string;
+    /** Target project/repo for this US (from projectMappings) */
+    targetProject: string;
+    /** Last sync timestamp */
+    lastSynced?: string;
+}
+/**
+ * Per-US external references map
+ * Maps US-ID → provider → reference
+ * @since v0.33.0
+ */
+export interface USExternalRefsMap {
+    [usId: string]: {
+        github?: USExternalRef;
+        jira?: USExternalRef;
+        ado?: USExternalRef;
+    };
+}
+/**
+ * How the sync target was determined
+ * Used for debugging and audit trails
+ */
+export type SyncTargetDerivation = 'user-selection' | 'project-mapping' | 'default-profile' | 'first-profile-fallback' | 'auto-detected';
+/**
+ * External tool sync target for an increment
+ *
+ * Explicitly specifies which external tool profile this increment syncs with.
+ * Stored in metadata.json to provide audit trail and deterministic sync behavior.
+ *
+ * @since v1.0.31 (ADR-0211)
+ *
+ * @example
+ * ```json
+ * {
+ *   "syncTarget": {
+ *     "profileId": "github-frontend",
+ *     "provider": "github",
+ *     "derivedFrom": "project-mapping",
+ *     "setAt": "2025-12-18T10:30:00Z"
+ *   }
+ * }
+ * ```
+ */
+export interface SyncTarget {
+    /**
+     * Profile ID from config.sync.profiles
+     * This is the key that links to the full profile configuration
+     *
+     * @example "github-frontend", "jira-backend", "ado-main"
+     */
+    profileId: string;
+    /**
+     * Provider type for quick filtering without loading full config
+     */
+    provider: 'github' | 'jira' | 'ado';
+    /**
+     * How this target was determined (for debugging/audit)
+     */
+    derivedFrom: SyncTargetDerivation;
+    /**
+     * Timestamp when target was set (ISO 8601)
+     */
+    setAt: string;
+    /**
+     * Optional: Source project ID that led to this target
+     * Useful when derivedFrom is 'project-mapping'
+     */
+    sourceProjectId?: string;
+}
+/**
+ * Validation result for external tool configuration
+ *
+ * @since v1.0.31
+ */
+export interface ExternalToolValidationResult {
+    /** Whether the configuration is valid */
+    valid: boolean;
+    /** Resolved sync target (if valid) */
+    syncTarget?: SyncTarget;
+    /** List of validation errors */
+    errors: string[];
+    /** List of validation warnings (non-blocking) */
+    warnings: string[];
+    /** Suggested fixes for errors */
+    suggestions?: string[];
+}
+/**
+ * Extended increment metadata with multi-project support (v0.29.0+)
+ *
+ * NOTE (v0.29.0): featureId field was REMOVED
+ * Feature ID is derived from increment number: 0081 → FS-081
+ * Use deriveFeatureId() from src/utils/feature-id-derivation.ts
+ * See ADR-0140 for rationale
+ */
+export interface IncrementMetadataV2 extends IncrementMetadata {
+    /** Single project ID (backward compatible) */
+    projectId?: string;
+    /** Multi-project configuration (v0.29.0+, overrides projectId if set) */
+    multiProject?: MultiProjectUserStory;
+    /** External container context for 2-level directory structure */
+    externalContainer?: ExternalContainerContext;
+    /** Epic ID if part of an epic */
+    epicId?: string;
+    /**
+     * Per-US external references (v0.33.0+)
+     * Replaces the single external_ref for cross-project increments
+     * Maps: US-001 → { github: {...}, jira: {...} }
+     */
+    externalRefs?: USExternalRefsMap;
+    /**
+     * External tool sync target (v1.0.31+ - ADR-0211)
+     *
+     * Explicitly specifies which external tool profile this increment syncs with.
+     * Provides deterministic sync behavior and audit trail.
+     *
+     * Resolution priority:
+     * 1. This field (explicit)
+     * 2. **Project**: field in spec.md → config.projectMappings
+     * 3. config.sync.defaultProfile (fallback)
+     *
+     * @example
+     * ```json
+     * {
+     *   "syncTarget": {
+     *     "profileId": "github-frontend",
+     *     "provider": "github",
+     *     "derivedFrom": "project-mapping",
+     *     "setAt": "2025-12-18T10:30:00Z"
+     *   }
+     * }
+     * ```
+     */
+    syncTarget?: SyncTarget;
+    /**
+     * Pull request references for pr-based push strategy (v1.0.437+)
+     *
+     * Tracks branch names and PR URLs created during increment closure.
+     * Single-repo: array with one entry. Multi-repo/umbrella: one entry per touched repo.
+     *
+     * @example
+     * ```json
+     * {
+     *   "prRefs": [{
+     *     "branch": "sw/0520-pr-based-closure",
+     *     "prNumber": 42,
+     *     "prUrl": "https://github.com/org/repo/pull/42",
+     *     "state": "open",
+     *     "createdAt": "2026-03-12T10:00:00Z"
+     *   }]
+     * }
+     * ```
+     */
+    prRefs?: PrRef[];
+    /** When true, skip living docs sync for this increment (per-increment override) */
+    skipLivingDocsSync?: boolean;
+}
+/**
+ * Pull request reference for a single repository (v1.0.437+)
+ */
+export interface PrRef {
+    /** Branch name (e.g., 'sw/0016-checkout-flow') */
+    branch: string;
+    /** PR number */
+    prNumber?: number;
+    /** PR URL */
+    prUrl?: string;
+    /** Repository slug (owner/repo) for multi-repo. Omit for single-repo. */
+    repoSlug?: string;
+    /** PR state */
+    state?: 'open' | 'merged' | 'closed';
+    /** When the PR was created */
+    createdAt?: string;
+}
+//# sourceMappingURL=increment-metadata.d.ts.map

package/dist/plugins/specweave/lib/vendor/core/types/increment-metadata.js

@@ -0,0 +1,246 @@
+/**
+ * Increment Metadata Types
+ *
+ * Defines the schema for increment metadata tracking (status, type, timestamps).
+ * Part of increment 0007: Smart Status Management
+ */
+/**
+ * Increment status enum
+ * Tracks the lifecycle state of an increment
+ */
+export var IncrementStatus;
+(function (IncrementStatus) {
+    /** Planning phase - spec/plan/tasks being created (does NOT count towards WIP limits) */
+    IncrementStatus["PLANNING"] = "planning";
+    /** Currently being worked on */
+    IncrementStatus["ACTIVE"] = "active";
+    /** Planned but not ready to start yet (does NOT count towards WIP limits) */
+    IncrementStatus["BACKLOG"] = "backlog";
+    /** Temporarily stopped (blocked by external dependency, deprioritized) */
+    IncrementStatus["PAUSED"] = "paused";
+    /**
+     * All tasks complete, awaiting user review (v0.28.63+)
+     *
+     * CRITICAL: This is a gating status that prevents auto-completion bugs.
+     * - Auto-transitions to READY_FOR_REVIEW when all tasks completed
+     * - User MUST explicitly run /sw:done to move to COMPLETED
+     * - /sw:next will prompt for confirmation before closure
+     *
+     * Prevents the bug where status becomes "completed" without:
+     * 1. ACs being checked in spec.md
+     * 2. User approval
+     */
+    IncrementStatus["READY_FOR_REVIEW"] = "ready_for_review";
+    /** All tasks complete AND user approved - increment finished */
+    IncrementStatus["COMPLETED"] = "completed";
+    /** Work abandoned (requirements changed, obsolete, etc.) */
+    IncrementStatus["ABANDONED"] = "abandoned";
+})(IncrementStatus || (IncrementStatus = {}));
+/**
+ * Increment type enum
+ * Determines rules and limits applied to the increment
+ */
+export var IncrementType;
+(function (IncrementType) {
+    /** Critical production fix (bypasses all limits) */
+    IncrementType["HOTFIX"] = "hotfix";
+    /** Standard feature development (limit: 2 active) */
+    IncrementType["FEATURE"] = "feature";
+    /** Production bug fix with SRE investigation (unlimited, urgent) */
+    IncrementType["BUG"] = "bug";
+    /** Change request from stakeholders (limit: 2 active) */
+    IncrementType["CHANGE_REQUEST"] = "change-request";
+    /** Code improvement (limit: 1 active) */
+    IncrementType["REFACTOR"] = "refactor";
+    /** POC/spike work (unlimited, auto-abandon after 14 days) */
+    IncrementType["EXPERIMENT"] = "experiment";
+})(IncrementType || (IncrementType = {}));
+/**
+ * Valid status transitions
+ * Enforces increment lifecycle rules
+ *
+ * CRITICAL (v0.28.63+): ACTIVE cannot directly transition to COMPLETED!
+ * Must go through READY_FOR_REVIEW first, which requires explicit user approval.
+ * This prevents the auto-completion bug where increments are marked "completed"
+ * without ACs being checked or user confirmation.
+ */
+export const VALID_TRANSITIONS = {
+    [IncrementStatus.PLANNING]: [
+        IncrementStatus.ACTIVE, // Move to active when tasks start
+        IncrementStatus.BACKLOG, // Move to backlog if deprioritized
+        IncrementStatus.ABANDONED // Cancel planning
+    ],
+    [IncrementStatus.ACTIVE]: [
+        IncrementStatus.BACKLOG,
+        IncrementStatus.PAUSED,
+        IncrementStatus.READY_FOR_REVIEW, // All tasks done → awaiting review
+        IncrementStatus.ABANDONED
+        // NOTE: COMPLETED intentionally NOT allowed! Must go through READY_FOR_REVIEW
+    ],
+    [IncrementStatus.BACKLOG]: [
+        IncrementStatus.PLANNING, // Resume planning
+        IncrementStatus.ACTIVE,
+        IncrementStatus.ABANDONED
+    ],
+    [IncrementStatus.PAUSED]: [
+        IncrementStatus.ACTIVE,
+        IncrementStatus.READY_FOR_REVIEW, // Can mark done while paused
+        IncrementStatus.ABANDONED
+    ],
+    [IncrementStatus.READY_FOR_REVIEW]: [
+        IncrementStatus.COMPLETED, // ONLY via explicit /sw:done with user approval
+        IncrementStatus.ACTIVE, // Reopen if more work needed
+        IncrementStatus.ABANDONED // Cancel if requirements changed
+    ],
+    [IncrementStatus.COMPLETED]: [
+        // Allow reopening completed increments when issues discovered
+        IncrementStatus.ACTIVE, // Reopen for fixes
+        IncrementStatus.ABANDONED // Mark as failed (rare)
+    ],
+    [IncrementStatus.ABANDONED]: [
+        IncrementStatus.ACTIVE // Can un-abandon if needed (rare)
+    ]
+};
+/**
+ * Compute the shortest valid transition path from `from` to `to`.
+ *
+ * Uses BFS over the VALID_TRANSITIONS graph.
+ * Returns the sequence of intermediate + final states (excluding the starting state).
+ * Returns null if no valid path exists.
+ *
+ * Example: computeTransitionPath(PLANNING, COMPLETED)
+ *   => [ACTIVE, READY_FOR_REVIEW, COMPLETED]
+ */
+export function computeTransitionPath(from, to) {
+    if (from === to)
+        return [];
+    const queue = [
+        { status: from, path: [] }
+    ];
+    const visited = new Set([from]);
+    while (queue.length > 0) {
+        const current = queue.shift();
+        const neighbors = VALID_TRANSITIONS[current.status] ?? [];
+        for (const next of neighbors) {
+            if (visited.has(next))
+                continue;
+            const newPath = [...current.path, next];
+            if (next === to)
+                return newPath;
+            visited.add(next);
+            queue.push({ status: next, path: newPath });
+        }
+    }
+    return null;
+}
+/**
+ * Type-based limits
+ * Maximum active increments per type
+ *
+ * null = unlimited (no limit enforcement)
+ * User can configure per-project in .specweave/config.json
+ */
+export const TYPE_LIMITS = {
+    [IncrementType.HOTFIX]: null, // Unlimited (emergency work)
+    [IncrementType.FEATURE]: 2, // Max 2 active (context switching cost)
+    [IncrementType.BUG]: null, // Unlimited (production issues)
+    [IncrementType.CHANGE_REQUEST]: 2, // Max 2 active (stakeholder-driven)
+    [IncrementType.REFACTOR]: 1, // Max 1 active (needs focus)
+    [IncrementType.EXPERIMENT]: null // Unlimited (exploratory work)
+};
+/**
+ * Staleness thresholds (days)
+ * When to warn about stale increments
+ */
+export const STALENESS_THRESHOLDS = {
+    /** Warn if paused for more than this many days */
+    PAUSED: 7,
+    /** Warn if active for more than this many days */
+    ACTIVE: 30,
+    /** Auto-abandon experiments after this many days */
+    EXPERIMENT: 14
+};
+/**
+ * Default metadata for new increments
+ *
+ * NOTE: New increments start in PLANNING status by default.
+ * They auto-transition to ACTIVE when tasks.md is created or first task starts.
+ */
+export function createDefaultMetadata(id, type = IncrementType.FEATURE) {
+    const now = new Date().toISOString();
+    return {
+        id,
+        status: IncrementStatus.PLANNING, // Start in planning phase
+        type,
+        created: now,
+        lastActivity: now
+    };
+}
+/**
+ * Check if status transition is valid
+ */
+export function isValidTransition(from, to) {
+    const allowedTransitions = VALID_TRANSITIONS[from];
+    return allowedTransitions.includes(to);
+}
+/**
+ * Calculate days elapsed since a given date
+ */
+function daysSince(dateStr) {
+    return (Date.now() - new Date(dateStr).getTime()) / (1000 * 60 * 60 * 24);
+}
+/**
+ * Check if increment is stale (paused too long or active too long)
+ */
+export function isStale(metadata) {
+    if (metadata.status === IncrementStatus.PAUSED && metadata.pausedAt) {
+        return daysSince(metadata.pausedAt) > STALENESS_THRESHOLDS.PAUSED;
+    }
+    if (metadata.status === IncrementStatus.ACTIVE) {
+        return daysSince(metadata.created) > STALENESS_THRESHOLDS.ACTIVE;
+    }
+    return false;
+}
+/**
+ * Check if increment should be auto-abandoned (experiments only)
+ */
+export function shouldAutoAbandon(metadata) {
+    return metadata.type === IncrementType.EXPERIMENT &&
+        daysSince(metadata.lastActivity) > STALENESS_THRESHOLDS.EXPERIMENT;
+}
+/**
+ * Statuses that count toward WIP (Work In Progress) limits
+ *
+ * ACTIVE: Currently executing tasks, consumes team capacity
+ * PAUSED: Temporarily blocked but still holding resources/context
+ * READY_FOR_REVIEW: Tasks done, awaiting approval (still blocks capacity)
+ *
+ * Statuses that do NOT count:
+ * - PLANNING: Lightweight spec/planning work, parallel-safe
+ * - BACKLOG: Not started yet
+ * - COMPLETED: Already done (user approved)
+ * - ABANDONED: Cancelled
+ */
+export const WIP_COUNTED_STATUSES = [
+    IncrementStatus.ACTIVE,
+    IncrementStatus.PAUSED, // Paused work still blocks team capacity
+    IncrementStatus.READY_FOR_REVIEW // Awaiting user approval, still in progress
+];
+/**
+ * Check if increment status counts toward WIP (Work In Progress) limits
+ */
+export function countsTowardWipLimit(status) {
+    return WIP_COUNTED_STATUSES.includes(status);
+}
+/**
+ * Validate if a status transition is allowed
+ * @throws Error if transition is invalid
+ */
+export function validateTransition(from, to) {
+    if (!isValidTransition(from, to)) {
+        const validTransitions = VALID_TRANSITIONS[from];
+        throw new Error(`Invalid transition: ${from} → ${to}.\n` +
+            `Valid transitions from ${from}: ${validTransitions.join(', ')}`);
+    }
+}
+//# sourceMappingURL=increment-metadata.js.map

package/dist/plugins/specweave/lib/vendor/core/types/increment-metadata.js.map

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