@axiomatic-labs/claudeflow 2.49.27 → 2.49.28

package/lib/install.js

@@ -395,8 +395,8 @@ function pathHash(p) {
   return h.digest('hex');
 }
 
-function syncManagedGlobalDir(srcDir, dstDir, backupRoot, filter) {
-  const out = { synced: 0, changed: 0, backups: 0, failed: 0 };
+function syncManagedGlobalDir(srcDir, dstDir, backupRoot, filter, label) {
+  const out = { synced: 0, changed: 0, backups: 0, failed: 0, failures: [] };
   if (!fs.existsSync(srcDir)) return out;
   fs.mkdirSync(dstDir, { recursive: true });
   for (const e of fs.readdirSync(srcDir, { withFileTypes: true })) {
@@ -413,8 +413,9 @@ function syncManagedGlobalDir(srcDir, dstDir, backupRoot, filter) {
       const r = replaceManagedPath(s, d, backupRoot, dstDir);
       if (r.movedAside) out.backups++;
       out.changed++;
-    } catch {
+    } catch (err) {
       out.failed++;
+      out.failures.push(`${label}:${e.name}:${err && err.code ? err.code : 'ERROR'}`);
     }
   }
   return out;
@@ -428,12 +429,14 @@ function syncGlobalClaudeArtifacts(src, homeDir = os.homedir()) {
     path.join(homeDir, '.claude', 'skills'),
     backupRoot,
     e => e.isDirectory() && e.name.startsWith('claudeflow-'),
+    'global-skills',
   );
   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'),
+    'global-agents',
   );
   return {
     skills: skillStats.synced,
@@ -441,6 +444,7 @@ function syncGlobalClaudeArtifacts(src, homeDir = os.homedir()) {
     changed: skillStats.changed + agentStats.changed,
     backups: skillStats.backups + agentStats.backups,
     failed: skillStats.failed + agentStats.failed,
+    failures: [...skillStats.failures, ...agentStats.failures],
   };
 }
 
@@ -830,7 +834,10 @@ function installFromPayload(src, cwd, options = {}) {
     out.globalAgents = r.agents;
     out.globalChanged = r.changed;
     out.globalBackups = r.backups;
-    if (r.failed) out.failed.push(`global-claude-artifacts:${r.failed}`);
+    if (r.failed) {
+      out.failed.push(`global-claude-artifacts:${r.failed}`);
+      for (const f of r.failures || []) out.failed.push(f);
+    }
   });
 
   // 4d) Codex skills — replace shipped claudeflow-* skills in .agents; preserve user skills.
@@ -1037,6 +1044,10 @@ async function run() {
       ui.warn('  Permission repair: one or more managed claudeflow paths are not writable by your user.');
       ui.warn('  From the project root, run once:');
       ui.warn('    sudo chown -R "$(whoami):$(id -gn)" .claudeflow scripts/claudeflow .claude/skills/claudeflow-* .claude/agents/claudeflow-* .agents/skills/claudeflow-* .codex/agents/claudeflow-* plugins/codexflow');
+      if (summary.failed.some(f => /^global-(skills|agents):.*:(EACCES|EPERM)$/.test(f))) {
+        ui.warn('  For personal Claude Code cache repair, also run once:');
+        ui.warn('    sudo chown -R "$(whoami):$(id -gn)" ~/.claude/skills/claudeflow-* ~/.claude/agents/claudeflow-*');
+      }
       ui.warn('  Then re-run: npx @axiomatic-labs/claudeflow@latest install');
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiomatic-labs/claudeflow",
-  "version": "2.49.27",
+  "version": "2.49.28",
   "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"