claude-code-workflow 6.3.24 → 6.3.26

package/ccw/dist/tools/memory-update-queue.js

@@ -0,0 +1,431 @@
+/**
+ * Memory Update Queue Tool
+ * Queue mechanism for batching CLAUDE.md updates
+ *
+ * Configuration:
+ * - Threshold: 5 paths trigger update
+ * - Timeout: 5 minutes auto-trigger
+ * - Storage: ~/.claude/.memory-queue.json
+ * - Deduplication: Same path only kept once
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join, dirname, resolve } from 'path';
+import { homedir } from 'os';
+// Default configuration
+const DEFAULT_THRESHOLD = 5;
+const DEFAULT_TIMEOUT_SECONDS = 300; // 5 minutes
+const QUEUE_FILE_PATH = join(homedir(), '.claude', '.memory-queue.json');
+/**
+ * Get queue configuration (from file or defaults)
+ * @returns {{ threshold: number, timeoutMs: number }}
+ */
+function getQueueConfig() {
+    try {
+        if (existsSync(QUEUE_FILE_PATH)) {
+            const content = readFileSync(QUEUE_FILE_PATH, 'utf8');
+            const data = JSON.parse(content);
+            return {
+                threshold: data.config?.threshold || DEFAULT_THRESHOLD,
+                timeoutMs: (data.config?.timeout || DEFAULT_TIMEOUT_SECONDS) * 1000
+            };
+        }
+    }
+    catch (e) {
+        // Use defaults
+    }
+    return {
+        threshold: DEFAULT_THRESHOLD,
+        timeoutMs: DEFAULT_TIMEOUT_SECONDS * 1000
+    };
+}
+// In-memory timeout reference (for cross-call persistence, we track via file timestamp)
+let scheduledTimeoutId = null;
+/**
+ * Ensure parent directory exists
+ */
+function ensureDir(filePath) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Load queue from file
+ * @returns {{ items: Array<{path: string, tool: string, strategy: string, addedAt: string}>, createdAt: string | null, config?: { threshold: number, timeout: number } }}
+ */
+function loadQueue() {
+    try {
+        if (existsSync(QUEUE_FILE_PATH)) {
+            const content = readFileSync(QUEUE_FILE_PATH, 'utf8');
+            const data = JSON.parse(content);
+            return {
+                items: Array.isArray(data.items) ? data.items : [],
+                createdAt: data.createdAt || null,
+                config: data.config || null
+            };
+        }
+    }
+    catch (e) {
+        console.error('[MemoryQueue] Failed to load queue:', e.message);
+    }
+    return { items: [], createdAt: null, config: null };
+}
+/**
+ * Save queue to file
+ * @param {{ items: Array<{path: string, tool: string, strategy: string, addedAt: string}>, createdAt: string | null }} data
+ */
+function saveQueue(data) {
+    try {
+        ensureDir(QUEUE_FILE_PATH);
+        writeFileSync(QUEUE_FILE_PATH, JSON.stringify(data, null, 2), 'utf8');
+    }
+    catch (e) {
+        console.error('[MemoryQueue] Failed to save queue:', e.message);
+        throw e;
+    }
+}
+/**
+ * Normalize path for comparison (handle Windows/Unix differences)
+ * @param {string} p
+ * @returns {string}
+ */
+function normalizePath(p) {
+    return resolve(p).replace(/\\/g, '/').toLowerCase();
+}
+/**
+ * Add path to queue with deduplication
+ * @param {string} path - Module path to update
+ * @param {{ tool?: string, strategy?: string }} options
+ * @returns {{ queued: boolean, queueSize: number, willFlush: boolean, message: string }}
+ */
+function addToQueue(path, options = {}) {
+    const { tool = 'gemini', strategy = 'single-layer' } = options;
+    const queue = loadQueue();
+    const config = getQueueConfig();
+    const normalizedPath = normalizePath(path);
+    const now = new Date().toISOString();
+    // Check for duplicates
+    const existingIndex = queue.items.findIndex(item => normalizePath(item.path) === normalizedPath);
+    if (existingIndex !== -1) {
+        // Update existing entry timestamp but keep it deduplicated
+        queue.items[existingIndex].addedAt = now;
+        queue.items[existingIndex].tool = tool;
+        queue.items[existingIndex].strategy = strategy;
+        saveQueue(queue);
+        return {
+            queued: false,
+            queueSize: queue.items.length,
+            willFlush: queue.items.length >= config.threshold,
+            message: `Path already in queue (updated): ${path}`
+        };
+    }
+    // Add new item
+    queue.items.push({
+        path,
+        tool,
+        strategy,
+        addedAt: now
+    });
+    // Set createdAt if this is the first item
+    if (!queue.createdAt) {
+        queue.createdAt = now;
+    }
+    saveQueue(queue);
+    const willFlush = queue.items.length >= config.threshold;
+    // Schedule timeout if not already scheduled
+    scheduleTimeout();
+    return {
+        queued: true,
+        queueSize: queue.items.length,
+        willFlush,
+        message: willFlush
+            ? `Queue threshold reached (${queue.items.length}/${config.threshold}), will flush`
+            : `Added to queue (${queue.items.length}/${config.threshold})`
+    };
+}
+/**
+ * Get current queue status
+ * @returns {{ queueSize: number, threshold: number, items: Array, timeoutMs: number | null, createdAt: string | null }}
+ */
+function getQueueStatus() {
+    const queue = loadQueue();
+    const config = getQueueConfig();
+    let timeUntilTimeout = null;
+    if (queue.createdAt && queue.items.length > 0) {
+        const createdTime = new Date(queue.createdAt).getTime();
+        const elapsed = Date.now() - createdTime;
+        timeUntilTimeout = Math.max(0, config.timeoutMs - elapsed);
+    }
+    return {
+        queueSize: queue.items.length,
+        threshold: config.threshold,
+        items: queue.items,
+        timeoutMs: config.timeoutMs,
+        timeoutSeconds: config.timeoutMs / 1000,
+        timeUntilTimeout,
+        createdAt: queue.createdAt
+    };
+}
+/**
+ * Configure queue settings
+ * @param {{ threshold?: number, timeout?: number }} settings
+ * @returns {{ success: boolean, config: { threshold: number, timeout: number } }}
+ */
+function configureQueue(settings) {
+    const queue = loadQueue();
+    const currentConfig = getQueueConfig();
+    const newConfig = {
+        threshold: settings.threshold || currentConfig.threshold,
+        timeout: settings.timeout || (currentConfig.timeoutMs / 1000)
+    };
+    // Validate
+    if (newConfig.threshold < 1 || newConfig.threshold > 20) {
+        throw new Error('Threshold must be between 1 and 20');
+    }
+    if (newConfig.timeout < 60 || newConfig.timeout > 1800) {
+        throw new Error('Timeout must be between 60 and 1800 seconds');
+    }
+    queue.config = newConfig;
+    saveQueue(queue);
+    return {
+        success: true,
+        config: newConfig,
+        message: `Queue configured: threshold=${newConfig.threshold}, timeout=${newConfig.timeout}s`
+    };
+}
+/**
+ * Flush queue - execute batch update
+ * @returns {Promise<{ success: boolean, processed: number, results: Array, errors: Array }>}
+ */
+async function flushQueue() {
+    const queue = loadQueue();
+    if (queue.items.length === 0) {
+        return {
+            success: true,
+            processed: 0,
+            results: [],
+            errors: [],
+            message: 'Queue is empty'
+        };
+    }
+    // Clear timeout
+    clearScheduledTimeout();
+    // Import update_module_claude dynamically to avoid circular deps
+    const { updateModuleClaudeTool } = await import('./update-module-claude.js');
+    const results = [];
+    const errors = [];
+    // Group by tool and strategy for efficiency
+    const groups = new Map();
+    for (const item of queue.items) {
+        const key = `${item.tool}:${item.strategy}`;
+        if (!groups.has(key)) {
+            groups.set(key, []);
+        }
+        groups.get(key).push(item);
+    }
+    // Process each group
+    for (const [key, items] of groups) {
+        const [tool, strategy] = key.split(':');
+        console.log(`[MemoryQueue] Processing ${items.length} items with ${tool}/${strategy}`);
+        for (const item of items) {
+            try {
+                const result = await updateModuleClaudeTool.execute({
+                    path: item.path,
+                    tool: item.tool,
+                    strategy: item.strategy
+                });
+                results.push({
+                    path: item.path,
+                    success: result.success !== false,
+                    result
+                });
+            }
+            catch (e) {
+                console.error(`[MemoryQueue] Failed to update ${item.path}:`, e.message);
+                errors.push({
+                    path: item.path,
+                    error: e.message
+                });
+            }
+        }
+    }
+    // Clear queue after processing
+    saveQueue({ items: [], createdAt: null });
+    return {
+        success: errors.length === 0,
+        processed: queue.items.length,
+        results,
+        errors,
+        message: `Processed ${results.length} items, ${errors.length} errors`
+    };
+}
+/**
+ * Schedule timeout for auto-flush
+ */
+function scheduleTimeout() {
+    // We use file-based timeout tracking for persistence across process restarts
+    // The actual timeout check happens on next add/status call
+    const queue = loadQueue();
+    const config = getQueueConfig();
+    if (!queue.createdAt || queue.items.length === 0) {
+        return;
+    }
+    const createdTime = new Date(queue.createdAt).getTime();
+    const elapsed = Date.now() - createdTime;
+    if (elapsed >= config.timeoutMs) {
+        // Timeout already exceeded, should flush
+        console.log('[MemoryQueue] Timeout exceeded, auto-flushing');
+        // Don't await here to avoid blocking
+        flushQueue().catch(e => {
+            console.error('[MemoryQueue] Auto-flush failed:', e.message);
+        });
+    }
+    else if (!scheduledTimeoutId) {
+        // Schedule in-memory timeout for current process
+        const remaining = config.timeoutMs - elapsed;
+        scheduledTimeoutId = setTimeout(() => {
+            scheduledTimeoutId = null;
+            const currentQueue = loadQueue();
+            if (currentQueue.items.length > 0) {
+                console.log('[MemoryQueue] Timeout reached, auto-flushing');
+                flushQueue().catch(e => {
+                    console.error('[MemoryQueue] Auto-flush failed:', e.message);
+                });
+            }
+        }, remaining);
+        // Prevent timeout from keeping process alive
+        if (scheduledTimeoutId.unref) {
+            scheduledTimeoutId.unref();
+        }
+    }
+}
+/**
+ * Clear scheduled timeout
+ */
+function clearScheduledTimeout() {
+    if (scheduledTimeoutId) {
+        clearTimeout(scheduledTimeoutId);
+        scheduledTimeoutId = null;
+    }
+}
+/**
+ * Check if timeout has expired and auto-flush if needed
+ * @returns {Promise<{ expired: boolean, flushed: boolean, result?: object }>}
+ */
+async function checkTimeout() {
+    const queue = loadQueue();
+    const config = getQueueConfig();
+    if (!queue.createdAt || queue.items.length === 0) {
+        return { expired: false, flushed: false };
+    }
+    const createdTime = new Date(queue.createdAt).getTime();
+    const elapsed = Date.now() - createdTime;
+    if (elapsed >= config.timeoutMs) {
+        console.log('[MemoryQueue] Timeout expired, triggering flush');
+        const result = await flushQueue();
+        return { expired: true, flushed: true, result };
+    }
+    return { expired: false, flushed: false };
+}
+/**
+ * Main execute function for tool interface
+ * @param {Record<string, unknown>} params
+ * @returns {Promise<unknown>}
+ */
+async function execute(params) {
+    const { action, path, tool = 'gemini', strategy = 'single-layer', threshold, timeout } = params;
+    switch (action) {
+        case 'add':
+            if (!path) {
+                throw new Error('Parameter "path" is required for add action');
+            }
+            // Check timeout first
+            const timeoutCheck = await checkTimeout();
+            if (timeoutCheck.flushed) {
+                // Queue was flushed due to timeout, add to fresh queue
+                const result = addToQueue(path, { tool, strategy });
+                return {
+                    ...result,
+                    timeoutFlushed: true,
+                    flushResult: timeoutCheck.result
+                };
+            }
+            const addResult = addToQueue(path, { tool, strategy });
+            // Auto-flush if threshold reached
+            if (addResult.willFlush) {
+                const flushResult = await flushQueue();
+                return {
+                    ...addResult,
+                    flushed: true,
+                    flushResult
+                };
+            }
+            return addResult;
+        case 'status':
+            // Check timeout first
+            await checkTimeout();
+            return getQueueStatus();
+        case 'flush':
+            return await flushQueue();
+        case 'configure':
+            return configureQueue({ threshold, timeout });
+        default:
+            throw new Error(`Unknown action: ${action}. Valid actions: add, status, flush, configure`);
+    }
+}
+/**
+ * Tool Definition
+ */
+export const memoryQueueTool = {
+    name: 'memory_queue',
+    description: `Memory update queue management. Batches CLAUDE.md updates for efficiency.
+
+Actions:
+- add: Add path to queue (auto-flushes at configured threshold/timeout)
+- status: Get queue status and configuration
+- flush: Immediately execute all queued updates
+- configure: Set threshold and timeout settings`,
+    parameters: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: ['add', 'status', 'flush', 'configure'],
+                description: 'Queue action to perform'
+            },
+            path: {
+                type: 'string',
+                description: 'Module directory path (required for add action)'
+            },
+            threshold: {
+                type: 'number',
+                description: 'Number of paths to trigger flush (1-20, for configure action)',
+                minimum: 1,
+                maximum: 20
+            },
+            timeout: {
+                type: 'number',
+                description: 'Timeout in seconds to trigger flush (60-1800, for configure action)',
+                minimum: 60,
+                maximum: 1800
+            },
+            tool: {
+                type: 'string',
+                enum: ['gemini', 'qwen', 'codex'],
+                description: 'CLI tool to use (default: gemini)',
+                default: 'gemini'
+            },
+            strategy: {
+                type: 'string',
+                enum: ['single-layer', 'multi-layer'],
+                description: 'Update strategy (default: single-layer)',
+                default: 'single-layer'
+            }
+        },
+        required: ['action']
+    },
+    execute
+};
+// Export individual functions for direct use
+export { loadQueue, saveQueue, addToQueue, getQueueStatus, flushQueue, configureQueue, scheduleTimeout, clearScheduledTimeout, checkTimeout, DEFAULT_THRESHOLD, DEFAULT_TIMEOUT_SECONDS, QUEUE_FILE_PATH };
+//# sourceMappingURL=memory-update-queue.js.map

package/ccw/dist/tools/memory-update-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-update-queue.js","sourceRoot":"","sources":["../../src/tools/memory-update-queue.js"],"names":[],"mappings":"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"}

package/ccw/src/core/routes/help-routes.ts

@@ -7,6 +7,29 @@ import { join } from 'path';
 import { homedir } from 'os';
 import type { RouteContext } from './types.js';
 
+/**
+ * Get the ccw-help index directory path (pure function)
+ * Priority: project path (.claude/skills/ccw-help/index) > user path (~/.claude/skills/ccw-help/index)
+ * @param projectPath - The project path to check first
+ */
+function getIndexDir(projectPath: string | null): string | null {
+  // Try project path first
+  if (projectPath) {
+    const projectIndexDir = join(projectPath, '.claude', 'skills', 'ccw-help', 'index');
+    if (existsSync(projectIndexDir)) {
+      return projectIndexDir;
+    }
+  }
+
+  // Fall back to user path
+  const userIndexDir = join(homedir(), '.claude', 'skills', 'ccw-help', 'index');
+  if (existsSync(userIndexDir)) {
+    return userIndexDir;
+  }
+
+  return null;
+}
+
 // ========== In-Memory Cache ==========
 interface CacheEntry {
   data: any;
@@ -61,14 +84,15 @@ let watchersInitialized = false;
 
 /**
  * Initialize file watchers for JSON indexes
+ * @param projectPath - The project path to resolve index directory
  */
-function initializeFileWatchers(): void {
+function initializeFileWatchers(projectPath: string | null): void {
   if (watchersInitialized) return;
 
-  const indexDir = join(homedir(), '.claude', 'skills', 'command-guide', 'index');
+  const indexDir = getIndexDir(projectPath);
 
-  if (!existsSync(indexDir)) {
-    console.warn(`Command guide index directory not found: ${indexDir}`);
+  if (!indexDir) {
+    console.warn(`ccw-help index directory not found in project or user paths`);
     return;
   }
 
@@ -152,15 +176,20 @@ function groupCommandsByCategory(commands: any[]): any {
  * @returns true if route was handled, false otherwise
  */
 export async function handleHelpRoutes(ctx: RouteContext): Promise<boolean> {
-  const { pathname, url, req, res } = ctx;
+  const { pathname, url, req, res, initialPath } = ctx;
 
   // Initialize file watchers on first request
-  initializeFileWatchers();
+  initializeFileWatchers(initialPath);
 
-  const indexDir = join(homedir(), '.claude', 'skills', 'command-guide', 'index');
+  const indexDir = getIndexDir(initialPath);
 
   // API: Get all commands with optional search
   if (pathname === '/api/help/commands') {
+    if (!indexDir) {
+      res.writeHead(404, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: 'ccw-help index directory not found' }));
+      return true;
+    }
     const searchQuery = url.searchParams.get('q') || '';
     const filePath = join(indexDir, 'all-commands.json');
 
@@ -191,6 +220,11 @@ export async function handleHelpRoutes(ctx: RouteContext): Promise<boolean> {
 
   // API: Get workflow command relationships
   if (pathname === '/api/help/workflows') {
+    if (!indexDir) {
+      res.writeHead(404, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: 'ccw-help index directory not found' }));
+      return true;
+    }
     const filePath = join(indexDir, 'command-relationships.json');
     const relationships = getCachedData('command-relationships', filePath);
 
@@ -207,6 +241,11 @@ export async function handleHelpRoutes(ctx: RouteContext): Promise<boolean> {
 
   // API: Get commands by category
   if (pathname === '/api/help/commands/by-category') {
+    if (!indexDir) {
+      res.writeHead(404, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: 'ccw-help index directory not found' }));
+      return true;
+    }
     const filePath = join(indexDir, 'by-category.json');
     const byCategory = getCachedData('by-category', filePath);
 

package/ccw/src/core/routes/litellm-api-routes.ts

@@ -334,12 +334,43 @@ export async function handleLiteLLMApiRoutes(ctx: RouteContext): Promise<boolean
         return true;
       }
 
-      // Test connection using litellm client
-      const client = getLiteLLMClient();
-      const available = await client.isAvailable();
+      // Get the API key to test (prefer first key from apiKeys array, fall back to default apiKey)
+      let apiKeyValue: string | null = null;
+      if (provider.apiKeys && provider.apiKeys.length > 0) {
+        apiKeyValue = provider.apiKeys[0].key;
+      } else if (provider.apiKey) {
+        apiKeyValue = provider.apiKey;
+      }
+
+      if (!apiKeyValue) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ success: false, error: 'No API key configured for this provider' }));
+        return true;
+      }
+
+      // Resolve environment variables in the API key
+      const { resolveEnvVar } = await import('../../config/litellm-api-config-manager.js');
+      const resolvedKey = resolveEnvVar(apiKeyValue);
+
+      if (!resolvedKey) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ success: false, error: 'API key is empty or environment variable not set' }));
+        return true;
+      }
+
+      // Determine API base URL
+      const apiBase = provider.apiBase || getDefaultApiBase(provider.type);
+
+      // Test the API key connection
+      const testResult = await testApiKeyConnection(provider.type, apiBase, resolvedKey);
 
       res.writeHead(200, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({ success: available, provider: provider.type }));
+      res.end(JSON.stringify({
+        success: testResult.valid,
+        provider: provider.type,
+        latencyMs: testResult.latencyMs,
+        error: testResult.error,
+      }));
     } catch (err) {
       res.writeHead(500, { 'Content-Type': 'application/json' });
       res.end(JSON.stringify({ success: false, error: (err as Error).message }));

package/ccw/src/core/routes/memory-routes.ts

@@ -1256,5 +1256,89 @@ RULES: Be concise. Focus on practical understanding. Include function signatures
     return true;
   }
 
+  // API: Memory Queue - Add path to queue
+  if (pathname === '/api/memory/queue/add' && req.method === 'POST') {
+    handlePostRequest(req, res, async (body) => {
+      const { path: modulePath, tool = 'gemini', strategy = 'single-layer' } = body;
+
+      if (!modulePath) {
+        return { error: 'path is required', status: 400 };
+      }
+
+      try {
+        const { memoryQueueTool } = await import('../../tools/memory-update-queue.js');
+        const result = await memoryQueueTool.execute({
+          action: 'add',
+          path: modulePath,
+          tool,
+          strategy
+        }) as { queueSize?: number; willFlush?: boolean; flushed?: boolean };
+
+        // Broadcast queue update event
+        broadcastToClients({
+          type: 'MEMORY_QUEUE_UPDATED',
+          payload: {
+            action: 'add',
+            path: modulePath,
+            queueSize: result.queueSize || 0,
+            willFlush: result.willFlush || false,
+            flushed: result.flushed || false,
+            timestamp: new Date().toISOString()
+          }
+        });
+
+        return { success: true, ...result };
+      } catch (error: unknown) {
+        return { error: (error as Error).message, status: 500 };
+      }
+    });
+    return true;
+  }
+
+  // API: Memory Queue - Get queue status
+  if (pathname === '/api/memory/queue/status' && req.method === 'GET') {
+    try {
+      const { memoryQueueTool } = await import('../../tools/memory-update-queue.js');
+      const result = await memoryQueueTool.execute({ action: 'status' }) as Record<string, unknown>;
+
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ success: true, ...result }));
+    } catch (error: unknown) {
+      res.writeHead(500, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: (error as Error).message }));
+    }
+    return true;
+  }
+
+  // API: Memory Queue - Flush queue immediately
+  if (pathname === '/api/memory/queue/flush' && req.method === 'POST') {
+    handlePostRequest(req, res, async () => {
+      try {
+        const { memoryQueueTool } = await import('../../tools/memory-update-queue.js');
+        const result = await memoryQueueTool.execute({ action: 'flush' }) as {
+          processed?: number;
+          success?: boolean;
+          errors?: unknown[];
+        };
+
+        // Broadcast queue flushed event
+        broadcastToClients({
+          type: 'MEMORY_QUEUE_FLUSHED',
+          payload: {
+            processed: result.processed || 0,
+            success: result.success || false,
+            errors: result.errors?.length || 0,
+            timestamp: new Date().toISOString()
+          }
+        });
+
+        return { success: true, ...result };
+      } catch (error: unknown) {
+        return { error: (error as Error).message, status: 500 };
+      }
+    });
+    return true;
+  }
+
   return false;
 }