claude-flow 3.37.0 → 3.38.0

package/.claude-plugin/marketplace.json

@@ -180,6 +180,21 @@
       "name": "ruflo-arena",
       "source": "./plugins/ruflo-arena",
       "description": "Competitive ruliology for ruflo swarms — arenas, tournaments, and adaptive co-evolution of program strategies (ADR-147/148); strategies-as-programs compete under payoff games"
+    },
+    {
+      "name": "ruflo-agntcy",
+      "source": "./plugins/ruflo-agntcy",
+      "description": "AGNTCY/Outshift Internet-of-Cognition runtime integration — SLIM secure transport, CASA intent-scoped tool authorization, and AGNTCY identity/observability spans (ADR-380); optional, removable augmentation per ADR-150"
+    },
+    {
+      "name": "ruflo-bbs-federation",
+      "source": "./plugins/ruflo-bbs-federation",
+      "description": "AgentBBS federated business-domain BBS room integration (ADR-164 Phase 1) — register/publish/watch/human-join MCP tools wrapping the agentbbs Rust workspace as a federation peer; degrades gracefully when agentbbs is absent"
+    },
+    {
+      "name": "ruflo-business-pods",
+      "source": "./plugins/ruflo-business-pods",
+      "description": "Business-domain pod templates for the federated business autopilot (ADR-164 Phase 2) — pod templates plus a dry-run-by-default single-tick runner that validates, reserves budget, and resolves agent roles before posting to the BBS room"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.37.0",
+  "version": "3.38.0",
   "workspaces": [
     "v3/@claude-flow/codex",
     "v3/@claude-flow/plugin-agent-federation",

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

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "generation": 4,
-  "generatedAt": "2026-08-11T17:05:49.193Z",
-  "gitSha": "6ce18b5a",
+  "generatedAt": "2026-08-11T22:42:24.276Z",
+  "gitSha": "6b01dc5a",
   "catalog": {
     "agents": 164,
     "tools": 397,

package/v3/@claude-flow/cli/dist/src/commands/migrate-agent-detection.d.ts

@@ -0,0 +1,27 @@
+export interface RemovedAgentMapping {
+    /** Basename as it shipped in the init template, e.g. "coder.md". */
+    basename: string;
+    /** Marketplace plugin id (name in .claude-plugin/marketplace.json) that now owns it. */
+    plugin: string;
+}
+export interface RemovedAgentGap {
+    agent: string;
+    plugin: string;
+    installCommand: string;
+}
+export interface DetectRemovedAgentGapsOptions {
+    /**
+     * Override for the Claude Code plugin-registry home directory. Defaults to
+     * os.homedir(). Tests inject an isolated temp dir so results don't depend
+     * on whatever is actually installed on the machine running the suite.
+     */
+    homeDir?: string;
+}
+/**
+ * Returns one gap row per removed agent that is both missing from the
+ * project's .claude/agents/ tree and not covered by an installed owning
+ * plugin. Pure filesystem checks, no CLI version comparison (ADR-382 Part B
+ * scope note: a filesystem check is sufficient and accurate here).
+ */
+export declare function detectRemovedAgentGaps(cwd: string, removedAgents: RemovedAgentMapping[], options?: DetectRemovedAgentGapsOptions): RemovedAgentGap[];
+//# sourceMappingURL=migrate-agent-detection.d.ts.map

package/v3/@claude-flow/cli/dist/src/commands/migrate-agent-detection.js

@@ -0,0 +1,113 @@
+/**
+ * ADR-382 Part B — the `ruflo migrate` mitigation ADR-128 promised and never
+ * shipped: detect the 9 forked agents ADR-128 Phase 2 deleted from the init
+ * template (each plugin is now canonical) and, when a project is missing one
+ * AND the owning plugin isn't installed, surface an install suggestion.
+ * See v3/docs/adr/ADR-382-init-scaffold-content-drift-remediation.md and
+ * https://github.com/ruvnet/ruflo/issues/2971.
+ *
+ * Kept in a sibling module (not migrate.ts) because migrate.ts is already
+ * near/over the 500-line budget — see CLAUDE.md file-size rule.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+/**
+ * Claude Code records every plugin install (marketplace-scoped, "user" or
+ * "project") in a single global file — ~/.claude/plugins/installed_plugins.json,
+ * keyed "<plugin>@<marketplace>". This is the only real on-disk signal for
+ * "is the owning plugin installed"; there is no per-project marker and no
+ * ruflo-side tracking for marketplace plugins (ruflo's own PluginManager
+ * manifest at .claude-flow/plugins/installed.json tracks a different,
+ * npm-package-based plugin system).
+ */
+function readInstalledPluginsRegistry(homeDir) {
+    const registryPath = path.join(homeDir, '.claude', 'plugins', 'installed_plugins.json');
+    try {
+        if (!fs.existsSync(registryPath))
+            return {};
+        const raw = fs.readFileSync(registryPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && parsed.plugins && typeof parsed.plugins === 'object') {
+            return parsed.plugins;
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+function isPluginInstalled(pluginName, cwd, registry) {
+    const resolvedCwd = path.resolve(cwd);
+    const prefix = `${pluginName}@`;
+    for (const [key, entries] of Object.entries(registry)) {
+        if (!key.startsWith(prefix))
+            continue;
+        if (!Array.isArray(entries))
+            continue;
+        for (const entry of entries) {
+            if (entry?.scope === 'project') {
+                if (entry.projectPath && path.resolve(entry.projectPath) === resolvedCwd)
+                    return true;
+            }
+            else {
+                // "user" scope (or unspecified) applies to every project.
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function agentFileExists(cwd, basename) {
+    const agentsDir = path.join(cwd, '.claude', 'agents');
+    return findBasename(agentsDir, basename, 0);
+}
+// .claude/agents/ is a shallow tree (category/[subcategory]/name.md); a small
+// depth guard is enough to avoid pathological recursion without needing a
+// real glob dependency for a two-or-three-level lookup.
+const MAX_AGENT_DIR_DEPTH = 6;
+function findBasename(dir, basename, depth) {
+    if (depth > MAX_AGENT_DIR_DEPTH)
+        return false;
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            if (findBasename(path.join(dir, entry.name), basename, depth + 1))
+                return true;
+        }
+        else if (entry.isFile() && entry.name === basename) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Returns one gap row per removed agent that is both missing from the
+ * project's .claude/agents/ tree and not covered by an installed owning
+ * plugin. Pure filesystem checks, no CLI version comparison (ADR-382 Part B
+ * scope note: a filesystem check is sufficient and accurate here).
+ */
+export function detectRemovedAgentGaps(cwd, removedAgents, options = {}) {
+    const homeDir = options.homeDir ?? os.homedir();
+    const registry = readInstalledPluginsRegistry(homeDir);
+    const gaps = [];
+    for (const { basename, plugin } of removedAgents) {
+        if (agentFileExists(cwd, basename))
+            continue;
+        if (isPluginInstalled(plugin, cwd, registry))
+            continue;
+        gaps.push({
+            agent: basename,
+            plugin,
+            installCommand: `ruflo plugins install ${plugin}`,
+        });
+    }
+    return gaps;
+}
+//# sourceMappingURL=migrate-agent-detection.js.map

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

@@ -5,6 +5,7 @@
 import { output } from '../output.js';
 import * as fs from 'fs';
 import * as path from 'path';
+import { detectRemovedAgentGaps } from './migrate-agent-detection.js';
 // Migration targets
 const MIGRATION_TARGETS = [
     { value: 'config', label: 'Configuration', hint: 'Migrate configuration files' },
@@ -15,6 +16,21 @@ const MIGRATION_TARGETS = [
     { value: 'embeddings', label: 'Embeddings', hint: 'Migrate to ONNX with hyperbolic support' },
     { value: 'all', label: 'All', hint: 'Full migration' }
 ];
+// ADR-128 Phase 2 deleted these 9 forked agents from the init template,
+// making each plugin canonical — but ADR-128's own Consequences section
+// promised "`ruflo migrate` should detect removed agents and print install
+// suggestions," which never shipped until ADR-382 Part B (issue #2971).
+const REMOVED_AGENTS = [
+    { basename: 'coder.md', plugin: 'ruflo-core' },
+    { basename: 'researcher.md', plugin: 'ruflo-core' },
+    { basename: 'reviewer.md', plugin: 'ruflo-core' },
+    { basename: 'tester.md', plugin: 'ruflo-testgen' },
+    { basename: 'memory-specialist.md', plugin: 'ruflo-rag-memory' },
+    { basename: 'security-auditor.md', plugin: 'ruflo-security-audit' },
+    { basename: 'sparc-orchestrator.md', plugin: 'ruflo-sparc' },
+    { basename: 'goal-planner.md', plugin: 'ruflo-goals' },
+    { basename: 'adr-architect.md', plugin: 'ruflo-adr' },
+];
 // Status command
 const statusCommand = {
     name: 'status',
@@ -101,10 +117,13 @@ const statusCommand = {
         if (migrationState) {
             components.push({ component: 'Migration State', status: migrationState, migrationNeeded: 'no' });
         }
+        // ADR-382 Part B: agents ADR-128 removed from the init template that are
+        // both missing from this project and not covered by an installed plugin.
+        const removedAgentGaps = detectRemovedAgentGaps(cwd, REMOVED_AGENTS);
         // Display results
         if (ctx.flags.format === 'json') {
-            output.printJson({ components, migrationState });
-            return { success: true, data: { components, migrationState } };
+            output.printJson({ components, migrationState, removedAgentGaps });
+            return { success: true, data: { components, migrationState, removedAgentGaps } };
         }
         output.writeln();
         output.writeln(output.bold('Migration Status'));
@@ -130,7 +149,26 @@ const statusCommand = {
         else {
             output.printSuccess('No migration needed.');
         }
-        return { success: true, data: { components, needsMigration } };
+        if (removedAgentGaps.length > 0) {
+            output.writeln();
+            output.writeln(output.bold('Removed Agents (ADR-128)'));
+            output.printTable({
+                columns: [
+                    { key: 'agent', header: 'Agent', width: 24 },
+                    { key: 'plugin', header: 'Owning Plugin', width: 20 },
+                    { key: 'installCommand', header: 'Install', width: 34 }
+                ],
+                data: removedAgentGaps.map(g => ({
+                    agent: output.warning(g.agent),
+                    plugin: g.plugin,
+                    installCommand: output.dim(g.installCommand)
+                })),
+                border: false
+            });
+            output.writeln();
+            output.printInfo(`${removedAgentGaps.length} agent(s) removed by ADR-128 are missing from .claude/agents/ and not covered by an installed plugin.`);
+        }
+        return { success: true, data: { components, needsMigration, removedAgentGaps } };
     }
 };
 // Run migration

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

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