v3.14.2

ruvnet/ruflov3.14.2Jun 25, 2026by ruvnet

AI Summary

Patch release fixing Windows embedding crashes and silent data loss bugs in the memory store related to embedding model loading failures.

Key Highlights

Fixed Windows embedding crash on proxy/firewall issues
Fixed silent data loss in memory store namespace handling
Implemented fallback for @xenova/transformers loading failures

Full Release Notes

Patch release fixing a Windows-on-proxy crash and a silent data-loss bug in \`memory store\`.

## Fixes

- **#2461** — \`ruflo memory store\` / \`memory search\` crashed with \`Cannot read properties of null (reading 'model')\` whenever \`@xenova/transformers\` couldn't fetch model files (corporate proxy, strict firewall, offline). Three independent bugs in the same path:
  1. \`loadEmbeddingModel()\` aborted on transformers throw; never reached the working ruvector ONNX fallback that ships in-tree.
  2. \`generateLocalEmbedding()\` then crashed dereferencing the null state.
  3. \`memory store\` without \`-n\` stored under literal namespace \`\"undefined\"\` (silent data loss).

  All three fixed in this release.

## Verification

- 50× \`generateLocalEmbedding\` on the **published** \`ruflo@3.14.2\` artifact → 50/50 success, 0 crashes
- 100× the same call locally with **every** embedder module unresolvable → 100/100 success (was: crash on call #1)
- \`@claude-flow/cli\` builds clean

## Install

\`\`\`bash
npx ruflo@3.14.2
# or
npx @claude-flow/cli@3.14.2
\`\`\`

All three packages — \`@claude-flow/cli\`, \`claude-flow\`, \`ruflo\` — at 3.14.2 with consistent \`latest\` / \`alpha\` / \`v3alpha\` dist-tags.

## Credits

@Pishro-canadaapply filed #2461 with full root-cause analysis and a proposed fix; this release implements it.

## PR

#2467 — diff and per-commit history.