docs: document session config tests

src/config/sessions/artifacts.test.ts

@@ -1,3 +1,4 @@
+// Session artifact tests cover artifact metadata persistence for sessions.
 import { describe, expect, it } from "vitest";
 import {
   formatSessionArchiveTimestamp,

src/config/sessions/cache-fields.test.ts

@@ -1,3 +1,4 @@
+// Session cache field tests cover cached metadata stored with sessions.
 import { describe, expect, it } from "vitest";
 import type { SessionEntry } from "./types.js";
 import { mergeSessionEntry } from "./types.js";

src/config/sessions/delivery-info.test.ts

@@ -1,3 +1,4 @@
+// Session delivery info tests cover persisted delivery metadata.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { setActivePluginRegistry } from "../../plugins/runtime.js";
 import { createSessionConversationTestRegistry } from "../../test-utils/session-conversation-registry.js";

src/config/sessions/disk-budget.test.ts

@@ -1,3 +1,4 @@
+// Session disk budget tests cover pruning and storage budget calculations.
 import nodeFs from "node:fs";
 import type { PathLike, StatOptions } from "node:fs";
 import fs from "node:fs/promises";

src/config/sessions/explicit-session-key-normalization.test.ts

@@ -1,3 +1,4 @@
+// Explicit session key tests cover normalization of caller-provided session keys.
 import { describe, expect, it } from "vitest";
 import { normalizeExplicitSessionKey } from "./explicit-session-key-normalization.js";
 import { installDiscordSessionKeyNormalizerFixture, makeCtx } from "./session-key.test-helpers.js";

src/config/sessions/goals.test.ts

@@ -1,3 +1,4 @@
+// Session goal tests cover persisted session goal state and transitions.
 import { describe, expect, it } from "vitest";
 import {
   clearSessionGoal,

src/config/sessions/group.test.ts

@@ -1,3 +1,4 @@
+// Session group tests cover grouping and lookup of related sessions.
 import { describe, expect, it } from "vitest";
 import type { MsgContext } from "../../auto-reply/templating.js";
 import { resolveGroupSessionKey } from "./group.js";

src/config/sessions/reset.test.ts

@@ -1,3 +1,4 @@
+// Session reset tests cover clearing persisted session state.
 import { beforeEach, describe, expect, it } from "vitest";
 import { setActivePluginRegistry } from "../../plugins/runtime.js";
 import { createSessionConversationTestRegistry } from "../../test-utils/session-conversation-registry.js";

src/config/sessions/session-key.test-helpers.ts

@@ -1,3 +1,4 @@
+// Session key test helpers isolate environment state for key normalization tests.
 import { afterEach, beforeEach } from "vitest";
 import type { MsgContext } from "../../auto-reply/templating.js";
 import type { ChannelPlugin } from "../../channels/plugins/types.plugin.js";

src/config/sessions/session-key.test.ts

@@ -1,3 +1,4 @@
+// Session key tests cover session key generation and normalization.
 import { describe, expect, it } from "vitest";
 import { resolveSessionKey } from "./session-key.js";
 import { installDiscordSessionKeyNormalizerFixture, makeCtx } from "./session-key.test-helpers.js";

src/config/sessions/sessions.test.ts

@@ -1,3 +1,4 @@
+// Session config tests cover session creation, updates, and persistence.
 import fs from "node:fs";
 import fsPromises from "node:fs/promises";
 import path from "node:path";

src/config/sessions/store-read.test.ts

@@ -1,3 +1,4 @@
+// Session store read tests cover loading persisted sessions from disk.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, expect, it } from "vitest";

src/config/sessions/store-writer.test.ts

@@ -1,3 +1,4 @@
+// Session store writer tests cover serialized session writes and cleanup.
 import { afterEach, describe, expect, it } from "vitest";
 import {
   clearSessionStoreCacheForTest,

src/config/sessions/store.pruning.integration.test.ts

@@ -1,3 +1,4 @@
+// Session store pruning integration tests cover filesystem-backed pruning.
 import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";

src/config/sessions/store.pruning.test.ts

@@ -1,3 +1,4 @@
+// Session store pruning tests cover pruning decisions and retention ordering.
 import crypto from "node:crypto";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
 import { createFixtureSuite } from "../../test-utils/fixture-suite.js";

src/config/sessions/store.session-key-normalization.test.ts

@@ -1,3 +1,4 @@
+// Store session key tests cover session key normalization during disk writes.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it } from "vitest";

src/config/sessions/store.skills-stripping.test.ts

@@ -1,3 +1,4 @@
+// Session store skill stripping tests cover omitting skill payloads from persisted state.
 import type { MakeDirectoryOptions, Mode, PathLike } from "node:fs";
 import fs from "node:fs/promises";
 import path from "node:path";

src/config/sessions/targets.test.ts

@@ -1,3 +1,4 @@
+// Session target tests cover persisted channel targets for sessions.
 import fsSync from "node:fs";
 import fs from "node:fs/promises";
 import path from "node:path";

src/config/sessions/transcript-append-redact.test.ts

@@ -1,3 +1,4 @@
+// Transcript append redaction tests cover secret scrubbing when appending transcript entries.
 import fs from "node:fs";
 import path from "node:path";
 import { beforeEach, describe, expect, it, vi } from "vitest";

src/config/sessions/transcript-stream.test.ts

@@ -1,3 +1,4 @@
+// Transcript stream tests cover streaming transcript reads and writes.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

src/config/sessions/transcript.test.ts

@@ -1,3 +1,4 @@
+// Transcript tests cover session transcript persistence and formatting.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";