claude-flow 3.30.5 → 3.31.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.30.5",
+  "version": "3.31.1",
   "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:21:59.884Z",
-  "gitSha": "9dd999c9",
+  "generatedAt": "2026-07-15T16:11:08.066Z",
+  "gitSha": "23abe26b",
   "catalog": {
     "agents": 164,
     "tools": 387,

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

@@ -124,6 +124,48 @@ async function maybeAutoDetectCodex(ctx, options) {
         // Codex auto-detect is a bonus, never a requirement — swallow everything.
     }
 }
+// Cross-agent skill registration via skills.sh. Runs `npx --yes skills add
+// 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,
+// but our own subprocess spawns should always set this).
+async function maybeInstallSkillsSh(ctx) {
+    try {
+        if (ctx.flags['no-skills-sh'] === true)
+            return;
+        if (ctx.flags.format === 'json')
+            return;
+        if (/^(1|true|on|yes)$/i.test(String(process.env.RUFLO_NO_SKILLS_SH || '')))
+            return;
+        const npxCmd = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+        if (!commandExists('npx'))
+            return;
+        output.writeln();
+        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', '--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 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 skills add ruvnet/ruflo --skill ruflo --yes'));
+        }
+    }
+    catch {
+        // Skills.sh registration is a bonus, never a requirement — swallow everything.
+    }
+}
 // Codex initialization action
 async function initCodexAction(ctx, options) {
     const { force, minimal, full, dualMode } = options;
@@ -405,6 +447,7 @@ const initAction = async (ctx) => {
         // #2666-adjacent — auto-detect + configure OpenAI Codex CLI if present
         if (!skipClaude) {
             await maybeAutoDetectCodex(ctx, { force, minimal, full });
+            await maybeInstallSkillsSh(ctx);
         }
         // Handle --start-all or --start-daemon
         const startAll = ctx.flags['start-all'] || ctx.flags.startAll;
@@ -1167,6 +1210,12 @@ export const initCommand = {
             type: 'boolean',
             default: false,
         },
+        {
+            name: 'no-skills-sh',
+            description: 'Skip the post-init `npx skills add ruvnet/ruflo` registration (also honored via RUFLO_NO_SKILLS_SH=1)',
+            type: 'boolean',
+            default: false,
+        },
         {
             name: 'all-agents',
             description: 'Install all agent categories (ADR-128: default is ~24 substrate agents; this restores the full set of ~89)',
@@ -1195,6 +1244,7 @@ export const initCommand = {
         { command: 'claude-flow init --codex --full', description: 'Codex init with all 137+ skills' },
         { command: 'claude-flow init --dual', description: 'Initialize for both Claude Code and Codex' },
         { command: 'claude-flow init --no-codex-detect', description: 'Skip auto-configuring OpenAI Codex even if it is installed' },
+        { command: 'claude-flow init --no-skills-sh', description: 'Skip the post-init skills.sh registration' },
         { command: 'claude-flow init --all-agents', description: 'Install all agent categories (~89 agents; ADR-128 opt-in)' },
     ],
     action: initAction,

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

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.30.5",
+  "version": "3.31.1",
   "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",