@lumenflow/memory 3.8.7 → 3.9.1

package/dist/__tests__/control-plane-sync-adapter.test.js

@@ -0,0 +1,232 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { afterEach, describe, expect, it } from 'vitest';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { loadSignals } from '../mem-signal-core.js';
+import { createControlPlaneSyncAdapter, DEFAULT_CONTROL_PLANE_SYNC_STATE_PATH, } from '../control-plane-sync-adapter.js';
+const SIGNALS_FILE = path.join('.lumenflow', 'memory', 'signals.jsonl');
+const MEMORY_FILE = path.join('.lumenflow', 'memory', 'memory.jsonl');
+const WORKSPACE_ID = 'workspace-test';
+const SESSION_ID = 'session-test';
+async function writeJsonl(filePath, records) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    const content = records.map((record) => JSON.stringify(record)).join('\n');
+    await fs.writeFile(filePath, `${content}${content ? '\n' : ''}`, 'utf-8');
+}
+async function readSyncState(baseDir) {
+    const statePath = path.join(baseDir, DEFAULT_CONTROL_PLANE_SYNC_STATE_PATH);
+    const raw = await fs.readFile(statePath, 'utf-8');
+    return JSON.parse(raw);
+}
+describe('control-plane sync adapter (WU-2152)', () => {
+    const tempRoots = [];
+    afterEach(async () => {
+        await Promise.all(tempRoots.map((root) => fs.rm(root, { recursive: true, force: true })));
+        tempRoots.length = 0;
+    });
+    it('pushes local-only signals and ignores origin:remote entries', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'control-plane-sync-adapter-'));
+        tempRoots.push(root);
+        await writeJsonl(path.join(root, SIGNALS_FILE), [
+            {
+                id: 'sig-local01',
+                message: 'local signal',
+                created_at: '2026-03-02T00:00:00.000Z',
+                read: false,
+                wu_id: 'WU-2152',
+                type: 'handoff',
+            },
+            {
+                id: 'sig-remote01',
+                message: 'remote signal',
+                created_at: '2026-03-02T00:00:01.000Z',
+                read: false,
+                wu_id: 'WU-2152',
+                origin: 'remote',
+            },
+        ]);
+        const pushInputs = [];
+        const adapter = createControlPlaneSyncAdapter({
+            baseDir: root,
+            workspaceId: WORKSPACE_ID,
+            sessionId: SESSION_ID,
+            signalPort: {
+                async pushSignals(input) {
+                    pushInputs.push(input.signals);
+                    return { accepted: input.signals.length };
+                },
+                async pullSignals() {
+                    return { signals: [] };
+                },
+            },
+            memoryPort: {
+                async syncMemory() {
+                    return { pushed: 0, pulled: 0, conflicts: [] };
+                },
+            },
+        });
+        const result = await adapter.pushLocalSignals();
+        expect(result.pushed).toBe(1);
+        expect(pushInputs).toHaveLength(1);
+        expect(pushInputs[0]).toEqual([
+            expect.objectContaining({
+                id: 'sig-local01',
+                kind: 'handoff',
+                origin: 'local',
+            }),
+        ]);
+        const syncState = await readSyncState(root);
+        expect(syncState.lastPushedSignalId).toBe('sig-local01');
+    });
+    it('pulls remote signals to local JSONL and prevents re-push echo loops', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'control-plane-sync-adapter-'));
+        tempRoots.push(root);
+        const pushedSignals = [];
+        const adapter = createControlPlaneSyncAdapter({
+            baseDir: root,
+            workspaceId: WORKSPACE_ID,
+            sessionId: SESSION_ID,
+            signalPort: {
+                async pushSignals(input) {
+                    pushedSignals.push(input.signals);
+                    return { accepted: input.signals.length };
+                },
+                async pullSignals() {
+                    return {
+                        signals: [
+                            {
+                                id: 'sig-remote-100',
+                                kind: 'handoff',
+                                timestamp: '2026-03-02T00:10:00.000Z',
+                                payload: {
+                                    message: 'remote handoff',
+                                    wu_id: 'WU-2152',
+                                    lane: 'Framework: Memory',
+                                },
+                                origin: 'remote',
+                                source_agent_id: 'agent-remote',
+                            },
+                        ],
+                        next_cursor: 'cursor-100',
+                    };
+                },
+            },
+            memoryPort: {
+                async syncMemory() {
+                    return { pushed: 0, pulled: 0, conflicts: [] };
+                },
+            },
+        });
+        const pullResult = await adapter.pullSignals();
+        expect(pullResult.pulled).toBe(1);
+        const localSignals = await loadSignals(root, { wuId: 'WU-2152' });
+        expect(localSignals).toHaveLength(1);
+        expect(localSignals[0]).toEqual(expect.objectContaining({
+            message: 'remote handoff',
+            origin: 'remote',
+            remote_id: 'sig-remote-100',
+        }));
+        const pushResult = await adapter.pushLocalSignals();
+        expect(pushResult.pushed).toBe(0);
+        expect(pushedSignals).toHaveLength(0);
+        const syncState = await readSyncState(root);
+        expect(syncState.pullCursor).toBe('cursor-100');
+    });
+    it('syncs only project lifecycle memory nodes', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'control-plane-sync-adapter-'));
+        tempRoots.push(root);
+        await writeJsonl(path.join(root, MEMORY_FILE), [
+            {
+                id: 'mem-p001',
+                type: 'note',
+                lifecycle: 'project',
+                content: 'project memory',
+                created_at: '2026-03-02T00:00:00.000Z',
+            },
+            {
+                id: 'mem-w001',
+                type: 'note',
+                lifecycle: 'wu',
+                content: 'wu memory',
+                created_at: '2026-03-02T00:00:01.000Z',
+            },
+        ]);
+        let capturedLocalRecords = [];
+        const adapter = createControlPlaneSyncAdapter({
+            baseDir: root,
+            workspaceId: WORKSPACE_ID,
+            sessionId: SESSION_ID,
+            signalPort: {
+                async pushSignals() {
+                    return { accepted: 0 };
+                },
+                async pullSignals() {
+                    return { signals: [] };
+                },
+            },
+            memoryPort: {
+                async syncMemory(input) {
+                    capturedLocalRecords = input.local_records.map((record) => ({
+                        id: record.id,
+                        namespace: record.namespace,
+                        key: record.key,
+                    }));
+                    return { pushed: input.local_records.length, pulled: 0, conflicts: [] };
+                },
+            },
+        });
+        const result = await adapter.syncProjectMemory();
+        expect(result.pushed).toBe(1);
+        expect(capturedLocalRecords).toEqual([
+            {
+                id: 'mem-p001',
+                namespace: 'project',
+                key: 'mem-p001',
+            },
+        ]);
+    });
+    it('opens circuit breaker after 3 consecutive remote failures', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'control-plane-sync-adapter-'));
+        tempRoots.push(root);
+        await writeJsonl(path.join(root, SIGNALS_FILE), [
+            {
+                id: 'sig-local-fail',
+                message: 'local signal',
+                created_at: '2026-03-02T00:00:00.000Z',
+                read: false,
+            },
+        ]);
+        const nowMs = 1_000;
+        let remoteAttempts = 0;
+        const adapter = createControlPlaneSyncAdapter({
+            baseDir: root,
+            workspaceId: WORKSPACE_ID,
+            sessionId: SESSION_ID,
+            now: () => nowMs,
+            signalPort: {
+                async pushSignals() {
+                    remoteAttempts += 1;
+                    throw new Error('remote unavailable');
+                },
+                async pullSignals() {
+                    return { signals: [] };
+                },
+            },
+            memoryPort: {
+                async syncMemory() {
+                    return { pushed: 0, pulled: 0, conflicts: [] };
+                },
+            },
+        });
+        await adapter.pushLocalSignals();
+        await adapter.pushLocalSignals();
+        await adapter.pushLocalSignals();
+        expect(remoteAttempts).toBe(3);
+        const result = await adapter.pushLocalSignals();
+        expect(result.skippedReason).toBe('circuit-open');
+        expect(remoteAttempts).toBe(3);
+    });
+});
+//# sourceMappingURL=control-plane-sync-adapter.test.js.map

package/dist/__tests__/control-plane-sync-adapter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane-sync-adapter.test.js","sourceRoot":"","sources":["../../src/__tests__/control-plane-sync-adapter.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/memory-promotion.test.js

@@ -0,0 +1,92 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { afterEach, describe, expect, it } from 'vitest';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { promoteProjectMemory } from '../memory-promotion.js';
+const MEMORY_RELATIVE_PATH = path.join('.lumenflow', 'memory', 'memory.jsonl');
+function fixtureNode(id, lifecycle, overrides = {}) {
+    return {
+        id,
+        type: 'note',
+        lifecycle,
+        content: `node-${id}`,
+        created_at: '2026-03-01T12:00:00.000Z',
+        ...overrides,
+    };
+}
+async function writeMemory(baseDir, nodes) {
+    const memoryFile = path.join(baseDir, MEMORY_RELATIVE_PATH);
+    await fs.mkdir(path.dirname(memoryFile), { recursive: true });
+    const content = nodes.map((node) => JSON.stringify(node)).join('\n');
+    await fs.writeFile(memoryFile, `${content}${content ? '\n' : ''}`, 'utf-8');
+}
+async function readMemory(baseDir) {
+    const memoryFile = path.join(baseDir, MEMORY_RELATIVE_PATH);
+    try {
+        const content = await fs.readFile(memoryFile, 'utf-8');
+        return content
+            .split('\n')
+            .filter((line) => line.trim().length > 0)
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+describe('promoteProjectMemory (WU-2145)', () => {
+    const tempRoots = [];
+    afterEach(async () => {
+        await Promise.all(tempRoots.map((root) => fs.rm(root, { recursive: true, force: true })));
+        tempRoots.length = 0;
+    });
+    it('promotes only project lifecycle nodes from worktree memory to main memory', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'memory-promotion-'));
+        tempRoots.push(root);
+        const mainDir = path.join(root, 'main');
+        const worktreeDir = path.join(root, 'worktree');
+        await writeMemory(mainDir, [fixtureNode('mem-mai1', 'project')]);
+        await writeMemory(worktreeDir, [
+            fixtureNode('mem-pro1', 'project'),
+            fixtureNode('mem-ses1', 'session'),
+            fixtureNode('mem-wu01', 'wu'),
+        ]);
+        const result = await promoteProjectMemory(worktreeDir, mainDir);
+        expect(result.promotedCount).toBe(1);
+        expect(result.promotedNodeIds).toEqual(['mem-pro1']);
+        const mainMemory = await readMemory(mainDir);
+        const ids = mainMemory.map((node) => node.id);
+        expect(ids).toContain('mem-mai1');
+        expect(ids).toContain('mem-pro1');
+        expect(ids).not.toContain('mem-ses1');
+        expect(ids).not.toContain('mem-wu01');
+    });
+    it('is a no-op when no project nodes exist in the worktree memory', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'memory-promotion-'));
+        tempRoots.push(root);
+        const mainDir = path.join(root, 'main');
+        const worktreeDir = path.join(root, 'worktree');
+        await writeMemory(mainDir, []);
+        await writeMemory(worktreeDir, [fixtureNode('mem-sess', 'session')]);
+        const result = await promoteProjectMemory(worktreeDir, mainDir);
+        expect(result.promotedCount).toBe(0);
+        expect(result.promotedNodeIds).toEqual([]);
+        const mainMemory = await readMemory(mainDir);
+        expect(mainMemory).toHaveLength(0);
+    });
+    it('skips project nodes that already exist in main memory (idempotent)', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'memory-promotion-'));
+        tempRoots.push(root);
+        const mainDir = path.join(root, 'main');
+        const worktreeDir = path.join(root, 'worktree');
+        await writeMemory(mainDir, [fixtureNode('mem-proj', 'project')]);
+        await writeMemory(worktreeDir, [fixtureNode('mem-proj', 'project')]);
+        const result = await promoteProjectMemory(worktreeDir, mainDir);
+        expect(result.promotedCount).toBe(0);
+        expect(result.promotedNodeIds).toEqual([]);
+        const mainMemory = await readMemory(mainDir);
+        expect(mainMemory.filter((node) => node.id === 'mem-proj')).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=memory-promotion.test.js.map

package/dist/__tests__/memory-promotion.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-promotion.test.js","sourceRoot":"","sources":["../../src/__tests__/memory-promotion.test.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAW9D,MAAM,oBAAoB,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AAE/E,SAAS,WAAW,CAClB,EAAU,EACV,SAAyC,EACzC,YAAwC,EAAE;IAE1C,OAAO;QACL,EAAE;QACF,IAAI,EAAE,MAAM;QACZ,SAAS;QACT,OAAO,EAAE,QAAQ,EAAE,EAAE;QACrB,UAAU,EAAE,0BAA0B;QACtC,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,OAAe,EAAE,KAA0B;IACpE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,OAAe;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,OAAO;aACX,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;aACxC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsB,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1F,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;QAC3E,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEhD,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,WAAW,CAAC,WAAW,EAAE;YAC7B,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC;YAClC,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC;YAClC,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC;SAC9B,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAEhE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAErD,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;QAC3E,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEhD,MAAM,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/B,MAAM,WAAW,CAAC,WAAW,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QAErE,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAEhE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAE3C,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;QAC3E,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEhD,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,WAAW,CAAC,WAAW,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QAErE,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAEhE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAE3C,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/signal-schema-extension.test.js

@@ -0,0 +1,79 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { afterEach, describe, expect, it } from 'vitest';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { createSignal, loadSignals } from '../mem-signal-core.js';
+const SIGNALS_RELATIVE_PATH = path.join('.lumenflow', 'memory', 'signals.jsonl');
+async function writeSignals(baseDir, records) {
+    const signalsPath = path.join(baseDir, SIGNALS_RELATIVE_PATH);
+    await fs.mkdir(path.dirname(signalsPath), { recursive: true });
+    const lines = records.map((record) => JSON.stringify(record)).join('\n');
+    await fs.writeFile(signalsPath, `${lines}${lines ? '\n' : ''}`, 'utf-8');
+}
+describe('signal contract enforcement (WU-2291)', () => {
+    const tempRoots = [];
+    afterEach(async () => {
+        await Promise.all(tempRoots.map((root) => fs.rm(root, { recursive: true, force: true })));
+        tempRoots.length = 0;
+    });
+    it('fails explicitly on legacy signals that omit strict metadata fields', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'signal-schema-extension-'));
+        tempRoots.push(root);
+        await writeSignals(root, [
+            {
+                id: 'sig-legacy1',
+                message: 'legacy signal',
+                created_at: '2026-03-01T12:00:00.000Z',
+                read: false,
+                wu_id: 'WU-2146',
+            },
+        ]);
+        await expect(loadSignals(root, { wuId: 'WU-2146' })).rejects.toThrow(/legacy signal record is not supported/i);
+    });
+    it('writes canonical strict metadata defaults for local signals', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'signal-schema-extension-'));
+        tempRoots.push(root);
+        const created = await createSignal(root, {
+            message: 'local signal without explicit metadata',
+            wuId: 'WU-2146',
+        });
+        expect(created.signal.type).toBe('coordination');
+        expect(created.signal.sender).toBe('system');
+        expect(created.signal.origin).toBe('local');
+        expect(created.signal.remote_id).toBe(created.signal.id);
+        const loaded = await loadSignals(root, { wuId: 'WU-2146' });
+        expect(loaded).toHaveLength(1);
+        expect(loaded[0]?.type).toBe('coordination');
+        expect(loaded[0]?.sender).toBe('system');
+        expect(loaded[0]?.origin).toBe('local');
+        expect(loaded[0]?.remote_id).toBe(loaded[0]?.id);
+    });
+    it('round-trips explicit metadata fields through create/load JSONL flow', async () => {
+        const root = await fs.mkdtemp(path.join(os.tmpdir(), 'signal-schema-extension-'));
+        tempRoots.push(root);
+        const created = await createSignal(root, {
+            message: 'handoff to remote agent',
+            wuId: 'WU-2146',
+            type: 'handoff',
+            sender: 'agent-alpha',
+            target_agent: 'agent-beta',
+            origin: 'mcp',
+            remote_id: 'remote-123',
+        });
+        expect(created.signal.type).toBe('handoff');
+        expect(created.signal.sender).toBe('agent-alpha');
+        expect(created.signal.target_agent).toBe('agent-beta');
+        expect(created.signal.origin).toBe('mcp');
+        expect(created.signal.remote_id).toBe('remote-123');
+        const loaded = await loadSignals(root, { wuId: 'WU-2146' });
+        expect(loaded).toHaveLength(1);
+        expect(loaded[0]?.type).toBe('handoff');
+        expect(loaded[0]?.sender).toBe('agent-alpha');
+        expect(loaded[0]?.target_agent).toBe('agent-beta');
+        expect(loaded[0]?.origin).toBe('mcp');
+        expect(loaded[0]?.remote_id).toBe('remote-123');
+    });
+});
+//# sourceMappingURL=signal-schema-extension.test.js.map

package/dist/__tests__/signal-schema-extension.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-schema-extension.test.js","sourceRoot":"","sources":["../../src/__tests__/signal-schema-extension.test.ts"],"names":[],"mappings":"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"}

package/dist/control-plane-sync-adapter.js

@@ -0,0 +1,267 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { loadSignals, createSignal } from './mem-signal-core.js';
+import { loadMemory } from './memory-store.js';
+const REMOTE_TIMEOUT_MS = 200;
+const CIRCUIT_FAILURE_THRESHOLD = 3;
+const CIRCUIT_OPEN_MS = 60_000;
+const SKIPPED_CIRCUIT_OPEN = 'circuit-open';
+export const DEFAULT_CONTROL_PLANE_SYNC_STATE_PATH = path.join('.lumenflow', 'state', 'control-plane-sync.json');
+const DEFAULT_SYNC_STATE = {
+    remoteFailureCount: 0,
+    circuitOpenUntilMs: 0,
+};
+function asString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function buildSignalPayload(signal) {
+    return {
+        message: signal.message,
+        wu_id: signal.wu_id,
+        lane: signal.lane,
+        sender: signal.sender,
+        target_agent: signal.target_agent,
+    };
+}
+function toRemoteSignal(signal) {
+    return {
+        id: signal.id,
+        kind: signal.type ?? 'signal',
+        timestamp: signal.created_at,
+        payload: buildSignalPayload(signal),
+        origin: 'local',
+        source_agent_id: signal.sender,
+    };
+}
+function extractMessage(signal) {
+    const payloadMessage = signal.payload.message;
+    if (typeof payloadMessage === 'string' && payloadMessage.trim().length > 0) {
+        return payloadMessage;
+    }
+    return `[${signal.kind}] remote signal`;
+}
+async function runWithTimeout(promise, timeoutMs) {
+    let timer;
+    const timeoutPromise = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error('Remote control-plane call timed out')), timeoutMs);
+    });
+    try {
+        return await Promise.race([promise, timeoutPromise]);
+    }
+    finally {
+        if (timer) {
+            clearTimeout(timer);
+        }
+    }
+}
+function isCircuitOpen(state, nowMs) {
+    return state.circuitOpenUntilMs > nowMs;
+}
+function markRemoteFailure(state, options, nowMs) {
+    const nextFailureCount = state.remoteFailureCount + 1;
+    if (nextFailureCount >= options.circuitFailureThreshold) {
+        return {
+            ...state,
+            remoteFailureCount: 0,
+            circuitOpenUntilMs: nowMs + options.circuitOpenMs,
+        };
+    }
+    return {
+        ...state,
+        remoteFailureCount: nextFailureCount,
+    };
+}
+function clearRemoteFailures(state) {
+    return {
+        ...state,
+        remoteFailureCount: 0,
+        circuitOpenUntilMs: 0,
+    };
+}
+async function readSyncState(baseDir) {
+    const syncStatePath = path.join(baseDir, DEFAULT_CONTROL_PLANE_SYNC_STATE_PATH);
+    try {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- path is rooted to baseDir + constant
+        const raw = await fs.readFile(syncStatePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return {
+            ...DEFAULT_SYNC_STATE,
+            ...parsed,
+            remoteFailureCount: parsed.remoteFailureCount ?? 0,
+            circuitOpenUntilMs: parsed.circuitOpenUntilMs ?? 0,
+        };
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            return { ...DEFAULT_SYNC_STATE };
+        }
+        throw error;
+    }
+}
+async function writeSyncState(baseDir, state) {
+    const syncStatePath = path.join(baseDir, DEFAULT_CONTROL_PLANE_SYNC_STATE_PATH);
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- path is rooted to baseDir + constant
+    await fs.mkdir(path.dirname(syncStatePath), { recursive: true });
+    const serializable = {
+        lastPushedSignalId: state.lastPushedSignalId,
+        pullCursor: state.pullCursor,
+        memoryCursor: state.memoryCursor,
+        remoteFailureCount: state.remoteFailureCount,
+        circuitOpenUntilMs: state.circuitOpenUntilMs,
+    };
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- path is rooted to baseDir + constant
+    await fs.writeFile(syncStatePath, `${JSON.stringify(serializable, null, 2)}\n`, 'utf-8');
+}
+function getSignalsAfterWatermark(signals, lastPushedSignalId) {
+    if (!lastPushedSignalId) {
+        return signals;
+    }
+    const markerIndex = signals.findIndex((signal) => signal.id === lastPushedSignalId);
+    if (markerIndex < 0) {
+        return signals;
+    }
+    return signals.slice(markerIndex + 1);
+}
+function toProjectMemoryRecords(memory) {
+    return memory.nodes
+        .filter((node) => node.lifecycle === 'project')
+        .map((node) => ({
+        id: node.id,
+        namespace: 'project',
+        key: node.id,
+        value: {
+            type: node.type,
+            lifecycle: node.lifecycle,
+            content: node.content,
+            created_at: node.created_at,
+            updated_at: node.updated_at,
+            wu_id: node.wu_id,
+            metadata: node.metadata,
+            tags: node.tags,
+        },
+        updated_at: node.updated_at ?? node.created_at,
+        origin: 'local',
+    }));
+}
+export function createControlPlaneSyncAdapter(options) {
+    const now = options.now ?? Date.now;
+    const remoteTimeoutMs = options.remoteTimeoutMs ?? REMOTE_TIMEOUT_MS;
+    const circuitOpenMs = options.circuitOpenMs ?? CIRCUIT_OPEN_MS;
+    const circuitFailureThreshold = options.circuitFailureThreshold ?? CIRCUIT_FAILURE_THRESHOLD;
+    const circuitConfig = {
+        circuitFailureThreshold,
+        circuitOpenMs,
+    };
+    async function executeRemote(action) {
+        const state = await readSyncState(options.baseDir);
+        const nowMs = now();
+        if (isCircuitOpen(state, nowMs)) {
+            return { ok: false, state };
+        }
+        try {
+            const result = await action(state);
+            const nextState = clearRemoteFailures(state);
+            await writeSyncState(options.baseDir, nextState);
+            return { ok: true, result, state: nextState };
+        }
+        catch {
+            const nextState = markRemoteFailure(state, circuitConfig, nowMs);
+            await writeSyncState(options.baseDir, nextState);
+            return { ok: false, state: nextState };
+        }
+    }
+    return {
+        async pushLocalSignals() {
+            const state = await readSyncState(options.baseDir);
+            if (isCircuitOpen(state, now())) {
+                return { pushed: 0, skippedReason: SKIPPED_CIRCUIT_OPEN };
+            }
+            const allSignals = await loadSignals(options.baseDir);
+            const afterWatermark = getSignalsAfterWatermark(allSignals, state.lastPushedSignalId);
+            const localSignals = afterWatermark.filter((signal) => signal.origin !== 'remote');
+            if (localSignals.length === 0) {
+                return { pushed: 0 };
+            }
+            const remoteSignals = localSignals.map(toRemoteSignal);
+            const remoteResult = await executeRemote(async () => runWithTimeout(options.signalPort.pushSignals({
+                workspace_id: options.workspaceId,
+                session_id: options.sessionId,
+                signals: remoteSignals,
+            }), remoteTimeoutMs));
+            if (!remoteResult.ok) {
+                const refreshed = await readSyncState(options.baseDir);
+                if (isCircuitOpen(refreshed, now())) {
+                    return { pushed: 0, skippedReason: SKIPPED_CIRCUIT_OPEN };
+                }
+                return { pushed: 0, skippedReason: 'remote-error' };
+            }
+            const currentState = await readSyncState(options.baseDir);
+            const nextState = {
+                ...currentState,
+                lastPushedSignalId: localSignals[localSignals.length - 1]?.id,
+            };
+            await writeSyncState(options.baseDir, nextState);
+            return { pushed: remoteResult.result.accepted };
+        },
+        async pullSignals() {
+            const remoteResult = await executeRemote(async (state) => runWithTimeout(options.signalPort.pullSignals({
+                workspace_id: options.workspaceId,
+                session_id: options.sessionId,
+                cursor: state.pullCursor,
+            }), remoteTimeoutMs));
+            if (!remoteResult.ok) {
+                const refreshed = await readSyncState(options.baseDir);
+                if (isCircuitOpen(refreshed, now())) {
+                    return { pulled: 0, skippedReason: SKIPPED_CIRCUIT_OPEN };
+                }
+                return { pulled: 0, skippedReason: 'remote-error' };
+            }
+            const pullResponse = remoteResult.result;
+            for (const signal of pullResponse.signals) {
+                await createSignal(options.baseDir, {
+                    message: extractMessage(signal),
+                    wuId: asString(signal.payload.wu_id),
+                    lane: asString(signal.payload.lane),
+                    type: signal.kind,
+                    sender: signal.source_agent_id,
+                    target_agent: asString(signal.payload.target_agent),
+                    origin: 'remote',
+                    remote_id: signal.id,
+                });
+            }
+            const currentState = await readSyncState(options.baseDir);
+            const nextState = {
+                ...currentState,
+                pullCursor: pullResponse.next_cursor ?? currentState.pullCursor,
+            };
+            await writeSyncState(options.baseDir, nextState);
+            return { pulled: pullResponse.signals.length };
+        },
+        async syncProjectMemory() {
+            const state = await readSyncState(options.baseDir);
+            const indexedMemory = await loadMemory(path.join(options.baseDir, '.lumenflow', 'memory'));
+            const localRecords = toProjectMemoryRecords(indexedMemory);
+            const remoteResult = await executeRemote(() => runWithTimeout(options.memoryPort.syncMemory({
+                workspace_id: options.workspaceId,
+                session_id: options.sessionId,
+                direction: 'bidirectional',
+                local_records: localRecords,
+                cursor: state.memoryCursor,
+            }), remoteTimeoutMs));
+            if (!remoteResult.ok) {
+                return { pushed: 0, pulled: 0, conflicts: [] };
+            }
+            const currentState = await readSyncState(options.baseDir);
+            const nextState = {
+                ...currentState,
+                memoryCursor: remoteResult.result.next_cursor ?? currentState.memoryCursor,
+            };
+            await writeSyncState(options.baseDir, nextState);
+            return remoteResult.result;
+        },
+    };
+}
+//# sourceMappingURL=control-plane-sync-adapter.js.map

package/dist/control-plane-sync-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane-sync-adapter.js","sourceRoot":"","sources":["../src/control-plane-sync-adapter.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -20,11 +20,13 @@ export { filterSummarizableNodes, summarizeWu, getCompactionRatio as getSummariz
 export * from './mem-triage-core.js';
 export * from './mem-index-core.js';
 export * from './mem-promote-core.js';
+export * from './memory-promotion.js';
 export * from './mem-profile-core.js';
 export * from './mem-delete-core.js';
 export * from './mem-recover-core.js';
 export * from './memory-schema.js';
 export * from './memory-store.js';
+export * from './control-plane-sync-adapter.js';
 // WU-1238: Decay scoring and access tracking
 export * from './decay/scoring.js';
 export * from './decay/access-tracking.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;GAGG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,kBAAkB,IAAI,2BAA2B,GAClD,MAAM,yBAAyB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAElC,6CAA6C;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;GAGG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,kBAAkB,IAAI,2BAA2B,GAClD,MAAM,yBAAyB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iCAAiC,CAAC;AAEhD,6CAA6C;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC"}

package/dist/mem-signal-core.js

@@ -50,7 +50,62 @@ const SIGNAL_ID_LENGTH = 8;
 const ERROR_MESSAGES = {
     MESSAGE_REQUIRED: 'message is required and cannot be empty',
     INVALID_WU_ID: 'Invalid WU ID format. Expected WU-XXX (e.g., WU-1473)',
+    INVALID_SIGNAL_METADATA: 'Signal metadata fields must be non-empty strings when provided',
+    LEGACY_SIGNAL_RECORD: 'Legacy signal record is not supported by the strict signal contract. Migrate records before loading signals.',
+    INVALID_SIGNAL_RECORD: 'Invalid signal record in signals.jsonl',
 };
+const DEFAULT_SIGNAL_TYPE = 'coordination';
+const DEFAULT_SIGNAL_SENDER = 'system';
+const DEFAULT_SIGNAL_ORIGIN = 'local';
+function normalizeOptionalString(value, fieldName) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const normalized = value.trim();
+    if (normalized.length === 0) {
+        throw createError(ErrorCodes.VALIDATION_ERROR, `${ERROR_MESSAGES.INVALID_SIGNAL_METADATA}: ${fieldName}`);
+    }
+    return normalized;
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function parseStrictSignalRecord(line, lineNumber) {
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        throw createError(ErrorCodes.VALIDATION_ERROR, `${ERROR_MESSAGES.INVALID_SIGNAL_RECORD} at line ${lineNumber}`);
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        throw createError(ErrorCodes.VALIDATION_ERROR, `${ERROR_MESSAGES.INVALID_SIGNAL_RECORD} at line ${lineNumber}`);
+    }
+    const candidate = parsed;
+    if (!isNonEmptyString(candidate.id) ||
+        !isNonEmptyString(candidate.message) ||
+        !isNonEmptyString(candidate.created_at) ||
+        typeof candidate.read !== 'boolean') {
+        throw createError(ErrorCodes.VALIDATION_ERROR, `${ERROR_MESSAGES.INVALID_SIGNAL_RECORD} at line ${lineNumber}`);
+    }
+    if (!isNonEmptyString(candidate.type) ||
+        !isNonEmptyString(candidate.sender) ||
+        !isNonEmptyString(candidate.origin) ||
+        !isNonEmptyString(candidate.remote_id)) {
+        throw createError(ErrorCodes.VALIDATION_ERROR, `${ERROR_MESSAGES.LEGACY_SIGNAL_RECORD} (line ${lineNumber})`);
+    }
+    return {
+        ...candidate,
+        id: candidate.id,
+        message: candidate.message,
+        created_at: candidate.created_at,
+        read: candidate.read,
+        type: candidate.type,
+        sender: candidate.sender,
+        origin: candidate.origin,
+        remote_id: candidate.remote_id,
+    };
+}
 /**
  * Generates a unique signal ID using random bytes.
  *
@@ -152,7 +207,7 @@ function isValidWuId(wuId) {
  * });
  */
 export async function createSignal(baseDir, options) {
-    const { message, wuId, lane } = options;
+    const { message, wuId, lane, type, sender, target_agent, origin, remote_id } = options;
     // Validate message is provided and non-empty
     if (!message || typeof message !== 'string' || message.trim().length === 0) {
         throw createError(ErrorCodes.VALIDATION_ERROR, ERROR_MESSAGES.MESSAGE_REQUIRED);
@@ -161,13 +216,23 @@ export async function createSignal(baseDir, options) {
     if (wuId !== undefined && !isValidWuId(wuId)) {
         throw createError(ErrorCodes.INVALID_WU_ID, ERROR_MESSAGES.INVALID_WU_ID);
     }
+    const normalizedType = normalizeOptionalString(type, 'type') ?? DEFAULT_SIGNAL_TYPE;
+    const normalizedSender = normalizeOptionalString(sender, 'sender') ?? DEFAULT_SIGNAL_SENDER;
+    const normalizedTargetAgent = normalizeOptionalString(target_agent, 'target_agent');
+    const normalizedOrigin = normalizeOptionalString(origin, 'origin') ?? DEFAULT_SIGNAL_ORIGIN;
+    const normalizedRemoteId = normalizeOptionalString(remote_id, 'remote_id');
     // Build signal object
     const signal = {
         id: generateSignalId(),
         message: message.trim(),
         created_at: new Date().toISOString(),
         read: false,
+        type: normalizedType,
+        sender: normalizedSender,
+        origin: normalizedOrigin,
+        remote_id: '',
     };
+    signal.remote_id = normalizedRemoteId ?? signal.id;
     // Add optional fields
     if (wuId) {
         signal.wu_id = wuId;
@@ -175,6 +240,9 @@ export async function createSignal(baseDir, options) {
     if (lane) {
         signal.lane = lane;
     }
+    if (normalizedTargetAgent) {
+        signal.target_agent = normalizedTargetAgent;
+    }
     // Ensure memory directory exists
     const memoryDir = getMemoryDir(baseDir);
     // eslint-disable-next-line security/detect-non-literal-fs-filename -- CLI tool creates known directory
@@ -228,7 +296,7 @@ export async function loadSignals(baseDir, options = {}) {
     }
     // Parse JSONL content
     const lines = content.split('\n').filter((line) => line.trim());
-    const signals = lines.map((line) => JSON.parse(line));
+    const signals = lines.map((line, index) => parseStrictSignalRecord(line, index + 1));
     // Merge receipt-based read state (WU-1472)
     const receiptIds = await loadReceiptIds(baseDir);
     for (const signal of signals) {

package/dist/mem-signal-core.js.map

@@ -1 +1 @@
-{"version":3,"file":"mem-signal-core.js","sourceRoot":"","sources":["../src/mem-signal-core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mem-signal-core.js","sourceRoot":"","sources":["../src/mem-signal-core.ts"],"names":[],"mappings":"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"}

package/dist/memory-promotion.js

@@ -0,0 +1,62 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Project memory promotion for wu:done cleanup flow (WU-2145).
+ *
+ * Copies project-lifecycle memory nodes from a WU worktree memory store to the
+ * main checkout memory store before worktree deletion.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { appendNode, loadMemoryAll } from './memory-store.js';
+import { LUMENFLOW_MEMORY_PATHS } from './paths.js';
+const PROJECT_LIFECYCLE = 'project';
+function isProjectNode(node) {
+    return node.lifecycle === PROJECT_LIFECYCLE;
+}
+function resolveMemoryDir(baseDir) {
+    return path.join(baseDir, LUMENFLOW_MEMORY_PATHS.MEMORY_DIR);
+}
+/**
+ * Promote project-lifecycle nodes from worktree memory into main memory.
+ *
+ * Rules:
+ * - Only nodes with lifecycle='project' are eligible
+ * - Nodes already present in main memory (same id) are skipped
+ * - If no project nodes exist, this is a no-op
+ */
+export async function promoteProjectMemory(worktreeDir, mainDir) {
+    const worktreeMemoryDir = resolveMemoryDir(worktreeDir);
+    const mainMemoryDir = resolveMemoryDir(mainDir);
+    const worktreeMemory = await loadMemoryAll(worktreeMemoryDir);
+    const mainMemory = await loadMemoryAll(mainMemoryDir);
+    const projectNodes = worktreeMemory.nodes.filter(isProjectNode);
+    if (projectNodes.length === 0) {
+        return {
+            promotedCount: 0,
+            promotedNodeIds: [],
+            skippedCount: 0,
+            skippedNodeIds: [],
+        };
+    }
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- path is derived from vetted workspace root + fixed memory dir suffix.
+    await fs.mkdir(mainMemoryDir, { recursive: true });
+    const promotedNodeIds = [];
+    const skippedNodeIds = [];
+    for (const node of projectNodes) {
+        if (mainMemory.byId.has(node.id)) {
+            skippedNodeIds.push(node.id);
+            continue;
+        }
+        await appendNode(mainMemoryDir, node);
+        mainMemory.byId.set(node.id, node);
+        promotedNodeIds.push(node.id);
+    }
+    return {
+        promotedCount: promotedNodeIds.length,
+        promotedNodeIds,
+        skippedCount: skippedNodeIds.length,
+        skippedNodeIds,
+    };
+}
+//# sourceMappingURL=memory-promotion.js.map

package/dist/memory-promotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-promotion.js","sourceRoot":"","sources":["../src/memory-promotion.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,iBAAiB,GAAG,SAAS,CAAC;AASpC,SAAS,aAAa,CAAC,IAAgB;IACrC,OAAO,IAAI,CAAC,SAAS,KAAK,iBAAiB,CAAC;AAC9C,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,OAAe;IAEf,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEhD,MAAM,cAAc,GAAG,MAAM,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,CAAC;IAEtD,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAChE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,eAAe,EAAE,EAAE;YACnB,YAAY,EAAE,CAAC;YACf,cAAc,EAAE,EAAE;SACnB,CAAC;IACJ,CAAC;IAED,4IAA4I;IAC5I,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnD,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACjC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,MAAM,UAAU,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACtC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACnC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,OAAO;QACL,aAAa,EAAE,eAAe,CAAC,MAAM;QACrC,eAAe;QACf,YAAY,EAAE,cAAc,CAAC,MAAM;QACnC,cAAc;KACf,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/memory",
-  "version": "3.8.7",
+  "version": "3.9.1",
   "description": "Memory layer for LumenFlow workflow framework - session tracking, context recovery, and agent coordination",
   "keywords": [
     "lumenflow",
@@ -56,7 +56,7 @@
     "ms": "^2.1.3",
     "yaml": "^2.8.2",
     "zod": "^4.3.6",
-    "@lumenflow/core": "3.8.7"
+    "@lumenflow/core": "3.9.1"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",