@axiomatic-labs/claudeflow 2.12.86 → 2.12.87

package/lib/install.js

@@ -1,6 +1,6 @@
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const { execSync, execFileSync } = require('child_process');
 const { requireAuth } = require('./auth.js');
 const { getLatestRelease, downloadReleaseAsset } = require('./download.js');
 const { writeLocalVersion, readLocalVersion } = require('./version.js');
@@ -14,6 +14,7 @@ const TEMPLATE_MANAGED_MANIFEST = path.join('.claudeflow', 'config', 'template-m
 const CLAUDE_BACKUP_ROOT = '.claudeflow-backups';
 const REQUIRED_TEMPLATE_RULES = ['claudeflow-implementation.md'];
 const TEMPLATE_MANAGED_SETTINGS_KEYS = ['$schema', 'enabledMcpjsonServers', 'env', 'permissions', 'hooks'];
+const SERENA_REPO = 'git+https://github.com/oraios/serena';
 const TEMPLATE_SEEDED_SETTINGS_KEYS = new Set(['statusLine']);
 
 async function run() {
@@ -457,6 +458,11 @@ function installAnalysisTools() {
 
   // 3. Write MCP servers directly to .mcp.json (more reliable than claude mcp add)
   configureMcpServers(hasUv);
+
+  // 4. Prime Serena for the current project when possible.
+  if (hasUv) {
+    indexSerenaProject(process.cwd());
+  }
 }
 
 // Write Serena and context7 MCP configs directly to .mcp.json.
@@ -479,41 +485,40 @@ function configureMcpServers(hasUv) {
 
   // Serena MCP (requires uv)
   if (hasUv) {
-    if (mcpConfig.mcpServers.serena) {
-      ui.success('Serena MCP already configured');
-    } else {
-      ui.step('Adding Serena MCP for semantic code analysis...');
-      const uvBin = resolveUvBin();
-      mcpConfig.mcpServers.serena = {
-        type: 'stdio',
-        command: 'uvx',
-        args: [
-          '--python', '3.13',
-          '--from', 'git+https://github.com/oraios/serena',
-          'serena', 'start-mcp-server',
-          '--context', 'claude-code',
-          '--project', cwd,
-        ],
-      };
-      changed = true;
-      ui.success('Serena MCP configured');
-    }
-  }
-
-  // context7 MCP
-  if (mcpConfig.mcpServers.context7) {
-    ui.success('context7 MCP already configured');
-  } else {
-    ui.step('Adding context7 MCP for library documentation...');
-    mcpConfig.mcpServers.context7 = {
+    const serenaCommand = commandExists('uvx') ? 'uvx' : 'uv';
+    const serenaArgs = serenaCommand === 'uvx'
+      ? [
+        '--from', SERENA_REPO,
+        'serena', 'start-mcp-server',
+        '--context', 'claude-code',
+        '--project-from-cwd',
+      ]
+      : [
+        'run', '--with', SERENA_REPO,
+        'serena', 'start-mcp-server',
+        '--context', 'claude-code',
+        '--project-from-cwd',
+      ];
+    ui.step(mcpConfig.mcpServers.serena ? 'Refreshing Serena MCP configuration...' : 'Adding Serena MCP for semantic code analysis...');
+    mcpConfig.mcpServers.serena = {
       type: 'stdio',
-      command: 'npx',
-      args: ['-y', '@upstash/context7-mcp@latest'],
+      command: serenaCommand,
+      args: serenaArgs,
     };
     changed = true;
-    ui.success('context7 MCP configured');
+    ui.success('Serena MCP configured');
   }
 
+  // context7 MCP
+  ui.step(mcpConfig.mcpServers.context7 ? 'Refreshing context7 MCP configuration...' : 'Adding context7 MCP for library documentation...');
+  mcpConfig.mcpServers.context7 = {
+    type: 'stdio',
+    command: 'npx',
+    args: ['-y', '@upstash/context7-mcp@latest'],
+  };
+  changed = true;
+  ui.success('context7 MCP configured');
+
   // Write .mcp.json if anything changed
   if (changed) {
     try {
@@ -535,21 +540,41 @@ function commandExists(cmd) {
   }
 }
 
-// Resolve uv binary path — may be in PATH or in common install locations
-function resolveUvBin() {
-  if (commandExists('uv')) return 'uv';
-  const candidates = [
-    path.join(homedir(), '.local', 'bin', 'uv'),
-    path.join(homedir(), '.cargo', 'bin', 'uv'),
+function indexSerenaProject(projectRoot) {
+  ui.step('Indexing project for Serena...');
+  const statusPath = path.join(projectRoot, '.claudeflow', 'tmp', 'tooling', 'serena-status.json');
+  const attempts = [
+    { command: 'uvx', args: ['--from', SERENA_REPO, 'serena', 'project', 'index', projectRoot] },
+    { command: 'uv', args: ['run', '--with', SERENA_REPO, 'serena', 'project', 'index', projectRoot] },
   ];
-  for (const p of candidates) {
-    if (fs.existsSync(p)) return p;
+
+  let failureReason = 'uv/uvx not available';
+  let indexed = false;
+  for (const attempt of attempts) {
+    if (!commandExists(attempt.command)) continue;
+    try {
+      execFileSync(attempt.command, attempt.args, { cwd: projectRoot, stdio: 'pipe', timeout: 120000 });
+      indexed = true;
+      failureReason = null;
+      break;
+    } catch (error) {
+      failureReason = error.stderr ? String(error.stderr).trim() : error.message;
+    }
   }
-  return 'uv'; // fallback — let it fail with a clear error
-}
 
-function homedir() {
-  return require('os').homedir();
+  fs.mkdirSync(path.dirname(statusPath), { recursive: true });
+  fs.writeFileSync(statusPath, `${JSON.stringify({
+    configured: true,
+    indexed,
+    last_attempt_at: new Date().toISOString(),
+    failure_reason: failureReason,
+  }, null, 2)}\n`);
+
+  if (indexed) {
+    ui.success('Serena project index ready');
+  } else {
+    ui.warn('Serena indexing failed — semantic navigation may need a manual retry');
+  }
 }
 
 function createPreInstallBackup(projectRoot, options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiomatic-labs/claudeflow",
-  "version": "2.12.86",
+  "version": "2.12.87",
   "description": "Claudeflow — AI-powered development toolkit for Claude Code. Skills, agents, hooks, and quality gates that ship production apps.",
   "bin": {
     "claudeflow": "./bin/cli.js"