claude-code-workflow 6.3.37 → 6.3.39

package/ccw/src/commands/issue.ts

@@ -223,6 +223,10 @@ interface IssueOptions {
   data?: string;        // JSON data for create
   fromQueue?: boolean | string;  // Sync statuses from queue (true=active, string=specific queue ID)
   queue?: string;       // Target queue ID for multi-queue operations
+  // GitHub pull options
+  state?: string;       // Issue state: open, closed, all
+  limit?: number;       // Maximum number of issues to pull
+  labels?: string;      // Filter by labels (comma-separated)
 }
 
 const ISSUES_DIR = '.workflow/issues';
@@ -1003,6 +1007,113 @@ async function createAction(options: IssueOptions): Promise<void> {
   }
 }
 
+/**
+ * pull - Pull issues from GitHub
+ * Usage: ccw issue pull [--state open|closed|all] [--limit N] [--labels label1,label2]
+ */
+async function pullAction(options: IssueOptions): Promise<void> {
+  try {
+    // Check if gh CLI is available
+    try {
+      execSync('gh --version', { stdio: 'ignore', timeout: EXEC_TIMEOUTS.GIT_QUICK });
+    } catch {
+      console.error(chalk.red('GitHub CLI (gh) is not installed or not in PATH'));
+      console.error(chalk.gray('Install from: https://cli.github.com/'));
+      process.exit(1);
+    }
+
+    // Build gh command with options
+    const state = options.state || 'open';
+    const limit = options.limit || 100;
+    let ghCommand = `gh issue list --state ${state} --limit ${limit} --json number,title,body,labels,url,state`;
+
+    if (options.labels) {
+      ghCommand += ` --label "${options.labels}"`;
+    }
+
+    console.log(chalk.cyan(`Fetching issues from GitHub (state: ${state}, limit: ${limit})...`));
+
+    // Fetch issues from GitHub
+    const ghOutput = execSync(ghCommand, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: EXEC_TIMEOUTS.PROCESS_SPAWN,
+    }).trim();
+
+    if (!ghOutput) {
+      console.log(chalk.yellow('No issues found on GitHub'));
+      return;
+    }
+
+    const ghIssues = JSON.parse(ghOutput);
+    const existingIssues = readIssues();
+
+    let imported = 0;
+    let skipped = 0;
+    let updated = 0;
+
+    for (const ghIssue of ghIssues) {
+      const issueId = `GH-${ghIssue.number}`;
+      const existingIssue = existingIssues.find(i => i.id === issueId);
+
+      // Prepare issue data
+      const issueData: Partial<Issue> = {
+        id: issueId,
+        title: ghIssue.title,
+        status: ghIssue.state === 'OPEN' ? 'registered' : 'completed',
+        priority: 3, // Default priority
+        context: ghIssue.body?.substring(0, 500) || ghIssue.title,
+        source: 'github',
+        source_url: ghIssue.url,
+        tags: ghIssue.labels?.map((l: any) => l.name) || [],
+      };
+
+      if (existingIssue) {
+        // Update existing issue if state changed
+        if (existingIssue.source_url === ghIssue.url) {
+          // Check if status needs updating
+          const newStatus = ghIssue.state === 'OPEN' ? 'registered' : 'completed';
+          if (existingIssue.status !== newStatus || existingIssue.title !== ghIssue.title) {
+            existingIssue.title = ghIssue.title;
+            existingIssue.status = newStatus;
+            existingIssue.updated_at = new Date().toISOString();
+            updated++;
+          } else {
+            skipped++;
+          }
+        } else {
+          skipped++;
+        }
+      } else {
+        // Create new issue
+        try {
+          createIssue(issueData);
+          imported++;
+        } catch (err) {
+          console.error(chalk.red(`Failed to import issue #${ghIssue.number}: ${(err as Error).message}`));
+        }
+      }
+    }
+
+    // Save updates if any
+    if (updated > 0) {
+      writeIssues(existingIssues);
+    }
+
+    console.log(chalk.green(`\n✓ GitHub sync complete:`));
+    console.log(chalk.gray(`  - Imported: ${imported} new issues`));
+    console.log(chalk.gray(`  - Updated: ${updated} existing issues`));
+    console.log(chalk.gray(`  - Skipped: ${skipped} unchanged issues`));
+
+    if (options.json) {
+      console.log(JSON.stringify({ imported, updated, skipped, total: ghIssues.length }));
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed to pull issues from GitHub: ${(err as Error).message}`));
+    process.exit(1);
+  }
+}
+
 /**
  * solution - Create or read solutions
  * Create: ccw issue solution <issue-id> --data '{"tasks":[...]}'
@@ -2715,6 +2826,9 @@ export async function issueCommand(
     case 'create':
       await createAction(options);
       break;
+    case 'pull':
+      await pullAction(options);
+      break;
     case 'solution':
       await solutionAction(argsArray[0], options);
       break;
@@ -2769,6 +2883,8 @@ export async function issueCommand(
       console.log(chalk.bold.cyan('\nCCW Issue Management (v3.0 - Multi-Queue + Lifecycle)\n'));
       console.log(chalk.bold('Core Commands:'));
       console.log(chalk.gray('  create --data \'{"title":"..."}\'    Create issue (auto-generates ID)'));
+      console.log(chalk.gray('  pull [--state open|closed|all]     Pull issues from GitHub'));
+      console.log(chalk.gray('       [--limit N] [--labels label1,label2]'));
       console.log(chalk.gray('  init <issue-id>                    Initialize new issue (manual ID)'));
       console.log(chalk.gray('  list [issue-id]                    List issues or tasks'));
       console.log(chalk.gray('  history                            List completed issues (from history)'));
@@ -2809,6 +2925,9 @@ export async function issueCommand(
       console.log(chalk.gray('  --priority <n>                     Queue priority (lower = higher)'));
       console.log(chalk.gray('  --json                             JSON output'));
       console.log(chalk.gray('  --force                            Force operation'));
+      console.log(chalk.gray('  --state <state>                    GitHub issue state (open/closed/all)'));
+      console.log(chalk.gray('  --limit <n>                        Max issues to pull from GitHub'));
+      console.log(chalk.gray('  --labels <labels>                  Filter by GitHub labels (comma-separated)'));
       console.log();
       console.log(chalk.bold('Storage:'));
       console.log(chalk.gray('  .workflow/issues/issues.jsonl         Active issues'));

package/ccw/src/commands/upgrade.ts

@@ -124,7 +124,7 @@ export async function upgradeCommand(options: UpgradeOptions): Promise<void> {
     info('All installations are up to date.');
     console.log('');
     info('To upgrade ccw itself, run:');
-    console.log(chalk.cyan('  npm update -g ccw'));
+    console.log(chalk.cyan('  npm update -g claude-code-workflow'));
     console.log('');
     return;
   }

package/ccw/src/config/litellm-api-config-manager.ts

@@ -4,9 +4,10 @@
  */
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from 'fs';
-import { homedir } from 'os';
 import { join } from 'path';
+import { homedir } from 'os';
 import { StoragePaths, GlobalPaths, ensureStorageDir } from './storage-paths.js';
+import { getCodexLensDataDir } from '../utils/codexlens-path.js';
 import type {
   LiteLLMApiConfig,
   ProviderCredential,
@@ -798,7 +799,7 @@ export function syncCodexLensConfig(baseDir: string): { success: boolean; messag
     const rotationConfig = config.codexlensEmbeddingRotation;
 
     // Get CodexLens settings path
-    const codexlensDir = join(homedir(), '.codexlens');
+    const codexlensDir = getCodexLensDataDir();
     const settingsPath = join(codexlensDir, 'settings.json');
 
     // Ensure directory exists

package/ccw/src/core/memory-embedder-bridge.ts

@@ -13,20 +13,16 @@
 
 import { spawn } from 'child_process';
 import { join, dirname } from 'path';
-import { homedir } from 'os';
 import { existsSync } from 'fs';
 import { fileURLToPath } from 'url';
+import { getCodexLensPython } from '../utils/codexlens-path.js';
 
 // Get directory of this module
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 // Venv paths (reuse CodexLens venv)
-const CODEXLENS_VENV = join(homedir(), '.codexlens', 'venv');
-const VENV_PYTHON =
-  process.platform === 'win32'
-    ? join(CODEXLENS_VENV, 'Scripts', 'python.exe')
-    : join(CODEXLENS_VENV, 'bin', 'python');
+const VENV_PYTHON = getCodexLensPython();
 
 // Script path
 const EMBEDDER_SCRIPT = join(__dirname, '..', '..', 'scripts', 'memory_embedder.py');

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

@@ -302,7 +302,7 @@ export async function handleCliRoutes(ctx: RouteContext): Promise<boolean> {
     if (req.method === 'PUT') {
       handlePostRequest(req, res, async (body: unknown) => {
         try {
-          const updates = body as { enabled?: boolean; primaryModel?: string; secondaryModel?: string; tags?: string[] };
+          const updates = body as { enabled?: boolean; primaryModel?: string; secondaryModel?: string; tags?: string[]; envFile?: string | null };
           const updated = updateToolConfig(initialPath, tool, updates);
 
           // Broadcast config updated event

package/ccw/src/core/routes/codexlens/config-handlers.ts

@@ -16,6 +16,7 @@ import type { RouteContext } from '../types.js';
 import { EXEC_TIMEOUTS } from '../../../utils/exec-constants.js';
 import { extractJSON } from './utils.js';
 import { stopWatcherForUninstall } from './watcher-handlers.js';
+import { getCodexLensDataDir } from '../../../utils/codexlens-path.js';
 
 export async function handleCodexLensConfigRoutes(ctx: RouteContext): Promise<boolean> {
   const { pathname, url, req, res, initialPath, handlePostRequest, broadcastToClients } = ctx;
@@ -777,7 +778,7 @@ export async function handleCodexLensConfigRoutes(ctx: RouteContext): Promise<bo
       const { join } = await import('path');
       const { readFile } = await import('fs/promises');
 
-      const envPath = join(homedir(), '.codexlens', '.env');
+      const envPath = join(getCodexLensDataDir(), '.env');
       let content = '';
       try {
         content = await readFile(envPath, 'utf-8');
@@ -829,7 +830,7 @@ export async function handleCodexLensConfigRoutes(ctx: RouteContext): Promise<bo
       }
 
       // Also read settings.json for current configuration
-      const settingsPath = join(homedir(), '.codexlens', 'settings.json');
+      const settingsPath = join(getCodexLensDataDir(), 'settings.json');
       let settings: Record<string, any> = {};
       try {
         const settingsContent = await readFile(settingsPath, 'utf-8');
@@ -943,7 +944,7 @@ export async function handleCodexLensConfigRoutes(ctx: RouteContext): Promise<bo
         const { join, dirname } = await import('path');
         const { writeFile, mkdir, readFile } = await import('fs/promises');
 
-        const envPath = join(homedir(), '.codexlens', '.env');
+        const envPath = join(getCodexLensDataDir(), '.env');
         await mkdir(dirname(envPath), { recursive: true });
 
         // Read existing env file to preserve custom variables
@@ -1072,7 +1073,7 @@ export async function handleCodexLensConfigRoutes(ctx: RouteContext): Promise<bo
         await writeFile(envPath, lines.join('\n'), 'utf-8');
 
         // Also update settings.json with mapped values
-        const settingsPath = join(homedir(), '.codexlens', 'settings.json');
+        const settingsPath = join(getCodexLensDataDir(), 'settings.json');
         let settings: Record<string, any> = {};
         try {
           const settingsContent = await readFile(settingsPath, 'utf-8');
@@ -1145,7 +1146,7 @@ export async function handleCodexLensConfigRoutes(ctx: RouteContext): Promise<bo
       const { join } = await import('path');
       const { readFile } = await import('fs/promises');
 
-      const settingsPath = join(homedir(), '.codexlens', 'settings.json');
+      const settingsPath = join(getCodexLensDataDir(), 'settings.json');
       let settings: Record<string, any> = {};
       try {
         const content = await readFile(settingsPath, 'utf-8');
@@ -1214,7 +1215,7 @@ export async function handleCodexLensConfigRoutes(ctx: RouteContext): Promise<bo
         const { join, dirname } = await import('path');
         const { writeFile, mkdir, readFile } = await import('fs/promises');
 
-        const settingsPath = join(homedir(), '.codexlens', 'settings.json');
+        const settingsPath = join(getCodexLensDataDir(), 'settings.json');
         await mkdir(dirname(settingsPath), { recursive: true });
 
         // Read existing settings

package/ccw/src/core/routes/codexlens/semantic-handlers.ts

@@ -17,6 +17,7 @@ import {
 import type { RouteContext } from '../types.js';
 import { extractJSON } from './utils.js';
 import { getDefaultTool } from '../../../tools/claude-cli-tools.js';
+import { getCodexLensDataDir } from '../../../utils/codexlens-path.js';
 
 export async function handleCodexLensSemanticRoutes(ctx: RouteContext): Promise<boolean> {
   const { pathname, url, req, res, initialPath, handlePostRequest } = ctx;
@@ -445,9 +446,8 @@ export async function handleCodexLensSemanticRoutes(ctx: RouteContext): Promise<
             // Write to CodexLens .env file for persistence
             const { writeFileSync, existsSync, readFileSync } = await import('fs');
             const { join } = await import('path');
-            const { homedir } = await import('os');
 
-            const codexlensDir = join(homedir(), '.codexlens');
+            const codexlensDir = getCodexLensDataDir();
             const envFile = join(codexlensDir, '.env');
 
             // Read existing .env content

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

@@ -2,13 +2,29 @@
  * Graph Routes Module
  * Handles graph visualization API endpoints for codex-lens data
  */
-import { homedir } from 'os';
 import { join, resolve, normalize } from 'path';
 import { existsSync, readdirSync } from 'fs';
 import Database from 'better-sqlite3';
 import { validatePath as validateAllowedPath } from '../../utils/path-validator.js';
 import type { RouteContext } from './types.js';
 
+/**
+ * Get the index root directory from CodexLens config or default.
+ * Matches Python implementation priority:
+ * 1. CODEXLENS_INDEX_DIR environment variable
+ * 2. index_dir from ~/.codexlens/config.json
+ * 3. Default: ~/.codexlens/indexes
+ */
+function getIndexRoot(): string {
+  const envOverride = process.env.CODEXLENS_INDEX_DIR;
+  if (envOverride) {
+    return envOverride;
+  }
+  // Default: use CodexLens data directory + indexes
+  const { getCodexLensDataDir } = require('../../utils/codexlens-path.js');
+  return join(getCodexLensDataDir(), 'indexes');
+}
+
 /**
  * PathMapper utility class (simplified from codex-lens Python implementation)
  * Maps source paths to index database paths
@@ -17,7 +33,7 @@ class PathMapper {
   private indexRoot: string;
 
   constructor(indexRoot?: string) {
-    this.indexRoot = indexRoot || join(homedir(), '.codexlens', 'indexes');
+    this.indexRoot = indexRoot || getIndexRoot();
   }
 
   /**