specweave 0.22.13 → 0.23.0

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

@@ -0,0 +1,157 @@
+/**
+ * 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, 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';
+    /** Coverage target percentage (70-95, 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;
+}
+/**
+ * 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
+ */
+export declare const VALID_TRANSITIONS: Record<IncrementStatus, IncrementStatus[]>;
+/**
+ * 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
+ *
+ * Statuses that do NOT count:
+ * - PLANNING: Lightweight spec/planning work, parallel-safe
+ * - BACKLOG: Not started yet
+ * - COMPLETED: Already done
+ * - 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;
+//# sourceMappingURL=increment-metadata.d.ts.map

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

@@ -0,0 +1,191 @@
+/**
+ * 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, 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
+ */
+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.COMPLETED,
+        IncrementStatus.ABANDONED
+    ],
+    [IncrementStatus.BACKLOG]: [
+        IncrementStatus.PLANNING, // Resume planning
+        IncrementStatus.ACTIVE,
+        IncrementStatus.ABANDONED
+    ],
+    [IncrementStatus.PAUSED]: [
+        IncrementStatus.ACTIVE,
+        IncrementStatus.ABANDONED
+    ],
+    [IncrementStatus.COMPLETED]: [
+        // NEW: 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)
+    ]
+};
+/**
+ * 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);
+}
+/**
+ * Check if increment is stale (paused too long or active too long)
+ */
+export function isStale(metadata) {
+    const now = new Date();
+    if (metadata.status === IncrementStatus.PAUSED && metadata.pausedAt) {
+        const pausedDate = new Date(metadata.pausedAt);
+        const daysPaused = (now.getTime() - pausedDate.getTime()) / (1000 * 60 * 60 * 24);
+        return daysPaused > STALENESS_THRESHOLDS.PAUSED;
+    }
+    if (metadata.status === IncrementStatus.ACTIVE) {
+        const createdDate = new Date(metadata.created);
+        const daysActive = (now.getTime() - createdDate.getTime()) / (1000 * 60 * 60 * 24);
+        return daysActive > STALENESS_THRESHOLDS.ACTIVE;
+    }
+    return false;
+}
+/**
+ * Check if increment should be auto-abandoned (experiments only)
+ */
+export function shouldAutoAbandon(metadata) {
+    if (metadata.type !== IncrementType.EXPERIMENT) {
+        return false;
+    }
+    const now = new Date();
+    const lastActivityDate = new Date(metadata.lastActivity);
+    const daysSinceActivity = (now.getTime() - lastActivityDate.getTime()) / (1000 * 60 * 60 * 24);
+    return daysSinceActivity > 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
+ *
+ * Statuses that do NOT count:
+ * - PLANNING: Lightweight spec/planning work, parallel-safe
+ * - BACKLOG: Not started yet
+ * - COMPLETED: Already done
+ * - ABANDONED: Cancelled
+ */
+export const WIP_COUNTED_STATUSES = [
+    IncrementStatus.ACTIVE,
+    IncrementStatus.PAUSED // Paused work still blocks team capacity
+];
+/**
+ * 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/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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"}

package/plugins/specweave/lib/vendor/generators/spec/task-parser.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Task Parser with US-Task Linkage Support
+ *
+ * Parses tasks.md files to extract task metadata including new US linkage fields:
+ * - userStory: US-ID this task implements (e.g., "US-001")
+ * - satisfiesACs: List of AC-IDs this task satisfies (e.g., ["AC-US1-01", "AC-US1-02"])
+ *
+ * Supports hierarchical task structure grouped by User Story.
+ */
+/**
+ * Task metadata extracted from tasks.md
+ */
+export interface Task {
+    /** Task ID (e.g., "T-001") */
+    id: string;
+    /** Task title */
+    title: string;
+    /** User Story this task implements (optional for backward compatibility) */
+    userStory?: string;
+    /** Acceptance Criteria IDs this task satisfies (optional) */
+    satisfiesACs?: string[];
+    /** Task completion status */
+    status: TaskStatus;
+    /** Priority level (P0, P1, P2, P3) */
+    priority?: string;
+    /** Estimated effort (e.g., "4 hours", "2 days") */
+    estimatedEffort?: string;
+    /** Task dependencies (task IDs this depends on) */
+    dependencies?: string[];
+    /** Full task description */
+    description?: string;
+    /** Files affected by this task */
+    filesAffected?: string[];
+    /** Line number in tasks.md (for error reporting) */
+    lineNumber?: number;
+}
+/**
+ * Task completion status
+ */
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'transferred' | 'canceled';
+/**
+ * Tasks grouped by User Story
+ */
+export interface TasksByUserStory {
+    [usId: string]: Task[];
+}
+/**
+ * Validation error for task linkage
+ */
+export interface TaskLinkageError {
+    taskId: string;
+    field: 'userStory' | 'satisfiesACs';
+    value: string;
+    message: string;
+    suggestedFix?: string;
+}
+/**
+ * Parse tasks.md and extract all tasks with US linkage
+ *
+ * @param tasksPath - Path to tasks.md file
+ * @returns Map of User Story ID → Tasks
+ * @throws Error if tasks.md cannot be read or is malformed
+ */
+export declare function parseTasksWithUSLinks(tasksPath: string): TasksByUserStory;
+/**
+ * Validate task US and AC linkage
+ *
+ * @param task - Task to validate
+ * @param validUSIds - List of valid US-IDs from spec.md
+ * @param validACIds - List of valid AC-IDs from spec.md
+ * @returns Array of validation errors (empty if valid)
+ */
+export declare function validateTaskLinkage(task: Task, validUSIds: string[], validACIds: string[]): TaskLinkageError[];
+/**
+ * Get all tasks (flattened, not grouped by US)
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Array of all tasks
+ */
+export declare function getAllTasks(tasksByUS: TasksByUserStory): Task[];
+/**
+ * Count tasks by status
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Map of status → count
+ */
+export declare function countTasksByStatus(tasksByUS: TasksByUserStory): Record<TaskStatus, number>;
+/**
+ * Calculate completion percentage
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Completion percentage (0-100)
+ */
+export declare function calculateCompletionPercentage(tasksByUS: TasksByUserStory): number;
+//# sourceMappingURL=task-parser.d.ts.map