v3.77.1 — AgentDB honours the configured embedding model2026-11-13
3.77.1 修复了 AgentDB 不读取自定义 embedding 配置的问题。此前 #2305 之后,memory_store 忽略了 .claude-flow/embeddings.json——控制器注册 AgentDB 时只传了 dbPath,配置的模型与维度全被丢弃,悄悄回退到 all-MiniLM-L6-v2、384 维。这次 @claude-flow/memory 3.3.3 会把维度透传给 AgentDB 并装上配置的 embedder,长度不符的向量直接拒收;CLI 的 memory bridge 在配置了非默认模型时改用本地 embedder,写入的记录也会标注实际生成它的 embedder。原本就固定在默认 384 维的存储不受影响。另外合入 #4975,在 CI 上隔离不稳定的浏览器测试套件。
v3.77.0 — neural wsp (ruv-FANN), opt-in judge routing, guidance WASM fix2026-11-12
ruflo 3.77.0 发布。新增 neural wsp 命令组(status / inspect / check / gate / export-centroid),提供 ruv-FANN 权重空间分析工具;相关三个包列为可选依赖,未安装时只提示 "not installed",不报错。ruflo-mods 0.17.0 加入模型裁判路由 routeJudge,默认关闭,与人工标注的一致性显著优于关键词路由,但还需新一批人工标注结果才考虑默认开启。Windows 下残留的 2>/dev/null 重定向已清理,analyze deps --security 会在 npm audit 非零退出时给出提示;修复了 scan_secrets 对多字节字符的误报。另发布 @claude-flow/guidance 3.0.1,重新构建 WASM 内核——此前只改了 Rust 源码,二进制仍是旧的,会直接崩溃。已对发布包做全新安装验证;alpha 仍停在 3.75.2。已知 PR CI 上一条 POSIX 追加测试偶发失败,正在跟进。
v3.76.1 — auto-memory import/sync exit non-zero when the memory package is missing2026-11-12
3.76.1 是一个补丁版,核心只修一件事:auto-memory-hook import 和 sync 在找不到 @claude-flow/memory 时,之前只打一行「DISABLED」警告就以 0 退出,调用方会误以为导入、同步都成功了,实际上什么也没做。现在这种情况统一返回退出码 1,覆盖打包版 helper、仓库副本以及 init 生成器的兜底路径,helpers manifest 也随之重新签名。发布后已在正式包上验证:全新安装 ruflo@3.76.1 能通过 CLI 自身解析导入四个内置包(security、codex、mcp、plugin-agent-federation);在没有 memory 包的项目里,import 和 sync 均正确返回 1。已发布 @claude-flow/cli、claude-flow、ruflo 3.76.1 及 MCP 注册项,alpha/v3alpha 仍停留在 3.75.2。另有一项已知问题:ruflo-console 的 write-argv.spec.ts append 测试在发布 CI 中连续三次失败,本地与 main 分支均通过,与本版改动无关,已单独跟进。
v3.76.0 — opt-in centroid agent router, neural router assets shipped2026-11-11
claude-flow 3.76.0:新增可选质心路由,修复神经路由模型缺失等多个问题
这版最亮眼的是新增了「最近质心」代理路由,设 CLAUDEFLOWROUTER_CENTROID=1 即可启用:按带标签样例的质心距离为任务分配执行代理,在 ADR-391 测试集上命中率 63.7%,而当前默认路由只有 25.7%。默认路由暂不改动,还需要在全新任务上验证「每次正确求解的平均成本」,达标后才会转正。
修复方面,CLAUDEFLOWROUTER_NEURAL=1 依赖的 KRR 模型、分档专家与校准器此前只有从源码仓库运行才能加载,现已随 npm 包分发,普通安装也能用。darwin 依赖改钉到 ~0.14.0,解决了 clean-install 与 pin-drift 两项 CI 失败。另外修了若干实际痛点:重新打开的任务完成时不再重复计功、设置风险扫描器现在会拦截对 node、deno、bun、php 的预先放行、hooks route 在质心路由决策时会如实显示方法名。alpha 与 v3alpha 标签仍停留在 3.75.2。
v3.75.3 — shared on zod 4, memory 3.3.1, Raft vote fix2026-11-10
这是一个安全与修复并行的版本。安全方面:@claude-flow/shared 升级到 zod 4,清掉全新 ruflo 安装时 npm audit 报出的 4 个高危漏洞(GHSA-mrhx-c7xc-m3w5);新增可选的模式下载固定密钥校验,开启 requireVerification 后下载内容必须通过固定密钥验证,默认不启用;写入辅助文件时不再跟随符号链接,若 .claude 本身是软链则跳过写入,避免误写到别处。修复方面:@claude-flow/memory 3.3.1 的 onInsightAccessed 改为按 key 查找洞察,此前只能按行 id 匹配;任务重新打开时会清空 completedAt;@claude-flow/swarm 3.0.6 修复 Raft 投票,requestVote() 现在遵守每任期一票和日志新旧校验;另修复了 doctor 测试的隔离问题。alpha 与 v3alpha 仍停留在 3.75.2。
v3.75.2 — ruflo ships the wrapper only; bridge SSRF guard2026-11-10
Socket flagged six files in ruflo@3.75.1. They were the Chat UI, MCP bridge and deploy scripts under ruflo/src/, which the CLI never reads. This release stops shipping them and fixes the two real defects the alerts pointed at.
Changes
- ruflo ships the wrapper only. The tarball drops from 531 files (8.2 MB unpacked) to 3 files. A test now fails if anything outside bin/, dist/, package.json, README.md or LICENSE is packed.
- MCP bridge outbound URL guard (both bridge copies, #4945). The old regex allowed https://[::1]/, 169.254.169.254, 100.64.0.0/10, .internal, IPv4-mapped loopback and LOCALHOST., and wrongly refused public hosts starting with fc or fd. The new url-guard.js also checks every address a hostname resolves to, and refuses redirects. If SEARCHAPIURL or RESEARCHAPI_URL points to a private address or redirects, the bridge now refuses it.
- Pinned bridge backends. agentic-flow@alpha is pinned to 3.0.0-alpha.2, the version that tag points at, so its tools are unchanged. The third-party gemini-mcp-server is pinned to 1.2.2. Spawned backends no longer inherit the bridge's MCPAUTHTOKEN.
- Removed chat-ui/patch-mcp-url-safety.sh. On the current upstream image it matched nothing and exited 0. Where it did match, it loosened the URL check for every URL.
@claude-flow/cli and claude-flow change version only.
🤖 Generated with RuFlo
v3.75.1 — bundled security loads again (zod 4), plus security and memory fixes2026-11-10
3.75.1 修复内置安全包无法加载的问题。3.74.1 与 3.75.0 打包的 @claude-flow/security 3.0.7 需要 zod 4,而外层封装仍带 zod 3,导入即抛 z.config is not a function,CLI 的认证、代理和 doctor 密钥链路径都受牵连。本版在包内直接附带 zod 4.6.7,CLI 自身的 zod 3 不动;CI 冒烟测试也改为按发布流程打包 CLI 并导入全部内置包。
自 3.75.0 起合并的改动还有:@claude-flow/aidefence 3.2.1 的 new AgentDB() 向量库恢复可用;模式库下载按可信公钥做 Ed25519 校验并限制大小与时长;内存与会话导入上限 16 MiB,联邦入网只接受 ~/.ruflo 下的密钥文件与配置的中继;getEntry 在 sql.js 下为纯读;联邦默认改用 require-jcs 签名,不支持 JCS 的对端需设 signatureMode: 'prefer-jcs';hive-mind spawn --claude 默认保留权限确认;providers test -p openai 会探测已保存端点;cleanup --force 保留项目的 data/、memory/ 与用户 hooks;启动自动更新需显式设 RUFLOAUTOUPDATE,开发态 Mongo 只监听回环,联邦握手更严格;helper 刷新会拒绝为其他 CLI 版本签名的清单;embeddings_neural 对 decayRate、driftThreshold 保留显式 0。
v3.75.0 — 25 issue fixes, plugins host, dual init, memory scopes, inventory tools2026-11-10
claude-flow 修了 25 个问题,也补上一批新命令。修复里最要紧的是原子写入:writeFileAtomic 只检查一次 writeSync,短写时会把截断文件改名顶上还报成功,现在每个字节都写完才落盘。模式保存失败会返回 false 并记录 lastFlushError;memorysearchunified 会指明失败的命名空间,searchTime 改为真实耗时,并发查 4 个命名空间;查不到与读取失败不再混为一谈。PII 反馈不再误记为漏拦,CORE-005 也不再把以 "…where you are now." 收尾的句子误判为角色切换。工具 schema 补上真实长度限制,agent_spawn 接受精确模型 ID,持久化状态跟随项目根目录。新增 ruflo start all 一键启动、ruflo plugins host 系列插件管理、记忆 scope 分级、清单查询工具,AutoMemory 也多了 dedupe 去重。
v3.74.1 — @metaharness/darwin in-process (ADR-526), zod 4 security, PageRank2026-11-09
版本 3.74.1:建议直接用它,别停在 3.74.0——后者打包的 .claude/helpers 是 3.63.4 的旧文件,而 ruflo 依赖该确切版本。现在发布脚本会在 helpers 与提交不一致时拒绝发布(#4900)。
主要变化是 darwin 内置(ADR-526):@metaharness/darwin 从可选依赖改为 @claude-flow/cli 的常规依赖。metaharnessbench --op verify 与 metaharnessgepa 四个操作(genome、validate、render、analyze)改为在 MCP 服务器内加载缓存模块运行,不再每次拉起脚本、bench 也不再多开一层 darwin CLI 进程;加载失败时回退到脚本。ruflo-metaharness 0.5.0 同步跟进。Node 22 下 20 次中位数:gepa validate 从 21.4 ms 降到首次 2.9 ms、后续 0.03 ms;render 从 21.9 ms 到 0.3/0.02 ms;bench verify 从 59.7 ms 到 40.0/0.05 ms。首次调用仍要付一次 darwin 导入成本,收益来自省掉进程创建,不是 darwin 本身变快。
另有安全更新(#4895):@claude-flow/security 3.0.7 迁移到 zod ^4.6.7,cli-core 3.7.6 兼容 zod 4 的 invalid_value 错误;PageRank 排序(#4899):@claude-flow/memory 3.2.6 与 @claude-flow/plugins 3.0.3 换用新实现;发布校验(#4900):prepare-publish.mjs 在签名前与收尾时两次比对 .claude/helpers 与 HEAD。
v3.73.0 — init ends with your project, opt-in activation telemetry, Node 20 keeps ruvector2026-11-09
Faster first five minutes
- init ends with your project, not a list of commands (#4871, #4875). It prints a quick local snapshot: tracked files, top languages, the most-changed file in the last 90 days, and your test command. Then it gives one prompt to paste into Claude Code about that file. The snapshot uses git only, with no network calls and a 2-second cap, and it never fails init.
- README: one recommended install path at the top (npx ruflo@latest init), plus a 30-second console tour (#4869). There's also a Chinese quick start and a sourced comparison page with CrewAI, LangGraph, AutoGen and Claude Code subagents (#4873, https://ruvnet.github.io/ruflo/compare.html).
Telemetry: opt-outs honored, opt-in activation events
- Opt-outs now stop the message fetch. ruflo funnel disable and every other opt-out now stop the background messages fetch, not only the promo row (#4860). The fetch's User-Agent carries only the release and OS family. See docs/privacy/funnel-legitimate-interest-assessment.md.
- Opt-in activation events (#4870): initcompleted, firstagentrun and sessionactive are sent only with an explicit ruflo funnel telemetry on consent. init asks once, defaulting to No. Skip the question with --no-telemetry-prompt.
- Plugin-only users can be counted (#4872). When the ruflo-core plugin starts the MCP server, the existing 6-hourly fetch is tagged surface/plugin, with the same opt-outs.
Fixes and hardening
- transfer: Ed25519 signatures for pattern-store publish and download.
- healthcare-clinical: audit entries store a SHA-256 query fingerprint.
- browser: the postinstall step installs the pinned agent-browser range.
- deps: open ranges capped in plugins and performance; marketplace agentic-flow 3.4.0; federation midstreamer ^0.3.2; aidefence agentdb ^3.6.0 (#4858, #4868).
- ruflo/server.json and mcpName prepare the io.github.ruvnet/ruflo MCP registry listing (#4874).
Upstream
- @ruvector/ruvllm-gpu-loop@1.1.2 (engines >=20) fixes npm 10 / Node 20 dropping the ruvector subtree from fresh installs.
- Node 20 keeps ruvector. agentic-flow is now a regular dependency of @claude-flow/cli. On npm 10 / Node 20, an optional pipenet (engines >=22, reached via agentic-flow → fastmcp → mcp-proxy) made npm drop ruvector, agentic-flow, @ruvector/attention and transformers from fresh installs. This affected 3.72.2 as well. Verified with fresh npm install ruflo@3.73.0 on node:20 and node:22.
- Bundled plugin-agent-federation 1.0.7 excludes agentic-flow ≤2.0.13 (GHSA-vcv2-r9jh-99m5) from its peer range (#4890).
- init keeps the ADR-150 metaharness score tip under the project snapshot.
Install: npx ruflo@latest init. latest is 3.73.0 for ruflo, claude-flow and @claude-flow/cli.