diff --git a/extensions/acpx/index.test.ts b/extensions/acpx/index.test.ts
index bccb63183223..64ea14ed95e9 100644
--- a/extensions/acpx/index.test.ts
+++ b/extensions/acpx/index.test.ts
@@ -1,3 +1,4 @@
+// ACPX tests cover index plugin behavior.
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
 import { beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/acpx/register.runtime.test.ts b/extensions/acpx/register.runtime.test.ts
index 28326f73e5e2..d99c65fb77bf 100644
--- a/extensions/acpx/register.runtime.test.ts
+++ b/extensions/acpx/register.runtime.test.ts
@@ -1,3 +1,4 @@
+// ACPX tests cover register plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 const { runtimeRegistry } = vi.hoisted(() => ({
diff --git a/extensions/acpx/src/claude-agent-acp-completion.test.ts b/extensions/acpx/src/claude-agent-acp-completion.test.ts
index 2ec8f998d529..d46c77bdce72 100644
--- a/extensions/acpx/src/claude-agent-acp-completion.test.ts
+++ b/extensions/acpx/src/claude-agent-acp-completion.test.ts
@@ -1,3 +1,4 @@
+// ACPX tests cover claude agent acp completion plugin behavior.
 import { ClaudeAcpAgent } from "@agentclientprotocol/claude-agent-acp";
 import { describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/acpx/src/codex-auth-bridge.test.ts b/extensions/acpx/src/codex-auth-bridge.test.ts
index 73be1d9309bc..48e479619f91 100644
--- a/extensions/acpx/src/codex-auth-bridge.test.ts
+++ b/extensions/acpx/src/codex-auth-bridge.test.ts
@@ -1,3 +1,4 @@
+// ACPX tests cover codex auth bridge plugin behavior.
 import { execFile } from "node:child_process";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/acpx/src/config.test.ts b/extensions/acpx/src/config.test.ts
index 1bf8e6829c16..b1a5a917d763 100644
--- a/extensions/acpx/src/config.test.ts
+++ b/extensions/acpx/src/config.test.ts
@@ -1,3 +1,4 @@
+// ACPX tests cover config plugin behavior.
 import fs from "node:fs";
 import { createRequire } from "node:module";
 import path from "node:path";
diff --git a/extensions/acpx/src/manifest.test.ts b/extensions/acpx/src/manifest.test.ts
index ce8ed193943d..7f20330c25a8 100644
--- a/extensions/acpx/src/manifest.test.ts
+++ b/extensions/acpx/src/manifest.test.ts
@@ -1,3 +1,4 @@
+// ACPX tests cover manifest plugin behavior.
 import fs from "node:fs";
 import { describe, expect, it } from "vitest";
 
diff --git a/extensions/acpx/src/process-lease.test.ts b/extensions/acpx/src/process-lease.test.ts
index c4fe282d7c49..9003ed7cc919 100644
--- a/extensions/acpx/src/process-lease.test.ts
+++ b/extensions/acpx/src/process-lease.test.ts
@@ -1,3 +1,4 @@
+// ACPX tests cover process lease plugin behavior.
 import { mkdtemp, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";
diff --git a/extensions/acpx/src/process-reaper.test.ts b/extensions/acpx/src/process-reaper.test.ts
index 6a31e6fe481a..1df6e90f49be 100644
--- a/extensions/acpx/src/process-reaper.test.ts
+++ b/extensions/acpx/src/process-reaper.test.ts
@@ -1,3 +1,4 @@
+// ACPX tests cover process reaper plugin behavior.
 import path from "node:path";
 import { describe, expect, it, vi } from "vitest";
 import { OPENCLAW_ACPX_LEASE_ID_ARG, OPENCLAW_GATEWAY_INSTANCE_ID_ARG } from "./process-lease.js";
diff --git a/extensions/acpx/src/runtime-internals/mcp-command-line.test.ts b/extensions/acpx/src/runtime-internals/mcp-command-line.test.ts
index 739c6f29924a..2342c8f28a19 100644
--- a/extensions/acpx/src/runtime-internals/mcp-command-line.test.ts
+++ b/extensions/acpx/src/runtime-internals/mcp-command-line.test.ts
@@ -1,3 +1,4 @@
+// ACPX tests cover mcp command line plugin behavior.
 import { describe, expect, it } from "vitest";
 
 type SplitCommandLine = (
diff --git a/extensions/acpx/src/runtime-internals/mcp-proxy.test.ts b/extensions/acpx/src/runtime-internals/mcp-proxy.test.ts
index f5e727955b1d..4ea546d96fe3 100644
--- a/extensions/acpx/src/runtime-internals/mcp-proxy.test.ts
+++ b/extensions/acpx/src/runtime-internals/mcp-proxy.test.ts
@@ -1,3 +1,4 @@
+// ACPX tests cover mcp proxy plugin behavior.
 import { spawn } from "node:child_process";
 import { chmod, mkdtemp, rm, writeFile } from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/acpx/src/runtime.test.ts b/extensions/acpx/src/runtime.test.ts
index ca3b7518e476..acffec327b39 100644
--- a/extensions/acpx/src/runtime.test.ts
+++ b/extensions/acpx/src/runtime.test.ts
@@ -1,3 +1,4 @@
+// ACPX tests cover runtime plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/acpx/src/service.test.ts b/extensions/acpx/src/service.test.ts
index d8982dd4196a..78d027d2b008 100644
--- a/extensions/acpx/src/service.test.ts
+++ b/extensions/acpx/src/service.test.ts
@@ -1,3 +1,4 @@
+// ACPX tests cover service plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/oc-path/cli-metadata.ts b/extensions/oc-path/cli-metadata.ts
index 81c03fd2c93b..a29b490a8f82 100644
--- a/extensions/oc-path/cli-metadata.ts
+++ b/extensions/oc-path/cli-metadata.ts
@@ -1,3 +1,4 @@
+// OC Path module implements cli metadata behavior.
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { registerOcPathCli } from "./cli-registration.js";
 
diff --git a/extensions/oc-path/cli-registration.ts b/extensions/oc-path/cli-registration.ts
index 62cc5e2d6a91..6268de380f0b 100644
--- a/extensions/oc-path/cli-registration.ts
+++ b/extensions/oc-path/cli-registration.ts
@@ -1,3 +1,4 @@
+// OC Path module implements cli registration behavior.
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
 
 export function registerOcPathCli(api: OpenClawPluginApi): void {
diff --git a/extensions/oc-path/index.ts b/extensions/oc-path/index.ts
index 81c03fd2c93b..db94b3999f9b 100644
--- a/extensions/oc-path/index.ts
+++ b/extensions/oc-path/index.ts
@@ -1,3 +1,4 @@
+// OC Path plugin entrypoint registers its OpenClaw integration.
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { registerOcPathCli } from "./cli-registration.js";
 
diff --git a/extensions/oc-path/src/oc-path/jsonc/edit.ts b/extensions/oc-path/src/oc-path/jsonc/edit.ts
index 5d4ad975967e..834afae94336 100644
--- a/extensions/oc-path/src/oc-path/jsonc/edit.ts
+++ b/extensions/oc-path/src/oc-path/jsonc/edit.ts
@@ -1,3 +1,4 @@
+// OC Path module implements edit behavior.
 import { applyEdits, modify } from "jsonc-parser/lib/esm/main.js";
 import type { OcPath } from "../oc-path.js";
 import {
diff --git a/extensions/oc-path/src/oc-path/jsonc/parse.ts b/extensions/oc-path/src/oc-path/jsonc/parse.ts
index ab805433600c..d10774b1503e 100644
--- a/extensions/oc-path/src/oc-path/jsonc/parse.ts
+++ b/extensions/oc-path/src/oc-path/jsonc/parse.ts
@@ -1,3 +1,4 @@
+// OC Path module implements parse behavior.
 import { type ParseError, parseTree, printParseErrorCode } from "jsonc-parser/lib/esm/main.js";
 import type { Diagnostic } from "../ast.js";
 import type { JsoncAst, JsoncEntry, JsoncValue } from "./ast.js";
diff --git a/extensions/oc-path/src/oc-path/jsonc/resolve-value.ts b/extensions/oc-path/src/oc-path/jsonc/resolve-value.ts
index 6ce4b880c91d..7f57145b9316 100644
--- a/extensions/oc-path/src/oc-path/jsonc/resolve-value.ts
+++ b/extensions/oc-path/src/oc-path/jsonc/resolve-value.ts
@@ -1,3 +1,4 @@
+// OC Path module implements resolve value behavior.
 import { isPositionalSeg, parseArrayIndexSegment, resolvePositionalSeg } from "../oc-path.js";
 import type { JsoncEntry, JsoncValue } from "./ast.js";
 
diff --git a/extensions/oc-path/src/oc-path/tests/edit.test.ts b/extensions/oc-path/src/oc-path/tests/edit.test.ts
index 1db85f576b44..bddac64494b6 100644
--- a/extensions/oc-path/src/oc-path/tests/edit.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/edit.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover edit plugin behavior.
 import { describe, expect, it } from "vitest";
 import { setMdOcPath as setOcPath } from "../edit.js";
 import { parseOcPath } from "../oc-path.js";
diff --git a/extensions/oc-path/src/oc-path/tests/emit.test.ts b/extensions/oc-path/src/oc-path/tests/emit.test.ts
index 1b5a39f74b86..c6eb62ec7c2e 100644
--- a/extensions/oc-path/src/oc-path/tests/emit.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/emit.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover emit plugin behavior.
 import { describe, expect, it } from "vitest";
 import { emitMd } from "../emit.js";
 import { parseMd } from "../parse.js";
diff --git a/extensions/oc-path/src/oc-path/tests/find.test.ts b/extensions/oc-path/src/oc-path/tests/find.test.ts
index a827ff3eb480..fb730070c140 100644
--- a/extensions/oc-path/src/oc-path/tests/find.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/find.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover find plugin behavior.
 import { describe, expect, it } from "vitest";
 import { findOcPaths } from "../find.js";
 import { parseJsonc } from "../jsonc/parse.js";
diff --git a/extensions/oc-path/src/oc-path/tests/jsonc/edit.test.ts b/extensions/oc-path/src/oc-path/tests/jsonc/edit.test.ts
index 30abcee3b539..8bd36a7f2bbf 100644
--- a/extensions/oc-path/src/oc-path/tests/jsonc/edit.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/jsonc/edit.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover edit plugin behavior.
 import { describe, expect, it } from "vitest";
 import { setJsoncOcPath } from "../../jsonc/edit.js";
 import { emitJsonc } from "../../jsonc/emit.js";
diff --git a/extensions/oc-path/src/oc-path/tests/jsonc/emit.test.ts b/extensions/oc-path/src/oc-path/tests/jsonc/emit.test.ts
index e007e32b5975..26fbd748038d 100644
--- a/extensions/oc-path/src/oc-path/tests/jsonc/emit.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/jsonc/emit.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover emit plugin behavior.
 import { describe, expect, it } from "vitest";
 import { emitJsonc } from "../../jsonc/emit.js";
 import { parseJsonc } from "../../jsonc/parse.js";
diff --git a/extensions/oc-path/src/oc-path/tests/jsonc/parse.test.ts b/extensions/oc-path/src/oc-path/tests/jsonc/parse.test.ts
index be5233bf3ebe..fbd4fc2f0e71 100644
--- a/extensions/oc-path/src/oc-path/tests/jsonc/parse.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/jsonc/parse.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover parse plugin behavior.
 import { describe, expect, it } from "vitest";
 import { MAX_JSONC_INPUT_BYTES, parseJsonc } from "../../jsonc/parse.js";
 
diff --git a/extensions/oc-path/src/oc-path/tests/jsonc/resolve.test.ts b/extensions/oc-path/src/oc-path/tests/jsonc/resolve.test.ts
index 527d38119302..1851269196f5 100644
--- a/extensions/oc-path/src/oc-path/tests/jsonc/resolve.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/jsonc/resolve.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover resolve plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseJsonc } from "../../jsonc/parse.js";
 import { resolveJsoncOcPath } from "../../jsonc/resolve.js";
diff --git a/extensions/oc-path/src/oc-path/tests/jsonl/edit.test.ts b/extensions/oc-path/src/oc-path/tests/jsonl/edit.test.ts
index 68f50eabba2a..a23efe6919e9 100644
--- a/extensions/oc-path/src/oc-path/tests/jsonl/edit.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/jsonl/edit.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover edit plugin behavior.
 import { describe, expect, it } from "vitest";
 import { appendJsonlOcPath, setJsonlOcPath } from "../../jsonl/edit.js";
 import { emitJsonl } from "../../jsonl/emit.js";
diff --git a/extensions/oc-path/src/oc-path/tests/jsonl/emit.test.ts b/extensions/oc-path/src/oc-path/tests/jsonl/emit.test.ts
index 89d549eb00a9..c5b8dfc51e4a 100644
--- a/extensions/oc-path/src/oc-path/tests/jsonl/emit.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/jsonl/emit.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover emit plugin behavior.
 import { describe, expect, it } from "vitest";
 import { emitJsonl } from "../../jsonl/emit.js";
 import { parseJsonl } from "../../jsonl/parse.js";
diff --git a/extensions/oc-path/src/oc-path/tests/jsonl/parse.test.ts b/extensions/oc-path/src/oc-path/tests/jsonl/parse.test.ts
index 0d3bd439278a..333ff82548ae 100644
--- a/extensions/oc-path/src/oc-path/tests/jsonl/parse.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/jsonl/parse.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover parse plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseJsonl } from "../../jsonl/parse.js";
 
diff --git a/extensions/oc-path/src/oc-path/tests/jsonl/resolve.test.ts b/extensions/oc-path/src/oc-path/tests/jsonl/resolve.test.ts
index cd2e0988e212..e3bb309288f5 100644
--- a/extensions/oc-path/src/oc-path/tests/jsonl/resolve.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/jsonl/resolve.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover resolve plugin behavior.
 import { describe, expect, it } from "vitest";
 import { findOcPaths } from "../../find.js";
 import { parseJsonl } from "../../jsonl/parse.js";
diff --git a/extensions/oc-path/src/oc-path/tests/oc-path.test.ts b/extensions/oc-path/src/oc-path/tests/oc-path.test.ts
index 27e6abe0f419..15b15ac5aee7 100644
--- a/extensions/oc-path/src/oc-path/tests/oc-path.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/oc-path.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover oc path plugin behavior.
 import { describe, expect, it } from "vitest";
 import { OcPathError, formatOcPath, isValidOcPath, parseOcPath } from "../oc-path.js";
 
diff --git a/extensions/oc-path/src/oc-path/tests/parse.test.ts b/extensions/oc-path/src/oc-path/tests/parse.test.ts
index be9133593cb5..f0679dca2cc4 100644
--- a/extensions/oc-path/src/oc-path/tests/parse.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/parse.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover parse plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseMd } from "../parse.js";
 
diff --git a/extensions/oc-path/src/oc-path/tests/resolve.test.ts b/extensions/oc-path/src/oc-path/tests/resolve.test.ts
index 3ed05200bc20..9bbc8a9197e1 100644
--- a/extensions/oc-path/src/oc-path/tests/resolve.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/resolve.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover resolve plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseMd } from "../parse.js";
 import { resolveMdOcPath as resolveOcPath } from "../resolve.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/append-multi-agent.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/append-multi-agent.test.ts
index a5d7d86d8d5f..f3ce350abfa2 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/append-multi-agent.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/append-multi-agent.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover append multi agent plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { JsoncValue } from "../../jsonc/ast.js";
 import { appendJsonlOcPath } from "../../jsonl/edit.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/byte-fidelity.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/byte-fidelity.test.ts
index 6453a804d2f6..8fc452346b9f 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/byte-fidelity.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/byte-fidelity.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover byte fidelity plugin behavior.
 import { describe, expect, it } from "vitest";
 import { emitMd } from "../../emit.js";
 import { parseMd } from "../../parse.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/cross-cutting.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/cross-cutting.test.ts
index 071b9415d73f..91f2e3838326 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/cross-cutting.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/cross-cutting.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover cross cutting plugin behavior.
 import { describe, expect, it } from "vitest";
 import { emitMd } from "../../emit.js";
 import { formatOcPath, parseOcPath } from "../../oc-path.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/cross-kind-properties.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/cross-kind-properties.test.ts
index 5ce3f11a8c74..6e43ba8046a7 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/cross-kind-properties.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/cross-kind-properties.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover cross kind properties plugin behavior.
 import { describe, expect, it } from "vitest";
 import { inferKind } from "../../dispatch.js";
 import { setMdOcPath } from "../../edit.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/edit-emit-roundtrip.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/edit-emit-roundtrip.test.ts
index b0d48a6343c6..cef4ebccfd26 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/edit-emit-roundtrip.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/edit-emit-roundtrip.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover edit emit roundtrip plugin behavior.
 import { describe, expect, it } from "vitest";
 import { setMdOcPath } from "../../edit.js";
 import { emitMd } from "../../emit.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/frontmatter-edges.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/frontmatter-edges.test.ts
index 1e9a3a414d49..890caac59fa2 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/frontmatter-edges.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/frontmatter-edges.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover frontmatter edges plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseMd } from "../../parse.js";
 
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/h2-block-split.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/h2-block-split.test.ts
index 4ef7d0dfe49f..11195ffeda6d 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/h2-block-split.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/h2-block-split.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover h2 block split plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseMd } from "../../parse.js";
 
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/items.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/items.test.ts
index 664b44f10919..47bf87c0496c 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/items.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/items.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover items plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseMd } from "../../parse.js";
 
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/jsonc-byte-fidelity.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/jsonc-byte-fidelity.test.ts
index 26abefe603e4..78ce4ecc907f 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/jsonc-byte-fidelity.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/jsonc-byte-fidelity.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover jsonc byte fidelity plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { JsoncValue } from "../../jsonc/ast.js";
 import { emitJsonc } from "../../jsonc/emit.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/jsonc-resolver-edges.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/jsonc-resolver-edges.test.ts
index f631803cdc34..015093383575 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/jsonc-resolver-edges.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/jsonc-resolver-edges.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover jsonc resolver edges plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseJsonc } from "../../jsonc/parse.js";
 import { resolveJsoncOcPath } from "../../jsonc/resolve.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/jsonl-byte-fidelity.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/jsonl-byte-fidelity.test.ts
index 5e8460816d17..86cb04888449 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/jsonl-byte-fidelity.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/jsonl-byte-fidelity.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover jsonl byte fidelity plugin behavior.
 import { describe, expect, it } from "vitest";
 import { emitJsonl } from "../../jsonl/emit.js";
 import { parseJsonl } from "../../jsonl/parse.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/jsonl-resolver-edges.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/jsonl-resolver-edges.test.ts
index 68b6105f7a61..9bf6fb9587cf 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/jsonl-resolver-edges.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/jsonl-resolver-edges.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover jsonl resolver edges plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { JsoncValue } from "../../jsonc/ast.js";
 import { parseJsonl } from "../../jsonl/parse.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/malformed-input.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/malformed-input.test.ts
index fc8ac8d252c3..02bc01efbe59 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/malformed-input.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/malformed-input.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover malformed input plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseMd } from "../../parse.js";
 
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/oc-path-parse-edges.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/oc-path-parse-edges.test.ts
index f423e8c88cd0..2a0b311a6616 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/oc-path-parse-edges.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/oc-path-parse-edges.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover oc path parse edges plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   OcPathError,
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/oc-path-resolver-edges.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/oc-path-resolver-edges.test.ts
index 38479dba91fd..a7173016b73c 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/oc-path-resolver-edges.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/oc-path-resolver-edges.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover oc path resolver edges plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseMd } from "../../parse.js";
 import { resolveMdOcPath as resolveOcPath } from "../../resolve.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/perf-determinism.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/perf-determinism.test.ts
index a07f2c5a41e0..742c1fa516be 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/perf-determinism.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/perf-determinism.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover perf determinism plugin behavior.
 import { describe, expect, it } from "vitest";
 import { emitMd } from "../../emit.js";
 import { parseMd } from "../../parse.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/real-world-fixtures.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/real-world-fixtures.test.ts
index 2c2ae9d737e6..87ae6fd157d2 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/real-world-fixtures.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/real-world-fixtures.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover real world fixtures plugin behavior.
 import { readFileSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/roundtrip-property.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/roundtrip-property.test.ts
index 60a2a3195663..31adc3ee4155 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/roundtrip-property.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/roundtrip-property.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover roundtrip property plugin behavior.
 import { describe, expect, it } from "vitest";
 import { emitMd } from "../../emit.js";
 import { parseMd } from "../../parse.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/security-and-limits.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/security-and-limits.test.ts
index 63fbf6b5ae7d..df4739bc4a2d 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/security-and-limits.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/security-and-limits.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover security and limits plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   MAX_PATH_LENGTH,
@@ -12,7 +13,6 @@ import {
 import { parseJsonc } from "../../jsonc/parse.js";
 import { parseJsonl } from "../../jsonl/parse.js";
 
-
 describe("encoding edges", () => {
   it("strips leading UTF-8 BOM from path string", () => {
     expect(parseOcPath("oc://X/Y").file).toBe("X");
@@ -37,7 +37,6 @@ describe("encoding edges", () => {
   });
 });
 
-
 describe("file-slot containment", () => {
   it("rejects absolute POSIX file slot", () => {
     expect(() => parseOcPath("oc:///etc/passwd")).toThrow(/Empty segment/);
@@ -73,7 +72,6 @@ describe("file-slot containment", () => {
   });
 });
 
-
 describe("path-string and traversal caps", () => {
   it("parseOcPath rejects strings longer than MAX_PATH_LENGTH", () => {
     expect(() => parseOcPath("oc://X/" + "a".repeat(MAX_PATH_LENGTH))).toThrow(/exceeds .* bytes/);
@@ -123,7 +121,6 @@ describe("path-string and traversal caps", () => {
   });
 });
 
-
 describe("sentinel literal at format boundary", () => {
   it("formatOcPath rejects a struct carrying the redaction sentinel", () => {
     expect(() => formatOcPath({ file: "AGENTS.md", section: "__OPENCLAW_REDACTED__" })).toThrow(
@@ -132,7 +129,6 @@ describe("sentinel literal at format boundary", () => {
   });
 });
 
-
 describe("numeric segments dispatch by node kind", () => {
   it("negative numeric key on object resolves as literal key (openclaw#59934)", () => {
     // Telegram supergroup IDs are negative numbers used as map keys.
@@ -153,7 +149,6 @@ describe("numeric segments dispatch by node kind", () => {
   });
 });
 
-
 describe("setOcPath value coercion is locale-independent and exact-match", () => {
   it("number coercion accepts `1.5`, refuses `1,5`", () => {
     const ast = parseJsonc('{"x":1.0}').ast;
@@ -174,7 +169,6 @@ describe("setOcPath value coercion is locale-independent and exact-match", () =>
   });
 });
 
-
 describe("predicate-value injection is contained", () => {
   it("regex metacharacters in predicate value match literally, not as regex", () => {
     const ast = parseJsonc('{"items":[{"name":"a.*"},{"name":"abc"}]}').ast;
@@ -213,7 +207,6 @@ describe("predicate-value injection is contained", () => {
   });
 });
 
-
 describe("structural rejection", () => {
   it("rejects mismatched brackets and braces", () => {
     expect(() => parseOcPath("oc://X/[unclosed")).toThrow(OcPathError);
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/sentinel-cross-kind.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/sentinel-cross-kind.test.ts
index 9971d0417438..5a9a0e0cab4e 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/sentinel-cross-kind.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/sentinel-cross-kind.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover sentinel cross kind plugin behavior.
 import { describe, expect, it } from "vitest";
 import { emitMd } from "../../emit.js";
 import { setJsoncOcPath } from "../../jsonc/edit.js";
diff --git a/extensions/oc-path/src/oc-path/tests/scenarios/sentinel-guard.test.ts b/extensions/oc-path/src/oc-path/tests/scenarios/sentinel-guard.test.ts
index 6c27000584f5..f694de1696d1 100644
--- a/extensions/oc-path/src/oc-path/tests/scenarios/sentinel-guard.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/scenarios/sentinel-guard.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover sentinel guard plugin behavior.
 import { describe, expect, it } from "vitest";
 import { emitMd } from "../../emit.js";
 import { parseMd } from "../../parse.js";
diff --git a/extensions/oc-path/src/oc-path/tests/sentinel.test.ts b/extensions/oc-path/src/oc-path/tests/sentinel.test.ts
index 360f54023ad2..c93705cab086 100644
--- a/extensions/oc-path/src/oc-path/tests/sentinel.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/sentinel.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover sentinel plugin behavior.
 import { describe, expect, it } from "vitest";
 import { OcEmitSentinelError, REDACTED_SENTINEL, guardSentinel } from "../sentinel.js";
 
diff --git a/extensions/oc-path/src/oc-path/tests/slug.test.ts b/extensions/oc-path/src/oc-path/tests/slug.test.ts
index 1e51d69738ec..1e15cd3e75cf 100644
--- a/extensions/oc-path/src/oc-path/tests/slug.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/slug.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover slug plugin behavior.
 import { describe, expect, it } from "vitest";
 import { slugify } from "../slug.js";
 
diff --git a/extensions/oc-path/src/oc-path/tests/universal.test.ts b/extensions/oc-path/src/oc-path/tests/universal.test.ts
index 35ece2bee970..a24c35838037 100644
--- a/extensions/oc-path/src/oc-path/tests/universal.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/universal.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover universal plugin behavior.
 import { describe, expect, it } from "vitest";
 import { emitMd } from "../emit.js";
 import { emitJsonc } from "../jsonc/emit.js";
diff --git a/extensions/oc-path/src/oc-path/tests/yaml/yaml-kind.test.ts b/extensions/oc-path/src/oc-path/tests/yaml/yaml-kind.test.ts
index 96dbe93c8be7..cadfb11cc108 100644
--- a/extensions/oc-path/src/oc-path/tests/yaml/yaml-kind.test.ts
+++ b/extensions/oc-path/src/oc-path/tests/yaml/yaml-kind.test.ts
@@ -1,3 +1,4 @@
+// OC Path tests cover yaml kind plugin behavior.
 import { describe, expect, it } from "vitest";
 import { inferKind } from "../../dispatch.js";
 import { parseOcPath } from "../../oc-path.js";
diff --git a/extensions/oc-path/src/oc-path/yaml/ast.ts b/extensions/oc-path/src/oc-path/yaml/ast.ts
index 05b83471864c..7f2bac7894ac 100644
--- a/extensions/oc-path/src/oc-path/yaml/ast.ts
+++ b/extensions/oc-path/src/oc-path/yaml/ast.ts
@@ -1,3 +1,4 @@
+// OC Path module implements ast behavior.
 import type { Document, LineCounter } from "yaml";
 
 export interface YamlAst {
diff --git a/extensions/oc-path/src/oc-path/yaml/edit.ts b/extensions/oc-path/src/oc-path/yaml/edit.ts
index e27bfd86499c..a3f732359789 100644
--- a/extensions/oc-path/src/oc-path/yaml/edit.ts
+++ b/extensions/oc-path/src/oc-path/yaml/edit.ts
@@ -1,3 +1,4 @@
+// OC Path module implements edit behavior.
 import {
   Document,
   isMap,
diff --git a/extensions/oc-path/src/oc-path/yaml/emit.ts b/extensions/oc-path/src/oc-path/yaml/emit.ts
index e2ff23aabf4c..1e483f9fd766 100644
--- a/extensions/oc-path/src/oc-path/yaml/emit.ts
+++ b/extensions/oc-path/src/oc-path/yaml/emit.ts
@@ -1,3 +1,4 @@
+// OC Path module implements emit behavior.
 import { OcEmitSentinelError, REDACTED_SENTINEL } from "../sentinel.js";
 import type { YamlAst } from "./ast.js";
 
diff --git a/extensions/oc-path/src/oc-path/yaml/parse.ts b/extensions/oc-path/src/oc-path/yaml/parse.ts
index b962cd309ffc..fa91f3b05fdf 100644
--- a/extensions/oc-path/src/oc-path/yaml/parse.ts
+++ b/extensions/oc-path/src/oc-path/yaml/parse.ts
@@ -1,3 +1,4 @@
+// OC Path module implements parse behavior.
 import { LineCounter, parseDocument } from "yaml";
 import type { Diagnostic } from "../ast.js";
 import type { YamlAst } from "./ast.js";
diff --git a/extensions/oc-path/src/oc-path/yaml/resolve.ts b/extensions/oc-path/src/oc-path/yaml/resolve.ts
index cda67c35a616..03f44d44869d 100644
--- a/extensions/oc-path/src/oc-path/yaml/resolve.ts
+++ b/extensions/oc-path/src/oc-path/yaml/resolve.ts
@@ -1,3 +1,4 @@
+// OC Path module implements resolve behavior.
 import { isMap, isScalar, isSeq, type Node, type Pair } from "yaml";
 import type { OcPath } from "../oc-path.js";
 import {