claude-flow 3.31.0 → 3.31.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.31.0",
+  "version": "3.31.2",
   "description": "Ruflo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
   "main": "dist/index.js",
   "type": "module",

package/v3/@claude-flow/cli/catalog-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "generation": 1,
-  "generatedAt": "2026-07-15T15:57:54.837Z",
-  "gitSha": "35ceda35",
+  "generatedAt": "2026-07-15T16:44:05.609Z",
+  "gitSha": "f00d78ff",
   "catalog": {
     "agents": 164,
     "tools": 387,

package/v3/@claude-flow/cli/dist/src/commands/init.js

@@ -125,10 +125,13 @@ async function maybeAutoDetectCodex(ctx, options) {
     }
 }
 // Cross-agent skill registration via skills.sh. Runs `npx --yes skills add
-// ruvnet/ruflo` so ruflo's 134 skills reach whatever agent the project uses
-// (Claude Code, Cursor, Copilot, Gemini, Cline, …). Best-effort — never fails
-// init. Opt-out: --no-skills-sh flag OR RUFLO_NO_SKILLS_SH=1. Skipped under
-// --skip-claude and scripted `--format json` output.
+// ruvnet/ruflo --skill ruflo --yes` so the *single* canonical ruflo skill
+// (SKILL.md at the ruvnet/ruflo repo root — describes the platform + entry
+// points) reaches whatever agent the project uses (Claude Code, Cursor,
+// Copilot, Gemini, Cline, …). Users who want ALL 267 plugin-specific skills
+// can run `npx skills add ruvnet/ruflo --all` themselves. Best-effort — never
+// fails init. Opt-out: --no-skills-sh flag OR RUFLO_NO_SKILLS_SH=1. Skipped
+// under --skip-claude and scripted `--format json` output.
 //
 // windowsHide silences the console flash the npx child would otherwise produce
 // (anthropics/claude-code#14828 spawn hazard applies to hook-fired spawns,
@@ -141,21 +144,37 @@ async function maybeInstallSkillsSh(ctx) {
             return;
         if (/^(1|true|on|yes)$/i.test(String(process.env.RUFLO_NO_SKILLS_SH || '')))
             return;
+        // Idempotency gate: if this project has already registered ruflo with
+        // skills.sh, don't re-clone the repo + re-fire a fresh install telemetry
+        // event on every `ruflo init --force` / `init upgrade` / etc. Each install
+        // pings skills.sh's leaderboard AND clones the whole ruvnet/ruflo repo
+        // (~50MB) — re-running per-init would silently inflate our own metrics
+        // (GitHub unique-cloners, skills.sh rank) and waste user bandwidth. This
+        // check makes the registration once-per-project, matching the intent.
+        const nodePath = await import('path');
+        const nodeFs = await import('fs');
+        const marker = nodePath.join(ctx.cwd, '.agents', 'skills', 'ruflo');
+        if (nodeFs.existsSync(marker)) {
+            output.writeln();
+            output.writeln(output.dim('  skills.sh registration already present at .agents/skills/ruflo — skipping'));
+            return;
+        }
         const npxCmd = process.platform === 'win32' ? 'npx.cmd' : 'npx';
         if (!commandExists('npx'))
             return;
         output.writeln();
-        output.printInfo('Registering ruflo with skills.sh (cross-agent skill catalog)…');
+        output.printInfo('Registering the core `ruflo` skill with skills.sh (cross-agent catalog)…');
         const { spawnSync } = await import('child_process');
-        const result = spawnSync(npxCmd, ['--yes', 'skills', 'add', 'ruvnet/ruflo'], { cwd: ctx.cwd, stdio: 'pipe', timeout: 60_000, windowsHide: true, encoding: 'utf-8' });
+        const result = spawnSync(npxCmd, ['--yes', 'skills', 'add', 'ruvnet/ruflo', '--skill', 'ruflo', '--yes'], { cwd: ctx.cwd, stdio: 'pipe', timeout: 60_000, windowsHide: true, encoding: 'utf-8' });
         if (result.status === 0) {
-            output.writeln(output.success('  ✓ ruflo skills registered via skills.sh — available to any agent in this project'));
+            output.writeln(output.success('  ✓ ruflo registered via skills.sh — the platform skill is available to any agent in this project'));
+            output.writeln(output.dim('    Want all 267 plugin skills? npx skills add ruvnet/ruflo --all'));
             output.writeln(output.dim('    Opt out next time: --no-skills-sh or RUFLO_NO_SKILLS_SH=1'));
         }
         else {
             // Common non-fatal reasons: offline, npx cache miss, skills CLI version
             // mismatch, unknown package. Log a soft note; users can retry manually.
-            output.writeln(output.dim('  skills.sh registration skipped (network or npx cache) — retry with: npx --yes skills add ruvnet/ruflo'));
+            output.writeln(output.dim('  skills.sh registration skipped (network or npx cache) — retry with: npx skills add ruvnet/ruflo --skill ruflo --yes'));
         }
     }
     catch {

package/v3/@claude-flow/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.31.0",
+  "version": "3.31.2",
   "type": "module",
   "description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",