v2/docs/V2.7.25_RELEASE_NOTES.md
Date: January 25, 2025 Version: 2.7.25 Status: ā Published to npm (alpha channel)
This release integrates [email protected] which provides a clean, error-free npx experience for memory commands by detecting npx environments and gracefully using hash-based embeddings.
What was fixed:
Before (v2.7.24):
npx claude-flow@alpha memory store "test" "value"
[Embeddings] Initializing local embedding model...
Error: Attempt to use DefaultLogger but none has been registered.
Something went wrong during model construction. Using `wasm` as a fallback.
[Embeddings] Failed to initialize: no available backend found.
[Embeddings] Falling back to hash-based embeddings
ā
Stored successfully
After (v2.7.25):
npx claude-flow@alpha memory store "test" "value"
[Embeddings] NPX environment detected - using hash-based embeddings
[Embeddings] For semantic search, install globally: npm install -g claude-flow
ā
Stored successfully
What's included:
Benefits:
npx claude-flow@alpha memory store "key" "value"
npm install -g claude-flow@alpha
claude-flow memory store "key" "value"
# No changes required - fully backward compatible
npm install -g claude-flow@alpha
.swarm/memory.dbagentic-flow: ^1.8.7 ā ^1.8.9NPX Detection Logic ([email protected]):
const isNpx = process.env.npm_config_user_agent?.includes('npx') ||
process.cwd().includes('_npx') ||
process.cwd().includes('npm/_npx');
if (isNpx && !process.env.FORCE_TRANSFORMERS) {
console.log('[Embeddings] NPX environment detected - using hash-based embeddings');
console.log('[Embeddings] For semantic search, install globally: npm install -g claude-flow');
return false; // Skip transformer initialization
}
Result:
agentic-flow progression:
claude-flow progression:
1. NPX Installation (Clean Experience):
npx claude-flow@alpha memory store "test" "Clean npx experience!"
# ā
No errors, clean output, helpful guidance
npx claude-flow@alpha memory query "test"
# ā
Works with hash-based embeddings
npx claude-flow@alpha memory list
# ā
Shows all stored memories
2. Local Installation (Full Semantic Search):
npm install -g claude-flow@alpha
claude-flow memory store "api-design" "REST with JWT auth"
# ā
Transformer model loads successfully
claude-flow memory query "authentication patterns"
# ā
Semantic search finds related concepts
3. Memory Persistence:
.swarm/memory.dbNone. This release is fully backward compatible.
None. All major issues from v2.7.24 have been resolved:
ā ONNX DefaultLogger error - Fixed (npx detection) ā WASM backend failure - Fixed (clean fallback) ā Confusing error messages - Fixed (helpful guidance) ā yoctocolors-cjs missing - Fixed (v2.7.23) ā "Enabled: false" log - Fixed (v2.7.22/[email protected])
Related Docs:
For Users:
npx claude-flow@alpha memory store "test" "value"npm install -g claude-flow@alphaFor Developers:
This release delivers on the promise of a clean, professional npx experience while maintaining full backward compatibility and optional semantic search for power users. The memory system now works beautifully in both npx and local installations with appropriate behavior for each environment.
Upgrade today for the best memory command experience! š