v3.38.0

ruvnet/ruflov3.38.0Aug 11, 2026by ruvnet

AI Summary

Remedies init scaffold content drift caused by plugin canonicalization, fixing missing agent detection, marketplace plugin launching, and stale CLI references.

Key Highlights

  • Implemented `ruflo migrate status` to detect and report missing ADR-128 agent files.
  • Fixed marketplace plugin MCP launch to resolve local installs before falling back to `npx @latest`.
  • Registered 3 previously missing plugins (`ruflo-agntcy`, `ruflo-bbs-federation`, `ruflo-business-pods`) in the marketplace registry.
  • Remapped 701 stale `npx claude-flow` invocations to `npx @claude-flow/cli@latest`.

New Features

  • New `ruflo migrate status` command for detecting missing agents.

Full Release Notes

## v3.38.0 — Init scaffold content drift remediation (ADR-382)

An investigation into `ruflo`'s two install tracks (`npm install` vs. the Claude Code marketplace plugin) surfaced four independently-verified defects in the init scaffold and its own remediation tooling, documented in [ADR-382](v3/docs/adr/ADR-382-init-scaffold-content-drift-remediation.md) and tracked in #2971. All four are fixed in this release.

### Fixed

- **Unfulfilled ADR-128 migrate mitigation** (#2973): ADR-128 Phase 2 removed 9 forked agent files (`coder.md`, `researcher.md`, `reviewer.md`, `tester.md`, `memory-specialist.md`, `security-auditor.md`, `sparc-orchestrator.md`, `goal-planner.md`, `adr-architect.md`) from the init template, making each plugin canonical — but the promised `ruflo migrate` detection for that removal was never implemented. `ruflo migrate status` now detects the gap and prints the exact `ruflo plugins install <plugin>` command to restore each missing agent.
- **Unpinned marketplace-plugin MCP launch** (#2975): `plugins/ruflo-core/.mcp.json` always launched `npx -y @claude-flow/cli@latest`, silently overriding any local `npm install` a user had, causing version divergence between the two install tracks. It now resolves a local install first (mirroring `hook-handler.cjs`'s existing `resolveCliBinForHook()` pattern), falling back to `npx @latest` only when nothing local resolves.
- **3 plugins missing from the marketplace registry** (#2975): `ruflo-agntcy`, `ruflo-bbs-federation`, and `ruflo-business-pods` existed in `plugins/` but were absent from `.claude-plugin/marketplace.json`, making them uninstallable via the marketplace despite being fully built. Registered.
- **Dead CLI/tool references in bundled scaffold content** (#2974): 701 occurrences of the stale `npx claude-flow` invocation form were remapped to `npx @claude-flow/cli@latest` across 142 files. A new CI guard (`scripts/smoke-init-scaffold-references.mjs`, warn-only) now derives live MCP-tool and CLI-subcommand sets and flags any future drift; 410 dead MCP-tool-name references (e.g. `sparc_mode`, `task_orchestrate`, `memory_usage`) were deliberately left FLAGged rather than guessed at, and are tracked as follow-up work rather than silently dropped.

### Notes

- No breaking changes; this is a backward-compatible bug-fix and tooling release.
- The `plugins/ruflo-core` MCP-launch fix applies to the git-based marketplace-plugin install track directly (already effective on `main`); the `migrate.ts` detection and scaffold-content remap ship in this npm release.