claude-code-workflow 6.3.53 → 7.0.0

package/ccw/dist/types/remote-notification.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Supported notification platforms
+ */
+export type NotificationPlatform = 'discord' | 'telegram' | 'feishu' | 'dingtalk' | 'wecom' | 'email' | 'webhook';
+/**
+ * Event types that can trigger notifications
+ */
+export type NotificationEventType = 'ask-user-question' | 'session-start' | 'session-end' | 'task-completed' | 'task-failed';
+/**
+ * Discord platform configuration
+ */
+export interface DiscordConfig {
+    /** Whether Discord notifications are enabled */
+    enabled: boolean;
+    /** Discord webhook URL */
+    webhookUrl: string;
+    /** Optional custom username for the webhook */
+    username?: string;
+    /** Optional avatar URL for the webhook */
+    avatarUrl?: string;
+}
+/**
+ * Telegram platform configuration
+ */
+export interface TelegramConfig {
+    /** Whether Telegram notifications are enabled */
+    enabled: boolean;
+    /** Telegram bot token */
+    botToken: string;
+    /** Telegram chat ID (user or group) */
+    chatId: string;
+    /** Optional parse mode (HTML, Markdown, MarkdownV2) */
+    parseMode?: 'HTML' | 'Markdown' | 'MarkdownV2';
+}
+/**
+ * Feishu (Lark) platform configuration
+ */
+export interface FeishuConfig {
+    /** Whether Feishu notifications are enabled */
+    enabled: boolean;
+    /** Feishu webhook URL */
+    webhookUrl: string;
+    /** Use rich card format (default: true) */
+    useCard?: boolean;
+    /** Custom title for notifications */
+    title?: string;
+}
+/**
+ * DingTalk platform configuration
+ */
+export interface DingTalkConfig {
+    /** Whether DingTalk notifications are enabled */
+    enabled: boolean;
+    /** DingTalk webhook URL */
+    webhookUrl: string;
+    /** Optional keywords for security check */
+    keywords?: string[];
+}
+/**
+ * WeCom (WeChat Work) platform configuration
+ */
+export interface WeComConfig {
+    /** Whether WeCom notifications are enabled */
+    enabled: boolean;
+    /** WeCom webhook URL */
+    webhookUrl: string;
+    /** Mentioned user IDs (@all for all members) */
+    mentionedList?: string[];
+}
+/**
+ * Email SMTP platform configuration
+ */
+export interface EmailConfig {
+    /** Whether Email notifications are enabled */
+    enabled: boolean;
+    /** SMTP server host */
+    host: string;
+    /** SMTP server port */
+    port: number;
+    /** Use secure connection (TLS) */
+    secure?: boolean;
+    /** SMTP username */
+    username: string;
+    /** SMTP password */
+    password: string;
+    /** Sender email address */
+    from: string;
+    /** Recipient email addresses */
+    to: string[];
+}
+/**
+ * Generic Webhook platform configuration
+ */
+export interface WebhookConfig {
+    /** Whether webhook notifications are enabled */
+    enabled: boolean;
+    /** Webhook URL */
+    url: string;
+    /** HTTP method (POST or PUT) */
+    method: 'POST' | 'PUT';
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Event configuration - maps events to platforms
+ */
+export interface EventConfig {
+    /** Event type */
+    event: NotificationEventType;
+    /** Platforms to notify for this event */
+    platforms: NotificationPlatform[];
+    /** Whether this event's notifications are enabled */
+    enabled: boolean;
+}
+/**
+ * Full remote notification configuration
+ */
+export interface RemoteNotificationConfig {
+    /** Master switch for all remote notifications */
+    enabled: boolean;
+    /** Platform-specific configurations */
+    platforms: {
+        discord?: DiscordConfig;
+        telegram?: TelegramConfig;
+        feishu?: FeishuConfig;
+        dingtalk?: DingTalkConfig;
+        wecom?: WeComConfig;
+        email?: EmailConfig;
+        webhook?: WebhookConfig;
+    };
+    /** Event-to-platform mappings */
+    events: EventConfig[];
+    /** Global timeout for all notification requests (ms) */
+    timeout: number;
+}
+/**
+ * Context passed when sending a notification
+ */
+export interface NotificationContext {
+    /** Event type that triggered the notification */
+    eventType: NotificationEventType;
+    /** Session ID if applicable */
+    sessionId?: string;
+    /** Question text for ask-user-question events */
+    questionText?: string;
+    /** Task description for task events */
+    taskDescription?: string;
+    /** Error message for task-failed events */
+    errorMessage?: string;
+    /** Timestamp of the event */
+    timestamp: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of a single platform notification attempt
+ */
+export interface PlatformNotificationResult {
+    /** Platform that was notified */
+    platform: NotificationPlatform;
+    /** Whether the notification succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Response time in milliseconds */
+    responseTime?: number;
+}
+/**
+ * Result of sending notifications to all configured platforms
+ */
+export interface NotificationDispatchResult {
+    /** Whether at least one notification succeeded */
+    success: boolean;
+    /** Results for each platform */
+    results: PlatformNotificationResult[];
+    /** Total dispatch time in milliseconds */
+    totalTime: number;
+}
+/**
+ * Test notification request
+ */
+export interface TestNotificationRequest {
+    /** Platform to test */
+    platform: NotificationPlatform;
+    /** Platform configuration to test (temporary, not saved) */
+    config: DiscordConfig | TelegramConfig | WebhookConfig;
+}
+/**
+ * Test notification result
+ */
+export interface TestNotificationResult {
+    /** Whether the test succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Response time in milliseconds */
+    responseTime?: number;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_REMOTE_NOTIFICATION_CONFIG: RemoteNotificationConfig;
+/**
+ * Mask sensitive fields in config for API responses
+ */
+export declare function maskSensitiveConfig(config: RemoteNotificationConfig): RemoteNotificationConfig;
+//# sourceMappingURL=remote-notification.d.ts.map

package/ccw/dist/types/remote-notification.d.ts.map

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

package/ccw/dist/types/remote-notification.js

@@ -0,0 +1,86 @@
+// ========================================
+// Remote Notification Types
+// ========================================
+// Type definitions for remote notification system
+// Supports Discord, Telegram, Feishu, DingTalk, WeCom, Email, and Generic Webhook platforms
+/**
+ * Default configuration values
+ */
+export const DEFAULT_REMOTE_NOTIFICATION_CONFIG = {
+    enabled: false,
+    platforms: {},
+    events: [
+        { event: 'ask-user-question', platforms: ['discord', 'telegram'], enabled: true },
+        { event: 'session-start', platforms: [], enabled: false },
+        { event: 'session-end', platforms: [], enabled: false },
+        { event: 'task-completed', platforms: [], enabled: false },
+        { event: 'task-failed', platforms: ['discord', 'telegram'], enabled: true },
+    ],
+    timeout: 10000, // 10 seconds
+};
+/**
+ * Mask sensitive fields in config for API responses
+ */
+export function maskSensitiveConfig(config) {
+    return {
+        ...config,
+        platforms: {
+            discord: config.platforms.discord ? {
+                ...config.platforms.discord,
+                webhookUrl: maskWebhookUrl(config.platforms.discord.webhookUrl),
+            } : undefined,
+            telegram: config.platforms.telegram ? {
+                ...config.platforms.telegram,
+                botToken: maskToken(config.platforms.telegram.botToken),
+            } : undefined,
+            feishu: config.platforms.feishu ? {
+                ...config.platforms.feishu,
+                webhookUrl: maskWebhookUrl(config.platforms.feishu.webhookUrl),
+            } : undefined,
+            dingtalk: config.platforms.dingtalk ? {
+                ...config.platforms.dingtalk,
+                webhookUrl: maskWebhookUrl(config.platforms.dingtalk.webhookUrl),
+            } : undefined,
+            wecom: config.platforms.wecom ? {
+                ...config.platforms.wecom,
+                webhookUrl: maskWebhookUrl(config.platforms.wecom.webhookUrl),
+            } : undefined,
+            email: config.platforms.email ? {
+                ...config.platforms.email,
+                password: maskToken(config.platforms.email.password),
+            } : undefined,
+            webhook: config.platforms.webhook ? {
+                ...config.platforms.webhook,
+                // Don't mask webhook URL as it's needed for display
+            } : undefined,
+        },
+    };
+}
+/**
+ * Mask webhook URL for display (show only domain and last part)
+ */
+function maskWebhookUrl(url) {
+    if (!url)
+        return '';
+    try {
+        const parsed = new URL(url);
+        const pathParts = parsed.pathname.split('/');
+        const lastPart = pathParts[pathParts.length - 1];
+        if (lastPart && lastPart.length > 8) {
+            return `${parsed.origin}/.../${lastPart.slice(0, 4)}****`;
+        }
+        return `${parsed.origin}/****`;
+    }
+    catch {
+        return '****';
+    }
+}
+/**
+ * Mask bot token for display
+ */
+function maskToken(token) {
+    if (!token || token.length < 10)
+        return '****';
+    return `${token.slice(0, 6)}****${token.slice(-4)}`;
+}
+//# sourceMappingURL=remote-notification.js.map

package/ccw/dist/types/remote-notification.js.map

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

package/ccw/dist/types/util.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Deep partial type - makes all nested properties optional
+ */
+export type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+/**
+ * Make specific keys optional
+ */
+export type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Make specific keys required
+ */
+export type RequiredBy<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+/**
+ * Extract function parameter types
+ */
+export type Parameters<T> = T extends (...args: infer P) => unknown ? P : never;
+/**
+ * Extract function return type
+ */
+export type ReturnType<T> = T extends (...args: unknown[]) => infer R ? R : never;
+/**
+ * Deep merge utility for configuration updates
+ * Recursively merges source into target, preserving nested objects
+ */
+export declare function deepMerge<T extends object>(target: T, source: DeepPartial<T>): T;
+//# sourceMappingURL=util.d.ts.map

package/ccw/dist/types/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/types/util.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACzC;KACG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACnC,GACD,CAAC,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAMlF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EACxC,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,CAAC,CA6BH"}

package/ccw/dist/types/util.js

@@ -0,0 +1,35 @@
+// ========================================
+// Utility Types
+// ========================================
+// Common utility type definitions
+// ========================================
+// Utility Functions
+// ========================================
+/**
+ * Deep merge utility for configuration updates
+ * Recursively merges source into target, preserving nested objects
+ */
+export function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key in source) {
+        if (Object.prototype.hasOwnProperty.call(source, key)) {
+            const sourceValue = source[key];
+            const targetValue = target[key];
+            if (sourceValue !== undefined &&
+                sourceValue !== null &&
+                typeof sourceValue === 'object' &&
+                !Array.isArray(sourceValue) &&
+                targetValue !== undefined &&
+                targetValue !== null &&
+                typeof targetValue === 'object' &&
+                !Array.isArray(targetValue)) {
+                result[key] = deepMerge(targetValue, sourceValue);
+            }
+            else if (sourceValue !== undefined) {
+                result[key] = sourceValue;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=util.js.map

package/ccw/dist/types/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/types/util.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,gBAAgB;AAChB,2CAA2C;AAC3C,kCAAkC;AA+BlC,2CAA2C;AAC3C,oBAAoB;AACpB,2CAA2C;AAE3C;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,MAAS,EACT,MAAsB;IAEtB,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAO,CAAC;IAElC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YACtD,MAAM,WAAW,GAAG,MAAM,CAAC,GAA0B,CAAC,CAAC;YACvD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAyB,CAAC,CAAC;YAEtD,IACE,WAAW,KAAK,SAAS;gBACzB,WAAW,KAAK,IAAI;gBACpB,OAAO,WAAW,KAAK,QAAQ;gBAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;gBAC3B,WAAW,KAAK,SAAS;gBACzB,WAAW,KAAK,IAAI;gBACpB,OAAO,WAAW,KAAK,QAAQ;gBAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B,CAAC;gBACA,MAAkC,CAAC,GAAG,CAAC,GAAG,SAAS,CAClD,WAAqB,EACrB,WAAkC,CACnC,CAAC;YACJ,CAAC;iBAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAkC,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/ccw/dist/utils/dashboard-launcher.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Check if the Dashboard server is running by attempting to connect to its health endpoint.
+ * @returns Promise that resolves to true if server is reachable
+ */
+export declare function isDashboardServerRunning(port?: number, host?: string): Promise<boolean>;
+/**
+ * Wait for Dashboard server to become available.
+ * Polls the health endpoint until it responds or timeout is reached.
+ * @param port - Port to check
+ * @param host - Host to check
+ * @param timeoutMs - Maximum time to wait
+ * @returns Promise that resolves to true if server became available
+ */
+export declare function waitForDashboardReady(port?: number, host?: string, timeoutMs?: number): Promise<boolean>;
+/**
+ * Attempt to start the CCW Dashboard server in a detached child process.
+ * @param port - Port to start the server on
+ * @param host - Host to bind the server to
+ * @param openBrowser - Whether to open browser (default: false)
+ * @returns Promise that resolves to true if process was successfully spawned and became ready
+ */
+export declare function startCcwServeProcess(port?: number, host?: string, openBrowser?: boolean): Promise<boolean>;
+/**
+ * Get the current dashboard process info.
+ * @returns Object with process status and PID
+ */
+export declare function getDashboardProcessStatus(): {
+    running: boolean;
+    pid: number | null;
+};
+/**
+ * Stop the spawned dashboard process (if any).
+ * Note: This only stops the process we spawned, not externally started servers.
+ */
+export declare function stopSpawnedDashboard(): Promise<void>;
+//# sourceMappingURL=dashboard-launcher.d.ts.map

package/ccw/dist/utils/dashboard-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-launcher.d.ts","sourceRoot":"","sources":["../../src/utils/dashboard-launcher.ts"],"names":[],"mappings":"AA0BA;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,GAAE,MAAuB,EAC7B,IAAI,GAAE,MAAuB,GAC5B,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,GAAE,MAAuB,EAC7B,IAAI,GAAE,MAAuB,EAC7B,SAAS,GAAE,MAAqC,GAC/C,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,GAAE,MAAuB,EAC7B,IAAI,GAAE,MAAuB,EAC7B,WAAW,GAAE,OAAe,GAC3B,OAAO,CAAC,OAAO,CAAC,CA8DlB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAKpF;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAuB1D"}

package/ccw/dist/utils/dashboard-launcher.js

@@ -0,0 +1,166 @@
+// ========================================
+// Dashboard Launcher Utility
+// ========================================
+// Detects Dashboard server status and auto-starts if needed
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import http from 'http';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Constants
+const DASHBOARD_PORT = Number(process.env.CCW_PORT || 3456);
+const DASHBOARD_HOST = process.env.CCW_HOST || '127.0.0.1';
+const DASHBOARD_CHECK_TIMEOUT_MS = 500;
+const DASHBOARD_STARTUP_TIMEOUT_MS = 30000;
+const DASHBOARD_STARTUP_POLL_INTERVAL_MS = 500;
+// Path to CCW CLI (adjust based on build output location)
+const CCW_CLI_PATH = join(__dirname, '../../bin/ccw.js');
+// Track spawned dashboard process
+let dashboardProcess = null;
+/**
+ * Check if the Dashboard server is running by attempting to connect to its health endpoint.
+ * @returns Promise that resolves to true if server is reachable
+ */
+export async function isDashboardServerRunning(port = DASHBOARD_PORT, host = DASHBOARD_HOST) {
+    return new Promise((resolve) => {
+        const req = http.get({
+            hostname: host,
+            port,
+            path: '/api/health',
+            timeout: DASHBOARD_CHECK_TIMEOUT_MS,
+        }, (res) => {
+            res.resume(); // Consume response data
+            res.on('end', () => {
+                resolve(res.statusCode === 200);
+            });
+        });
+        req.on('error', () => {
+            resolve(false);
+        });
+        req.on('timeout', () => {
+            req.destroy();
+            resolve(false);
+        });
+    });
+}
+/**
+ * Wait for Dashboard server to become available.
+ * Polls the health endpoint until it responds or timeout is reached.
+ * @param port - Port to check
+ * @param host - Host to check
+ * @param timeoutMs - Maximum time to wait
+ * @returns Promise that resolves to true if server became available
+ */
+export async function waitForDashboardReady(port = DASHBOARD_PORT, host = DASHBOARD_HOST, timeoutMs = DASHBOARD_STARTUP_TIMEOUT_MS) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        const isRunning = await isDashboardServerRunning(port, host);
+        if (isRunning) {
+            return true;
+        }
+        await new Promise((resolve) => setTimeout(resolve, DASHBOARD_STARTUP_POLL_INTERVAL_MS));
+    }
+    return false;
+}
+/**
+ * Attempt to start the CCW Dashboard server in a detached child process.
+ * @param port - Port to start the server on
+ * @param host - Host to bind the server to
+ * @param openBrowser - Whether to open browser (default: false)
+ * @returns Promise that resolves to true if process was successfully spawned and became ready
+ */
+export async function startCcwServeProcess(port = DASHBOARD_PORT, host = DASHBOARD_HOST, openBrowser = false) {
+    // Don't start if already running
+    const alreadyRunning = await isDashboardServerRunning(port, host);
+    if (alreadyRunning) {
+        console.log(`[DashboardLauncher] Dashboard already running at ${host}:${port}`);
+        return true;
+    }
+    // Don't spawn duplicate process
+    if (dashboardProcess && !dashboardProcess.killed) {
+        console.log(`[DashboardLauncher] Dashboard process already spawned, waiting for ready...`);
+        return waitForDashboardReady(port, host);
+    }
+    console.log(`[DashboardLauncher] Starting Dashboard server at ${host}:${port}...`);
+    return new Promise((resolve) => {
+        try {
+            const args = ['serve', '--port', port.toString(), '--host', host];
+            if (!openBrowser) {
+                args.push('--no-browser');
+            }
+            dashboardProcess = spawn('node', [CCW_CLI_PATH, ...args], {
+                detached: true,
+                stdio: 'ignore', // Detach stdio from parent
+                shell: process.platform === 'win32', // Use shell on Windows for better compatibility
+                env: {
+                    ...process.env,
+                    CCW_PORT: port.toString(),
+                    CCW_HOST: host,
+                },
+            });
+            dashboardProcess.unref(); // Allow parent to exit independently
+            dashboardProcess.on('error', (err) => {
+                console.error(`[DashboardLauncher] Failed to start Dashboard: ${err.message}`);
+                dashboardProcess = null;
+                resolve(false);
+            });
+            // Wait for server to become ready
+            waitForDashboardReady(port, host)
+                .then((ready) => {
+                if (ready) {
+                    console.log(`[DashboardLauncher] Dashboard started successfully (PID: ${dashboardProcess?.pid})`);
+                }
+                else {
+                    console.error(`[DashboardLauncher] Dashboard failed to start within timeout`);
+                    dashboardProcess = null;
+                }
+                resolve(ready);
+            })
+                .catch(() => {
+                resolve(false);
+            });
+        }
+        catch (err) {
+            console.error(`[DashboardLauncher] Exception while starting Dashboard: ${err.message}`);
+            dashboardProcess = null;
+            resolve(false);
+        }
+    });
+}
+/**
+ * Get the current dashboard process info.
+ * @returns Object with process status and PID
+ */
+export function getDashboardProcessStatus() {
+    return {
+        running: dashboardProcess !== null && !dashboardProcess.killed,
+        pid: dashboardProcess?.pid ?? null,
+    };
+}
+/**
+ * Stop the spawned dashboard process (if any).
+ * Note: This only stops the process we spawned, not externally started servers.
+ */
+export async function stopSpawnedDashboard() {
+    if (dashboardProcess && !dashboardProcess.killed) {
+        console.log(`[DashboardLauncher] Stopping spawned Dashboard process (PID: ${dashboardProcess.pid})...`);
+        return new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                if (dashboardProcess && !dashboardProcess.killed) {
+                    dashboardProcess.kill('SIGKILL');
+                }
+                dashboardProcess = null;
+                resolve();
+            }, 5000);
+            dashboardProcess.once('exit', () => {
+                clearTimeout(timeout);
+                dashboardProcess = null;
+                console.log(`[DashboardLauncher] Dashboard process stopped`);
+                resolve();
+            });
+            dashboardProcess.kill('SIGTERM');
+        });
+    }
+}
+//# sourceMappingURL=dashboard-launcher.js.map

package/ccw/dist/utils/dashboard-launcher.js.map

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

package/ccw/dist/utils/db-loader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Database Loader - Centralized better-sqlite3 loading with native module error handling
+ * Catches NODE_MODULE_VERSION mismatch errors and provides actionable fix instructions
+ */
+/**
+ * Load better-sqlite3 Database constructor with error handling.
+ * Returns the Database class or null if loading fails.
+ */
+export declare function loadDatabase(): typeof import('better-sqlite3') | null;
+/**
+ * Create a database instance with error handling.
+ * Returns the database instance or null if creation fails.
+ */
+export declare function createDatabase(dbPath: string, options?: any): any | null;
+//# sourceMappingURL=db-loader.d.ts.map

package/ccw/dist/utils/db-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-loader.d.ts","sourceRoot":"","sources":["../../src/utils/db-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsBH;;;GAGG;AACH,wBAAgB,YAAY,IAAI,cAAc,gBAAgB,CAAC,GAAG,IAAI,CASrE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CASxE"}