docs: document gateway session tests

steipete · steipete · commit d68b97575cb6 · 2026-06-03T16:48:43.000-04:00
diff --git a/src/gateway/server.sessions.compaction.test.ts b/src/gateway/server.sessions.compaction.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Gateway session compaction RPC tests.
+ */
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/gateway/server.sessions.list-changed.test.ts b/src/gateway/server.sessions.list-changed.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Gateway sessions.list changed-state tests.
+ */
 import fs from "node:fs/promises";
 import path from "node:path";
 import { expect, test, vi } from "vitest";
diff --git a/src/gateway/server.sessions.preview-resolve.test.ts b/src/gateway/server.sessions.preview-resolve.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Gateway session preview resolve tests.
+ */
 import fs from "node:fs/promises";
 import path from "node:path";
 import { expect, test } from "vitest";
diff --git a/src/gateway/server.sessions.reset-models.test.ts b/src/gateway/server.sessions.reset-models.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Gateway session reset model-selection tests.
+ */
 import fs from "node:fs/promises";
 import path from "node:path";
 import { expect, test } from "vitest";
diff --git a/src/gateway/server.sessions.store-rpc.test.ts b/src/gateway/server.sessions.store-rpc.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Gateway session store RPC tests.
+ */
 import fs from "node:fs/promises";
 import path from "node:path";
 import { expect, test, vi } from "vitest";
diff --git a/src/gateway/session-archive.imports.test.ts b/src/gateway/session-archive.imports.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Session archive import-boundary tests.
+ */
 import { importFreshModule } from "openclaw/plugin-sdk/test-fixtures";
 import { beforeAll, describe, expect, it, vi } from "vitest";
 
diff --git a/src/gateway/session-child-sessions.test.ts b/src/gateway/session-child-sessions.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Child-session aggregation tests.
+ */
 import { expect, test, vi } from "vitest";
 import { loadCombinedSessionStoreForGateway } from "../config/sessions/combined-store-gateway.js";
 import type { SessionEntry } from "../config/sessions/types.js";
diff --git a/src/gateway/session-compaction-checkpoints.test.ts b/src/gateway/session-compaction-checkpoints.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Session compaction checkpoint persistence tests.
+ */
 import fsSync from "node:fs";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/src/gateway/session-history-state.test.ts b/src/gateway/session-history-state.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Session history state hashing and metadata tests.
+ */
 import { createHash } from "node:crypto";
 import { describe, expect, test, vi } from "vitest";
 import { HEARTBEAT_PROMPT } from "../auto-reply/heartbeat.js";
diff --git a/src/gateway/session-lifecycle-state.test.ts b/src/gateway/session-lifecycle-state.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Session lifecycle state derivation tests.
+ */
 import { describe, expect, it } from "vitest";
 import {
   deriveGatewaySessionLifecycleSnapshot,
diff --git a/src/gateway/session-message-events.test.ts b/src/gateway/session-message-events.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Session message event indexing and broadcast tests.
+ */
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/src/gateway/session-preview.test-helpers.ts b/src/gateway/session-preview.test-helpers.ts
@@ -1,3 +1,6 @@
+/**
+ * Transcript preview fixtures shared by session preview tests.
+ */
 export function createToolSummaryPreviewTranscriptLines(sessionId: string): string[] {
   return [
     JSON.stringify({ type: "session", version: 1, id: sessionId }),
diff --git a/src/gateway/session-subagent-reactivation.test.ts b/src/gateway/session-subagent-reactivation.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Subagent session reactivation tests.
+ */
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const getLatestSubagentRunByChildSessionKeyMock = vi.fn();
diff --git a/src/gateway/sessions-history-http.revocation.test.ts b/src/gateway/sessions-history-http.revocation.test.ts
@@ -1,3 +1,6 @@
+/**
+ * HTTP session history revocation tests.
+ */
 import { EventEmitter } from "node:events";
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { afterEach, describe, expect, it, vi } from "vitest";
diff --git a/src/gateway/sessions-resolve-store.test.ts b/src/gateway/sessions-resolve-store.test.ts
@@ -1,3 +1,6 @@
+/**
+ * Session resolve store tests.
+ */
 import path from "node:path";
 import { describe, expect, it } from "vitest";
 import { ErrorCodes } from "../../packages/gateway-protocol/src/index.js";
diff --git a/src/gateway/test/server-sessions.test-helpers.ts b/src/gateway/test/server-sessions.test-helpers.ts
@@ -1,3 +1,6 @@
+/**
+ * HTTP server session fixtures shared by gateway session tests.
+ */
 import fsSync from "node:fs";
 import fs from "node:fs/promises";
 import os from "node:os";
