docs: document channel plugin tests

src/channels/plugins/account-action-gate.test.ts

@@ -1,3 +1,4 @@
+// Account action gate tests cover channel account action visibility and enablement checks.
 import { describe, expect, it } from "vitest";
 import { createAccountActionGate } from "./account-action-gate.js";
 

src/channels/plugins/account-helpers.test.ts

@@ -1,3 +1,4 @@
+// Account helper tests cover channel account normalization and lookup helpers.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import { normalizeAccountId } from "../../routing/session-key.js";

src/channels/plugins/acp-bindings.test.ts

@@ -1,3 +1,4 @@
+// ACP binding tests cover channel plugin ACP target binding and stateful driver behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { buildConfiguredAcpSessionKey } from "../../acp/persistent-bindings.types.js";
 import { ensureConfiguredBindingBuiltinsRegistered } from "./configured-binding-builtins.js";

src/channels/plugins/acp-stateful-target-driver.test.ts

@@ -1,3 +1,4 @@
+// ACP stateful target driver tests cover ACP target state persistence and routing.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const resetMocks = vi.hoisted(() => ({

src/channels/plugins/approvals.test.ts

@@ -1,3 +1,4 @@
+// Approval tests cover channel plugin approval request formatting and dispatch.
 import { describe, expect, it, vi } from "vitest";
 import { resolveChannelApprovalAdapter, resolveChannelApprovalCapability } from "./approvals.js";
 

src/channels/plugins/binding-routing.test.ts

@@ -1,3 +1,4 @@
+// Binding routing tests cover channel binding selection and message routing behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   testing,

src/channels/plugins/binding-targets.test.ts

@@ -1,3 +1,4 @@
+// Binding target tests cover channel binding target extraction and validation.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   ensureConfiguredBindingTargetReady,

src/channels/plugins/bundled-load-error.test.ts

@@ -1,3 +1,4 @@
+// Bundled load error tests cover diagnostics when bundled channel plugins fail to load.
 import { describe, it, expect } from "vitest";
 import { describeBundledChannelLoadError } from "./bundled.js";
 

src/channels/plugins/bundled-root-caches.test.ts

@@ -1,3 +1,4 @@
+// Bundled root cache tests cover cached bundled channel root resolution.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

src/channels/plugins/bundled.shape-guard.test.ts

@@ -1,3 +1,4 @@
+// Bundled shape guard tests cover bundled channel package metadata and export shape.
 import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import os from "node:os";

src/channels/plugins/catalog.test.ts

@@ -1,3 +1,4 @@
+// Channel plugin catalog tests cover plugin catalog entries and metadata normalization.
 import { describe, expect, it } from "vitest";
 import { getChannelPluginCatalogEntry } from "./catalog.js";
 

src/channels/plugins/chat-target-prefixes.test.ts

@@ -1,3 +1,4 @@
+// Chat target prefix tests cover channel target prefix parsing and display behavior.
 import { describe, expect, it } from "vitest";
 import {
   createAllowedChatSenderMatcher,

src/channels/plugins/config-helpers.test.ts

@@ -1,3 +1,4 @@
+// Config helper tests cover channel plugin config merge and selection helpers.
 import { describe, expect, it } from "vitest";
 import { clearAccountEntryFields } from "./config-helpers.js";
 

src/channels/plugins/config-schema.test.ts

@@ -1,3 +1,4 @@
+// Config schema tests cover channel plugin config schema validation and defaults.
 import { describe, expect, it, vi } from "vitest";
 import { z } from "zod";
 import {

src/channels/plugins/configured-state.test.ts

@@ -1,3 +1,4 @@
+// Configured state tests cover channel plugin configured-state detection and summaries.
 import { createRequire } from "node:module";
 import { describe, expect, it } from "vitest";
 import {

src/channels/plugins/directory-adapters.test.ts

@@ -1,3 +1,4 @@
+// Directory adapter tests cover channel directory adapter contracts and result normalization.
 import { describe, expect, it } from "vitest";
 import {
   createChannelDirectoryAdapter,

src/channels/plugins/directory-config-helpers.test.ts

@@ -1,3 +1,4 @@
+// Directory config helper tests cover config helpers for channel directory integrations.
 import { describe, expect, it } from "vitest";
 import {
   createInspectedDirectoryEntriesLister,

src/channels/plugins/doctor-contract-api.fast-path.test.ts

@@ -1,3 +1,4 @@
+// Doctor contract API fast-path tests cover lightweight channel doctor contract loading.
 import { describe, expect, it, vi } from "vitest";
 
 const { loadBundledPluginPublicArtifactModuleSyncMock } = vi.hoisted(() => ({

src/channels/plugins/gateway-auth-bypass.test.ts

@@ -1,3 +1,4 @@
+// Gateway auth bypass tests cover channel plugin paths allowed to skip gateway auth.
 import { describe, expect, it, vi } from "vitest";
 
 const { loadBundledPluginPublicArtifactModuleSyncMock } = vi.hoisted(() => ({

src/channels/plugins/group-policy-warnings.test.ts

@@ -1,3 +1,4 @@
+// Group policy warning tests cover user-facing warnings for channel group access policy.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../config/types.openclaw.js";
 import {

src/channels/plugins/helpers.test.ts

@@ -1,3 +1,4 @@
+// Channel plugin helper tests cover shared plugin helper behavior and edge cases.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import {

src/channels/plugins/legacy-config.test.ts

@@ -1,3 +1,4 @@
+// Legacy config tests cover channel plugin config compatibility and migration helpers.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { LegacyConfigRule } from "../../config/legacy.shared.js";
 

src/channels/plugins/message-actions.security.test.ts

@@ -1,3 +1,4 @@
+// Message action security tests cover channel message action authorization and validation.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { jsonResult } from "../../agents/tools/common.js";
 import type { OpenClawConfig } from "../../config/config.js";

src/channels/plugins/message-actions.test.ts

@@ -1,3 +1,4 @@
+// Message action tests cover channel message action schema and invocation behavior.
 import { Type } from "typebox";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";

src/channels/plugins/message-capability-matrix.test.ts

@@ -1,3 +1,4 @@
+// Message capability matrix tests cover channel message feature support across plugin surfaces.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import type { ChannelMessageActionAdapter, ChannelPlugin } from "./types.js";

src/channels/plugins/message-tool-api.test.ts

@@ -1,3 +1,4 @@
+// Message tool API tests cover channel message tool descriptors and runtime calls.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const { loadBundledPluginPublicArtifactModuleSyncMock } = vi.hoisted(() => ({

src/channels/plugins/module-loader.test.ts

@@ -1,3 +1,4 @@
+// Module loader tests cover channel plugin module resolution and import failure handling.
 import fs from "node:fs";
 import { createRequire } from "node:module";
 import os from "node:os";

src/channels/plugins/package-state-probes.test.ts

@@ -1,3 +1,4 @@
+// Package state probe tests cover channel plugin package install and runtime status probes.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

src/channels/plugins/pairing-adapters.test.ts

@@ -1,3 +1,4 @@
+// Pairing adapter tests cover channel plugin device/account pairing adapter behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   createLoggedPairingApprovalNotifier,

src/channels/plugins/persisted-auth-state.test.ts

@@ -1,3 +1,4 @@
+// Persisted auth state tests cover channel plugin auth state serialization and recovery.
 import { describe, expect, it } from "vitest";
 import {
   hasBundledChannelPersistedAuthState,

src/channels/plugins/read-only-command-defaults.test.ts

@@ -1,3 +1,4 @@
+// Read-only command default tests cover command defaulting for read-only channel plugins.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const loadPluginMetadataSnapshot = vi.hoisted(() => vi.fn());

src/channels/plugins/read-only.test.ts

@@ -1,3 +1,4 @@
+// Read-only channel tests cover read-only plugin registration and runtime behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";

src/channels/plugins/registry.test.ts

@@ -1,3 +1,4 @@
+// Registry tests cover channel plugin registry installation, lookup, and reset behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { createEmptyPluginRegistry } from "../../plugins/registry-empty.js";
 import type { PluginRegistry } from "../../plugins/registry.js";

src/channels/plugins/runtime-forwarders.test.ts

@@ -1,3 +1,4 @@
+// Runtime forwarder tests cover channel plugin runtime method delegation and fallback handling.
 import { describe, expect, it, vi } from "vitest";
 import {
   createRuntimeDirectoryLiveAdapter,

src/channels/plugins/session-conversation.bundled-fallback.test.ts

@@ -1,3 +1,4 @@
+// Session conversation fallback tests cover bundled plugin fallback for conversation sessions.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { clearRuntimeConfigSnapshot, setRuntimeConfigSnapshot } from "../../config/io.js";
 import { resetPluginRuntimeStateForTest } from "../../plugins/runtime.js";

src/channels/plugins/session-conversation.test.ts

@@ -1,3 +1,4 @@
+// Session conversation tests cover channel plugin conversation binding and session lookup.
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
 import { clearRuntimeConfigSnapshot, setRuntimeConfigSnapshot } from "../../config/io.js";
 import { resetPluginRuntimeStateForTest, setActivePluginRegistry } from "../../plugins/runtime.js";

src/channels/plugins/setup-group-access-configure.test.ts

@@ -1,3 +1,4 @@
+// Setup group access configure tests cover channel setup writes for group access config.
 import { describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import { configureChannelAccessWithAllowlist } from "./setup-group-access-configure.js";

src/channels/plugins/setup-group-access.test.ts

@@ -1,3 +1,4 @@
+// Setup group access tests cover group access setup flow decisions and outputs.
 import { describe, expect, it, vi } from "vitest";
 import {
   formatAllowlistEntries,

src/channels/plugins/setup-helpers.import-safety.test.ts

@@ -1,3 +1,4 @@
+// Setup helper import-safety tests cover lazy boundaries for channel plugin setup helpers.
 import { importFreshModule } from "openclaw/plugin-sdk/test-fixtures";
 import { afterEach, describe, expect, it, vi } from "vitest";
 

src/channels/plugins/setup-helpers.test.ts

@@ -1,3 +1,4 @@
+// Setup helper tests cover channel setup helper outputs and lifecycle cleanup.
 import { afterAll, beforeEach, describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import { resetPluginRuntimeStateForTest, setActivePluginRegistry } from "../../plugins/runtime.js";

src/channels/plugins/setup-promotion-helpers.test.ts

@@ -1,3 +1,4 @@
+// Setup promotion helper tests cover setup-result promotion into configured channel state.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const getBundledChannelPluginMock = vi.hoisted(() => vi.fn());

src/channels/plugins/setup-wizard-binary.test.ts

@@ -1,3 +1,4 @@
+// Setup wizard binary tests cover channel setup wizard binary selection and invocation.
 import { describe, expect, it, vi } from "vitest";
 import {
   createCliPathTextInput,

src/channels/plugins/setup-wizard-helpers.test.ts

@@ -1,3 +1,4 @@
+// Setup wizard helper tests cover channel setup step formatting and config writes.
 import {
   resolveSetupWizardAllowFromEntries,
   resolveSetupWizardGroupAllowlist,

src/channels/plugins/setup-wizard-proxy.test.ts

@@ -1,3 +1,4 @@
+// Setup wizard proxy tests cover proxying setup wizard calls through channel plugin facades.
 import {
   promptSetupWizardAllowFrom,
   resolveSetupWizardAllowFromEntries,

src/channels/plugins/target-parsing.test.ts

@@ -1,3 +1,4 @@
+// Target parsing tests cover channel target syntax parsing and validation.
 import { beforeEach, describe, expect, it } from "vitest";
 import {
   channelRouteTargetsMatchExact,

src/channels/plugins/target-resolvers.test.ts

@@ -1,3 +1,4 @@
+// Target resolver tests cover channel plugin target resolution from user input and bindings.
 import { describe, expect, it } from "vitest";
 import {
   buildUnresolvedTargetResults,

src/channels/plugins/thread-binding-api.test.ts

@@ -1,3 +1,4 @@
+// Thread binding API tests cover channel plugin thread binding contracts and helpers.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const { loadBundledPluginPublicArtifactModuleSyncMock } = vi.hoisted(() => ({

src/channels/plugins/threading-helpers.test.ts

@@ -1,3 +1,4 @@
+// Threading helper tests cover channel thread metadata and reply-thread helper behavior.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../config/config.js";
 import {

src/channels/plugins/tts-capabilities.test.ts

@@ -1,3 +1,4 @@
+// TTS capability tests cover channel plugin text-to-speech capability detection.
 import { afterEach, describe, expect, it } from "vitest";
 import { createEmptyPluginRegistry } from "../../plugins/registry-empty.js";
 import { setActivePluginRegistry } from "../../plugins/runtime.js";