claude-code-workflow 6.3.37 → 6.3.39

package/ccw/src/templates/dashboard.html

@@ -278,6 +278,50 @@
       display: block;
       animation: spin 1s linear infinite;
     }
+    .check-icon-loading {
+      display: none;
+    }
+
+    /* Version Badge */
+    .version-badge {
+      display: none;
+      position: absolute;
+      top: -2px;
+      right: -2px;
+      min-width: 16px;
+      height: 16px;
+      padding: 0 4px;
+      background: hsl(var(--destructive));
+      color: white;
+      border-radius: 8px;
+      font-size: 0.625rem;
+      font-weight: 600;
+      align-items: center;
+      justify-content: center;
+      pointer-events: none;
+      z-index: 10;
+    }
+    .version-badge.has-update {
+      display: flex;
+      animation: badgePulse 2s ease-in-out infinite;
+    }
+    .version-badge.checking {
+      display: flex;
+      background: hsl(var(--muted) / 0.8);
+    }
+    .version-badge.checking::after {
+      content: '...';
+      animation: dots 1.5s steps(4, end) infinite;
+    }
+    @keyframes badgePulse {
+      0%, 100% { transform: scale(1); }
+      50% { transform: scale(1.15); }
+    }
+    @keyframes dots {
+      0%, 20% { content: '.'; }
+      40% { content: '..'; }
+      60%, 100% { content: '...'; }
+    }
 
     /* Auto-Update Toggle Switch */
     .auto-update-switch {
@@ -390,7 +434,7 @@
           <!-- Auto-Update Controls -->
           <div class="flex items-center gap-2 border-l border-border pl-2">
             <!-- Check Now Button -->
-            <button class="tooltip-bottom p-1.5 text-muted-foreground hover:text-foreground hover:bg-hover rounded" id="checkUpdateNow" data-tooltip="Check for updates now" onclick="checkForUpdatesNow()">
+            <button class="tooltip-bottom p-1.5 text-muted-foreground hover:text-foreground hover:bg-hover rounded relative" id="checkUpdateNow" data-tooltip="Check for updates now" onclick="checkForUpdatesNow()">
               <!-- Download Icon (default) -->
               <svg class="check-icon-default" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
                 <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/>
@@ -398,9 +442,11 @@
                 <line x1="12" y1="15" x2="12" y2="3"/>
               </svg>
               <!-- Loading Icon (checking state) -->
-              <svg class="check-icon-loading hidden" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+              <svg class="check-icon-loading" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
                 <path d="M21 12a9 9 0 1 1-6.219-8.56"/>
               </svg>
+              <!-- Version Available Badge -->
+              <span class="version-badge" id="versionBadge"></span>
             </button>
             <!-- Auto-Update Toggle Switch -->
             <label class="tooltip-bottom auto-update-switch" data-tooltip="Auto-update">

package/ccw/src/tools/claude-cli-tools.ts

@@ -268,7 +268,8 @@ function ensureToolTags(tool: Partial<ClaudeCliTool>): ClaudeCliTool {
     enabled: tool.enabled ?? true,
     primaryModel: tool.primaryModel,
     secondaryModel: tool.secondaryModel,
-    tags: tool.tags ?? []
+    tags: tool.tags ?? [],
+    envFile: tool.envFile
   };
 }
 
@@ -438,9 +439,9 @@ export function loadClaudeCliTools(projectDir: string): ClaudeCliToolsConfig & {
     const migrated = migrateConfig(parsed, projectDir);
     const needsSave = migrated.version !== parsed.version;
 
-    // Merge tools with defaults and ensure required fields exist
+    // Load user-configured tools only (defaults NOT merged)
     const mergedTools: Record<string, ClaudeCliTool> = {};
-    for (const [key, tool] of Object.entries({ ...DEFAULT_TOOLS_CONFIG.tools, ...(migrated.tools || {}) })) {
+    for (const [key, tool] of Object.entries(migrated.tools || {})) {
       mergedTools[key] = {
         ...ensureToolTags(tool),
         type: tool.type ?? 'builtin',

package/ccw/src/tools/cli-config-manager.ts

@@ -29,6 +29,7 @@ export interface CliToolConfig {
   primaryModel: string;
   secondaryModel: string;
   tags?: string[];
+  envFile?: string | null;
 }
 
 export interface CliConfig {
@@ -184,7 +185,8 @@ export function getFullConfigResponse(baseDir: string): {
       enabled: tool.enabled,
       primaryModel: tool.primaryModel ?? '',
       secondaryModel: tool.secondaryModel ?? '',
-      tags: tool.tags
+      tags: tool.tags,
+      envFile: tool.envFile
     };
   }
 

package/ccw/src/tools/codex-lens-lsp.ts

@@ -12,14 +12,11 @@ import { z } from 'zod';
 import type { ToolSchema, ToolResult } from '../types/tool.js';
 import { spawn } from 'child_process';
 import { join } from 'path';
-import { homedir } from 'os';
 import { getProjectRoot } from '../utils/path-validator.js';
+import { getCodexLensPython } from '../utils/codexlens-path.js';
 
 // CodexLens venv configuration
-const CODEXLENS_VENV =
-  process.platform === 'win32'
-    ? join(homedir(), '.codexlens', 'venv', 'Scripts', 'python.exe')
-    : join(homedir(), '.codexlens', 'venv', 'bin', 'python');
+const CODEXLENS_VENV = getCodexLensPython();
 
 // Define Zod schema for validation
 const ParamsSchema = z.object({

package/ccw/src/tools/codex-lens.ts

@@ -24,6 +24,12 @@ import {
   isUvAvailable,
   createCodexLensUvManager,
 } from '../utils/uv-manager.js';
+import {
+  getCodexLensDataDir,
+  getCodexLensVenvDir,
+  getCodexLensPython,
+  getCodexLensPip,
+} from '../utils/codexlens-path.js';
 
 // Get directory of this module
 const __filename = fileURLToPath(import.meta.url);
@@ -109,14 +115,6 @@ function findLocalCcwLitellmPath(): string | null {
   return findLocalPackagePath('ccw-litellm');
 }
 
-// CodexLens configuration
-const CODEXLENS_DATA_DIR = join(homedir(), '.codexlens');
-const CODEXLENS_VENV = join(CODEXLENS_DATA_DIR, 'venv');
-const VENV_PYTHON =
-  process.platform === 'win32'
-    ? join(CODEXLENS_VENV, 'Scripts', 'python.exe')
-    : join(CODEXLENS_VENV, 'bin', 'python');
-
 // Bootstrap status cache
 let bootstrapChecked = false;
 let bootstrapReady = false;
@@ -245,7 +243,7 @@ async function checkVenvStatus(force = false): Promise<ReadyStatus> {
   }
 
   // Check venv exists
-  if (!existsSync(CODEXLENS_VENV)) {
+  if (!existsSync(getCodexLensVenvDir())) {
     const result = { ready: false, error: 'Venv not found' };
     venvStatusCache = { status: result, timestamp: Date.now() };
     console.log(`[PERF][CodexLens] checkVenvStatus (no venv): ${Date.now() - funcStart}ms`);
@@ -253,7 +251,7 @@ async function checkVenvStatus(force = false): Promise<ReadyStatus> {
   }
 
   // Check python executable exists
-  if (!existsSync(VENV_PYTHON)) {
+  if (!existsSync(getCodexLensPython())) {
     const result = { ready: false, error: 'Python executable not found in venv' };
     venvStatusCache = { status: result, timestamp: Date.now() };
     console.log(`[PERF][CodexLens] checkVenvStatus (no python): ${Date.now() - funcStart}ms`);
@@ -265,7 +263,7 @@ async function checkVenvStatus(force = false): Promise<ReadyStatus> {
   console.log('[PERF][CodexLens] checkVenvStatus spawning Python...');
 
   return new Promise((resolve) => {
-    const child = spawn(VENV_PYTHON, ['-c', 'import codexlens; import watchdog; print(codexlens.__version__)'], {
+    const child = spawn(getCodexLensPython(), ['-c', 'import codexlens; import watchdog; print(codexlens.__version__)'], {
       stdio: ['ignore', 'pipe', 'pipe'],
       timeout: 10000,
     });
@@ -377,7 +375,7 @@ try:
 except Exception as e:
     print(json.dumps({"available": False, "error": str(e)}))
 `;
-    const child = spawn(VENV_PYTHON, ['-c', checkCode], {
+    const child = spawn(getCodexLensPython(), ['-c', checkCode], {
       stdio: ['ignore', 'pipe', 'pipe'],
       timeout: 15000,
     });
@@ -438,7 +436,7 @@ async function ensureLiteLLMEmbedderReady(): Promise<BootstrapResult> {
 
   // Check if ccw_litellm can be imported
   const importStatus = await new Promise<{ ok: boolean; error?: string }>((resolve) => {
-    const child = spawn(VENV_PYTHON, ['-c', 'import ccw_litellm; print("OK")'], {
+    const child = spawn(getCodexLensPython(), ['-c', 'import ccw_litellm; print("OK")'], {
       stdio: ['ignore', 'pipe', 'pipe'],
       timeout: 15000,
     });
@@ -502,10 +500,7 @@ async function ensureLiteLLMEmbedderReady(): Promise<BootstrapResult> {
   }
 
   // Fallback: Use pip for installation
-  const pipPath =
-    process.platform === 'win32'
-      ? join(CODEXLENS_VENV, 'Scripts', 'pip.exe')
-      : join(CODEXLENS_VENV, 'bin', 'pip');
+  const pipPath = getCodexLensPip();
 
   try {
     if (localPath) {
@@ -552,10 +547,7 @@ interface PythonEnvInfo {
  * DirectML requires: 64-bit Python, version 3.8-3.12
  */
 async function checkPythonEnvForDirectML(): Promise<PythonEnvInfo> {
-  const pythonPath =
-    process.platform === 'win32'
-      ? join(CODEXLENS_VENV, 'Scripts', 'python.exe')
-      : join(CODEXLENS_VENV, 'bin', 'python');
+  const pythonPath = getCodexLensPython();
 
   if (!existsSync(pythonPath)) {
     return { version: '', majorMinor: '', architecture: 0, compatible: false, error: 'Python not found in venv' };
@@ -800,10 +792,7 @@ async function installSemantic(gpuMode: GpuMode = 'cpu'): Promise<BootstrapResul
     console.log(`[CodexLens] Python ${pythonEnv.version} (${pythonEnv.architecture}-bit) - DirectML compatible`);
   }
 
-  const pipPath =
-    process.platform === 'win32'
-      ? join(CODEXLENS_VENV, 'Scripts', 'pip.exe')
-      : join(CODEXLENS_VENV, 'bin', 'pip');
+  const pipPath = getCodexLensPip();
 
   // IMPORTANT: Uninstall all onnxruntime variants first to prevent conflicts
   // Having multiple onnxruntime packages causes provider detection issues
@@ -933,16 +922,18 @@ async function bootstrapVenv(): Promise<BootstrapResult> {
 
   // Fall back to pip logic...
   // Ensure data directory exists
-  if (!existsSync(CODEXLENS_DATA_DIR)) {
-    mkdirSync(CODEXLENS_DATA_DIR, { recursive: true });
+  const dataDir = getCodexLensDataDir();
+  const venvDir = getCodexLensVenvDir();
+  if (!existsSync(dataDir)) {
+    mkdirSync(dataDir, { recursive: true });
   }
 
   // Create venv if not exists
-  if (!existsSync(CODEXLENS_VENV)) {
+  if (!existsSync(venvDir)) {
     try {
       console.log('[CodexLens] Creating virtual environment...');
       const pythonCmd = getSystemPython();
-      execSync(`${pythonCmd} -m venv "${CODEXLENS_VENV}"`, { stdio: 'inherit', timeout: EXEC_TIMEOUTS.PROCESS_SPAWN });
+      execSync(`${pythonCmd} -m venv "${venvDir}"`, { stdio: 'inherit', timeout: EXEC_TIMEOUTS.PROCESS_SPAWN });
     } catch (err) {
       return { success: false, error: `Failed to create venv: ${(err as Error).message}` };
     }
@@ -951,10 +942,7 @@ async function bootstrapVenv(): Promise<BootstrapResult> {
   // Install codex-lens
   try {
     console.log('[CodexLens] Installing codex-lens package...');
-    const pipPath =
-      process.platform === 'win32'
-        ? join(CODEXLENS_VENV, 'Scripts', 'pip.exe')
-        : join(CODEXLENS_VENV, 'bin', 'pip');
+    const pipPath = getCodexLensPip();
 
     // Try local path - codex-lens is local-only, not published to PyPI
     const codexLensPath = findLocalCodexLensPath();
@@ -1131,7 +1119,7 @@ async function executeCodexLens(args: string[], options: ExecuteOptions = {}): P
     // spawn's cwd option handles drive changes correctly on Windows
     const spawnArgs = ['-m', 'codexlens', ...args];
 
-    const child = spawn(VENV_PYTHON, spawnArgs, {
+    const child = spawn(getCodexLensPython(), spawnArgs, {
       cwd,
       shell: false, // CRITICAL: Prevent command injection
       timeout,
@@ -1674,7 +1662,7 @@ export async function handler(params: Record<string, unknown>): Promise<ToolResu
 async function uninstallCodexLens(): Promise<BootstrapResult> {
   try {
     // Check if venv exists
-    if (!existsSync(CODEXLENS_VENV)) {
+    if (!existsSync(getCodexLensVenvDir())) {
       return { success: false, error: 'CodexLens not installed (venv not found)' };
     }
 
@@ -1694,7 +1682,8 @@ async function uninstallCodexLens(): Promise<BootstrapResult> {
       await new Promise(resolve => setTimeout(resolve, 500));
     }
 
-    console.log(`[CodexLens] Removing directory: ${CODEXLENS_DATA_DIR}`);
+    const dataDir = getCodexLensDataDir();
+    console.log(`[CodexLens] Removing directory: ${dataDir}`);
 
     // Remove the entire .codexlens directory with retry logic for locked files
     const fs = await import('fs');
@@ -1729,7 +1718,7 @@ async function uninstallCodexLens(): Promise<BootstrapResult> {
       }
     };
 
-    await removeWithRetry(CODEXLENS_DATA_DIR);
+    await removeWithRetry(dataDir);
 
     // Reset bootstrap cache
     bootstrapChecked = false;
@@ -1827,7 +1816,7 @@ export {
 
 // Export Python path for direct spawn usage (e.g., watcher)
 export function getVenvPythonPath(): string {
-  return VENV_PYTHON;
+  return getCodexLensPython();
 }
 
 export type { GpuMode, PythonEnvInfo };

package/ccw/src/tools/litellm-client.ts

@@ -12,7 +12,7 @@
 import { spawn } from 'child_process';
 import { existsSync } from 'fs';
 import { join } from 'path';
-import { homedir } from 'os';
+import { getCodexLensPython, getCodexLensVenvDir } from '../utils/codexlens-path.js';
 
 export interface LiteLLMConfig {
   pythonPath?: string;  // Default: CodexLens venv Python
@@ -22,7 +22,7 @@ export interface LiteLLMConfig {
 
 // Platform-specific constants for CodexLens venv
 const IS_WINDOWS = process.platform === 'win32';
-const CODEXLENS_VENV = join(homedir(), '.codexlens', 'venv');
+const CODEXLENS_VENV = getCodexLensVenvDir();
 const VENV_BIN_DIR = IS_WINDOWS ? 'Scripts' : 'bin';
 const PYTHON_EXECUTABLE = IS_WINDOWS ? 'python.exe' : 'python';
 
@@ -40,6 +40,20 @@ export function getCodexLensVenvPython(): string {
   return 'python';
 }
 
+/**
+ * Get the Python path from CodexLens venv using centralized path utility
+ * Falls back to system 'python' if venv doesn't exist
+ * @returns Path to Python executable
+ */
+export function getCodexLensPythonPath(): string {
+  const codexLensPython = getCodexLensPython();
+  if (existsSync(codexLensPython)) {
+    return codexLensPython;
+  }
+  // Fallback to system Python if venv not available
+  return 'python';
+}
+
 export interface ChatMessage {
   role: 'system' | 'user' | 'assistant';
   content: string;

package/ccw/src/tools/loop-task-manager.ts

@@ -22,8 +22,19 @@ export interface LoopTask {
   /** Task description (what to do) */
   description: string;
 
-  /** CLI tool to use */
-  tool: 'bash' | 'gemini' | 'codex' | 'qwen' | 'claude';
+  /**
+   * CLI tool to use
+   *
+   * Should be one of the enabled tools from cli-tools.json:
+   * - 'bash' (always available)
+   * - Builtin tools: 'gemini', 'qwen', 'codex', 'claude', 'opencode'
+   * - CLI wrappers: 'doubao', etc. (if enabled)
+   * - API endpoints: custom tools (if enabled)
+   *
+   * Note: Validation is performed at the API layer (loop-v2-routes.ts)
+   * to ensure tool is enabled before saving.
+   */
+  tool: string;
 
   /** Execution mode */
   mode: 'analysis' | 'write' | 'review';

package/ccw/src/tools/native-session-discovery.ts

@@ -232,6 +232,19 @@ function encodeQwenProjectPath(projectDir: string): string {
     .replace(/_/g, '-');
 }
 
+/**
+ * Encode a path to Claude Code's project folder name format
+ * D:\Claude_dms3 -> D--Claude-dms3 (same as Qwen)
+ * Rules: : -> -, \ -> -, _ -> -
+ */
+function encodeClaudeProjectPath(projectDir: string): string {
+  const absolutePath = resolve(projectDir);
+  return absolutePath
+    .replace(/:/g, '-')
+    .replace(/\\/g, '-')
+    .replace(/_/g, '-');
+}
+
 /**
  * Qwen Session Discoverer
  * New path: ~/.qwen/projects/<path-encoded>/chats/<uuid>.jsonl
@@ -576,9 +589,10 @@ class ClaudeSessionDiscoverer extends SessionDiscoverer {
       // If workingDir provided, only look in that project's folder
       let projectDirs: string[];
       if (workingDir) {
-        const projectHash = calculateProjectHash(workingDir);
-        const projectPath = join(this.basePath, projectHash);
-        projectDirs = existsSync(projectPath) ? [projectHash] : [];
+        // Claude Code uses path encoding (D:\path -> D--path) not SHA256 hash
+        const encodedPath = encodeClaudeProjectPath(workingDir);
+        const projectPath = join(this.basePath, encodedPath);
+        projectDirs = existsSync(projectPath) ? [encodedPath] : [];
       } else {
         projectDirs = readdirSync(this.basePath).filter(d => {
           const fullPath = join(this.basePath, d);
@@ -652,6 +666,7 @@ class ClaudeSessionDiscoverer extends SessionDiscoverer {
   /**
    * Extract first user message from Claude Code session file (.jsonl)
    * Format: {"type":"user","message":{"role":"user","content":"..."},"isMeta":false,...}
+   * Content can be: string | array of {type,text} | array of {type,source} etc.
    */
   extractFirstUserMessage(filePath: string): string | null {
     try {
@@ -661,14 +676,30 @@ class ClaudeSessionDiscoverer extends SessionDiscoverer {
       for (const line of lines) {
         try {
           const entry = JSON.parse(line);
-          // Claude Code format: type="user", message.role="user", message.content="..."
+          // Claude Code format: type="user", message.role="user", message.content can be string or array
           // Skip meta messages and command messages
           if (entry.type === 'user' &&
               entry.message?.role === 'user' &&
               entry.message?.content &&
-              !entry.isMeta &&
-              !entry.message.content.startsWith('<command-')) {
-            return entry.message.content;
+              !entry.isMeta) {
+
+            const msgContent = entry.message.content;
+
+            // Handle string content (simple case)
+            if (typeof msgContent === 'string') {
+              if (!msgContent.startsWith('<command-') && !msgContent.includes('<local-command')) {
+                return msgContent;
+              }
+            }
+            // Handle array content (can contain text, image, tool_result, etc.)
+            else if (Array.isArray(msgContent)) {
+              for (const item of msgContent) {
+                // Look for text items
+                if (item.type === 'text' && item.text) {
+                  return item.text;
+                }
+              }
+            }
           }
         } catch { /* skip invalid lines */ }
       }

package/ccw/src/utils/codexlens-path.ts

@@ -0,0 +1,60 @@
+/**
+ * CodexLens Path Utilities
+ *
+ * Provides centralized path resolution for CodexLens data directory,
+ * respecting the CODEXLENS_DATA_DIR environment variable.
+ *
+ * Priority order (matching Python implementation):
+ * 1. CODEXLENS_DATA_DIR environment variable
+ * 2. Default: ~/.codexlens
+ */
+
+import { join } from 'path';
+import { homedir } from 'os';
+
+/**
+ * Get the CodexLens data directory.
+ * Respects CODEXLENS_DATA_DIR environment variable.
+ *
+ * @returns Path to CodexLens data directory
+ */
+export function getCodexLensDataDir(): string {
+  const envOverride = process.env.CODEXLENS_DATA_DIR;
+  if (envOverride) {
+    return envOverride;
+  }
+  return join(homedir(), '.codexlens');
+}
+
+/**
+ * Get the CodexLens virtual environment path.
+ *
+ * @returns Path to CodexLens venv directory
+ */
+export function getCodexLensVenvDir(): string {
+  return join(getCodexLensDataDir(), 'venv');
+}
+
+/**
+ * Get the Python executable path in the CodexLens venv.
+ *
+ * @returns Path to python executable
+ */
+export function getCodexLensPython(): string {
+  const venvDir = getCodexLensVenvDir();
+  return process.platform === 'win32'
+    ? join(venvDir, 'Scripts', 'python.exe')
+    : join(venvDir, 'bin', 'python');
+}
+
+/**
+ * Get the pip executable path in the CodexLens venv.
+ *
+ * @returns Path to pip executable
+ */
+export function getCodexLensPip(): string {
+  const venvDir = getCodexLensVenvDir();
+  return process.platform === 'win32'
+    ? join(venvDir, 'Scripts', 'pip.exe')
+    : join(venvDir, 'bin', 'pip');
+}

package/ccw/src/utils/uv-manager.ts

@@ -14,6 +14,7 @@ import { existsSync, mkdirSync } from 'fs';
 import { join, dirname } from 'path';
 import { homedir, platform, arch } from 'os';
 import { EXEC_TIMEOUTS } from './exec-constants.js';
+import { getCodexLensDataDir, getCodexLensVenvDir } from './codexlens-path.js';
 
 /**
  * Configuration for UvManager
@@ -767,9 +768,9 @@ export class UvManager {
  * @returns Configured UvManager instance
  */
 export function createCodexLensUvManager(dataDir?: string): UvManager {
-  const baseDir = dataDir ?? join(homedir(), '.codexlens');
+  const baseDir = dataDir ?? getCodexLensDataDir();
   return new UvManager({
-    venvPath: join(baseDir, 'venv'),
+    venvPath: getCodexLensVenvDir(),
     pythonVersion: '>=3.10,<3.13', // onnxruntime compatibility
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-workflow",
-  "version": "6.3.37",
+  "version": "6.3.39",
   "description": "JSON-driven multi-agent development framework with intelligent CLI orchestration (Gemini/Qwen/Codex), context-first architecture, and automated workflow execution",
   "type": "module",
   "main": "ccw/src/index.js",