claude-flow 3.10.40 → 3.10.42

package/v3/@claude-flow/cli/dist/src/ruvector/router-trajectory.js

@@ -0,0 +1,87 @@
+/**
+ * Router trajectory collection (#2334 Phase 1)
+ *
+ * Opt-in per-decision dataset collection for the model router. The persisted
+ * bandit state (`.swarm/model-router-state.json`) keeps only aggregates —
+ * 9 Beta(α,β) cells and a capped/truncated history — which is not trainable
+ * material for the Phase 2 FastGRNN tier-classifier. This sidecar captures
+ * the per-example rows that training needs:
+ *
+ *   decision rows: { taskHash, task, embedding?, complexity, features,
+ *                    model, confidence, uncertainty, routedBy, ts }
+ *   outcome rows:  { taskHash, model, outcome, ts }
+ *
+ * joined offline on `taskHash` (sha256-16 of the task text).
+ *
+ * OFF by default. Enable with CLAUDE_FLOW_ROUTER_TRAJECTORY=1. Rows append to
+ * `.swarm/model-router-trajectories.jsonl` — local-only, same trust domain as
+ * the existing state file, but unlike it the rows contain full task text (up
+ * to 500 chars) and raw embeddings, which is why this is opt-in rather than
+ * always-on.
+ *
+ * Writes are best-effort: any fs error is swallowed (collection must never
+ * break routing), matching the state-file behavior in model-router.ts.
+ *
+ * @module router-trajectory
+ */
+import { createHash } from 'crypto';
+import { appendFileSync, existsSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+export const TRAJECTORY_FILE = '.swarm/model-router-trajectories.jsonl';
+/** Schema version stamped on every row so offline training can dispatch. */
+const ROW_VERSION = 1;
+export function trajectoryCollectionEnabled() {
+    return process.env.CLAUDE_FLOW_ROUTER_TRAJECTORY === '1';
+}
+/** Join key: first 16 hex chars of sha256(task). */
+export function taskHash(task) {
+    return createHash('sha256').update(task).digest('hex').slice(0, 16);
+}
+function appendRow(row) {
+    try {
+        const fullPath = join(process.cwd(), TRAJECTORY_FILE);
+        const dir = dirname(fullPath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        appendFileSync(fullPath, JSON.stringify(row) + '\n');
+    }
+    catch {
+        // Best-effort: collection must never break routing.
+    }
+}
+export function recordTrajectoryDecision(task, embedding, complexity, decision) {
+    if (!trajectoryCollectionEnabled())
+        return;
+    appendRow({
+        v: ROW_VERSION,
+        type: 'decision',
+        ts: new Date().toISOString(),
+        taskHash: taskHash(task),
+        task: task.slice(0, 500),
+        ...(embedding && embedding.length > 0 ? { embedding } : {}),
+        complexity: complexity.score,
+        features: {
+            lexicalComplexity: complexity.lexicalComplexity,
+            semanticDepth: complexity.semanticDepth,
+            taskScope: complexity.taskScope,
+            uncertaintyLevel: complexity.uncertaintyLevel,
+        },
+        model: decision.model,
+        confidence: decision.confidence,
+        uncertainty: decision.uncertainty,
+        routedBy: decision.routedBy,
+    });
+}
+export function recordTrajectoryOutcome(task, model, outcome) {
+    if (!trajectoryCollectionEnabled())
+        return;
+    appendRow({
+        v: ROW_VERSION,
+        type: 'outcome',
+        ts: new Date().toISOString(),
+        taskHash: taskHash(task),
+        model,
+        outcome,
+    });
+}
+//# sourceMappingURL=router-trajectory.js.map

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

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