@axiomatic-labs/claudeflow 2.9.73 → 2.9.75

package/lib/install.js

@@ -52,11 +52,11 @@ async function run() {
   fs.writeFileSync(tmpZip, zipBuffer);
   fs.mkdirSync(tmpExtract, { recursive: true });
 
+  const cwd = process.cwd();
+
   try {
     ui.step('Extracting template files...');
     execSync(`unzip -o "${tmpZip}" -d "${tmpExtract}"`, { stdio: 'pipe' });
-
-    const cwd = process.cwd();
     const srcClaude = path.join(tmpExtract, '.claude');
 
     // Copy settings.json
@@ -116,8 +116,10 @@ async function run() {
     fs.rmSync(tmpExtract, { recursive: true, force: true });
   }
 
+  // Install analysis tools (ast-grep + Serena MCP)
+  installAnalysisTools();
+
   // Count installed items
-  const cwd = process.cwd();
   const skillsDir = path.join(cwd, '.claude', 'skills');
   let skillCount = 0;
   try {
@@ -216,6 +218,137 @@ function showGettingStarted(cwd) {
   console.log('');
 }
 
+// Install ast-grep CLI, uv, and Serena MCP for enhanced code analysis.
+// All steps are best-effort — failures warn but never block the install.
+function installAnalysisTools() {
+  console.log('');
+  ui.step('Setting up analysis tools...');
+
+  // 1. ast-grep CLI
+  const hasAstGrep = commandExists('sg');
+  if (hasAstGrep) {
+    ui.success('ast-grep CLI already installed');
+  } else {
+    ui.step('Installing ast-grep CLI...');
+    try {
+      execSync('npm install -g @ast-grep/cli', { stdio: 'pipe', timeout: 60000 });
+      ui.success('ast-grep CLI installed');
+    } catch {
+      ui.warn('ast-grep install failed — code exploration will use Grep fallback');
+    }
+  }
+
+  // 2. uv (required by Serena)
+  let hasUv = commandExists('uv');
+  if (hasUv) {
+    ui.success('uv already installed');
+  } else {
+    ui.step('Installing uv (Python package manager)...');
+    try {
+      if (process.platform === 'win32') {
+        execSync('powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"', {
+          stdio: 'pipe',
+          timeout: 60000,
+        });
+      } else {
+        execSync('curl -LsSf https://astral.sh/uv/install.sh | sh', {
+          stdio: 'pipe',
+          timeout: 60000,
+        });
+      }
+      // uv installs to ~/.local/bin or ~/.cargo/bin — check both
+      hasUv = commandExists('uv') || commandExists(path.join(homedir(), '.local', 'bin', 'uv'));
+      if (hasUv) {
+        ui.success('uv installed');
+      } else {
+        ui.warn('uv installed but not in PATH — restart your terminal before running init/update');
+      }
+    } catch {
+      ui.warn('uv install failed — Serena MCP will not be available');
+    }
+  }
+
+  // 3. Serena MCP
+  if (hasUv) {
+    let serenaConfigured = false;
+    try {
+      const mcpList = execSync('claude mcp list', { stdio: 'pipe', encoding: 'utf8', timeout: 10000 });
+      serenaConfigured = mcpList.includes('serena');
+    } catch {
+      // claude CLI not available or mcp list failed — skip Serena
+      ui.warn('Could not check MCP servers — Serena setup skipped');
+      return;
+    }
+
+    if (serenaConfigured) {
+      ui.success('Serena MCP already configured');
+    } else {
+      ui.step('Adding Serena MCP for semantic code analysis...');
+      try {
+        const projectPath = process.cwd();
+        const uvBin = resolveUvBin();
+        execSync(
+          `claude mcp add serena -- ${uvBin} -p 3.13 --from git+https://github.com/oraios/serena serena start-mcp-server --context claude-code --project "${projectPath}"`,
+          { stdio: 'pipe', timeout: 30000 }
+        );
+        ui.success('Serena MCP configured');
+      } catch {
+        ui.warn('Serena MCP setup failed — code exploration will use Grep fallback');
+      }
+    }
+  }
+
+  // 4. context7 MCP (library documentation for research)
+  let context7Configured = false;
+  try {
+    const mcpList = execSync('claude mcp list', { stdio: 'pipe', encoding: 'utf8', timeout: 10000 });
+    context7Configured = mcpList.includes('context7');
+  } catch {}
+
+  if (context7Configured) {
+    ui.success('context7 MCP already configured');
+  } else {
+    ui.step('Adding context7 MCP for library documentation...');
+    try {
+      execSync('claude mcp add context7 -- npx -y @upstash/context7-mcp@latest', {
+        stdio: 'pipe',
+        timeout: 30000,
+      });
+      ui.success('context7 MCP configured');
+    } catch {
+      ui.warn('context7 setup failed — research will use WebSearch fallback');
+    }
+  }
+}
+
+// Check if a command exists in PATH
+function commandExists(cmd) {
+  try {
+    const check = process.platform === 'win32' ? `where "${cmd}"` : `command -v "${cmd}"`;
+    execSync(check, { stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// 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'),
+  ];
+  for (const p of candidates) {
+    if (fs.existsSync(p)) return p;
+  }
+  return 'uv'; // fallback — let it fail with a clear error
+}
+
+function homedir() {
+  return require('os').homedir();
+}
+
 // Recursively copy a directory, creating parents as needed
 function copyDirSync(src, dst) {
   fs.mkdirSync(dst, { recursive: true });

package/package.json

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