coding-tool-x 3.7.4 → 3.7.6

package/src/server/api/omp-sessions.js

@@ -16,6 +16,14 @@ const {
 } = require('../services/omp-sessions');
 const { loadAliases } = require('../services/alias');
 const { broadcastLog } = require('../websocket-server');
+const {
+  defaultProjectInfo,
+  emptySessionList,
+  getSessionListSnapshot,
+  invalidateSessionSnapshots,
+  runSessionSnapshotWorker
+} = require('../services/session-snapshots');
+const { invalidateProjectSnapshots } = require('../services/project-snapshots');
 
 function isNotFoundError(error) {
   if (!error || !error.message) return false;
@@ -81,27 +89,22 @@ module.exports = () => {
     }
   });
 
-  router.get('/:projectName', (req, res) => {
+  router.get('/:projectName', async (req, res) => {
     try {
       if (!isOmpInstalled()) {
         return res.status(404).json({ error: 'OMP CLI not installed' });
       }
       const { projectName } = req.params;
-      const sessions = getSessionsByProject(projectName);
-      const aliases = loadAliases();
-      const project = getProjects().find(p => p.name === projectName);
-      const totalSize = sessions.reduce((sum, session) => sum + (session.size || 0), 0);
-      res.json({
-        sessions,
-        totalSize,
-        aliases,
-        projectInfo: {
-          name: projectName,
-          fullPath: project?.fullPath || project?.path || projectName,
-          path: project?.path || projectName,
-          displayName: project?.displayName || projectName
-        }
+      const force = req.query?.fresh === '1';
+      const snapshot = await getSessionListSnapshot('omp', projectName, {
+        fallbackValue: emptySessionList(projectName, {
+          aliases: loadAliases(),
+          projectInfo: defaultProjectInfo(projectName)
+        }),
+        force,
+        refresh: () => runSessionSnapshotWorker('omp', projectName, {}, { force })
       });
+      res.json({ ...snapshot.value, meta: snapshot.meta });
     } catch (err) {
       console.error('[OMP API] Failed to get sessions:', err);
       res.status(500).json({ error: err.message });
@@ -206,7 +209,10 @@ module.exports = () => {
       if (!isOmpInstalled()) {
         return res.status(404).json({ error: 'OMP CLI not installed' });
       }
-      res.json(deleteSession(req.params.sessionId));
+      const result = deleteSession(req.params.sessionId);
+      invalidateSessionSnapshots('omp', req.params.projectName);
+      invalidateProjectSnapshots('omp');
+      res.json(result);
     } catch (err) {
       if (isNotFoundError(err)) {
         return res.status(404).json({ error: err.message });
@@ -244,6 +250,10 @@ module.exports = () => {
           failed.push({ sessionId, error: err.message });
         }
       });
+      if (deletedSessionIds.length > 0) {
+        invalidateSessionSnapshots('omp', req.params.projectName);
+        invalidateProjectSnapshots('omp');
+      }
       res.json({
         success: failed.length === 0,
         requestedCount: uniqueSessionIds.length,
@@ -262,7 +272,10 @@ module.exports = () => {
       if (!isOmpInstalled()) {
         return res.status(404).json({ error: 'OMP CLI not installed' });
       }
-      res.json(forkSession(req.params.sessionId, req.body || {}));
+      const result = forkSession(req.params.sessionId, req.body || {});
+      invalidateSessionSnapshots('omp', req.params.projectName);
+      invalidateProjectSnapshots('omp');
+      res.json(result);
     } catch (err) {
       if (isNotFoundError(err)) {
         return res.status(404).json({ error: err.message });
@@ -282,6 +295,7 @@ module.exports = () => {
         return res.status(400).json({ error: 'order must be an array' });
       }
       saveSessionOrder(req.params.projectName, order);
+      invalidateSessionSnapshots('omp', req.params.projectName);
       res.json({ success: true });
     } catch (err) {
       console.error('[OMP API] Failed to save session order:', err);

package/src/server/api/opencode-projects.js

@@ -1,7 +1,6 @@
 const express = require('express');
 const router = express.Router();
 const {
-  getProjects,
   saveProjectOrder,
   deleteProject,
   isOpenCodeInstalled
@@ -11,20 +10,14 @@ const {
   getProjectListSnapshot,
   invalidateProjectSnapshots
 } = require('../services/project-snapshots');
+const { invalidateSessionSnapshots } = require('../services/session-snapshots');
+const { runDashboardSnapshotWorker } = require('../services/dashboard-snapshot-worker');
 
 function isNotFoundError(error) {
   return !!(error && error.message === 'Project not found');
 }
 
 module.exports = (config) => {
-  function buildProjectsPayload() {
-    const projects = getProjects();
-    return {
-      projects,
-      currentProject: projects[0] ? projects[0].name : null
-    };
-  }
-
   /**
    * GET /api/opencode/projects
    * 获取所有 OpenCode 项目列表
@@ -40,10 +33,11 @@ module.exports = (config) => {
         });
       }
 
+      const force = req.query?.fresh === '1';
       const snapshot = await getProjectListSnapshot('opencode', {
         fallbackValue: emptyProjectList(null),
-        force: req.query?.fresh === '1',
-        refresh: buildProjectsPayload
+        force,
+        refresh: () => runDashboardSnapshotWorker('projects', 'opencode', config, { force })
       });
       res.json({ ...snapshot.value, meta: snapshot.meta });
     } catch (err) {
@@ -100,6 +94,7 @@ module.exports = (config) => {
       const { projectName } = req.params;
       const result = deleteProject(projectName);
       invalidateProjectSnapshots('opencode');
+      invalidateSessionSnapshots('opencode', projectName);
       res.json(result);
     } catch (err) {
       if (isNotFoundError(err)) {

package/src/server/api/opencode-sessions.js

@@ -15,6 +15,14 @@ const {
 const { loadAliases } = require('../services/alias');
 const { broadcastLog } = require('../websocket-server');
 const { HOME_DIR } = require('../../config/paths');
+const {
+  defaultProjectInfo,
+  emptySessionList,
+  getSessionListSnapshot,
+  invalidateSessionSnapshots,
+  runSessionSnapshotWorker
+} = require('../services/session-snapshots');
+const { invalidateProjectSnapshots } = require('../services/project-snapshots');
 
 function isNotFoundError(error) {
   if (!error || !error.message) {
@@ -117,34 +125,23 @@ module.exports = (config) => {
    * GET /api/opencode/sessions/:projectName
    * 获取项目的所有会话
    */
-  router.get('/:projectName', (req, res) => {
+  router.get('/:projectName', async (req, res) => {
     try {
       if (!isOpenCodeInstalled()) {
         return res.status(404).json({ error: 'OpenCode CLI not installed' });
       }
 
       const { projectName } = req.params;
-      const sessions = getSessionsByProject(projectName);
-      const aliases = loadAliases();
-      const projects = getProjects();
-      const project = projects.find(p => p.name === projectName);
-
-      // 计算总大小
-      const totalSize = sessions.reduce((sum, session) => {
-        return sum + (session.size || 0);
-      }, 0);
-
-      res.json({
-        sessions,
-        totalSize,
-        aliases,
-        projectInfo: {
-          name: projectName,
-          fullPath: project?.fullPath || projectName,
-          path: project?.path || projectName,
-          displayName: project?.displayName || projectName
-        }
+      const force = req.query?.fresh === '1';
+      const snapshot = await getSessionListSnapshot('opencode', projectName, {
+        fallbackValue: emptySessionList(projectName, {
+          aliases: loadAliases(),
+          projectInfo: defaultProjectInfo(projectName)
+        }),
+        force,
+        refresh: () => runSessionSnapshotWorker('opencode', projectName, {}, { force })
       });
+      res.json({ ...snapshot.value, meta: snapshot.meta });
     } catch (err) {
       console.error('[OpenCode API] Failed to get sessions:', err);
       res.status(500).json({ error: err.message });
@@ -294,6 +291,8 @@ module.exports = (config) => {
 
       const { sessionId } = req.params;
       const result = deleteSession(sessionId);
+      invalidateSessionSnapshots('opencode', req.params.projectName);
+      invalidateProjectSnapshots('opencode');
 
       res.json(result);
     } catch (err) {
@@ -347,6 +346,11 @@ module.exports = (config) => {
         }
       });
 
+      if (deletedSessionIds.length > 0) {
+        invalidateSessionSnapshots('opencode', req.params.projectName);
+        invalidateProjectSnapshots('opencode');
+      }
+
       res.json({
         success: failed.length === 0,
         requestedCount: uniqueSessionIds.length,
@@ -372,6 +376,8 @@ module.exports = (config) => {
 
       const { sessionId } = req.params;
       const result = forkSession(sessionId);
+      invalidateSessionSnapshots('opencode', req.params.projectName);
+      invalidateProjectSnapshots('opencode');
       res.json(result);
     } catch (err) {
       if (isNotFoundError(err)) {
@@ -401,6 +407,7 @@ module.exports = (config) => {
       }
 
       saveSessionOrder(projectName, order);
+      invalidateSessionSnapshots('opencode', projectName);
       res.json({ success: true });
     } catch (err) {
       console.error('[OpenCode API] Failed to save session order:', err);

package/src/server/api/projects.js

@@ -1,45 +1,23 @@
 const express = require('express');
 const router = express.Router();
-const { getProjectsWithStats, saveProjectOrder, getProjectOrder, deleteProject } = require('../services/sessions');
+const { saveProjectOrder, deleteProject } = require('../services/sessions');
 const {
   emptyProjectList,
   getProjectListSnapshot,
   invalidateProjectSnapshots
 } = require('../services/project-snapshots');
+const { invalidateSessionSnapshots } = require('../services/session-snapshots');
+const { runDashboardSnapshotWorker } = require('../services/dashboard-snapshot-worker');
 
 module.exports = (config) => {
-  async function buildProjectsPayload() {
-    const projects = await getProjectsWithStats(config);
-    const order = getProjectOrder(config);
-
-    // Sort projects by saved order
-    let sortedProjects = projects;
-    if (order && order.length > 0) {
-      const orderMap = new Map(order.map((name, idx) => [name, idx]));
-      sortedProjects = [...projects].sort((a, b) => {
-        const aIdx = orderMap.has(a.name) ? orderMap.get(a.name) : 999999;
-        const bIdx = orderMap.has(b.name) ? orderMap.get(b.name) : 999999;
-        if (aIdx === bIdx) {
-          // Both are new, sort by lastUsed
-          return (b.lastUsed || 0) - (a.lastUsed || 0);
-        }
-        return aIdx - bIdx;
-      });
-    }
-
-    return {
-      projects: sortedProjects,
-      currentProject: config.currentProject || (sortedProjects[0] ? sortedProjects[0].name : null)
-    };
-  }
-
   // GET /api/projects - Get all projects with stats
   router.get('/', async (req, res) => {
     try {
+      const force = req.query?.fresh === '1';
       const snapshot = await getProjectListSnapshot('claude', {
         fallbackValue: emptyProjectList(config.currentProject || null),
-        force: req.query?.fresh === '1',
-        refresh: buildProjectsPayload
+        force,
+        refresh: () => runDashboardSnapshotWorker('projects', 'claude', config, { force })
       });
       res.json({ ...snapshot.value, meta: snapshot.meta });
     } catch (error) {
@@ -130,6 +108,7 @@ module.exports = (config) => {
       const { projectName } = req.params;
       deleteProject(config, projectName);
       invalidateProjectSnapshots('claude');
+      invalidateSessionSnapshots('claude', projectName);
       res.json({ success: true });
     } catch (error) {
       console.error('Error deleting project:', error);

package/src/server/api/sessions.js

@@ -3,10 +3,18 @@ const router = express.Router();
 const path = require('path');
 const fs = require('fs');
 const readline = require('readline');
-const { getSessionsForProject, deleteSession, forkSession, saveSessionOrder, parseRealProjectPath, searchSessions, getRecentSessions, searchSessionsAcrossProjects, hasActualMessages } = require('../services/sessions');
+const { deleteSession, forkSession, saveSessionOrder, parseRealProjectPath, searchSessions, getRecentSessions, searchSessionsAcrossProjects, hasActualMessages } = require('../services/sessions');
 const { loadAliases } = require('../services/alias');
 const { broadcastLog } = require('../websocket-server');
 const { NATIVE_PATHS } = require('../../config/paths');
+const {
+  defaultProjectInfo,
+  emptySessionList,
+  getSessionListSnapshot,
+  invalidateSessionSnapshots,
+  runSessionSnapshotWorker
+} = require('../services/session-snapshots');
+const { invalidateProjectSnapshots } = require('../services/project-snapshots');
 const CLAUDE_PROJECTS_DIR = NATIVE_PATHS.claude.projects;
 
 function resolveClaudeSessionFile(projectName, sessionId, fullPath) {
@@ -158,22 +166,16 @@ module.exports = (config) => {
   router.get('/:projectName', async (req, res) => {
     try {
       const { projectName } = req.params;
-      const result = await getSessionsForProject(config, projectName);
-      const aliases = loadAliases();
-
-      // Parse project path info
-      const { fullPath, projectName: displayName } = parseRealProjectPath(projectName);
-
-      res.json({
-        sessions: result.sessions,
-        totalSize: result.totalSize,
-        aliases,
-        projectInfo: {
-          name: projectName,
-          displayName,
-          fullPath
-        }
+      const force = req.query?.fresh === '1';
+      const snapshot = await getSessionListSnapshot('claude', projectName, {
+        fallbackValue: emptySessionList(projectName, {
+          aliases: loadAliases(),
+          projectInfo: defaultProjectInfo(projectName)
+        }),
+        force,
+        refresh: () => runSessionSnapshotWorker('claude', projectName, config, { force })
       });
+      res.json({ ...snapshot.value, meta: snapshot.meta });
     } catch (error) {
       console.error('Error fetching sessions:', error);
       res.status(500).json({ error: error.message });
@@ -185,6 +187,8 @@ module.exports = (config) => {
     try {
       const { projectName, sessionId } = req.params;
       const result = deleteSession(config, projectName, sessionId);
+      invalidateSessionSnapshots('claude', projectName);
+      invalidateProjectSnapshots('claude');
       res.json(result);
     } catch (error) {
       console.error('Error deleting session:', error);
@@ -228,6 +232,11 @@ module.exports = (config) => {
         }
       });
 
+      if (deletedSessionIds.length > 0) {
+        invalidateSessionSnapshots('claude', projectName);
+        invalidateProjectSnapshots('claude');
+      }
+
       res.json({
         success: failed.length === 0,
         requestedCount: uniqueSessionIds.length,
@@ -246,6 +255,8 @@ module.exports = (config) => {
     try {
       const { projectName, sessionId } = req.params;
       const result = forkSession(config, projectName, sessionId, normalizeForkOptions(req.body));
+      invalidateSessionSnapshots('claude', projectName);
+      invalidateProjectSnapshots('claude');
       res.json(result);
     } catch (error) {
       console.error('Error forking session:', error);
@@ -330,6 +341,10 @@ module.exports = (config) => {
         timestamp: Date.now()
       });
 
+      const snapshotSource = toolType === 'codex' || toolType === 'gemini' ? toolType : 'claude';
+      invalidateSessionSnapshots(snapshotSource, projectName);
+      invalidateProjectSnapshots(snapshotSource);
+
       res.json({
         success: true,
         sessionId: newSessionId,
@@ -352,6 +367,7 @@ module.exports = (config) => {
         return res.status(400).json({ error: 'order must be an array' });
       }
       saveSessionOrder(projectName, order);
+      invalidateSessionSnapshots('claude', projectName);
       res.json({ success: true });
     } catch (error) {
       console.error('Error saving session order:', error);

package/src/server/services/channel-balance.js

@@ -1737,7 +1737,8 @@ async function refreshChannelBalance(source, channelId) {
 
   const entry = await refreshSnapshot(
     buildBalanceSnapshotKey(normalizedSource, channel),
-    () => refreshChannelBalanceSnapshot(normalizedSource, channel, { force: true })
+    () => refreshChannelBalanceSnapshot(normalizedSource, channel, { force: true }),
+    { bypassInflight: true }
   );
   const balance = entry.value;
   return {

package/src/server/services/codex-sessions.js

@@ -227,10 +227,14 @@ function normalizeSession(codexSession) {
  * 聚合项目列表
  * @returns {Array} 项目对象数组
  */
-function getProjects() {
-  const cached = globalCache.get(CODEX_PROJECTS_CACHE_KEY);
-  if (cached) {
-    return cached;
+function getProjects(options = {}) {
+  if (options.force) {
+    invalidateCodexSessionCaches();
+  } else {
+    const cached = globalCache.get(CODEX_PROJECTS_CACHE_KEY);
+    if (cached) {
+      return cached;
+    }
   }
 
   const sessions = getAllSessions();
@@ -302,11 +306,15 @@ function getProjects() {
  * @param {string} projectName - 项目名称
  * @returns {Array} 归一化的会话数组
  */
-function getSessionsByProject(projectName) {
+function getSessionsByProject(projectName, options = {}) {
   const cacheKey = getCodexSessionsCacheKey(projectName);
-  const cached = globalCache.get(cacheKey);
-  if (cached) {
-    return cached;
+  if (options.force) {
+    invalidateCodexSessionCaches({ projectName });
+  } else {
+    const cached = globalCache.get(cacheKey);
+    if (cached) {
+      return cached;
+    }
   }
 
   const sessions = getAllSessions();
@@ -975,9 +983,14 @@ function calculateProjectAndSessionCounts() {
 /**
  * 获取 Codex 项目与会话数量（用于仪表盘轻量统计）
  */
-function getProjectAndSessionCounts() {
+function getProjectAndSessionCounts(options = {}) {
   const now = Date.now();
-  if (countsCache.expiresAt > now) {
+  if (options.force) {
+    countsCache.expiresAt = 0;
+    scanFilesCache.expiresAt = 0;
+    sessionFileIndexCache.expiresAt = 0;
+  }
+  if (!options.force && countsCache.expiresAt > now) {
     return countsCache.value;
   }
 

package/src/server/services/dashboard-snapshot-worker.js

@@ -0,0 +1,216 @@
+'use strict';
+
+const { fork } = require('child_process');
+
+const DASHBOARD_SNAPSHOT_WORKER_TIMEOUT_MS = 180 * 1000;
+
+function sortClaudeProjects(projects, order = []) {
+  if (!Array.isArray(order) || order.length === 0) {
+    return projects;
+  }
+  const orderMap = new Map(order.map((name, idx) => [name, idx]));
+  return [...projects].sort((a, b) => {
+    const aIdx = orderMap.has(a.name) ? orderMap.get(a.name) : 999999;
+    const bIdx = orderMap.has(b.name) ? orderMap.get(b.name) : 999999;
+    if (aIdx === bIdx) {
+      return (b.lastUsed || 0) - (a.lastUsed || 0);
+    }
+    return aIdx - bIdx;
+  });
+}
+
+async function buildProjectsPayload(source, config = {}, options = {}) {
+  switch (source) {
+    case 'claude': {
+      const { getProjectsWithStats, getProjectOrder } = require('./sessions');
+      const projects = await getProjectsWithStats(config, { force: options.force === true });
+      const sortedProjects = sortClaudeProjects(projects, getProjectOrder(config));
+      return {
+        projects: sortedProjects,
+        currentProject: config.currentProject || (sortedProjects[0] ? sortedProjects[0].name : null)
+      };
+    }
+    case 'codex': {
+      const { getProjects } = require('./codex-sessions');
+      const projects = getProjects({ force: options.force === true });
+      return { projects, currentProject: projects[0] ? projects[0].name : null };
+    }
+    case 'gemini': {
+      const { getProjects } = require('./gemini-sessions');
+      const projects = getProjects({ force: options.force === true });
+      return { projects, currentProject: projects[0] ? projects[0].name : null };
+    }
+    case 'opencode': {
+      const { getProjects } = require('./opencode-sessions');
+      const projects = getProjects({ force: options.force === true });
+      return { projects, currentProject: projects[0] ? projects[0].name : null };
+    }
+    case 'omp': {
+      const { getProjects } = require('./omp-sessions');
+      const projects = getProjects({ force: options.force === true });
+      return { projects, currentProject: projects[0] ? projects[0].name : null };
+    }
+    default:
+      throw new Error(`Unsupported project snapshot source: ${source}`);
+  }
+}
+
+function buildCountsPayload(source, config = {}, options = {}) {
+  switch (source) {
+    case 'claude':
+      return require('./sessions').getProjectAndSessionCounts(config, { force: options.force === true });
+    case 'codex':
+      return require('./codex-sessions').getProjectAndSessionCounts({ force: options.force === true });
+    case 'gemini':
+      return require('./gemini-sessions').getProjectAndSessionCounts({ force: options.force === true });
+    case 'opencode':
+      return require('./opencode-sessions').getProjectAndSessionCounts({ force: options.force === true });
+    case 'omp':
+      return require('./omp-sessions').getProjectAndSessionCounts({ force: options.force === true });
+    default:
+      throw new Error(`Unsupported counts snapshot source: ${source}`);
+  }
+}
+
+function buildTodayStatsPayload(source) {
+  switch (source) {
+    case 'claude':
+      return require('./claude-statistics-service').getTodayStatistics();
+    case 'codex':
+      return require('./codex-statistics-service').getTodayStatistics();
+    case 'gemini':
+      return require('./gemini-statistics-service').getTodayStatistics();
+    case 'opencode':
+      return require('./opencode-statistics-service').getTodayStatistics();
+    case 'omp':
+      return require('./omp-statistics-service').getTodayStatistics();
+    default:
+      throw new Error(`Unsupported today stats snapshot source: ${source}`);
+  }
+}
+
+function buildChannelsPayload(source) {
+  switch (source) {
+    case 'claude':
+      return require('./channels').getAllChannels();
+    case 'codex':
+      return require('./codex-channels').getChannels();
+    case 'gemini':
+      return require('./gemini-channels').getChannels();
+    case 'opencode':
+      return require('./opencode-channels').getChannels();
+    case 'omp':
+      return require('./omp-channels').getChannels();
+    default:
+      throw new Error(`Unsupported channels snapshot source: ${source}`);
+  }
+}
+
+async function buildPayload({ kind, source, config, options }) {
+  const snapshotOptions = options || {};
+  switch (kind) {
+    case 'projects':
+      return buildProjectsPayload(source, config || {}, snapshotOptions);
+    case 'counts':
+      return buildCountsPayload(source, config || {}, snapshotOptions);
+    case 'todayStats':
+      return buildTodayStatsPayload(source);
+    case 'channels':
+      return buildChannelsPayload(source);
+    default:
+      throw new Error(`Unsupported dashboard snapshot kind: ${kind}`);
+  }
+}
+
+function runDashboardSnapshotWorker(kind, source, config = {}, options = {}) {
+  if (process.env.NODE_ENV === 'test') {
+    return Promise.resolve(buildPayload({ kind, source, config, options }));
+  }
+
+  return new Promise((resolve, reject) => {
+    const child = fork(__filename, [], {
+      stdio: ['ignore', 'ignore', 'pipe', 'ipc'],
+      env: {
+        ...process.env,
+        CC_TOOL_DASHBOARD_SNAPSHOT_WORKER: '1'
+      }
+    });
+
+    let settled = false;
+    let stderr = '';
+    let timeout = null;
+
+    const finish = (error, value) => {
+      if (settled) return;
+      settled = true;
+      if (timeout) {
+        clearTimeout(timeout);
+      }
+      child.removeAllListeners();
+      if (!child.killed) {
+        child.kill();
+      }
+      if (error) {
+        reject(error);
+      } else {
+        resolve(value);
+      }
+    };
+
+    timeout = setTimeout(() => {
+      finish(new Error(`Dashboard snapshot refresh timed out for ${kind}/${source}`));
+    }, DASHBOARD_SNAPSHOT_WORKER_TIMEOUT_MS);
+
+    child.stderr.on('data', (chunk) => {
+      stderr += chunk.toString();
+      if (stderr.length > 4096) {
+        stderr = stderr.slice(-4096);
+      }
+    });
+
+    child.on('message', (message) => {
+      if (!message || typeof message !== 'object') return;
+      if (message.ok) {
+        finish(null, message.value);
+      } else {
+        finish(new Error(message.error || `Dashboard snapshot refresh failed for ${kind}/${source}`));
+      }
+    });
+
+    child.on('error', (error) => finish(error));
+    child.on('exit', (code, signal) => {
+      if (settled) return;
+      const suffix = stderr ? `: ${stderr.trim()}` : '';
+      finish(new Error(`Dashboard snapshot worker exited (${code || signal || 'unknown'})${suffix}`));
+    });
+
+    child.send({ kind, source, config, options });
+  });
+}
+
+function attachWorkerHandler() {
+  process.on('message', async (message) => {
+    try {
+      const value = await buildPayload(message || {});
+      if (process.send) {
+        process.send({ ok: true, value }, () => process.exit(0));
+        return;
+      }
+    } catch (error) {
+      if (process.send) {
+        process.send({ ok: false, error: error?.message || String(error) }, () => process.exit(1));
+        return;
+      }
+    }
+    process.exit(0);
+  });
+}
+
+if (process.env.CC_TOOL_DASHBOARD_SNAPSHOT_WORKER === '1' || require.main === module) {
+  attachWorkerHandler();
+}
+
+module.exports = {
+  buildPayload,
+  runDashboardSnapshotWorker
+};