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

test/scripts/config-reload-log-scanner.test.ts

@@ -0,0 +1,123 @@
+// Config Reload Log Scanner tests cover config reload log scanner script behavior.
+import { appendFileSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { createConfigReloadLogScanner } from "../../scripts/e2e/lib/config-reload/log-scanner.mjs";
+
+const tempRoots: string[] = [];
+
+function makeTempRoot(): string {
+  const root = mkdtempSync(path.join(tmpdir(), "openclaw-config-reload-log-"));
+  tempRoots.push(root);
+  return root;
+}
+
+afterEach(() => {
+  for (const root of tempRoots.splice(0)) {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
+describe("config reload log scanner", () => {
+  it("keeps previous matches while reading only appended log lines", () => {
+    const logPath = path.join(makeTempRoot(), "gateway.log");
+    const scanner = createConfigReloadLogScanner(logPath, {
+      maxReadBytes: 1024,
+      tailLineLimit: 4,
+    });
+
+    expect(scanner.scan()).toEqual({ reloadLines: [], restartLines: [], tailLines: [] });
+
+    writeFileSync(logPath, "gateway boot\n");
+    expect(scanner.scan()).toEqual({
+      reloadLines: [],
+      restartLines: [],
+      tailLines: ["gateway boot"],
+    });
+
+    appendFileSync(logPath, "config change detected; evaluating reload: plugins.entries.demo\n");
+    expect(scanner.scan().reloadLines).toEqual([
+      "config change detected; evaluating reload: plugins.entries.demo",
+    ]);
+
+    appendFileSync(logPath, "later noise\n");
+    expect(scanner.scan().reloadLines).toEqual([
+      "config change detected; evaluating reload: plugins.entries.demo",
+    ]);
+  });
+
+  it("preserves partial lines between polls", () => {
+    const logPath = path.join(makeTempRoot(), "gateway.log");
+    const scanner = createConfigReloadLogScanner(logPath, {
+      maxReadBytes: 1024,
+      tailLineLimit: 4,
+    });
+
+    writeFileSync(logPath, "config change detected");
+    expect(scanner.scan().reloadLines).toEqual([]);
+
+    appendFileSync(logPath, "; evaluating reload: gateway.channelHealthCheckMinutes\n");
+    expect(scanner.scan().reloadLines).toEqual([
+      "config change detected; evaluating reload: gateway.channelHealthCheckMinutes",
+    ]);
+  });
+
+  it("starts from a bounded tail of oversized logs", () => {
+    const logPath = path.join(makeTempRoot(), "gateway.log");
+    const reloadLine =
+      "config change detected; evaluating reload: gateway.channelHealthCheckMinutes\n";
+    writeFileSync(logPath, `${"x".repeat(4096)}\n${reloadLine}`);
+
+    const scanner = createConfigReloadLogScanner(logPath, {
+      maxReadBytes: reloadLine.length,
+      tailLineLimit: 4,
+    });
+
+    expect(scanner.scan().reloadLines).toEqual([
+      "config change detected; evaluating reload: gateway.channelHealthCheckMinutes",
+    ]);
+  });
+
+  it("resets accumulated matches when the log rotates", () => {
+    const logPath = path.join(makeTempRoot(), "gateway.log");
+    const scanner = createConfigReloadLogScanner(logPath, {
+      maxReadBytes: 1024,
+      tailLineLimit: 4,
+    });
+
+    writeFileSync(logPath, "config change detected; evaluating reload: old.path\n");
+    expect(scanner.scan().reloadLines).toEqual([
+      "config change detected; evaluating reload: old.path",
+    ]);
+
+    writeFileSync(logPath, "config change requires gateway restart: new.path\n");
+    const result = scanner.scan();
+    expect(result.reloadLines).toEqual([]);
+    expect(result.restartLines).toEqual(["config change requires gateway restart: new.path"]);
+  });
+
+  it("resets accumulated matches when a rotated log keeps the same size", () => {
+    const logPath = path.join(makeTempRoot(), "gateway.log");
+    const scanner = createConfigReloadLogScanner(logPath, {
+      maxReadBytes: 1024,
+      tailLineLimit: 4,
+    });
+    const oldText = "config change detected; evaluating reload: old.path with enough padding\n";
+    const restartLine = "config change requires gateway restart: new.path";
+    const restartText = `${restartLine}${" ".repeat(oldText.length - restartLine.length - 1)}\n`;
+
+    expect(Buffer.byteLength(restartText)).toBe(Buffer.byteLength(oldText));
+    writeFileSync(logPath, oldText);
+    expect(scanner.scan().reloadLines).toEqual([
+      "config change detected; evaluating reload: old.path with enough padding",
+    ]);
+
+    rmSync(logPath, { force: true });
+    writeFileSync(logPath, restartText);
+
+    const result = scanner.scan();
+    expect(result.reloadLines).toEqual([]);
+    expect(result.restartLines).toEqual([restartText.replace(/\n$/u, "")]);
+  });
+});