claude-flow 3.59.13 → 3.59.14

package/.claude/proven-config.json

@@ -1,5 +1,5 @@
 {
-  "adoptedAt": 1792634570394,
+  "adoptedAt": 1792643533692,
   "championId": "sha256:6141a8ea990c5063b77e090ae8f37f9c539d8aa8f58dcceb30f3a82f97e57319",
   "manifest": {
     "schema": "ruflo.proven-config/v1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.59.13",
+  "version": "3.59.14",
   "workspaces": [
     "v3/@claude-flow/codex",
     "v3/@claude-flow/mcp",

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

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "generation": 7,
-  "generatedAt": "2026-10-22T02:03:09.504Z",
-  "gitSha": "056a11ec",
+  "generatedAt": "2026-10-22T04:32:33.371Z",
+  "gitSha": "88bdc9a6",
   "catalog": {
     "agents": 176,
     "tools": 432,

package/v3/@claude-flow/cli/dist/src/mcp-tools/memory-tools.js

@@ -21,6 +21,17 @@ import { DEFAULT_SEARCH_THRESHOLD, nearMisses } from '../memory/search-defaults.
 const MEMORY_DIR = '.swarm';
 const LEGACY_MEMORY_FILE = 'store.json';
 const LEGACY_MEMORY_DIR = '.claude-flow/memory';
+/**
+ * #3196: allow an MCP caller to select the same explicit store the CLI accepts
+ * via `--path`. No path means the existing MCP default is unchanged; this is
+ * deliberately not an implicit `CLAUDE_FLOW_DB_PATH` override because the
+ * native/encrypted CLI store and the AgentDB sibling are separate backends.
+ */
+function resolveDbPathOption(inputDbPath) {
+    return typeof inputDbPath === 'string' && inputDbPath.trim().length > 0
+        ? resolve(inputDbPath)
+        : undefined;
+}
 const MIGRATION_MARKER = '.migrated-to-sqlite';
 function getMemoryDir() {
     return resolve(MEMORY_DIR);
@@ -439,6 +450,7 @@ export const memoryTools = [
                     enum: ['user_claim', 'agent_output', 'system_observation', 'tool_result', 'unknown'],
                     description: 'ADR-323: who/what produced this value, so shared-namespace retrieval can filter by trust level instead of conflating a user\'s stated claim with an agent\'s own output. Default: "unknown".',
                 },
+                dbPath: { type: 'string', description: 'Explicit SQLite store to read/write; omit to use the MCP default (the native/AgentDB sibling).' },
             },
             required: ['key', 'value'],
         },
@@ -447,7 +459,9 @@ export const memoryTools = [
             if (missingKey) {
                 return { success: false, key: input.key, stored: false, hasEmbedding: false, ...missingKey };
             }
-            await ensureInitialized();
+            const dbPath = resolveDbPathOption(input.dbPath);
+            if (!dbPath)
+                await ensureInitialized();
             const { storeEntry } = await getMemoryFunctions();
             const key = input.key;
             const namespace = input.namespace || 'default';
@@ -486,6 +500,7 @@ export const memoryTools = [
                     ttl,
                     upsert,
                     provenanceType,
+                    dbPath,
                 });
                 const duration = performance.now() - startTime;
                 return {
@@ -522,6 +537,7 @@ export const memoryTools = [
             properties: {
                 key: { type: 'string', description: 'Memory key' },
                 namespace: { type: 'string', description: 'Namespace (default: "default")' },
+                dbPath: { type: 'string', description: 'Explicit SQLite store to read/write; omit to use the MCP default (the native/AgentDB sibling).' },
             },
             required: ['key'],
         },
@@ -530,13 +546,15 @@ export const memoryTools = [
             if (missingKey) {
                 return { key: input.key, namespace: input.namespace, value: null, found: false, ...missingKey };
             }
-            await ensureInitialized();
+            const dbPath = resolveDbPathOption(input.dbPath);
+            if (!dbPath)
+                await ensureInitialized();
             const { getEntry } = await getMemoryFunctions();
             const key = input.key;
             const namespace = input.namespace || 'default';
             validateMemoryInput(key, undefined, undefined, namespace);
             try {
-                const result = await getEntry({ key, namespace });
+                const result = await getEntry({ key, namespace, dbPath });
                 if (result.found && result.entry) {
                     // Try to parse JSON value
                     let value = result.entry.content;
@@ -594,6 +612,7 @@ export const memoryTools = [
                     items: { type: 'string', enum: ['user_claim', 'agent_output', 'system_observation', 'tool_result', 'unknown'] },
                     description: 'ADR-323: restrict results to these provenance types (e.g. exclude user_claim when fact-checking). Omit for no filtering. Enforced for standard and SmartRetrieval searches.',
                 },
+                dbPath: { type: 'string', description: 'Explicit SQLite store to read/write; omit to use the MCP default (the native/AgentDB sibling).' },
             },
             required: ['query'],
         },
@@ -602,7 +621,9 @@ export const memoryTools = [
             if (missingQuery) {
                 return { query: input.query, results: [], total: 0, ...missingQuery };
             }
-            await ensureInitialized();
+            const dbPath = resolveDbPathOption(input.dbPath);
+            if (!dbPath)
+                await ensureInitialized();
             const { searchEntries } = await getMemoryFunctions();
             const query = input.query;
             const provenanceFilter = input.provenance_filter;
@@ -649,6 +670,7 @@ export const memoryTools = [
                                 limit: req.limit || limit * 3,
                                 threshold: req.threshold ?? threshold,
                                 provenanceFilter,
+                                dbPath,
                             });
                             return {
                                 results: r.results.map(e => ({
@@ -693,7 +715,7 @@ export const memoryTools = [
                             };
                         });
                         const smartNearMisses = results.length === 0 && thresholdWasDefault
-                            ? await nearMisses(searchEntries, { query, namespace, provenanceFilter })
+                            ? await nearMisses(searchEntries, { query, namespace, provenanceFilter, dbPath })
                             : undefined;
                         return {
                             query,
@@ -721,6 +743,7 @@ export const memoryTools = [
                     limit,
                     threshold,
                     provenanceFilter,
+                    dbPath,
                 });
                 if (!result.success) {
                     return { query, results: [], total: 0, error: result.error };
@@ -744,7 +767,7 @@ export const memoryTools = [
                     };
                 });
                 const nearMissInfo = results.length === 0 && thresholdWasDefault
-                    ? await nearMisses(searchEntries, { query, namespace, provenanceFilter })
+                    ? await nearMisses(searchEntries, { query, namespace, provenanceFilter, dbPath })
                     : undefined;
                 return {
                     query,
@@ -775,6 +798,7 @@ export const memoryTools = [
             properties: {
                 key: { type: 'string', description: 'Memory key' },
                 namespace: { type: 'string', description: 'Namespace (default: "default")' },
+                dbPath: { type: 'string', description: 'Explicit SQLite store to read/write; omit to use the MCP default (the native/AgentDB sibling).' },
             },
             required: ['key'],
         },
@@ -783,13 +807,15 @@ export const memoryTools = [
             if (missingKey) {
                 return { success: false, key: input.key, namespace: input.namespace, deleted: false, ...missingKey };
             }
-            await ensureInitialized();
+            const dbPath = resolveDbPathOption(input.dbPath);
+            if (!dbPath)
+                await ensureInitialized();
             const { deleteEntry } = await getMemoryFunctions();
             const key = input.key;
             const namespace = input.namespace || 'default';
             validateMemoryInput(key, undefined, undefined, namespace);
             try {
-                const result = await deleteEntry({ key, namespace });
+                const result = await deleteEntry({ key, namespace, dbPath });
                 return {
                     success: result.deleted,
                     key,
@@ -825,10 +851,13 @@ export const memoryTools = [
                 },
                 limit: { type: 'number', description: 'Maximum results (default: 50)' },
                 offset: { type: 'number', description: 'Offset for pagination (default: 0)' },
+                dbPath: { type: 'string', description: 'Explicit SQLite store to read/write; omit to use the MCP default (the native/AgentDB sibling).' },
             },
         },
         handler: async (input) => {
-            await ensureInitialized();
+            const dbPath = resolveDbPathOption(input.dbPath);
+            if (!dbPath)
+                await ensureInitialized();
             const { listEntries } = await getMemoryFunctions();
             const namespace = input.namespace;
             const tags = Array.isArray(input.tags)
@@ -847,6 +876,7 @@ export const memoryTools = [
                     tags,
                     limit,
                     offset,
+                    dbPath,
                 });
                 const entries = result.entries.map(e => ({
                     key: e.key,
@@ -884,14 +914,14 @@ export const memoryTools = [
         inputSchema: {
             type: 'object',
             properties: {
-                dbPath: { type: 'string', description: 'Database file to inspect; omitted uses the MCP store default' },
+                dbPath: { type: 'string', description: 'Explicit SQLite store to read/write; omit to use the MCP default (the native/AgentDB sibling).' },
             },
         },
         handler: async (input) => {
             if (input.dbPath !== undefined && (typeof input.dbPath !== 'string' || !input.dbPath.trim())) {
                 return memoryStatsUnavailable('dbPath must be a non-empty string');
             }
-            const dbPath = typeof input.dbPath === 'string' ? resolve(input.dbPath) : undefined;
+            const dbPath = resolveDbPathOption(input.dbPath);
             // An explicit read must not initialize or migrate the unrelated default store.
             if (!dbPath)
                 await ensureInitialized();

package/v3/@claude-flow/cli/dist/src/mcp-tools/workflow-tools.js

@@ -583,7 +583,8 @@ export const workflowTools = [
             }
             // Sort by creation date (newest first)
             workflows.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
-            // Apply limit
+            // Count the matches before the limit cuts the page down
+            const total = workflows.length;
             const limit = input.limit || 20;
             workflows = workflows.slice(0, limit);
             return {
@@ -595,7 +596,7 @@ export const workflowTools = [
                     createdAt: w.createdAt,
                     completedAt: w.completedAt,
                 })),
-                total: workflows.length,
+                total,
                 filters: { status: input.status },
             };
         },

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

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