feat(memory-sdk): add memory event journal bridge

src/plugin-sdk/memory-core-host-events.ts

@@ -0,0 +1 @@
+export * from "../memory-host-sdk/events.js";

src/plugin-sdk/memory-core.ts

@@ -46,6 +46,12 @@ export {
   withProgress,
   withProgressTotals,
 } from "./memory-core-host-runtime-cli.js";
+export {
+  appendMemoryHostEvent,
+  readMemoryHostEvents,
+  resolveMemoryHostEventLogPath,
+} from "./memory-core-host-events.js";
+export type { MemoryHostEvent } from "./memory-core-host-events.js";
 export {
   resolveMemoryCorePluginConfig,
   formatMemoryDreamingDay,

src/plugin-sdk/memory-host-events.test.ts

@@ -0,0 +1,60 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import {
+  appendMemoryHostEvent,
+  readMemoryHostEvents,
+  resolveMemoryHostEventLogPath,
+} from "./memory-host-events.js";
+
+const tempDirs: string[] = [];
+
+afterEach(async () => {
+  await Promise.all(tempDirs.splice(0).map((dir) => fs.rm(dir, { recursive: true, force: true })));
+});
+
+describe("memory host event journal helpers", () => {
+  it("appends and reads typed workspace events", async () => {
+    const workspaceDir = await fs.mkdtemp(path.join(os.tmpdir(), "memory-host-events-"));
+    tempDirs.push(workspaceDir);
+
+    await appendMemoryHostEvent(workspaceDir, {
+      type: "memory.recall.recorded",
+      timestamp: "2026-04-05T12:00:00.000Z",
+      query: "glacier backup",
+      resultCount: 1,
+      results: [
+        {
+          path: "memory/2026-04-05.md",
+          startLine: 1,
+          endLine: 3,
+          score: 0.9,
+        },
+      ],
+    });
+    await appendMemoryHostEvent(workspaceDir, {
+      type: "memory.dream.completed",
+      timestamp: "2026-04-05T13:00:00.000Z",
+      phase: "light",
+      lineCount: 4,
+      storageMode: "both",
+      inlinePath: path.join(workspaceDir, "memory", "2026-04-05.md"),
+      reportPath: path.join(workspaceDir, "memory", "dreaming", "light", "2026-04-05.md"),
+    });
+
+    const eventLogPath = resolveMemoryHostEventLogPath(workspaceDir);
+    await expect(fs.readFile(eventLogPath, "utf8")).resolves.toContain(
+      '"type":"memory.recall.recorded"',
+    );
+
+    const events = await readMemoryHostEvents({ workspaceDir });
+    const tail = await readMemoryHostEvents({ workspaceDir, limit: 1 });
+
+    expect(events).toHaveLength(2);
+    expect(events[0]?.type).toBe("memory.recall.recorded");
+    expect(events[1]?.type).toBe("memory.dream.completed");
+    expect(tail).toHaveLength(1);
+    expect(tail[0]?.type).toBe("memory.dream.completed");
+  });
+});

src/plugin-sdk/memory-host-events.ts

@@ -0,0 +1 @@
+export * from "../memory-host-sdk/events.js";