@axiomatic-labs/claudeflow 2.49.11 → 2.49.13

package/lib/install.js

@@ -1,6 +1,7 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const crypto = require('crypto');
 const { execSync } = require('child_process');
 const { requireAuth } = require('./auth.js');
 const { getLatestRelease, downloadReleaseAsset } = require('./download.js');
@@ -41,6 +42,83 @@ function copyDir(src, dst) {
   }
 }
 
+function copyPath(src, dst) {
+  const st = fs.statSync(src);
+  if (st.isDirectory()) copyDir(src, dst);
+  else if (st.isFile()) {
+    fs.mkdirSync(path.dirname(dst), { recursive: true });
+    fs.copyFileSync(src, dst);
+  }
+}
+
+function pathHash(p) {
+  if (!fs.existsSync(p)) return null;
+  const h = crypto.createHash('sha256');
+  const walk = (cur, rel) => {
+    const st = fs.statSync(cur);
+    if (st.isDirectory()) {
+      h.update(`dir:${rel}\n`);
+      for (const name of fs.readdirSync(cur).sort()) walk(path.join(cur, name), path.join(rel, name));
+      return;
+    }
+    if (!st.isFile()) return;
+    h.update(`file:${rel}\n`);
+    h.update(fs.readFileSync(cur));
+    h.update('\n');
+  };
+  walk(p, '');
+  return h.digest('hex');
+}
+
+function syncManagedGlobalDir(srcDir, dstDir, backupRoot, filter) {
+  const out = { synced: 0, changed: 0, backups: 0, failed: 0 };
+  if (!fs.existsSync(srcDir)) return out;
+  fs.mkdirSync(dstDir, { recursive: true });
+  for (const e of fs.readdirSync(srcDir, { withFileTypes: true })) {
+    if (!filter(e)) continue;
+    const s = path.join(srcDir, e.name);
+    const d = path.join(dstDir, e.name);
+    try {
+      out.synced++;
+      if (pathHash(s) === pathHash(d)) continue;
+      if (fs.existsSync(d)) {
+        copyPath(d, path.join(backupRoot, path.basename(dstDir), e.name));
+        out.backups++;
+      }
+      rmrf(d);
+      copyPath(s, d);
+      out.changed++;
+    } catch {
+      out.failed++;
+    }
+  }
+  return out;
+}
+
+function syncGlobalClaudeArtifacts(src, homeDir = os.homedir()) {
+  const stamp = new Date().toISOString().replace(/\D/g, '').slice(0, 14) + '-' + process.pid;
+  const backupRoot = path.join(homeDir, '.claude', 'backup', `claudeflow-install-${stamp}`);
+  const skillStats = syncManagedGlobalDir(
+    path.join(src, '.claude', 'skills'),
+    path.join(homeDir, '.claude', 'skills'),
+    backupRoot,
+    e => e.isDirectory() && e.name.startsWith('claudeflow-'),
+  );
+  const agentStats = syncManagedGlobalDir(
+    path.join(src, '.claude', 'agents'),
+    path.join(homeDir, '.claude', 'agents'),
+    backupRoot,
+    e => e.isFile() && e.name.startsWith('claudeflow-') && e.name.endsWith('.md'),
+  );
+  return {
+    skills: skillStats.synced,
+    agents: agentStats.synced,
+    changed: skillStats.changed + agentStats.changed,
+    backups: skillStats.backups + agentStats.backups,
+    failed: skillStats.failed + agentStats.failed,
+  };
+}
+
 function countFiles(dir) {
   let n = 0;
   for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
@@ -217,7 +295,7 @@ function mergeCodexMarketplace(cwd, payloadMarketplace) {
 }
 
 // Seed the BASE MCP server set (playwright for visual QA / browser_verification, context7 for live library
-// docs during Discover) into the project's root `.mcp.json` — the set the old framework shipped, restored.
+// docs during Discover, chrome-devtools for Chrome DevTools inspection) into the project's root `.mcp.json`.
 // ADD-IF-ABSENT by server key: create the file if missing, else merge in only the keys the user doesn't
 // already have (never clobber a server they configured). A corrupt/unexpected `.mcp.json` is left untouched
 // (don't risk eating the user's servers). Returns the number of servers added (0 = nothing to do). Like the
@@ -295,13 +373,18 @@ function syncAgentsMd(cwd, snippetPath) {
 }
 
 // Place + merge the framework from an extracted payload dir into a project. Pure filesystem, no network —
-// so it is testable on a throwaway dir.
-function installFromPayload(src, cwd) {
+// so it is testable on a throwaway dir. The real CLI turns on `syncGlobalClaude` so stale personal
+// Claude Code skills/agents cannot shadow the project-local copy; tests keep it off unless explicit.
+function installFromPayload(src, cwd, options = {}) {
   const out = {
     playbooks: 0,
     scripts: 0,
     skills: 0,
     agents: 0,
+    globalSkills: 0,
+    globalAgents: 0,
+    globalChanged: 0,
+    globalBackups: 0,
     codexSkills: 0,
     codexAgents: 0,
     codexHooks: false,
@@ -385,7 +468,20 @@ function installFromPayload(src, cwd) {
     }
   });
 
-  // 4c) Codex skills — replace shipped claudeflow-* skills in .agents; preserve user skills.
+  // 4c) Personal Claude Code cache repair — Claude prioritizes ~/.claude skills/agents over project-local
+  // ones. A stale personal claudeflow-* copy shadows the version just installed in this project, so the real
+  // CLI refreshes only our namespaced personal artifacts and backs up any changed copy first.
+  step('global-claude-artifacts', () => {
+    if (options.syncGlobalClaude !== true) return;
+    const r = syncGlobalClaudeArtifacts(src, options.globalHome || os.homedir());
+    out.globalSkills = r.skills;
+    out.globalAgents = r.agents;
+    out.globalChanged = r.changed;
+    out.globalBackups = r.backups;
+    if (r.failed) out.failed.push(`global-claude-artifacts:${r.failed}`);
+  });
+
+  // 4d) Codex skills — replace shipped claudeflow-* skills in .agents; preserve user skills.
   step('codex-skills', () => {
     const srcSkills = path.join(src, '.agents', 'skills');
     if (fs.existsSync(srcSkills)) {
@@ -399,7 +495,7 @@ function installFromPayload(src, cwd) {
     }
   });
 
-  // 4d) Codex agents — replace shipped claudeflow-*.toml agents; preserve user agents.
+  // 4e) Codex agents — replace shipped claudeflow-*.toml agents; preserve user agents.
   step('codex-agents', () => {
     const srcAgents = path.join(src, '.codex', 'agents');
     if (fs.existsSync(srcAgents)) {
@@ -537,13 +633,18 @@ async function run() {
   execSync(`unzip -qq -o "${tmpZip}" -d "${tmp}"`, { stdio: 'ignore' });
 
   ui.step('Installing framework...');
-  const summary = installFromPayload(tmp, cwd);
+  const summary = installFromPayload(tmp, cwd, { syncGlobalClaude: process.env.CLAUDEFLOW_NO_GLOBAL_SYNC !== '1' });
   writeLocalVersion(`v${version}`);
 
   try { rmrf(tmp); fs.rmSync(tmpZip, { force: true }); } catch {}
 
   ui.success(`claudeflow v${version} installed`);
   ui.info(`  ${summary.playbooks} playbooks · ${summary.scripts} scripts · ${summary.skills} skills`
+    + (summary.globalSkills || summary.globalAgents
+      ? ` · global Claude repaired (${summary.globalSkills} skills, ${summary.globalAgents} agents`
+        + (summary.globalBackups ? `, ${summary.globalBackups} backups` : '')
+        + ')'
+      : '')
     + (summary.codexSkills ? ` · ${summary.codexSkills} Codex skills` : '')
     + (summary.codexAgents ? ` · ${summary.codexAgents} Codex agents` : '')
     + (summary.codexHooks ? ' · Codex hooks merged' : '')
@@ -563,6 +664,7 @@ module.exports.installFromPayload = installFromPayload;
 module.exports.mergeSettings = mergeSettings;
 module.exports.syncClaudeMd = syncClaudeMd;
 module.exports.syncAgentsMd = syncAgentsMd;
+module.exports.syncGlobalClaudeArtifacts = syncGlobalClaudeArtifacts;
 module.exports.mergeMcp = mergeMcp;
 module.exports.mergeGitignore = mergeGitignore;
 module.exports.mergeCodexHooks = mergeCodexHooks;

package/package.json

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