claude-code-workflow 6.3.53 → 7.0.0

package/ccw/dist/core/services/session-state-service.d.ts

@@ -0,0 +1,148 @@
+/**
+ * SessionStateService - Unified session state management
+ *
+ * Provides centralized session state persistence across CLI hooks and API routes.
+ * Supports both legacy global path (~/.claude/.ccw-sessions/) and session-scoped
+ * paths (.workflow/sessions/{sessionId}/) for workflow integration.
+ */
+/**
+ * Session state interface
+ */
+export interface SessionState {
+    /** ISO timestamp of first session load */
+    firstLoad: string;
+    /** Number of times session has been loaded */
+    loadCount: number;
+    /** Last prompt text (optional) */
+    lastPrompt?: string;
+    /** Active mode for the session (optional) */
+    activeMode?: 'analysis' | 'write' | 'review' | 'auto';
+}
+/**
+ * Storage type for session state
+ */
+export type SessionStorageType = 'global' | 'session-scoped';
+/**
+ * Options for session state operations
+ */
+export interface SessionStateOptions {
+    /** Storage type: 'global' uses ~/.claude/.ccw-sessions/, 'session-scoped' uses .workflow/sessions/{sessionId}/ */
+    storageType?: SessionStorageType;
+    /** Project root path (required for session-scoped storage) */
+    projectPath?: string;
+}
+/**
+ * Validates that a session ID is safe to use in file paths.
+ * Session IDs should be alphanumeric with optional hyphens and underscores.
+ * This prevents path traversal attacks (e.g., "../../../etc").
+ *
+ * @param sessionId - The session ID to validate
+ * @returns true if the session ID is safe, false otherwise
+ */
+export declare function validateSessionId(sessionId: string): boolean;
+/**
+ * Get session state file path
+ *
+ * Supports two storage modes:
+ * - 'global': ~/.claude/.ccw-sessions/session-{sessionId}.json (default)
+ * - 'session-scoped': {projectPath}/.workflow/sessions/{sessionId}/state.json
+ *
+ * @param sessionId - The session ID
+ * @param options - Storage options
+ * @returns Full path to the session state file
+ */
+export declare function getSessionStatePath(sessionId: string, options?: SessionStateOptions): string;
+/**
+ * Load session state from file
+ *
+ * @param sessionId - The session ID
+ * @param options - Storage options
+ * @returns SessionState if exists and valid, null otherwise
+ */
+export declare function loadSessionState(sessionId: string, options?: SessionStateOptions): SessionState | null;
+/**
+ * Save session state to file
+ *
+ * @param sessionId - The session ID
+ * @param state - The session state to save
+ * @param options - Storage options
+ */
+export declare function saveSessionState(sessionId: string, state: SessionState, options?: SessionStateOptions): void;
+/**
+ * Clear session state (for session-end cleanup)
+ *
+ * @param sessionId - The session ID
+ * @param options - Storage options
+ * @returns true if state was cleared, false if it didn't exist
+ */
+export declare function clearSessionState(sessionId: string, options?: SessionStateOptions): boolean;
+/**
+ * Update session state with new values
+ *
+ * This is a convenience function that loads existing state, merges with updates,
+ * and saves the result.
+ *
+ * @param sessionId - The session ID
+ * @param updates - Partial state to merge
+ * @param options - Storage options
+ * @returns The updated state
+ */
+export declare function updateSessionState(sessionId: string, updates: Partial<SessionState>, options?: SessionStateOptions): SessionState;
+/**
+ * Increment the load count for a session
+ *
+ * This is a convenience function for the common pattern of tracking
+ * how many times a session has been loaded.
+ *
+ * @param sessionId - The session ID
+ * @param prompt - Optional prompt to record as lastPrompt
+ * @param options - Storage options
+ * @returns Object with isFirstPrompt flag and updated state
+ */
+export declare function incrementSessionLoad(sessionId: string, prompt?: string, options?: SessionStateOptions): {
+    isFirstPrompt: boolean;
+    state: SessionState;
+};
+/**
+ * SessionStateService class for object-oriented usage
+ */
+export declare class SessionStateService {
+    private options?;
+    constructor(options?: SessionStateOptions);
+    /**
+     * Get session state file path
+     */
+    getStatePath(sessionId: string): string;
+    /**
+     * Load session state
+     */
+    load(sessionId: string): SessionState | null;
+    /**
+     * Save session state
+     */
+    save(sessionId: string, state: SessionState): void;
+    /**
+     * Clear session state
+     */
+    clear(sessionId: string): boolean;
+    /**
+     * Update session state
+     */
+    update(sessionId: string, updates: Partial<SessionState>): SessionState;
+    /**
+     * Increment load count
+     */
+    incrementLoad(sessionId: string, prompt?: string): {
+        isFirstPrompt: boolean;
+        state: SessionState;
+    };
+    /**
+     * Check if session is first load
+     */
+    isFirstLoad(sessionId: string): boolean;
+    /**
+     * Get load count for session
+     */
+    getLoadCount(sessionId: string): number;
+}
+//# sourceMappingURL=session-state-service.d.ts.map

package/ccw/dist/core/services/session-state-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state-service.d.ts","sourceRoot":"","sources":["../../../src/core/services/session-state-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,gBAAgB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kHAAkH;IAClH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAS5D;AAUD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAwB5F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,GAAG,IAAI,CAuBtG;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAc5G;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CA6B3F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAad;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAkBjD;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAsB;gBAE1B,OAAO,CAAC,EAAE,mBAAmB;IAIzC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIvC;;OAEG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAI5C;;OAEG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAIlD;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY;IAIvE;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG;QAAE,aAAa,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE;IAIlG;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAIxC"}

package/ccw/dist/core/services/session-state-service.js

@@ -0,0 +1,259 @@
+/**
+ * SessionStateService - Unified session state management
+ *
+ * Provides centralized session state persistence across CLI hooks and API routes.
+ * Supports both legacy global path (~/.claude/.ccw-sessions/) and session-scoped
+ * paths (.workflow/sessions/{sessionId}/) for workflow integration.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync, rmSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+/**
+ * Validates that a session ID is safe to use in file paths.
+ * Session IDs should be alphanumeric with optional hyphens and underscores.
+ * This prevents path traversal attacks (e.g., "../../../etc").
+ *
+ * @param sessionId - The session ID to validate
+ * @returns true if the session ID is safe, false otherwise
+ */
+export function validateSessionId(sessionId) {
+    if (!sessionId || typeof sessionId !== 'string') {
+        return false;
+    }
+    // Allow alphanumeric, hyphens, and underscores only
+    // Must be 1-256 characters (reasonable length limit)
+    // Must not start with a dot (hidden files) or hyphen
+    const SAFE_SESSION_ID_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,255}$/;
+    return SAFE_SESSION_ID_PATTERN.test(sessionId);
+}
+/**
+ * Get the default global session state directory
+ * Uses ~/.claude/.ccw-sessions/ for reliable persistence across sessions
+ */
+function getGlobalStateDir() {
+    return join(homedir(), '.claude', '.ccw-sessions');
+}
+/**
+ * Get session state file path
+ *
+ * Supports two storage modes:
+ * - 'global': ~/.claude/.ccw-sessions/session-{sessionId}.json (default)
+ * - 'session-scoped': {projectPath}/.workflow/sessions/{sessionId}/state.json
+ *
+ * @param sessionId - The session ID
+ * @param options - Storage options
+ * @returns Full path to the session state file
+ */
+export function getSessionStatePath(sessionId, options) {
+    if (!validateSessionId(sessionId)) {
+        throw new Error(`Invalid session ID: ${sessionId}`);
+    }
+    const storageType = options?.storageType ?? 'global';
+    if (storageType === 'session-scoped') {
+        if (!options?.projectPath) {
+            throw new Error('projectPath is required for session-scoped storage');
+        }
+        const stateDir = join(options.projectPath, '.workflow', 'sessions', sessionId);
+        if (!existsSync(stateDir)) {
+            mkdirSync(stateDir, { recursive: true });
+        }
+        return join(stateDir, 'state.json');
+    }
+    // Global storage (default)
+    const stateDir = getGlobalStateDir();
+    if (!existsSync(stateDir)) {
+        mkdirSync(stateDir, { recursive: true });
+    }
+    return join(stateDir, `session-${sessionId}.json`);
+}
+/**
+ * Load session state from file
+ *
+ * @param sessionId - The session ID
+ * @param options - Storage options
+ * @returns SessionState if exists and valid, null otherwise
+ */
+export function loadSessionState(sessionId, options) {
+    if (!validateSessionId(sessionId)) {
+        return null;
+    }
+    try {
+        const stateFile = getSessionStatePath(sessionId, options);
+        if (!existsSync(stateFile)) {
+            return null;
+        }
+        const content = readFileSync(stateFile, 'utf-8');
+        const parsed = JSON.parse(content);
+        // Validate required fields
+        if (typeof parsed.firstLoad !== 'string' || typeof parsed.loadCount !== 'number') {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save session state to file
+ *
+ * @param sessionId - The session ID
+ * @param state - The session state to save
+ * @param options - Storage options
+ */
+export function saveSessionState(sessionId, state, options) {
+    if (!validateSessionId(sessionId)) {
+        throw new Error(`Invalid session ID: ${sessionId}`);
+    }
+    const stateFile = getSessionStatePath(sessionId, options);
+    // Ensure parent directory exists
+    const stateDir = dirname(stateFile);
+    if (!existsSync(stateDir)) {
+        mkdirSync(stateDir, { recursive: true });
+    }
+    writeFileSync(stateFile, JSON.stringify(state, null, 2), 'utf-8');
+}
+/**
+ * Clear session state (for session-end cleanup)
+ *
+ * @param sessionId - The session ID
+ * @param options - Storage options
+ * @returns true if state was cleared, false if it didn't exist
+ */
+export function clearSessionState(sessionId, options) {
+    if (!validateSessionId(sessionId)) {
+        return false;
+    }
+    try {
+        const stateFile = getSessionStatePath(sessionId, options);
+        if (!existsSync(stateFile)) {
+            return false;
+        }
+        unlinkSync(stateFile);
+        // For session-scoped storage, also remove the session directory if empty
+        if (options?.storageType === 'session-scoped' && options.projectPath) {
+            const sessionDir = join(options.projectPath, '.workflow', 'sessions', sessionId);
+            try {
+                // Try to remove the directory (will fail if not empty)
+                rmSync(sessionDir, { recursive: false, force: true });
+            }
+            catch {
+                // Directory not empty or other error - ignore
+            }
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Update session state with new values
+ *
+ * This is a convenience function that loads existing state, merges with updates,
+ * and saves the result.
+ *
+ * @param sessionId - The session ID
+ * @param updates - Partial state to merge
+ * @param options - Storage options
+ * @returns The updated state
+ */
+export function updateSessionState(sessionId, updates, options) {
+    const existing = loadSessionState(sessionId, options);
+    const newState = existing
+        ? { ...existing, ...updates }
+        : {
+            firstLoad: new Date().toISOString(),
+            loadCount: 1,
+            ...updates
+        };
+    saveSessionState(sessionId, newState, options);
+    return newState;
+}
+/**
+ * Increment the load count for a session
+ *
+ * This is a convenience function for the common pattern of tracking
+ * how many times a session has been loaded.
+ *
+ * @param sessionId - The session ID
+ * @param prompt - Optional prompt to record as lastPrompt
+ * @param options - Storage options
+ * @returns Object with isFirstPrompt flag and updated state
+ */
+export function incrementSessionLoad(sessionId, prompt, options) {
+    const existing = loadSessionState(sessionId, options);
+    const isFirstPrompt = !existing;
+    const state = isFirstPrompt
+        ? {
+            firstLoad: new Date().toISOString(),
+            loadCount: 1,
+            lastPrompt: prompt
+        }
+        : {
+            ...existing,
+            loadCount: existing.loadCount + 1,
+            ...(prompt !== undefined && { lastPrompt: prompt })
+        };
+    saveSessionState(sessionId, state, options);
+    return { isFirstPrompt, state };
+}
+/**
+ * SessionStateService class for object-oriented usage
+ */
+export class SessionStateService {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Get session state file path
+     */
+    getStatePath(sessionId) {
+        return getSessionStatePath(sessionId, this.options);
+    }
+    /**
+     * Load session state
+     */
+    load(sessionId) {
+        return loadSessionState(sessionId, this.options);
+    }
+    /**
+     * Save session state
+     */
+    save(sessionId, state) {
+        saveSessionState(sessionId, state, this.options);
+    }
+    /**
+     * Clear session state
+     */
+    clear(sessionId) {
+        return clearSessionState(sessionId, this.options);
+    }
+    /**
+     * Update session state
+     */
+    update(sessionId, updates) {
+        return updateSessionState(sessionId, updates, this.options);
+    }
+    /**
+     * Increment load count
+     */
+    incrementLoad(sessionId, prompt) {
+        return incrementSessionLoad(sessionId, prompt, this.options);
+    }
+    /**
+     * Check if session is first load
+     */
+    isFirstLoad(sessionId) {
+        return this.load(sessionId) === null;
+    }
+    /**
+     * Get load count for session
+     */
+    getLoadCount(sessionId) {
+        const state = this.load(sessionId);
+        return state?.loadCount ?? 0;
+    }
+}
+//# sourceMappingURL=session-state-service.js.map

package/ccw/dist/core/services/session-state-service.js.map

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

package/ccw/dist/core/services/version-checker.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Version Checker Service
+ * Checks application version against GitHub latest release
+ * Uses caching to avoid excessive API calls
+ */
+/**
+ * Version check result
+ */
+export interface VersionCheckResult {
+    currentVersion: string;
+    latestVersion: string;
+    updateAvailable: boolean;
+    changelog?: string;
+}
+/**
+ * Version Checker Service
+ * Checks for updates by comparing local version with GitHub releases
+ */
+export declare class VersionChecker {
+    private cache;
+    private readonly CACHE_TTL;
+    private readonly GITHUB_OWNER;
+    private readonly GITHUB_REPO;
+    private readonly GITHUB_API_URL;
+    /**
+     * Check for updates
+     * Returns cached result if within TTL
+     */
+    checkVersion(): Promise<VersionCheckResult>;
+    /**
+     * Get local version from package.json
+     * Searches in monorepo root and ccw package directories
+     */
+    private getLocalVersion;
+    /**
+     * Fetch latest version from GitHub Releases API
+     * Returns cached data if available even if expired, on error
+     */
+    private getLatestVersionFromGitHub;
+    /**
+     * Compare two semantic version strings
+     * Returns: -1 if v1 < v2, 0 if v1 == v2, 1 if v1 > v2
+     */
+    private compareVersions;
+    /**
+     * Clear the version cache (useful for testing or manual refresh)
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=version-checker.d.ts.map

package/ccw/dist/core/services/version-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-checker.d.ts","sourceRoot":"","sources":["../../../src/core/services/version-checker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8D;IAE7F;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAqBjD;;;OAGG;YACW,eAAe;IA0B7B;;;OAGG;YACW,0BAA0B;IAiDxC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/ccw/dist/core/services/version-checker.js

@@ -0,0 +1,141 @@
+/**
+ * Version Checker Service
+ * Checks application version against GitHub latest release
+ * Uses caching to avoid excessive API calls
+ */
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { existsSync } from 'fs';
+/**
+ * Version Checker Service
+ * Checks for updates by comparing local version with GitHub releases
+ */
+export class VersionChecker {
+    cache = null;
+    CACHE_TTL = 5 * 60 * 1000; // 5 minutes
+    GITHUB_OWNER = 'dyw0830';
+    GITHUB_REPO = 'ccw';
+    GITHUB_API_URL = `https://api.github.com/repos/dyw0830/ccw/releases/latest`;
+    /**
+     * Check for updates
+     * Returns cached result if within TTL
+     */
+    async checkVersion() {
+        // Check cache first
+        if (this.cache && Date.now() - this.cache.timestamp < this.CACHE_TTL) {
+            return this.cache.data;
+        }
+        // Get versions
+        const currentVersion = await this.getLocalVersion();
+        const latestVersion = await this.getLatestVersionFromGitHub();
+        const result = {
+            currentVersion,
+            latestVersion,
+            updateAvailable: this.compareVersions(currentVersion, latestVersion) < 0
+        };
+        // Cache result
+        this.cache = { data: result, timestamp: Date.now() };
+        return result;
+    }
+    /**
+     * Get local version from package.json
+     * Searches in monorepo root and ccw package directories
+     */
+    async getLocalVersion() {
+        // Try to find package.json with actual CCW version
+        const possiblePaths = [
+            join(process.cwd(), 'package.json'), // Current directory
+            join(process.cwd(), 'ccw', 'package.json'), // ccw subdirectory
+            join(__dirname, '..', '..', '..', '..', 'package.json'), // From src/core/services -> monorepo root
+        ];
+        for (const pkgPath of possiblePaths) {
+            if (existsSync(pkgPath)) {
+                try {
+                    const content = await readFile(pkgPath, 'utf-8');
+                    const pkg = JSON.parse(content);
+                    if (pkg.version && typeof pkg.version === 'string') {
+                        return pkg.version;
+                    }
+                }
+                catch {
+                    // Continue to next path
+                }
+            }
+        }
+        // Fallback to a default version if no package.json found
+        return '0.0.0';
+    }
+    /**
+     * Fetch latest version from GitHub Releases API
+     * Returns cached data if available even if expired, on error
+     */
+    async getLatestVersionFromGitHub() {
+        try {
+            // Create abort controller for timeout
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 10000); // 10 second timeout
+            const response = await fetch(this.GITHUB_API_URL, {
+                headers: {
+                    'Accept': 'application/vnd.github.v3+json',
+                    'User-Agent': 'CCW-VersionChecker', // REQUIRED by GitHub API
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+            }
+            // Validate response structure
+            const data = await response.json();
+            if (!data || typeof data !== 'object') {
+                throw new Error('Invalid GitHub API response format');
+            }
+            if (!data.tag_name || typeof data.tag_name !== 'string') {
+                throw new Error('Invalid tag_name in GitHub response');
+            }
+            // Extract version from tag_name (remove 'v' prefix if present)
+            const tagName = data.tag_name;
+            return tagName.startsWith('v') ? tagName.substring(1) : tagName;
+        }
+        catch (error) {
+            // Handle abort (timeout)
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error('GitHub API request timeout (10s)');
+            }
+            // Return cached data if available, even if expired
+            if (this.cache) {
+                console.warn(`[VersionChecker] Using cached version due to error: ${error.message}`);
+                return this.cache.data.latestVersion;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Compare two semantic version strings
+     * Returns: -1 if v1 < v2, 0 if v1 == v2, 1 if v1 > v2
+     */
+    compareVersions(v1, v2) {
+        // Parse semver versions (major.minor.patch)
+        const parts1 = v1.split('.').map((p) => (parseInt(p, 10) || 0));
+        const parts2 = v2.split('.').map((p) => (parseInt(p, 10) || 0));
+        // Ensure we have at least 3 parts for comparison
+        while (parts1.length < 3)
+            parts1.push(0);
+        while (parts2.length < 3)
+            parts2.push(0);
+        for (let i = 0; i < 3; i++) {
+            if (parts1[i] < parts2[i])
+                return -1;
+            if (parts1[i] > parts2[i])
+                return 1;
+        }
+        return 0;
+    }
+    /**
+     * Clear the version cache (useful for testing or manual refresh)
+     */
+    clearCache() {
+        this.cache = null;
+    }
+}
+//# sourceMappingURL=version-checker.js.map

package/ccw/dist/core/services/version-checker.js.map

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