🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
fix(memory): keep home-level helpers on the active project root
Rudy Celekli2203fa56dcc2
diff --git a/.claude/helpers/auto-memory-hook.mjs b/.claude/helpers/auto-memory-hook.mjsindex e0764c25cf..a83ce6cece 100755--- a/.claude/helpers/auto-memory-hook.mjs+++ b/.claude/helpers/auto-memory-hook.mjs@@ -12,12 +12,16 @@*/import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';-import { join, dirname } from 'path';+import { join, dirname, resolve } from 'path';import { fileURLToPath } from 'url';const __filename = fileURLToPath(import.meta.url);const __dirname = dirname(__filename);-const PROJECT_ROOT = join(__dirname, '../..');+// Home-level helpers can serve a different project. Keep the memory writer on+// the same project root as intelligence.cjs, which reads CLAUDE_PROJECT_DIR.+const PROJECT_ROOT = process.env.CLAUDE_PROJECT_DIR+ ? resolve(process.env.CLAUDE_PROJECT_DIR)+ : join(__dirname, '../..');const DATA_DIR = join(PROJECT_ROOT, '.claude-flow', 'data');const STORE_PATH = join(DATA_DIR, 'auto-memory-store.json');diff --git a/.claude/helpers/learning-service.mjs b/.claude/helpers/learning-service.mjsindex 7eabdc23c9..93fdc169f2 100755--- a/.claude/helpers/learning-service.mjs+++ b/.claude/helpers/learning-service.mjs@@ -19,14 +19,16 @@import { createRequire } from 'module';import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';-import { join, dirname } from 'path';+import { join, dirname, resolve } from 'path';import { fileURLToPath } from 'url';import { execSync, spawn } from 'child_process';import Database from 'better-sqlite3';const __filename = fileURLToPath(import.meta.url);const __dirname = dirname(__filename);-const PROJECT_ROOT = join(__dirname, '../..');+const PROJECT_ROOT = process.env.CLAUDE_PROJECT_DIR+ ? resolve(process.env.CLAUDE_PROJECT_DIR)+ : join(__dirname, '../..');const DATA_DIR = join(PROJECT_ROOT, '.claude-flow/learning');const DB_PATH = join(DATA_DIR, 'patterns.db');const METRICS_PATH = join(DATA_DIR, 'learning-metrics.json');diff --git a/.claude/helpers/metrics-db.mjs b/.claude/helpers/metrics-db.mjsindex db713ea3f2..b5e01003d2 100755--- a/.claude/helpers/metrics-db.mjs+++ b/.claude/helpers/metrics-db.mjs@@ -7,12 +7,14 @@import initSqlJs from 'sql.js';import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, statSync, openSync, writeSync, fsyncSync, closeSync, renameSync, rmSync } from 'fs';-import { dirname, join, basename } from 'path';+import { dirname, join, basename, resolve } from 'path';import { fileURLToPath } from 'url';import { execSync } from 'child_process';const __dirname = dirname(fileURLToPath(import.meta.url));-const PROJECT_ROOT = join(__dirname, '../..');+const PROJECT_ROOT = process.env.CLAUDE_PROJECT_DIR+ ? resolve(process.env.CLAUDE_PROJECT_DIR)+ : join(__dirname, '../..');const V3_DIR = join(PROJECT_ROOT, 'v3');const DB_PATH = join(PROJECT_ROOT, '.claude-flow', 'metrics.db');diff --git a/v3/@claude-flow/cli/.claude/helpers/auto-memory-hook.mjs b/v3/@claude-flow/cli/.claude/helpers/auto-memory-hook.mjsindex 409f689703..1fbf9b00d0 100755--- a/v3/@claude-flow/cli/.claude/helpers/auto-memory-hook.mjs+++ b/v3/@claude-flow/cli/.claude/helpers/auto-memory-hook.mjs@@ -12,12 +12,16 @@*/import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';-import { join, dirname } from 'path';+import { join, dirname, resolve } from 'path';import { fileURLToPath } from 'url';const __filename = fileURLToPath(import.meta.url);const __dirname = dirname(__filename);-const PROJECT_ROOT = join(__dirname, '../..');+// Home-level helpers can serve a different project. Keep the memory writer on+// the same project root as intelligence.cjs, which reads CLAUDE_PROJECT_DIR.+const PROJECT_ROOT = process.env.CLAUDE_PROJECT_DIR+ ? resolve(process.env.CLAUDE_PROJECT_DIR)+ : join(__dirname, '../..');const DATA_DIR = join(PROJECT_ROOT, '.claude-flow', 'data');const STORE_PATH = join(DATA_DIR, 'auto-memory-store.json');diff --git a/v3/@claude-flow/cli/.claude/helpers/learning-service.mjs b/v3/@claude-flow/cli/.claude/helpers/learning-service.mjsindex 4b46c31941..bbe2fac8ab 100755--- a/v3/@claude-flow/cli/.claude/helpers/learning-service.mjs+++ b/v3/@claude-flow/cli/.claude/helpers/learning-service.mjs@@ -19,14 +19,16 @@import { createRequire } from 'module';import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';-import { join, dirname } from 'path';+import { join, dirname, resolve } from 'path';import { fileURLToPath } from 'url';import { execSync, spawn } from 'child_process';import Database from 'better-sqlite3';const __filename = fileURLToPath(import.meta.url);const __dirname = dirname(__filename);-const PROJECT_ROOT = join(__dirname, '../..');+const PROJECT_ROOT = process.env.CLAUDE_PROJECT_DIR+ ? resolve(process.env.CLAUDE_PROJECT_DIR)+ : join(__dirname, '../..');const DATA_DIR = join(PROJECT_ROOT, '.claude-flow/learning');const DB_PATH = join(DATA_DIR, 'patterns.db');const METRICS_PATH = join(DATA_DIR, 'learning-metrics.json');diff --git a/v3/@claude-flow/cli/.claude/helpers/metrics-db.mjs b/v3/@claude-flow/cli/.claude/helpers/metrics-db.mjsindex f38440fb63..94936ad93e 100755--- a/v3/@claude-flow/cli/.claude/helpers/metrics-db.mjs+++ b/v3/@claude-flow/cli/.claude/helpers/metrics-db.mjs@@ -7,12 +7,14 @@import initSqlJs from 'sql.js';import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, statSync, openSync, writeSync, fsyncSync, closeSync, renameSync, rmSync } from 'fs';-import { dirname, join, basename } from 'path';+import { dirname, join, basename, resolve } from 'path';import { fileURLToPath } from 'url';import { execSync } from 'child_process';const __dirname = dirname(fileURLToPath(import.meta.url));-const PROJECT_ROOT = join(__dirname, '../..');+const PROJECT_ROOT = process.env.CLAUDE_PROJECT_DIR+ ? resolve(process.env.CLAUDE_PROJECT_DIR)+ : join(__dirname, '../..');const V3_DIR = join(PROJECT_ROOT, 'v3');const DB_PATH = join(PROJECT_ROOT, '.claude-flow', 'metrics.db');diff --git a/v3/@claude-flow/cli/__tests__/auto-memory-project-root-3286.test.ts b/v3/@claude-flow/cli/__tests__/auto-memory-project-root-3286.test.tsnew file mode 100644index 0000000000..8a8b6bda37--- /dev/null+++ b/v3/@claude-flow/cli/__tests__/auto-memory-project-root-3286.test.ts@@ -0,0 +1,86 @@+/** Regression for #3286: home-level helpers must write to the active project. */+import { afterEach, describe, expect, it } from 'vitest';+import { spawnSync } from 'node:child_process';+import { copyFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';+import { tmpdir } from 'node:os';+import { dirname, join, resolve } from 'node:path';+import { fileURLToPath } from 'node:url';++import { generateAutoMemoryHook } from '../src/init/helpers-generator.js';++const here = dirname(fileURLToPath(import.meta.url));+const packageHook = resolve(here, '../.claude/helpers/auto-memory-hook.mjs');+const dogfoodHook = resolve(here, '../../../../.claude/helpers/auto-memory-hook.mjs');+const tempRoots: string[] = [];++function fixture(source: string | null) {+ const root = mkdtempSync(join(tmpdir(), 'ruflo-root-3286-'));+ tempRoots.push(root);+ const project = join(root, 'project');+ const home = join(root, 'home');+ const hook = join(home, '.claude', 'helpers', 'auto-memory-hook.mjs');+ mkdirSync(project, { recursive: true });+ mkdirSync(dirname(hook), { recursive: true });+ if (source) copyFileSync(source, hook);+ else writeFileSync(hook, generateAutoMemoryHook());+ return { project, home, hook };+}++function run(hook: string, project: string, command: string) {+ const result = spawnSync(process.execPath, [hook, command], {+ cwd: project,+ env: { ...process.env, CLAUDE_PROJECT_DIR: project },+ encoding: 'utf8',+ timeout: 10_000,+ });+ expect(result.error).toBeUndefined();+ expect(result.status).toBe(0);+ return result.stdout;+}++afterEach(() => {+ for (const root of tempRoots.splice(0)) rmSync(root, { recursive: true, force: true });+});++describe('#3286 auto-memory project root', () => {+ for (const [name, source] of [['package', packageHook], ['repository', dogfoodHook]] as const) {+ it(`${name} helper imports and syncs into the project when invoked from HOME`, () => {+ const { project, home, hook } = fixture(source);+ const mockMemory = join(project, 'mock-memory.mjs');+ writeFileSync(mockMemory, `+import { writeFileSync } from 'node:fs';+export class AutoMemoryBridge {+ constructor(backend, config) { this.backend = backend; this.config = config; }+ async importFromAutoMemory() {+ await this.backend.store({ id: 'scope', key: 'scope', content: this.config.workingDir });+ return { imported: 1, skipped: 0 };+ }+ async syncToAutoMemory() {+ writeFileSync(new URL('./sync-root.txt', import.meta.url), this.config.workingDir);+ return { synced: 1, categories: [] };+ }+ async curateIndex() {}+}+`);+ mkdirSync(join(project, '.claude-flow'), { recursive: true });+ writeFileSync(join(project, '.claude-flow', 'memory-package.json'), JSON.stringify({ distPath: mockMemory }));++ expect(run(hook, project, 'import')).toContain('Imported 1 entries');+ const store = join(project, '.claude-flow', 'data', 'auto-memory-store.json');+ expect(JSON.parse(readFileSync(store, 'utf8'))[0].content).toBe(project);+ expect(run(hook, project, 'sync')).toContain('Synced 1 entries');+ expect(readFileSync(join(project, 'sync-root.txt'), 'utf8')).toBe(project);+ expect(existsSync(join(home, '.claude-flow', 'data', 'auto-memory-store.json'))).toBe(false);+ });+ }++ it('generated fallback reads the project store when invoked from HOME', () => {+ const { project, home, hook } = fixture(null);+ const data = join(project, '.claude-flow', 'data');+ mkdirSync(data, { recursive: true });+ writeFileSync(join(data, 'auto-memory-store.json'), '[]');++ expect(run(hook, project, 'status')).toContain('Store: Initialized');+ expect(existsSync(join(home, '.claude-flow', 'data'))).toBe(false);+ });+});diff --git a/v3/@claude-flow/cli/src/init/helpers-generator.ts b/v3/@claude-flow/cli/src/init/helpers-generator.tsindex f9f57fb340..c399102b37 100644--- a/v3/@claude-flow/cli/src/init/helpers-generator.ts+++ b/v3/@claude-flow/cli/src/init/helpers-generator.ts@@ -1015,12 +1015,14 @@ export function generateAutoMemoryHook(): string {*/import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';-import { join, dirname } from 'path';+import { join, dirname, resolve } from 'path';import { fileURLToPath } from 'url';const __filename = fileURLToPath(import.meta.url);const __dirname = dirname(__filename);-const PROJECT_ROOT = join(__dirname, '../..');+const PROJECT_ROOT = process.env.CLAUDE_PROJECT_DIR+ ? resolve(process.env.CLAUDE_PROJECT_DIR)+ : join(__dirname, '../..');const DATA_DIR = join(PROJECT_ROOT, '.claude-flow', 'data');const STORE_PATH = join(DATA_DIR, 'auto-memory-store.json');