Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

extensions/bonjour/index.test.ts

@@ -0,0 +1,107 @@
+// Bonjour tests cover index plugin behavior.
+import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
+import { afterAll, describe, expect, it, vi } from "vitest";
+
+const mocks = vi.hoisted(() => ({
+  advertiserModuleLoaded: vi.fn(),
+  runtimeModuleLoaded: vi.fn(),
+  startGatewayBonjourAdvertiser: vi.fn(async () => ({ stop: vi.fn() })),
+  registerUncaughtExceptionHandler: vi.fn(),
+  registerUnhandledRejectionHandler: vi.fn(),
+}));
+
+vi.mock("./src/advertiser.js", () => {
+  mocks.advertiserModuleLoaded();
+  return {
+    startGatewayBonjourAdvertiser: mocks.startGatewayBonjourAdvertiser,
+  };
+});
+
+vi.mock("openclaw/plugin-sdk/runtime", () => {
+  mocks.runtimeModuleLoaded();
+  return {
+    registerUncaughtExceptionHandler: mocks.registerUncaughtExceptionHandler,
+    registerUnhandledRejectionHandler: mocks.registerUnhandledRejectionHandler,
+  };
+});
+
+const { default: bonjourPlugin } = await import("./index.js");
+
+afterAll(() => {
+  vi.doUnmock("./src/advertiser.js");
+  vi.doUnmock("openclaw/plugin-sdk/runtime");
+  vi.resetModules();
+});
+
+describe("bonjour plugin entry", () => {
+  it("lazy-loads advertiser runtime when gateway discovery advertises", async () => {
+    let discoveryService:
+      | Parameters<ReturnType<typeof createTestPluginApi>["registerGatewayDiscoveryService"]>[0]
+      | undefined;
+    const logger = {
+      info: vi.fn(),
+      warn: vi.fn(),
+      error: vi.fn(),
+      debug: vi.fn(),
+    };
+    const api = createTestPluginApi({
+      logger,
+      registerGatewayDiscoveryService(service) {
+        discoveryService = service;
+      },
+    });
+
+    expect(mocks.advertiserModuleLoaded).not.toHaveBeenCalled();
+    expect(mocks.runtimeModuleLoaded).not.toHaveBeenCalled();
+
+    bonjourPlugin.register(api);
+
+    expect(discoveryService?.id).toBe("bonjour");
+    expect(mocks.advertiserModuleLoaded).not.toHaveBeenCalled();
+    expect(mocks.runtimeModuleLoaded).not.toHaveBeenCalled();
+
+    if (!discoveryService) {
+      throw new Error("expected bonjour plugin to register a discovery service");
+    }
+
+    const stop = vi.fn();
+    mocks.startGatewayBonjourAdvertiser.mockResolvedValueOnce({ stop });
+
+    await expect(
+      discoveryService.advertise({
+        machineDisplayName: "Dev Box",
+        gatewayPort: 3210,
+        gatewayTlsEnabled: true,
+        gatewayTlsFingerprintSha256: "abc123",
+        gatewayDirectReachable: true,
+        canvasPort: 9876,
+        sshPort: 22,
+        tailnetDns: "dev.tailnet.ts.net",
+        cliPath: "/usr/local/bin/openclaw",
+        minimal: false,
+      }),
+    ).resolves.toEqual({ stop });
+
+    expect(mocks.advertiserModuleLoaded).toHaveBeenCalledTimes(1);
+    expect(mocks.runtimeModuleLoaded).toHaveBeenCalledTimes(1);
+    expect(mocks.startGatewayBonjourAdvertiser).toHaveBeenCalledWith(
+      {
+        instanceName: "Dev Box (OpenClaw)",
+        gatewayPort: 3210,
+        gatewayTlsEnabled: true,
+        gatewayTlsFingerprintSha256: "abc123",
+        gatewayDirectReachable: true,
+        canvasPort: 9876,
+        sshPort: 22,
+        tailnetDns: "dev.tailnet.ts.net",
+        cliPath: "/usr/local/bin/openclaw",
+        minimal: false,
+      },
+      {
+        logger,
+        registerUncaughtExceptionHandler: mocks.registerUncaughtExceptionHandler,
+        registerUnhandledRejectionHandler: mocks.registerUnhandledRejectionHandler,
+      },
+    );
+  });
+});