claude-flow 3.71.2 → 3.71.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (25) hide show
  1. package/.claude/helpers/auto-memory-hook.mjs +209 -55
  2. package/.claude/proven-config.json +1 -1
  3. package/.claude/security-scans/scan-all-quick.json +201 -0
  4. package/.claude/settings.json +2 -1
  5. package/README.md +2 -0
  6. package/package.json +1 -1
  7. package/v3/@claude-flow/cli/README.md +2 -0
  8. package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
  9. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +20 -1
  10. package/v3/@claude-flow/cli/dist/src/commands/hive-mind-worker.d.ts +10 -0
  11. package/v3/@claude-flow/cli/dist/src/commands/hive-mind-worker.js +20 -0
  12. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +27 -4
  13. package/v3/@claude-flow/cli/dist/src/init/settings-generator.js +4 -0
  14. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +3 -3
  15. package/v3/@claude-flow/cli/dist/src/mcp-tools/claims-tools.js +16 -9
  16. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +11 -1
  17. package/v3/@claude-flow/cli/dist/src/mcp-tools/task-tools.js +11 -0
  18. package/v3/@claude-flow/cli/dist/src/missions/schemas.d.ts +10 -10
  19. package/v3/@claude-flow/cli/dist/src/mods/headless-plugins.d.ts +16 -0
  20. package/v3/@claude-flow/cli/dist/src/mods/headless-plugins.js +30 -1
  21. package/v3/@claude-flow/cli/dist/src/services/daemon-autostart.d.ts +24 -0
  22. package/v3/@claude-flow/cli/dist/src/services/daemon-autostart.js +55 -1
  23. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.d.ts +15 -0
  24. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +28 -0
  25. package/v3/@claude-flow/cli/package.json +1 -1
@@ -9,6 +9,10 @@
9
9
  * node auto-memory-hook.mjs import # SessionStart: import auto memory files into backend
10
10
  * node auto-memory-hook.mjs sync # SessionEnd: sync insights back to MEMORY.md
11
11
  * node auto-memory-hook.mjs status # Show bridge status
12
+ * node auto-memory-hook.mjs read <namespace> <key> # Read-only exact lookup, prints JSON
13
+ *
14
+ * import and sync exit 1 when they fail (never 2, which Claude Code treats as
15
+ * "block"), so a failed write is visible without stopping the session.
12
16
  */
13
17
 
14
18
  import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync, unlinkSync, rmdirSync, rmSync, statSync } from 'fs';
@@ -57,6 +61,9 @@ function warnMemoryUnavailable() {
57
61
 
58
62
  const DEBUG = !!(process.env.RUFLO_DEBUG || process.env.DEBUG);
59
63
 
64
+ /** A command failure whose message is already complete; main prints it and exits 1. */
65
+ class HookFailure extends Error {}
66
+
60
67
  // ── Graceful shutdown (FIX 3) ───────────────────────────────────────────────
61
68
  // Track the backend in use so a SIGTERM/SIGINT mid-run can still flush it
62
69
  // (the JSON backend persists; a SQLite-backed one closes/flushes WAL) instead
@@ -76,8 +83,9 @@ async function gracefulExit(signal) {
76
83
  process.on('SIGTERM', () => { gracefulExit('SIGTERM'); });
77
84
  process.on('SIGINT', () => { gracefulExit('SIGINT'); });
78
85
 
79
- // Ensure data dir
80
- if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR, { recursive: true });
86
+ // The data directory is created lazily by import and sync only, so the
87
+ // read-only `read` subcommand never creates directories (#4685).
88
+ function ensureDataDir() { if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR, { recursive: true }); }
81
89
 
82
90
  // ============================================================================
83
91
  // Store write safety (#4058): intelligence.cjs read-modify-writes the same
@@ -118,6 +126,83 @@ function writeFileAtomic(filePath, text) {
118
126
  }
119
127
  }
120
128
 
129
+ // ============================================================================
130
+ // Strict store reads (#4685): only ENOENT means "no store yet". A read or
131
+ // parse failure, a non-array document, or an entry without a unique string id
132
+ // is an error, and the file is never rewritten, so its bytes stay intact.
133
+ // ============================================================================
134
+
135
+ class StoreError extends Error {
136
+ constructor(code, message, cause) {
137
+ super(message);
138
+ this.name = 'StoreError';
139
+ this.code = code;
140
+ if (cause) this.cause = cause;
141
+ }
142
+ }
143
+
144
+ function parseStoreText(text, filePath) {
145
+ let data;
146
+ try { data = JSON.parse(text); } catch (e) {
147
+ throw new StoreError('STORE_PARSE_FAILED', `${filePath} is not valid JSON (${e.message}); left unchanged`, e);
148
+ }
149
+ if (!Array.isArray(data)) {
150
+ throw new StoreError('STORE_NOT_ARRAY', `${filePath} does not hold a JSON array; left unchanged`);
151
+ }
152
+ const seen = new Set();
153
+ for (let i = 0; i < data.length; i++) {
154
+ const e = data[i];
155
+ if (!e || typeof e !== 'object' || Array.isArray(e)) {
156
+ throw new StoreError('STORE_BAD_ENTRY', `${filePath} entry ${i} is not an object; left unchanged`);
157
+ }
158
+ if (typeof e.id !== 'string' || e.id.length === 0) {
159
+ throw new StoreError('STORE_BAD_ID', `${filePath} entry ${i} has no string id; left unchanged`);
160
+ }
161
+ if (seen.has(e.id)) {
162
+ // intelligence.cjs de-duplicates the store by id when it consolidates,
163
+ // which repairs a duplicate an older writer left behind.
164
+ throw new StoreError('STORE_DUPLICATE_ID', `${filePath} holds duplicate id ${JSON.stringify(e.id)}; left unchanged`);
165
+ }
166
+ seen.add(e.id);
167
+ }
168
+ return data;
169
+ }
170
+
171
+ /** The parsed entries, or null when the file does not exist. Anything else throws a StoreError. */
172
+ function readStoreFile(filePath) {
173
+ let text;
174
+ try { text = readFileSync(filePath, 'utf-8'); } catch (e) {
175
+ if (e && e.code === 'ENOENT') return null;
176
+ const why = (e && (e.code || e.message)) || String(e);
177
+ throw new StoreError('STORE_READ_FAILED', `cannot read ${filePath} (${why}); left unchanged`, e);
178
+ }
179
+ return parseStoreText(text, filePath);
180
+ }
181
+
182
+ /**
183
+ * Re-read the store and check that every expected entry is present and equal
184
+ * under `same`, and that every deleted id is gone. Throws on any mismatch.
185
+ */
186
+ function verifyStoreFile(filePath, expected, deletedIds, same) {
187
+ const onDisk = readStoreFile(filePath);
188
+ if (onDisk === null) throw new StoreError('STORE_READBACK_MISMATCH', `${filePath} is missing after the write`);
189
+ const byId = new Map(onDisk.map((e) => [e.id, e]));
190
+ for (const [id, want] of expected) {
191
+ const got = byId.get(id);
192
+ if (!got) throw new StoreError('STORE_READBACK_MISMATCH', `${filePath} readback is missing entry ${JSON.stringify(id)}`);
193
+ if (!same(got, want)) throw new StoreError('STORE_READBACK_MISMATCH', `${filePath} readback differs for entry ${JSON.stringify(id)}`);
194
+ }
195
+ for (const id of deletedIds) {
196
+ if (!expected.has(id) && byId.has(id)) {
197
+ throw new StoreError('STORE_READBACK_MISMATCH', `${filePath} readback still holds deleted entry ${JSON.stringify(id)}`);
198
+ }
199
+ }
200
+ return onDisk;
201
+ }
202
+
203
+ const sameJson = (a, b) => JSON.stringify(a) === JSON.stringify(b);
204
+ const sameRecord = (a, b) => a.namespace === b.namespace && a.key === b.key && a.content === b.content;
205
+
121
206
  // Claude Code shares one auto-memory directory across every worktree of a
122
207
  // repository, but findGitRoot() in the memory package stops at a worktree's
123
208
  // `.git` FILE and keys the directory by the worktree path (#4058). Resolve the
@@ -149,21 +234,36 @@ class JsonFileBackend {
149
234
  this.entries = new Map();
150
235
  this.loadedIds = new Set();
151
236
  this.deletedIds = new Set();
237
+ // Entries this instance wrote (or deleted), so a caller can confirm them on disk.
238
+ this.written = new Map();
239
+ this.storePresent = false;
152
240
  }
153
241
 
154
242
  async initialize() {
155
- if (existsSync(this.filePath)) {
156
- try {
157
- const data = JSON.parse(readFileSync(this.filePath, 'utf-8'));
158
- if (Array.isArray(data)) {
159
- for (const entry of data) { this.entries.set(entry.id, entry); this.loadedIds.add(entry.id); }
160
- }
161
- } catch { /* start fresh */ }
243
+ // Throws on anything but a missing file, so a damaged store is never
244
+ // mistaken for an empty one and later overwritten (#4685).
245
+ const data = readStoreFile(this.filePath);
246
+ this.storePresent = data !== null;
247
+ for (const entry of data || []) { this.entries.set(entry.id, entry); this.loadedIds.add(entry.id); }
248
+ }
249
+
250
+ _track(entry) {
251
+ if (!entry || typeof entry.id !== 'string' || entry.id.length === 0) {
252
+ throw new StoreError('STORE_BAD_ID', 'refusing to store an entry without a string id');
162
253
  }
254
+ this.entries.set(entry.id, entry);
255
+ this.written.set(entry.id, entry);
256
+ this.deletedIds.delete(entry.id);
257
+ }
258
+
259
+ _forget(id) {
260
+ this.deletedIds.add(id);
261
+ this.written.delete(id);
262
+ return this.entries.delete(id);
163
263
  }
164
264
 
165
265
  async shutdown() { this._persist(); }
166
- async store(entry) { this.entries.set(entry.id, entry); this._persist(); }
266
+ async store(entry) { this._track(entry); this._persist(); }
167
267
  async get(id) { return this.entries.get(id) ?? null; }
168
268
  async getByKey(key, ns) {
169
269
  for (const e of this.entries.values()) {
@@ -178,10 +278,11 @@ class JsonFileBackend {
178
278
  if (updates.content !== undefined) e.content = updates.content;
179
279
  if (updates.tags) e.tags = updates.tags;
180
280
  e.updatedAt = Date.now();
281
+ this.written.set(id, e);
181
282
  this._persist();
182
283
  return e;
183
284
  }
184
- async delete(id) { this.deletedIds.add(id); return this.entries.delete(id); }
285
+ async delete(id) { return this._forget(id); }
185
286
  async query(opts) {
186
287
  let results = [...this.entries.values()];
187
288
  if (opts?.namespace) results = results.filter(e => e.namespace === opts.namespace);
@@ -199,8 +300,8 @@ class JsonFileBackend {
199
300
  return results;
200
301
  }
201
302
  async search() { return []; } // No vector search in JSON backend
202
- async bulkInsert(entries) { for (const e of entries) this.entries.set(e.id, e); this._persist(); }
203
- async bulkDelete(ids) { let n = 0; for (const id of ids) { this.deletedIds.add(id); if (this.entries.delete(id)) n++; } this._persist(); return n; }
303
+ async bulkInsert(entries) { for (const e of entries) this._track(e); this._persist(); }
304
+ async bulkDelete(ids) { let n = 0; for (const id of ids) { if (this._forget(id)) n++; } this._persist(); return n; }
204
305
  async count() { return this.entries.size; }
205
306
  async listNamespaces() {
206
307
  const ns = new Set();
@@ -209,8 +310,8 @@ class JsonFileBackend {
209
310
  }
210
311
  async clearNamespace(ns) {
211
312
  let n = 0;
212
- for (const [id, e] of this.entries) {
213
- if (e.namespace === ns) { this.deletedIds.add(id); this.entries.delete(id); n++; }
313
+ for (const [id, e] of [...this.entries]) {
314
+ if (e.namespace === ns) { this._forget(id); n++; }
214
315
  }
215
316
  this._persist();
216
317
  return n;
@@ -235,25 +336,24 @@ class JsonFileBackend {
235
336
  };
236
337
  }
237
338
 
339
+ // Errors propagate (#4685): a failed read, write or rename must reject the
340
+ // store/bulkInsert/shutdown call instead of resolving with an in-memory-only
341
+ // update. The readback runs inside the lock so a parallel writer cannot race it.
238
342
  _persist() {
239
- try {
240
- withStoreLock(this.filePath, () => {
241
- // Keep entries another writer (intelligence.cjs, a parallel hook) added
242
- // after we loaded; ours win on the same id, and our own deletes stay deleted.
243
- const merged = new Map(this.entries);
244
- try {
245
- const onDisk = JSON.parse(readFileSync(this.filePath, 'utf-8'));
246
- if (Array.isArray(onDisk)) {
247
- for (const e of onDisk) {
248
- if (e && !merged.has(e.id) && !this.loadedIds.has(e.id) && !this.deletedIds.has(e.id)) merged.set(e.id, e);
249
- }
250
- }
251
- } catch { /* missing or unreadable: write ours */ }
252
- writeFileAtomic(this.filePath, JSON.stringify([...merged.values()], null, 2));
253
- for (const id of merged.keys()) this.loadedIds.add(id);
254
- this.entries = merged;
255
- });
256
- } catch { /* best effort */ }
343
+ withStoreLock(this.filePath, () => {
344
+ // Keep entries another writer (intelligence.cjs, a parallel hook) added
345
+ // after we loaded; ours win on the same id, and our own deletes stay deleted.
346
+ // A missing file is the only case that writes without merging.
347
+ const merged = new Map(this.entries);
348
+ for (const e of readStoreFile(this.filePath) || []) {
349
+ if (!merged.has(e.id) && !this.loadedIds.has(e.id) && !this.deletedIds.has(e.id)) merged.set(e.id, e);
350
+ }
351
+ writeFileAtomic(this.filePath, JSON.stringify([...merged.values()], null, 2));
352
+ verifyStoreFile(this.filePath, merged, this.deletedIds, sameJson);
353
+ for (const id of merged.keys()) this.loadedIds.add(id);
354
+ this.entries = merged;
355
+ this.storePresent = true;
356
+ });
257
357
  }
258
358
  }
259
359
 
@@ -286,7 +386,7 @@ async function loadMemoryPackage() {
286
386
  }
287
387
 
288
388
  // Strategy 2: Use createRequire for CJS-style resolution (handles nested node_modules
289
- // when installed as a transitive dependency via npx ruflo / npx claude-flow)
389
+ // when installed as a transitive dependency via npx ruflo / npx @claude-flow/cli@latest)
290
390
  try {
291
391
  const { createRequire } = await import('module');
292
392
  const require = createRequire(join(MODULE_ROOT, 'package.json'));
@@ -365,6 +465,7 @@ async function doImport() {
365
465
  }
366
466
 
367
467
  const config = readConfig();
468
+ ensureDataDir();
368
469
  const backend = trackBackend(new JsonFileBackend(STORE_PATH));
369
470
  await backend.initialize();
370
471
 
@@ -395,19 +496,32 @@ async function doImport() {
395
496
  }
396
497
 
397
498
  const bridge = new memPkg.AutoMemoryBridge(backend, bridgeConfig);
499
+ const fileErrors = [];
500
+ if (typeof bridge.on === 'function') bridge.on('import:file-error', (info) => { fileErrors.push(info?.file || 'unknown'); });
398
501
 
502
+ // Success is reported only after the import, the final persist and a fresh
503
+ // readback of every entry this run wrote have all succeeded (#4685).
504
+ const failures = [];
505
+ let result = null;
399
506
  try {
400
- const result = await bridge.importFromAutoMemory();
401
- success(`Imported ${result.imported} entries (${result.skipped} skipped)`);
402
- dim(`├─ Backend entries: ${await backend.count()}`);
403
- dim(`├─ Learning: ${config.learningBridge.enabled ? 'active' : 'disabled'}`);
404
- dim(`├─ Graph: ${config.memoryGraph.enabled ? 'active' : 'disabled'}`);
405
- dim(`└─ Agent scopes: ${config.agentScopes.enabled ? 'active' : 'disabled'}`);
507
+ result = await bridge.importFromAutoMemory();
406
508
  } catch (err) {
407
- dim(`Import failed (non-critical): ${err.message}`);
509
+ failures.push(`import: ${err.message}`);
408
510
  }
409
-
410
- await backend.shutdown();
511
+ try {
512
+ await backend.shutdown();
513
+ verifyStoreFile(STORE_PATH, backend.written, backend.deletedIds, sameRecord);
514
+ } catch (err) {
515
+ failures.push(`persist: ${err.message}`);
516
+ }
517
+ if (fileErrors.length) failures.push(`unreadable source file(s): ${fileErrors.join(', ')}`);
518
+ if (failures.length) throw new HookFailure(`Import failed: ${failures.join('; ')}`);
519
+
520
+ success(`Imported ${result.imported} entries (${result.skipped} skipped), verified in ${STORE_PATH}`);
521
+ dim(`├─ Backend entries: ${await backend.count()}`);
522
+ dim(`├─ Learning: ${config.learningBridge.enabled ? 'active' : 'disabled'}`);
523
+ dim(`├─ Graph: ${config.memoryGraph.enabled ? 'active' : 'disabled'}`);
524
+ dim(`└─ Agent scopes: ${config.agentScopes.enabled ? 'active' : 'disabled'}`);
411
525
  }
412
526
 
413
527
  async function doSync() {
@@ -420,6 +534,7 @@ async function doSync() {
420
534
  }
421
535
 
422
536
  const config = readConfig();
537
+ ensureDataDir();
423
538
  const backend = trackBackend(new JsonFileBackend(STORE_PATH));
424
539
  await backend.initialize();
425
540
 
@@ -454,6 +569,7 @@ async function doSync() {
454
569
 
455
570
  const bridge = new memPkg.AutoMemoryBridge(backend, bridgeConfig);
456
571
 
572
+ let syncError = null;
457
573
  try {
458
574
  const syncResult = await bridge.syncToAutoMemory();
459
575
  success(`Synced ${syncResult.synced} entries to auto memory`);
@@ -467,11 +583,12 @@ async function doSync() {
467
583
  if (indexSkipped) dim(`MEMORY.md index unchanged (${indexSkipped.reason || 'nothing to curate'})`);
468
584
  else success('Curated MEMORY.md index');
469
585
  } catch (err) {
470
- dim(`Sync failed (non-critical): ${err.message}`);
586
+ syncError = err;
471
587
  }
472
588
 
473
589
  if (bridge.destroy) bridge.destroy();
474
590
  await backend.shutdown();
591
+ if (syncError) throw new HookFailure(`Sync failed: ${syncError.message}`);
475
592
  }
476
593
 
477
594
  async function doStatus() {
@@ -489,16 +606,44 @@ async function doStatus() {
489
606
  console.log(` MemoryGraph: ${config.memoryGraph.enabled ? '✅ Enabled' : '⏸ Disabled'}`);
490
607
  console.log(` AgentScopes: ${config.agentScopes.enabled ? '✅ Enabled' : '⏸ Disabled'}`);
491
608
 
492
- if (existsSync(STORE_PATH)) {
493
- try {
494
- const data = JSON.parse(readFileSync(STORE_PATH, 'utf-8'));
495
- console.log(` Entries: ${Array.isArray(data) ? data.length : 0}`);
496
- } catch { /* ignore */ }
609
+ try {
610
+ const data = readStoreFile(STORE_PATH);
611
+ if (data) console.log(` Entries: ${data.length}`);
612
+ } catch (err) {
613
+ console.log(` Entries: ❌ ${err.message}`);
497
614
  }
498
615
 
499
616
  console.log('');
500
617
  }
501
618
 
619
+ // Read-only exact lookup (#4685). It never loads the memory package, creates a
620
+ // directory, takes the write lock or calls shutdown, so it cannot change the store.
621
+ const READ_SCHEMA_VERSION = 1;
622
+ async function doRead(namespace, key) {
623
+ const out = { schemaVersion: READ_SCHEMA_VERSION, store: STORE_PATH, storePresent: false, namespace: namespace ?? null, key: key ?? null, found: false, entry: null };
624
+ const refuse = (code, message) => {
625
+ out.error = { code, message };
626
+ console.log(JSON.stringify(out, null, 2));
627
+ return 1;
628
+ };
629
+ if (typeof namespace !== 'string' || !namespace || typeof key !== 'string' || !key) {
630
+ return refuse('USAGE', 'usage: auto-memory-hook.mjs read <namespace> <key>');
631
+ }
632
+ const backend = new JsonFileBackend(STORE_PATH);
633
+ try {
634
+ await backend.initialize();
635
+ } catch (err) {
636
+ out.storePresent = true; // initialize() only throws for a file that exists
637
+ return refuse(err.code || 'STORE_READ_FAILED', err.message);
638
+ }
639
+ out.storePresent = backend.storePresent;
640
+ const matches = await backend.query({ namespace, key });
641
+ if (matches.length > 1) return refuse('AMBIGUOUS_KEY', `${matches.length} entries share namespace ${JSON.stringify(namespace)} and key ${JSON.stringify(key)}`);
642
+ if (matches.length === 1) { out.found = true; out.entry = matches[0]; }
643
+ console.log(JSON.stringify(out, null, 2));
644
+ return 0;
645
+ }
646
+
502
647
  // ============================================================================
503
648
  // Main
504
649
  // ============================================================================
@@ -506,8 +651,10 @@ async function doStatus() {
506
651
  // Older settings.json files run `node -e "…import(file)" import`, where the
507
652
  // subcommand lands in argv[1] and argv[2] is empty, so both hooks fell through
508
653
  // to `status` and never imported or synced (#4058). Accept that shape too.
509
- const COMMANDS = ['import', 'sync', 'status'];
654
+ const COMMANDS = ['import', 'sync', 'status', 'read'];
655
+ const argvBase = process.argv[2] ? 2 : 1;
510
656
  const command = process.argv[2] || (COMMANDS.includes(process.argv[1]) ? process.argv[1] : 'status');
657
+ const commandArgs = process.argv.slice(argvBase + 1);
511
658
 
512
659
  // Dynamic import() failures can surface as unhandled rejections on a later
513
660
  // microtask even when the awaiting call site already caught them, which would
@@ -521,18 +668,25 @@ process.on('unhandledRejection', (reason) => {
521
668
  }
522
669
  });
523
670
 
671
+ // A failed import or sync exits 1, never 2: Claude Code treats exit 2 from a
672
+ // hook as "block", while exit 1 is a non-blocking error it shows to the user,
673
+ // so the session carries on and the failure is no longer hidden (#4685).
674
+ let exitCode = 0;
524
675
  try {
525
676
  switch (command) {
526
677
  case 'import': await doImport(); break;
527
678
  case 'sync': await doSync(); break;
528
679
  case 'status': await doStatus(); break;
680
+ case 'read': exitCode = await doRead(commandArgs[0], commandArgs[1]); break;
529
681
  default:
530
- console.log('Usage: auto-memory-hook.mjs <import|sync|status>');
682
+ console.log('Usage: auto-memory-hook.mjs <import|sync|status|read <namespace> <key>>');
531
683
  break;
532
684
  }
533
685
  } catch (err) {
534
- // Hooks must never crash Claude Code - fail silently
535
- try { dim(`Error (non-critical): ${err.message}`); } catch (_) {}
686
+ exitCode = 1;
687
+ const detail = err && err.message ? err.message : String(err);
688
+ const line = err instanceof HookFailure ? `[AutoMemory] ${detail}` : `[AutoMemory] ${command} failed: ${detail}`;
689
+ try { process.stderr.write(`${line}\n`); } catch (_) {}
536
690
  }
537
- // Force clean exit — process.exitCode alone isn't enough if async errors override it
538
- process.exit(0);
691
+ // Force exit — process.exitCode alone isn't enough if async errors override it
692
+ process.exit(exitCode);
@@ -1,5 +1,5 @@
1
1
  {
2
- "adoptedAt": 1793816224786,
2
+ "adoptedAt": 1793836180662,
3
3
  "championId": "sha256:6141a8ea990c5063b77e090ae8f37f9c539d8aa8f58dcceb30f3a82f97e57319",
4
4
  "manifest": {
5
5
  "schema": "ruflo.proven-config/v1",
@@ -0,0 +1,201 @@
1
+ {
2
+ "timestamp": "2026-11-04T23:51:38.536Z",
3
+ "target": ".",
4
+ "depth": "quick",
5
+ "type": "all",
6
+ "summary": {
7
+ "critical": 0,
8
+ "high": 18,
9
+ "medium": 13,
10
+ "low": 0,
11
+ "total": 31
12
+ },
13
+ "findings": [
14
+ {
15
+ "severity": "high",
16
+ "type": "Dependency CVE",
17
+ "location": "package.json:@claude-flow/plugin-gastown-bridge",
18
+ "description": "Vulnerability"
19
+ },
20
+ {
21
+ "severity": "medium",
22
+ "type": "Dependency CVE",
23
+ "location": "package.json:@electron/asar",
24
+ "description": "Vulnerability"
25
+ },
26
+ {
27
+ "severity": "high",
28
+ "type": "Dependency CVE",
29
+ "location": "package.json:@grpc/grpc-js",
30
+ "description": "@grpc/grpc-js: In certain configura"
31
+ },
32
+ {
33
+ "severity": "medium",
34
+ "type": "Dependency CVE",
35
+ "location": "package.json:@hono/node-server",
36
+ "description": "@hono/node-server: `serveStatic` de"
37
+ },
38
+ {
39
+ "severity": "high",
40
+ "type": "Dependency CVE",
41
+ "location": "package.json:@huggingface/transformers",
42
+ "description": "Vulnerability"
43
+ },
44
+ {
45
+ "severity": "medium",
46
+ "type": "Dependency CVE",
47
+ "location": "package.json:@vitest/mocker",
48
+ "description": "Vitest: Path Traversal / Arbitrary "
49
+ },
50
+ {
51
+ "severity": "high",
52
+ "type": "Dependency CVE",
53
+ "location": "package.json:@xenova/transformers",
54
+ "description": "Vulnerability"
55
+ },
56
+ {
57
+ "severity": "high",
58
+ "type": "Dependency CVE",
59
+ "location": "package.json:adm-zip",
60
+ "description": "adm-zip: Crafted ZIP file triggers "
61
+ },
62
+ {
63
+ "severity": "high",
64
+ "type": "Dependency CVE",
65
+ "location": "package.json:agentic-flow",
66
+ "description": "Vulnerability"
67
+ },
68
+ {
69
+ "severity": "high",
70
+ "type": "Dependency CVE",
71
+ "location": "package.json:axios",
72
+ "description": "Axios: Prototype pollution gadget i"
73
+ },
74
+ {
75
+ "severity": "high",
76
+ "type": "Dependency CVE",
77
+ "location": "package.json:body-parser",
78
+ "description": "body-parser vulnerable to Denial of"
79
+ },
80
+ {
81
+ "severity": "high",
82
+ "type": "Dependency CVE",
83
+ "location": "package.json:brace-expansion",
84
+ "description": "brace-expansion: Quadratic-time exp"
85
+ },
86
+ {
87
+ "severity": "medium",
88
+ "type": "Dependency CVE",
89
+ "location": "package.json:fast-uri",
90
+ "description": "fast-uri vulnerable to inconsistent"
91
+ },
92
+ {
93
+ "severity": "high",
94
+ "type": "Dependency CVE",
95
+ "location": "package.json:follow-redirects",
96
+ "description": "follow-redirects array-form headers"
97
+ },
98
+ {
99
+ "severity": "medium",
100
+ "type": "Dependency CVE",
101
+ "location": "package.json:gaxios",
102
+ "description": "Vulnerability"
103
+ },
104
+ {
105
+ "severity": "medium",
106
+ "type": "Dependency CVE",
107
+ "location": "package.json:glob",
108
+ "description": "Glob: AbortSignal cancellation bypa"
109
+ },
110
+ {
111
+ "severity": "medium",
112
+ "type": "Dependency CVE",
113
+ "location": "package.json:hono",
114
+ "description": "Hono: Incomplete fix for CVE-2026-3"
115
+ },
116
+ {
117
+ "severity": "medium",
118
+ "type": "Dependency CVE",
119
+ "location": "package.json:ip-address",
120
+ "description": "ip-address: Address6.isLinkLocal() "
121
+ },
122
+ {
123
+ "severity": "medium",
124
+ "type": "Dependency CVE",
125
+ "location": "package.json:js-yaml",
126
+ "description": "js-yaml: maxTotalMergeKeys does not"
127
+ },
128
+ {
129
+ "severity": "medium",
130
+ "type": "Dependency CVE",
131
+ "location": "package.json:minimatch",
132
+ "description": "minimatch has potential denial of s"
133
+ },
134
+ {
135
+ "severity": "high",
136
+ "type": "Dependency CVE",
137
+ "location": "package.json:onnxruntime-node",
138
+ "description": "Vulnerability"
139
+ },
140
+ {
141
+ "severity": "medium",
142
+ "type": "Dependency CVE",
143
+ "location": "package.json:qs",
144
+ "description": "qs array-limit bypass via bracket-k"
145
+ },
146
+ {
147
+ "severity": "medium",
148
+ "type": "Dependency CVE",
149
+ "location": "package.json:rimraf",
150
+ "description": "Vulnerability"
151
+ },
152
+ {
153
+ "severity": "high",
154
+ "type": "Dependency CVE",
155
+ "location": "package.json:sharp",
156
+ "description": "sharp inherited vulnerabilities in "
157
+ },
158
+ {
159
+ "severity": "high",
160
+ "type": "Dependency CVE",
161
+ "location": "package.json:source-map-js",
162
+ "description": "source-map-js allows event-loop den"
163
+ },
164
+ {
165
+ "severity": "high",
166
+ "type": "Dependency CVE",
167
+ "location": "package.json:undici",
168
+ "description": "undici vulnerable to Denial of Serv"
169
+ },
170
+ {
171
+ "severity": "high",
172
+ "type": "Dependency CVE",
173
+ "location": "package.json:vite",
174
+ "description": "launch-editor: escapeCmdArgs() omit"
175
+ },
176
+ {
177
+ "severity": "medium",
178
+ "type": "Dependency CVE",
179
+ "location": "package.json:vitest",
180
+ "description": "Vulnerability"
181
+ },
182
+ {
183
+ "severity": "high",
184
+ "type": "Dependency CVE",
185
+ "location": "package.json:zod",
186
+ "description": "Zod can exhaust memory while valida"
187
+ },
188
+ {
189
+ "severity": "high",
190
+ "type": "Hardcoded Secret",
191
+ "location": "ruflo/docker-compose.public.yml:21",
192
+ "description": "Hardcoded Password"
193
+ },
194
+ {
195
+ "severity": "high",
196
+ "type": "Hardcoded Secret",
197
+ "location": "ruflo/docker-compose.yml:112",
198
+ "description": "API Key (Stripe/OpenAI)"
199
+ }
200
+ ]
201
+ }
@@ -49,7 +49,8 @@
49
49
  {
50
50
  "type": "command",
51
51
  "command": "node \"$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs\" pre-bash",
52
- "timeout": 5000
52
+ "timeout": 5000,
53
+ "onFailure": "block"
53
54
  }
54
55
  ]
55
56
  }
package/README.md CHANGED
@@ -36,6 +36,8 @@
36
36
  /ruflo
37
37
  ```
38
38
 
39
+ From a terminal on Claude Code 2.1.292 or later, one command adds the marketplace and installs a plugin: `claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo`.
40
+
39
41
  **Core** provides foundation tools. **Console** opens the agent cockpit. **Mods** add routing and policy enforcement inside Claude Code. Mods run with your account's permissions; review their code before installing.
40
42
 
41
43
  <img src="docs/assets/readme/icons/terminal.svg" width="28" height="28" alt=""> **Using Codex or another MCP enabled tool?** Use NPX for Ruflo project setup and connect your client to the Ruflo MCP server. Run the setup wizard in your project terminal:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-flow",
3
- "version": "3.71.2",
3
+ "version": "3.71.3",
4
4
  "workspaces": [
5
5
  "v3/@claude-flow/codex",
6
6
  "v3/@claude-flow/mcp",
@@ -36,6 +36,8 @@
36
36
  /ruflo
37
37
  ```
38
38
 
39
+ From a terminal on Claude Code 2.1.292 or later, one command adds the marketplace and installs a plugin: `claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo`.
40
+
39
41
  **Core** provides foundation tools. **Console** opens the agent cockpit. **Mods** add routing and policy enforcement inside Claude Code. Mods run with your account's permissions; review their code before installing.
40
42
 
41
43
  <img src="docs/assets/readme/icons/terminal.svg" width="28" height="28" alt=""> **Using Codex or another MCP enabled tool?** Use NPX for Ruflo project setup and connect your client to the Ruflo MCP server. Run the setup wizard in your project terminal: