Gateway: eager-init QMD backend on startup

src/gateway/server-startup-memory.test.ts

@@ -0,0 +1,65 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import type { OpenClawConfig } from "../config/config.js";
+
+const { getMemorySearchManagerMock } = vi.hoisted(() => ({
+  getMemorySearchManagerMock: vi.fn(),
+}));
+
+vi.mock("../memory/index.js", () => ({
+  getMemorySearchManager: getMemorySearchManagerMock,
+}));
+
+import { startGatewayMemoryBackend } from "./server-startup-memory.js";
+
+describe("startGatewayMemoryBackend", () => {
+  beforeEach(() => {
+    getMemorySearchManagerMock.mockReset();
+  });
+
+  it("skips initialization when memory backend is not qmd", async () => {
+    const cfg = {
+      agents: { list: [{ id: "main", default: true }] },
+      memory: { backend: "builtin" },
+    } as OpenClawConfig;
+    const log = { info: vi.fn(), warn: vi.fn() };
+
+    await startGatewayMemoryBackend({ cfg, log });
+
+    expect(getMemorySearchManagerMock).not.toHaveBeenCalled();
+    expect(log.info).not.toHaveBeenCalled();
+    expect(log.warn).not.toHaveBeenCalled();
+  });
+
+  it("initializes qmd backend for the default agent", async () => {
+    const cfg = {
+      agents: { list: [{ id: "ops", default: true }, { id: "main" }] },
+      memory: { backend: "qmd", qmd: {} },
+    } as OpenClawConfig;
+    const log = { info: vi.fn(), warn: vi.fn() };
+    getMemorySearchManagerMock.mockResolvedValue({ manager: { search: vi.fn() } });
+
+    await startGatewayMemoryBackend({ cfg, log });
+
+    expect(getMemorySearchManagerMock).toHaveBeenCalledWith({ cfg, agentId: "ops" });
+    expect(log.info).toHaveBeenCalledWith(
+      'qmd memory startup initialization armed for agent "ops"',
+    );
+    expect(log.warn).not.toHaveBeenCalled();
+  });
+
+  it("logs a warning when qmd manager init fails", async () => {
+    const cfg = {
+      agents: { list: [{ id: "main", default: true }] },
+      memory: { backend: "qmd", qmd: {} },
+    } as OpenClawConfig;
+    const log = { info: vi.fn(), warn: vi.fn() };
+    getMemorySearchManagerMock.mockResolvedValue({ manager: null, error: "qmd missing" });
+
+    await startGatewayMemoryBackend({ cfg, log });
+
+    expect(log.warn).toHaveBeenCalledWith(
+      'qmd memory startup initialization failed for agent "main": qmd missing',
+    );
+    expect(log.info).not.toHaveBeenCalled();
+  });
+});