claude-flow 3.57.2 → 3.58.0

package/v3/@claude-flow/cli/dist/src/memory/model-cache-dir.js

@@ -0,0 +1,17 @@
+import * as os from 'node:os';
+import * as path from 'node:path';
+/**
+ * Resolve a writable cache directory for ONNX model downloads.
+ *
+ * ADR-454: duplicated intentionally from
+ * `@claude-flow/embeddings/src/transformers-loader.ts`'s
+ * `resolveModelCacheDir()` rather than imported, since `@claude-flow/cli`
+ * has no dependency on `@claude-flow/embeddings` (see the circular
+ * optional-dep note in `memory-initializer.ts`).
+ */
+export function resolveModelCacheDir() {
+    return (process.env.TRANSFORMERS_CACHE ||
+        process.env.HF_HOME ||
+        path.join(os.homedir(), '.cache', 'ruflo', 'models'));
+}
+//# sourceMappingURL=model-cache-dir.js.map

package/v3/@claude-flow/cli/dist/src/ruvector/task-embedder.js

@@ -19,6 +19,8 @@
  *
  * @module task-embedder
  */
+import * as fs from 'node:fs';
+import { resolveModelCacheDir } from '../memory/model-cache-dir.js';
 // ============================================================================
 // FNV-1a-32 hash (matches scripts/gen-seed-corpus.mjs + router-trajectory.ts)
 // ============================================================================
@@ -38,18 +40,48 @@ function cacheKey(task) {
 // same function (xenova's pipeline returns a callable that accepts either),
 // so we don't pay the ONNX model-load cost twice.
 let _extractorPromise = null;
+/**
+ * ADR-454: distinguishes a null-extractor result caused by a genuinely
+ * missing dependency (permanent — nothing changes without a reinstall) from
+ * one caused by an environmental/fixable failure during `pipeline(...)`
+ * init, such as EACCES on the model cache dir (retryable).
+ */
+let _extractorDegradedReason = null;
+let _extractorLastAttemptAt = 0;
+const EXTRACTOR_RETRY_INTERVAL_MS = 60_000;
 function loadExtractor() {
-    if (_extractorPromise !== null)
-        return _extractorPromise;
+    if (_extractorPromise !== null) {
+        const isRetryableDue = _extractorDegradedReason === 'retryable' &&
+            Date.now() - _extractorLastAttemptAt >= EXTRACTOR_RETRY_INTERVAL_MS;
+        if (!isRetryableDue)
+            return _extractorPromise;
+        // Fall through to re-attempt — the retryable failure may now be fixed.
+    }
+    _extractorLastAttemptAt = Date.now();
     _extractorPromise = (async () => {
+        let packageImportable = false;
         try {
             const specifier = '@xenova/transformers';
             const mod = await import(/* @vite-ignore */ specifier).catch(() => null);
-            if (!mod || typeof mod.pipeline !== 'function')
+            if (!mod || typeof mod.pipeline !== 'function') {
+                _extractorDegradedReason = 'permanent';
                 return null;
-            return await mod.pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2', { quantized: true });
+            }
+            packageImportable = true;
+            // ADR-454: route model downloads to a user-writable cache dir — the
+            // package-relative default is root-owned under a system-prefix
+            // global install, which throws EACCES for the runtime user.
+            const cacheDir = resolveModelCacheDir();
+            fs.mkdirSync(cacheDir, { recursive: true });
+            const env = mod.env;
+            if (env)
+                env.cacheDir = cacheDir;
+            const extractor = await mod.pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2', { quantized: true });
+            _extractorDegradedReason = null;
+            return extractor;
         }
         catch {
+            _extractorDegradedReason = packageImportable ? 'retryable' : 'permanent';
             return null;
         }
     })();
@@ -233,5 +265,7 @@ export function __resetTaskEmbedderForTests() {
     _hits = 0;
     _misses = 0;
     _extractorPromise = null;
+    _extractorDegradedReason = null;
+    _extractorLastAttemptAt = 0;
 }
 //# sourceMappingURL=task-embedder.js.map

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

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