specweave 0.23.8 → 0.23.12

package/dist/src/core/config/types.d.ts

@@ -0,0 +1,216 @@
+/**
+ * SpecWeave Configuration Types
+ *
+ * Defines the structure for .specweave/config.json
+ *
+ * @module core/config/types
+ */
+/**
+ * Repository provider types
+ */
+export type RepositoryProvider = 'local' | 'github' | 'bitbucket' | 'ado' | 'gitlab' | 'generic';
+/**
+ * Issue tracker provider types
+ */
+export type IssueTrackerProvider = 'none' | 'jira' | 'github' | 'ado';
+/**
+ * Jira instance types
+ */
+export type JiraInstanceType = 'cloud' | 'server';
+/**
+ * Jira organization strategies
+ */
+export type JiraStrategy = 'single-project' | 'project-per-team' | 'component-based' | 'board-based';
+/**
+ * Sync direction types
+ */
+export type SyncDirection = 'import' | 'export' | 'bidirectional';
+/**
+ * Repository configuration
+ */
+export interface RepoConfig {
+    name: string;
+    url: string;
+    path?: string;
+    branch?: string;
+    specweaveProject?: string;
+}
+/**
+ * Jira project configuration
+ */
+export interface JiraProjectConfig {
+    key: string;
+    id?: string;
+    name?: string;
+    specweaveProject?: string;
+}
+/**
+ * Jira board configuration
+ */
+export interface JiraBoardConfig {
+    id: string;
+    name?: string;
+}
+/**
+ * Repository configuration section
+ */
+export interface RepositoryConfiguration {
+    provider: RepositoryProvider;
+    organization?: string;
+    repos?: RepoConfig[];
+}
+/**
+ * Issue tracker configuration section
+ */
+export interface IssueTrackerConfiguration {
+    provider: IssueTrackerProvider;
+    domain?: string;
+    instanceType?: JiraInstanceType;
+    strategy?: JiraStrategy;
+    projects?: JiraProjectConfig[];
+    components?: string[];
+    boards?: JiraBoardConfig[];
+    owner?: string;
+    repo?: string;
+    repos?: string[];
+    organization_ado?: string;
+    project?: string;
+}
+/**
+ * Sync profile configuration
+ */
+export interface SyncProfile {
+    provider: string;
+    displayName: string;
+    config: {
+        owner?: string;
+        repo?: string;
+        domain?: string;
+        projectKey?: string;
+        projects?: string[];
+        organization?: string;
+        project?: string;
+        monorepoProjects?: string[];
+    };
+    timeRange: {
+        default: string;
+        max: string;
+    };
+    rateLimits?: {
+        maxItemsPerSync: number;
+        warnThreshold: number;
+    };
+}
+/**
+ * Sync settings
+ */
+export interface SyncSettings {
+    canUpsertInternalItems: boolean;
+    canUpdateExternalItems: boolean;
+    canUpdateStatus: boolean;
+}
+/**
+ * Sync configuration section
+ */
+export interface SyncConfiguration {
+    enabled: boolean;
+    direction: SyncDirection;
+    autoSync: boolean;
+    includeStatus: boolean;
+    autoApplyLabels: boolean;
+    provider?: string;
+    activeProfile?: string;
+    settings?: SyncSettings;
+    profiles?: Record<string, SyncProfile>;
+}
+/**
+ * Permission configuration section
+ */
+export interface PermissionsConfiguration {
+    canCreate: boolean;
+    canUpdate: boolean;
+    canUpdateStatus: boolean;
+}
+/**
+ * Hook configuration
+ */
+export interface HookConfiguration {
+    post_task_completion?: {
+        sync_living_docs?: boolean;
+        sync_tasks_md?: boolean;
+        external_tracker_sync?: boolean;
+    };
+    post_increment_planning?: {
+        auto_create_github_issue?: boolean;
+    };
+}
+/**
+ * Project metadata
+ */
+export interface ProjectMetadata {
+    name: string;
+    version: string;
+}
+/**
+ * Adapter configuration
+ */
+export interface AdapterConfiguration {
+    default: string;
+}
+/**
+ * Main SpecWeave configuration
+ */
+export interface SpecWeaveConfig {
+    /**
+     * Config version for migration support
+     */
+    version: string;
+    /**
+     * Project metadata (optional, for backward compatibility)
+     */
+    project?: ProjectMetadata;
+    /**
+     * Adapter configuration (optional, for backward compatibility)
+     */
+    adapters?: AdapterConfiguration;
+    /**
+     * Hook configuration (optional)
+     */
+    hooks?: HookConfiguration;
+    /**
+     * Repository provider configuration
+     */
+    repository?: RepositoryConfiguration;
+    /**
+     * Issue tracker configuration
+     */
+    issueTracker?: IssueTrackerConfiguration;
+    /**
+     * Sync configuration
+     */
+    sync?: SyncConfiguration;
+    /**
+     * Permissions configuration
+     */
+    permissions?: PermissionsConfiguration;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: SpecWeaveConfig;
+/**
+ * Validation error
+ */
+export interface ValidationError {
+    path: string;
+    message: string;
+    value?: any;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/config/types.d.ts.map

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

package/dist/src/core/config/types.js

@@ -0,0 +1,32 @@
+/**
+ * SpecWeave Configuration Types
+ *
+ * Defines the structure for .specweave/config.json
+ *
+ * @module core/config/types
+ */
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    version: '2.0',
+    repository: {
+        provider: 'local'
+    },
+    issueTracker: {
+        provider: 'none'
+    },
+    sync: {
+        enabled: false,
+        direction: 'bidirectional',
+        autoSync: false,
+        includeStatus: true,
+        autoApplyLabels: true
+    },
+    permissions: {
+        canCreate: true,
+        canUpdate: true,
+        canUpdateStatus: true
+    }
+};
+//# sourceMappingURL=types.js.map

package/dist/src/core/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/config/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8NH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,OAAO,EAAE,KAAK;IACd,UAAU,EAAE;QACV,QAAQ,EAAE,OAAO;KAClB;IACD,YAAY,EAAE;QACZ,QAAQ,EAAE,MAAM;KACjB;IACD,IAAI,EAAE;QACJ,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;KACtB;IACD,WAAW,EAAE;QACX,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;QACf,eAAe,EAAE,IAAI;KACtB;CACF,CAAC"}

package/dist/src/core/progress/cancelation-handler.d.ts

@@ -0,0 +1,79 @@
+/**
+ * CancelationHandler - Graceful Ctrl+C (SIGINT) handling with state persistence
+ *
+ * Features:
+ * - Single Ctrl+C: Save state and exit gracefully
+ * - Double Ctrl+C (within 2s): Force exit immediately
+ * - Polling mechanism for cooperative cancelation
+ * - State persistence to resume later
+ *
+ * @module core/progress/cancelation-handler
+ */
+import type { Logger } from '../../utils/logger.js';
+/**
+ * Cancelation handler options
+ */
+export interface CancelationOptions {
+    /** State save callback - called when Ctrl+C is pressed */
+    onSaveState?: () => Promise<void>;
+    /** Logger instance */
+    logger?: Logger;
+    /** Force exit timeout in milliseconds (default: 2000ms) */
+    forceExitTimeout?: number;
+}
+/**
+ * CancelationHandler - Handles SIGINT gracefully with double Ctrl+C force exit
+ *
+ * @example
+ * ```typescript
+ * const handler = new CancelationHandler({
+ *   onSaveState: async () => {
+ *     await saveImportState();
+ *   }
+ * });
+ *
+ * handler.register();
+ *
+ * // In import loop
+ * for (const project of projects) {
+ *   if (handler.shouldCancel()) {
+ *     break;
+ *   }
+ *   await importProject(project);
+ * }
+ *
+ * handler.unregister();
+ * ```
+ */
+export declare class CancelationHandler {
+    private logger;
+    private onSaveState?;
+    private forceExitTimeout;
+    private cancelRequested;
+    private firstCtrlCTime;
+    private sigintHandler;
+    constructor(options?: CancelationOptions);
+    /**
+     * Register SIGINT listener
+     */
+    register(): void;
+    /**
+     * Unregister SIGINT listener
+     */
+    unregister(): void;
+    /**
+     * Check if cancelation was requested (polling mechanism)
+     *
+     * @returns true if Ctrl+C was pressed
+     */
+    shouldCancel(): boolean;
+    /**
+     * Handle SIGINT signal (Ctrl+C)
+     */
+    private handleSigint;
+    /**
+     * Reset cancelation state (useful for testing)
+     */
+    reset(): void;
+}
+//# sourceMappingURL=cancelation-handler.d.ts.map

package/dist/src/core/progress/cancelation-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancelation-handler.d.ts","sourceRoot":"","sources":["../../../../src/core/progress/cancelation-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAC,CAAsB;IAC1C,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,aAAa,CAA6B;gBAEtC,OAAO,GAAE,kBAAuB;IAM5C;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;;;OAIG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;YACW,YAAY;IAiC1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/src/core/progress/cancelation-handler.js

@@ -0,0 +1,111 @@
+/**
+ * CancelationHandler - Graceful Ctrl+C (SIGINT) handling with state persistence
+ *
+ * Features:
+ * - Single Ctrl+C: Save state and exit gracefully
+ * - Double Ctrl+C (within 2s): Force exit immediately
+ * - Polling mechanism for cooperative cancelation
+ * - State persistence to resume later
+ *
+ * @module core/progress/cancelation-handler
+ */
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * CancelationHandler - Handles SIGINT gracefully with double Ctrl+C force exit
+ *
+ * @example
+ * ```typescript
+ * const handler = new CancelationHandler({
+ *   onSaveState: async () => {
+ *     await saveImportState();
+ *   }
+ * });
+ *
+ * handler.register();
+ *
+ * // In import loop
+ * for (const project of projects) {
+ *   if (handler.shouldCancel()) {
+ *     break;
+ *   }
+ *   await importProject(project);
+ * }
+ *
+ * handler.unregister();
+ * ```
+ */
+export class CancelationHandler {
+    constructor(options = {}) {
+        this.cancelRequested = false;
+        this.firstCtrlCTime = null;
+        this.sigintHandler = null;
+        this.logger = options.logger ?? consoleLogger;
+        this.onSaveState = options.onSaveState;
+        this.forceExitTimeout = options.forceExitTimeout ?? 2000;
+    }
+    /**
+     * Register SIGINT listener
+     */
+    register() {
+        this.sigintHandler = () => {
+            void this.handleSigint();
+        };
+        process.on('SIGINT', this.sigintHandler);
+    }
+    /**
+     * Unregister SIGINT listener
+     */
+    unregister() {
+        if (this.sigintHandler) {
+            process.off('SIGINT', this.sigintHandler);
+            this.sigintHandler = null;
+        }
+    }
+    /**
+     * Check if cancelation was requested (polling mechanism)
+     *
+     * @returns true if Ctrl+C was pressed
+     */
+    shouldCancel() {
+        return this.cancelRequested;
+    }
+    /**
+     * Handle SIGINT signal (Ctrl+C)
+     */
+    async handleSigint() {
+        const now = Date.now();
+        // Double Ctrl+C detection
+        if (this.firstCtrlCTime !== null) {
+            const elapsed = now - this.firstCtrlCTime;
+            if (elapsed < this.forceExitTimeout) {
+                // Force exit on double Ctrl+C
+                this.logger.warn('\n⚠️  Forced exit (progress may be lost)');
+                process.exit(1);
+            }
+        }
+        // First Ctrl+C
+        this.firstCtrlCTime = now;
+        this.cancelRequested = true;
+        this.logger.log('\n⏸️  Cancelation requested. Saving progress...');
+        try {
+            // Save state if callback provided
+            if (this.onSaveState) {
+                await this.onSaveState();
+            }
+            this.logger.log('✅ Progress saved. Run with --resume to continue.');
+            process.exit(0);
+        }
+        catch (error) {
+            this.logger.error('❌ Failed to save progress:', error);
+            process.exit(1);
+        }
+    }
+    /**
+     * Reset cancelation state (useful for testing)
+     */
+    reset() {
+        this.cancelRequested = false;
+        this.firstCtrlCTime = null;
+    }
+}
+//# sourceMappingURL=cancelation-handler.js.map

package/dist/src/core/progress/cancelation-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancelation-handler.js","sourceRoot":"","sources":["../../../../src/core/progress/cancelation-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AActD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,kBAAkB;IAS7B,YAAY,UAA8B,EAAE;QAJpC,oBAAe,GAAY,KAAK,CAAC;QACjC,mBAAc,GAAkB,IAAI,CAAC;QACrC,kBAAa,GAAwB,IAAI,CAAC;QAGhD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,CAAC,aAAa,GAAG,GAAG,EAAE;YACxB,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;QAC3B,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,0BAA0B;QAC1B,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC;YAC1C,IAAI,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACpC,8BAA8B;gBAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;gBAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,eAAe;QACf,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC;QAC1B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAE5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAEnE,IAAI,CAAC;YACH,kCAAkC;YAClC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3B,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;IAC7B,CAAC;CACF"}

package/dist/src/core/progress/import-state.d.ts

@@ -0,0 +1,71 @@
+/**
+ * ImportState - State persistence for resumable imports
+ *
+ * Features:
+ * - Save/load import progress
+ * - 24-hour TTL for stale state cleanup
+ * - Error tracking for retry logic
+ *
+ * @module core/progress/import-state
+ */
+/**
+ * Import error record
+ */
+export interface ImportError {
+    /** Item identifier (e.g., project key) */
+    id: string;
+    /** Error message */
+    error: string;
+    /** Timestamp when error occurred */
+    timestamp: number;
+}
+/**
+ * Import state structure
+ */
+export interface ImportState {
+    /** Total number of items to import */
+    total: number;
+    /** Number of items completed (success + failed) */
+    completed: number;
+    /** Number of successful imports */
+    succeeded: number;
+    /** Number of failed imports */
+    failed: number;
+    /** Array of import errors */
+    errors: ImportError[];
+    /** Timestamp when state was saved */
+    timestamp: number;
+    /** Whether import was canceled by user */
+    canceled: boolean;
+    /** Optional: Last successfully processed item ID */
+    lastProcessedId?: string;
+}
+/**
+ * Save import state to disk
+ *
+ * @param state Import state to save
+ * @param projectRoot Project root directory
+ */
+export declare function saveImportState(state: ImportState, projectRoot?: string): Promise<void>;
+/**
+ * Load import state from disk with TTL validation
+ *
+ * @param projectRoot Project root directory
+ * @param ttlMs Time-to-live in milliseconds (default: 24 hours)
+ * @returns Import state if valid, null if expired or missing
+ */
+export declare function loadImportState(projectRoot?: string, ttlMs?: number): Promise<ImportState | null>;
+/**
+ * Delete import state file
+ *
+ * @param projectRoot Project root directory
+ */
+export declare function deleteImportState(projectRoot?: string): Promise<void>;
+/**
+ * Check if import state exists (without loading)
+ *
+ * @param projectRoot Project root directory
+ * @returns true if state file exists
+ */
+export declare function hasImportState(projectRoot?: string): boolean;
+//# sourceMappingURL=import-state.d.ts.map

package/dist/src/core/progress/import-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-state.d.ts","sourceRoot":"","sources":["../../../../src/core/progress/import-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAYD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,WAAW,EAClB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,WAAW,GAAE,MAAsB,EACnC,KAAK,GAAE,MAA4B,GAClC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA0B7B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAG3E"}

package/dist/src/core/progress/import-state.js

@@ -0,0 +1,96 @@
+/**
+ * ImportState - State persistence for resumable imports
+ *
+ * Features:
+ * - Save/load import progress
+ * - 24-hour TTL for stale state cleanup
+ * - Error tracking for retry logic
+ *
+ * @module core/progress/import-state
+ */
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { existsSync } from 'fs';
+import { mkdirpSync } from '../../utils/fs-native.js';
+/**
+ * Get import state file path
+ *
+ * @param projectRoot Project root directory
+ * @returns Path to import-state.json
+ */
+function getStateFilePath(projectRoot = process.cwd()) {
+    return join(projectRoot, '.specweave', 'cache', 'import-state.json');
+}
+/**
+ * Save import state to disk
+ *
+ * @param state Import state to save
+ * @param projectRoot Project root directory
+ */
+export async function saveImportState(state, projectRoot = process.cwd()) {
+    const stateFilePath = getStateFilePath(projectRoot);
+    const cacheDir = join(projectRoot, '.specweave', 'cache');
+    // Ensure cache directory exists
+    mkdirpSync(cacheDir);
+    // Add timestamp
+    const stateWithTimestamp = {
+        ...state,
+        timestamp: Date.now(),
+    };
+    // Write to file
+    await fs.writeFile(stateFilePath, JSON.stringify(stateWithTimestamp, null, 2), 'utf-8');
+}
+/**
+ * Load import state from disk with TTL validation
+ *
+ * @param projectRoot Project root directory
+ * @param ttlMs Time-to-live in milliseconds (default: 24 hours)
+ * @returns Import state if valid, null if expired or missing
+ */
+export async function loadImportState(projectRoot = process.cwd(), ttlMs = 24 * 60 * 60 * 1000 // 24 hours
+) {
+    const stateFilePath = getStateFilePath(projectRoot);
+    // Check if file exists
+    if (!existsSync(stateFilePath)) {
+        return null;
+    }
+    try {
+        // Read and parse file
+        const content = await fs.readFile(stateFilePath, 'utf-8');
+        const state = JSON.parse(content);
+        // Validate TTL
+        const age = Date.now() - state.timestamp;
+        if (age > ttlMs) {
+            // State is expired, delete it
+            await deleteImportState(projectRoot);
+            return null;
+        }
+        return state;
+    }
+    catch (error) {
+        // Invalid JSON or read error
+        return null;
+    }
+}
+/**
+ * Delete import state file
+ *
+ * @param projectRoot Project root directory
+ */
+export async function deleteImportState(projectRoot = process.cwd()) {
+    const stateFilePath = getStateFilePath(projectRoot);
+    if (existsSync(stateFilePath)) {
+        await fs.unlink(stateFilePath);
+    }
+}
+/**
+ * Check if import state exists (without loading)
+ *
+ * @param projectRoot Project root directory
+ * @returns true if state file exists
+ */
+export function hasImportState(projectRoot = process.cwd()) {
+    const stateFilePath = getStateFilePath(projectRoot);
+    return existsSync(stateFilePath);
+}
+//# sourceMappingURL=import-state.js.map

package/dist/src/core/progress/import-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-state.js","sourceRoot":"","sources":["../../../../src/core/progress/import-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAoCtD;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IAC3D,OAAO,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAkB,EAClB,cAAsB,OAAO,CAAC,GAAG,EAAE;IAEnC,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAE1D,gCAAgC;IAChC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAErB,gBAAgB;IAChB,MAAM,kBAAkB,GAAgB;QACtC,GAAG,KAAK;QACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,gBAAgB;IAChB,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,cAAsB,OAAO,CAAC,GAAG,EAAE,EACnC,QAAgB,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW;;IAE/C,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEpD,uBAAuB;IACvB,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,sBAAsB;QACtB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAgB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE/C,eAAe;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;QACzC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;YAChB,8BAA8B;YAC9B,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,6BAA6B;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IACzE,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEpD,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IAChE,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACpD,OAAO,UAAU,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC"}