docs: document vitest routing maps

test/vitest/vitest.agents-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing globs for agent core, embedded-agent, tool, and support suites.
 export const agentsAllTestPatterns = ["src/agents/**/*.test.ts"];
 
 export const agentsCoreTestPatterns = ["src/agents/*.test.ts"];

test/vitest/vitest.channel-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots and globs for core channel tests and channel plugin tests.
 import path from "node:path";
 import { BUNDLED_PLUGIN_PATH_PREFIX } from "../../scripts/lib/bundled-plugin-paths.mjs";
 import { splitChannelExtensionTestRoots } from "./vitest.extension-channel-split-paths.mjs";

test/vitest/vitest.commands-light-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing map for lightweight command tests and their source triggers.
 const normalizeRepoPath = (value) => value.replaceAll("\\", "/");
 
 const commandsLightEntries = [

test/vitest/vitest.extension-acpx-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for the ACP extension suite.
 export const acpxExtensionTestRoots = ["extensions/acpx"];
 
 export function isAcpxExtensionRoot(root) {

test/vitest/vitest.extension-active-memory-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for active-memory extension tests.
 export const activeMemoryExtensionTestRoots = ["extensions/active-memory"];
 
 export function isActiveMemoryExtensionRoot(root) {

test/vitest/vitest.extension-browser-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for browser extension tests.
 export const browserExtensionTestRoots = ["extensions/browser"];
 
 export function isBrowserExtensionRoot(root) {

test/vitest/vitest.extension-channel-split-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing specs for channel plugins split into dedicated Vitest configs.
 import { bundledPluginRoot } from "../../scripts/lib/bundled-plugin-paths.mjs";
 
 export const splitChannelExtensionShardSpecs = [

test/vitest/vitest.extension-codex-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for Codex extension tests.
 export const codexExtensionTestRoots = ["extensions/codex"];
 
 export function isCodexExtensionRoot(root) {

test/vitest/vitest.extension-diffs-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for diffs extension tests.
 export const diffsExtensionTestRoots = ["extensions/diffs"];
 
 export function isDiffsExtensionRoot(root) {

test/vitest/vitest.extension-feishu-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for Feishu extension tests.
 import { bundledPluginRoot } from "../../scripts/lib/bundled-plugin-paths.mjs";
 
 export const feishuExtensionIds = ["feishu"];

test/vitest/vitest.extension-irc-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for IRC extension tests.
 export const ircExtensionTestRoots = ["extensions/irc"];
 
 export function isIrcExtensionRoot(root) {

test/vitest/vitest.extension-matrix-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for Matrix extension tests.
 import { bundledPluginRoot } from "../../scripts/lib/bundled-plugin-paths.mjs";
 
 export const matrixExtensionIds = ["matrix"];

test/vitest/vitest.extension-mattermost-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for Mattermost extension tests.
 import { bundledPluginRoot } from "../../scripts/lib/bundled-plugin-paths.mjs";
 
 export const mattermostExtensionIds = ["mattermost"];

test/vitest/vitest.extension-media-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for media generation, media understanding, and voice plugins.
 export const mediaExtensionTestRoots = [
   "extensions/alibaba",
   "extensions/deepgram",

test/vitest/vitest.extension-memory-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for memory extension suites.
 export const memoryExtensionTestRoots = [
   "extensions/memory-core",
   "extensions/memory-lancedb",

test/vitest/vitest.extension-messaging-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for miscellaneous messaging extension suites.
 import { bundledPluginRoot } from "../../scripts/lib/bundled-plugin-paths.mjs";
 
 export const messagingExtensionIds = [

test/vitest/vitest.extension-misc-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for miscellaneous provider/tool extension suites.
 export const miscExtensionTestRoots = [
   "extensions/arcee",
   "extensions/brave",

test/vitest/vitest.extension-msteams-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for Microsoft Teams extension tests.
 import { bundledPluginRoot } from "../../scripts/lib/bundled-plugin-paths.mjs";
 
 export const msTeamsExtensionIds = ["msteams"];

test/vitest/vitest.extension-provider-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for model provider extension suites.
 import { bundledPluginRoot } from "../../scripts/lib/bundled-plugin-paths.mjs";
 
 export const providerExtensionIds = [

test/vitest/vitest.extension-qa-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for QA channel/lab extension tests.
 export const qaExtensionTestRoots = ["extensions/qa-channel", "extensions/qa-lab"];
 
 export function isQaExtensionRoot(root) {

test/vitest/vitest.extension-telegram-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for Telegram extension tests.
 export const telegramExtensionTestRoots = ["extensions/telegram"];
 
 export function isTelegramExtensionRoot(root) {

test/vitest/vitest.extension-voice-call-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for voice-call extension tests.
 import { bundledPluginRoot } from "../../scripts/lib/bundled-plugin-paths.mjs";
 
 export const voiceCallExtensionIds = ["voice-call"];

test/vitest/vitest.extension-whatsapp-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for WhatsApp extension tests.
 import { bundledPluginRoot } from "../../scripts/lib/bundled-plugin-paths.mjs";
 
 export const whatsAppExtensionIds = ["whatsapp"];

test/vitest/vitest.extension-zalo-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing roots for Zalo extension tests.
 export const zaloExtensionTestRoots = ["extensions/zalo", "extensions/zalouser"];
 
 export function isZaloExtensionRoot(root) {

test/vitest/vitest.plugin-sdk-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing map for lightweight plugin SDK tests and source triggers.
 const normalizeRepoPath = (value) => value.replaceAll("\\", "/");
 
 const pluginSdkLightEntries = [

test/vitest/vitest.test-shards.mjs

@@ -1,3 +1,4 @@
+// Full-suite Vitest shard definitions used by test-projects and CI planning.
 export const autoReplyCoreTestInclude = ["src/auto-reply/*.test.ts"];
 
 export const autoReplyCoreTestExclude = ["src/auto-reply/reply*.test.ts"];

test/vitest/vitest.ui-paths.mjs

@@ -1,3 +1,4 @@
+// Test routing globs and predicates for UI unit tests.
 export const unitUiIncludePatterns = [
   "ui/src/ui/app-chat.test.ts",
   "ui/src/ui/chat/**/*.test.ts",

test/vitest/vitest.unit-fast-paths.mjs

@@ -1,3 +1,4 @@
+// Unit-fast test discovery and classification helpers for fast local routing.
 import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";

test/vitest/vitest.unit-paths.mjs

@@ -1,3 +1,4 @@
+// Unit test routing globs and boundary/bundled-plugin exclusions.
 import path from "node:path";
 import { BUNDLED_PLUGIN_ROOT_DIR } from "../../scripts/lib/bundled-plugin-paths.mjs";