specweave 2.3.0 → 3.0.1

package/dist/src/core/types/spec-identifier.d.ts

@@ -1,67 +0,0 @@
-/**
- * Spec Identifier Types
- *
- * Flexible identifier system that supports:
- * - External tool IDs (JIRA-AUTH-123, ADO-12345, GH-456)
- * - Custom user-defined IDs
- * - Title-based slugs (user-authentication-system)
- * - Sequential numbers (spec-001)
- */
-export type SpecIdentifierSource = 'external-jira' | 'external-ado' | 'external-github' | 'custom' | 'title-slug' | 'sequential' | 'hybrid-prefix';
-export interface SpecIdentifier {
-    /** Full identifier including project: "backend/JIRA-AUTH-123" */
-    full: string;
-    /** Display-friendly identifier: "JIRA-AUTH-123" or "user-authentication" */
-    display: string;
-    /** Where this ID came from */
-    source: SpecIdentifierSource;
-    /** External tool ID if applicable: "AUTH-123" (JIRA), "12345" (ADO), "#456" (GitHub) */
-    externalId?: string;
-    /** Direct link to external issue/epic */
-    externalUrl?: string;
-    /** Project this spec belongs to: "backend", "frontend", "mobile" */
-    project: string;
-    /** Whether ID is stable (doesn't change with content) */
-    stable: boolean;
-    /** Compact display format: "BE-JIRA-AUTH-123", "FE-user-auth" */
-    compact: string;
-}
-export interface SpecContent {
-    /** Raw markdown content */
-    content: string;
-    /** Parsed frontmatter */
-    frontmatter: Record<string, any>;
-    /** Spec title (from frontmatter or first heading) */
-    title: string;
-    /** Project identifier */
-    project: string;
-    /** File path */
-    path: string;
-}
-export interface ProjectConfig {
-    /** Unique project ID */
-    id: string;
-    /** Display name */
-    displayName: string;
-    /** Project description */
-    description?: string;
-    /** GitHub repository configuration */
-    github?: {
-        owner: string;
-        repo: string;
-    } | null;
-    /** Default labels for GitHub issues */
-    defaultLabels?: string[];
-    /** Team name */
-    team?: string;
-    /** Whether to sync this project to GitHub */
-    syncEnabled?: boolean;
-}
-export interface ProjectsConfig {
-    [projectId: string]: ProjectConfig;
-}
-/** Project code mapping for compact display */
-export declare const PROJECT_CODES: Record<string, string>;
-/** Get project code from project ID */
-export declare function getProjectCode(projectId: string): string;
-//# sourceMappingURL=spec-identifier.d.ts.map

package/dist/src/core/types/spec-identifier.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-identifier.d.ts","sourceRoot":"","sources":["../../../../src/core/types/spec-identifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,cAAc,GACd,iBAAiB,GACjB,QAAQ,GACR,YAAY,GACZ,YAAY,GACZ,eAAe,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IAEb,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,MAAM,EAAE,oBAAoB,CAAC;IAE7B,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAEhB,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAC;IAEhB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAEhB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjC,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IAEd,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,sCAAsC;IACtC,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,IAAI,CAAC;IAET,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC;CACpC;AAED,+CAA+C;AAC/C,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOhD,CAAC;AAEF,uCAAuC;AACvC,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/src/core/types/spec-identifier.js

@@ -1,23 +0,0 @@
-/**
- * Spec Identifier Types
- *
- * Flexible identifier system that supports:
- * - External tool IDs (JIRA-AUTH-123, ADO-12345, GH-456)
- * - Custom user-defined IDs
- * - Title-based slugs (user-authentication-system)
- * - Sequential numbers (spec-001)
- */
-/** Project code mapping for compact display */
-export const PROJECT_CODES = {
-    backend: 'BE',
-    frontend: 'FE',
-    mobile: 'MB',
-    infra: 'IN',
-    _parent: 'PA',
-    default: 'DF'
-};
-/** Get project code from project ID */
-export function getProjectCode(projectId) {
-    return PROJECT_CODES[projectId] || projectId.toUpperCase().substring(0, 2);
-}
-//# sourceMappingURL=spec-identifier.js.map

package/dist/src/core/types/spec-identifier.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-identifier.js","sourceRoot":"","sources":["../../../../src/core/types/spec-identifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoFH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,uCAAuC;AACvC,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/src/core/types/sync-config-validator.d.ts

@@ -1,54 +0,0 @@
-/**
- * Sync Config Validator - Validates critical sync configuration rules
- *
- * Enforces immutable architectural constraints:
- * 1. Increment → Living Docs MUST be one-way (IMMUTABLE)
- * 2. autoIncrementCreation MUST be false (FORBIDDEN)
- * 3. Warns if all permissions enabled (conflict risk)
- *
- * Part of v0.24.0 three-permission architecture (FS-047)
- */
-import { SyncSettings } from './sync-settings.js';
-/**
- * Validation result for sync configuration
- */
-export interface SyncConfigValidationResult {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-}
-/**
- * Config structure (partial, relevant to sync validation)
- */
-export interface SyncConfig {
-    sync?: {
-        settings?: SyncSettings;
-        incrementToLivingDocs?: 'one-way' | 'two-way';
-        autoIncrementCreation?: boolean;
-        [key: string]: any;
-    };
-}
-/**
- * Validate sync configuration against architectural rules
- *
- * @param config - Configuration object from .specweave/config.json
- * @returns Validation result with errors and warnings
- */
-export declare function validateSyncConfig(config: SyncConfig): SyncConfigValidationResult;
-/**
- * Throw error if sync config is invalid
- *
- * @param config - Configuration object from .specweave/config.json
- * @param options - Optional logger for warnings
- * @throws Error if validation fails
- */
-export declare function assertValidSyncConfig(config: SyncConfig, options?: {
-    logger?: {
-        warn: (message: string) => void;
-    };
-}): void;
-/**
- * Get human-readable summary of sync config validation
- */
-export declare function getSyncConfigSummary(config: SyncConfig): string;
-//# sourceMappingURL=sync-config-validator.d.ts.map

package/dist/src/core/types/sync-config-validator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sync-config-validator.d.ts","sourceRoot":"","sources":["../../../../src/core/types/sync-config-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAwB,MAAM,oBAAoB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,YAAY,CAAC;QACxB,qBAAqB,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;QAC9C,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,0BAA0B,CA0EjF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAA;CAAO,GAC7D,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAoB/D"}

package/dist/src/core/types/sync-config-validator.js

@@ -1,112 +0,0 @@
-/**
- * Sync Config Validator - Validates critical sync configuration rules
- *
- * Enforces immutable architectural constraints:
- * 1. Increment → Living Docs MUST be one-way (IMMUTABLE)
- * 2. autoIncrementCreation MUST be false (FORBIDDEN)
- * 3. Warns if all permissions enabled (conflict risk)
- *
- * Part of v0.24.0 three-permission architecture (FS-047)
- */
-import { validateSyncSettings } from './sync-settings.js';
-/**
- * Validate sync configuration against architectural rules
- *
- * @param config - Configuration object from .specweave/config.json
- * @returns Validation result with errors and warnings
- */
-export function validateSyncConfig(config) {
-    const result = {
-        valid: true,
-        errors: [],
-        warnings: [],
-    };
-    // If no sync config, that's fine (safe defaults apply)
-    if (!config.sync) {
-        return result;
-    }
-    const { sync } = config;
-    // Rule 1: Validate SyncSettings structure (if provided)
-    if (sync.settings) {
-        try {
-            validateSyncSettings(sync.settings);
-        }
-        catch (error) {
-            result.valid = false;
-            result.errors.push(`Invalid sync settings: ${error.message}`);
-        }
-    }
-    // Rule 2: incrementToLivingDocs MUST be 'one-way' (immutable architectural rule)
-    if (sync.incrementToLivingDocs !== undefined && sync.incrementToLivingDocs !== 'one-way') {
-        result.valid = false;
-        result.errors.push(`sync.incrementToLivingDocs MUST be 'one-way' (found: '${sync.incrementToLivingDocs}'). ` +
-            'Increment → Living Docs sync is ALWAYS one-way by architectural design. ' +
-            'This direction is IMMUTABLE and cannot be configured.');
-    }
-    // Rule 3: autoIncrementCreation MUST be false (forbidden feature)
-    if (sync.autoIncrementCreation === true) {
-        result.valid = false;
-        result.errors.push('sync.autoIncrementCreation MUST be false. ' +
-            'Auto-creating increments for external items is FORBIDDEN. ' +
-            'External items live in living docs ONLY. ' +
-            'Users MUST manually create increments when ready to work on external items.');
-    }
-    // Warning: All permissions enabled (full sync mode)
-    if (sync.settings &&
-        sync.settings.canUpsertInternalItems === true &&
-        sync.settings.canUpdateExternalItems === true &&
-        sync.settings.canUpdateStatus === true) {
-        result.warnings.push('⚠️  All sync permissions enabled (full sync mode). ' +
-            'This allows bidirectional sync between SpecWeave and external tools. ' +
-            'Be aware of potential sync conflicts when multiple tools modify the same items. ' +
-            'Consider enabling only the permissions you need for your workflow.');
-    }
-    // Warning: Conflicting permissions (update external without status)
-    if (sync.settings &&
-        sync.settings.canUpdateExternalItems === true &&
-        sync.settings.canUpdateStatus === false) {
-        result.warnings.push('⚠️  canUpdateExternalItems=true but canUpdateStatus=false. ' +
-            'External items will be updated with content changes but status will not sync. ' +
-            'Consider enabling canUpdateStatus if you want status to reflect completion.');
-    }
-    return result;
-}
-/**
- * Throw error if sync config is invalid
- *
- * @param config - Configuration object from .specweave/config.json
- * @param options - Optional logger for warnings
- * @throws Error if validation fails
- */
-export function assertValidSyncConfig(config, options = {}) {
-    const result = validateSyncConfig(config);
-    if (!result.valid) {
-        throw new Error(`Invalid sync configuration:\n${result.errors.join('\n')}`);
-    }
-    // Log warnings (but don't throw)
-    if (result.warnings.length > 0 && options.logger) {
-        options.logger.warn('Sync configuration warnings:');
-        result.warnings.forEach((warning) => options.logger.warn(warning));
-    }
-}
-/**
- * Get human-readable summary of sync config validation
- */
-export function getSyncConfigSummary(config) {
-    const result = validateSyncConfig(config);
-    const lines = [
-        '=== Sync Configuration Validation ===',
-        `Valid: ${result.valid ? '✅ Yes' : '❌ No'}`,
-    ];
-    if (result.errors.length > 0) {
-        lines.push('\nErrors:', ...result.errors.map((e) => `  ❌ ${e}`));
-    }
-    if (result.warnings.length > 0) {
-        lines.push('\nWarnings:', ...result.warnings.map((w) => `  ⚠️  ${w}`));
-    }
-    if (result.valid && result.errors.length === 0 && result.warnings.length === 0) {
-        lines.push('\n✅ All sync configuration rules satisfied');
-    }
-    return lines.join('\n');
-}
-//# sourceMappingURL=sync-config-validator.js.map

package/dist/src/core/types/sync-config-validator.js.map

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

package/dist/src/core/us-completion-detector.d.ts

@@ -1,124 +0,0 @@
-/**
- * User Story Completion Detector
- *
- * Detects when user stories become fully complete (all ACs satisfied)
- * and triggers living docs + external tool sync.
- *
- * CRITICAL: This module enables automatic US-level sync cascade:
- * Task completion → AC marking → US detection → Living docs sync → External tools sync
- *
- * Architecture:
- * - Parses spec.md to extract all ACs
- * - Groups ACs by user story (AC-US1-01 → US-001)
- * - Detects which USs have ALL ACs marked [x]
- * - Tracks completion state to prevent re-sync
- *
- * Integration:
- * - Called by consolidated-sync.js after AC sync
- * - Returns newly completed USs (state transition detection)
- * - Living docs sync handles external tool updates
- */
-import { Logger } from '../utils/logger.js';
-/**
- * User Story completion data
- */
-export interface UserStoryCompletion {
-    usId: string;
-    title: string;
-    totalACs: number;
-    completedACs: number;
-    percentage: number;
-    isComplete: boolean;
-    status: string;
-    acIds: string[];
-    completedAcIds: string[];
-    wasAlreadyComplete: boolean;
-}
-/**
- * User Story Completion Detector
- *
- * Detects when user stories transition from incomplete to complete
- * and triggers sync cascade.
- */
-export declare class USCompletionDetector {
-    private projectRoot;
-    private logger;
-    constructor(projectRoot: string, options?: {
-        logger?: Logger;
-    });
-    /**
-     * Detect user story completions for an increment
-     *
-     * @param incrementId - Increment ID (e.g., "0053-safe-feature-deletion")
-     * @returns Array of user story completion data
-     */
-    detectCompletions(incrementId: string): Promise<UserStoryCompletion[]>;
-    /**
-     * Get only NEWLY completed user stories (state transition detection)
-     *
-     * @param incrementId - Increment ID
-     * @returns Array of newly completed user stories (excludes already-complete USs)
-     */
-    getNewlyCompletedUSs(incrementId: string): Promise<UserStoryCompletion[]>;
-    /**
-     * Parse spec.md to extract all acceptance criteria
-     *
-     * @param incrementId - Increment ID
-     * @returns Array of AC data
-     */
-    private parseSpecACs;
-    /**
-     * Group ACs by user story
-     *
-     * @param acs - Array of AC data
-     * @returns Map of US-ID to array of ACs
-     */
-    private groupACsByUserStory;
-    /**
-     * Calculate completion status for each user story
-     *
-     * @param usGroups - Map of US-ID to array of ACs
-     * @returns Array of user story completion data
-     */
-    private calculateCompletions;
-    /**
-     * Calculate user story status based on AC completion
-     *
-     * Status mapping (Universal 5-level hierarchy - Level 2):
-     * - 0% complete → "not_started"
-     * - 1-99% complete → "in_progress"
-     * - 100% complete → "completed"
-     *
-     * @param percentage - Completion percentage (0-100)
-     * @param completedACs - Number of completed ACs
-     * @returns User story status
-     */
-    private calculateUSStatus;
-    /**
-     * Extract user story title from ACs or generate default
-     *
-     * @param usId - User story ID
-     * @param acs - Array of ACs for this user story
-     * @returns User story title
-     */
-    private extractUSTitle;
-    /**
-     * Load previous completion state from disk
-     *
-     * @param incrementId - Increment ID
-     * @returns Set of previously completed US IDs
-     */
-    private loadCompletionState;
-    /**
-     * Save completion state to disk
-     *
-     * @param incrementId - Increment ID
-     * @param completions - Array of user story completion data
-     */
-    saveCompletionState(incrementId: string, completions: UserStoryCompletion[]): Promise<void>;
-    /**
-     * Check if file exists
-     */
-    private fileExists;
-}
-//# sourceMappingURL=us-completion-detector.d.ts.map

package/dist/src/core/us-completion-detector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"us-completion-detector.d.ts","sourceRoot":"","sources":["../../../src/core/us-completion-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAE,MAAM,EAAiB,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAaD;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;gBAEX,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAKlE;;;;;OAKG;IACG,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAgC5E;;;;;OAKG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAQ/E;;;;;OAKG;YACW,YAAY;IA+C1B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAuC5B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAMtB;;;;;OAKG;YACW,mBAAmB;IA4BjC;;;;;OAKG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,mBAAmB,EAAE,GACjC,OAAO,CAAC,IAAI,CAAC;IAiChB;;OAEG;YACW,UAAU;CAQzB"}

package/dist/src/core/us-completion-detector.js

@@ -1,270 +0,0 @@
-/**
- * User Story Completion Detector
- *
- * Detects when user stories become fully complete (all ACs satisfied)
- * and triggers living docs + external tool sync.
- *
- * CRITICAL: This module enables automatic US-level sync cascade:
- * Task completion → AC marking → US detection → Living docs sync → External tools sync
- *
- * Architecture:
- * - Parses spec.md to extract all ACs
- * - Groups ACs by user story (AC-US1-01 → US-001)
- * - Detects which USs have ALL ACs marked [x]
- * - Tracks completion state to prevent re-sync
- *
- * Integration:
- * - Called by consolidated-sync.js after AC sync
- * - Returns newly completed USs (state transition detection)
- * - Living docs sync handles external tool updates
- */
-import { promises as fs } from 'fs';
-import path from 'path';
-import { consoleLogger } from '../utils/logger.js';
-/**
- * User Story Completion Detector
- *
- * Detects when user stories transition from incomplete to complete
- * and triggers sync cascade.
- */
-export class USCompletionDetector {
-    constructor(projectRoot, options = {}) {
-        this.projectRoot = projectRoot;
-        this.logger = options.logger ?? consoleLogger;
-    }
-    /**
-     * Detect user story completions for an increment
-     *
-     * @param incrementId - Increment ID (e.g., "0053-safe-feature-deletion")
-     * @returns Array of user story completion data
-     */
-    async detectCompletions(incrementId) {
-        try {
-            // 1. Parse spec.md to extract all ACs
-            const acs = await this.parseSpecACs(incrementId);
-            if (acs.length === 0) {
-                this.logger.log(`   ℹ️  No ACs found in spec.md for ${incrementId}`);
-                return [];
-            }
-            // 2. Group ACs by user story
-            const usGroups = this.groupACsByUserStory(acs);
-            // 3. Calculate completion status for each user story
-            const completions = this.calculateCompletions(usGroups);
-            // 4. Load previous completion state (to detect NEW completions)
-            const previousState = await this.loadCompletionState(incrementId);
-            // 5. Mark which USs were already complete
-            for (const completion of completions) {
-                completion.wasAlreadyComplete = previousState.has(completion.usId);
-            }
-            return completions;
-        }
-        catch (error) {
-            this.logger.error(`   ❌ Failed to detect US completions for ${incrementId}:`, error);
-            return [];
-        }
-    }
-    /**
-     * Get only NEWLY completed user stories (state transition detection)
-     *
-     * @param incrementId - Increment ID
-     * @returns Array of newly completed user stories (excludes already-complete USs)
-     */
-    async getNewlyCompletedUSs(incrementId) {
-        const completions = await this.detectCompletions(incrementId);
-        return completions.filter(us => us.isComplete && !us.wasAlreadyComplete);
-    }
-    /**
-     * Parse spec.md to extract all acceptance criteria
-     *
-     * @param incrementId - Increment ID
-     * @returns Array of AC data
-     */
-    async parseSpecACs(incrementId) {
-        const specPath = path.join(this.projectRoot, '.specweave/increments', incrementId, 'spec.md');
-        if (!await this.fileExists(specPath)) {
-            throw new Error(`spec.md not found: ${specPath}`);
-        }
-        const content = await fs.readFile(specPath, 'utf-8');
-        const lines = content.split('\n');
-        const acs = [];
-        // Pattern: - [x] **AC-US1-01**: Description
-        // Also supports: - [ ] AC-US1-01: Description (without bold)
-        const acPattern = /^[-*]\s+\[([ x])\]\s+\*{0,2}(AC-US\d+-\d+)\*{0,2}:\s+(.+?)$/;
-        for (let i = 0; i < lines.length; i++) {
-            const match = lines[i].match(acPattern);
-            if (match) {
-                const completed = match[1] === 'x';
-                const acId = match[2];
-                const description = match[3];
-                // Extract user story ID from AC ID (AC-US1-01 → US-001)
-                const usMatch = acId.match(/AC-US(\d+)-\d+/);
-                if (usMatch) {
-                    const usNum = usMatch[1].padStart(3, '0'); // 1 → 001
-                    const usId = `US-${usNum}`;
-                    acs.push({
-                        acId,
-                        usId,
-                        description,
-                        completed,
-                        lineNumber: i + 1
-                    });
-                }
-            }
-        }
-        return acs;
-    }
-    /**
-     * Group ACs by user story
-     *
-     * @param acs - Array of AC data
-     * @returns Map of US-ID to array of ACs
-     */
-    groupACsByUserStory(acs) {
-        const groups = new Map();
-        for (const ac of acs) {
-            if (!groups.has(ac.usId)) {
-                groups.set(ac.usId, []);
-            }
-            groups.get(ac.usId).push(ac);
-        }
-        return groups;
-    }
-    /**
-     * Calculate completion status for each user story
-     *
-     * @param usGroups - Map of US-ID to array of ACs
-     * @returns Array of user story completion data
-     */
-    calculateCompletions(usGroups) {
-        const completions = [];
-        for (const [usId, usACs] of usGroups.entries()) {
-            const totalACs = usACs.length;
-            const completedACs = usACs.filter(ac => ac.completed).length;
-            const percentage = totalACs > 0
-                ? Math.round((completedACs / totalACs) * 100 * 100) / 100
-                : 0;
-            const isComplete = percentage === 100;
-            // Calculate user story status based on AC completion
-            const status = this.calculateUSStatus(percentage, completedACs);
-            const acIds = usACs.map(ac => ac.acId);
-            const completedAcIds = usACs.filter(ac => ac.completed).map(ac => ac.acId);
-            // Extract title from first AC description (if available)
-            const title = this.extractUSTitle(usId, usACs);
-            completions.push({
-                usId,
-                title,
-                totalACs,
-                completedACs,
-                percentage,
-                isComplete,
-                status,
-                acIds,
-                completedAcIds,
-                wasAlreadyComplete: false // Will be set by detectCompletions()
-            });
-        }
-        return completions;
-    }
-    /**
-     * Calculate user story status based on AC completion
-     *
-     * Status mapping (Universal 5-level hierarchy - Level 2):
-     * - 0% complete → "not_started"
-     * - 1-99% complete → "in_progress"
-     * - 100% complete → "completed"
-     *
-     * @param percentage - Completion percentage (0-100)
-     * @param completedACs - Number of completed ACs
-     * @returns User story status
-     */
-    calculateUSStatus(percentage, completedACs) {
-        if (percentage === 0) {
-            return 'not_started';
-        }
-        else if (percentage === 100) {
-            return 'completed';
-        }
-        else {
-            return 'in_progress';
-        }
-    }
-    /**
-     * Extract user story title from ACs or generate default
-     *
-     * @param usId - User story ID
-     * @param acs - Array of ACs for this user story
-     * @returns User story title
-     */
-    extractUSTitle(usId, acs) {
-        // For now, just return the US ID
-        // TODO: Extract actual title from spec.md user story heading
-        return usId;
-    }
-    /**
-     * Load previous completion state from disk
-     *
-     * @param incrementId - Increment ID
-     * @returns Set of previously completed US IDs
-     */
-    async loadCompletionState(incrementId) {
-        const statePath = path.join(this.projectRoot, '.specweave/state', `us-completion-${incrementId}.json`);
-        try {
-            if (!await this.fileExists(statePath)) {
-                return new Set();
-            }
-            const content = await fs.readFile(statePath, 'utf-8');
-            const data = JSON.parse(content);
-            // Return set of US IDs that were marked as complete
-            return new Set(Object.entries(data)
-                .filter(([_, state]) => state.completed)
-                .map(([usId]) => usId));
-        }
-        catch (error) {
-            this.logger.warn(`   ⚠️  Failed to load completion state: ${error}`);
-            return new Set();
-        }
-    }
-    /**
-     * Save completion state to disk
-     *
-     * @param incrementId - Increment ID
-     * @param completions - Array of user story completion data
-     */
-    async saveCompletionState(incrementId, completions) {
-        const statePath = path.join(this.projectRoot, '.specweave/state', `us-completion-${incrementId}.json`);
-        try {
-            // Ensure state directory exists
-            await fs.mkdir(path.dirname(statePath), { recursive: true });
-            // Build state object
-            const state = {};
-            for (const completion of completions) {
-                state[completion.usId] = {
-                    completed: completion.isComplete,
-                    percentage: completion.percentage,
-                    completedAt: completion.isComplete ? new Date().toISOString() : null,
-                    totalACs: completion.totalACs,
-                    completedACs: completion.completedACs
-                };
-            }
-            // Write to disk
-            await fs.writeFile(statePath, JSON.stringify(state, null, 2), 'utf-8');
-            this.logger.log(`   ✅ Saved completion state: ${statePath}`);
-        }
-        catch (error) {
-            this.logger.error(`   ❌ Failed to save completion state: ${error}`);
-        }
-    }
-    /**
-     * Check if file exists
-     */
-    async fileExists(filePath) {
-        try {
-            await fs.access(filePath);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-}
-//# sourceMappingURL=us-completion-detector.js.map