From 96e5812426050d29236c772351426cdb0dd37c4b Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Thu, 4 Jun 2026 21:33:35 -0400
Subject: [PATCH] docs: document medium extension sources

---
 extensions/copilot/doctor-contract-api.test.ts        |  1 +
 extensions/copilot/harness.test.ts                    |  1 +
 extensions/copilot/harness.ts                         |  1 +
 extensions/copilot/index.test.ts                      |  1 +
 extensions/copilot/index.ts                           |  1 +
 extensions/copilot/src/attempt.live.test.ts           |  1 +
 extensions/copilot/src/attempt.test.ts                |  1 +
 extensions/copilot/src/attempt.ts                     |  1 +
 extensions/copilot/src/auth-bridge.test.ts            |  1 +
 extensions/copilot/src/auth-bridge.ts                 |  1 +
 extensions/copilot/src/compaction-bridge.test.ts      |  1 +
 extensions/copilot/src/compaction-bridge.ts           |  1 +
 extensions/copilot/src/doctor-probes.test.ts          |  1 +
 extensions/copilot/src/dual-write-transcripts.test.ts |  1 +
 extensions/copilot/src/event-bridge.test.ts           |  1 +
 extensions/copilot/src/event-bridge.ts                |  1 +
 extensions/copilot/src/hooks-bridge.test.ts           |  1 +
 extensions/copilot/src/permission-bridge.test.ts      |  1 +
 extensions/copilot/src/replay-shim.test.ts            |  1 +
 extensions/copilot/src/runtime.test.ts                |  1 +
 extensions/copilot/src/runtime.ts                     |  1 +
 extensions/copilot/src/sdk-loader.test.ts             |  1 +
 extensions/copilot/src/sdk-loader.ts                  |  1 +
 extensions/copilot/src/telemetry-bridge.test.ts       |  1 +
 extensions/copilot/src/telemetry-bridge.ts            |  1 +
 extensions/copilot/src/tool-bridge.test.ts            |  1 +
 extensions/copilot/src/tool-bridge.ts                 |  1 +
 extensions/copilot/src/usage-bridge.test.ts           |  1 +
 extensions/copilot/src/usage-bridge.ts                |  1 +
 extensions/copilot/src/user-input-bridge.test.ts      |  1 +
 extensions/copilot/src/workspace-bootstrap.test.ts    |  1 +
 extensions/copilot/src/workspace-bootstrap.ts         |  1 +
 extensions/google-meet/doctor-contract-api.ts         |  1 +
 extensions/google-meet/google-meet.live.test.ts       |  1 +
 extensions/google-meet/index.create.test.ts           |  1 +
 extensions/google-meet/index.test.ts                  |  1 +
 extensions/google-meet/index.ts                       |  1 +
 extensions/google-meet/node-host.test.ts              |  1 +
 extensions/google-meet/src/agent-consult.ts           |  1 +
 extensions/google-meet/src/calendar.ts                |  1 +
 extensions/google-meet/src/cli.test.ts                |  1 +
 extensions/google-meet/src/cli.ts                     |  1 +
 extensions/google-meet/src/config-compat.test.ts      |  1 +
 extensions/google-meet/src/config-compat.ts           |  1 +
 extensions/google-meet/src/config.test.ts             |  1 +
 extensions/google-meet/src/config.ts                  |  1 +
 extensions/google-meet/src/create.ts                  |  1 +
 extensions/google-meet/src/drive.ts                   |  1 +
 extensions/google-meet/src/google-api-errors.ts       |  1 +
 extensions/google-meet/src/meet.ts                    |  1 +
 extensions/google-meet/src/node-host.ts               |  1 +
 extensions/google-meet/src/oauth.test.ts              |  1 +
 extensions/google-meet/src/oauth.ts                   |  1 +
 extensions/google-meet/src/realtime-node.ts           |  1 +
 extensions/google-meet/src/realtime.ts                |  1 +
 extensions/google-meet/src/runtime.ts                 |  1 +
 extensions/google-meet/src/setup.ts                   |  1 +
 .../google-meet/src/test-support/plugin-harness.ts    |  1 +
 .../google-meet/src/transports/chrome-audio-device.ts |  1 +
 .../src/transports/chrome-browser-proxy.test.ts       |  1 +
 .../src/transports/chrome-browser-proxy.ts            |  1 +
 .../google-meet/src/transports/chrome-create.ts       |  1 +
 extensions/google-meet/src/transports/chrome.test.ts  |  1 +
 extensions/google-meet/src/transports/chrome.ts       |  1 +
 extensions/google-meet/src/transports/twilio.ts       |  1 +
 extensions/google-meet/src/transports/types.ts        |  1 +
 extensions/google-meet/src/voice-call-gateway.test.ts |  1 +
 extensions/google-meet/src/voice-call-gateway.ts      |  1 +
 extensions/google/api.test.ts                         |  1 +
 extensions/google/api.ts                              |  1 +
 extensions/google/cli-backend.ts                      |  1 +
 extensions/google/default-model.test.ts               |  1 +
 extensions/google/doctor-contract-api.ts              |  1 +
 extensions/google/embedding-batch.ts                  |  1 +
 extensions/google/embedding-provider.test.ts          |  1 +
 extensions/google/embedding-provider.ts               |  1 +
 extensions/google/gemini-auth.ts                      |  1 +
 extensions/google/gemini-cli-provider.ts              |  1 +
 extensions/google/generation-provider-metadata.ts     |  1 +
 extensions/google/google-genai-runtime.ts             |  1 +
 extensions/google/google.live.test.ts                 |  1 +
 extensions/google/image-generation-provider.test.ts   |  1 +
 extensions/google/image-generation-provider.ts        |  1 +
 extensions/google/index.test.ts                       |  1 +
 extensions/google/index.ts                            |  1 +
 extensions/google/manifest.test.ts                    |  1 +
 extensions/google/media-understanding-provider.ts     |  1 +
 .../google/media-understanding-provider.video.test.ts |  1 +
 extensions/google/memory-embedding-adapter.ts         |  1 +
 extensions/google/model-id.test.ts                    |  1 +
 extensions/google/model-id.ts                         |  1 +
 extensions/google/music-generation-provider.test.ts   |  1 +
 extensions/google/music-generation-provider.ts        |  1 +
 extensions/google/oauth-token-shared.test.ts          |  1 +
 extensions/google/oauth-token-shared.ts               |  1 +
 extensions/google/oauth.credentials.ts                |  1 +
 extensions/google/oauth.flow.ts                       |  1 +
 extensions/google/oauth.http.ts                       |  1 +
 extensions/google/oauth.local-login.test.ts           |  1 +
 extensions/google/oauth.project.ts                    |  1 +
 extensions/google/oauth.runtime.ts                    |  1 +
 extensions/google/oauth.settings.ts                   |  1 +
 extensions/google/oauth.shared.ts                     |  1 +
 extensions/google/oauth.test.ts                       |  1 +
 extensions/google/oauth.token.ts                      |  1 +
 extensions/google/oauth.ts                            |  1 +
 extensions/google/onboard.ts                          |  1 +
 extensions/google/provider-catalog.test.ts            |  1 +
 extensions/google/provider-catalog.ts                 |  1 +
 extensions/google/provider-contract-api.ts            |  1 +
 extensions/google/provider-discovery.ts               |  1 +
 extensions/google/provider-hooks.ts                   |  1 +
 extensions/google/provider-models.test.ts             |  1 +
 extensions/google/provider-models.ts                  |  1 +
 extensions/google/provider-policy-api.test.ts         |  1 +
 extensions/google/provider-policy-api.ts              |  1 +
 extensions/google/provider-policy.ts                  |  5 ++---
 extensions/google/provider-registration.test.ts       |  1 +
 extensions/google/provider-registration.ts            |  1 +
 extensions/google/provider-runtime.contract.test.ts   |  1 +
 extensions/google/realtime-voice-provider.test.ts     |  1 +
 extensions/google/realtime-voice-provider.ts          |  1 +
 extensions/google/runtime-api.ts                      |  1 +
 extensions/google/setup-api.test.ts                   |  1 +
 extensions/google/setup-api.ts                        |  1 +
 extensions/google/speech-provider.test.ts             |  1 +
 extensions/google/speech-provider.ts                  |  1 +
 .../google/src/gemini-web-search-provider.runtime.ts  |  1 +
 .../google/src/gemini-web-search-provider.shared.ts   |  1 +
 extensions/google/src/gemini-web-search-provider.ts   |  1 +
 extensions/google/test-api.ts                         |  1 +
 extensions/google/thinking-api.ts                     |  1 +
 extensions/google/thinking.test.ts                    |  1 +
 extensions/google/thinking.ts                         |  1 +
 extensions/google/transport-stream.test.ts            |  1 +
 extensions/google/transport-stream.ts                 |  1 +
 extensions/google/vertex-adc.ts                       |  1 +
 extensions/google/video-generation-provider.test.ts   |  1 +
 extensions/google/video-generation-provider.ts        |  1 +
 extensions/google/web-search-contract-api.ts          |  1 +
 extensions/google/web-search-provider.test.ts         |  1 +
 extensions/google/web-search-provider.ts              |  1 +
 extensions/googlechat/api.ts                          |  1 +
 extensions/googlechat/channel-config-api.ts           |  1 +
 extensions/googlechat/channel-plugin-api.ts           |  1 +
 extensions/googlechat/config-api.ts                   |  1 +
 extensions/googlechat/contract-api.ts                 |  1 +
 extensions/googlechat/directory-contract-api.ts       |  1 +
 extensions/googlechat/doctor-contract-api.ts          |  1 +
 extensions/googlechat/index.ts                        |  1 +
 extensions/googlechat/secret-contract-api.ts          |  1 +
 extensions/googlechat/setup-entry.ts                  |  1 +
 extensions/googlechat/src/accounts.ts                 |  1 +
 extensions/googlechat/src/actions.test.ts             |  1 +
 extensions/googlechat/src/actions.ts                  |  1 +
 extensions/googlechat/src/api.ts                      |  1 +
 extensions/googlechat/src/approval-auth.test.ts       |  1 +
 extensions/googlechat/src/approval-auth.ts            |  1 +
 extensions/googlechat/src/auth.ts                     |  1 +
 extensions/googlechat/src/channel-base.ts             |  1 +
 extensions/googlechat/src/channel-config.test.ts      |  1 +
 extensions/googlechat/src/channel.adapters.ts         |  1 +
 extensions/googlechat/src/channel.deps.runtime.ts     |  1 +
 extensions/googlechat/src/channel.runtime.ts          |  1 +
 extensions/googlechat/src/channel.setup.ts            |  1 +
 extensions/googlechat/src/channel.test.ts             |  1 +
 extensions/googlechat/src/channel.ts                  |  1 +
 extensions/googlechat/src/config-schema.test.ts       |  1 +
 extensions/googlechat/src/config-schema.ts            |  1 +
 extensions/googlechat/src/doctor-contract.test.ts     |  1 +
 extensions/googlechat/src/doctor-contract.ts          |  1 +
 extensions/googlechat/src/doctor.ts                   |  1 +
 extensions/googlechat/src/gateway.ts                  |  1 +
 extensions/googlechat/src/google-auth.runtime.test.ts |  1 +
 extensions/googlechat/src/google-auth.runtime.ts      |  1 +
 extensions/googlechat/src/group-policy.ts             |  1 +
 extensions/googlechat/src/monitor-access.test.ts      |  1 +
 extensions/googlechat/src/monitor-access.ts           |  1 +
 extensions/googlechat/src/monitor-durable.test.ts     |  1 +
 extensions/googlechat/src/monitor-durable.ts          |  1 +
 extensions/googlechat/src/monitor-reply-delivery.ts   |  1 +
 extensions/googlechat/src/monitor-routing.ts          |  1 +
 extensions/googlechat/src/monitor-types.ts            |  1 +
 extensions/googlechat/src/monitor-webhook.test.ts     |  1 +
 extensions/googlechat/src/monitor-webhook.ts          |  1 +
 .../googlechat/src/monitor.reply-delivery.test.ts     |  1 +
 extensions/googlechat/src/monitor.test.ts             |  1 +
 extensions/googlechat/src/monitor.ts                  |  1 +
 .../googlechat/src/monitor.webhook-routing.test.ts    |  1 +
 extensions/googlechat/src/runtime.ts                  |  1 +
 extensions/googlechat/src/secret-contract.test.ts     |  1 +
 extensions/googlechat/src/secret-contract.ts          |  1 +
 extensions/googlechat/src/setup-core.ts               |  1 +
 extensions/googlechat/src/setup-surface.ts            |  1 +
 extensions/googlechat/src/setup.test.ts               |  1 +
 extensions/googlechat/src/targets.test.ts             |  1 +
 extensions/googlechat/src/targets.ts                  |  1 +
 extensions/googlechat/src/types.config.ts             |  1 +
 extensions/googlechat/src/types.ts                    |  1 +
 extensions/googlechat/test-api.ts                     |  1 +
 extensions/irc/api.ts                                 |  1 +
 extensions/irc/channel-config-api.ts                  |  1 +
 extensions/irc/configured-state.ts                    |  1 +
 extensions/irc/contract-api.ts                        |  1 +
 extensions/irc/index.test.ts                          |  1 +
 extensions/irc/index.ts                               |  1 +
 extensions/irc/runtime-api.test.ts                    |  1 +
 extensions/irc/secret-contract-api.ts                 |  1 +
 extensions/irc/setup-entry.ts                         |  1 +
 extensions/irc/src/accounts.test.ts                   |  1 +
 extensions/irc/src/accounts.ts                        |  1 +
 extensions/irc/src/channel-api.ts                     |  1 +
 extensions/irc/src/channel.test.ts                    |  1 +
 extensions/irc/src/channel.ts                         |  1 +
 extensions/irc/src/client.test.ts                     |  1 +
 extensions/irc/src/client.ts                          |  1 +
 extensions/irc/src/config-schema.test.ts              |  1 +
 extensions/irc/src/config-schema.ts                   |  1 +
 extensions/irc/src/config-ui-hints.ts                 |  1 +
 extensions/irc/src/connect-options.test.ts            |  1 +
 extensions/irc/src/connect-options.ts                 |  1 +
 extensions/irc/src/control-chars.test.ts              |  1 +
 extensions/irc/src/control-chars.ts                   |  1 +
 extensions/irc/src/doctor.ts                          |  1 +
 extensions/irc/src/gateway.ts                         |  1 +
 extensions/irc/src/inbound.behavior.test.ts           |  1 +
 extensions/irc/src/inbound.ts                         |  1 +
 extensions/irc/src/message-adapter.ts                 |  1 +
 extensions/irc/src/monitor.test.ts                    |  1 +
 extensions/irc/src/monitor.ts                         |  1 +
 extensions/irc/src/normalize.test.ts                  |  1 +
 extensions/irc/src/normalize.ts                       |  1 +
 extensions/irc/src/outbound-base.ts                   |  1 +
 extensions/irc/src/policy.test.ts                     |  1 +
 extensions/irc/src/policy.ts                          |  1 +
 extensions/irc/src/probe.test.ts                      |  1 +
 extensions/irc/src/probe.ts                           |  1 +
 extensions/irc/src/protocol.test.ts                   |  1 +
 extensions/irc/src/protocol.ts                        |  1 +
 extensions/irc/src/runtime.ts                         |  1 +
 extensions/irc/src/secret-contract.ts                 |  1 +
 extensions/irc/src/send.test.ts                       |  1 +
 extensions/irc/src/send.ts                            |  1 +
 extensions/irc/src/setup-core.ts                      |  1 +
 extensions/irc/src/setup-surface.ts                   |  1 +
 extensions/irc/src/setup.test.ts                      |  1 +
 extensions/irc/src/types.ts                           |  1 +
 extensions/memory-wiki/api.ts                         |  1 +
 extensions/memory-wiki/cli-metadata.test.ts           |  1 +
 extensions/memory-wiki/cli-metadata.ts                |  1 +
 extensions/memory-wiki/contract-api.ts                |  1 +
 extensions/memory-wiki/doctor-contract-api.ts         |  1 +
 extensions/memory-wiki/index.test.ts                  |  1 +
 extensions/memory-wiki/index.ts                       |  1 +
 extensions/memory-wiki/setup-api.ts                   |  1 +
 extensions/memory-wiki/src/apply.test.ts              |  1 +
 extensions/memory-wiki/src/apply.ts                   |  1 +
 extensions/memory-wiki/src/bridge.test.ts             |  1 +
 extensions/memory-wiki/src/bridge.ts                  |  1 +
 extensions/memory-wiki/src/chatgpt-import.ts          |  1 +
 extensions/memory-wiki/src/claim-health.test.ts       |  1 +
 extensions/memory-wiki/src/claim-health.ts            |  1 +
 extensions/memory-wiki/src/cli.test.ts                |  1 +
 extensions/memory-wiki/src/cli.ts                     |  1 +
 extensions/memory-wiki/src/compile.test.ts            |  1 +
 extensions/memory-wiki/src/compile.ts                 |  1 +
 extensions/memory-wiki/src/config-compat.test.ts      |  1 +
 extensions/memory-wiki/src/config-compat.ts           |  1 +
 extensions/memory-wiki/src/config.test.ts             |  1 +
 extensions/memory-wiki/src/config.ts                  |  1 +
 extensions/memory-wiki/src/corpus-supplement.ts       |  1 +
 extensions/memory-wiki/src/gateway.test.ts            |  1 +
 extensions/memory-wiki/src/gateway.ts                 |  1 +
 extensions/memory-wiki/src/import-insights.test.ts    |  1 +
 extensions/memory-wiki/src/import-insights.ts         |  1 +
 extensions/memory-wiki/src/import-runs.ts             |  1 +
 extensions/memory-wiki/src/ingest.test.ts             |  1 +
 extensions/memory-wiki/src/ingest.ts                  |  1 +
 extensions/memory-wiki/src/lint.test.ts               |  1 +
 extensions/memory-wiki/src/lint.ts                    |  1 +
 extensions/memory-wiki/src/log.ts                     |  1 +
 extensions/memory-wiki/src/markdown.test.ts           |  1 +
 extensions/memory-wiki/src/markdown.ts                |  1 +
 extensions/memory-wiki/src/memory-palace.test.ts      |  1 +
 extensions/memory-wiki/src/memory-palace.ts           |  1 +
 extensions/memory-wiki/src/obsidian.test.ts           |  1 +
 extensions/memory-wiki/src/obsidian.ts                |  1 +
 extensions/memory-wiki/src/prompt-section.test.ts     |  1 +
 extensions/memory-wiki/src/prompt-section.ts          |  1 +
 extensions/memory-wiki/src/query.test.ts              |  1 +
 extensions/memory-wiki/src/query.ts                   |  1 +
 extensions/memory-wiki/src/source-page-shared.test.ts |  1 +
 extensions/memory-wiki/src/source-page-shared.ts      |  1 +
 extensions/memory-wiki/src/source-path-shared.ts      |  1 +
 extensions/memory-wiki/src/source-sync-state.ts       |  1 +
 extensions/memory-wiki/src/source-sync.test.ts        |  1 +
 extensions/memory-wiki/src/source-sync.ts             |  1 +
 extensions/memory-wiki/src/status.test.ts             |  1 +
 extensions/memory-wiki/src/status.ts                  |  1 +
 extensions/memory-wiki/src/test-helpers.ts            |  1 +
 extensions/memory-wiki/src/time.test.ts               |  1 +
 extensions/memory-wiki/src/time.ts                    |  1 +
 extensions/memory-wiki/src/tool.test.ts               |  3 ++-
 extensions/memory-wiki/src/tool.ts                    |  1 +
 extensions/memory-wiki/src/unsafe-local.test.ts       |  1 +
 extensions/memory-wiki/src/unsafe-local.ts            |  1 +
 extensions/memory-wiki/src/vault.test.ts              |  1 +
 extensions/memory-wiki/src/vault.ts                   |  1 +
 extensions/minimax/api.ts                             |  1 +
 extensions/minimax/image-generation-provider.test.ts  |  1 +
 extensions/minimax/image-generation-provider.ts       |  1 +
 extensions/minimax/index.test.ts                      |  1 +
 extensions/minimax/index.ts                           |  1 +
 extensions/minimax/media-understanding-provider.ts    |  1 +
 extensions/minimax/minimax.live.test.ts               |  1 +
 extensions/minimax/model-definitions.test.ts          |  1 +
 extensions/minimax/model-definitions.ts               |  1 +
 extensions/minimax/music-generation-provider.test.ts  |  1 +
 extensions/minimax/music-generation-provider.ts       |  1 +
 extensions/minimax/oauth.runtime.ts                   |  1 +
 extensions/minimax/oauth.test.ts                      |  1 +
 extensions/minimax/oauth.ts                           |  1 +
 extensions/minimax/onboard.test.ts                    |  1 +
 extensions/minimax/onboard.ts                         |  1 +
 extensions/minimax/provider-catalog.ts                |  1 +
 extensions/minimax/provider-contract-api.ts           |  1 +
 .../minimax/provider-discovery.contract.test.ts       |  1 +
 extensions/minimax/provider-discovery.ts              |  1 +
 extensions/minimax/provider-http.test-helpers.ts      |  1 +
 extensions/minimax/provider-models.ts                 |  1 +
 extensions/minimax/provider-registration.ts           |  1 +
 extensions/minimax/speech-provider.test.ts            |  1 +
 extensions/minimax/speech-provider.ts                 |  1 +
 .../src/minimax-web-search-provider.runtime.ts        |  1 +
 .../minimax/src/minimax-web-search-provider.test.ts   |  1 +
 extensions/minimax/src/minimax-web-search-provider.ts |  1 +
 extensions/minimax/test-api.ts                        |  1 +
 extensions/minimax/tts.test.ts                        |  1 +
 extensions/minimax/tts.ts                             |  1 +
 extensions/minimax/video-generation-provider.test.ts  |  1 +
 extensions/minimax/video-generation-provider.ts       |  1 +
 extensions/minimax/web-search-contract-api.ts         |  1 +
 extensions/minimax/web-search-provider.ts             |  1 +
 extensions/nextcloud-talk/api.ts                      |  1 +
 extensions/nextcloud-talk/channel-plugin-api.ts       |  1 +
 extensions/nextcloud-talk/contract-api.ts             |  1 +
 extensions/nextcloud-talk/doctor-contract-api.ts      |  1 +
 extensions/nextcloud-talk/index.ts                    |  1 +
 extensions/nextcloud-talk/secret-contract-api.ts      |  1 +
 extensions/nextcloud-talk/setup-entry.ts              |  1 +
 extensions/nextcloud-talk/src/accounts.test.ts        |  1 +
 extensions/nextcloud-talk/src/accounts.ts             |  1 +
 extensions/nextcloud-talk/src/api-credentials.ts      |  1 +
 extensions/nextcloud-talk/src/approval-auth.test.ts   |  1 +
 extensions/nextcloud-talk/src/approval-auth.ts        |  1 +
 extensions/nextcloud-talk/src/bot-preflight.test.ts   |  1 +
 extensions/nextcloud-talk/src/bot-preflight.ts        |  1 +
 extensions/nextcloud-talk/src/channel-api.ts          |  1 +
 extensions/nextcloud-talk/src/channel.adapters.ts     |  1 +
 extensions/nextcloud-talk/src/channel.core.test.ts    |  1 +
 .../nextcloud-talk/src/channel.lifecycle.test.ts      |  1 +
 extensions/nextcloud-talk/src/channel.status.test.ts  |  1 +
 extensions/nextcloud-talk/src/channel.ts              |  1 +
 extensions/nextcloud-talk/src/config-schema.ts        |  1 +
 extensions/nextcloud-talk/src/core.test.ts            |  1 +
 extensions/nextcloud-talk/src/doctor-contract.ts      |  1 +
 extensions/nextcloud-talk/src/doctor.test.ts          |  1 +
 extensions/nextcloud-talk/src/doctor.ts               |  1 +
 extensions/nextcloud-talk/src/gateway.ts              |  1 +
 extensions/nextcloud-talk/src/inbound.authz.test.ts   |  1 +
 .../nextcloud-talk/src/inbound.behavior.test.ts       |  1 +
 extensions/nextcloud-talk/src/inbound.ts              |  1 +
 extensions/nextcloud-talk/src/message-actions.test.ts |  1 +
 extensions/nextcloud-talk/src/message-actions.ts      |  1 +
 extensions/nextcloud-talk/src/message-adapter.ts      |  1 +
 extensions/nextcloud-talk/src/monitor-runtime.ts      |  1 +
 extensions/nextcloud-talk/src/monitor.replay.test.ts  |  1 +
 .../nextcloud-talk/src/monitor.test-fixtures.ts       |  1 +
 extensions/nextcloud-talk/src/monitor.test-harness.ts |  1 +
 extensions/nextcloud-talk/src/monitor.ts              |  1 +
 extensions/nextcloud-talk/src/normalize.ts            |  1 +
 extensions/nextcloud-talk/src/policy.ts               |  1 +
 extensions/nextcloud-talk/src/replay-guard.ts         |  1 +
 extensions/nextcloud-talk/src/room-info.test.ts       |  1 +
 extensions/nextcloud-talk/src/room-info.ts            |  1 +
 extensions/nextcloud-talk/src/runtime.ts              |  1 +
 extensions/nextcloud-talk/src/secret-contract.ts      |  1 +
 extensions/nextcloud-talk/src/secret-input.ts         |  1 +
 .../nextcloud-talk/src/send.cfg-threading.test.ts     |  1 +
 extensions/nextcloud-talk/src/send.runtime.ts         |  1 +
 extensions/nextcloud-talk/src/send.ts                 |  1 +
 extensions/nextcloud-talk/src/session-route.ts        |  1 +
 extensions/nextcloud-talk/src/setup-core.ts           |  1 +
 extensions/nextcloud-talk/src/setup-surface.ts        |  1 +
 extensions/nextcloud-talk/src/setup.test.ts           |  1 +
 extensions/nextcloud-talk/src/signature.ts            |  1 +
 extensions/nextcloud-talk/src/types.ts                |  1 +
 extensions/nostr/api.ts                               |  1 +
 extensions/nostr/channel-plugin-api.ts                |  1 +
 extensions/nostr/doctor-contract-api.test.ts          |  1 +
 extensions/nostr/doctor-contract-api.ts               |  1 +
 extensions/nostr/index.ts                             |  1 +
 extensions/nostr/setup-api.ts                         |  1 +
 extensions/nostr/setup-entry.ts                       |  1 +
 extensions/nostr/src/channel-api.ts                   |  1 +
 extensions/nostr/src/channel.inbound.test.ts          |  1 +
 extensions/nostr/src/channel.lifecycle.test.ts        |  1 +
 extensions/nostr/src/channel.outbound.test.ts         |  1 +
 extensions/nostr/src/channel.setup.ts                 |  1 +
 extensions/nostr/src/channel.test.ts                  |  1 +
 extensions/nostr/src/channel.ts                       |  1 +
 extensions/nostr/src/config-schema.ts                 |  1 +
 extensions/nostr/src/default-relays.ts                |  1 +
 extensions/nostr/src/gateway.ts                       |  1 +
 extensions/nostr/src/inbound-direct-dm-runtime.ts     |  1 +
 extensions/nostr/src/nostr-bus.fuzz.test.ts           |  1 +
 extensions/nostr/src/nostr-bus.inbound.test.ts        |  1 +
 extensions/nostr/src/nostr-bus.integration.test.ts    |  1 +
 extensions/nostr/src/nostr-bus.test.ts                |  1 +
 extensions/nostr/src/nostr-bus.ts                     |  1 +
 extensions/nostr/src/nostr-key-utils.ts               |  1 +
 extensions/nostr/src/nostr-profile-core.ts            |  1 +
 extensions/nostr/src/nostr-profile-http-runtime.ts    |  1 +
 extensions/nostr/src/nostr-profile-url-safety.ts      |  1 +
 extensions/nostr/src/nostr-profile.fuzz.test.ts       |  1 +
 extensions/nostr/src/nostr-profile.test.ts            |  1 +
 extensions/nostr/src/nostr-state-store.test.ts        |  1 +
 extensions/nostr/src/nostr-state-store.ts             |  1 +
 extensions/nostr/src/runtime.ts                       |  1 +
 extensions/nostr/src/session-route.ts                 |  1 +
 extensions/nostr/src/setup-adapter.ts                 |  1 +
 extensions/nostr/src/setup-surface.ts                 |  9 +++------
 extensions/nostr/src/test-fixtures.ts                 |  1 +
 extensions/nostr/src/types.ts                         |  1 +
 extensions/nostr/test-api.ts                          |  1 +
 extensions/ollama/api.ts                              |  1 +
 extensions/ollama/index.test.ts                       |  1 +
 extensions/ollama/index.ts                            |  1 +
 extensions/ollama/ollama.live.test.ts                 |  1 +
 .../ollama/provider-discovery.import-guard.test.ts    |  1 +
 extensions/ollama/provider-discovery.test.ts          |  1 +
 extensions/ollama/provider-discovery.ts               |  1 +
 extensions/ollama/provider-policy-api.test.ts         |  1 +
 extensions/ollama/provider-policy-api.ts              |  1 +
 extensions/ollama/runtime-api.ts                      |  1 +
 extensions/ollama/src/defaults.ts                     |  1 +
 extensions/ollama/src/discovery-shared.test.ts        |  1 +
 extensions/ollama/src/discovery-shared.ts             |  1 +
 extensions/ollama/src/embedding-provider.test.ts      |  1 +
 extensions/ollama/src/embedding-provider.ts           |  1 +
 extensions/ollama/src/media-understanding-provider.ts |  1 +
 extensions/ollama/src/memory-embedding-adapter.ts     |  1 +
 extensions/ollama/src/model-behavior.ts               |  1 +
 extensions/ollama/src/model-id.ts                     |  1 +
 extensions/ollama/src/ollama-json.ts                  |  1 +
 extensions/ollama/src/provider-base-url.test.ts       |  1 +
 extensions/ollama/src/provider-base-url.ts            |  1 +
 extensions/ollama/src/provider-models.ssrf.test.ts    |  1 +
 extensions/ollama/src/provider-models.test.ts         |  1 +
 extensions/ollama/src/provider-models.ts              |  1 +
 .../ollama/src/sanitizers/kimi-inline-reasoning.ts    |  1 +
 .../ollama/src/sanitizers/visible-content-contract.ts |  1 +
 extensions/ollama/src/sanitizers/visible-content.ts   |  1 +
 extensions/ollama/src/setup.test.ts                   |  1 +
 extensions/ollama/src/setup.ts                        |  1 +
 extensions/ollama/src/stream-runtime.test.ts          |  1 +
 extensions/ollama/src/stream.test.ts                  |  1 +
 extensions/ollama/src/stream.ts                       |  1 +
 extensions/ollama/src/web-search-provider.test.ts     |  1 +
 extensions/ollama/src/web-search-provider.ts          |  1 +
 extensions/ollama/src/wsl2-crash-loop-check.test.ts   |  1 +
 extensions/ollama/src/wsl2-crash-loop-check.ts        |  1 +
 extensions/ollama/web-search-contract-api.ts          |  1 +
 extensions/ollama/web-search-provider.ts              |  1 +
 extensions/openai/api.ts                              |  1 +
 extensions/openai/auth-choice-copy.ts                 |  1 +
 extensions/openai/base-url.test.ts                    |  1 +
 extensions/openai/base-url.ts                         |  1 +
 extensions/openai/default-models.test.ts              |  1 +
 extensions/openai/default-models.ts                   |  1 +
 extensions/openai/embedding-batch.test.ts             |  1 +
 extensions/openai/embedding-batch.ts                  |  1 +
 extensions/openai/embedding-provider.test.ts          |  1 +
 extensions/openai/embedding-provider.ts               |  1 +
 extensions/openai/image-generation-provider.test.ts   |  1 +
 extensions/openai/image-generation-provider.ts        |  1 +
 extensions/openai/index.test.ts                       |  1 +
 extensions/openai/index.ts                            |  1 +
 .../openai/media-understanding-provider.test.ts       |  1 +
 extensions/openai/media-understanding-provider.ts     |  1 +
 extensions/openai/memory-embedding-adapter.test.ts    |  1 +
 extensions/openai/memory-embedding-adapter.ts         |  1 +
 extensions/openai/native-web-search.ts                |  1 +
 .../openai/openai-chatgpt-auth-identity.test.ts       |  1 +
 extensions/openai/openai-chatgpt-auth-identity.ts     |  1 +
 extensions/openai/openai-chatgpt-catalog.ts           |  1 +
 extensions/openai/openai-chatgpt-device-code.test.ts  |  1 +
 extensions/openai/openai-chatgpt-device-code.ts       |  1 +
 .../openai/openai-chatgpt-oauth-abort.runtime.ts      |  1 +
 .../openai/openai-chatgpt-oauth-flow.runtime.test.ts  |  1 +
 .../openai/openai-chatgpt-oauth-page.runtime.ts       |  1 +
 .../openai/openai-chatgpt-oauth-types.runtime.ts      |  1 +
 .../openai/openai-chatgpt-oauth.runtime.test.ts       |  1 +
 extensions/openai/openai-chatgpt-oauth.runtime.ts     |  1 +
 extensions/openai/openai-chatgpt-pkce.runtime.ts      |  1 +
 extensions/openai/openai-chatgpt-provider.runtime.ts  |  1 +
 extensions/openai/openai-chatgpt-provider.test.ts     |  1 +
 extensions/openai/openai-chatgpt-provider.ts          |  1 +
 extensions/openai/openai-chatgpt-shared.ts            |  1 +
 extensions/openai/openai-provider.live.test.ts        |  1 +
 extensions/openai/openai-provider.test.ts             |  1 +
 extensions/openai/openai-provider.ts                  |  1 +
 extensions/openai/openai-tts.live.test.ts             |  1 +
 extensions/openai/openai.live.test.ts                 |  1 +
 extensions/openai/openclaw.plugin.test.ts             |  1 +
 extensions/openai/prompt-overlay.ts                   |  1 +
 extensions/openai/provider-auth.contract.test.ts      |  1 +
 extensions/openai/provider-catalog.contract.test.ts   |  1 +
 extensions/openai/provider-contract-api.ts            |  1 +
 extensions/openai/provider-policy-api.test.ts         |  1 +
 extensions/openai/provider-policy-api.ts              |  1 +
 extensions/openai/provider-runtime.contract.test.ts   |  1 +
 extensions/openai/realtime-provider-shared.ts         |  1 +
 .../openai/realtime-transcription-provider.test.ts    |  1 +
 extensions/openai/realtime-transcription-provider.ts  |  1 +
 extensions/openai/realtime-voice-provider.test.ts     |  1 +
 extensions/openai/realtime-voice-provider.ts          |  1 +
 extensions/openai/register.runtime.ts                 |  1 +
 extensions/openai/replay-policy.ts                    |  1 +
 extensions/openai/setup-api.test.ts                   |  1 +
 extensions/openai/setup-api.ts                        |  1 +
 extensions/openai/shared.ts                           |  1 +
 extensions/openai/speech-provider.test.ts             |  1 +
 extensions/openai/speech-provider.ts                  |  1 +
 extensions/openai/test-api.ts                         |  1 +
 .../provider-catalog.contract-test-support.ts         |  1 +
 extensions/openai/thinking-policy.ts                  |  1 +
 extensions/openai/transport-policy.test.ts            |  1 +
 extensions/openai/transport-policy.ts                 |  1 +
 extensions/openai/tts.test.ts                         |  1 +
 extensions/openai/tts.ts                              |  1 +
 extensions/openai/video-generation-provider.test.ts   |  1 +
 extensions/openai/video-generation-provider.ts        |  1 +
 extensions/qa-matrix/cli.runtime.ts                   |  1 +
 extensions/qa-matrix/cli.ts                           |  1 +
 extensions/qa-matrix/index.ts                         |  1 +
 extensions/qa-matrix/runtime-api.ts                   |  1 +
 extensions/qa-matrix/runtime.ts                       |  1 +
 extensions/qa-matrix/src/cli-paths.ts                 |  1 +
 extensions/qa-matrix/src/cli.runtime.test.ts          |  1 +
 extensions/qa-matrix/src/cli.runtime.ts               |  1 +
 extensions/qa-matrix/src/cli.test.ts                  |  1 +
 extensions/qa-matrix/src/cli.ts                       |  1 +
 extensions/qa-matrix/src/docker-runtime.ts            |  1 +
 extensions/qa-matrix/src/run-config.test.ts           |  1 +
 extensions/qa-matrix/src/run-config.ts                |  1 +
 .../src/runners/contract/model-selection.test.ts      |  1 +
 .../qa-matrix/src/runners/contract/model-selection.ts |  1 +
 .../qa-matrix/src/runners/contract/runtime.test.ts    |  1 +
 extensions/qa-matrix/src/runners/contract/runtime.ts  |  1 +
 .../src/runners/contract/scenario-catalog.ts          |  1 +
 .../src/runners/contract/scenario-media-fixtures.ts   |  1 +
 .../runners/contract/scenario-runtime-allowbots.ts    |  1 +
 .../src/runners/contract/scenario-runtime-approval.ts |  1 +
 .../src/runners/contract/scenario-runtime-cli.test.ts |  1 +
 .../src/runners/contract/scenario-runtime-cli.ts      |  1 +
 .../src/runners/contract/scenario-runtime-config.ts   |  1 +
 .../src/runners/contract/scenario-runtime-dm.ts       |  1 +
 .../contract/scenario-runtime-e2ee-destructive.ts     |  1 +
 .../src/runners/contract/scenario-runtime-e2ee.ts     |  1 +
 .../src/runners/contract/scenario-runtime-edit.ts     |  1 +
 .../src/runners/contract/scenario-runtime-media.ts    |  1 +
 .../src/runners/contract/scenario-runtime-reaction.ts |  1 +
 .../src/runners/contract/scenario-runtime-restart.ts  |  1 +
 .../src/runners/contract/scenario-runtime-room.ts     |  4 +++-
 .../runners/contract/scenario-runtime-shared.test.ts  |  1 +
 .../src/runners/contract/scenario-runtime-shared.ts   |  1 +
 .../runners/contract/scenario-runtime-state-files.ts  |  1 +
 .../src/runners/contract/scenario-runtime.ts          |  1 +
 .../qa-matrix/src/runners/contract/scenario-types.ts  |  1 +
 .../qa-matrix/src/runners/contract/scenarios.test.ts  |  1 +
 .../qa-matrix/src/runners/contract/scenarios.ts       |  1 +
 extensions/qa-matrix/src/runtime-api.test.ts          |  1 +
 .../src/shared/live-transport-cli.runtime.test.ts     |  1 +
 .../src/shared/live-transport-cli.runtime.ts          |  1 +
 extensions/qa-matrix/src/shared/live-transport-cli.ts |  1 +
 .../qa-matrix/src/shared/live-transport-scenarios.ts  |  1 +
 extensions/qa-matrix/src/substrate/artifacts.test.ts  |  1 +
 extensions/qa-matrix/src/substrate/artifacts.ts       |  1 +
 extensions/qa-matrix/src/substrate/client.test.ts     |  1 +
 extensions/qa-matrix/src/substrate/client.ts          |  1 +
 extensions/qa-matrix/src/substrate/config.test.ts     |  1 +
 extensions/qa-matrix/src/substrate/config.ts          |  1 +
 .../qa-matrix/src/substrate/e2ee-client.test.ts       |  1 +
 extensions/qa-matrix/src/substrate/e2ee-client.ts     |  1 +
 extensions/qa-matrix/src/substrate/events.test.ts     |  1 +
 extensions/qa-matrix/src/substrate/events.ts          |  1 +
 .../qa-matrix/src/substrate/fault-proxy.test.ts       |  1 +
 extensions/qa-matrix/src/substrate/fault-proxy.ts     |  1 +
 .../qa-matrix/src/substrate/harness.runtime.test.ts   |  1 +
 extensions/qa-matrix/src/substrate/harness.runtime.ts |  1 +
 extensions/qa-matrix/src/substrate/request.test.ts    |  1 +
 extensions/qa-matrix/src/substrate/request.ts         |  1 +
 extensions/qa-matrix/src/substrate/sync.test.ts       |  1 +
 extensions/qa-matrix/src/substrate/sync.ts            |  1 +
 extensions/qa-matrix/src/substrate/topology.ts        |  1 +
 extensions/signal/api.ts                              |  1 +
 extensions/signal/channel-config-api.ts               |  1 +
 extensions/signal/channel-entry.ts                    |  1 +
 extensions/signal/config-api.ts                       |  1 +
 extensions/signal/contract-api.ts                     |  1 +
 extensions/signal/index.ts                            |  1 +
 extensions/signal/reaction-runtime-api.ts             |  1 +
 extensions/signal/runtime-api.ts                      |  1 +
 extensions/signal/setup-entry.ts                      |  1 +
 extensions/signal/src/account-types.ts                |  1 +
 extensions/signal/src/accounts.test.ts                |  1 +
 extensions/signal/src/accounts.ts                     |  1 +
 extensions/signal/src/approval-auth.test.ts           |  1 +
 extensions/signal/src/approval-auth.ts                |  1 +
 .../signal/src/approval-handler.runtime.test.ts       |  1 +
 extensions/signal/src/approval-handler.runtime.ts     |  1 +
 extensions/signal/src/approval-native.test.ts         |  1 +
 extensions/signal/src/approval-native.ts              |  1 +
 extensions/signal/src/approval-reactions.test.ts      |  1 +
 extensions/signal/src/approval-reactions.ts           |  1 +
 extensions/signal/src/approval-resolver.ts            |  1 +
 extensions/signal/src/channel.runtime.ts              |  1 +
 extensions/signal/src/channel.setup.ts                |  1 +
 extensions/signal/src/channel.ts                      |  1 +
 extensions/signal/src/client-adapter.test.ts          |  1 +
 extensions/signal/src/client-container.test.ts        |  1 +
 extensions/signal/src/client.test.ts                  |  1 +
 extensions/signal/src/client.ts                       |  1 +
 extensions/signal/src/config-schema.test.ts           |  1 +
 extensions/signal/src/config-schema.ts                |  1 +
 extensions/signal/src/config-ui-hints.ts              |  1 +
 extensions/signal/src/core.test.ts                    |  1 +
 extensions/signal/src/daemon.test.ts                  |  1 +
 extensions/signal/src/daemon.ts                       |  1 +
 extensions/signal/src/format.chunking.test.ts         |  1 +
 extensions/signal/src/format.test.ts                  |  1 +
 extensions/signal/src/format.ts                       |  1 +
 extensions/signal/src/identity.ts                     |  1 +
 .../signal/src/inbound-context.contract.test.ts       |  1 +
 extensions/signal/src/install-signal-cli.test.ts      |  1 +
 extensions/signal/src/install-signal-cli.ts           |  1 +
 extensions/signal/src/message-actions.test.ts         |  1 +
 extensions/signal/src/message-actions.ts              |  1 +
 .../signal/src/monitor.tool-result.autostart.test.ts  |  1 +
 ...irs-uuid-only-senders-uuid-allowlist-entry.test.ts |  1 +
 ...result.sends-tool-summaries-responseprefix.test.ts |  1 +
 .../signal/src/monitor.tool-result.test-harness.ts    |  1 +
 extensions/signal/src/monitor.ts                      |  1 +
 extensions/signal/src/monitor/access-policy.test.ts   |  1 +
 extensions/signal/src/monitor/access-policy.ts        |  1 +
 .../src/monitor/event-handler.inbound-context.test.ts |  1 +
 .../src/monitor/event-handler.mention-gating.test.ts  |  1 +
 .../src/monitor/event-handler.silent-ingest.test.ts   |  1 +
 .../signal/src/monitor/event-handler.test-harness.ts  |  1 +
 extensions/signal/src/monitor/event-handler.ts        |  1 +
 extensions/signal/src/monitor/event-handler.types.ts  |  1 +
 extensions/signal/src/monitor/inbound-context.ts      |  1 +
 extensions/signal/src/monitor/mentions.ts             |  1 +
 extensions/signal/src/normalize.test.ts               |  1 +
 extensions/signal/src/normalize.ts                    |  1 +
 extensions/signal/src/outbound-session.ts             |  1 +
 extensions/signal/src/probe.contract.test.ts          |  1 +
 extensions/signal/src/probe.ts                        |  1 +
 extensions/signal/src/reaction-level.ts               |  1 +
 extensions/signal/src/rpc-context.ts                  |  1 +
 extensions/signal/src/runtime.ts                      |  1 +
 extensions/signal/src/send-reactions.test.ts          |  1 +
 extensions/signal/src/send.runtime.ts                 |  1 +
 extensions/signal/src/send.test.ts                    |  1 +
 extensions/signal/src/send.ts                         |  1 +
 extensions/signal/src/setup-core.ts                   |  1 +
 extensions/signal/src/setup-surface.ts                |  1 +
 extensions/signal/src/shared.ts                       |  1 +
 extensions/signal/src/sse-reconnect.ts                |  1 +
 extensions/signal/src/uuid.ts                         |  1 +
 extensions/tlon/api.ts                                |  1 +
 extensions/tlon/channel-plugin-api.ts                 |  1 +
 extensions/tlon/doctor-contract-api.ts                |  1 +
 extensions/tlon/index.ts                              |  1 +
 extensions/tlon/setup-api.ts                          |  1 +
 extensions/tlon/setup-entry.ts                        |  1 +
 extensions/tlon/src/account-fields.ts                 |  1 +
 extensions/tlon/src/channel.message-adapter.test.ts   |  1 +
 extensions/tlon/src/channel.runtime.ts                |  1 +
 extensions/tlon/src/channel.ts                        |  1 +
 extensions/tlon/src/config-schema.ts                  |  1 +
 extensions/tlon/src/core.test.ts                      |  1 +
 extensions/tlon/src/doctor-contract.ts                |  1 +
 extensions/tlon/src/doctor.test.ts                    |  1 +
 extensions/tlon/src/doctor.ts                         |  1 +
 extensions/tlon/src/logger-runtime.ts                 |  1 +
 extensions/tlon/src/monitor/approval-runtime.ts       |  1 +
 extensions/tlon/src/monitor/approval.test.ts          |  1 +
 extensions/tlon/src/monitor/authorization.ts          |  1 +
 extensions/tlon/src/monitor/cites.ts                  |  1 +
 extensions/tlon/src/monitor/discovery.ts              |  1 +
 extensions/tlon/src/monitor/history.ts                |  1 +
 extensions/tlon/src/monitor/index.ts                  |  1 +
 extensions/tlon/src/monitor/media.test.ts             |  1 +
 extensions/tlon/src/monitor/media.ts                  |  1 +
 .../tlon/src/monitor/processed-messages.test.ts       |  1 +
 extensions/tlon/src/monitor/processed-messages.ts     |  1 +
 extensions/tlon/src/monitor/settings-helpers.test.ts  |  1 +
 extensions/tlon/src/monitor/settings-helpers.ts       |  1 +
 extensions/tlon/src/monitor/utils.ts                  |  1 +
 extensions/tlon/src/runtime.ts                        |  1 +
 extensions/tlon/src/session-route.ts                  |  1 +
 extensions/tlon/src/setup-core.ts                     |  1 +
 extensions/tlon/src/setup-surface.ts                  |  1 +
 extensions/tlon/src/targets.ts                        |  1 +
 extensions/tlon/src/tlon-api.test.ts                  |  1 +
 extensions/tlon/src/tlon-api.ts                       |  1 +
 extensions/tlon/src/types.ts                          |  1 +
 extensions/tlon/src/urbit/auth.ssrf.test.ts           |  1 +
 extensions/tlon/src/urbit/auth.ts                     |  1 +
 extensions/tlon/src/urbit/base-url.test.ts            |  1 +
 extensions/tlon/src/urbit/base-url.ts                 |  1 +
 extensions/tlon/src/urbit/channel-ops.test.ts         |  1 +
 extensions/tlon/src/urbit/channel-ops.ts              |  1 +
 extensions/tlon/src/urbit/context.ts                  |  1 +
 extensions/tlon/src/urbit/errors.ts                   |  1 +
 extensions/tlon/src/urbit/fetch.ts                    |  1 +
 extensions/tlon/src/urbit/send.test.ts                |  1 +
 extensions/tlon/src/urbit/send.ts                     |  1 +
 extensions/tlon/src/urbit/sse-client.test.ts          |  1 +
 extensions/tlon/src/urbit/sse-client.ts               |  1 +
 extensions/tlon/src/urbit/upload.test.ts              |  1 +
 extensions/tlon/test-api.ts                           |  1 +
 .../xai/.boundary-stubs/anthropic-vertex-api.d.ts     |  1 +
 extensions/xai/.boundary-stubs/ollama-api.d.ts        |  1 +
 .../xai/.boundary-stubs/ollama-runtime-api.d.ts       |  1 +
 .../xai/.boundary-stubs/speech-core-runtime-api.d.ts  |  1 +
 extensions/xai/api.test.ts                            |  1 +
 extensions/xai/api.ts                                 |  1 +
 extensions/xai/code-execution-tool-shared.ts          |  1 +
 extensions/xai/code-execution.test.ts                 |  1 +
 extensions/xai/code-execution.ts                      |  1 +
 extensions/xai/image-generation-provider.test.ts      |  1 +
 extensions/xai/image-generation-provider.ts           |  1 +
 extensions/xai/index.test.ts                          |  1 +
 extensions/xai/index.ts                               |  1 +
 extensions/xai/model-compat.ts                        |  1 +
 extensions/xai/model-definitions.ts                   |  1 +
 extensions/xai/model-id.test.ts                       |  1 +
 extensions/xai/model-id.ts                            |  1 +
 extensions/xai/onboard.test.ts                        |  1 +
 extensions/xai/onboard.ts                             |  1 +
 extensions/xai/provider-catalog.ts                    |  1 +
 extensions/xai/provider-contract-api.ts               |  1 +
 extensions/xai/provider-discovery.ts                  |  1 +
 extensions/xai/provider-models.ts                     |  1 +
 extensions/xai/provider-policy-api.test.ts            |  1 +
 extensions/xai/provider-policy-api.ts                 |  1 +
 .../xai/realtime-transcription-provider.test.ts       |  1 +
 extensions/xai/realtime-transcription-provider.ts     |  1 +
 extensions/xai/runtime-model-compat.test.ts           |  1 +
 extensions/xai/runtime-model-compat.ts                |  1 +
 extensions/xai/setup-api.ts                           |  1 +
 extensions/xai/speech-provider.test.ts                |  1 +
 extensions/xai/speech-provider.ts                     |  1 +
 extensions/xai/src/code-execution-config.ts           |  1 +
 extensions/xai/src/code-execution-shared.ts           |  1 +
 extensions/xai/src/responses-tool-shared.test.ts      |  1 +
 extensions/xai/src/responses-tool-shared.ts           |  1 +
 extensions/xai/src/tool-auth-shared.test.ts           |  1 +
 extensions/xai/src/tool-auth-shared.ts                |  1 +
 extensions/xai/src/tool-config-shared.test.ts         |  1 +
 extensions/xai/src/tool-config-shared.ts              |  1 +
 extensions/xai/src/web-search-provider.runtime.ts     |  1 +
 extensions/xai/src/web-search-response.types.ts       |  1 +
 extensions/xai/src/web-search-shared.ts               |  1 +
 extensions/xai/src/x-search-config.ts                 |  1 +
 extensions/xai/src/x-search-shared.ts                 |  1 +
 extensions/xai/src/xai-user-agent.test.ts             |  1 +
 extensions/xai/stream.test.ts                         |  1 +
 extensions/xai/stream.ts                              |  1 +
 extensions/xai/stt.test.ts                            |  1 +
 extensions/xai/stt.ts                                 |  1 +
 extensions/xai/test-api.ts                            |  1 +
 extensions/xai/test-helpers.ts                        |  1 +
 extensions/xai/tts.test.ts                            |  1 +
 extensions/xai/tts.ts                                 |  1 +
 extensions/xai/video-generation-provider.test.ts      |  1 +
 extensions/xai/video-generation-provider.ts           |  1 +
 extensions/xai/web-search-contract-api.ts             |  1 +
 extensions/xai/web-search-provider-shared.ts          |  1 +
 extensions/xai/web-search.test.ts                     |  1 +
 extensions/xai/web-search.ts                          |  1 +
 extensions/xai/x-search-tool-shared.ts                |  1 +
 extensions/xai/x-search.live.test.ts                  |  1 +
 extensions/xai/x-search.test.ts                       |  1 +
 extensions/xai/x-search.ts                            |  1 +
 extensions/xai/xai-oauth.test.ts                      |  1 +
 extensions/xai/xai-oauth.ts                           |  1 +
 extensions/xai/xai.live.test.ts                       |  1 +
 extensions/zalo/api.ts                                |  1 +
 extensions/zalo/channel-plugin-api.ts                 |  1 +
 extensions/zalo/contract-api.ts                       |  1 +
 extensions/zalo/index.test.ts                         |  1 +
 extensions/zalo/index.ts                              |  1 +
 extensions/zalo/runtime-api.test.ts                   |  1 +
 extensions/zalo/runtime-api.ts                        |  1 +
 extensions/zalo/secret-contract-api.ts                |  1 +
 extensions/zalo/setup-api.ts                          |  1 +
 extensions/zalo/setup-entry.ts                        |  1 +
 extensions/zalo/src/accounts.test.ts                  |  1 +
 extensions/zalo/src/accounts.ts                       |  1 +
 extensions/zalo/src/actions.runtime.ts                |  1 +
 extensions/zalo/src/actions.test.ts                   |  1 +
 extensions/zalo/src/actions.ts                        |  1 +
 extensions/zalo/src/api.test.ts                       |  1 +
 extensions/zalo/src/approval-auth.test.ts             |  1 +
 extensions/zalo/src/approval-auth.ts                  |  1 +
 extensions/zalo/src/channel.directory.test.ts         |  1 +
 extensions/zalo/src/channel.runtime.ts                |  1 +
 extensions/zalo/src/channel.startup.test.ts           |  1 +
 extensions/zalo/src/channel.ts                        |  1 +
 extensions/zalo/src/config-schema.test.ts             |  1 +
 extensions/zalo/src/config-schema.ts                  |  1 +
 extensions/zalo/src/group-access.ts                   |  1 +
 extensions/zalo/src/monitor-durable.test.ts           |  1 +
 extensions/zalo/src/monitor-durable.ts                |  1 +
 extensions/zalo/src/monitor.group-policy.test.ts      |  1 +
 extensions/zalo/src/monitor.image.polling.test.ts     |  1 +
 extensions/zalo/src/monitor.lifecycle.test.ts         |  1 +
 extensions/zalo/src/monitor.pairing.lifecycle.test.ts |  1 +
 .../zalo/src/monitor.polling.media-reply.test.ts      |  1 +
 .../zalo/src/monitor.reply-once.lifecycle.test.ts     |  1 +
 extensions/zalo/src/monitor.ts                        |  1 +
 extensions/zalo/src/monitor.types.ts                  |  1 +
 extensions/zalo/src/monitor.webhook.test.ts           |  1 +
 extensions/zalo/src/monitor.webhook.ts                |  1 +
 extensions/zalo/src/outbound-media.test.ts            |  1 +
 extensions/zalo/src/outbound-media.ts                 |  1 +
 extensions/zalo/src/outbound-payload.contract.test.ts |  1 +
 extensions/zalo/src/probe.ts                          |  1 +
 extensions/zalo/src/proxy.ts                          |  1 +
 extensions/zalo/src/runtime-api.ts                    | 11 +++--------
 extensions/zalo/src/runtime-support.ts                |  1 +
 extensions/zalo/src/runtime.ts                        |  1 +
 extensions/zalo/src/secret-contract.ts                |  1 +
 extensions/zalo/src/secret-input.ts                   |  1 +
 extensions/zalo/src/send.test.ts                      |  1 +
 extensions/zalo/src/send.ts                           |  1 +
 extensions/zalo/src/session-route.ts                  |  1 +
 extensions/zalo/src/setup-allow-from.ts               |  1 +
 extensions/zalo/src/setup-core.ts                     |  1 +
 extensions/zalo/src/setup-status.test.ts              |  1 +
 extensions/zalo/src/setup-surface.test.ts             |  1 +
 extensions/zalo/src/setup-surface.ts                  |  1 +
 extensions/zalo/src/status-issues.test.ts             |  1 +
 extensions/zalo/src/status-issues.ts                  |  1 +
 .../zalo/src/test-support/lifecycle-test-support.ts   |  1 +
 .../src/test-support/monitor-mocks-test-support.ts    |  1 +
 extensions/zalo/src/token.test.ts                     |  1 +
 extensions/zalo/src/token.ts                          |  1 +
 extensions/zalo/src/types.ts                          |  1 +
 extensions/zalo/test-api.ts                           |  1 +
 extensions/zalouser/api.ts                            |  1 +
 extensions/zalouser/contract-api.ts                   |  1 +
 extensions/zalouser/doctor-contract-api.ts            |  1 +
 extensions/zalouser/index.ts                          |  1 +
 extensions/zalouser/runtime-api.ts                    |  1 +
 extensions/zalouser/setup-entry.ts                    |  1 +
 extensions/zalouser/src/accounts.runtime.ts           |  1 +
 extensions/zalouser/src/accounts.test-mocks.ts        |  1 +
 extensions/zalouser/src/accounts.test.ts              |  1 +
 extensions/zalouser/src/accounts.ts                   |  1 +
 extensions/zalouser/src/channel-api.ts                |  1 +
 extensions/zalouser/src/channel.adapters.ts           |  1 +
 extensions/zalouser/src/channel.directory.test.ts     |  1 +
 extensions/zalouser/src/channel.runtime.ts            |  1 +
 extensions/zalouser/src/channel.sendpayload.test.ts   |  1 +
 extensions/zalouser/src/channel.setup.test.ts         |  1 +
 extensions/zalouser/src/channel.setup.ts              |  1 +
 extensions/zalouser/src/channel.test.ts               |  1 +
 extensions/zalouser/src/channel.ts                    |  1 +
 extensions/zalouser/src/config-schema.ts              |  1 +
 extensions/zalouser/src/directory.ts                  |  1 +
 extensions/zalouser/src/doctor-contract.ts            |  1 +
 extensions/zalouser/src/doctor.test.ts                |  1 +
 extensions/zalouser/src/doctor.ts                     |  1 +
 extensions/zalouser/src/group-policy.test.ts          |  1 +
 extensions/zalouser/src/group-policy.ts               |  1 +
 extensions/zalouser/src/message-sid.test.ts           |  1 +
 extensions/zalouser/src/message-sid.ts                |  1 +
 extensions/zalouser/src/monitor.account-scope.test.ts |  1 +
 extensions/zalouser/src/monitor.group-gating.test.ts  |  1 +
 extensions/zalouser/src/monitor.send-mocks.ts         |  1 +
 extensions/zalouser/src/monitor.ts                    |  1 +
 extensions/zalouser/src/probe.test.ts                 |  1 +
 extensions/zalouser/src/probe.ts                      |  1 +
 extensions/zalouser/src/qr-temp-file.ts               |  1 +
 extensions/zalouser/src/reaction.test.ts              |  1 +
 extensions/zalouser/src/reaction.ts                   |  1 +
 extensions/zalouser/src/runtime.ts                    |  1 +
 extensions/zalouser/src/security-audit.test.ts        |  1 +
 extensions/zalouser/src/security-audit.ts             |  1 +
 extensions/zalouser/src/send-receipt.ts               |  1 +
 extensions/zalouser/src/send.test.ts                  |  1 +
 extensions/zalouser/src/send.ts                       |  1 +
 extensions/zalouser/src/session-route.ts              |  1 +
 extensions/zalouser/src/setup-core.ts                 |  1 +
 extensions/zalouser/src/setup-surface.test.ts         |  1 +
 extensions/zalouser/src/setup-surface.ts              |  1 +
 extensions/zalouser/src/setup-test-helpers.ts         |  1 +
 extensions/zalouser/src/shared.ts                     |  1 +
 extensions/zalouser/src/status-issues.test.ts         |  1 +
 extensions/zalouser/src/status-issues.ts              |  1 +
 extensions/zalouser/src/test-helpers.ts               |  1 +
 extensions/zalouser/src/text-styles.test.ts           |  1 +
 extensions/zalouser/src/text-styles.ts                |  1 +
 extensions/zalouser/src/tool.test.ts                  |  1 +
 extensions/zalouser/src/tool.ts                       |  1 +
 extensions/zalouser/src/types.ts                      |  1 +
 extensions/zalouser/src/zalo-js.credentials.test.ts   |  1 +
 extensions/zalouser/src/zalo-js.test-mocks.ts         |  1 +
 extensions/zalouser/src/zalo-js.ts                    |  1 +
 extensions/zalouser/src/zalo-quote-metadata.test.ts   |  1 +
 extensions/zalouser/src/zca-client.test.ts            |  1 +
 extensions/zalouser/src/zca-client.ts                 |  1 +
 extensions/zalouser/src/zca-constants.ts              |  1 +
 extensions/zalouser/src/zca-js-exports.d.ts           |  1 +
 extensions/zalouser/test-api.ts                       |  1 +
 930 files changed, 938 insertions(+), 19 deletions(-)

diff --git a/extensions/copilot/doctor-contract-api.test.ts b/extensions/copilot/doctor-contract-api.test.ts
index a629b67d2a6a..a82cfe875f9b 100755
--- a/extensions/copilot/doctor-contract-api.test.ts
+++ b/extensions/copilot/doctor-contract-api.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover doctor contract api plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   legacyConfigRules,
diff --git a/extensions/copilot/harness.test.ts b/extensions/copilot/harness.test.ts
index f01a68b77156..f9d5bb3d43b8 100644
--- a/extensions/copilot/harness.test.ts
+++ b/extensions/copilot/harness.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover harness plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { CopilotClientPool } from "./harness.js";
 import { createCopilotAgentHarness, type CopilotSessionBinding } from "./harness.js";
diff --git a/extensions/copilot/harness.ts b/extensions/copilot/harness.ts
index b2648284183c..a5f841153e60 100644
--- a/extensions/copilot/harness.ts
+++ b/extensions/copilot/harness.ts
@@ -1,3 +1,4 @@
+// Copilot plugin module implements harness behavior.
 import type { CopilotClient } from "@github/copilot-sdk";
 import {
   compactWithSafetyTimeout,
diff --git a/extensions/copilot/index.test.ts b/extensions/copilot/index.test.ts
index 23aa4466d998..b90032babf09 100644
--- a/extensions/copilot/index.test.ts
+++ b/extensions/copilot/index.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover index plugin behavior.
 import fs from "node:fs";
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
 import { describe, expect, it, vi } from "vitest";
diff --git a/extensions/copilot/index.ts b/extensions/copilot/index.ts
index 657e1325f580..ba395c7655f5 100644
--- a/extensions/copilot/index.ts
+++ b/extensions/copilot/index.ts
@@ -1,3 +1,4 @@
+// Copilot plugin entrypoint registers its OpenClaw integration.
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { createCopilotAgentHarness, type CopilotSessionBinding } from "./harness.js";
 
diff --git a/extensions/copilot/src/attempt.live.test.ts b/extensions/copilot/src/attempt.live.test.ts
index 3669b313c5b8..51b6ca57e2b3 100644
--- a/extensions/copilot/src/attempt.live.test.ts
+++ b/extensions/copilot/src/attempt.live.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover attempt plugin behavior.
 import { mkdtemp, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
diff --git a/extensions/copilot/src/attempt.test.ts b/extensions/copilot/src/attempt.test.ts
index 5d6af41d20a0..337a39050e57 100644
--- a/extensions/copilot/src/attempt.test.ts
+++ b/extensions/copilot/src/attempt.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover attempt plugin behavior.
 import fsp from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";
diff --git a/extensions/copilot/src/attempt.ts b/extensions/copilot/src/attempt.ts
index bc3af4962608..2447bba419fb 100644
--- a/extensions/copilot/src/attempt.ts
+++ b/extensions/copilot/src/attempt.ts
@@ -1,3 +1,4 @@
+// Copilot plugin module implements attempt behavior.
 import fsp from "node:fs/promises";
 import type { MessageOptions, SessionConfig, Tool as SdkTool } from "@github/copilot-sdk";
 import type {
diff --git a/extensions/copilot/src/auth-bridge.test.ts b/extensions/copilot/src/auth-bridge.test.ts
index 459de13d5fe7..716b912ea493 100755
--- a/extensions/copilot/src/auth-bridge.test.ts
+++ b/extensions/copilot/src/auth-bridge.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover auth bridge plugin behavior.
 import { createHash } from "node:crypto";
 import { join, resolve } from "node:path";
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
diff --git a/extensions/copilot/src/auth-bridge.ts b/extensions/copilot/src/auth-bridge.ts
index 1c419a8c9970..489bd2664388 100755
--- a/extensions/copilot/src/auth-bridge.ts
+++ b/extensions/copilot/src/auth-bridge.ts
@@ -1,3 +1,4 @@
+// Copilot plugin module implements auth bridge behavior.
 import { createHash } from "node:crypto";
 import { homedir as osHomedir } from "node:os";
 import { join, normalize, resolve, sep } from "node:path";
diff --git a/extensions/copilot/src/compaction-bridge.test.ts b/extensions/copilot/src/compaction-bridge.test.ts
index 2d4280feb2af..d789f07f0658 100755
--- a/extensions/copilot/src/compaction-bridge.test.ts
+++ b/extensions/copilot/src/compaction-bridge.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover compaction bridge plugin behavior.
 import { describe, expect, it } from "vitest";
 import { createInfiniteSessionConfig } from "./compaction-bridge.js";
 
diff --git a/extensions/copilot/src/compaction-bridge.ts b/extensions/copilot/src/compaction-bridge.ts
index af006ce0584b..e5c6b41a7f2c 100755
--- a/extensions/copilot/src/compaction-bridge.ts
+++ b/extensions/copilot/src/compaction-bridge.ts
@@ -1,3 +1,4 @@
+// Copilot plugin module implements compaction bridge behavior.
 import type { SessionConfig } from "@github/copilot-sdk";
 
 // Compaction bridge for the GitHub Copilot agent runtime.
diff --git a/extensions/copilot/src/doctor-probes.test.ts b/extensions/copilot/src/doctor-probes.test.ts
index db80447af537..b6d323a5a98f 100755
--- a/extensions/copilot/src/doctor-probes.test.ts
+++ b/extensions/copilot/src/doctor-probes.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover doctor probes plugin behavior.
 import { EventEmitter } from "node:events";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/copilot/src/dual-write-transcripts.test.ts b/extensions/copilot/src/dual-write-transcripts.test.ts
index 0878a12f5f63..b75fff56bfcb 100755
--- a/extensions/copilot/src/dual-write-transcripts.test.ts
+++ b/extensions/copilot/src/dual-write-transcripts.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover dual write transcripts plugin behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/copilot/src/event-bridge.test.ts b/extensions/copilot/src/event-bridge.test.ts
index f6168f7bef79..30a22bcf8971 100644
--- a/extensions/copilot/src/event-bridge.test.ts
+++ b/extensions/copilot/src/event-bridge.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover event bridge plugin behavior.
 import type { SessionEvent } from "@github/copilot-sdk";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { attachEventBridge, type SessionLike } from "./event-bridge.js";
diff --git a/extensions/copilot/src/event-bridge.ts b/extensions/copilot/src/event-bridge.ts
index 8b65e7d97651..982a0b8ffe76 100644
--- a/extensions/copilot/src/event-bridge.ts
+++ b/extensions/copilot/src/event-bridge.ts
@@ -1,3 +1,4 @@
+// Copilot plugin module implements event bridge behavior.
 import type { MessageOptions, SessionEvent, SessionEventType } from "@github/copilot-sdk";
 import type { AgentMessage } from "openclaw/plugin-sdk/agent-harness-runtime";
 import {
diff --git a/extensions/copilot/src/hooks-bridge.test.ts b/extensions/copilot/src/hooks-bridge.test.ts
index d6644012fd4b..98b3cad65d52 100755
--- a/extensions/copilot/src/hooks-bridge.test.ts
+++ b/extensions/copilot/src/hooks-bridge.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover hooks bridge plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createHooksBridge, type CopilotHooksConfig } from "./hooks-bridge.js";
 
diff --git a/extensions/copilot/src/permission-bridge.test.ts b/extensions/copilot/src/permission-bridge.test.ts
index 4c03968d2475..16e19d3873c2 100755
--- a/extensions/copilot/src/permission-bridge.test.ts
+++ b/extensions/copilot/src/permission-bridge.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover permission bridge plugin behavior.
 import type {
   PermissionRequest as SdkPermissionRequest,
   PermissionRequestResult as SdkPermissionRequestResult,
diff --git a/extensions/copilot/src/replay-shim.test.ts b/extensions/copilot/src/replay-shim.test.ts
index 65917d3d9373..031a83ec1c9c 100755
--- a/extensions/copilot/src/replay-shim.test.ts
+++ b/extensions/copilot/src/replay-shim.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover replay shim plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   classifyResumeFailure,
diff --git a/extensions/copilot/src/runtime.test.ts b/extensions/copilot/src/runtime.test.ts
index ff73ed0194b2..461077439db3 100644
--- a/extensions/copilot/src/runtime.test.ts
+++ b/extensions/copilot/src/runtime.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover runtime plugin behavior.
 import { normalize, resolve, sep } from "node:path";
 import type { CopilotClient, CopilotClientOptions } from "@github/copilot-sdk";
 import { afterEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/copilot/src/runtime.ts b/extensions/copilot/src/runtime.ts
index 9b45bdbd2c0e..32f9d4b5b873 100644
--- a/extensions/copilot/src/runtime.ts
+++ b/extensions/copilot/src/runtime.ts
@@ -1,3 +1,4 @@
+// Copilot plugin module implements runtime behavior.
 import { normalize, resolve, sep } from "node:path";
 import type { CopilotClient, CopilotClientOptions } from "@github/copilot-sdk";
 import { loadCopilotSdk } from "./sdk-loader.js";
diff --git a/extensions/copilot/src/sdk-loader.test.ts b/extensions/copilot/src/sdk-loader.test.ts
index f8f48fe23a3f..34d9ab259436 100755
--- a/extensions/copilot/src/sdk-loader.test.ts
+++ b/extensions/copilot/src/sdk-loader.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover sdk loader plugin behavior.
 import { mkdtempSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import path from "node:path";
diff --git a/extensions/copilot/src/sdk-loader.ts b/extensions/copilot/src/sdk-loader.ts
index cb8feabd4bcc..1f94044ded06 100755
--- a/extensions/copilot/src/sdk-loader.ts
+++ b/extensions/copilot/src/sdk-loader.ts
@@ -1,3 +1,4 @@
+// Copilot plugin module implements sdk loader behavior.
 import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import path from "node:path";
diff --git a/extensions/copilot/src/telemetry-bridge.test.ts b/extensions/copilot/src/telemetry-bridge.test.ts
index 4fdec2b25f38..f92f78b1f11a 100755
--- a/extensions/copilot/src/telemetry-bridge.test.ts
+++ b/extensions/copilot/src/telemetry-bridge.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover telemetry bridge plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   createTelemetryConfig,
diff --git a/extensions/copilot/src/telemetry-bridge.ts b/extensions/copilot/src/telemetry-bridge.ts
index fb1345d7d9c2..8cc4e78f14d8 100755
--- a/extensions/copilot/src/telemetry-bridge.ts
+++ b/extensions/copilot/src/telemetry-bridge.ts
@@ -1,3 +1,4 @@
+// Copilot plugin module implements telemetry bridge behavior.
 import type { CopilotClientOptions } from "@github/copilot-sdk";
 
 // Telemetry bridge for the GitHub Copilot agent runtime.
diff --git a/extensions/copilot/src/tool-bridge.test.ts b/extensions/copilot/src/tool-bridge.test.ts
index 579a510dc51d..9c2fc6a14787 100644
--- a/extensions/copilot/src/tool-bridge.test.ts
+++ b/extensions/copilot/src/tool-bridge.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover tool bridge plugin behavior.
 import type { Tool as SdkTool, ToolInvocation, ToolResultObject } from "@github/copilot-sdk";
 import type { AnyAgentTool, SandboxContext } from "openclaw/plugin-sdk/agent-harness-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/copilot/src/tool-bridge.ts b/extensions/copilot/src/tool-bridge.ts
index 58442c4f6aa2..b77e6db43f39 100644
--- a/extensions/copilot/src/tool-bridge.ts
+++ b/extensions/copilot/src/tool-bridge.ts
@@ -1,3 +1,4 @@
+// Copilot plugin module implements tool bridge behavior.
 import type { Tool as SdkTool, ToolInvocation, ToolResultObject } from "@github/copilot-sdk";
 import type {
   AnyAgentTool,
diff --git a/extensions/copilot/src/usage-bridge.test.ts b/extensions/copilot/src/usage-bridge.test.ts
index e7f43b9b8661..680b07088e24 100644
--- a/extensions/copilot/src/usage-bridge.test.ts
+++ b/extensions/copilot/src/usage-bridge.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover usage bridge plugin behavior.
 import type { NormalizedUsage } from "openclaw/plugin-sdk/agent-harness-runtime";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/copilot/src/usage-bridge.ts b/extensions/copilot/src/usage-bridge.ts
index ae58673764a4..2fadfdb38336 100644
--- a/extensions/copilot/src/usage-bridge.ts
+++ b/extensions/copilot/src/usage-bridge.ts
@@ -1,3 +1,4 @@
+// Copilot plugin module implements usage bridge behavior.
 import type { AgentMessage, NormalizedUsage } from "openclaw/plugin-sdk/agent-harness-runtime";
 
 type AssistantMessage = Extract<AgentMessage, { role: "assistant" }>;
diff --git a/extensions/copilot/src/user-input-bridge.test.ts b/extensions/copilot/src/user-input-bridge.test.ts
index 188472bf4778..3dd339ad8ac5 100755
--- a/extensions/copilot/src/user-input-bridge.test.ts
+++ b/extensions/copilot/src/user-input-bridge.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover user input bridge plugin behavior.
 import type { SessionConfig } from "@github/copilot-sdk";
 import { describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/copilot/src/workspace-bootstrap.test.ts b/extensions/copilot/src/workspace-bootstrap.test.ts
index 65b632d384d4..2fcc669a6474 100644
--- a/extensions/copilot/src/workspace-bootstrap.test.ts
+++ b/extensions/copilot/src/workspace-bootstrap.test.ts
@@ -1,3 +1,4 @@
+// Copilot tests cover workspace bootstrap plugin behavior.
 import { mkdtemp, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";
diff --git a/extensions/copilot/src/workspace-bootstrap.ts b/extensions/copilot/src/workspace-bootstrap.ts
index 1c644d55f65c..05ce0e063504 100644
--- a/extensions/copilot/src/workspace-bootstrap.ts
+++ b/extensions/copilot/src/workspace-bootstrap.ts
@@ -1,3 +1,4 @@
+// Copilot plugin module implements workspace bootstrap behavior.
 import path from "node:path";
 import type {
   AgentHarnessAttemptParams,
diff --git a/extensions/google-meet/doctor-contract-api.ts b/extensions/google-meet/doctor-contract-api.ts
index db610ee157d7..5f741f149819 100644
--- a/extensions/google-meet/doctor-contract-api.ts
+++ b/extensions/google-meet/doctor-contract-api.ts
@@ -1 +1,2 @@
+// Google Meet API module exposes the plugin public contract.
 export { legacyConfigRules, normalizeCompatibilityConfig } from "./src/config-compat.js";
diff --git a/extensions/google-meet/google-meet.live.test.ts b/extensions/google-meet/google-meet.live.test.ts
index d38bdb5702d7..e8d8f128166f 100644
--- a/extensions/google-meet/google-meet.live.test.ts
+++ b/extensions/google-meet/google-meet.live.test.ts
@@ -1,3 +1,4 @@
+// Google Meet tests cover google meet plugin behavior.
 import { isLiveTestEnabled } from "openclaw/plugin-sdk/test-env";
 import { describe, expect, it } from "vitest";
 import { buildGoogleMeetExportManifest, googleMeetExportFileNames } from "./src/cli.js";
diff --git a/extensions/google-meet/index.create.test.ts b/extensions/google-meet/index.create.test.ts
index ac413dc59771..1502710f6fc0 100644
--- a/extensions/google-meet/index.create.test.ts
+++ b/extensions/google-meet/index.create.test.ts
@@ -1,3 +1,4 @@
+// Google Meet tests cover index.create plugin behavior.
 import { Command } from "commander";
 import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import plugin, { testing as googleMeetPluginTesting } from "./index.js";
diff --git a/extensions/google-meet/index.test.ts b/extensions/google-meet/index.test.ts
index d971401cd187..97181708a127 100644
--- a/extensions/google-meet/index.test.ts
+++ b/extensions/google-meet/index.test.ts
@@ -1,3 +1,4 @@
+// Google Meet tests cover index plugin behavior.
 import { EventEmitter } from "node:events";
 import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
diff --git a/extensions/google-meet/index.ts b/extensions/google-meet/index.ts
index 02e91d4df043..fb28baa4f0d8 100644
--- a/extensions/google-meet/index.ts
+++ b/extensions/google-meet/index.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin entrypoint registers its OpenClaw integration.
 import {
   optionalPositiveIntegerSchema,
   readPositiveIntegerParam,
diff --git a/extensions/google-meet/node-host.test.ts b/extensions/google-meet/node-host.test.ts
index d61d656c562f..f046ccfa91b9 100644
--- a/extensions/google-meet/node-host.test.ts
+++ b/extensions/google-meet/node-host.test.ts
@@ -1,3 +1,4 @@
+// Google Meet tests cover node host plugin behavior.
 import { spawnSync } from "node:child_process";
 import { EventEmitter } from "node:events";
 import { afterAll, afterEach, beforeAll, describe, expect, it, vi } from "vitest";
diff --git a/extensions/google-meet/src/agent-consult.ts b/extensions/google-meet/src/agent-consult.ts
index 6dac4b704f6c..3cec6dc52c4c 100644
--- a/extensions/google-meet/src/agent-consult.ts
+++ b/extensions/google-meet/src/agent-consult.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements agent consult behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import type { PluginRuntime, RuntimeLogger } from "openclaw/plugin-sdk/plugin-runtime";
diff --git a/extensions/google-meet/src/calendar.ts b/extensions/google-meet/src/calendar.ts
index ba5963be63fa..631e363dc0b7 100644
--- a/extensions/google-meet/src/calendar.ts
+++ b/extensions/google-meet/src/calendar.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements calendar behavior.
 import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime";
 import { googleApiError } from "./google-api-errors.js";
 
diff --git a/extensions/google-meet/src/cli.test.ts b/extensions/google-meet/src/cli.test.ts
index a986bc824ff5..cdc0a79107d9 100644
--- a/extensions/google-meet/src/cli.test.ts
+++ b/extensions/google-meet/src/cli.test.ts
@@ -1,3 +1,4 @@
+// Google Meet tests cover cli plugin behavior.
 import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import path from "node:path";
diff --git a/extensions/google-meet/src/cli.ts b/extensions/google-meet/src/cli.ts
index 5ea9950b0660..f6d675e09ce9 100644
--- a/extensions/google-meet/src/cli.ts
+++ b/extensions/google-meet/src/cli.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements cli behavior.
 import { mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { createInterface } from "node:readline/promises";
diff --git a/extensions/google-meet/src/config-compat.test.ts b/extensions/google-meet/src/config-compat.test.ts
index 5ed9e8f0d16a..a35853f1b035 100644
--- a/extensions/google-meet/src/config-compat.test.ts
+++ b/extensions/google-meet/src/config-compat.test.ts
@@ -1,3 +1,4 @@
+// Google Meet tests cover config compat plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/google-meet/src/config-compat.ts b/extensions/google-meet/src/config-compat.ts
index cf1050f660ad..a0d0b90d7019 100644
--- a/extensions/google-meet/src/config-compat.ts
+++ b/extensions/google-meet/src/config-compat.ts
@@ -1,3 +1,4 @@
+// Google Meet helper module supports config compat behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   asNullableRecord as asRecord,
diff --git a/extensions/google-meet/src/config.test.ts b/extensions/google-meet/src/config.test.ts
index c4326f5664a5..c52130db6719 100644
--- a/extensions/google-meet/src/config.test.ts
+++ b/extensions/google-meet/src/config.test.ts
@@ -1,3 +1,4 @@
+// Google Meet tests cover config plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it } from "vitest";
 import { resolveGoogleMeetConfig, resolveGoogleMeetGatewayOperationTimeoutMs } from "./config.js";
diff --git a/extensions/google-meet/src/config.ts b/extensions/google-meet/src/config.ts
index 33e0bd751942..9591745955ce 100644
--- a/extensions/google-meet/src/config.ts
+++ b/extensions/google-meet/src/config.ts
@@ -1,3 +1,4 @@
+// Google Meet helper module supports config behavior.
 import {
   addTimerTimeoutGraceMs,
   resolvePositiveTimerTimeoutMs,
diff --git a/extensions/google-meet/src/create.ts b/extensions/google-meet/src/create.ts
index 3cb77a7549d6..be0e8cde48d0 100644
--- a/extensions/google-meet/src/create.ts
+++ b/extensions/google-meet/src/create.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements create behavior.
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { GoogleMeetConfig, GoogleMeetMode, GoogleMeetTransport } from "./config.js";
diff --git a/extensions/google-meet/src/drive.ts b/extensions/google-meet/src/drive.ts
index 503fb6c8fc63..266dc4d70df5 100644
--- a/extensions/google-meet/src/drive.ts
+++ b/extensions/google-meet/src/drive.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements drive behavior.
 import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime";
 import { googleApiError } from "./google-api-errors.js";
 
diff --git a/extensions/google-meet/src/google-api-errors.ts b/extensions/google-meet/src/google-api-errors.ts
index b78bf2a77647..99697c4f63fb 100644
--- a/extensions/google-meet/src/google-api-errors.ts
+++ b/extensions/google-meet/src/google-api-errors.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements google api errors behavior.
 const REAUTH_HINT = "Re-run `openclaw googlemeet auth login` and store the refreshed oauth block.";
 
 function scopeText(scopes: readonly string[]): string {
diff --git a/extensions/google-meet/src/meet.ts b/extensions/google-meet/src/meet.ts
index bb8f4e892f64..862ec38e22a3 100644
--- a/extensions/google-meet/src/meet.ts
+++ b/extensions/google-meet/src/meet.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements meet behavior.
 import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime";
 import { uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { exportGoogleDriveDocumentText, extractGoogleDriveDocumentId } from "./drive.js";
diff --git a/extensions/google-meet/src/node-host.ts b/extensions/google-meet/src/node-host.ts
index 3c832ba3aa3d..27ddae829420 100644
--- a/extensions/google-meet/src/node-host.ts
+++ b/extensions/google-meet/src/node-host.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements node host behavior.
 import { spawn, spawnSync, type ChildProcess } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { setTimeout as sleep } from "node:timers/promises";
diff --git a/extensions/google-meet/src/oauth.test.ts b/extensions/google-meet/src/oauth.test.ts
index 9efefe1e6c26..8a22bf8055a7 100644
--- a/extensions/google-meet/src/oauth.test.ts
+++ b/extensions/google-meet/src/oauth.test.ts
@@ -1,3 +1,4 @@
+// Google Meet tests cover oauth plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
   buildGoogleMeetAuthUrl,
diff --git a/extensions/google-meet/src/oauth.ts b/extensions/google-meet/src/oauth.ts
index c1ac6bea30c9..2bc1a6ae9e63 100644
--- a/extensions/google-meet/src/oauth.ts
+++ b/extensions/google-meet/src/oauth.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements oauth behavior.
 import {
   MAX_DATE_TIMESTAMP_MS,
   resolveDateTimestampMs,
diff --git a/extensions/google-meet/src/realtime-node.ts b/extensions/google-meet/src/realtime-node.ts
index 7450404c16c4..9c62ce45579b 100644
--- a/extensions/google-meet/src/realtime-node.ts
+++ b/extensions/google-meet/src/realtime-node.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements realtime node behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import type { PluginRuntime, RuntimeLogger } from "openclaw/plugin-sdk/plugin-runtime";
diff --git a/extensions/google-meet/src/realtime.ts b/extensions/google-meet/src/realtime.ts
index bbb926cbdd9d..ffee31537885 100644
--- a/extensions/google-meet/src/realtime.ts
+++ b/extensions/google-meet/src/realtime.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements realtime behavior.
 import { spawn } from "node:child_process";
 import type { Writable } from "node:stream";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/google-meet/src/runtime.ts b/extensions/google-meet/src/runtime.ts
index 48b2c81b4297..e206319333b7 100644
--- a/extensions/google-meet/src/runtime.ts
+++ b/extensions/google-meet/src/runtime.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements runtime behavior.
 import { randomUUID } from "node:crypto";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
diff --git a/extensions/google-meet/src/setup.ts b/extensions/google-meet/src/setup.ts
index e792e64690ba..b51c52d30ec9 100644
--- a/extensions/google-meet/src/setup.ts
+++ b/extensions/google-meet/src/setup.ts
@@ -1,3 +1,4 @@
+// Google Meet setup module handles plugin onboarding behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/google-meet/src/test-support/plugin-harness.ts b/extensions/google-meet/src/test-support/plugin-harness.ts
index 6ab045b0cce3..60b92918588a 100644
--- a/extensions/google-meet/src/test-support/plugin-harness.ts
+++ b/extensions/google-meet/src/test-support/plugin-harness.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements plugin harness behavior.
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
 import { vi } from "vitest";
diff --git a/extensions/google-meet/src/transports/chrome-audio-device.ts b/extensions/google-meet/src/transports/chrome-audio-device.ts
index f0bec9007fe0..057071a1c364 100644
--- a/extensions/google-meet/src/transports/chrome-audio-device.ts
+++ b/extensions/google-meet/src/transports/chrome-audio-device.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements chrome audio device behavior.
 export const GOOGLE_MEET_SYSTEM_PROFILER_COMMAND = "/usr/sbin/system_profiler";
 
 export function outputMentionsBlackHole2ch(output: string): boolean {
diff --git a/extensions/google-meet/src/transports/chrome-browser-proxy.test.ts b/extensions/google-meet/src/transports/chrome-browser-proxy.test.ts
index 2554352e265e..146c293de035 100644
--- a/extensions/google-meet/src/transports/chrome-browser-proxy.test.ts
+++ b/extensions/google-meet/src/transports/chrome-browser-proxy.test.ts
@@ -1,3 +1,4 @@
+// Google Meet tests cover chrome browser proxy plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import type { PluginRuntime } from "openclaw/plugin-sdk/plugin-runtime";
 import { describe, expect, it, vi } from "vitest";
diff --git a/extensions/google-meet/src/transports/chrome-browser-proxy.ts b/extensions/google-meet/src/transports/chrome-browser-proxy.ts
index f20527b7e077..1356cedd4d33 100644
--- a/extensions/google-meet/src/transports/chrome-browser-proxy.ts
+++ b/extensions/google-meet/src/transports/chrome-browser-proxy.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements chrome browser proxy behavior.
 import { addTimerTimeoutGraceMs } from "openclaw/plugin-sdk/number-runtime";
 import type { PluginRuntime } from "openclaw/plugin-sdk/plugin-runtime";
 
diff --git a/extensions/google-meet/src/transports/chrome-create.ts b/extensions/google-meet/src/transports/chrome-create.ts
index 519ee23a0f8d..0805f6c33483 100644
--- a/extensions/google-meet/src/transports/chrome-create.ts
+++ b/extensions/google-meet/src/transports/chrome-create.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements chrome create behavior.
 import type { PluginRuntime } from "openclaw/plugin-sdk/plugin-runtime";
 import { sleep } from "openclaw/plugin-sdk/runtime-env";
 import type { GoogleMeetConfig } from "../config.js";
diff --git a/extensions/google-meet/src/transports/chrome.test.ts b/extensions/google-meet/src/transports/chrome.test.ts
index 88a41396d41d..c42dd9c588f3 100644
--- a/extensions/google-meet/src/transports/chrome.test.ts
+++ b/extensions/google-meet/src/transports/chrome.test.ts
@@ -1,3 +1,4 @@
+// Google Meet tests cover chrome plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it } from "vitest";
 import { testing } from "./chrome.js";
diff --git a/extensions/google-meet/src/transports/chrome.ts b/extensions/google-meet/src/transports/chrome.ts
index 49a810e5a6b8..6faeb6e39c2b 100644
--- a/extensions/google-meet/src/transports/chrome.ts
+++ b/extensions/google-meet/src/transports/chrome.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements chrome behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { callGatewayFromCli } from "openclaw/plugin-sdk/gateway-runtime";
 import { addTimerTimeoutGraceMs } from "openclaw/plugin-sdk/number-runtime";
diff --git a/extensions/google-meet/src/transports/twilio.ts b/extensions/google-meet/src/transports/twilio.ts
index a4bda23a7149..3f7fedd860d3 100644
--- a/extensions/google-meet/src/transports/twilio.ts
+++ b/extensions/google-meet/src/transports/twilio.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements twilio behavior.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 const DTMF_PATTERN = /^[0-9*#wWpP,]+$/;
diff --git a/extensions/google-meet/src/transports/types.ts b/extensions/google-meet/src/transports/types.ts
index 37e7679acb0d..81455b9aa662 100644
--- a/extensions/google-meet/src/transports/types.ts
+++ b/extensions/google-meet/src/transports/types.ts
@@ -1,3 +1,4 @@
+// Google Meet type declarations define plugin contracts.
 import type { GoogleMeetMode, GoogleMeetModeInput, GoogleMeetTransport } from "../config.js";
 
 type GoogleMeetSessionState = "active" | "ended";
diff --git a/extensions/google-meet/src/voice-call-gateway.test.ts b/extensions/google-meet/src/voice-call-gateway.test.ts
index 82792c1677d0..05f34b31c038 100644
--- a/extensions/google-meet/src/voice-call-gateway.test.ts
+++ b/extensions/google-meet/src/voice-call-gateway.test.ts
@@ -1,3 +1,4 @@
+// Google Meet tests cover voice call gateway plugin behavior.
 import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { resolveGoogleMeetConfig } from "./config.js";
 import {
diff --git a/extensions/google-meet/src/voice-call-gateway.ts b/extensions/google-meet/src/voice-call-gateway.ts
index fa0efef466c4..fd95215c98cb 100644
--- a/extensions/google-meet/src/voice-call-gateway.ts
+++ b/extensions/google-meet/src/voice-call-gateway.ts
@@ -1,3 +1,4 @@
+// Google Meet plugin module implements voice call gateway behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import {
   GatewayClient,
diff --git a/extensions/google/api.test.ts b/extensions/google/api.test.ts
index 8019f72aa90f..a996db9294b8 100644
--- a/extensions/google/api.test.ts
+++ b/extensions/google/api.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover api plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   isGoogleGenerativeAiApi,
diff --git a/extensions/google/api.ts b/extensions/google/api.ts
index 626c9567d84a..b8d1ce9ff879 100644
--- a/extensions/google/api.ts
+++ b/extensions/google/api.ts
@@ -1,3 +1,4 @@
+// Google API module exposes the plugin public contract.
 import {
   resolveProviderHttpRequestConfig,
   type ProviderRequestTransportOverrides,
diff --git a/extensions/google/cli-backend.ts b/extensions/google/cli-backend.ts
index c7b3948942db..6c378ffff2ed 100644
--- a/extensions/google/cli-backend.ts
+++ b/extensions/google/cli-backend.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements cli backend behavior.
 import type { CliBackendPlugin } from "openclaw/plugin-sdk/cli-backend";
 import {
   CLI_FRESH_WATCHDOG_DEFAULTS,
diff --git a/extensions/google/default-model.test.ts b/extensions/google/default-model.test.ts
index f1df845ac2dd..b873152506f8 100644
--- a/extensions/google/default-model.test.ts
+++ b/extensions/google/default-model.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover default model plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/provider-onboard";
 import { describe, expect, it } from "vitest";
 import { applyGoogleGeminiModelDefault, GOOGLE_GEMINI_DEFAULT_MODEL } from "./api.js";
diff --git a/extensions/google/doctor-contract-api.ts b/extensions/google/doctor-contract-api.ts
index 3d1ca244575b..a7fdd6600d44 100644
--- a/extensions/google/doctor-contract-api.ts
+++ b/extensions/google/doctor-contract-api.ts
@@ -1,3 +1,4 @@
+// Google API module exposes the plugin public contract.
 import type { DoctorSessionRouteStateOwner } from "openclaw/plugin-sdk/runtime-doctor";
 
 export const sessionRouteStateOwners: DoctorSessionRouteStateOwner[] = [
diff --git a/extensions/google/embedding-batch.ts b/extensions/google/embedding-batch.ts
index 3ceed4eb2c10..ab4c89228e1e 100644
--- a/extensions/google/embedding-batch.ts
+++ b/extensions/google/embedding-batch.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements embedding batch behavior.
 import crypto from "node:crypto";
 import {
   buildEmbeddingBatchGroupOptions,
diff --git a/extensions/google/embedding-provider.test.ts b/extensions/google/embedding-provider.test.ts
index 896329cca605..80b15739cdc6 100644
--- a/extensions/google/embedding-provider.test.ts
+++ b/extensions/google/embedding-provider.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover embedding provider plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 vi.mock("openclaw/plugin-sdk/memory-core-host-engine-embeddings", async (importOriginal) => {
diff --git a/extensions/google/embedding-provider.ts b/extensions/google/embedding-provider.ts
index 50eb4346ab04..c7651700ee46 100644
--- a/extensions/google/embedding-provider.ts
+++ b/extensions/google/embedding-provider.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import {
   buildRemoteBaseUrlPolicy,
   debugEmbeddingsLog,
diff --git a/extensions/google/gemini-auth.ts b/extensions/google/gemini-auth.ts
index 98961ae5e9d8..9242dd54356f 100644
--- a/extensions/google/gemini-auth.ts
+++ b/extensions/google/gemini-auth.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements gemini auth behavior.
 import { parseGoogleOauthApiKey } from "./oauth-token-shared.js";
 
 export function parseGeminiAuth(apiKey: string): { headers: Record<string, string> } {
diff --git a/extensions/google/gemini-cli-provider.ts b/extensions/google/gemini-cli-provider.ts
index d900a3557ddf..ee080f2ed2a9 100644
--- a/extensions/google/gemini-cli-provider.ts
+++ b/extensions/google/gemini-cli-provider.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import type {
   OpenClawPluginApi,
   ProviderAuthContext,
diff --git a/extensions/google/generation-provider-metadata.ts b/extensions/google/generation-provider-metadata.ts
index 9d2ac74218eb..11c1ba816f00 100644
--- a/extensions/google/generation-provider-metadata.ts
+++ b/extensions/google/generation-provider-metadata.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import type { MusicGenerationProvider } from "openclaw/plugin-sdk/music-generation";
 import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth";
 import type {
diff --git a/extensions/google/google-genai-runtime.ts b/extensions/google/google-genai-runtime.ts
index b02a09c8beb2..953ee7ce1230 100644
--- a/extensions/google/google-genai-runtime.ts
+++ b/extensions/google/google-genai-runtime.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements google genai runtime behavior.
 import { GoogleGenAI } from "@google/genai";
 
 export type GoogleGenAIClient = InstanceType<typeof GoogleGenAI>;
diff --git a/extensions/google/google.live.test.ts b/extensions/google/google.live.test.ts
index d166e9d59d08..df3fec0b436f 100644
--- a/extensions/google/google.live.test.ts
+++ b/extensions/google/google.live.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover google plugin behavior.
 import {
   registerProviderPlugin,
   requireRegisteredProvider,
diff --git a/extensions/google/image-generation-provider.test.ts b/extensions/google/image-generation-provider.test.ts
index 1fe04aab2a1d..8010876e12f7 100644
--- a/extensions/google/image-generation-provider.test.ts
+++ b/extensions/google/image-generation-provider.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover image generation provider plugin behavior.
 import * as providerAuthRuntime from "openclaw/plugin-sdk/provider-auth-runtime";
 import * as providerHttp from "openclaw/plugin-sdk/provider-http";
 import { mockPinnedHostnameResolution } from "openclaw/plugin-sdk/test-env";
diff --git a/extensions/google/image-generation-provider.ts b/extensions/google/image-generation-provider.ts
index 0c9c04650637..974512dfcd01 100644
--- a/extensions/google/image-generation-provider.ts
+++ b/extensions/google/image-generation-provider.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import {
   generatedImageAssetFromBase64,
   type GeneratedImageAsset,
diff --git a/extensions/google/index.test.ts b/extensions/google/index.test.ts
index e0b7bbf4b5c2..55f2a0282d7a 100644
--- a/extensions/google/index.test.ts
+++ b/extensions/google/index.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover index plugin behavior.
 import type { Context, Model } from "openclaw/plugin-sdk/llm";
 import type {
   ProviderReplaySessionEntry,
diff --git a/extensions/google/index.ts b/extensions/google/index.ts
index ac477c1e3eb2..724efd872566 100644
--- a/extensions/google/index.ts
+++ b/extensions/google/index.ts
@@ -1,3 +1,4 @@
+// Google plugin entrypoint registers its OpenClaw integration.
 import type { ImageGenerationProvider } from "openclaw/plugin-sdk/image-generation";
 import type { MediaUnderstandingProvider } from "openclaw/plugin-sdk/media-understanding";
 import type { MusicGenerationProvider } from "openclaw/plugin-sdk/music-generation";
diff --git a/extensions/google/manifest.test.ts b/extensions/google/manifest.test.ts
index 8ca7ce57963e..de0cc9209c02 100644
--- a/extensions/google/manifest.test.ts
+++ b/extensions/google/manifest.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover manifest plugin behavior.
 import { readFileSync } from "node:fs";
 import { describe, expect, it } from "vitest";
 
diff --git a/extensions/google/media-understanding-provider.ts b/extensions/google/media-understanding-provider.ts
index 0c688a217d83..85597199af95 100644
--- a/extensions/google/media-understanding-provider.ts
+++ b/extensions/google/media-understanding-provider.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import {
   describeImageWithModel,
   describeImagesWithModel,
diff --git a/extensions/google/media-understanding-provider.video.test.ts b/extensions/google/media-understanding-provider.video.test.ts
index 12a0a634f24a..84307f54aeef 100644
--- a/extensions/google/media-understanding-provider.video.test.ts
+++ b/extensions/google/media-understanding-provider.video.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover media understanding provider.video plugin behavior.
 import {
   createRequestCaptureJsonFetch,
   installPinnedHostnameTestHooks,
diff --git a/extensions/google/memory-embedding-adapter.ts b/extensions/google/memory-embedding-adapter.ts
index 3d544e625ef8..b44340d58c72 100644
--- a/extensions/google/memory-embedding-adapter.ts
+++ b/extensions/google/memory-embedding-adapter.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements memory embedding adapter behavior.
 import {
   hasNonTextEmbeddingParts,
   isMissingEmbeddingApiKeyError,
diff --git a/extensions/google/model-id.test.ts b/extensions/google/model-id.test.ts
index ea92aa56f180..52361d029ce0 100644
--- a/extensions/google/model-id.test.ts
+++ b/extensions/google/model-id.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover model id plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeAntigravityModelId, normalizeGoogleModelId } from "./api.js";
 
diff --git a/extensions/google/model-id.ts b/extensions/google/model-id.ts
index e4f9007acc16..4ed22e65c5fb 100644
--- a/extensions/google/model-id.ts
+++ b/extensions/google/model-id.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements model id behavior.
 const ANTIGRAVITY_BARE_PRO_IDS = new Set(["gemini-3-pro", "gemini-3.1-pro", "gemini-3-1-pro"]);
 const GOOGLE_PROVIDER_PREFIX = "google/";
 
diff --git a/extensions/google/music-generation-provider.test.ts b/extensions/google/music-generation-provider.test.ts
index 43f6027ef88c..2f0fed928c97 100644
--- a/extensions/google/music-generation-provider.test.ts
+++ b/extensions/google/music-generation-provider.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover music generation provider plugin behavior.
 import { afterAll, afterEach, describe, expect, it, vi } from "vitest";
 
 const { createGoogleGenAIMock, generateContentMock } = vi.hoisted(() => {
diff --git a/extensions/google/music-generation-provider.ts b/extensions/google/music-generation-provider.ts
index b281ccbe9e99..dc349d4b34a0 100644
--- a/extensions/google/music-generation-provider.ts
+++ b/extensions/google/music-generation-provider.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import { extensionForMime } from "openclaw/plugin-sdk/media-mime";
 import type {
   GeneratedMusicAsset,
diff --git a/extensions/google/oauth-token-shared.test.ts b/extensions/google/oauth-token-shared.test.ts
index 8bb0aeb7ed48..a92fb88999bc 100644
--- a/extensions/google/oauth-token-shared.test.ts
+++ b/extensions/google/oauth-token-shared.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover oauth token shared plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   formatGoogleOauthApiKey,
diff --git a/extensions/google/oauth-token-shared.ts b/extensions/google/oauth-token-shared.ts
index 08577a174913..ffa025d5664b 100644
--- a/extensions/google/oauth-token-shared.ts
+++ b/extensions/google/oauth-token-shared.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements oauth token shared behavior.
 import { readStringValue } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 type GoogleOauthApiKeyCredential = {
diff --git a/extensions/google/oauth.credentials.ts b/extensions/google/oauth.credentials.ts
index 4fee1bcef62b..f4a28277554f 100644
--- a/extensions/google/oauth.credentials.ts
+++ b/extensions/google/oauth.credentials.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements oauth.credentials behavior.
 import { existsSync, readFileSync, readdirSync, realpathSync } from "node:fs";
 import type { Dirent } from "node:fs";
 import { delimiter, dirname, join } from "node:path";
diff --git a/extensions/google/oauth.flow.ts b/extensions/google/oauth.flow.ts
index 607882267e81..67ad08c99dd6 100644
--- a/extensions/google/oauth.flow.ts
+++ b/extensions/google/oauth.flow.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements oauth.flow behavior.
 import { generateHexPkceVerifierChallenge } from "openclaw/plugin-sdk/provider-auth";
 import {
   generateOAuthState,
diff --git a/extensions/google/oauth.http.ts b/extensions/google/oauth.http.ts
index 413048996b37..353c7d734656 100644
--- a/extensions/google/oauth.http.ts
+++ b/extensions/google/oauth.http.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements oauth.http behavior.
 import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime";
 import { DEFAULT_FETCH_TIMEOUT_MS } from "./oauth.shared.js";
 
diff --git a/extensions/google/oauth.local-login.test.ts b/extensions/google/oauth.local-login.test.ts
index 626bec4390bb..834278510185 100644
--- a/extensions/google/oauth.local-login.test.ts
+++ b/extensions/google/oauth.local-login.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover oauth.local login plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const AUTH_URL = "https://accounts.google.com/o/oauth2/v2/auth?state=state-123";
diff --git a/extensions/google/oauth.project.ts b/extensions/google/oauth.project.ts
index b068876c31a2..701c21454646 100644
--- a/extensions/google/oauth.project.ts
+++ b/extensions/google/oauth.project.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements oauth.project behavior.
 import { fetchWithTimeout } from "./oauth.http.js";
 import {
   CODE_ASSIST_ENDPOINT_PROD,
diff --git a/extensions/google/oauth.runtime.ts b/extensions/google/oauth.runtime.ts
index dcbd0ad24df7..c6477e72b7e0 100644
--- a/extensions/google/oauth.runtime.ts
+++ b/extensions/google/oauth.runtime.ts
@@ -1 +1,2 @@
+// Google plugin module implements oauth behavior.
 export { loginGeminiCliOAuth, refreshGeminiCliOAuthToken } from "./oauth.js";
diff --git a/extensions/google/oauth.settings.ts b/extensions/google/oauth.settings.ts
index a47c9f9ec817..328d5d4724e4 100644
--- a/extensions/google/oauth.settings.ts
+++ b/extensions/google/oauth.settings.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements oauth.settings behavior.
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
diff --git a/extensions/google/oauth.shared.ts b/extensions/google/oauth.shared.ts
index 3c7414ad1b1d..bfe23d1c8833 100644
--- a/extensions/google/oauth.shared.ts
+++ b/extensions/google/oauth.shared.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements oauth.shared behavior.
 export const CLIENT_ID_KEYS = ["OPENCLAW_GEMINI_OAUTH_CLIENT_ID", "GEMINI_CLI_OAUTH_CLIENT_ID"];
 export const CLIENT_SECRET_KEYS = [
   "OPENCLAW_GEMINI_OAUTH_CLIENT_SECRET",
diff --git a/extensions/google/oauth.test.ts b/extensions/google/oauth.test.ts
index 950cb7aa43a4..805c2c2373ea 100644
--- a/extensions/google/oauth.test.ts
+++ b/extensions/google/oauth.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover oauth plugin behavior.
 import { join, parse } from "node:path";
 import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/google/oauth.token.ts b/extensions/google/oauth.token.ts
index b995657f4de5..8983cc5038c6 100644
--- a/extensions/google/oauth.token.ts
+++ b/extensions/google/oauth.token.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements oauth.token behavior.
 import {
   asDateTimestampMs,
   resolveExpiresAtMsFromDurationSeconds,
diff --git a/extensions/google/oauth.ts b/extensions/google/oauth.ts
index 4461567e60ea..1f30c10b49ef 100644
--- a/extensions/google/oauth.ts
+++ b/extensions/google/oauth.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements oauth behavior.
 import type { OAuthCredential } from "openclaw/plugin-sdk/provider-auth";
 import { clearCredentialsCache, extractGeminiCliCredentials } from "./oauth.credentials.js";
 import {
diff --git a/extensions/google/onboard.ts b/extensions/google/onboard.ts
index 8efc1984d9a7..aba7d21d1f97 100644
--- a/extensions/google/onboard.ts
+++ b/extensions/google/onboard.ts
@@ -1,3 +1,4 @@
+// Google setup module handles plugin onboarding behavior.
 import {
   applyAgentDefaultModelPrimary,
   type OpenClawConfig,
diff --git a/extensions/google/provider-catalog.test.ts b/extensions/google/provider-catalog.test.ts
index 875e56fde34f..9da6ae2d5af8 100644
--- a/extensions/google/provider-catalog.test.ts
+++ b/extensions/google/provider-catalog.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover provider catalog plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildGoogleStaticCatalogProvider,
diff --git a/extensions/google/provider-catalog.ts b/extensions/google/provider-catalog.ts
index 923a8b0a997f..284ddeb0cc2f 100644
--- a/extensions/google/provider-catalog.ts
+++ b/extensions/google/provider-catalog.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import type {
   ModelDefinitionConfig,
   ModelProviderConfig,
diff --git a/extensions/google/provider-contract-api.ts b/extensions/google/provider-contract-api.ts
index c90b1fe92ab1..87738aeb1416 100644
--- a/extensions/google/provider-contract-api.ts
+++ b/extensions/google/provider-contract-api.ts
@@ -1,3 +1,4 @@
+// Google API module exposes the plugin public contract.
 import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared";
 
 const noopAuth = async () => ({ profiles: [] });
diff --git a/extensions/google/provider-discovery.ts b/extensions/google/provider-discovery.ts
index 8692fc66f29a..8de97f097fe0 100644
--- a/extensions/google/provider-discovery.ts
+++ b/extensions/google/provider-discovery.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared";
 import {
   buildGoogleStaticCatalogProvider,
diff --git a/extensions/google/provider-hooks.ts b/extensions/google/provider-hooks.ts
index 7b09c48bdde6..42740a2c27f7 100644
--- a/extensions/google/provider-hooks.ts
+++ b/extensions/google/provider-hooks.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import type {
   ProviderDefaultThinkingPolicyContext,
   ProviderThinkingProfile,
diff --git a/extensions/google/provider-models.test.ts b/extensions/google/provider-models.test.ts
index 8198e7d7eeee..617e92826d09 100644
--- a/extensions/google/provider-models.test.ts
+++ b/extensions/google/provider-models.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover provider models plugin behavior.
 import type { ProviderRuntimeModel } from "openclaw/plugin-sdk/plugin-entry";
 import { describe, expect, it } from "vitest";
 import { createProviderDynamicModelContext as createContext } from "../test-support/provider-model-test-helpers.js";
diff --git a/extensions/google/provider-models.ts b/extensions/google/provider-models.ts
index 45b967e4267d..b381d5437792 100644
--- a/extensions/google/provider-models.ts
+++ b/extensions/google/provider-models.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import type {
   ProviderResolveDynamicModelContext,
   ProviderRuntimeModel,
diff --git a/extensions/google/provider-policy-api.test.ts b/extensions/google/provider-policy-api.test.ts
index 7b232be6b10c..ec5d1245599f 100644
--- a/extensions/google/provider-policy-api.test.ts
+++ b/extensions/google/provider-policy-api.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover provider policy api plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeConfig, resolveThinkingProfile } from "./provider-policy-api.js";
 
diff --git a/extensions/google/provider-policy-api.ts b/extensions/google/provider-policy-api.ts
index bf9a7ef42ac2..a3e59f6836a7 100644
--- a/extensions/google/provider-policy-api.ts
+++ b/extensions/google/provider-policy-api.ts
@@ -1,3 +1,4 @@
+// Google API module exposes the plugin public contract.
 import type { ProviderDefaultThinkingPolicyContext } from "openclaw/plugin-sdk/core";
 import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-types";
 import { normalizeGoogleProviderConfig, resolveGoogleThinkingProfile } from "./provider-policy.js";
diff --git a/extensions/google/provider-policy.ts b/extensions/google/provider-policy.ts
index 3d92fb41061c..a915263f044f 100644
--- a/extensions/google/provider-policy.ts
+++ b/extensions/google/provider-policy.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import type {
   ProviderDefaultThinkingPolicyContext,
   ProviderThinkingProfile,
@@ -43,9 +44,7 @@ const GOOGLE_VERTEX_REGION_HOST_SUFFIX = "-aiplatform.googleapis.com";
 
 export function isGoogleVertexHostname(hostname: string): boolean {
   const normalized = hostname.toLowerCase();
-  return (
-    normalized === GOOGLE_VERTEX_HOST || normalized.endsWith(GOOGLE_VERTEX_REGION_HOST_SUFFIX)
-  );
+  return normalized === GOOGLE_VERTEX_HOST || normalized.endsWith(GOOGLE_VERTEX_REGION_HOST_SUFFIX);
 }
 
 export function isGoogleVertexBaseUrl(baseUrl?: string | null): boolean {
diff --git a/extensions/google/provider-registration.test.ts b/extensions/google/provider-registration.test.ts
index a887e59528d6..558006de06dc 100644
--- a/extensions/google/provider-registration.test.ts
+++ b/extensions/google/provider-registration.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover provider registration plugin behavior.
 import type { Model } from "openclaw/plugin-sdk/llm";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { buildGoogleProvider } from "./provider-registration.js";
diff --git a/extensions/google/provider-registration.ts b/extensions/google/provider-registration.ts
index 63225b1d32d2..a52dc7a22d33 100644
--- a/extensions/google/provider-registration.ts
+++ b/extensions/google/provider-registration.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import type {
   OpenClawPluginApi,
   ProviderReasoningOutputModeContext,
diff --git a/extensions/google/provider-runtime.contract.test.ts b/extensions/google/provider-runtime.contract.test.ts
index b74febbac09b..fc0d0501e688 100644
--- a/extensions/google/provider-runtime.contract.test.ts
+++ b/extensions/google/provider-runtime.contract.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover provider runtime.contract plugin behavior.
 import { describeGoogleProviderRuntimeContract } from "openclaw/plugin-sdk/provider-test-contracts";
 
 describeGoogleProviderRuntimeContract(() => import("./index.js"));
diff --git a/extensions/google/realtime-voice-provider.test.ts b/extensions/google/realtime-voice-provider.test.ts
index 9968b2f586dc..eed1b08035f6 100644
--- a/extensions/google/realtime-voice-provider.test.ts
+++ b/extensions/google/realtime-voice-provider.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover realtime voice provider plugin behavior.
 import { REALTIME_VOICE_AUDIO_FORMAT_PCM16_24KHZ } from "openclaw/plugin-sdk/realtime-voice";
 import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { buildGoogleRealtimeVoiceProvider } from "./realtime-voice-provider.js";
diff --git a/extensions/google/realtime-voice-provider.ts b/extensions/google/realtime-voice-provider.ts
index d2ca9c166d6a..80cba25a6d27 100644
--- a/extensions/google/realtime-voice-provider.ts
+++ b/extensions/google/realtime-voice-provider.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import { randomUUID } from "node:crypto";
 import type {
   ActivityHandling,
diff --git a/extensions/google/runtime-api.ts b/extensions/google/runtime-api.ts
index 24ac97898844..38d0bb0046e1 100644
--- a/extensions/google/runtime-api.ts
+++ b/extensions/google/runtime-api.ts
@@ -1,3 +1,4 @@
+// Google API module exposes the plugin public contract.
 export {
   DEFAULT_GOOGLE_API_BASE_URL,
   createGoogleThinkingPayloadWrapper,
diff --git a/extensions/google/setup-api.test.ts b/extensions/google/setup-api.test.ts
index e4324eb8d080..e1e5d4e67d84 100644
--- a/extensions/google/setup-api.test.ts
+++ b/extensions/google/setup-api.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover setup api plugin behavior.
 import type { CliBackendPlugin } from "openclaw/plugin-sdk/cli-backend";
 import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/google/setup-api.ts b/extensions/google/setup-api.ts
index e8d9a50abf08..84650d8e7c9e 100644
--- a/extensions/google/setup-api.ts
+++ b/extensions/google/setup-api.ts
@@ -1,3 +1,4 @@
+// Google API module exposes the plugin public contract.
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { buildGoogleGeminiCliBackend } from "./cli-backend.js";
 import { createGoogleVertexProvider } from "./provider-contract-api.js";
diff --git a/extensions/google/speech-provider.test.ts b/extensions/google/speech-provider.test.ts
index 54560d36afce..ed6916886551 100644
--- a/extensions/google/speech-provider.test.ts
+++ b/extensions/google/speech-provider.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover speech provider plugin behavior.
 import {
   getProviderHttpMocks,
   installProviderHttpMockCleanup,
diff --git a/extensions/google/speech-provider.ts b/extensions/google/speech-provider.ts
index 72262e8d0837..51e348a98e78 100644
--- a/extensions/google/speech-provider.ts
+++ b/extensions/google/speech-provider.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import { transcodeAudioBufferToOpus } from "openclaw/plugin-sdk/media-runtime";
 import {
   assertOkOrThrowProviderError,
diff --git a/extensions/google/src/gemini-web-search-provider.runtime.ts b/extensions/google/src/gemini-web-search-provider.runtime.ts
index 239be795473a..7d1786dacdc0 100644
--- a/extensions/google/src/gemini-web-search-provider.runtime.ts
+++ b/extensions/google/src/gemini-web-search-provider.runtime.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import {
   createProviderHttpError,
   formatProviderHttpErrorMessage,
diff --git a/extensions/google/src/gemini-web-search-provider.shared.ts b/extensions/google/src/gemini-web-search-provider.shared.ts
index fdbf0b491151..0f89be07be4a 100644
--- a/extensions/google/src/gemini-web-search-provider.shared.ts
+++ b/extensions/google/src/gemini-web-search-provider.shared.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import {
   isRecord,
   normalizeOptionalString as trimToUndefined,
diff --git a/extensions/google/src/gemini-web-search-provider.ts b/extensions/google/src/gemini-web-search-provider.ts
index e0f9c9eea856..9cb448697e46 100644
--- a/extensions/google/src/gemini-web-search-provider.ts
+++ b/extensions/google/src/gemini-web-search-provider.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   createWebSearchProviderContractFields,
diff --git a/extensions/google/test-api.ts b/extensions/google/test-api.ts
index 44dfec0dddd9..c6199dbab7a9 100644
--- a/extensions/google/test-api.ts
+++ b/extensions/google/test-api.ts
@@ -1,3 +1,4 @@
+// Google API module exposes the plugin public contract.
 export { buildGoogleGeminiCliBackend } from "./cli-backend.js";
 export { buildGoogleImageGenerationProvider } from "./image-generation-provider.js";
 export { buildGoogleMusicGenerationProvider } from "./music-generation-provider.js";
diff --git a/extensions/google/thinking-api.ts b/extensions/google/thinking-api.ts
index fbb47dfdc594..d99571f15a14 100644
--- a/extensions/google/thinking-api.ts
+++ b/extensions/google/thinking-api.ts
@@ -1,3 +1,4 @@
+// Google API module exposes the plugin public contract.
 export {
   createGoogleThinkingPayloadWrapper,
   createGoogleThinkingStreamWrapper,
diff --git a/extensions/google/thinking.test.ts b/extensions/google/thinking.test.ts
index 752c9b163fae..542d39cfc669 100644
--- a/extensions/google/thinking.test.ts
+++ b/extensions/google/thinking.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover thinking plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   resolveGoogleGemini3ThinkingLevel,
diff --git a/extensions/google/thinking.ts b/extensions/google/thinking.ts
index edc0735a5f61..490b0014f463 100644
--- a/extensions/google/thinking.ts
+++ b/extensions/google/thinking.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements thinking behavior.
 export {
   createGoogleThinkingPayloadWrapper,
   createGoogleThinkingStreamWrapper,
diff --git a/extensions/google/transport-stream.test.ts b/extensions/google/transport-stream.test.ts
index 7f569044f77a..0134b97a8b6d 100644
--- a/extensions/google/transport-stream.test.ts
+++ b/extensions/google/transport-stream.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover transport stream plugin behavior.
 import { mkdir, mkdtemp, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/google/transport-stream.ts b/extensions/google/transport-stream.ts
index c2e1816bf3d8..c50f94cd151d 100644
--- a/extensions/google/transport-stream.ts
+++ b/extensions/google/transport-stream.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements transport stream behavior.
 import type { StreamFn } from "openclaw/plugin-sdk/agent-core";
 import {
   calculateCost,
diff --git a/extensions/google/vertex-adc.ts b/extensions/google/vertex-adc.ts
index 62399c11aabe..9017b2ca0665 100644
--- a/extensions/google/vertex-adc.ts
+++ b/extensions/google/vertex-adc.ts
@@ -1,3 +1,4 @@
+// Google plugin module implements vertex adc behavior.
 import { existsSync, readFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/google/video-generation-provider.test.ts b/extensions/google/video-generation-provider.test.ts
index c35ab684bcb0..5a16b6604d37 100644
--- a/extensions/google/video-generation-provider.test.ts
+++ b/extensions/google/video-generation-provider.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover video generation provider plugin behavior.
 import { mockPinnedHostnameResolution } from "openclaw/plugin-sdk/test-env";
 import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/google/video-generation-provider.ts b/extensions/google/video-generation-provider.ts
index 057858622b3b..4257daa3ff02 100644
--- a/extensions/google/video-generation-provider.ts
+++ b/extensions/google/video-generation-provider.ts
@@ -1,3 +1,4 @@
+// Google provider module implements model/runtime integration.
 import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime";
 import {
   createProviderOperationDeadline,
diff --git a/extensions/google/web-search-contract-api.ts b/extensions/google/web-search-contract-api.ts
index c2fdfbf9eb88..08a9ee167a24 100644
--- a/extensions/google/web-search-contract-api.ts
+++ b/extensions/google/web-search-contract-api.ts
@@ -1 +1,2 @@
+// Google API module exposes the plugin public contract.
 export { createGeminiWebSearchProvider } from "./src/gemini-web-search-provider.js";
diff --git a/extensions/google/web-search-provider.test.ts b/extensions/google/web-search-provider.test.ts
index b66ddbb53a38..7254b73bb304 100644
--- a/extensions/google/web-search-provider.test.ts
+++ b/extensions/google/web-search-provider.test.ts
@@ -1,3 +1,4 @@
+// Google tests cover web search provider plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { withEnv, withEnvAsync, withFetchPreconnect } from "openclaw/plugin-sdk/test-env";
 import { afterEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/google/web-search-provider.ts b/extensions/google/web-search-provider.ts
index c2fdfbf9eb88..0dfb7cde8e66 100644
--- a/extensions/google/web-search-provider.ts
+++ b/extensions/google/web-search-provider.ts
@@ -1 +1,2 @@
+// Google provider module implements model/runtime integration.
 export { createGeminiWebSearchProvider } from "./src/gemini-web-search-provider.js";
diff --git a/extensions/googlechat/api.ts b/extensions/googlechat/api.ts
index fa02d6c72375..60f2788099a6 100644
--- a/extensions/googlechat/api.ts
+++ b/extensions/googlechat/api.ts
@@ -1,3 +1,4 @@
+// Googlechat API module exposes the plugin public contract.
 export { googlechatPlugin } from "./src/channel.js";
 export { googlechatSetupAdapter } from "./src/setup-core.js";
 export { googlechatSetupWizard } from "./src/setup-surface.js";
diff --git a/extensions/googlechat/channel-config-api.ts b/extensions/googlechat/channel-config-api.ts
index 6581ecc10196..2421081dcf55 100644
--- a/extensions/googlechat/channel-config-api.ts
+++ b/extensions/googlechat/channel-config-api.ts
@@ -1 +1,2 @@
+// Googlechat API module exposes the plugin public contract.
 export { GoogleChatChannelConfigSchema } from "./src/config-schema.js";
diff --git a/extensions/googlechat/channel-plugin-api.ts b/extensions/googlechat/channel-plugin-api.ts
index 605b2539fcbb..dd6defc01961 100644
--- a/extensions/googlechat/channel-plugin-api.ts
+++ b/extensions/googlechat/channel-plugin-api.ts
@@ -1 +1,2 @@
+// Googlechat API module exposes the plugin public contract.
 export { googlechatPlugin } from "./src/channel.js";
diff --git a/extensions/googlechat/config-api.ts b/extensions/googlechat/config-api.ts
index 5a0ee2a703ea..08328182e2a9 100644
--- a/extensions/googlechat/config-api.ts
+++ b/extensions/googlechat/config-api.ts
@@ -1,2 +1,3 @@
+// Googlechat API module exposes the plugin public contract.
 export { GoogleChatConfigSchema } from "openclaw/plugin-sdk/bundled-channel-config-schema";
 export { buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-primitives";
diff --git a/extensions/googlechat/contract-api.ts b/extensions/googlechat/contract-api.ts
index 30a6ad83a3ac..65fe3e623344 100644
--- a/extensions/googlechat/contract-api.ts
+++ b/extensions/googlechat/contract-api.ts
@@ -1,3 +1,4 @@
+// Googlechat API module exposes the plugin public contract.
 export {
   collectRuntimeConfigAssignments,
   secretTargetRegistryEntries,
diff --git a/extensions/googlechat/directory-contract-api.ts b/extensions/googlechat/directory-contract-api.ts
index 0c7d96596ebc..5e4b025410fc 100644
--- a/extensions/googlechat/directory-contract-api.ts
+++ b/extensions/googlechat/directory-contract-api.ts
@@ -1,3 +1,4 @@
+// Googlechat API module exposes the plugin public contract.
 import { googlechatDirectoryAdapter } from "./src/channel.adapters.js";
 
 export const googlechatDirectoryContractPlugin = {
diff --git a/extensions/googlechat/doctor-contract-api.ts b/extensions/googlechat/doctor-contract-api.ts
index a7a56f234421..07575133a4d4 100644
--- a/extensions/googlechat/doctor-contract-api.ts
+++ b/extensions/googlechat/doctor-contract-api.ts
@@ -1 +1,2 @@
+// Googlechat API module exposes the plugin public contract.
 export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
diff --git a/extensions/googlechat/index.ts b/extensions/googlechat/index.ts
index 17e9836b182a..73d28f36021d 100644
--- a/extensions/googlechat/index.ts
+++ b/extensions/googlechat/index.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin entrypoint registers its OpenClaw integration.
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelEntry({
diff --git a/extensions/googlechat/secret-contract-api.ts b/extensions/googlechat/secret-contract-api.ts
index 9f44ef28569c..7af9916370a8 100644
--- a/extensions/googlechat/secret-contract-api.ts
+++ b/extensions/googlechat/secret-contract-api.ts
@@ -1,3 +1,4 @@
+// Googlechat API module exposes the plugin public contract.
 export {
   channelSecrets,
   collectRuntimeConfigAssignments,
diff --git a/extensions/googlechat/setup-entry.ts b/extensions/googlechat/setup-entry.ts
index 27c28f1e8f0c..d9eecdf44704 100644
--- a/extensions/googlechat/setup-entry.ts
+++ b/extensions/googlechat/setup-entry.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/googlechat/src/accounts.ts b/extensions/googlechat/src/accounts.ts
index f1522ed4784d..c37f59a643b9 100644
--- a/extensions/googlechat/src/accounts.ts
+++ b/extensions/googlechat/src/accounts.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements accounts behavior.
 import {
   createAccountListHelpers,
   DEFAULT_ACCOUNT_ID,
diff --git a/extensions/googlechat/src/actions.test.ts b/extensions/googlechat/src/actions.test.ts
index af185f96cb14..08f2aebac24d 100644
--- a/extensions/googlechat/src/actions.test.ts
+++ b/extensions/googlechat/src/actions.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover actions plugin behavior.
 import path from "node:path";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/googlechat/src/actions.ts b/extensions/googlechat/src/actions.ts
index e7d257d4d179..d7ff372e94d8 100644
--- a/extensions/googlechat/src/actions.ts
+++ b/extensions/googlechat/src/actions.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements actions behavior.
 import {
   createActionGate,
   jsonResult,
diff --git a/extensions/googlechat/src/api.ts b/extensions/googlechat/src/api.ts
index c51a32115bf6..3a6c88299fbd 100644
--- a/extensions/googlechat/src/api.ts
+++ b/extensions/googlechat/src/api.ts
@@ -1,3 +1,4 @@
+// Googlechat API module exposes the plugin public contract.
 import crypto from "node:crypto";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { parseMediaContentLength } from "openclaw/plugin-sdk/media-runtime";
diff --git a/extensions/googlechat/src/approval-auth.test.ts b/extensions/googlechat/src/approval-auth.test.ts
index a9aa9dcb9d34..71946304650a 100644
--- a/extensions/googlechat/src/approval-auth.test.ts
+++ b/extensions/googlechat/src/approval-auth.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover approval auth plugin behavior.
 import { describe, expect, it } from "vitest";
 import { googleChatApprovalAuth } from "./approval-auth.js";
 
diff --git a/extensions/googlechat/src/approval-auth.ts b/extensions/googlechat/src/approval-auth.ts
index db3678a1675a..2876f7913a29 100644
--- a/extensions/googlechat/src/approval-auth.ts
+++ b/extensions/googlechat/src/approval-auth.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements approval auth behavior.
 import {
   createResolvedApproverActionAuthAdapter,
   resolveApprovalApprovers,
diff --git a/extensions/googlechat/src/auth.ts b/extensions/googlechat/src/auth.ts
index a48d376c6aa3..9ca1f9b5f8af 100644
--- a/extensions/googlechat/src/auth.ts
+++ b/extensions/googlechat/src/auth.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements auth behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { fetchWithSsrFGuard } from "../runtime-api.js";
 import type { ResolvedGoogleChatAccount } from "./accounts.js";
diff --git a/extensions/googlechat/src/channel-base.ts b/extensions/googlechat/src/channel-base.ts
index 61dfcfaef60f..0966f9e98b5c 100644
--- a/extensions/googlechat/src/channel-base.ts
+++ b/extensions/googlechat/src/channel-base.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements channel base behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { formatNormalizedAllowFromEntries } from "openclaw/plugin-sdk/allow-from";
 import {
diff --git a/extensions/googlechat/src/channel-config.test.ts b/extensions/googlechat/src/channel-config.test.ts
index 2103399c10f8..256bda52b705 100644
--- a/extensions/googlechat/src/channel-config.test.ts
+++ b/extensions/googlechat/src/channel-config.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover channel config plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import { googlechatPlugin } from "./channel.js";
diff --git a/extensions/googlechat/src/channel.adapters.ts b/extensions/googlechat/src/channel.adapters.ts
index 5fbc4310254d..07905c00891d 100644
--- a/extensions/googlechat/src/channel.adapters.ts
+++ b/extensions/googlechat/src/channel.adapters.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements channel.adapters behavior.
 import { adaptScopedAccountAccessor } from "openclaw/plugin-sdk/channel-config-helpers";
 import type {
   ChannelThreadingContext,
diff --git a/extensions/googlechat/src/channel.deps.runtime.ts b/extensions/googlechat/src/channel.deps.runtime.ts
index cf00d2be50c6..cee9e2cccc15 100644
--- a/extensions/googlechat/src/channel.deps.runtime.ts
+++ b/extensions/googlechat/src/channel.deps.runtime.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements channeleps behavior.
 export {
   buildChannelConfigSchema,
   chunkTextForOutbound,
diff --git a/extensions/googlechat/src/channel.runtime.ts b/extensions/googlechat/src/channel.runtime.ts
index 81f000f95e77..b1adeb151226 100644
--- a/extensions/googlechat/src/channel.runtime.ts
+++ b/extensions/googlechat/src/channel.runtime.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements channel behavior.
 import {
   probeGoogleChat as probeGoogleChatImpl,
   sendGoogleChatMessage as sendGoogleChatMessageImpl,
diff --git a/extensions/googlechat/src/channel.setup.ts b/extensions/googlechat/src/channel.setup.ts
index a57b1e8c18eb..33dea1bcf40f 100644
--- a/extensions/googlechat/src/channel.setup.ts
+++ b/extensions/googlechat/src/channel.setup.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements channel.setup behavior.
 import type { ChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import type { ResolvedGoogleChatAccount } from "./accounts.js";
 import { createGoogleChatPluginBase } from "./channel-base.js";
diff --git a/extensions/googlechat/src/channel.test.ts b/extensions/googlechat/src/channel.test.ts
index 6d5164c77e80..24fadfb6a835 100644
--- a/extensions/googlechat/src/channel.test.ts
+++ b/extensions/googlechat/src/channel.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover channel plugin behavior.
 import { verifyChannelMessageAdapterCapabilityProofs } from "openclaw/plugin-sdk/channel-outbound";
 import {
   createDirectoryTestRuntime,
diff --git a/extensions/googlechat/src/channel.ts b/extensions/googlechat/src/channel.ts
index 7df2b7681089..853e24072af8 100644
--- a/extensions/googlechat/src/channel.ts
+++ b/extensions/googlechat/src/channel.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements channel behavior.
 import type { ChannelMessageActionName } from "openclaw/plugin-sdk/channel-contract";
 import { createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { buildPassiveProbedChannelStatusSummary } from "openclaw/plugin-sdk/extension-shared";
diff --git a/extensions/googlechat/src/config-schema.test.ts b/extensions/googlechat/src/config-schema.test.ts
index df21a46d2794..449ed75d3e4f 100644
--- a/extensions/googlechat/src/config-schema.test.ts
+++ b/extensions/googlechat/src/config-schema.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover config schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { GoogleChatConfigSchema } from "../runtime-api.js";
 
diff --git a/extensions/googlechat/src/config-schema.ts b/extensions/googlechat/src/config-schema.ts
index b7bf4ce0edac..34be734b44cb 100644
--- a/extensions/googlechat/src/config-schema.ts
+++ b/extensions/googlechat/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Googlechat helper module supports config schema behavior.
 import { buildChannelConfigSchema, GoogleChatConfigSchema } from "../config-api.js";
 
 export const GoogleChatChannelConfigSchema = buildChannelConfigSchema(GoogleChatConfigSchema);
diff --git a/extensions/googlechat/src/doctor-contract.test.ts b/extensions/googlechat/src/doctor-contract.test.ts
index b92ee34ddcc1..21d5224a5350 100644
--- a/extensions/googlechat/src/doctor-contract.test.ts
+++ b/extensions/googlechat/src/doctor-contract.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover doctor contract plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeCompatibilityConfig } from "./doctor-contract.js";
 
diff --git a/extensions/googlechat/src/doctor-contract.ts b/extensions/googlechat/src/doctor-contract.ts
index 9923f8f87da6..53068f63677b 100644
--- a/extensions/googlechat/src/doctor-contract.ts
+++ b/extensions/googlechat/src/doctor-contract.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements doctor contract behavior.
 import type {
   ChannelDoctorConfigMutation,
   ChannelDoctorLegacyConfigRule,
diff --git a/extensions/googlechat/src/doctor.ts b/extensions/googlechat/src/doctor.ts
index 6c8f34f8b552..62ed0a7018dd 100644
--- a/extensions/googlechat/src/doctor.ts
+++ b/extensions/googlechat/src/doctor.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements doctor behavior.
 import { createDangerousNameMatchingMutableAllowlistWarningCollector } from "openclaw/plugin-sdk/channel-policy";
 
 function asObjectRecord(value: unknown): Record<string, unknown> | null {
diff --git a/extensions/googlechat/src/gateway.ts b/extensions/googlechat/src/gateway.ts
index b3907810b24c..59ac482af7a2 100644
--- a/extensions/googlechat/src/gateway.ts
+++ b/extensions/googlechat/src/gateway.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements gateway behavior.
 import {
   createAccountStatusSink,
   runPassiveAccountLifecycle,
diff --git a/extensions/googlechat/src/google-auth.runtime.test.ts b/extensions/googlechat/src/google-auth.runtime.test.ts
index 110195c71dfc..48fb01d36e11 100644
--- a/extensions/googlechat/src/google-auth.runtime.test.ts
+++ b/extensions/googlechat/src/google-auth.runtime.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover google auth plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/googlechat/src/google-auth.runtime.ts b/extensions/googlechat/src/google-auth.runtime.ts
index fb9fc30c9987..3eb6dc3be709 100644
--- a/extensions/googlechat/src/google-auth.runtime.ts
+++ b/extensions/googlechat/src/google-auth.runtime.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements google auth behavior.
 import fs from "node:fs/promises";
 import type { ConnectionOptions } from "node:tls";
 import { parseMediaContentLength } from "openclaw/plugin-sdk/media-runtime";
diff --git a/extensions/googlechat/src/group-policy.ts b/extensions/googlechat/src/group-policy.ts
index cf4de7018cf7..646e979ff66c 100644
--- a/extensions/googlechat/src/group-policy.ts
+++ b/extensions/googlechat/src/group-policy.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements group policy behavior.
 import { resolveChannelGroupRequireMention } from "openclaw/plugin-sdk/channel-policy";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
 
diff --git a/extensions/googlechat/src/monitor-access.test.ts b/extensions/googlechat/src/monitor-access.test.ts
index 60d482977efb..5899a39fedeb 100644
--- a/extensions/googlechat/src/monitor-access.test.ts
+++ b/extensions/googlechat/src/monitor-access.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover monitor access plugin behavior.
 import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
 
 const createChannelPairingController = vi.hoisted(() => vi.fn());
diff --git a/extensions/googlechat/src/monitor-access.ts b/extensions/googlechat/src/monitor-access.ts
index edb886846d44..7291fd6840ce 100644
--- a/extensions/googlechat/src/monitor-access.ts
+++ b/extensions/googlechat/src/monitor-access.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements monitor access behavior.
 import {
   channelIngressRoutes,
   createChannelIngressResolver,
diff --git a/extensions/googlechat/src/monitor-durable.test.ts b/extensions/googlechat/src/monitor-durable.test.ts
index 62068658bfa6..0f06263bee7c 100644
--- a/extensions/googlechat/src/monitor-durable.test.ts
+++ b/extensions/googlechat/src/monitor-durable.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover monitor durable plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveGoogleChatDurableReplyOptions } from "./monitor-durable.js";
 
diff --git a/extensions/googlechat/src/monitor-durable.ts b/extensions/googlechat/src/monitor-durable.ts
index 12b4400fbffd..3e8fe582cf35 100644
--- a/extensions/googlechat/src/monitor-durable.ts
+++ b/extensions/googlechat/src/monitor-durable.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements monitor durable behavior.
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 
 export type GoogleChatDurableReplyOptions = {
diff --git a/extensions/googlechat/src/monitor-reply-delivery.ts b/extensions/googlechat/src/monitor-reply-delivery.ts
index 835fbb4dd07f..a5162c06aabd 100644
--- a/extensions/googlechat/src/monitor-reply-delivery.ts
+++ b/extensions/googlechat/src/monitor-reply-delivery.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements monitor reply delivery behavior.
 import {
   deliverTextOrMediaReply,
   resolveSendableOutboundReplyParts,
diff --git a/extensions/googlechat/src/monitor-routing.ts b/extensions/googlechat/src/monitor-routing.ts
index a4795e6c1b36..e25783abe965 100644
--- a/extensions/googlechat/src/monitor-routing.ts
+++ b/extensions/googlechat/src/monitor-routing.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements monitor routing behavior.
 import type { IncomingMessage, ServerResponse } from "node:http";
 import {
   createFixedWindowRateLimiter,
diff --git a/extensions/googlechat/src/monitor-types.ts b/extensions/googlechat/src/monitor-types.ts
index 4586ae035340..753f9a635f29 100644
--- a/extensions/googlechat/src/monitor-types.ts
+++ b/extensions/googlechat/src/monitor-types.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements monitor types behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
 import type { ResolvedGoogleChatAccount } from "./accounts.js";
 import type { GoogleChatAudienceType } from "./auth.js";
diff --git a/extensions/googlechat/src/monitor-webhook.test.ts b/extensions/googlechat/src/monitor-webhook.test.ts
index 5361c73b4661..2f8631afc2a4 100644
--- a/extensions/googlechat/src/monitor-webhook.test.ts
+++ b/extensions/googlechat/src/monitor-webhook.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover monitor webhook plugin behavior.
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { FixedWindowRateLimiter } from "openclaw/plugin-sdk/webhook-ingress";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/googlechat/src/monitor-webhook.ts b/extensions/googlechat/src/monitor-webhook.ts
index f48404445816..bcc97a2a943d 100644
--- a/extensions/googlechat/src/monitor-webhook.ts
+++ b/extensions/googlechat/src/monitor-webhook.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements monitor webhook behavior.
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import {
diff --git a/extensions/googlechat/src/monitor.reply-delivery.test.ts b/extensions/googlechat/src/monitor.reply-delivery.test.ts
index 0a7ac390f656..c085c96560ae 100644
--- a/extensions/googlechat/src/monitor.reply-delivery.test.ts
+++ b/extensions/googlechat/src/monitor.reply-delivery.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover monitor.reply delivery plugin behavior.
 import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../runtime-api.js";
 import type { ResolvedGoogleChatAccount } from "./accounts.js";
diff --git a/extensions/googlechat/src/monitor.test.ts b/extensions/googlechat/src/monitor.test.ts
index 2cc2a5d9639b..8e96b391d86f 100644
--- a/extensions/googlechat/src/monitor.test.ts
+++ b/extensions/googlechat/src/monitor.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover monitor plugin behavior.
 import { recordChannelBotPairLoopAndCheckSuppression } from "openclaw/plugin-sdk/channel-inbound";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { ResolvedGoogleChatAccount } from "./accounts.js";
diff --git a/extensions/googlechat/src/monitor.ts b/extensions/googlechat/src/monitor.ts
index 8741d268bf7c..40f1cd1260c5 100644
--- a/extensions/googlechat/src/monitor.ts
+++ b/extensions/googlechat/src/monitor.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements monitor behavior.
 import {
   recordChannelBotPairLoopAndCheckSuppression,
   type ChannelBotLoopProtectionFacts,
diff --git a/extensions/googlechat/src/monitor.webhook-routing.test.ts b/extensions/googlechat/src/monitor.webhook-routing.test.ts
index db5dc51b0e70..d7482fa509ce 100644
--- a/extensions/googlechat/src/monitor.webhook-routing.test.ts
+++ b/extensions/googlechat/src/monitor.webhook-routing.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover monitor.webhook routing plugin behavior.
 import { EventEmitter } from "node:events";
 import type { IncomingMessage } from "node:http";
 import {
diff --git a/extensions/googlechat/src/runtime.ts b/extensions/googlechat/src/runtime.ts
index 16c610108698..ef80578ab3fe 100644
--- a/extensions/googlechat/src/runtime.ts
+++ b/extensions/googlechat/src/runtime.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements runtime behavior.
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 import type { PluginRuntime } from "openclaw/plugin-sdk/runtime-store";
 
diff --git a/extensions/googlechat/src/secret-contract.test.ts b/extensions/googlechat/src/secret-contract.test.ts
index 2a039b05671d..259c4d4f71a9 100644
--- a/extensions/googlechat/src/secret-contract.test.ts
+++ b/extensions/googlechat/src/secret-contract.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover secret contract plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   applyResolvedAssignments,
diff --git a/extensions/googlechat/src/secret-contract.ts b/extensions/googlechat/src/secret-contract.ts
index e59f761c76ad..07fd84e545cf 100644
--- a/extensions/googlechat/src/secret-contract.ts
+++ b/extensions/googlechat/src/secret-contract.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements secret contract behavior.
 import {
   getChannelSurface,
   hasOwnProperty,
diff --git a/extensions/googlechat/src/setup-core.ts b/extensions/googlechat/src/setup-core.ts
index 4c82b3b18ab7..f3d5fac63dfe 100644
--- a/extensions/googlechat/src/setup-core.ts
+++ b/extensions/googlechat/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements setup core behavior.
 import {
   createPatchedAccountSetupAdapter,
   createSetupInputPresenceValidator,
diff --git a/extensions/googlechat/src/setup-surface.ts b/extensions/googlechat/src/setup-surface.ts
index 088942d16203..dd27da902bf9 100644
--- a/extensions/googlechat/src/setup-surface.ts
+++ b/extensions/googlechat/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements setup surface behavior.
 import {
   addWildcardAllowFrom,
   applySetupAccountConfigPatch,
diff --git a/extensions/googlechat/src/setup.test.ts b/extensions/googlechat/src/setup.test.ts
index b425628ca864..803674c9e8b6 100644
--- a/extensions/googlechat/src/setup.test.ts
+++ b/extensions/googlechat/src/setup.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover setup plugin behavior.
 import {
   expectLifecyclePatch,
   expectPendingUntilAbort,
diff --git a/extensions/googlechat/src/targets.test.ts b/extensions/googlechat/src/targets.test.ts
index e98e9e279c3e..074c5538beb9 100644
--- a/extensions/googlechat/src/targets.test.ts
+++ b/extensions/googlechat/src/targets.test.ts
@@ -1,3 +1,4 @@
+// Googlechat tests cover targets plugin behavior.
 import { afterAll, afterEach, describe, expect, it, vi } from "vitest";
 import type { ResolvedGoogleChatAccount } from "./accounts.js";
 import { downloadGoogleChatMedia, sendGoogleChatMessage } from "./api.js";
diff --git a/extensions/googlechat/src/targets.ts b/extensions/googlechat/src/targets.ts
index a40b2dc0da8c..7362afa9a34d 100644
--- a/extensions/googlechat/src/targets.ts
+++ b/extensions/googlechat/src/targets.ts
@@ -1,3 +1,4 @@
+// Googlechat plugin module implements targets behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { ResolvedGoogleChatAccount } from "./accounts.js";
 import { findGoogleChatDirectMessage } from "./api.js";
diff --git a/extensions/googlechat/src/types.config.ts b/extensions/googlechat/src/types.config.ts
index 1d9d7b72e0df..09de22fe554f 100644
--- a/extensions/googlechat/src/types.config.ts
+++ b/extensions/googlechat/src/types.config.ts
@@ -1,3 +1,4 @@
+// Googlechat helper module supports types behavior.
 import type { GoogleChatAccountConfig, GoogleChatConfig } from "../runtime-api.js";
 
 export type { GoogleChatAccountConfig, GoogleChatConfig };
diff --git a/extensions/googlechat/src/types.ts b/extensions/googlechat/src/types.ts
index 0478fa38c924..c656979ed6b8 100644
--- a/extensions/googlechat/src/types.ts
+++ b/extensions/googlechat/src/types.ts
@@ -1,3 +1,4 @@
+// Googlechat type declarations define plugin contracts.
 export type GoogleChatSpace = {
   name?: string;
   displayName?: string;
diff --git a/extensions/googlechat/test-api.ts b/extensions/googlechat/test-api.ts
index 7560ae57995b..168ec2b2813a 100644
--- a/extensions/googlechat/test-api.ts
+++ b/extensions/googlechat/test-api.ts
@@ -1,2 +1,3 @@
+// Googlechat API module exposes the plugin public contract.
 export { googlechatPlugin } from "./src/channel.js";
 export { setGoogleChatRuntime } from "./src/runtime.js";
diff --git a/extensions/irc/api.ts b/extensions/irc/api.ts
index 5404875213e8..09e3bffee510 100644
--- a/extensions/irc/api.ts
+++ b/extensions/irc/api.ts
@@ -1,3 +1,4 @@
+// Irc API module exposes the plugin public contract.
 export { ircPlugin } from "./src/channel.js";
 export { setIrcRuntime } from "./src/runtime.js";
 export {
diff --git a/extensions/irc/channel-config-api.ts b/extensions/irc/channel-config-api.ts
index b9ac0f26e51e..2910b557bede 100644
--- a/extensions/irc/channel-config-api.ts
+++ b/extensions/irc/channel-config-api.ts
@@ -1 +1,2 @@
+// Irc API module exposes the plugin public contract.
 export { IrcChannelConfigSchema } from "./src/config-schema.js";
diff --git a/extensions/irc/configured-state.ts b/extensions/irc/configured-state.ts
index 1a2091f783f6..2f2b1e00de3d 100644
--- a/extensions/irc/configured-state.ts
+++ b/extensions/irc/configured-state.ts
@@ -1,3 +1,4 @@
+// Irc helper module supports configured state behavior.
 export function hasIrcConfiguredState(params: { env?: NodeJS.ProcessEnv }): boolean {
   return (
     typeof params.env?.IRC_HOST === "string" &&
diff --git a/extensions/irc/contract-api.ts b/extensions/irc/contract-api.ts
index bc8f64f050fc..dfedb65b53a7 100644
--- a/extensions/irc/contract-api.ts
+++ b/extensions/irc/contract-api.ts
@@ -1,3 +1,4 @@
+// Irc API module exposes the plugin public contract.
 export {
   collectRuntimeConfigAssignments,
   secretTargetRegistryEntries,
diff --git a/extensions/irc/index.test.ts b/extensions/irc/index.test.ts
index a3ac2842f85f..f5625e0ad980 100644
--- a/extensions/irc/index.test.ts
+++ b/extensions/irc/index.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover index plugin behavior.
 import { assertBundledChannelEntries } from "openclaw/plugin-sdk/channel-test-helpers";
 import { describe } from "vitest";
 import entry from "./index.js";
diff --git a/extensions/irc/index.ts b/extensions/irc/index.ts
index 965af1664bad..abd933099d4d 100644
--- a/extensions/irc/index.ts
+++ b/extensions/irc/index.ts
@@ -1,3 +1,4 @@
+// Irc plugin entrypoint registers its OpenClaw integration.
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelEntry({
diff --git a/extensions/irc/runtime-api.test.ts b/extensions/irc/runtime-api.test.ts
index 71c7d000cc53..6f226ad55882 100644
--- a/extensions/irc/runtime-api.test.ts
+++ b/extensions/irc/runtime-api.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover runtime api plugin behavior.
 import { runDirectImportSmoke } from "openclaw/plugin-sdk/plugin-test-contracts";
 import { beforeAll, describe, expect, it } from "vitest";
 
diff --git a/extensions/irc/secret-contract-api.ts b/extensions/irc/secret-contract-api.ts
index 9f44ef28569c..79dc6ad7b42d 100644
--- a/extensions/irc/secret-contract-api.ts
+++ b/extensions/irc/secret-contract-api.ts
@@ -1,3 +1,4 @@
+// Irc API module exposes the plugin public contract.
 export {
   channelSecrets,
   collectRuntimeConfigAssignments,
diff --git a/extensions/irc/setup-entry.ts b/extensions/irc/setup-entry.ts
index 6f940a664e53..0947b0c770b1 100644
--- a/extensions/irc/setup-entry.ts
+++ b/extensions/irc/setup-entry.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/irc/src/accounts.test.ts b/extensions/irc/src/accounts.test.ts
index 4a61af8b0360..531554c6c368 100644
--- a/extensions/irc/src/accounts.test.ts
+++ b/extensions/irc/src/accounts.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover accounts plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/irc/src/accounts.ts b/extensions/irc/src/accounts.ts
index 9e3eec81557f..23df670bffe0 100644
--- a/extensions/irc/src/accounts.ts
+++ b/extensions/irc/src/accounts.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements accounts behavior.
 import { createAccountListHelpers } from "openclaw/plugin-sdk/account-helpers";
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { resolveMergedAccountConfig } from "openclaw/plugin-sdk/account-resolution";
diff --git a/extensions/irc/src/channel-api.ts b/extensions/irc/src/channel-api.ts
index 2dfba3516086..425d9c70719b 100644
--- a/extensions/irc/src/channel-api.ts
+++ b/extensions/irc/src/channel-api.ts
@@ -1,3 +1,4 @@
+// Irc API module exposes the plugin public contract.
 export { createAccountStatusSink } from "openclaw/plugin-sdk/channel-outbound";
 export { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 export type { ChannelPlugin } from "openclaw/plugin-sdk/channel-core";
diff --git a/extensions/irc/src/channel.test.ts b/extensions/irc/src/channel.test.ts
index 258eebe06728..113bc08854b0 100644
--- a/extensions/irc/src/channel.test.ts
+++ b/extensions/irc/src/channel.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover channel plugin behavior.
 import { afterEach, describe, expect, it } from "vitest";
 import { ircOutboundBaseAdapter } from "./outbound-base.js";
 import { clearIrcRuntime } from "./runtime.js";
diff --git a/extensions/irc/src/channel.ts b/extensions/irc/src/channel.ts
index f34d08a2ba35..8cc74cc82a5c 100644
--- a/extensions/irc/src/channel.ts
+++ b/extensions/irc/src/channel.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements channel behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { formatNormalizedAllowFromEntries } from "openclaw/plugin-sdk/allow-from";
 import {
diff --git a/extensions/irc/src/client.test.ts b/extensions/irc/src/client.test.ts
index 06e63093dc39..153c9abda1f9 100644
--- a/extensions/irc/src/client.test.ts
+++ b/extensions/irc/src/client.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover client plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildIrcNickServCommands } from "./client.js";
 
diff --git a/extensions/irc/src/client.ts b/extensions/irc/src/client.ts
index 309ca9c69ce6..dddb6745c165 100644
--- a/extensions/irc/src/client.ts
+++ b/extensions/irc/src/client.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements client behavior.
 import net from "node:net";
 import tls from "node:tls";
 import { withTimeout } from "openclaw/plugin-sdk/security-runtime";
diff --git a/extensions/irc/src/config-schema.test.ts b/extensions/irc/src/config-schema.test.ts
index cb076e2855d0..64889a39f0e7 100644
--- a/extensions/irc/src/config-schema.test.ts
+++ b/extensions/irc/src/config-schema.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover config schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { IrcConfigSchema } from "./config-schema.js";
 
diff --git a/extensions/irc/src/config-schema.ts b/extensions/irc/src/config-schema.ts
index ae9ae4261c7e..1c0ac77c55a2 100644
--- a/extensions/irc/src/config-schema.ts
+++ b/extensions/irc/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Irc helper module supports config schema behavior.
 import {
   DmPolicySchema,
   GroupPolicySchema,
diff --git a/extensions/irc/src/config-ui-hints.ts b/extensions/irc/src/config-ui-hints.ts
index e65d87f08780..bb10740b160e 100644
--- a/extensions/irc/src/config-ui-hints.ts
+++ b/extensions/irc/src/config-ui-hints.ts
@@ -1,3 +1,4 @@
+// Irc helper module supports config ui hints behavior.
 import type { ChannelConfigUiHint } from "openclaw/plugin-sdk/core";
 
 export const ircChannelConfigUiHints = {
diff --git a/extensions/irc/src/connect-options.test.ts b/extensions/irc/src/connect-options.test.ts
index f991ea0ca30c..b03c1a917886 100644
--- a/extensions/irc/src/connect-options.test.ts
+++ b/extensions/irc/src/connect-options.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover connect options plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildIrcConnectOptions } from "./connect-options.js";
 
diff --git a/extensions/irc/src/connect-options.ts b/extensions/irc/src/connect-options.ts
index 45d06bf0b6e3..9f3043721def 100644
--- a/extensions/irc/src/connect-options.ts
+++ b/extensions/irc/src/connect-options.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements connect options behavior.
 import type { ResolvedIrcAccount } from "./accounts.js";
 import type { IrcClientOptions } from "./client.js";
 
diff --git a/extensions/irc/src/control-chars.test.ts b/extensions/irc/src/control-chars.test.ts
index e8c5a506289f..15f9f7414e75 100644
--- a/extensions/irc/src/control-chars.test.ts
+++ b/extensions/irc/src/control-chars.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover control chars plugin behavior.
 import { describe, expect, it } from "vitest";
 import { hasIrcControlChars, isIrcControlChar, stripIrcControlChars } from "./control-chars.js";
 
diff --git a/extensions/irc/src/control-chars.ts b/extensions/irc/src/control-chars.ts
index 8b349ba1cd00..6ec0b68c6551 100644
--- a/extensions/irc/src/control-chars.ts
+++ b/extensions/irc/src/control-chars.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements control chars behavior.
 export function isIrcControlChar(charCode: number): boolean {
   return charCode <= 0x1f || charCode === 0x7f;
 }
diff --git a/extensions/irc/src/doctor.ts b/extensions/irc/src/doctor.ts
index 28dd0c0b34f6..98752032142b 100644
--- a/extensions/irc/src/doctor.ts
+++ b/extensions/irc/src/doctor.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements doctor behavior.
 import { createDangerousNameMatchingMutableAllowlistWarningCollector } from "openclaw/plugin-sdk/channel-policy";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 
diff --git a/extensions/irc/src/gateway.ts b/extensions/irc/src/gateway.ts
index 82ac300dd8e6..6004c3bd30f9 100644
--- a/extensions/irc/src/gateway.ts
+++ b/extensions/irc/src/gateway.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements gateway behavior.
 import { runStoppablePassiveMonitor } from "openclaw/plugin-sdk/extension-shared";
 import type { ChannelAccountSnapshot } from "openclaw/plugin-sdk/status-helpers";
 import type { ResolvedIrcAccount } from "./accounts.js";
diff --git a/extensions/irc/src/inbound.behavior.test.ts b/extensions/irc/src/inbound.behavior.test.ts
index fcf71c1f71a8..b1b945fb384d 100644
--- a/extensions/irc/src/inbound.behavior.test.ts
+++ b/extensions/irc/src/inbound.behavior.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover inbound.behavior plugin behavior.
 import { createPluginRuntimeMock } from "openclaw/plugin-sdk/channel-test-helpers";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { ResolvedIrcAccount } from "./accounts.js";
diff --git a/extensions/irc/src/inbound.ts b/extensions/irc/src/inbound.ts
index a51dd4d72055..182f5b29d861 100644
--- a/extensions/irc/src/inbound.ts
+++ b/extensions/irc/src/inbound.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements inbound behavior.
 import { logInboundDrop } from "openclaw/plugin-sdk/channel-inbound";
 import {
   channelIngressRoutes,
diff --git a/extensions/irc/src/message-adapter.ts b/extensions/irc/src/message-adapter.ts
index 293d4e6cf594..9f35185fb25a 100644
--- a/extensions/irc/src/message-adapter.ts
+++ b/extensions/irc/src/message-adapter.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements message adapter behavior.
 import { defineChannelMessageAdapter } from "openclaw/plugin-sdk/channel-outbound";
 import { sendMessageIrc } from "./send.js";
 import type { CoreConfig } from "./types.js";
diff --git a/extensions/irc/src/monitor.test.ts b/extensions/irc/src/monitor.test.ts
index b8af37265e77..833255b65c33 100644
--- a/extensions/irc/src/monitor.test.ts
+++ b/extensions/irc/src/monitor.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover monitor plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveIrcInboundTarget } from "./monitor.js";
 
diff --git a/extensions/irc/src/monitor.ts b/extensions/irc/src/monitor.ts
index 1692344242a3..0be083b4fe44 100644
--- a/extensions/irc/src/monitor.ts
+++ b/extensions/irc/src/monitor.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements monitor behavior.
 import { resolveLoggerBackedRuntime } from "openclaw/plugin-sdk/extension-shared";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { resolveIrcAccount } from "./accounts.js";
diff --git a/extensions/irc/src/normalize.test.ts b/extensions/irc/src/normalize.test.ts
index 428f0015fd2e..c437fe7b4e21 100644
--- a/extensions/irc/src/normalize.test.ts
+++ b/extensions/irc/src/normalize.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover normalize plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildIrcAllowlistCandidates,
diff --git a/extensions/irc/src/normalize.ts b/extensions/irc/src/normalize.ts
index 483875e1ef2f..780bd907127f 100644
--- a/extensions/irc/src/normalize.ts
+++ b/extensions/irc/src/normalize.ts
@@ -1,3 +1,4 @@
+// Irc helper module supports normalize behavior.
 import {
   normalizeLowercaseStringOrEmpty,
   normalizeOptionalLowercaseString,
diff --git a/extensions/irc/src/outbound-base.ts b/extensions/irc/src/outbound-base.ts
index 34007aa558a5..e69902597759 100644
--- a/extensions/irc/src/outbound-base.ts
+++ b/extensions/irc/src/outbound-base.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements outbound base behavior.
 import { sanitizeForPlainText } from "openclaw/plugin-sdk/channel-outbound";
 import { chunkTextForOutbound } from "./channel-api.js";
 
diff --git a/extensions/irc/src/policy.test.ts b/extensions/irc/src/policy.test.ts
index dc2bfc34be00..a6336a588c2b 100644
--- a/extensions/irc/src/policy.test.ts
+++ b/extensions/irc/src/policy.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover policy plugin behavior.
 import { resolveChannelGroupPolicy } from "openclaw/plugin-sdk/channel-policy";
 import { describe, expect, it } from "vitest";
 import { resolveIrcGroupMatch, resolveIrcRequireMention } from "./policy.js";
diff --git a/extensions/irc/src/policy.ts b/extensions/irc/src/policy.ts
index 4abfadefe969..0e8d2a0e1ffd 100644
--- a/extensions/irc/src/policy.ts
+++ b/extensions/irc/src/policy.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements policy behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { IrcChannelConfig } from "./types.js";
 
diff --git a/extensions/irc/src/probe.test.ts b/extensions/irc/src/probe.test.ts
index c395da45e808..1a848a8c1051 100644
--- a/extensions/irc/src/probe.test.ts
+++ b/extensions/irc/src/probe.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover probe plugin behavior.
 import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { probeIrc } from "./probe.js";
 
diff --git a/extensions/irc/src/probe.ts b/extensions/irc/src/probe.ts
index e18dee1f84b5..056630c526a7 100644
--- a/extensions/irc/src/probe.ts
+++ b/extensions/irc/src/probe.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements probe behavior.
 import { resolveIrcAccount } from "./accounts.js";
 import { connectIrcClient } from "./client.js";
 import { buildIrcConnectOptions } from "./connect-options.js";
diff --git a/extensions/irc/src/protocol.test.ts b/extensions/irc/src/protocol.test.ts
index 48bc230b35cb..c266ed20cd7f 100644
--- a/extensions/irc/src/protocol.test.ts
+++ b/extensions/irc/src/protocol.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover protocol plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   parseIrcLine,
diff --git a/extensions/irc/src/protocol.ts b/extensions/irc/src/protocol.ts
index ea989d76f1ed..655e7c2a6842 100644
--- a/extensions/irc/src/protocol.ts
+++ b/extensions/irc/src/protocol.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements protocol behavior.
 import { randomUUID } from "node:crypto";
 import { hasIrcControlChars, stripIrcControlChars } from "./control-chars.js";
 
diff --git a/extensions/irc/src/runtime.ts b/extensions/irc/src/runtime.ts
index 87ea65365c3b..18063d3605bb 100644
--- a/extensions/irc/src/runtime.ts
+++ b/extensions/irc/src/runtime.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements runtime behavior.
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 import type { PluginRuntime } from "./runtime-api.js";
 
diff --git a/extensions/irc/src/secret-contract.ts b/extensions/irc/src/secret-contract.ts
index 80e1edf0386b..63af9223fdfc 100644
--- a/extensions/irc/src/secret-contract.ts
+++ b/extensions/irc/src/secret-contract.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements secret contract behavior.
 import {
   collectNestedChannelFieldAssignments,
   collectSimpleChannelFieldAssignments,
diff --git a/extensions/irc/src/send.test.ts b/extensions/irc/src/send.test.ts
index 3f7ce6c7b464..6e1932dcdc8c 100644
--- a/extensions/irc/src/send.test.ts
+++ b/extensions/irc/src/send.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover send plugin behavior.
 import { verifyChannelMessageAdapterCapabilityProofs } from "openclaw/plugin-sdk/channel-outbound";
 import { createSendCfgThreadingRuntime } from "openclaw/plugin-sdk/channel-test-helpers";
 import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/irc/src/send.ts b/extensions/irc/src/send.ts
index 9b71061b2b52..2776c6d0be05 100644
--- a/extensions/irc/src/send.ts
+++ b/extensions/irc/src/send.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements send behavior.
 import {
   createMessageReceiptFromOutboundResults,
   type MessageReceipt,
diff --git a/extensions/irc/src/setup-core.ts b/extensions/irc/src/setup-core.ts
index d0539a63b951..1d32fab61ebb 100644
--- a/extensions/irc/src/setup-core.ts
+++ b/extensions/irc/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements setup core behavior.
 import type { ChannelSetupAdapter, ChannelSetupInput } from "openclaw/plugin-sdk/channel-setup";
 import type { DmPolicy } from "openclaw/plugin-sdk/config-contracts";
 import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
diff --git a/extensions/irc/src/setup-surface.ts b/extensions/irc/src/setup-surface.ts
index 3af2eae45b04..077420cf3132 100644
--- a/extensions/irc/src/setup-surface.ts
+++ b/extensions/irc/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Irc plugin module implements setup surface behavior.
 import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/routing";
 import type {
diff --git a/extensions/irc/src/setup.test.ts b/extensions/irc/src/setup.test.ts
index 3e5cdf17ae1f..2a666994df92 100644
--- a/extensions/irc/src/setup.test.ts
+++ b/extensions/irc/src/setup.test.ts
@@ -1,3 +1,4 @@
+// Irc tests cover setup plugin behavior.
 import {
   expectStopPendingUntilAbort,
   startAccountAndTrackLifecycle,
diff --git a/extensions/irc/src/types.ts b/extensions/irc/src/types.ts
index a3373aabdec6..96eb7b8b5006 100644
--- a/extensions/irc/src/types.ts
+++ b/extensions/irc/src/types.ts
@@ -1,3 +1,4 @@
+// Irc type declarations define plugin contracts.
 import type {
   BlockStreamingCoalesceConfig,
   DmConfig,
diff --git a/extensions/memory-wiki/api.ts b/extensions/memory-wiki/api.ts
index 189e8107003a..c512f384fc07 100644
--- a/extensions/memory-wiki/api.ts
+++ b/extensions/memory-wiki/api.ts
@@ -1,3 +1,4 @@
+// Memory Wiki API module exposes the plugin public contract.
 export {
   buildPluginConfigSchema,
   definePluginEntry,
diff --git a/extensions/memory-wiki/cli-metadata.test.ts b/extensions/memory-wiki/cli-metadata.test.ts
index f5d010334d6c..15d02f5df92e 100644
--- a/extensions/memory-wiki/cli-metadata.test.ts
+++ b/extensions/memory-wiki/cli-metadata.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover cli metadata plugin behavior.
 import { Command } from "commander";
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
 import { beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/memory-wiki/cli-metadata.ts b/extensions/memory-wiki/cli-metadata.ts
index 27ac67e2f330..518ad6d500a9 100644
--- a/extensions/memory-wiki/cli-metadata.ts
+++ b/extensions/memory-wiki/cli-metadata.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements cli metadata behavior.
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 
 export default definePluginEntry({
diff --git a/extensions/memory-wiki/contract-api.ts b/extensions/memory-wiki/contract-api.ts
index db610ee157d7..ca7dd33e08e7 100644
--- a/extensions/memory-wiki/contract-api.ts
+++ b/extensions/memory-wiki/contract-api.ts
@@ -1 +1,2 @@
+// Memory Wiki API module exposes the plugin public contract.
 export { legacyConfigRules, normalizeCompatibilityConfig } from "./src/config-compat.js";
diff --git a/extensions/memory-wiki/doctor-contract-api.ts b/extensions/memory-wiki/doctor-contract-api.ts
index db610ee157d7..ca7dd33e08e7 100644
--- a/extensions/memory-wiki/doctor-contract-api.ts
+++ b/extensions/memory-wiki/doctor-contract-api.ts
@@ -1 +1,2 @@
+// Memory Wiki API module exposes the plugin public contract.
 export { legacyConfigRules, normalizeCompatibilityConfig } from "./src/config-compat.js";
diff --git a/extensions/memory-wiki/index.test.ts b/extensions/memory-wiki/index.test.ts
index c8d54d935879..b3a892a774cb 100644
--- a/extensions/memory-wiki/index.test.ts
+++ b/extensions/memory-wiki/index.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover index plugin behavior.
 import { describe, expect, it } from "vitest";
 import plugin from "./index.js";
 import { createMemoryWikiTestHarness } from "./src/test-helpers.js";
diff --git a/extensions/memory-wiki/index.ts b/extensions/memory-wiki/index.ts
index ed1cb7bbe8e8..ac01329fe38a 100644
--- a/extensions/memory-wiki/index.ts
+++ b/extensions/memory-wiki/index.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin entrypoint registers its OpenClaw integration.
 import { definePluginEntry } from "./api.js";
 import { registerWikiCli } from "./src/cli.js";
 import { memoryWikiConfigSchema, resolveMemoryWikiConfig } from "./src/config.js";
diff --git a/extensions/memory-wiki/setup-api.ts b/extensions/memory-wiki/setup-api.ts
index 29c2839eef78..42ff79cf79e1 100644
--- a/extensions/memory-wiki/setup-api.ts
+++ b/extensions/memory-wiki/setup-api.ts
@@ -1,3 +1,4 @@
+// Memory Wiki API module exposes the plugin public contract.
 import { definePluginEntry } from "./api.js";
 import { migrateMemoryWikiLegacyConfig } from "./src/config-compat.js";
 
diff --git a/extensions/memory-wiki/src/apply.test.ts b/extensions/memory-wiki/src/apply.test.ts
index a8289211e9ee..d8495d4f3855 100644
--- a/extensions/memory-wiki/src/apply.test.ts
+++ b/extensions/memory-wiki/src/apply.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover apply plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/memory-wiki/src/apply.ts b/extensions/memory-wiki/src/apply.ts
index 03db73493e99..a4d5c094f416 100644
--- a/extensions/memory-wiki/src/apply.ts
+++ b/extensions/memory-wiki/src/apply.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements apply behavior.
 import path from "node:path";
 import {
   replaceManagedMarkdownBlock,
diff --git a/extensions/memory-wiki/src/bridge.test.ts b/extensions/memory-wiki/src/bridge.test.ts
index d6d7b17d0804..eedc3f789b70 100644
--- a/extensions/memory-wiki/src/bridge.test.ts
+++ b/extensions/memory-wiki/src/bridge.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover bridge plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-wiki/src/bridge.ts b/extensions/memory-wiki/src/bridge.ts
index 4e0062083b3f..8ed5de3e0c60 100644
--- a/extensions/memory-wiki/src/bridge.ts
+++ b/extensions/memory-wiki/src/bridge.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements bridge behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/memory-wiki/src/chatgpt-import.ts b/extensions/memory-wiki/src/chatgpt-import.ts
index a097fb841649..283588f0960c 100644
--- a/extensions/memory-wiki/src/chatgpt-import.ts
+++ b/extensions/memory-wiki/src/chatgpt-import.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements chatgpt import behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/memory-wiki/src/claim-health.test.ts b/extensions/memory-wiki/src/claim-health.test.ts
index 0442849dde21..d58091453459 100644
--- a/extensions/memory-wiki/src/claim-health.test.ts
+++ b/extensions/memory-wiki/src/claim-health.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover claim health plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildPageContradictionClusters } from "./claim-health.js";
 import type { WikiPageSummary } from "./markdown.js";
diff --git a/extensions/memory-wiki/src/claim-health.ts b/extensions/memory-wiki/src/claim-health.ts
index 05945cb1376c..7be5cb7662f2 100644
--- a/extensions/memory-wiki/src/claim-health.ts
+++ b/extensions/memory-wiki/src/claim-health.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements claim health behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { WikiClaim, WikiPageSummary } from "./markdown.js";
 
diff --git a/extensions/memory-wiki/src/cli.test.ts b/extensions/memory-wiki/src/cli.test.ts
index 8f2a5588df2a..1517339ca551 100644
--- a/extensions/memory-wiki/src/cli.test.ts
+++ b/extensions/memory-wiki/src/cli.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover cli plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-wiki/src/cli.ts b/extensions/memory-wiki/src/cli.ts
index 8d5722ef21a2..c4e8d819d2af 100644
--- a/extensions/memory-wiki/src/cli.ts
+++ b/extensions/memory-wiki/src/cli.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements cli behavior.
 import fs from "node:fs/promises";
 import type { Command } from "commander";
 import { callGatewayFromCli } from "openclaw/plugin-sdk/gateway-runtime";
diff --git a/extensions/memory-wiki/src/compile.test.ts b/extensions/memory-wiki/src/compile.test.ts
index c6a0c74924c4..6217ebd299e5 100644
--- a/extensions/memory-wiki/src/compile.test.ts
+++ b/extensions/memory-wiki/src/compile.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover compile plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-wiki/src/compile.ts b/extensions/memory-wiki/src/compile.ts
index 78a5c6512a6d..be79ab4b4d19 100644
--- a/extensions/memory-wiki/src/compile.ts
+++ b/extensions/memory-wiki/src/compile.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements compile behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { runTasksWithConcurrency } from "openclaw/plugin-sdk/concurrency-runtime";
diff --git a/extensions/memory-wiki/src/config-compat.test.ts b/extensions/memory-wiki/src/config-compat.test.ts
index f2309659ea60..f84292c74501 100644
--- a/extensions/memory-wiki/src/config-compat.test.ts
+++ b/extensions/memory-wiki/src/config-compat.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover config compat plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../api.js";
 import {
diff --git a/extensions/memory-wiki/src/config-compat.ts b/extensions/memory-wiki/src/config-compat.ts
index 46806bd4ed95..590c5e3d52ef 100644
--- a/extensions/memory-wiki/src/config-compat.ts
+++ b/extensions/memory-wiki/src/config-compat.ts
@@ -1,3 +1,4 @@
+// Memory Wiki helper module supports config compat behavior.
 import type { OpenClawConfig } from "../api.js";
 
 type LegacyConfigRule = {
diff --git a/extensions/memory-wiki/src/config.test.ts b/extensions/memory-wiki/src/config.test.ts
index cfb6b5f25c06..06872e6607ef 100644
--- a/extensions/memory-wiki/src/config.test.ts
+++ b/extensions/memory-wiki/src/config.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover config plugin behavior.
 import fs from "node:fs";
 import path from "node:path";
 import {
diff --git a/extensions/memory-wiki/src/config.ts b/extensions/memory-wiki/src/config.ts
index 3d5caf5ee0f4..20e34873db2c 100644
--- a/extensions/memory-wiki/src/config.ts
+++ b/extensions/memory-wiki/src/config.ts
@@ -1,3 +1,4 @@
+// Memory Wiki helper module supports config behavior.
 import os from "node:os";
 import path from "node:path";
 import { mapPluginConfigIssues } from "openclaw/plugin-sdk/extension-shared";
diff --git a/extensions/memory-wiki/src/corpus-supplement.ts b/extensions/memory-wiki/src/corpus-supplement.ts
index bb84e9c2d027..eeade4ffc4ac 100644
--- a/extensions/memory-wiki/src/corpus-supplement.ts
+++ b/extensions/memory-wiki/src/corpus-supplement.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements corpus supplement behavior.
 import type { OpenClawConfig } from "../api.js";
 import type { ResolvedMemoryWikiConfig } from "./config.js";
 import { getMemoryWikiPage, searchMemoryWiki } from "./query.js";
diff --git a/extensions/memory-wiki/src/gateway.test.ts b/extensions/memory-wiki/src/gateway.test.ts
index 332d8211fd32..55753a1a7f31 100644
--- a/extensions/memory-wiki/src/gateway.test.ts
+++ b/extensions/memory-wiki/src/gateway.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover gateway plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
   applyMemoryWikiMutation,
diff --git a/extensions/memory-wiki/src/gateway.ts b/extensions/memory-wiki/src/gateway.ts
index 1f28877c873e..afec885d5010 100644
--- a/extensions/memory-wiki/src/gateway.ts
+++ b/extensions/memory-wiki/src/gateway.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements gateway behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { resolveDefaultAgentId } from "openclaw/plugin-sdk/memory-host-core";
 import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers";
diff --git a/extensions/memory-wiki/src/import-insights.test.ts b/extensions/memory-wiki/src/import-insights.test.ts
index 83e777c1f24f..fba91a567cc1 100644
--- a/extensions/memory-wiki/src/import-insights.test.ts
+++ b/extensions/memory-wiki/src/import-insights.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover import insights plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/memory-wiki/src/import-insights.ts b/extensions/memory-wiki/src/import-insights.ts
index b5d028fb3934..bf60964032fb 100644
--- a/extensions/memory-wiki/src/import-insights.ts
+++ b/extensions/memory-wiki/src/import-insights.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements import insights behavior.
 import type { ResolvedMemoryWikiConfig } from "./config.js";
 import { parseWikiMarkdown } from "./markdown.js";
 import { readQueryableWikiPages } from "./query.js";
diff --git a/extensions/memory-wiki/src/import-runs.ts b/extensions/memory-wiki/src/import-runs.ts
index c0ea87587827..e9b8d8ef273e 100644
--- a/extensions/memory-wiki/src/import-runs.ts
+++ b/extensions/memory-wiki/src/import-runs.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements import runs behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/memory-wiki/src/ingest.test.ts b/extensions/memory-wiki/src/ingest.test.ts
index 7f5045704b92..40a68de75948 100644
--- a/extensions/memory-wiki/src/ingest.test.ts
+++ b/extensions/memory-wiki/src/ingest.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover ingest plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/memory-wiki/src/ingest.ts b/extensions/memory-wiki/src/ingest.ts
index 041a060d9ee0..c8a0da9879be 100644
--- a/extensions/memory-wiki/src/ingest.ts
+++ b/extensions/memory-wiki/src/ingest.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements ingest behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { pathExists } from "openclaw/plugin-sdk/security-runtime";
diff --git a/extensions/memory-wiki/src/lint.test.ts b/extensions/memory-wiki/src/lint.test.ts
index efc4b72c97b9..e0368cc53457 100644
--- a/extensions/memory-wiki/src/lint.test.ts
+++ b/extensions/memory-wiki/src/lint.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover lint plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/memory-wiki/src/lint.ts b/extensions/memory-wiki/src/lint.ts
index 2361362000c9..ac9a8ea48900 100644
--- a/extensions/memory-wiki/src/lint.ts
+++ b/extensions/memory-wiki/src/lint.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements lint behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import {
diff --git a/extensions/memory-wiki/src/log.ts b/extensions/memory-wiki/src/log.ts
index 86e388dc6c1a..837ce247ac24 100644
--- a/extensions/memory-wiki/src/log.ts
+++ b/extensions/memory-wiki/src/log.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements log behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { appendRegularFile } from "openclaw/plugin-sdk/security-runtime";
diff --git a/extensions/memory-wiki/src/markdown.test.ts b/extensions/memory-wiki/src/markdown.test.ts
index d75fb4c97896..9152418587f0 100644
--- a/extensions/memory-wiki/src/markdown.test.ts
+++ b/extensions/memory-wiki/src/markdown.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover markdown plugin behavior.
 import { createHash } from "node:crypto";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/memory-wiki/src/markdown.ts b/extensions/memory-wiki/src/markdown.ts
index 5de3dc716d47..60fd81781750 100644
--- a/extensions/memory-wiki/src/markdown.ts
+++ b/extensions/memory-wiki/src/markdown.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements markdown behavior.
 import { createHash } from "node:crypto";
 import path from "node:path";
 import {
diff --git a/extensions/memory-wiki/src/memory-palace.test.ts b/extensions/memory-wiki/src/memory-palace.test.ts
index 4156e622a653..263082d98bc6 100644
--- a/extensions/memory-wiki/src/memory-palace.test.ts
+++ b/extensions/memory-wiki/src/memory-palace.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover memory palace plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/memory-wiki/src/memory-palace.ts b/extensions/memory-wiki/src/memory-palace.ts
index a6d02f95dffd..ddbe996f4964 100644
--- a/extensions/memory-wiki/src/memory-palace.ts
+++ b/extensions/memory-wiki/src/memory-palace.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements memory palace behavior.
 import type { ResolvedMemoryWikiConfig } from "./config.js";
 import { parseWikiMarkdown, type WikiPageKind } from "./markdown.js";
 import { readQueryableWikiPages } from "./query.js";
diff --git a/extensions/memory-wiki/src/obsidian.test.ts b/extensions/memory-wiki/src/obsidian.test.ts
index 588ef0f95c1e..a059e8fc40ab 100644
--- a/extensions/memory-wiki/src/obsidian.test.ts
+++ b/extensions/memory-wiki/src/obsidian.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover obsidian plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveMemoryWikiConfig } from "./config.js";
 import { runObsidianDaily, runObsidianSearch } from "./obsidian.js";
diff --git a/extensions/memory-wiki/src/obsidian.ts b/extensions/memory-wiki/src/obsidian.ts
index 6660997630a5..33db9c7942f7 100644
--- a/extensions/memory-wiki/src/obsidian.ts
+++ b/extensions/memory-wiki/src/obsidian.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements obsidian behavior.
 import { execFile } from "node:child_process";
 import { constants as fsConstants } from "node:fs";
 import fs from "node:fs/promises";
diff --git a/extensions/memory-wiki/src/prompt-section.test.ts b/extensions/memory-wiki/src/prompt-section.test.ts
index 51ffd181e57e..2176da898e67 100644
--- a/extensions/memory-wiki/src/prompt-section.test.ts
+++ b/extensions/memory-wiki/src/prompt-section.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover prompt section plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-wiki/src/prompt-section.ts b/extensions/memory-wiki/src/prompt-section.ts
index c4c4b22f1681..f49bbc4d3099 100644
--- a/extensions/memory-wiki/src/prompt-section.ts
+++ b/extensions/memory-wiki/src/prompt-section.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements prompt section behavior.
 import fs from "node:fs";
 import path from "node:path";
 import type { MemoryPromptSectionBuilder } from "openclaw/plugin-sdk/memory-host-core";
diff --git a/extensions/memory-wiki/src/query.test.ts b/extensions/memory-wiki/src/query.test.ts
index 5701864a0ad9..99f3f9aa19fc 100644
--- a/extensions/memory-wiki/src/query.test.ts
+++ b/extensions/memory-wiki/src/query.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover query plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-wiki/src/query.ts b/extensions/memory-wiki/src/query.ts
index bfee0770a2d1..8a06321efd9e 100644
--- a/extensions/memory-wiki/src/query.ts
+++ b/extensions/memory-wiki/src/query.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements query behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import type { MemorySearchResult } from "openclaw/plugin-sdk/memory-core-host-runtime-files";
diff --git a/extensions/memory-wiki/src/source-page-shared.test.ts b/extensions/memory-wiki/src/source-page-shared.test.ts
index ab07109c4930..f9a3832c3783 100644
--- a/extensions/memory-wiki/src/source-page-shared.test.ts
+++ b/extensions/memory-wiki/src/source-page-shared.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover source page shared plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-wiki/src/source-page-shared.ts b/extensions/memory-wiki/src/source-page-shared.ts
index 4a1c28546fe8..ac9872993a12 100644
--- a/extensions/memory-wiki/src/source-page-shared.ts
+++ b/extensions/memory-wiki/src/source-page-shared.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements source page shared behavior.
 import fs from "node:fs/promises";
 import { timestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
 import { FsSafeError, root as fsRoot } from "openclaw/plugin-sdk/security-runtime";
diff --git a/extensions/memory-wiki/src/source-path-shared.ts b/extensions/memory-wiki/src/source-path-shared.ts
index a97fc229682f..a819baa27a17 100644
--- a/extensions/memory-wiki/src/source-path-shared.ts
+++ b/extensions/memory-wiki/src/source-path-shared.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements source path shared behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { lowercasePreservingWhitespace } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/memory-wiki/src/source-sync-state.ts b/extensions/memory-wiki/src/source-sync-state.ts
index db7fe6b2b4e7..1dde9e536033 100644
--- a/extensions/memory-wiki/src/source-sync-state.ts
+++ b/extensions/memory-wiki/src/source-sync-state.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements source sync state behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { readJsonFileWithFallback, writeJsonFileAtomically } from "openclaw/plugin-sdk/json-store";
diff --git a/extensions/memory-wiki/src/source-sync.test.ts b/extensions/memory-wiki/src/source-sync.test.ts
index 42ab08fbbfb0..7cf4ea178026 100644
--- a/extensions/memory-wiki/src/source-sync.test.ts
+++ b/extensions/memory-wiki/src/source-sync.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover source sync plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { syncMemoryWikiImportedSources } from "./source-sync.js";
 
diff --git a/extensions/memory-wiki/src/source-sync.ts b/extensions/memory-wiki/src/source-sync.ts
index 41bd1d18d9d5..1aad6b9fd442 100644
--- a/extensions/memory-wiki/src/source-sync.ts
+++ b/extensions/memory-wiki/src/source-sync.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements source sync behavior.
 import type { OpenClawConfig } from "../api.js";
 import { syncMemoryWikiBridgeSources, type BridgeMemoryWikiResult } from "./bridge.js";
 import {
diff --git a/extensions/memory-wiki/src/status.test.ts b/extensions/memory-wiki/src/status.test.ts
index f0e58f48516f..2fd7cfc887ee 100644
--- a/extensions/memory-wiki/src/status.test.ts
+++ b/extensions/memory-wiki/src/status.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover status plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/memory-wiki/src/status.ts b/extensions/memory-wiki/src/status.ts
index 8454c94dcaa8..ab2b7f89b6d9 100644
--- a/extensions/memory-wiki/src/status.ts
+++ b/extensions/memory-wiki/src/status.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements status behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { listActiveMemoryPublicArtifacts } from "openclaw/plugin-sdk/memory-host-core";
diff --git a/extensions/memory-wiki/src/test-helpers.ts b/extensions/memory-wiki/src/test-helpers.ts
index d3a311be190e..091a685c3091 100644
--- a/extensions/memory-wiki/src/test-helpers.ts
+++ b/extensions/memory-wiki/src/test-helpers.ts
@@ -1,3 +1,4 @@
+// Memory Wiki helper module supports test helpers behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
diff --git a/extensions/memory-wiki/src/time.test.ts b/extensions/memory-wiki/src/time.test.ts
index 887688df9336..373aaca94b50 100644
--- a/extensions/memory-wiki/src/time.test.ts
+++ b/extensions/memory-wiki/src/time.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover time plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { resolveMemoryWikiTimestamp } from "./time.js";
 
diff --git a/extensions/memory-wiki/src/time.ts b/extensions/memory-wiki/src/time.ts
index 96cc2fd5192b..5084394f1056 100644
--- a/extensions/memory-wiki/src/time.ts
+++ b/extensions/memory-wiki/src/time.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements time behavior.
 import { timestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
 
 export function resolveMemoryWikiTimestamp(nowMs?: number): string {
diff --git a/extensions/memory-wiki/src/tool.test.ts b/extensions/memory-wiki/src/tool.test.ts
index 1236455e49d4..cd89e8b9619e 100644
--- a/extensions/memory-wiki/src/tool.test.ts
+++ b/extensions/memory-wiki/src/tool.test.ts
@@ -1,10 +1,11 @@
+// Memory Wiki tests cover tool plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
 import type { ResolvedMemoryWikiConfig } from "./config.js";
-import { createWikiApplyTool, createWikiLintTool } from "./tool.js";
 import { lintMemoryWikiVault } from "./lint.js";
 import { createMemoryWikiTestHarness } from "./test-helpers.js";
+import { createWikiApplyTool, createWikiLintTool } from "./tool.js";
 
 function asSchemaObject(value: unknown): Record<string, unknown> {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
diff --git a/extensions/memory-wiki/src/tool.ts b/extensions/memory-wiki/src/tool.ts
index b31deccc787e..8745d26dac43 100644
--- a/extensions/memory-wiki/src/tool.ts
+++ b/extensions/memory-wiki/src/tool.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements tool behavior.
 import path from "node:path";
 import { optionalFiniteNumberSchema } from "openclaw/plugin-sdk/channel-actions";
 import { Type } from "typebox";
diff --git a/extensions/memory-wiki/src/unsafe-local.test.ts b/extensions/memory-wiki/src/unsafe-local.test.ts
index d5f71d3bc213..b797cfed1e8f 100644
--- a/extensions/memory-wiki/src/unsafe-local.test.ts
+++ b/extensions/memory-wiki/src/unsafe-local.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover unsafe local plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/memory-wiki/src/unsafe-local.ts b/extensions/memory-wiki/src/unsafe-local.ts
index 693749bf1402..c37a004c54b9 100644
--- a/extensions/memory-wiki/src/unsafe-local.ts
+++ b/extensions/memory-wiki/src/unsafe-local.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements unsafe local behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/memory-wiki/src/vault.test.ts b/extensions/memory-wiki/src/vault.test.ts
index 7029a622d744..4ca209d48011 100644
--- a/extensions/memory-wiki/src/vault.test.ts
+++ b/extensions/memory-wiki/src/vault.test.ts
@@ -1,3 +1,4 @@
+// Memory Wiki tests cover vault plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/memory-wiki/src/vault.ts b/extensions/memory-wiki/src/vault.ts
index 0a26fcdff85f..da87793d3584 100644
--- a/extensions/memory-wiki/src/vault.ts
+++ b/extensions/memory-wiki/src/vault.ts
@@ -1,3 +1,4 @@
+// Memory Wiki plugin module implements vault behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import {
diff --git a/extensions/minimax/api.ts b/extensions/minimax/api.ts
index ebb16836c7a7..cd521b05ff0e 100644
--- a/extensions/minimax/api.ts
+++ b/extensions/minimax/api.ts
@@ -1,3 +1,4 @@
+// Minimax API module exposes the plugin public contract.
 export { buildMinimaxPortalProvider, buildMinimaxProvider } from "./provider-catalog.js";
 export {
   buildMinimaxApiModelDefinition,
diff --git a/extensions/minimax/image-generation-provider.test.ts b/extensions/minimax/image-generation-provider.test.ts
index 85c9804c6c59..1f67135919df 100644
--- a/extensions/minimax/image-generation-provider.test.ts
+++ b/extensions/minimax/image-generation-provider.test.ts
@@ -1,3 +1,4 @@
+// Minimax tests cover image generation provider plugin behavior.
 import * as providerAuth from "openclaw/plugin-sdk/provider-auth-runtime";
 import * as providerHttp from "openclaw/plugin-sdk/provider-http";
 import { installPinnedHostnameTestHooks } from "openclaw/plugin-sdk/test-env";
diff --git a/extensions/minimax/image-generation-provider.ts b/extensions/minimax/image-generation-provider.ts
index f94eb6a0d723..300cc9104f9f 100644
--- a/extensions/minimax/image-generation-provider.ts
+++ b/extensions/minimax/image-generation-provider.ts
@@ -1,3 +1,4 @@
+// Minimax provider module implements model/runtime integration.
 import type { ImageGenerationProvider } from "openclaw/plugin-sdk/image-generation";
 import { canonicalizeBase64 } from "openclaw/plugin-sdk/media-runtime";
 import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth";
diff --git a/extensions/minimax/index.test.ts b/extensions/minimax/index.test.ts
index f3b8a821ff71..eaad2957437b 100644
--- a/extensions/minimax/index.test.ts
+++ b/extensions/minimax/index.test.ts
@@ -1,3 +1,4 @@
+// Minimax tests cover index plugin behavior.
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import type { StreamFn } from "openclaw/plugin-sdk/agent-core";
diff --git a/extensions/minimax/index.ts b/extensions/minimax/index.ts
index ec8fc9fbe90a..7be659ec1798 100644
--- a/extensions/minimax/index.ts
+++ b/extensions/minimax/index.ts
@@ -1,3 +1,4 @@
+// Minimax plugin entrypoint registers its OpenClaw integration.
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import {
   buildMinimaxImageGenerationProvider,
diff --git a/extensions/minimax/media-understanding-provider.ts b/extensions/minimax/media-understanding-provider.ts
index f8de99204a95..b90aa48f767a 100644
--- a/extensions/minimax/media-understanding-provider.ts
+++ b/extensions/minimax/media-understanding-provider.ts
@@ -1,3 +1,4 @@
+// Minimax provider module implements model/runtime integration.
 import {
   describeImageWithModel,
   describeImagesWithModel,
diff --git a/extensions/minimax/minimax.live.test.ts b/extensions/minimax/minimax.live.test.ts
index cb82c465349c..9f71d19e516d 100644
--- a/extensions/minimax/minimax.live.test.ts
+++ b/extensions/minimax/minimax.live.test.ts
@@ -1,3 +1,4 @@
+// Minimax tests cover minimax plugin behavior.
 import {
   registerProviderPlugin,
   requireRegisteredProvider,
diff --git a/extensions/minimax/model-definitions.test.ts b/extensions/minimax/model-definitions.test.ts
index cb7a39e9d29d..da76812f69df 100644
--- a/extensions/minimax/model-definitions.test.ts
+++ b/extensions/minimax/model-definitions.test.ts
@@ -1,3 +1,4 @@
+// Minimax tests cover model definitions plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildMinimaxApiModelDefinition,
diff --git a/extensions/minimax/model-definitions.ts b/extensions/minimax/model-definitions.ts
index 55288d41978b..5a046bcf7d02 100644
--- a/extensions/minimax/model-definitions.ts
+++ b/extensions/minimax/model-definitions.ts
@@ -1,3 +1,4 @@
+// Minimax plugin module implements model definitions behavior.
 import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared";
 import { MINIMAX_DEFAULT_MODEL_ID, MINIMAX_TEXT_MODEL_CATALOG } from "./provider-models.js";
 
diff --git a/extensions/minimax/music-generation-provider.test.ts b/extensions/minimax/music-generation-provider.test.ts
index e87b0ae4ee71..da26ed10f48a 100644
--- a/extensions/minimax/music-generation-provider.test.ts
+++ b/extensions/minimax/music-generation-provider.test.ts
@@ -1,3 +1,4 @@
+// Minimax tests cover music generation provider plugin behavior.
 import { expectExplicitMusicGenerationCapabilities } from "openclaw/plugin-sdk/provider-test-contracts";
 import { beforeAll, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/minimax/music-generation-provider.ts b/extensions/minimax/music-generation-provider.ts
index 7e8ad73c34cb..08977f64eefb 100644
--- a/extensions/minimax/music-generation-provider.ts
+++ b/extensions/minimax/music-generation-provider.ts
@@ -1,3 +1,4 @@
+// Minimax provider module implements model/runtime integration.
 import { extensionForMime } from "openclaw/plugin-sdk/media-mime";
 import type {
   GeneratedMusicAsset,
diff --git a/extensions/minimax/oauth.runtime.ts b/extensions/minimax/oauth.runtime.ts
index 9659b3f7310f..95ee43686405 100644
--- a/extensions/minimax/oauth.runtime.ts
+++ b/extensions/minimax/oauth.runtime.ts
@@ -1 +1,2 @@
+// Minimax plugin module implements oauth behavior.
 export { loginMiniMaxPortalOAuth } from "./oauth.js";
diff --git a/extensions/minimax/oauth.test.ts b/extensions/minimax/oauth.test.ts
index dc5bb2bcb891..cb30242420bc 100644
--- a/extensions/minimax/oauth.test.ts
+++ b/extensions/minimax/oauth.test.ts
@@ -1,3 +1,4 @@
+// Minimax tests cover oauth plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { loginMiniMaxPortalOAuth, normalizeOAuthExpires } from "./oauth.js";
diff --git a/extensions/minimax/oauth.ts b/extensions/minimax/oauth.ts
index 3d3110f2afcf..5b0c47c3f3b5 100644
--- a/extensions/minimax/oauth.ts
+++ b/extensions/minimax/oauth.ts
@@ -1,3 +1,4 @@
+// Minimax plugin module implements oauth behavior.
 import { randomBytes, randomUUID } from "node:crypto";
 import {
   MAX_DATE_TIMESTAMP_MS,
diff --git a/extensions/minimax/onboard.test.ts b/extensions/minimax/onboard.test.ts
index 054bbda5cf68..ae5c323fc9df 100644
--- a/extensions/minimax/onboard.test.ts
+++ b/extensions/minimax/onboard.test.ts
@@ -1,3 +1,4 @@
+// Minimax tests cover onboard plugin behavior.
 import { resolveAgentModelPrimaryValue } from "openclaw/plugin-sdk/provider-onboard";
 import {
   expectProviderOnboardMergedLegacyConfig,
diff --git a/extensions/minimax/onboard.ts b/extensions/minimax/onboard.ts
index 4bad3b7325b9..5e3fdde4a142 100644
--- a/extensions/minimax/onboard.ts
+++ b/extensions/minimax/onboard.ts
@@ -1,3 +1,4 @@
+// Minimax setup module handles plugin onboarding behavior.
 import {
   applyAgentDefaultModelPrimary,
   applyOnboardAuthAgentModelsAndProviders,
diff --git a/extensions/minimax/provider-catalog.ts b/extensions/minimax/provider-catalog.ts
index 91e15e07d0ba..a96888bec541 100644
--- a/extensions/minimax/provider-catalog.ts
+++ b/extensions/minimax/provider-catalog.ts
@@ -1,3 +1,4 @@
+// Minimax provider module implements model/runtime integration.
 import type {
   ModelDefinitionConfig,
   ModelProviderConfig,
diff --git a/extensions/minimax/provider-contract-api.ts b/extensions/minimax/provider-contract-api.ts
index 13b6c687d365..ee4d82bf3ea6 100644
--- a/extensions/minimax/provider-contract-api.ts
+++ b/extensions/minimax/provider-contract-api.ts
@@ -1,3 +1,4 @@
+// Minimax API module exposes the plugin public contract.
 import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared";
 
 const noopAuth = async () => ({ profiles: [] });
diff --git a/extensions/minimax/provider-discovery.contract.test.ts b/extensions/minimax/provider-discovery.contract.test.ts
index ec1a6aafbaa9..a5888b598cd5 100644
--- a/extensions/minimax/provider-discovery.contract.test.ts
+++ b/extensions/minimax/provider-discovery.contract.test.ts
@@ -1,3 +1,4 @@
+// Minimax tests cover provider discovery.contract plugin behavior.
 import { describeMinimaxProviderDiscoveryContract } from "openclaw/plugin-sdk/provider-test-contracts";
 
 describeMinimaxProviderDiscoveryContract(() => import("./index.js"));
diff --git a/extensions/minimax/provider-discovery.ts b/extensions/minimax/provider-discovery.ts
index 73b305e38e6a..82975a86b965 100644
--- a/extensions/minimax/provider-discovery.ts
+++ b/extensions/minimax/provider-discovery.ts
@@ -1,3 +1,4 @@
+// Minimax provider module implements model/runtime integration.
 import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared";
 import { buildMinimaxPortalProvider, buildMinimaxProvider } from "./provider-catalog.js";
 
diff --git a/extensions/minimax/provider-http.test-helpers.ts b/extensions/minimax/provider-http.test-helpers.ts
index a6b6337820f6..d19a920fd64a 100644
--- a/extensions/minimax/provider-http.test-helpers.ts
+++ b/extensions/minimax/provider-http.test-helpers.ts
@@ -1,3 +1,4 @@
+// Minimax provider module implements model/runtime integration.
 import type {
   fetchProviderDownloadResponse,
   fetchProviderOperationResponse,
diff --git a/extensions/minimax/provider-models.ts b/extensions/minimax/provider-models.ts
index 691c4d32e0e1..7eac693662fc 100644
--- a/extensions/minimax/provider-models.ts
+++ b/extensions/minimax/provider-models.ts
@@ -1,3 +1,4 @@
+// Minimax provider module implements model/runtime integration.
 import { matchesExactOrPrefix } from "openclaw/plugin-sdk/provider-model-shared";
 
 export const MINIMAX_DEFAULT_MODEL_ID = "MiniMax-M3";
diff --git a/extensions/minimax/provider-registration.ts b/extensions/minimax/provider-registration.ts
index 965964947bdb..034561a7cd74 100644
--- a/extensions/minimax/provider-registration.ts
+++ b/extensions/minimax/provider-registration.ts
@@ -1,3 +1,4 @@
+// Minimax provider module implements model/runtime integration.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import type {
   OpenClawPluginApi,
diff --git a/extensions/minimax/speech-provider.test.ts b/extensions/minimax/speech-provider.test.ts
index 82993ffa0cd1..bd549fb63469 100644
--- a/extensions/minimax/speech-provider.test.ts
+++ b/extensions/minimax/speech-provider.test.ts
@@ -1,3 +1,4 @@
+// Minimax tests cover speech provider plugin behavior.
 import { mkdir, mkdtemp, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";
diff --git a/extensions/minimax/speech-provider.ts b/extensions/minimax/speech-provider.ts
index da48bac217f2..19e1751e9c61 100644
--- a/extensions/minimax/speech-provider.ts
+++ b/extensions/minimax/speech-provider.ts
@@ -1,3 +1,4 @@
+// Minimax provider module implements model/runtime integration.
 import { transcodeAudioBufferToOpus } from "openclaw/plugin-sdk/media-runtime";
 import {
   isProviderAuthProfileConfigured,
diff --git a/extensions/minimax/src/minimax-web-search-provider.runtime.ts b/extensions/minimax/src/minimax-web-search-provider.runtime.ts
index a7cbaa562206..250e98357520 100644
--- a/extensions/minimax/src/minimax-web-search-provider.runtime.ts
+++ b/extensions/minimax/src/minimax-web-search-provider.runtime.ts
@@ -1,3 +1,4 @@
+// Minimax provider module implements model/runtime integration.
 import {
   createProviderHttpError,
   formatProviderHttpErrorMessage,
diff --git a/extensions/minimax/src/minimax-web-search-provider.test.ts b/extensions/minimax/src/minimax-web-search-provider.test.ts
index d09ba875ab3d..2efa66b2f768 100644
--- a/extensions/minimax/src/minimax-web-search-provider.test.ts
+++ b/extensions/minimax/src/minimax-web-search-provider.test.ts
@@ -1,3 +1,4 @@
+// Minimax tests cover minimax web search provider plugin behavior.
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
 import { minimaxWebSearchTesting } from "../test-api.js";
 
diff --git a/extensions/minimax/src/minimax-web-search-provider.ts b/extensions/minimax/src/minimax-web-search-provider.ts
index 5db337cb19b4..21765d583a31 100644
--- a/extensions/minimax/src/minimax-web-search-provider.ts
+++ b/extensions/minimax/src/minimax-web-search-provider.ts
@@ -1,3 +1,4 @@
+// Minimax provider module implements model/runtime integration.
 import {
   createWebSearchProviderContractFields,
   type WebSearchProviderPlugin,
diff --git a/extensions/minimax/test-api.ts b/extensions/minimax/test-api.ts
index b838379953d6..b7fb15730861 100644
--- a/extensions/minimax/test-api.ts
+++ b/extensions/minimax/test-api.ts
@@ -1,3 +1,4 @@
+// Minimax API module exposes the plugin public contract.
 export {
   buildMinimaxImageGenerationProvider,
   buildMinimaxPortalImageGenerationProvider,
diff --git a/extensions/minimax/tts.test.ts b/extensions/minimax/tts.test.ts
index 4a4452e68377..a87aa0d0c6f2 100644
--- a/extensions/minimax/tts.test.ts
+++ b/extensions/minimax/tts.test.ts
@@ -1,3 +1,4 @@
+// Minimax tests cover tts plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/minimax/tts.ts b/extensions/minimax/tts.ts
index 1b037290300a..9553abe04b4f 100644
--- a/extensions/minimax/tts.ts
+++ b/extensions/minimax/tts.ts
@@ -1,3 +1,4 @@
+// Minimax plugin module implements tts behavior.
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 import { assertOkOrThrowProviderError } from "openclaw/plugin-sdk/provider-http";
 import {
diff --git a/extensions/minimax/video-generation-provider.test.ts b/extensions/minimax/video-generation-provider.test.ts
index ba4115cfb770..bff2ae468376 100644
--- a/extensions/minimax/video-generation-provider.test.ts
+++ b/extensions/minimax/video-generation-provider.test.ts
@@ -1,3 +1,4 @@
+// Minimax tests cover video generation provider plugin behavior.
 import { expectExplicitVideoGenerationCapabilities } from "openclaw/plugin-sdk/provider-test-contracts";
 import { beforeAll, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/minimax/video-generation-provider.ts b/extensions/minimax/video-generation-provider.ts
index 13a9e99a1616..0397973147ca 100644
--- a/extensions/minimax/video-generation-provider.ts
+++ b/extensions/minimax/video-generation-provider.ts
@@ -1,3 +1,4 @@
+// Minimax provider module implements model/runtime integration.
 import { extensionForMime } from "openclaw/plugin-sdk/media-mime";
 import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth";
 import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime";
diff --git a/extensions/minimax/web-search-contract-api.ts b/extensions/minimax/web-search-contract-api.ts
index d772f0302362..49d089a2f968 100644
--- a/extensions/minimax/web-search-contract-api.ts
+++ b/extensions/minimax/web-search-contract-api.ts
@@ -1,3 +1,4 @@
+// Minimax API module exposes the plugin public contract.
 import {
   createWebSearchProviderContractFields,
   type WebSearchProviderPlugin,
diff --git a/extensions/minimax/web-search-provider.ts b/extensions/minimax/web-search-provider.ts
index 740cc4ce4d21..7051f3fe2669 100644
--- a/extensions/minimax/web-search-provider.ts
+++ b/extensions/minimax/web-search-provider.ts
@@ -1 +1,2 @@
+// Minimax provider module implements model/runtime integration.
 export { createMiniMaxWebSearchProvider } from "./src/minimax-web-search-provider.js";
diff --git a/extensions/nextcloud-talk/api.ts b/extensions/nextcloud-talk/api.ts
index 05701614b9eb..8620e5cd5a33 100644
--- a/extensions/nextcloud-talk/api.ts
+++ b/extensions/nextcloud-talk/api.ts
@@ -1 +1,2 @@
+// Nextcloud Talk API module exposes the plugin public contract.
 export { nextcloudTalkPlugin } from "./src/channel.js";
diff --git a/extensions/nextcloud-talk/channel-plugin-api.ts b/extensions/nextcloud-talk/channel-plugin-api.ts
index 05701614b9eb..8620e5cd5a33 100644
--- a/extensions/nextcloud-talk/channel-plugin-api.ts
+++ b/extensions/nextcloud-talk/channel-plugin-api.ts
@@ -1 +1,2 @@
+// Nextcloud Talk API module exposes the plugin public contract.
 export { nextcloudTalkPlugin } from "./src/channel.js";
diff --git a/extensions/nextcloud-talk/contract-api.ts b/extensions/nextcloud-talk/contract-api.ts
index bc8f64f050fc..de7c4ff4aa88 100644
--- a/extensions/nextcloud-talk/contract-api.ts
+++ b/extensions/nextcloud-talk/contract-api.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk API module exposes the plugin public contract.
 export {
   collectRuntimeConfigAssignments,
   secretTargetRegistryEntries,
diff --git a/extensions/nextcloud-talk/doctor-contract-api.ts b/extensions/nextcloud-talk/doctor-contract-api.ts
index a7a56f234421..881082307624 100644
--- a/extensions/nextcloud-talk/doctor-contract-api.ts
+++ b/extensions/nextcloud-talk/doctor-contract-api.ts
@@ -1 +1,2 @@
+// Nextcloud Talk API module exposes the plugin public contract.
 export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
diff --git a/extensions/nextcloud-talk/index.ts b/extensions/nextcloud-talk/index.ts
index 6a77e515592d..e4949e46936e 100644
--- a/extensions/nextcloud-talk/index.ts
+++ b/extensions/nextcloud-talk/index.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin entrypoint registers its OpenClaw integration.
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelEntry({
diff --git a/extensions/nextcloud-talk/secret-contract-api.ts b/extensions/nextcloud-talk/secret-contract-api.ts
index 9f44ef28569c..9b2e37a21a98 100644
--- a/extensions/nextcloud-talk/secret-contract-api.ts
+++ b/extensions/nextcloud-talk/secret-contract-api.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk API module exposes the plugin public contract.
 export {
   channelSecrets,
   collectRuntimeConfigAssignments,
diff --git a/extensions/nextcloud-talk/setup-entry.ts b/extensions/nextcloud-talk/setup-entry.ts
index e5e9067dfc43..bb7ec37b675b 100644
--- a/extensions/nextcloud-talk/setup-entry.ts
+++ b/extensions/nextcloud-talk/setup-entry.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/nextcloud-talk/src/accounts.test.ts b/extensions/nextcloud-talk/src/accounts.test.ts
index c6524e1e4296..8b365eea16d1 100644
--- a/extensions/nextcloud-talk/src/accounts.test.ts
+++ b/extensions/nextcloud-talk/src/accounts.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover accounts plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   listNextcloudTalkAccountIds,
diff --git a/extensions/nextcloud-talk/src/accounts.ts b/extensions/nextcloud-talk/src/accounts.ts
index 35aa9f8db663..650096e2bc9f 100644
--- a/extensions/nextcloud-talk/src/accounts.ts
+++ b/extensions/nextcloud-talk/src/accounts.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements accounts behavior.
 import {
   createAccountListHelpers,
   DEFAULT_ACCOUNT_ID,
diff --git a/extensions/nextcloud-talk/src/api-credentials.ts b/extensions/nextcloud-talk/src/api-credentials.ts
index 82021165e0b6..2c29f8c7509a 100644
--- a/extensions/nextcloud-talk/src/api-credentials.ts
+++ b/extensions/nextcloud-talk/src/api-credentials.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements api credentials behavior.
 import { readFileSync } from "node:fs";
 import { normalizeResolvedSecretInputString } from "./secret-input.js";
 
diff --git a/extensions/nextcloud-talk/src/approval-auth.test.ts b/extensions/nextcloud-talk/src/approval-auth.test.ts
index b28cf37f6919..a976e5d0e54b 100644
--- a/extensions/nextcloud-talk/src/approval-auth.test.ts
+++ b/extensions/nextcloud-talk/src/approval-auth.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover approval auth plugin behavior.
 import { describe, expect, it } from "vitest";
 import { nextcloudTalkApprovalAuth } from "./approval-auth.js";
 
diff --git a/extensions/nextcloud-talk/src/approval-auth.ts b/extensions/nextcloud-talk/src/approval-auth.ts
index afbd72abc47a..3acd91deda9c 100644
--- a/extensions/nextcloud-talk/src/approval-auth.ts
+++ b/extensions/nextcloud-talk/src/approval-auth.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements approval auth behavior.
 import {
   createResolvedApproverActionAuthAdapter,
   resolveApprovalApprovers,
diff --git a/extensions/nextcloud-talk/src/bot-preflight.test.ts b/extensions/nextcloud-talk/src/bot-preflight.test.ts
index a21b81cabb14..db2cf6cefcf4 100644
--- a/extensions/nextcloud-talk/src/bot-preflight.test.ts
+++ b/extensions/nextcloud-talk/src/bot-preflight.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover bot preflight plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { ResolvedNextcloudTalkAccount } from "./accounts.js";
 
diff --git a/extensions/nextcloud-talk/src/bot-preflight.ts b/extensions/nextcloud-talk/src/bot-preflight.ts
index bec844691b70..59137a38d31f 100644
--- a/extensions/nextcloud-talk/src/bot-preflight.ts
+++ b/extensions/nextcloud-talk/src/bot-preflight.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements bot preflight behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { parseStrictNonNegativeInteger } from "openclaw/plugin-sdk/number-runtime";
 import { readProviderJsonResponse } from "openclaw/plugin-sdk/provider-http";
diff --git a/extensions/nextcloud-talk/src/channel-api.ts b/extensions/nextcloud-talk/src/channel-api.ts
index 7e4acb2b797c..bd1f2c6eb598 100644
--- a/extensions/nextcloud-talk/src/channel-api.ts
+++ b/extensions/nextcloud-talk/src/channel-api.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk API module exposes the plugin public contract.
 export type { ChannelPlugin } from "openclaw/plugin-sdk/channel-plugin-common";
 export type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 export { clearAccountEntryFields } from "openclaw/plugin-sdk/channel-plugin-common";
diff --git a/extensions/nextcloud-talk/src/channel.adapters.ts b/extensions/nextcloud-talk/src/channel.adapters.ts
index fd6eff563f84..daa99f2480f8 100644
--- a/extensions/nextcloud-talk/src/channel.adapters.ts
+++ b/extensions/nextcloud-talk/src/channel.adapters.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements channel.adapters behavior.
 import { formatAllowFromLowercase } from "openclaw/plugin-sdk/allow-from";
 import {
   adaptScopedAccountAccessor,
diff --git a/extensions/nextcloud-talk/src/channel.core.test.ts b/extensions/nextcloud-talk/src/channel.core.test.ts
index a607d8af60b3..21bce04f353b 100644
--- a/extensions/nextcloud-talk/src/channel.core.test.ts
+++ b/extensions/nextcloud-talk/src/channel.core.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover channel.core plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   nextcloudTalkConfigAdapter,
diff --git a/extensions/nextcloud-talk/src/channel.lifecycle.test.ts b/extensions/nextcloud-talk/src/channel.lifecycle.test.ts
index 9ad5f348f45c..46aef91a61b6 100644
--- a/extensions/nextcloud-talk/src/channel.lifecycle.test.ts
+++ b/extensions/nextcloud-talk/src/channel.lifecycle.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover channel.lifecycle plugin behavior.
 import { createStartAccountContext } from "openclaw/plugin-sdk/channel-test-helpers";
 import {
   expectStopPendingUntilAbort,
diff --git a/extensions/nextcloud-talk/src/channel.status.test.ts b/extensions/nextcloud-talk/src/channel.status.test.ts
index 568753a364cf..d313def28aa8 100644
--- a/extensions/nextcloud-talk/src/channel.status.test.ts
+++ b/extensions/nextcloud-talk/src/channel.status.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover channel.status plugin behavior.
 import { describe, expect, it } from "vitest";
 import { nextcloudTalkPlugin } from "./channel.js";
 
diff --git a/extensions/nextcloud-talk/src/channel.ts b/extensions/nextcloud-talk/src/channel.ts
index 0bb03d8ad185..892ee5b624ee 100644
--- a/extensions/nextcloud-talk/src/channel.ts
+++ b/extensions/nextcloud-talk/src/channel.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements channel behavior.
 import { describeWebhookAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { createLoggedPairingApprovalNotifier } from "openclaw/plugin-sdk/channel-pairing";
diff --git a/extensions/nextcloud-talk/src/config-schema.ts b/extensions/nextcloud-talk/src/config-schema.ts
index c78f904b4600..315a82bd300b 100644
--- a/extensions/nextcloud-talk/src/config-schema.ts
+++ b/extensions/nextcloud-talk/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk helper module supports config schema behavior.
 import {
   DmPolicySchema,
   GroupPolicySchema,
diff --git a/extensions/nextcloud-talk/src/core.test.ts b/extensions/nextcloud-talk/src/core.test.ts
index 3b8db2fcbf79..9101ebee181c 100644
--- a/extensions/nextcloud-talk/src/core.test.ts
+++ b/extensions/nextcloud-talk/src/core.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover core plugin behavior.
 import { mkdtemp, rm } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/nextcloud-talk/src/doctor-contract.ts b/extensions/nextcloud-talk/src/doctor-contract.ts
index e5afb453540e..f38c43c17cf0 100644
--- a/extensions/nextcloud-talk/src/doctor-contract.ts
+++ b/extensions/nextcloud-talk/src/doctor-contract.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements doctor contract behavior.
 import { createLegacyPrivateNetworkDoctorContract } from "openclaw/plugin-sdk/ssrf-runtime";
 
 const contract = createLegacyPrivateNetworkDoctorContract({
diff --git a/extensions/nextcloud-talk/src/doctor.test.ts b/extensions/nextcloud-talk/src/doctor.test.ts
index 68bb382cf1a4..42410200e0a8 100644
--- a/extensions/nextcloud-talk/src/doctor.test.ts
+++ b/extensions/nextcloud-talk/src/doctor.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover doctor plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const hoisted = vi.hoisted(() => ({
diff --git a/extensions/nextcloud-talk/src/doctor.ts b/extensions/nextcloud-talk/src/doctor.ts
index 13d580a5e196..0edbb6f7248b 100644
--- a/extensions/nextcloud-talk/src/doctor.ts
+++ b/extensions/nextcloud-talk/src/doctor.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements doctor behavior.
 import type { ChannelDoctorAdapter } from "openclaw/plugin-sdk/channel-contract";
 import { listNextcloudTalkAccountIds, resolveNextcloudTalkAccount } from "./accounts.js";
 import { probeNextcloudTalkBotResponseFeature } from "./bot-preflight.js";
diff --git a/extensions/nextcloud-talk/src/gateway.ts b/extensions/nextcloud-talk/src/gateway.ts
index 03d5bf825553..f7743712ee55 100644
--- a/extensions/nextcloud-talk/src/gateway.ts
+++ b/extensions/nextcloud-talk/src/gateway.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements gateway behavior.
 import { createAccountStatusSink } from "openclaw/plugin-sdk/channel-outbound";
 import { runStoppablePassiveMonitor } from "openclaw/plugin-sdk/extension-shared";
 import { resolveNextcloudTalkAccount, type ResolvedNextcloudTalkAccount } from "./accounts.js";
diff --git a/extensions/nextcloud-talk/src/inbound.authz.test.ts b/extensions/nextcloud-talk/src/inbound.authz.test.ts
index 23511cf1c67e..8c32f64de36e 100644
--- a/extensions/nextcloud-talk/src/inbound.authz.test.ts
+++ b/extensions/nextcloud-talk/src/inbound.authz.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover inbound.authz plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { PluginRuntime, RuntimeEnv } from "../runtime-api.js";
 import type { ResolvedNextcloudTalkAccount } from "./accounts.js";
diff --git a/extensions/nextcloud-talk/src/inbound.behavior.test.ts b/extensions/nextcloud-talk/src/inbound.behavior.test.ts
index 867aa79078df..760c3a01236c 100644
--- a/extensions/nextcloud-talk/src/inbound.behavior.test.ts
+++ b/extensions/nextcloud-talk/src/inbound.behavior.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover inbound.behavior plugin behavior.
 import { createPluginRuntimeMock } from "openclaw/plugin-sdk/channel-test-helpers";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { PluginRuntime, RuntimeEnv } from "../runtime-api.js";
diff --git a/extensions/nextcloud-talk/src/inbound.ts b/extensions/nextcloud-talk/src/inbound.ts
index 7e48374eb4d0..ccadd2d7b65b 100644
--- a/extensions/nextcloud-talk/src/inbound.ts
+++ b/extensions/nextcloud-talk/src/inbound.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements inbound behavior.
 import {
   channelIngressRoutes,
   resolveStableChannelMessageIngress,
diff --git a/extensions/nextcloud-talk/src/message-actions.test.ts b/extensions/nextcloud-talk/src/message-actions.test.ts
index ce73d72a0f80..ba25366f288b 100644
--- a/extensions/nextcloud-talk/src/message-actions.test.ts
+++ b/extensions/nextcloud-talk/src/message-actions.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover message actions plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { CoreConfig } from "./types.js";
diff --git a/extensions/nextcloud-talk/src/message-actions.ts b/extensions/nextcloud-talk/src/message-actions.ts
index 556308672c3f..e7d0aeae4563 100644
--- a/extensions/nextcloud-talk/src/message-actions.ts
+++ b/extensions/nextcloud-talk/src/message-actions.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements message actions behavior.
 import {
   jsonResult,
   readStringParam,
diff --git a/extensions/nextcloud-talk/src/message-adapter.ts b/extensions/nextcloud-talk/src/message-adapter.ts
index 0282372951cd..e0a1b47ef036 100644
--- a/extensions/nextcloud-talk/src/message-adapter.ts
+++ b/extensions/nextcloud-talk/src/message-adapter.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements message adapter behavior.
 import { defineChannelMessageAdapter } from "openclaw/plugin-sdk/channel-outbound";
 import { sendMessageNextcloudTalk } from "./send.js";
 import type { CoreConfig } from "./types.js";
diff --git a/extensions/nextcloud-talk/src/monitor-runtime.ts b/extensions/nextcloud-talk/src/monitor-runtime.ts
index da55a221b149..509adb6e883d 100644
--- a/extensions/nextcloud-talk/src/monitor-runtime.ts
+++ b/extensions/nextcloud-talk/src/monitor-runtime.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements monitor runtime behavior.
 import os from "node:os";
 import { resolveLoggerBackedRuntime } from "openclaw/plugin-sdk/extension-shared";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";
diff --git a/extensions/nextcloud-talk/src/monitor.replay.test.ts b/extensions/nextcloud-talk/src/monitor.replay.test.ts
index 5be435ebfe64..e6f59b708a77 100644
--- a/extensions/nextcloud-talk/src/monitor.replay.test.ts
+++ b/extensions/nextcloud-talk/src/monitor.replay.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover monitor.replay plugin behavior.
 import { createMockIncomingRequest } from "openclaw/plugin-sdk/test-env";
 import { describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/nextcloud-talk/src/monitor.test-fixtures.ts b/extensions/nextcloud-talk/src/monitor.test-fixtures.ts
index 1a65a1b25e66..2857aa49a8e7 100644
--- a/extensions/nextcloud-talk/src/monitor.test-fixtures.ts
+++ b/extensions/nextcloud-talk/src/monitor.test-fixtures.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements monitor fixtures behavior.
 import { generateNextcloudTalkSignature } from "./signature.js";
 
 export function createSignedCreateMessageRequest(params?: { backend?: string }) {
diff --git a/extensions/nextcloud-talk/src/monitor.test-harness.ts b/extensions/nextcloud-talk/src/monitor.test-harness.ts
index b52bb22d78c6..1cf0e954ed1f 100644
--- a/extensions/nextcloud-talk/src/monitor.test-harness.ts
+++ b/extensions/nextcloud-talk/src/monitor.test-harness.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements monitor harness behavior.
 import type { AddressInfo } from "node:net";
 import { afterEach } from "vitest";
 import { createNextcloudTalkWebhookServer } from "./monitor.js";
diff --git a/extensions/nextcloud-talk/src/monitor.ts b/extensions/nextcloud-talk/src/monitor.ts
index 5c494bd00e09..c47e821af549 100644
--- a/extensions/nextcloud-talk/src/monitor.ts
+++ b/extensions/nextcloud-talk/src/monitor.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements monitor behavior.
 import { createServer, type IncomingMessage, type Server, type ServerResponse } from "node:http";
 import { safeParseJsonWithSchema } from "openclaw/plugin-sdk/extension-shared";
 import {
diff --git a/extensions/nextcloud-talk/src/normalize.ts b/extensions/nextcloud-talk/src/normalize.ts
index 295caadd8a4b..42316ca360f4 100644
--- a/extensions/nextcloud-talk/src/normalize.ts
+++ b/extensions/nextcloud-talk/src/normalize.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk helper module supports normalize behavior.
 export function stripNextcloudTalkTargetPrefix(raw: string): string | undefined {
   const trimmed = raw.trim();
   if (!trimmed) {
diff --git a/extensions/nextcloud-talk/src/policy.ts b/extensions/nextcloud-talk/src/policy.ts
index c8ad4dbd92bc..767a11cf51f3 100644
--- a/extensions/nextcloud-talk/src/policy.ts
+++ b/extensions/nextcloud-talk/src/policy.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements policy behavior.
 import {
   buildChannelKeyCandidates,
   normalizeChannelSlug,
diff --git a/extensions/nextcloud-talk/src/replay-guard.ts b/extensions/nextcloud-talk/src/replay-guard.ts
index a75a439b21bf..1857c4ea2d75 100644
--- a/extensions/nextcloud-talk/src/replay-guard.ts
+++ b/extensions/nextcloud-talk/src/replay-guard.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements replay guard behavior.
 import path from "node:path";
 import { createClaimableDedupe } from "openclaw/plugin-sdk/persistent-dedupe";
 
diff --git a/extensions/nextcloud-talk/src/room-info.test.ts b/extensions/nextcloud-talk/src/room-info.test.ts
index 5f358003a8e1..56dcfb508383 100644
--- a/extensions/nextcloud-talk/src/room-info.test.ts
+++ b/extensions/nextcloud-talk/src/room-info.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover room info plugin behavior.
 import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import path from "node:path";
diff --git a/extensions/nextcloud-talk/src/room-info.ts b/extensions/nextcloud-talk/src/room-info.ts
index 85d3b7c3bf41..3a03a9608fbe 100644
--- a/extensions/nextcloud-talk/src/room-info.ts
+++ b/extensions/nextcloud-talk/src/room-info.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements room info behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
 import { readProviderJsonResponse } from "openclaw/plugin-sdk/provider-http";
diff --git a/extensions/nextcloud-talk/src/runtime.ts b/extensions/nextcloud-talk/src/runtime.ts
index 35eb1cb8f63f..7b809aef0663 100644
--- a/extensions/nextcloud-talk/src/runtime.ts
+++ b/extensions/nextcloud-talk/src/runtime.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements runtime behavior.
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 import type { PluginRuntime } from "openclaw/plugin-sdk/runtime-store";
 
diff --git a/extensions/nextcloud-talk/src/secret-contract.ts b/extensions/nextcloud-talk/src/secret-contract.ts
index ba34154f4ce6..28875ecbad4c 100644
--- a/extensions/nextcloud-talk/src/secret-contract.ts
+++ b/extensions/nextcloud-talk/src/secret-contract.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements secret contract behavior.
 import {
   collectConditionalChannelFieldAssignments,
   getChannelSurface,
diff --git a/extensions/nextcloud-talk/src/secret-input.ts b/extensions/nextcloud-talk/src/secret-input.ts
index 10e757b4145f..c5106f3e5518 100644
--- a/extensions/nextcloud-talk/src/secret-input.ts
+++ b/extensions/nextcloud-talk/src/secret-input.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements secret input behavior.
 export {
   buildSecretInputSchema,
   normalizeResolvedSecretInputString,
diff --git a/extensions/nextcloud-talk/src/send.cfg-threading.test.ts b/extensions/nextcloud-talk/src/send.cfg-threading.test.ts
index 99af411f1865..529806d20847 100644
--- a/extensions/nextcloud-talk/src/send.cfg-threading.test.ts
+++ b/extensions/nextcloud-talk/src/send.cfg-threading.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover send.cfg threading plugin behavior.
 import { verifyChannelMessageAdapterCapabilityProofs } from "openclaw/plugin-sdk/channel-outbound";
 import {
   createSendCfgThreadingRuntime,
diff --git a/extensions/nextcloud-talk/src/send.runtime.ts b/extensions/nextcloud-talk/src/send.runtime.ts
index cb04b1b1492b..5f235bb826de 100644
--- a/extensions/nextcloud-talk/src/send.runtime.ts
+++ b/extensions/nextcloud-talk/src/send.runtime.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements send behavior.
 export { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 export { resolveMarkdownTableMode } from "openclaw/plugin-sdk/markdown-table-runtime";
 export { ssrfPolicyFromPrivateNetworkOptIn } from "openclaw/plugin-sdk/ssrf-runtime";
diff --git a/extensions/nextcloud-talk/src/send.ts b/extensions/nextcloud-talk/src/send.ts
index f99cd1845012..8defeb3e2a1e 100644
--- a/extensions/nextcloud-talk/src/send.ts
+++ b/extensions/nextcloud-talk/src/send.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements send behavior.
 import { createMessageReceiptFromOutboundResults } from "openclaw/plugin-sdk/channel-outbound";
 import { stripNextcloudTalkTargetPrefix } from "./normalize.js";
 import {
diff --git a/extensions/nextcloud-talk/src/session-route.ts b/extensions/nextcloud-talk/src/session-route.ts
index 83ca2aab5727..3706d8d90efa 100644
--- a/extensions/nextcloud-talk/src/session-route.ts
+++ b/extensions/nextcloud-talk/src/session-route.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements session route behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { buildOutboundBaseSessionKey } from "openclaw/plugin-sdk/routing";
 import { stripNextcloudTalkTargetPrefix } from "./normalize.js";
diff --git a/extensions/nextcloud-talk/src/setup-core.ts b/extensions/nextcloud-talk/src/setup-core.ts
index 8754176a0c0e..8c4f642f9b40 100644
--- a/extensions/nextcloud-talk/src/setup-core.ts
+++ b/extensions/nextcloud-talk/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements setup core behavior.
 import type { ChannelSetupAdapter, ChannelSetupInput } from "openclaw/plugin-sdk/channel-setup";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/routing";
diff --git a/extensions/nextcloud-talk/src/setup-surface.ts b/extensions/nextcloud-talk/src/setup-surface.ts
index b151514dadb6..a37cb7a57593 100644
--- a/extensions/nextcloud-talk/src/setup-surface.ts
+++ b/extensions/nextcloud-talk/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements setup surface behavior.
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/routing";
 import { hasConfiguredSecretInput } from "openclaw/plugin-sdk/secret-input";
 import {
diff --git a/extensions/nextcloud-talk/src/setup.test.ts b/extensions/nextcloud-talk/src/setup.test.ts
index 938e7543c0d5..669b72101526 100644
--- a/extensions/nextcloud-talk/src/setup.test.ts
+++ b/extensions/nextcloud-talk/src/setup.test.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk tests cover setup plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/nextcloud-talk/src/signature.ts b/extensions/nextcloud-talk/src/signature.ts
index 8420e344fdb3..cd378afa3a80 100644
--- a/extensions/nextcloud-talk/src/signature.ts
+++ b/extensions/nextcloud-talk/src/signature.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk plugin module implements signature behavior.
 import { createHmac, randomBytes, timingSafeEqual } from "node:crypto";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { NextcloudTalkWebhookHeaders } from "./types.js";
diff --git a/extensions/nextcloud-talk/src/types.ts b/extensions/nextcloud-talk/src/types.ts
index 9e12a90b572d..25f58cf80ef6 100644
--- a/extensions/nextcloud-talk/src/types.ts
+++ b/extensions/nextcloud-talk/src/types.ts
@@ -1,3 +1,4 @@
+// Nextcloud Talk type declarations define plugin contracts.
 import type { MessageReceipt } from "openclaw/plugin-sdk/channel-outbound";
 import type {
   BlockStreamingCoalesceConfig,
diff --git a/extensions/nostr/api.ts b/extensions/nostr/api.ts
index 61595c3b79b0..b25f8b189361 100644
--- a/extensions/nostr/api.ts
+++ b/extensions/nostr/api.ts
@@ -1,3 +1,4 @@
+// Nostr API module exposes the plugin public contract.
 export {
   getPluginRuntimeGatewayRequestScope,
   type OpenClawConfig,
diff --git a/extensions/nostr/channel-plugin-api.ts b/extensions/nostr/channel-plugin-api.ts
index 3cdf86a5120f..603b98228536 100644
--- a/extensions/nostr/channel-plugin-api.ts
+++ b/extensions/nostr/channel-plugin-api.ts
@@ -1 +1,2 @@
+// Nostr API module exposes the plugin public contract.
 export { nostrPlugin } from "./src/channel.js";
diff --git a/extensions/nostr/doctor-contract-api.test.ts b/extensions/nostr/doctor-contract-api.test.ts
index ea9152ee7585..ba9e298408d0 100644
--- a/extensions/nostr/doctor-contract-api.test.ts
+++ b/extensions/nostr/doctor-contract-api.test.ts
@@ -1,3 +1,4 @@
+// Nostr tests cover doctor contract api plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/nostr/doctor-contract-api.ts b/extensions/nostr/doctor-contract-api.ts
index 679648054814..6189dd363436 100644
--- a/extensions/nostr/doctor-contract-api.ts
+++ b/extensions/nostr/doctor-contract-api.ts
@@ -1,3 +1,4 @@
+// Nostr API module exposes the plugin public contract.
 import type { Dirent } from "node:fs";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/nostr/index.ts b/extensions/nostr/index.ts
index 3a665750d0e2..56df5686040d 100644
--- a/extensions/nostr/index.ts
+++ b/extensions/nostr/index.ts
@@ -1,3 +1,4 @@
+// Nostr plugin entrypoint registers its OpenClaw integration.
 import {
   defineBundledChannelEntry,
   loadBundledEntryExportSync,
diff --git a/extensions/nostr/setup-api.ts b/extensions/nostr/setup-api.ts
index f9824d063b45..787a44e10a94 100644
--- a/extensions/nostr/setup-api.ts
+++ b/extensions/nostr/setup-api.ts
@@ -1 +1,2 @@
+// Nostr API module exposes the plugin public contract.
 export { nostrSetupAdapter, nostrSetupWizard } from "./src/setup-surface.js";
diff --git a/extensions/nostr/setup-entry.ts b/extensions/nostr/setup-entry.ts
index 145d15dd4c9d..f6bc0f628ed9 100644
--- a/extensions/nostr/setup-entry.ts
+++ b/extensions/nostr/setup-entry.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/nostr/src/channel-api.ts b/extensions/nostr/src/channel-api.ts
index 0ae01c400725..1a33a2cd947c 100644
--- a/extensions/nostr/src/channel-api.ts
+++ b/extensions/nostr/src/channel-api.ts
@@ -1,3 +1,4 @@
+// Nostr API module exposes the plugin public contract.
 export {
   buildChannelConfigSchema,
   DEFAULT_ACCOUNT_ID,
diff --git a/extensions/nostr/src/channel.inbound.test.ts b/extensions/nostr/src/channel.inbound.test.ts
index 41119d359f09..0feefa867f6f 100644
--- a/extensions/nostr/src/channel.inbound.test.ts
+++ b/extensions/nostr/src/channel.inbound.test.ts
@@ -1,3 +1,4 @@
+// Nostr tests cover channel.inbound plugin behavior.
 import { createStartAccountContext } from "openclaw/plugin-sdk/channel-test-helpers";
 import { afterEach, beforeAll, describe, expect, it, vi } from "vitest";
 import type { PluginRuntime } from "../runtime-api.js";
diff --git a/extensions/nostr/src/channel.lifecycle.test.ts b/extensions/nostr/src/channel.lifecycle.test.ts
index caffa5c5bae2..ca08b41f98e7 100644
--- a/extensions/nostr/src/channel.lifecycle.test.ts
+++ b/extensions/nostr/src/channel.lifecycle.test.ts
@@ -1,3 +1,4 @@
+// Nostr tests cover channel.lifecycle plugin behavior.
 import {
   createStartAccountContext,
   createPluginRuntimeMock,
diff --git a/extensions/nostr/src/channel.outbound.test.ts b/extensions/nostr/src/channel.outbound.test.ts
index 7a5eb7ff6b4d..217965e00bb1 100644
--- a/extensions/nostr/src/channel.outbound.test.ts
+++ b/extensions/nostr/src/channel.outbound.test.ts
@@ -1,3 +1,4 @@
+// Nostr tests cover channel.outbound plugin behavior.
 import { verifyChannelMessageAdapterCapabilityProofs } from "openclaw/plugin-sdk/channel-outbound";
 import { createStartAccountContext } from "openclaw/plugin-sdk/channel-test-helpers";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/nostr/src/channel.setup.ts b/extensions/nostr/src/channel.setup.ts
index 11b9d064a869..e5beed7cf2ee 100644
--- a/extensions/nostr/src/channel.setup.ts
+++ b/extensions/nostr/src/channel.setup.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements channel.setup behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
diff --git a/extensions/nostr/src/channel.test.ts b/extensions/nostr/src/channel.test.ts
index 421df762a6a1..3c1588b62d39 100644
--- a/extensions/nostr/src/channel.test.ts
+++ b/extensions/nostr/src/channel.test.ts
@@ -1,3 +1,4 @@
+// Nostr tests cover channel plugin behavior.
 import {
   createPluginSetupWizardConfigure,
   createTestWizardPrompter,
diff --git a/extensions/nostr/src/channel.ts b/extensions/nostr/src/channel.ts
index aca5c61d1a47..bc87fb4bb01f 100644
--- a/extensions/nostr/src/channel.ts
+++ b/extensions/nostr/src/channel.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements channel behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import {
   createScopedDmSecurityResolver,
diff --git a/extensions/nostr/src/config-schema.ts b/extensions/nostr/src/config-schema.ts
index 29342040d608..558d8b4f5740 100644
--- a/extensions/nostr/src/config-schema.ts
+++ b/extensions/nostr/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Nostr helper module supports config schema behavior.
 import {
   AllowFromListSchema,
   DmPolicySchema,
diff --git a/extensions/nostr/src/default-relays.ts b/extensions/nostr/src/default-relays.ts
index f9b6be01cba8..615e92f2dad3 100644
--- a/extensions/nostr/src/default-relays.ts
+++ b/extensions/nostr/src/default-relays.ts
@@ -1 +1,2 @@
+// Nostr plugin module implements default relays behavior.
 export const DEFAULT_RELAYS = ["wss://relay.damus.io", "wss://nos.lol"];
diff --git a/extensions/nostr/src/gateway.ts b/extensions/nostr/src/gateway.ts
index 67a25da09265..e349bba37dde 100644
--- a/extensions/nostr/src/gateway.ts
+++ b/extensions/nostr/src/gateway.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements gateway behavior.
 import {
   resolveStableChannelMessageIngress,
   type StableChannelIngressIdentityParams,
diff --git a/extensions/nostr/src/inbound-direct-dm-runtime.ts b/extensions/nostr/src/inbound-direct-dm-runtime.ts
index 04bbbd7785e9..042aa68cc452 100644
--- a/extensions/nostr/src/inbound-direct-dm-runtime.ts
+++ b/extensions/nostr/src/inbound-direct-dm-runtime.ts
@@ -1 +1,2 @@
+// Nostr plugin module implements inbound direct dm runtime behavior.
 export { dispatchInboundDirectDmWithRuntime } from "openclaw/plugin-sdk/channel-inbound";
diff --git a/extensions/nostr/src/nostr-bus.fuzz.test.ts b/extensions/nostr/src/nostr-bus.fuzz.test.ts
index e33cc0306a7e..a901bf8b177b 100644
--- a/extensions/nostr/src/nostr-bus.fuzz.test.ts
+++ b/extensions/nostr/src/nostr-bus.fuzz.test.ts
@@ -1,3 +1,4 @@
+// Nostr tests cover nostr bus.fuzz plugin behavior.
 import { describe, expect, it } from "vitest";
 import { createMetrics, type MetricName } from "./metrics.js";
 import { validatePrivateKey, isValidPubkey, normalizePubkey } from "./nostr-key-utils.js";
diff --git a/extensions/nostr/src/nostr-bus.inbound.test.ts b/extensions/nostr/src/nostr-bus.inbound.test.ts
index ed9da8e9ed62..0681b1dd552f 100644
--- a/extensions/nostr/src/nostr-bus.inbound.test.ts
+++ b/extensions/nostr/src/nostr-bus.inbound.test.ts
@@ -1,3 +1,4 @@
+// Nostr tests cover nostr bus.inbound plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { startNostrBus } from "./nostr-bus.js";
 import { TEST_HEX_PRIVATE_KEY } from "./test-fixtures.js";
diff --git a/extensions/nostr/src/nostr-bus.integration.test.ts b/extensions/nostr/src/nostr-bus.integration.test.ts
index 80cbf9432210..b6a2c84adba5 100644
--- a/extensions/nostr/src/nostr-bus.integration.test.ts
+++ b/extensions/nostr/src/nostr-bus.integration.test.ts
@@ -1,3 +1,4 @@
+// Nostr tests cover nostr bus.integration plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { createMetrics, createNoopMetrics, type MetricEvent } from "./metrics.js";
 import { createSeenTracker } from "./seen-tracker.js";
diff --git a/extensions/nostr/src/nostr-bus.test.ts b/extensions/nostr/src/nostr-bus.test.ts
index 63d1b7d79762..b0dc6dfec2fa 100644
--- a/extensions/nostr/src/nostr-bus.test.ts
+++ b/extensions/nostr/src/nostr-bus.test.ts
@@ -1,3 +1,4 @@
+// Nostr tests cover nostr bus plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   validatePrivateKey,
diff --git a/extensions/nostr/src/nostr-bus.ts b/extensions/nostr/src/nostr-bus.ts
index 6b868b442fe0..26b0ad44900b 100644
--- a/extensions/nostr/src/nostr-bus.ts
+++ b/extensions/nostr/src/nostr-bus.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements nostr bus behavior.
 import { SimplePool, finalizeEvent, getPublicKey, verifyEvent, type Event } from "nostr-tools";
 import { decrypt, encrypt } from "nostr-tools/nip04";
 import {
diff --git a/extensions/nostr/src/nostr-key-utils.ts b/extensions/nostr/src/nostr-key-utils.ts
index e116e8d9b3c4..813d7cbb4dd5 100644
--- a/extensions/nostr/src/nostr-key-utils.ts
+++ b/extensions/nostr/src/nostr-key-utils.ts
@@ -1,3 +1,4 @@
+// Nostr helper module supports nostr key utils behavior.
 import { getPublicKey, nip19 } from "nostr-tools";
 
 /**
diff --git a/extensions/nostr/src/nostr-profile-core.ts b/extensions/nostr/src/nostr-profile-core.ts
index f47279526a82..f56ef88385bb 100644
--- a/extensions/nostr/src/nostr-profile-core.ts
+++ b/extensions/nostr/src/nostr-profile-core.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements nostr profile core behavior.
 import { type NostrProfile, NostrProfileSchema } from "./config-schema.js";
 
 /** NIP-01 profile content (JSON inside kind:0 event). */
diff --git a/extensions/nostr/src/nostr-profile-http-runtime.ts b/extensions/nostr/src/nostr-profile-http-runtime.ts
index cf33cc5f74d6..f6d4162f1fa6 100644
--- a/extensions/nostr/src/nostr-profile-http-runtime.ts
+++ b/extensions/nostr/src/nostr-profile-http-runtime.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements nostr profile http runtime behavior.
 export {
   readJsonBodyWithLimit,
   requestBodyErrorToText,
diff --git a/extensions/nostr/src/nostr-profile-url-safety.ts b/extensions/nostr/src/nostr-profile-url-safety.ts
index 467a3e79d8a1..d13987d51cd7 100644
--- a/extensions/nostr/src/nostr-profile-url-safety.ts
+++ b/extensions/nostr/src/nostr-profile-url-safety.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements nostr profile url safety behavior.
 import { isBlockedHostnameOrIp } from "openclaw/plugin-sdk/ssrf-runtime";
 
 export function validateUrlSafety(urlStr: string): { ok: true } | { ok: false; error: string } {
diff --git a/extensions/nostr/src/nostr-profile.fuzz.test.ts b/extensions/nostr/src/nostr-profile.fuzz.test.ts
index 563eaddcf6a6..64b4fd9501c7 100644
--- a/extensions/nostr/src/nostr-profile.fuzz.test.ts
+++ b/extensions/nostr/src/nostr-profile.fuzz.test.ts
@@ -1,3 +1,4 @@
+// Nostr tests cover nostr profile.fuzz plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { NostrProfile } from "./config-schema.js";
 import {
diff --git a/extensions/nostr/src/nostr-profile.test.ts b/extensions/nostr/src/nostr-profile.test.ts
index d2508d2273b8..8d3e1620c7a5 100644
--- a/extensions/nostr/src/nostr-profile.test.ts
+++ b/extensions/nostr/src/nostr-profile.test.ts
@@ -1,3 +1,4 @@
+// Nostr tests cover nostr profile plugin behavior.
 import { verifyEvent, getPublicKey } from "nostr-tools";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { NostrProfile } from "./config-schema.js";
diff --git a/extensions/nostr/src/nostr-state-store.test.ts b/extensions/nostr/src/nostr-state-store.test.ts
index a9785d2e5113..19b0922bfe4d 100644
--- a/extensions/nostr/src/nostr-state-store.test.ts
+++ b/extensions/nostr/src/nostr-state-store.test.ts
@@ -1,3 +1,4 @@
+// Nostr tests cover nostr state store plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/nostr/src/nostr-state-store.ts b/extensions/nostr/src/nostr-state-store.ts
index ebcdd3446d00..49447cc7afc9 100644
--- a/extensions/nostr/src/nostr-state-store.ts
+++ b/extensions/nostr/src/nostr-state-store.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements nostr state store behavior.
 import { getNostrRuntime } from "./runtime.js";
 
 const STORE_VERSION = 2;
diff --git a/extensions/nostr/src/runtime.ts b/extensions/nostr/src/runtime.ts
index 6866046d229c..d4edeb908955 100644
--- a/extensions/nostr/src/runtime.ts
+++ b/extensions/nostr/src/runtime.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements runtime behavior.
 import type { PluginRuntime } from "openclaw/plugin-sdk/core";
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 
diff --git a/extensions/nostr/src/session-route.ts b/extensions/nostr/src/session-route.ts
index cbf31e89a564..69a8b0ad682d 100644
--- a/extensions/nostr/src/session-route.ts
+++ b/extensions/nostr/src/session-route.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements session route behavior.
 import {
   buildChannelOutboundSessionRoute,
   stripChannelTargetPrefix,
diff --git a/extensions/nostr/src/setup-adapter.ts b/extensions/nostr/src/setup-adapter.ts
index 25cc8cdced11..b5941456b226 100644
--- a/extensions/nostr/src/setup-adapter.ts
+++ b/extensions/nostr/src/setup-adapter.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements setup adapter behavior.
 import type { ChannelSetupAdapter } from "openclaw/plugin-sdk/channel-setup";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/routing";
diff --git a/extensions/nostr/src/setup-surface.ts b/extensions/nostr/src/setup-surface.ts
index cceee4b8cf62..45fff6b20d9e 100644
--- a/extensions/nostr/src/setup-surface.ts
+++ b/extensions/nostr/src/setup-surface.ts
@@ -1,8 +1,9 @@
+import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/routing";
+// Nostr plugin module implements setup surface behavior.
 import {
   hasConfiguredSecretInput,
   normalizeSecretInputString,
 } from "openclaw/plugin-sdk/secret-input";
-import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/routing";
 import type { ChannelSetupDmPolicy, ChannelSetupWizard, DmPolicy } from "openclaw/plugin-sdk/setup";
 import {
   createSetupTranslator,
@@ -16,11 +17,7 @@ import {
 } from "openclaw/plugin-sdk/setup";
 import { DEFAULT_RELAYS } from "./default-relays.js";
 import { getPublicKeyFromPrivate, normalizePubkey } from "./nostr-key-utils.js";
-import {
-  buildNostrSetupPatch,
-  createNostrSetupAdapter,
-  parseRelayUrls,
-} from "./setup-adapter.js";
+import { buildNostrSetupPatch, createNostrSetupAdapter, parseRelayUrls } from "./setup-adapter.js";
 import { resolveDefaultNostrAccountId, resolveNostrAccount } from "./types.js";
 
 const t = createSetupTranslator();
diff --git a/extensions/nostr/src/test-fixtures.ts b/extensions/nostr/src/test-fixtures.ts
index d3bd1b665e84..15ea649d6f08 100644
--- a/extensions/nostr/src/test-fixtures.ts
+++ b/extensions/nostr/src/test-fixtures.ts
@@ -1,3 +1,4 @@
+// Nostr plugin module implements test fixtures behavior.
 import type { ResolvedNostrAccount } from "./types.js";
 
 export const TEST_HEX_PRIVATE_KEY =
diff --git a/extensions/nostr/src/types.ts b/extensions/nostr/src/types.ts
index 9ad96963fa0e..3faf19a0a80f 100644
--- a/extensions/nostr/src/types.ts
+++ b/extensions/nostr/src/types.ts
@@ -1,3 +1,4 @@
+// Nostr type declarations define plugin contracts.
 import {
   DEFAULT_ACCOUNT_ID,
   normalizeAccountId,
diff --git a/extensions/nostr/test-api.ts b/extensions/nostr/test-api.ts
index 3cdf86a5120f..603b98228536 100644
--- a/extensions/nostr/test-api.ts
+++ b/extensions/nostr/test-api.ts
@@ -1 +1,2 @@
+// Nostr API module exposes the plugin public contract.
 export { nostrPlugin } from "./src/channel.js";
diff --git a/extensions/ollama/api.ts b/extensions/ollama/api.ts
index 0d18cf8d562d..8e7625b9fd95 100644
--- a/extensions/ollama/api.ts
+++ b/extensions/ollama/api.ts
@@ -1,3 +1,4 @@
+// Ollama API module exposes the plugin public contract.
 export {
   OLLAMA_DEFAULT_BASE_URL,
   OLLAMA_DEFAULT_CONTEXT_WINDOW,
diff --git a/extensions/ollama/index.test.ts b/extensions/ollama/index.test.ts
index 5b670b44ed70..42eda99abe8e 100644
--- a/extensions/ollama/index.test.ts
+++ b/extensions/ollama/index.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover index plugin behavior.
 import {
   describeImageWithModel,
   describeImagesWithModel,
diff --git a/extensions/ollama/index.ts b/extensions/ollama/index.ts
index 1acc895daf4a..ff7a3cbc8bab 100644
--- a/extensions/ollama/index.ts
+++ b/extensions/ollama/index.ts
@@ -1,3 +1,4 @@
+// Ollama plugin entrypoint registers its OpenClaw integration.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { resolvePluginConfigObject } from "openclaw/plugin-sdk/plugin-config-runtime";
 import {
diff --git a/extensions/ollama/ollama.live.test.ts b/extensions/ollama/ollama.live.test.ts
index b965efd87646..c762e2b00541 100644
--- a/extensions/ollama/ollama.live.test.ts
+++ b/extensions/ollama/ollama.live.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover ollama plugin behavior.
 import { spawnSync } from "node:child_process";
 import * as fsSync from "node:fs";
 import fs from "node:fs/promises";
diff --git a/extensions/ollama/provider-discovery.import-guard.test.ts b/extensions/ollama/provider-discovery.import-guard.test.ts
index d7930956801d..846125cfa05b 100644
--- a/extensions/ollama/provider-discovery.import-guard.test.ts
+++ b/extensions/ollama/provider-discovery.import-guard.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover provider discovery.import guard plugin behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/ollama/provider-discovery.test.ts b/extensions/ollama/provider-discovery.test.ts
index 8068e7ef23b6..e3278827410e 100644
--- a/extensions/ollama/provider-discovery.test.ts
+++ b/extensions/ollama/provider-discovery.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover provider discovery plugin behavior.
 import { mkdtempSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
diff --git a/extensions/ollama/provider-discovery.ts b/extensions/ollama/provider-discovery.ts
index ef709f8fd339..1597331474f9 100644
--- a/extensions/ollama/provider-discovery.ts
+++ b/extensions/ollama/provider-discovery.ts
@@ -1,3 +1,4 @@
+// Ollama provider module implements model/runtime integration.
 import type { ProviderCatalogContext } from "openclaw/plugin-sdk/provider-catalog-shared";
 import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared";
 import {
diff --git a/extensions/ollama/provider-policy-api.test.ts b/extensions/ollama/provider-policy-api.test.ts
index e31c0270c183..2595e0fd34b2 100644
--- a/extensions/ollama/provider-policy-api.test.ts
+++ b/extensions/ollama/provider-policy-api.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover provider policy api plugin behavior.
 import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-types";
 import { describe, expect, it } from "vitest";
 import { normalizeConfig, resolveThinkingProfile } from "./provider-policy-api.js";
diff --git a/extensions/ollama/provider-policy-api.ts b/extensions/ollama/provider-policy-api.ts
index 2ef81fb02b06..13f136c1aa10 100644
--- a/extensions/ollama/provider-policy-api.ts
+++ b/extensions/ollama/provider-policy-api.ts
@@ -1,3 +1,4 @@
+// Ollama API module exposes the plugin public contract.
 import type { ProviderThinkingProfile } from "openclaw/plugin-sdk/plugin-entry";
 import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-types";
 import { OLLAMA_DEFAULT_BASE_URL } from "./src/defaults.js";
diff --git a/extensions/ollama/runtime-api.ts b/extensions/ollama/runtime-api.ts
index 05156fab574e..6b53660a6c5c 100644
--- a/extensions/ollama/runtime-api.ts
+++ b/extensions/ollama/runtime-api.ts
@@ -1,3 +1,4 @@
+// Ollama API module exposes the plugin public contract.
 export {
   buildAssistantMessage,
   buildOllamaChatRequest,
diff --git a/extensions/ollama/src/defaults.ts b/extensions/ollama/src/defaults.ts
index c1e420674d88..ae293843fc5e 100644
--- a/extensions/ollama/src/defaults.ts
+++ b/extensions/ollama/src/defaults.ts
@@ -1,3 +1,4 @@
+// Ollama plugin module implements defaults behavior.
 export const OLLAMA_DEFAULT_BASE_URL = "http://127.0.0.1:11434";
 export const OLLAMA_DOCKER_HOST_BASE_URL = "http://host.docker.internal:11434";
 export const OLLAMA_CLOUD_BASE_URL = "https://ollama.com";
diff --git a/extensions/ollama/src/discovery-shared.test.ts b/extensions/ollama/src/discovery-shared.test.ts
index 980e7bf47c01..151f2d6f5ec3 100644
--- a/extensions/ollama/src/discovery-shared.test.ts
+++ b/extensions/ollama/src/discovery-shared.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover discovery shared plugin behavior.
 import { describe, expect, it } from "vitest";
 import { isLocalOllamaBaseUrl } from "./discovery-shared.js";
 
diff --git a/extensions/ollama/src/discovery-shared.ts b/extensions/ollama/src/discovery-shared.ts
index 404a8360c9f6..82f6f34e4cde 100644
--- a/extensions/ollama/src/discovery-shared.ts
+++ b/extensions/ollama/src/discovery-shared.ts
@@ -1,3 +1,4 @@
+// Ollama plugin module implements discovery shared behavior.
 import { getCachedLiveCatalogValue } from "openclaw/plugin-sdk/provider-catalog-shared";
 import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/ollama/src/embedding-provider.test.ts b/extensions/ollama/src/embedding-provider.test.ts
index 0040365643c9..13f8d1f43280 100644
--- a/extensions/ollama/src/embedding-provider.test.ts
+++ b/extensions/ollama/src/embedding-provider.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover embedding provider plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/provider-auth";
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/ollama/src/embedding-provider.ts b/extensions/ollama/src/embedding-provider.ts
index 44843ec8bd1b..56763f4c94f1 100644
--- a/extensions/ollama/src/embedding-provider.ts
+++ b/extensions/ollama/src/embedding-provider.ts
@@ -1,3 +1,4 @@
+// Ollama provider module implements model/runtime integration.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/provider-auth";
 import {
   isKnownEnvApiKeyMarker,
diff --git a/extensions/ollama/src/media-understanding-provider.ts b/extensions/ollama/src/media-understanding-provider.ts
index 307e70862d3f..59a88d7c1851 100644
--- a/extensions/ollama/src/media-understanding-provider.ts
+++ b/extensions/ollama/src/media-understanding-provider.ts
@@ -1,3 +1,4 @@
+// Ollama provider module implements model/runtime integration.
 import {
   describeImageWithModel,
   describeImagesWithModel,
diff --git a/extensions/ollama/src/memory-embedding-adapter.ts b/extensions/ollama/src/memory-embedding-adapter.ts
index 5299ed77f51b..02786bdde8d0 100644
--- a/extensions/ollama/src/memory-embedding-adapter.ts
+++ b/extensions/ollama/src/memory-embedding-adapter.ts
@@ -1,3 +1,4 @@
+// Ollama plugin module implements memory embedding adapter behavior.
 import type { MemoryEmbeddingProviderAdapter } from "openclaw/plugin-sdk/memory-core-host-engine-embeddings";
 import {
   DEFAULT_OLLAMA_EMBEDDING_MODEL,
diff --git a/extensions/ollama/src/model-behavior.ts b/extensions/ollama/src/model-behavior.ts
index ab3d35ad916d..88eab26031ca 100644
--- a/extensions/ollama/src/model-behavior.ts
+++ b/extensions/ollama/src/model-behavior.ts
@@ -1,3 +1,4 @@
+// Ollama plugin module implements model behavior behavior.
 import { isOllamaCloudKimiModelRef } from "./sanitizers/kimi-inline-reasoning.js";
 
 export function shouldWrapOllamaCompatMoonshotThinking(modelId: string): boolean {
diff --git a/extensions/ollama/src/model-id.ts b/extensions/ollama/src/model-id.ts
index 3cc1578fbda8..7649f3365c4f 100644
--- a/extensions/ollama/src/model-id.ts
+++ b/extensions/ollama/src/model-id.ts
@@ -1,3 +1,4 @@
+// Ollama plugin module implements model id behavior.
 import { normalizeProviderId } from "openclaw/plugin-sdk/provider-model-shared";
 import { uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 
diff --git a/extensions/ollama/src/ollama-json.ts b/extensions/ollama/src/ollama-json.ts
index 036c154d7264..ad988d216df6 100644
--- a/extensions/ollama/src/ollama-json.ts
+++ b/extensions/ollama/src/ollama-json.ts
@@ -1,3 +1,4 @@
+// Ollama plugin module implements ollama json behavior.
 export {
   parseJsonObjectPreservingUnsafeIntegers,
   parseJsonPreservingUnsafeIntegers,
diff --git a/extensions/ollama/src/provider-base-url.test.ts b/extensions/ollama/src/provider-base-url.test.ts
index 51c812bfa8c5..5ce8ab81fbcd 100644
--- a/extensions/ollama/src/provider-base-url.test.ts
+++ b/extensions/ollama/src/provider-base-url.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover provider base url plugin behavior.
 import { describe, expect, it } from "vitest";
 import { readProviderBaseUrl } from "./provider-base-url.js";
 
diff --git a/extensions/ollama/src/provider-base-url.ts b/extensions/ollama/src/provider-base-url.ts
index 0d250cf05af2..a6b1507b8c1f 100644
--- a/extensions/ollama/src/provider-base-url.ts
+++ b/extensions/ollama/src/provider-base-url.ts
@@ -1,3 +1,4 @@
+// Ollama provider module implements model/runtime integration.
 import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared";
 
 export function readProviderBaseUrl(provider: ModelProviderConfig | undefined): string | undefined {
diff --git a/extensions/ollama/src/provider-models.ssrf.test.ts b/extensions/ollama/src/provider-models.ssrf.test.ts
index 6f64e6e62bac..ff41b1a7e3fb 100644
--- a/extensions/ollama/src/provider-models.ssrf.test.ts
+++ b/extensions/ollama/src/provider-models.ssrf.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover provider models.ssrf plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildOllamaBaseUrlSsrFPolicy } from "./provider-models.js";
 
diff --git a/extensions/ollama/src/provider-models.test.ts b/extensions/ollama/src/provider-models.test.ts
index 637ba1fcc2e7..7f047172ee05 100644
--- a/extensions/ollama/src/provider-models.test.ts
+++ b/extensions/ollama/src/provider-models.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover provider models plugin behavior.
 import { jsonResponse, requestBodyText, requestUrl } from "openclaw/plugin-sdk/test-env";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/ollama/src/provider-models.ts b/extensions/ollama/src/provider-models.ts
index 7be373f8251f..9631b127d977 100644
--- a/extensions/ollama/src/provider-models.ts
+++ b/extensions/ollama/src/provider-models.ts
@@ -1,3 +1,4 @@
+// Ollama provider module implements model/runtime integration.
 import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared";
 import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-onboard";
 import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime";
diff --git a/extensions/ollama/src/sanitizers/kimi-inline-reasoning.ts b/extensions/ollama/src/sanitizers/kimi-inline-reasoning.ts
index 1ae5efb710a2..e870d1b76c2b 100644
--- a/extensions/ollama/src/sanitizers/kimi-inline-reasoning.ts
+++ b/extensions/ollama/src/sanitizers/kimi-inline-reasoning.ts
@@ -1,3 +1,4 @@
+// Ollama plugin module implements kimi inline reasoning behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type {
   OllamaVisibleContentSanitizer,
diff --git a/extensions/ollama/src/sanitizers/visible-content-contract.ts b/extensions/ollama/src/sanitizers/visible-content-contract.ts
index 4d8bc42edbbd..5cf33e28f392 100644
--- a/extensions/ollama/src/sanitizers/visible-content-contract.ts
+++ b/extensions/ollama/src/sanitizers/visible-content-contract.ts
@@ -1,3 +1,4 @@
+// Ollama plugin module implements visible content contract behavior.
 export type OllamaVisibleContentStreamResolution =
   | { kind: "visible"; text: string }
   | { kind: "pending" };
diff --git a/extensions/ollama/src/sanitizers/visible-content.ts b/extensions/ollama/src/sanitizers/visible-content.ts
index 3495de325e27..4cb8a7aacd62 100644
--- a/extensions/ollama/src/sanitizers/visible-content.ts
+++ b/extensions/ollama/src/sanitizers/visible-content.ts
@@ -1,3 +1,4 @@
+// Ollama plugin module implements visible content behavior.
 import {
   createKimiInlineReasoningSanitizer,
   isOllamaCloudKimiModelRef,
diff --git a/extensions/ollama/src/setup.test.ts b/extensions/ollama/src/setup.test.ts
index e5d4938b4040..472c41cbe795 100644
--- a/extensions/ollama/src/setup.test.ts
+++ b/extensions/ollama/src/setup.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover setup plugin behavior.
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
 import type { WizardPrompter } from "openclaw/plugin-sdk/setup";
 import { jsonResponse, requestBodyText, requestUrl } from "openclaw/plugin-sdk/test-env";
diff --git a/extensions/ollama/src/setup.ts b/extensions/ollama/src/setup.ts
index 2d2a1e447045..182f1dda6dd9 100644
--- a/extensions/ollama/src/setup.ts
+++ b/extensions/ollama/src/setup.ts
@@ -1,3 +1,4 @@
+// Ollama setup module handles plugin onboarding behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import type {
   OpenClawConfig,
diff --git a/extensions/ollama/src/stream-runtime.test.ts b/extensions/ollama/src/stream-runtime.test.ts
index 47985afb4dca..7ed081599f75 100644
--- a/extensions/ollama/src/stream-runtime.test.ts
+++ b/extensions/ollama/src/stream-runtime.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover stream runtime plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 const { fetchWithSsrFGuardMock } = vi.hoisted(() => ({
diff --git a/extensions/ollama/src/stream.test.ts b/extensions/ollama/src/stream.test.ts
index fe7c8fab91d7..8325efdec733 100644
--- a/extensions/ollama/src/stream.test.ts
+++ b/extensions/ollama/src/stream.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover stream plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
 const { fetchWithSsrFGuardMock } = vi.hoisted(() => ({
diff --git a/extensions/ollama/src/stream.ts b/extensions/ollama/src/stream.ts
index d376f654a586..4161aec3337d 100644
--- a/extensions/ollama/src/stream.ts
+++ b/extensions/ollama/src/stream.ts
@@ -1,3 +1,4 @@
+// Ollama plugin module implements stream behavior.
 import { randomUUID } from "node:crypto";
 import type { StreamFn } from "openclaw/plugin-sdk/agent-core";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
diff --git a/extensions/ollama/src/web-search-provider.test.ts b/extensions/ollama/src/web-search-provider.test.ts
index e0fab798a117..7b98109276dc 100644
--- a/extensions/ollama/src/web-search-provider.test.ts
+++ b/extensions/ollama/src/web-search-provider.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover web search provider plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createOllamaWebSearchProvider as createContractOllamaWebSearchProvider } from "../web-search-contract-api.js";
diff --git a/extensions/ollama/src/web-search-provider.ts b/extensions/ollama/src/web-search-provider.ts
index 9d28cf308f6c..1ef4ca8be3a8 100644
--- a/extensions/ollama/src/web-search-provider.ts
+++ b/extensions/ollama/src/web-search-provider.ts
@@ -1,3 +1,4 @@
+// Ollama provider module implements model/runtime integration.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   isNonSecretApiKeyMarker,
diff --git a/extensions/ollama/src/wsl2-crash-loop-check.test.ts b/extensions/ollama/src/wsl2-crash-loop-check.test.ts
index 02d8a41116f1..593029b76bb2 100644
--- a/extensions/ollama/src/wsl2-crash-loop-check.test.ts
+++ b/extensions/ollama/src/wsl2-crash-loop-check.test.ts
@@ -1,3 +1,4 @@
+// Ollama tests cover wsl2 crash loop check plugin behavior.
 import { promisify } from "node:util";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/ollama/src/wsl2-crash-loop-check.ts b/extensions/ollama/src/wsl2-crash-loop-check.ts
index 809dd8b75b2a..de26779fd7f7 100644
--- a/extensions/ollama/src/wsl2-crash-loop-check.ts
+++ b/extensions/ollama/src/wsl2-crash-loop-check.ts
@@ -1,3 +1,4 @@
+// Ollama plugin module implements wsl2 crash loop check behavior.
 import { execFile } from "node:child_process";
 import { access } from "node:fs/promises";
 import { promisify } from "node:util";
diff --git a/extensions/ollama/web-search-contract-api.ts b/extensions/ollama/web-search-contract-api.ts
index 1fafbe0ca31c..aa66bde8a7c0 100644
--- a/extensions/ollama/web-search-contract-api.ts
+++ b/extensions/ollama/web-search-contract-api.ts
@@ -1,3 +1,4 @@
+// Ollama API module exposes the plugin public contract.
 import {
   createWebSearchProviderContractFields,
   type WebSearchProviderPlugin,
diff --git a/extensions/ollama/web-search-provider.ts b/extensions/ollama/web-search-provider.ts
index f92a70a06b6c..2856cbff0ae3 100644
--- a/extensions/ollama/web-search-provider.ts
+++ b/extensions/ollama/web-search-provider.ts
@@ -1 +1,2 @@
+// Ollama provider module implements model/runtime integration.
 export { createOllamaWebSearchProvider } from "./src/web-search-provider.js";
diff --git a/extensions/openai/api.ts b/extensions/openai/api.ts
index dcad31fbdf0f..df44af586d72 100644
--- a/extensions/openai/api.ts
+++ b/extensions/openai/api.ts
@@ -1,3 +1,4 @@
+// Openai API module exposes the plugin public contract.
 export {
   applyOpenAIConfig,
   applyOpenAIProviderConfig,
diff --git a/extensions/openai/auth-choice-copy.ts b/extensions/openai/auth-choice-copy.ts
index bfcf049ccc5f..ca2ab9bc304c 100644
--- a/extensions/openai/auth-choice-copy.ts
+++ b/extensions/openai/auth-choice-copy.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements auth choice copy behavior.
 export const OPENAI_API_KEY_LABEL = "OpenAI API Key";
 export const OPENAI_CHATGPT_LOGIN_LABEL = "ChatGPT Login";
 export const OPENAI_CHATGPT_LOGIN_HINT = "Sign in with your ChatGPT or Codex subscription";
diff --git a/extensions/openai/base-url.test.ts b/extensions/openai/base-url.test.ts
index de0b41464e24..bc346dee214c 100644
--- a/extensions/openai/base-url.test.ts
+++ b/extensions/openai/base-url.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover base url plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   canonicalizeCodexResponsesBaseUrl,
diff --git a/extensions/openai/base-url.ts b/extensions/openai/base-url.ts
index 346653eb18a9..be96c537b94a 100644
--- a/extensions/openai/base-url.ts
+++ b/extensions/openai/base-url.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements base url behavior.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 export const OPENAI_CODEX_RESPONSES_BASE_URL = "https://chatgpt.com/backend-api/codex";
diff --git a/extensions/openai/default-models.test.ts b/extensions/openai/default-models.test.ts
index a30fbe41ce55..68a2bbc6ca0b 100644
--- a/extensions/openai/default-models.test.ts
+++ b/extensions/openai/default-models.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover default models plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/provider-onboard";
 import { describe, expect, it } from "vitest";
 import { applyOpenAIConfig, applyOpenAIProviderConfig, OPENAI_DEFAULT_MODEL } from "./api.js";
diff --git a/extensions/openai/default-models.ts b/extensions/openai/default-models.ts
index 8f26af038a00..a7b1bb1f755a 100644
--- a/extensions/openai/default-models.ts
+++ b/extensions/openai/default-models.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements default models behavior.
 import { ensureModelAllowlistEntry } from "openclaw/plugin-sdk/provider-onboard";
 import {
   applyAgentDefaultModelPrimary,
diff --git a/extensions/openai/embedding-batch.test.ts b/extensions/openai/embedding-batch.test.ts
index 7dacf1310ae7..5c26a8396daf 100644
--- a/extensions/openai/embedding-batch.test.ts
+++ b/extensions/openai/embedding-batch.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover embedding batch plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseOpenAiBatchOutput } from "./embedding-batch.js";
 
diff --git a/extensions/openai/embedding-batch.ts b/extensions/openai/embedding-batch.ts
index 6c1e136ea2ad..5588cd97d1c0 100644
--- a/extensions/openai/embedding-batch.ts
+++ b/extensions/openai/embedding-batch.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements embedding batch behavior.
 import {
   applyEmbeddingBatchOutputLine,
   buildBatchHeaders,
diff --git a/extensions/openai/embedding-provider.test.ts b/extensions/openai/embedding-provider.test.ts
index 92a6e33838f7..c13d346d8065 100644
--- a/extensions/openai/embedding-provider.test.ts
+++ b/extensions/openai/embedding-provider.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover embedding provider plugin behavior.
 import type { MemoryEmbeddingProviderCreateOptions } from "openclaw/plugin-sdk/memory-core-host-engine-embeddings";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/openai/embedding-provider.ts b/extensions/openai/embedding-provider.ts
index 19c0da28109f..904ecf79204c 100644
--- a/extensions/openai/embedding-provider.ts
+++ b/extensions/openai/embedding-provider.ts
@@ -1,3 +1,4 @@
+// Openai provider module implements model/runtime integration.
 import {
   fetchRemoteEmbeddingVectors,
   resolveRemoteEmbeddingClient,
diff --git a/extensions/openai/image-generation-provider.test.ts b/extensions/openai/image-generation-provider.test.ts
index 657810d937cf..104aac4c1c61 100644
--- a/extensions/openai/image-generation-provider.test.ts
+++ b/extensions/openai/image-generation-provider.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover image generation provider plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { buildOpenAIImageGenerationProvider } from "./image-generation-provider.js";
 
diff --git a/extensions/openai/image-generation-provider.ts b/extensions/openai/image-generation-provider.ts
index e28fdcb9e217..4b0e64bd66c7 100644
--- a/extensions/openai/image-generation-provider.ts
+++ b/extensions/openai/image-generation-provider.ts
@@ -1,3 +1,4 @@
+// Openai provider module implements model/runtime integration.
 import path from "node:path";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type {
diff --git a/extensions/openai/index.test.ts b/extensions/openai/index.test.ts
index aca69a34247f..56ccd0edf3a7 100644
--- a/extensions/openai/index.test.ts
+++ b/extensions/openai/index.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover index plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
 import { requireRegisteredProvider } from "openclaw/plugin-sdk/plugin-test-runtime";
diff --git a/extensions/openai/index.ts b/extensions/openai/index.ts
index 6f10c81b3efd..b1a34b687b8b 100644
--- a/extensions/openai/index.ts
+++ b/extensions/openai/index.ts
@@ -1,3 +1,4 @@
+// Openai plugin entrypoint registers its OpenClaw integration.
 import { resolvePluginConfigObject } from "openclaw/plugin-sdk/plugin-config-runtime";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { buildProviderToolCompatFamilyHooks } from "openclaw/plugin-sdk/provider-tools";
diff --git a/extensions/openai/media-understanding-provider.test.ts b/extensions/openai/media-understanding-provider.test.ts
index e6c156b5812d..c501c83aaaa9 100644
--- a/extensions/openai/media-understanding-provider.test.ts
+++ b/extensions/openai/media-understanding-provider.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover media understanding provider plugin behavior.
 import {
   createAuthCaptureJsonFetch,
   createRequestCaptureJsonFetch,
diff --git a/extensions/openai/media-understanding-provider.ts b/extensions/openai/media-understanding-provider.ts
index 86e705377598..c8e702b0725c 100644
--- a/extensions/openai/media-understanding-provider.ts
+++ b/extensions/openai/media-understanding-provider.ts
@@ -1,3 +1,4 @@
+// Openai provider module implements model/runtime integration.
 import {
   describeImageWithModel,
   describeImagesWithModel,
diff --git a/extensions/openai/memory-embedding-adapter.test.ts b/extensions/openai/memory-embedding-adapter.test.ts
index 23a2c54f51a7..2e0f40c8896e 100644
--- a/extensions/openai/memory-embedding-adapter.test.ts
+++ b/extensions/openai/memory-embedding-adapter.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover memory embedding adapter plugin behavior.
 import type { MemoryEmbeddingProvider } from "openclaw/plugin-sdk/memory-core-host-engine-embeddings";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/openai/memory-embedding-adapter.ts b/extensions/openai/memory-embedding-adapter.ts
index 867e97d01a79..401a740f0b4b 100644
--- a/extensions/openai/memory-embedding-adapter.ts
+++ b/extensions/openai/memory-embedding-adapter.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements memory embedding adapter behavior.
 import {
   isMissingEmbeddingApiKeyError,
   mapBatchEmbeddingsByIndex,
diff --git a/extensions/openai/native-web-search.ts b/extensions/openai/native-web-search.ts
index 56a7b699fea6..8b6622866bba 100644
--- a/extensions/openai/native-web-search.ts
+++ b/extensions/openai/native-web-search.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements native web search behavior.
 import type { StreamFn } from "openclaw/plugin-sdk/agent-core";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { streamSimple } from "openclaw/plugin-sdk/llm";
diff --git a/extensions/openai/openai-chatgpt-auth-identity.test.ts b/extensions/openai/openai-chatgpt-auth-identity.test.ts
index 12290d8cfe77..8c73e4e4729e 100644
--- a/extensions/openai/openai-chatgpt-auth-identity.test.ts
+++ b/extensions/openai/openai-chatgpt-auth-identity.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover openai chatgpt auth identity plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveCodexAuthIdentity } from "./openai-chatgpt-auth-identity.js";
 
diff --git a/extensions/openai/openai-chatgpt-auth-identity.ts b/extensions/openai/openai-chatgpt-auth-identity.ts
index e5e0c510b293..5208a102c066 100644
--- a/extensions/openai/openai-chatgpt-auth-identity.ts
+++ b/extensions/openai/openai-chatgpt-auth-identity.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements openai chatgpt auth identity behavior.
 import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
 import { trimNonEmptyString } from "./openai-chatgpt-shared.js";
 
diff --git a/extensions/openai/openai-chatgpt-catalog.ts b/extensions/openai/openai-chatgpt-catalog.ts
index a88b6c2d47ed..c95d00093f5c 100644
--- a/extensions/openai/openai-chatgpt-catalog.ts
+++ b/extensions/openai/openai-chatgpt-catalog.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements openai chatgpt catalog behavior.
 import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared";
 import { OPENAI_CODEX_RESPONSES_BASE_URL } from "./base-url.js";
 
diff --git a/extensions/openai/openai-chatgpt-device-code.test.ts b/extensions/openai/openai-chatgpt-device-code.test.ts
index 7d14c6091e44..63c1105c3bb4 100644
--- a/extensions/openai/openai-chatgpt-device-code.test.ts
+++ b/extensions/openai/openai-chatgpt-device-code.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover openai chatgpt device code plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { resolveCodexAccessTokenExpiry } from "./openai-chatgpt-auth-identity.js";
 import { loginOpenAICodexDeviceCode } from "./openai-chatgpt-device-code.js";
diff --git a/extensions/openai/openai-chatgpt-device-code.ts b/extensions/openai/openai-chatgpt-device-code.ts
index 095f73f5b991..fc6224810bd1 100644
--- a/extensions/openai/openai-chatgpt-device-code.ts
+++ b/extensions/openai/openai-chatgpt-device-code.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements openai chatgpt device code behavior.
 import {
   positiveSecondsToSafeMilliseconds,
   resolveExpiresAtMsFromDurationSeconds,
diff --git a/extensions/openai/openai-chatgpt-oauth-abort.runtime.ts b/extensions/openai/openai-chatgpt-oauth-abort.runtime.ts
index c3b1f0512972..11fc1e92ea02 100644
--- a/extensions/openai/openai-chatgpt-oauth-abort.runtime.ts
+++ b/extensions/openai/openai-chatgpt-oauth-abort.runtime.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements openai chatgpt oauth abort behavior.
 export {
   buildOAuthRequestSignal,
   createOAuthLoginCancelledError,
diff --git a/extensions/openai/openai-chatgpt-oauth-flow.runtime.test.ts b/extensions/openai/openai-chatgpt-oauth-flow.runtime.test.ts
index aeee18ff5dbd..5624f0bfa9fb 100644
--- a/extensions/openai/openai-chatgpt-oauth-flow.runtime.test.ts
+++ b/extensions/openai/openai-chatgpt-oauth-flow.runtime.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover openai chatgpt oauth flow plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 const ssrfMocks = vi.hoisted(() => ({
diff --git a/extensions/openai/openai-chatgpt-oauth-page.runtime.ts b/extensions/openai/openai-chatgpt-oauth-page.runtime.ts
index b83966d9e900..033fe00dc814 100644
--- a/extensions/openai/openai-chatgpt-oauth-page.runtime.ts
+++ b/extensions/openai/openai-chatgpt-oauth-page.runtime.ts
@@ -1 +1,2 @@
+// Openai plugin module implements openai chatgpt oauth page behavior.
 export { oauthErrorHtml, oauthSuccessHtml } from "openclaw/plugin-sdk/provider-oauth-runtime";
diff --git a/extensions/openai/openai-chatgpt-oauth-types.runtime.ts b/extensions/openai/openai-chatgpt-oauth-types.runtime.ts
index fd82e087e068..1847eb1ec603 100644
--- a/extensions/openai/openai-chatgpt-oauth-types.runtime.ts
+++ b/extensions/openai/openai-chatgpt-oauth-types.runtime.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements openai chatgpt oauth types behavior.
 export type {
   OAuthAuthInfo,
   OAuthCredentials,
diff --git a/extensions/openai/openai-chatgpt-oauth.runtime.test.ts b/extensions/openai/openai-chatgpt-oauth.runtime.test.ts
index 7d8392fa671a..b48a923c6bc8 100644
--- a/extensions/openai/openai-chatgpt-oauth.runtime.test.ts
+++ b/extensions/openai/openai-chatgpt-oauth.runtime.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover openai chatgpt oauth plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { testing } from "./openai-chatgpt-oauth.runtime.js";
diff --git a/extensions/openai/openai-chatgpt-oauth.runtime.ts b/extensions/openai/openai-chatgpt-oauth.runtime.ts
index 04f8b2205c28..b73c476cf817 100644
--- a/extensions/openai/openai-chatgpt-oauth.runtime.ts
+++ b/extensions/openai/openai-chatgpt-oauth.runtime.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements openai chatgpt oauth behavior.
 import path from "node:path";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
diff --git a/extensions/openai/openai-chatgpt-pkce.runtime.ts b/extensions/openai/openai-chatgpt-pkce.runtime.ts
index 3251d84287b2..c34b8d6bcb8e 100644
--- a/extensions/openai/openai-chatgpt-pkce.runtime.ts
+++ b/extensions/openai/openai-chatgpt-pkce.runtime.ts
@@ -1 +1,2 @@
+// Openai plugin module implements openai chatgpt pkce behavior.
 export { generateOAuthState, generatePKCE } from "openclaw/plugin-sdk/provider-oauth-runtime";
diff --git a/extensions/openai/openai-chatgpt-provider.runtime.ts b/extensions/openai/openai-chatgpt-provider.runtime.ts
index 3579a703a3db..24815fefce25 100644
--- a/extensions/openai/openai-chatgpt-provider.runtime.ts
+++ b/extensions/openai/openai-chatgpt-provider.runtime.ts
@@ -1,3 +1,4 @@
+// Openai provider module implements model/runtime integration.
 import { ensureGlobalUndiciEnvProxyDispatcher } from "openclaw/plugin-sdk/runtime-env";
 import { refreshOpenAICodexToken as refreshOpenAICodexTokenFromFlow } from "./openai-chatgpt-oauth-flow.runtime.js";
 import type { OAuthCredentials } from "./openai-chatgpt-oauth-types.runtime.js";
diff --git a/extensions/openai/openai-chatgpt-provider.test.ts b/extensions/openai/openai-chatgpt-provider.test.ts
index 41f7bb357537..94b821384461 100644
--- a/extensions/openai/openai-chatgpt-provider.test.ts
+++ b/extensions/openai/openai-chatgpt-provider.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover openai chatgpt provider plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const refreshOpenAICodexTokenMock = vi.hoisted(() => vi.fn());
diff --git a/extensions/openai/openai-chatgpt-provider.ts b/extensions/openai/openai-chatgpt-provider.ts
index 861dd72012be..5af958a26b35 100644
--- a/extensions/openai/openai-chatgpt-provider.ts
+++ b/extensions/openai/openai-chatgpt-provider.ts
@@ -1,3 +1,4 @@
+// Openai provider module implements model/runtime integration.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import type {
   ProviderAuthContext,
diff --git a/extensions/openai/openai-chatgpt-shared.ts b/extensions/openai/openai-chatgpt-shared.ts
index c68cd763ff47..12fbb89dad30 100644
--- a/extensions/openai/openai-chatgpt-shared.ts
+++ b/extensions/openai/openai-chatgpt-shared.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements openai chatgpt shared behavior.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 export const trimNonEmptyString = normalizeOptionalString;
diff --git a/extensions/openai/openai-provider.live.test.ts b/extensions/openai/openai-provider.live.test.ts
index ff0d5eb84aa1..836ae21ce0ed 100644
--- a/extensions/openai/openai-provider.live.test.ts
+++ b/extensions/openai/openai-provider.live.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover openai provider plugin behavior.
 import OpenAI from "openai";
 import type { ProviderRuntimeModel } from "openclaw/plugin-sdk/plugin-entry";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/openai/openai-provider.test.ts b/extensions/openai/openai-provider.test.ts
index d78703bf1060..1731cd9c2bd7 100644
--- a/extensions/openai/openai-provider.test.ts
+++ b/extensions/openai/openai-provider.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover openai provider plugin behavior.
 import type { StreamFn } from "openclaw/plugin-sdk/agent-core";
 import type { Context, Model, SimpleStreamOptions } from "openclaw/plugin-sdk/llm";
 import { beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/openai/openai-provider.ts b/extensions/openai/openai-provider.ts
index 6596d9cb4fd3..f04ae009c87b 100644
--- a/extensions/openai/openai-provider.ts
+++ b/extensions/openai/openai-provider.ts
@@ -1,3 +1,4 @@
+// Openai provider module implements model/runtime integration.
 import type {
   ProviderResolveDynamicModelContext,
   ProviderRuntimeModel,
diff --git a/extensions/openai/openai-tts.live.test.ts b/extensions/openai/openai-tts.live.test.ts
index 1870b604f51f..25dca5d9637b 100644
--- a/extensions/openai/openai-tts.live.test.ts
+++ b/extensions/openai/openai-tts.live.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover openai tts plugin behavior.
 import { isLiveTestEnabled } from "openclaw/plugin-sdk/test-env";
 import { describe, expect, it } from "vitest";
 import { buildOpenAISpeechProvider } from "./speech-provider.js";
diff --git a/extensions/openai/openai.live.test.ts b/extensions/openai/openai.live.test.ts
index 58ee30b5cc0e..5dcfcdfb9bd2 100644
--- a/extensions/openai/openai.live.test.ts
+++ b/extensions/openai/openai.live.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover openai plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/openai/openclaw.plugin.test.ts b/extensions/openai/openclaw.plugin.test.ts
index 80c04fc9647b..9795630c05b5 100644
--- a/extensions/openai/openclaw.plugin.test.ts
+++ b/extensions/openai/openclaw.plugin.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover openclaw.plugin plugin behavior.
 import { readFileSync } from "node:fs";
 import { describe, expect, it } from "vitest";
 import { buildOpenAIProvider } from "./openai-provider.js";
diff --git a/extensions/openai/prompt-overlay.ts b/extensions/openai/prompt-overlay.ts
index 06d8747d879f..1bc115762d22 100644
--- a/extensions/openai/prompt-overlay.ts
+++ b/extensions/openai/prompt-overlay.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements prompt overlay behavior.
 import {
   GPT5_BEHAVIOR_CONTRACT,
   GPT5_FRIENDLY_CHAT_PROMPT_OVERLAY,
diff --git a/extensions/openai/provider-auth.contract.test.ts b/extensions/openai/provider-auth.contract.test.ts
index d7cad26df84c..382748e368e2 100644
--- a/extensions/openai/provider-auth.contract.test.ts
+++ b/extensions/openai/provider-auth.contract.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover provider auth.contract plugin behavior.
 import { describeOpenAICodexProviderAuthContract } from "openclaw/plugin-sdk/provider-test-contracts";
 import { vi } from "vitest";
 
diff --git a/extensions/openai/provider-catalog.contract.test.ts b/extensions/openai/provider-catalog.contract.test.ts
index 4342f65bb15d..65bf7300703a 100644
--- a/extensions/openai/provider-catalog.contract.test.ts
+++ b/extensions/openai/provider-catalog.contract.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover provider catalog.contract plugin behavior.
 import { describeOpenAIProviderCatalogContract } from "./test-support/provider-catalog.contract-test-support.js";
 
 describeOpenAIProviderCatalogContract();
diff --git a/extensions/openai/provider-contract-api.ts b/extensions/openai/provider-contract-api.ts
index b9a7e4dce7ca..e64f61079a39 100644
--- a/extensions/openai/provider-contract-api.ts
+++ b/extensions/openai/provider-contract-api.ts
@@ -1,3 +1,4 @@
+// Openai API module exposes the plugin public contract.
 import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared";
 import {
   OPENAI_ACCOUNT_WIZARD_GROUP,
diff --git a/extensions/openai/provider-policy-api.test.ts b/extensions/openai/provider-policy-api.test.ts
index 839157b03d83..53b8c038d7bc 100644
--- a/extensions/openai/provider-policy-api.test.ts
+++ b/extensions/openai/provider-policy-api.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover provider policy api plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveThinkingProfile } from "./provider-policy-api.js";
 
diff --git a/extensions/openai/provider-policy-api.ts b/extensions/openai/provider-policy-api.ts
index 1531260d2de5..43694a9d78cb 100644
--- a/extensions/openai/provider-policy-api.ts
+++ b/extensions/openai/provider-policy-api.ts
@@ -1,3 +1,4 @@
+// Openai API module exposes the plugin public contract.
 import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-types";
 import { resolveUnifiedOpenAIThinkingProfile } from "./thinking-policy.js";
 
diff --git a/extensions/openai/provider-runtime.contract.test.ts b/extensions/openai/provider-runtime.contract.test.ts
index 35ea4cc5904c..2f2071957081 100644
--- a/extensions/openai/provider-runtime.contract.test.ts
+++ b/extensions/openai/provider-runtime.contract.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover provider runtime.contract plugin behavior.
 import { describeOpenAIProviderRuntimeContract } from "openclaw/plugin-sdk/provider-test-contracts";
 
 describeOpenAIProviderRuntimeContract(() => import("./index.js"));
diff --git a/extensions/openai/realtime-provider-shared.ts b/extensions/openai/realtime-provider-shared.ts
index bea1aae55d91..0a3303352cba 100644
--- a/extensions/openai/realtime-provider-shared.ts
+++ b/extensions/openai/realtime-provider-shared.ts
@@ -1,3 +1,4 @@
+// Openai provider module implements model/runtime integration.
 import { resolveExpiresAtMsFromEpochSeconds } from "openclaw/plugin-sdk/number-runtime";
 import {
   createProviderHttpError,
diff --git a/extensions/openai/realtime-transcription-provider.test.ts b/extensions/openai/realtime-transcription-provider.test.ts
index ab7da104004f..3db9bd109806 100644
--- a/extensions/openai/realtime-transcription-provider.test.ts
+++ b/extensions/openai/realtime-transcription-provider.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover realtime transcription provider plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { buildOpenAIRealtimeTranscriptionProvider } from "./realtime-transcription-provider.js";
 
diff --git a/extensions/openai/realtime-transcription-provider.ts b/extensions/openai/realtime-transcription-provider.ts
index 9e319aae579b..6de735bdd957 100644
--- a/extensions/openai/realtime-transcription-provider.ts
+++ b/extensions/openai/realtime-transcription-provider.ts
@@ -1,3 +1,4 @@
+// Openai provider module implements model/runtime integration.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   isProviderAuthProfileConfigured,
diff --git a/extensions/openai/realtime-voice-provider.test.ts b/extensions/openai/realtime-voice-provider.test.ts
index 54e60b9c27d6..3204b272e567 100644
--- a/extensions/openai/realtime-voice-provider.test.ts
+++ b/extensions/openai/realtime-voice-provider.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover realtime voice provider plugin behavior.
 import { REALTIME_VOICE_AUDIO_FORMAT_PCM16_24KHZ } from "openclaw/plugin-sdk/realtime-voice";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { buildOpenAIRealtimeVoiceProvider } from "./realtime-voice-provider.js";
diff --git a/extensions/openai/realtime-voice-provider.ts b/extensions/openai/realtime-voice-provider.ts
index 9bce483ee012..498c1ff960da 100644
--- a/extensions/openai/realtime-voice-provider.ts
+++ b/extensions/openai/realtime-voice-provider.ts
@@ -1,3 +1,4 @@
+// Openai provider module implements model/runtime integration.
 import { execFileSync } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import {
diff --git a/extensions/openai/register.runtime.ts b/extensions/openai/register.runtime.ts
index 483dedc6e1b5..9568940d20ee 100644
--- a/extensions/openai/register.runtime.ts
+++ b/extensions/openai/register.runtime.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements register behavior.
 export { buildOpenAIImageGenerationProvider } from "./image-generation-provider.js";
 export { openaiMediaUnderstandingProvider } from "./media-understanding-provider.js";
 export { buildOpenAIProvider } from "./openai-provider.js";
diff --git a/extensions/openai/replay-policy.ts b/extensions/openai/replay-policy.ts
index ab4ed523c870..82fddf5b0810 100644
--- a/extensions/openai/replay-policy.ts
+++ b/extensions/openai/replay-policy.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements replay policy behavior.
 import type {
   ProviderReplayPolicy,
   ProviderReplayPolicyContext,
diff --git a/extensions/openai/setup-api.test.ts b/extensions/openai/setup-api.test.ts
index c9dd14333698..eeb3d52a3171 100644
--- a/extensions/openai/setup-api.test.ts
+++ b/extensions/openai/setup-api.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover setup api plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildOpenAISetupProvider } from "./setup-api.js";
 
diff --git a/extensions/openai/setup-api.ts b/extensions/openai/setup-api.ts
index 5854838e571e..33700f4e9d5b 100644
--- a/extensions/openai/setup-api.ts
+++ b/extensions/openai/setup-api.ts
@@ -1,3 +1,4 @@
+// Openai API module exposes the plugin public contract.
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import type { ProviderAuthContext, ProviderAuthResult } from "openclaw/plugin-sdk/plugin-entry";
 import type { ProviderAuthMethod } from "openclaw/plugin-sdk/plugin-entry";
diff --git a/extensions/openai/shared.ts b/extensions/openai/shared.ts
index d7995818f202..e1a6b2009097 100644
--- a/extensions/openai/shared.ts
+++ b/extensions/openai/shared.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements shared behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { findCatalogTemplate } from "openclaw/plugin-sdk/provider-catalog-shared";
 import {
diff --git a/extensions/openai/speech-provider.test.ts b/extensions/openai/speech-provider.test.ts
index ca05d5739ef3..7b71e456a548 100644
--- a/extensions/openai/speech-provider.test.ts
+++ b/extensions/openai/speech-provider.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover speech provider plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { buildOpenAISpeechProvider } from "./speech-provider.js";
 
diff --git a/extensions/openai/speech-provider.ts b/extensions/openai/speech-provider.ts
index 269d2b73c240..b2e07dd981ac 100644
--- a/extensions/openai/speech-provider.ts
+++ b/extensions/openai/speech-provider.ts
@@ -1,3 +1,4 @@
+// Openai provider module implements model/runtime integration.
 import { normalizeResolvedSecretInputString } from "openclaw/plugin-sdk/secret-input";
 import type {
   SpeechDirectiveTokenParseContext,
diff --git a/extensions/openai/test-api.ts b/extensions/openai/test-api.ts
index 434036a149c5..9471b5333ee4 100644
--- a/extensions/openai/test-api.ts
+++ b/extensions/openai/test-api.ts
@@ -1,3 +1,4 @@
+// Openai API module exposes the plugin public contract.
 export { buildOpenAIImageGenerationProvider } from "./image-generation-provider.js";
 export { openaiMediaUnderstandingProvider } from "./media-understanding-provider.js";
 export { buildOpenAIRealtimeTranscriptionProvider } from "./realtime-transcription-provider.js";
diff --git a/extensions/openai/test-support/provider-catalog.contract-test-support.ts b/extensions/openai/test-support/provider-catalog.contract-test-support.ts
index b3a417671e57..57a73140c2c7 100644
--- a/extensions/openai/test-support/provider-catalog.contract-test-support.ts
+++ b/extensions/openai/test-support/provider-catalog.contract-test-support.ts
@@ -1,3 +1,4 @@
+// Openai provider module implements model/runtime integration.
 import {
   registerProviderPlugin,
   requireRegisteredProvider,
diff --git a/extensions/openai/thinking-policy.ts b/extensions/openai/thinking-policy.ts
index 439f52a23738..3f53ebeb21d6 100644
--- a/extensions/openai/thinking-policy.ts
+++ b/extensions/openai/thinking-policy.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements thinking policy behavior.
 import type { ProviderThinkingProfile } from "openclaw/plugin-sdk/plugin-entry";
 
 const OPENAI_THINKING_BASE_LEVELS = [
diff --git a/extensions/openai/transport-policy.test.ts b/extensions/openai/transport-policy.test.ts
index 2182ad65e6de..940a8f57e13e 100644
--- a/extensions/openai/transport-policy.test.ts
+++ b/extensions/openai/transport-policy.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover transport policy plugin behavior.
 import type { ProviderRuntimeModel } from "openclaw/plugin-sdk/plugin-entry";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/openai/transport-policy.ts b/extensions/openai/transport-policy.ts
index a5558e6f76a2..0a6d0280a301 100644
--- a/extensions/openai/transport-policy.ts
+++ b/extensions/openai/transport-policy.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements transport policy behavior.
 import type {
   ProviderResolveTransportTurnStateContext,
   ProviderResolveWebSocketSessionPolicyContext,
diff --git a/extensions/openai/tts.test.ts b/extensions/openai/tts.test.ts
index ee037ddfcba7..758cddd08f93 100644
--- a/extensions/openai/tts.test.ts
+++ b/extensions/openai/tts.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover tts plugin behavior.
 import { mkdtempSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/openai/tts.ts b/extensions/openai/tts.ts
index d3b1a1039c89..acfa82a8fc18 100644
--- a/extensions/openai/tts.ts
+++ b/extensions/openai/tts.ts
@@ -1,3 +1,4 @@
+// Openai plugin module implements tts behavior.
 import {
   assertOkOrThrowProviderError,
   resolveProviderRequestHeaders,
diff --git a/extensions/openai/video-generation-provider.test.ts b/extensions/openai/video-generation-provider.test.ts
index 6c92ae91e58b..1fc7dab48a8f 100644
--- a/extensions/openai/video-generation-provider.test.ts
+++ b/extensions/openai/video-generation-provider.test.ts
@@ -1,3 +1,4 @@
+// Openai tests cover video generation provider plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/openai/video-generation-provider.ts b/extensions/openai/video-generation-provider.ts
index cc27821a13c4..88684631da44 100644
--- a/extensions/openai/video-generation-provider.ts
+++ b/extensions/openai/video-generation-provider.ts
@@ -1,3 +1,4 @@
+// Openai provider module implements model/runtime integration.
 import { extensionForMime } from "openclaw/plugin-sdk/media-mime";
 import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth";
 import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime";
diff --git a/extensions/qa-matrix/cli.runtime.ts b/extensions/qa-matrix/cli.runtime.ts
index 4959d167a37c..2cbf1c56d426 100644
--- a/extensions/qa-matrix/cli.runtime.ts
+++ b/extensions/qa-matrix/cli.runtime.ts
@@ -1 +1,2 @@
+// Qa Matrix plugin module implements cli behavior.
 export { runQaMatrixCommand } from "./src/cli.runtime.js";
diff --git a/extensions/qa-matrix/cli.ts b/extensions/qa-matrix/cli.ts
index 8bcc6de2457a..b474c36dc046 100644
--- a/extensions/qa-matrix/cli.ts
+++ b/extensions/qa-matrix/cli.ts
@@ -1 +1,2 @@
+// Qa Matrix plugin module implements cli behavior.
 export { qaRunnerCliRegistrations, registerMatrixQaCli } from "./src/cli.js";
diff --git a/extensions/qa-matrix/index.ts b/extensions/qa-matrix/index.ts
index f584ecb7ed65..d7fc07079042 100644
--- a/extensions/qa-matrix/index.ts
+++ b/extensions/qa-matrix/index.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin entrypoint registers its OpenClaw integration.
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 
 export default definePluginEntry({
diff --git a/extensions/qa-matrix/runtime-api.ts b/extensions/qa-matrix/runtime-api.ts
index 127fa5b033ed..cfc9a4a1cc2a 100644
--- a/extensions/qa-matrix/runtime-api.ts
+++ b/extensions/qa-matrix/runtime-api.ts
@@ -1 +1,2 @@
+// Qa Matrix API module exposes the plugin public contract.
 export { qaRunnerCliRegistrations } from "./cli.js";
diff --git a/extensions/qa-matrix/runtime.ts b/extensions/qa-matrix/runtime.ts
index 6e56bad14161..8f7e5de37ad0 100644
--- a/extensions/qa-matrix/runtime.ts
+++ b/extensions/qa-matrix/runtime.ts
@@ -1 +1,2 @@
+// Qa Matrix plugin module implements runtime behavior.
 export { runMatrixQaLive } from "./src/runners/contract/runtime.js";
diff --git a/extensions/qa-matrix/src/cli-paths.ts b/extensions/qa-matrix/src/cli-paths.ts
index 529527fdff68..8eb8f7ff44ea 100644
--- a/extensions/qa-matrix/src/cli-paths.ts
+++ b/extensions/qa-matrix/src/cli-paths.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements cli paths behavior.
 import path from "node:path";
 
 export function resolveRepoRelativeOutputDir(repoRoot: string, outputDir?: string) {
diff --git a/extensions/qa-matrix/src/cli.runtime.test.ts b/extensions/qa-matrix/src/cli.runtime.test.ts
index ea15e26083ba..96462664b9d9 100644
--- a/extensions/qa-matrix/src/cli.runtime.test.ts
+++ b/extensions/qa-matrix/src/cli.runtime.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover cli plugin behavior.
 import { mkdir, mkdtemp, readFile, rm } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/qa-matrix/src/cli.runtime.ts b/extensions/qa-matrix/src/cli.runtime.ts
index de9ee3c9c1bd..94efa8c3fe1b 100644
--- a/extensions/qa-matrix/src/cli.runtime.ts
+++ b/extensions/qa-matrix/src/cli.runtime.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements cli behavior.
 import {
   printLiveTransportQaArtifacts,
   startLiveTransportQaOutputTee,
diff --git a/extensions/qa-matrix/src/cli.test.ts b/extensions/qa-matrix/src/cli.test.ts
index dbb7f08b737e..b1ec495498a1 100644
--- a/extensions/qa-matrix/src/cli.test.ts
+++ b/extensions/qa-matrix/src/cli.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover cli plugin behavior.
 import { Command } from "commander";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/qa-matrix/src/cli.ts b/extensions/qa-matrix/src/cli.ts
index b81b83a06c72..f508773aa5b9 100644
--- a/extensions/qa-matrix/src/cli.ts
+++ b/extensions/qa-matrix/src/cli.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements cli behavior.
 import type { Command } from "commander";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import {
diff --git a/extensions/qa-matrix/src/docker-runtime.ts b/extensions/qa-matrix/src/docker-runtime.ts
index fcd1636c5372..a7ef72d4af5e 100644
--- a/extensions/qa-matrix/src/docker-runtime.ts
+++ b/extensions/qa-matrix/src/docker-runtime.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements docker runtime behavior.
 import {
   createQaDockerRuntime,
   type QaDockerFetchLike as FetchLike,
diff --git a/extensions/qa-matrix/src/run-config.test.ts b/extensions/qa-matrix/src/run-config.test.ts
index c7c6b45101a6..7d7a64829fd8 100644
--- a/extensions/qa-matrix/src/run-config.test.ts
+++ b/extensions/qa-matrix/src/run-config.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover run config plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeQaProviderMode } from "./run-config.js";
 
diff --git a/extensions/qa-matrix/src/run-config.ts b/extensions/qa-matrix/src/run-config.ts
index a7b8eedc653b..681d84c62429 100644
--- a/extensions/qa-matrix/src/run-config.ts
+++ b/extensions/qa-matrix/src/run-config.ts
@@ -1,3 +1,4 @@
+// Qa Matrix helper module supports run config behavior.
 export type QaProviderMode = "mock-openai" | "live-frontier";
 export type QaProviderModeInput = QaProviderMode | "live-openai";
 
diff --git a/extensions/qa-matrix/src/runners/contract/model-selection.test.ts b/extensions/qa-matrix/src/runners/contract/model-selection.test.ts
index 41cd1a19082e..a7c05b51e5b7 100644
--- a/extensions/qa-matrix/src/runners/contract/model-selection.test.ts
+++ b/extensions/qa-matrix/src/runners/contract/model-selection.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover model selection plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const loadQaRuntimeModule = vi.hoisted(() => vi.fn());
diff --git a/extensions/qa-matrix/src/runners/contract/model-selection.ts b/extensions/qa-matrix/src/runners/contract/model-selection.ts
index 4570a28486af..2cb107498d62 100644
--- a/extensions/qa-matrix/src/runners/contract/model-selection.ts
+++ b/extensions/qa-matrix/src/runners/contract/model-selection.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements model selection behavior.
 import { loadQaRuntimeModule } from "openclaw/plugin-sdk/qa-runner-runtime";
 import { normalizeQaProviderMode, type QaProviderModeInput } from "../../run-config.js";
 
diff --git a/extensions/qa-matrix/src/runners/contract/runtime.test.ts b/extensions/qa-matrix/src/runners/contract/runtime.test.ts
index ca612ba3faff..f674fc92f696 100644
--- a/extensions/qa-matrix/src/runners/contract/runtime.test.ts
+++ b/extensions/qa-matrix/src/runners/contract/runtime.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover runtime plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { renderQaMarkdownReport } from "openclaw/plugin-sdk/qa-runtime";
diff --git a/extensions/qa-matrix/src/runners/contract/runtime.ts b/extensions/qa-matrix/src/runners/contract/runtime.ts
index 3a9a5eb6fd20..39f00c107c66 100644
--- a/extensions/qa-matrix/src/runners/contract/runtime.ts
+++ b/extensions/qa-matrix/src/runners/contract/runtime.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements runtime behavior.
 import { randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-catalog.ts b/extensions/qa-matrix/src/runners/contract/scenario-catalog.ts
index b2d253ade7f6..19d5d350a67f 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-catalog.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-catalog.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario catalog behavior.
 import type { QaProviderModeInput } from "../../run-config.js";
 import {
   collectLiveTransportStandardScenarioCoverage,
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-media-fixtures.ts b/extensions/qa-matrix/src/runners/contract/scenario-media-fixtures.ts
index f86ec01c1bdd..f4b3f73af370 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-media-fixtures.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-media-fixtures.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario media fixtures behavior.
 export const MATRIX_QA_IMAGE_ATTACHMENT_FILENAME = "red-top-blue-bottom.png";
 
 type MatrixQaMediaTypeCoverageCase = {
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-allowbots.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-allowbots.ts
index ca228b10690f..271e3cb889a5 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-allowbots.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-allowbots.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime allowbots behavior.
 import { MATRIX_QA_BOT_DM_ROOM_KEY, resolveMatrixQaScenarioRoomId } from "./scenario-catalog.js";
 import {
   buildExactMarkerPrompt,
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-approval.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-approval.ts
index 6556754256a2..98065d6798b9 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-approval.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-approval.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime approval behavior.
 import { randomUUID } from "node:crypto";
 import { setTimeout as sleep } from "node:timers/promises";
 import { normalizeUniqueStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-cli.test.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-cli.test.ts
index 648a8ec944b4..727d720720bf 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-cli.test.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-cli.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover scenario runtime cli plugin behavior.
 import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { setTimeout as sleep } from "node:timers/promises";
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-cli.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-cli.ts
index 58fc8f5c5018..a6bc399963f3 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-cli.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-cli.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime cli behavior.
 import { spawn as startOpenClawCliProcess } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { existsSync } from "node:fs";
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-config.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-config.ts
index 257702d879ba..dbf3f450d390 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-config.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-config.ts
@@ -1,3 +1,4 @@
+// Qa Matrix helper module supports scenario runtime config behavior.
 import { readFile } from "node:fs/promises";
 import { replaceFileAtomic } from "openclaw/plugin-sdk/security-runtime";
 import { isRecord as isMatrixQaPlainRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-dm.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-dm.ts
index 92e40964f41c..643a9fac0231 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-dm.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-dm.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime dm behavior.
 import { randomUUID } from "node:crypto";
 import {
   MATRIX_QA_DRIVER_DM_ROOM_KEY,
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-e2ee-destructive.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-e2ee-destructive.ts
index d6fb6b65ba83..44bd1fdb6c75 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-e2ee-destructive.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-e2ee-destructive.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime e2ee destructive behavior.
 import { randomUUID } from "node:crypto";
 import { chmod, copyFile, mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-e2ee.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-e2ee.ts
index 71c39d1eac3b..deb2e7658b30 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-e2ee.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-e2ee.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime e2ee behavior.
 import { randomUUID } from "node:crypto";
 import { chmod, mkdir, mkdtemp, readFile, rm, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-edit.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-edit.ts
index 998539ca2741..2d5d6b86132b 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-edit.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-edit.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime edit behavior.
 import { randomUUID } from "node:crypto";
 import {
   assertNoSutReplyWindow,
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-media.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-media.ts
index 18c7a9f598d0..5dfdeb69f24f 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-media.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-media.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime media behavior.
 import type { MatrixQaObservedEvent } from "../../substrate/events.js";
 import { MATRIX_QA_MEDIA_ROOM_KEY, resolveMatrixQaScenarioRoomId } from "./scenario-catalog.js";
 import {
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-reaction.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-reaction.ts
index c661296b844d..414e719d793a 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-reaction.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-reaction.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime reaction behavior.
 import type { MatrixQaObservedEvent } from "../../substrate/events.js";
 import {
   advanceMatrixQaActorCursor,
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-restart.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-restart.ts
index 78ea0e8253ef..7e70bb880d18 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-restart.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-restart.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime restart behavior.
 import {
   MATRIX_QA_HOMESERVER_ROOM_KEY,
   MATRIX_QA_RESTART_ROOM_KEY,
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-room.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-room.ts
index 1c52f60f9f5f..8c73ab5d94fb 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-room.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-room.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime room behavior.
 import { randomUUID } from "node:crypto";
 import { writeFile } from "node:fs/promises";
 import path from "node:path";
@@ -950,7 +951,8 @@ async function runMatrixToolProgressScenario(
     });
   if (isFinalReply(preview.event)) {
     if (
-      (params.allowFinalBeforeProgress === true || params.allowTopLevelFinalWithProgress === true) &&
+      (params.allowFinalBeforeProgress === true ||
+        params.allowTopLevelFinalWithProgress === true) &&
       params.allowFinalOnly !== true
     ) {
       const progressAfterFinal = await client
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-shared.test.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-shared.test.ts
index 1b59318b3a83..20d6b3594d9f 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-shared.test.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-shared.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover scenario runtime shared plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { resolveMatrixQaNoReplyWindowMs } from "./scenario-runtime-shared.js";
 
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-shared.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-shared.ts
index 5e83b551b839..cb93a892dcc5 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-shared.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-shared.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime shared behavior.
 import { randomUUID } from "node:crypto";
 import { createMatrixQaClient, type MatrixQaRoomObserver } from "../../substrate/client.js";
 import type { MatrixQaObservedEvent } from "../../substrate/events.js";
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime-state-files.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime-state-files.ts
index 0cdd367a0f8a..5cc930cf8d39 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime-state-files.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime-state-files.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime state files behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-runtime.ts b/extensions/qa-matrix/src/runners/contract/scenario-runtime.ts
index 528b3daab115..2fe872751666 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-runtime.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-runtime.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario runtime behavior.
 import {
   MATRIX_QA_DRIVER_DM_ROOM_KEY,
   MATRIX_QA_SECONDARY_ROOM_KEY,
diff --git a/extensions/qa-matrix/src/runners/contract/scenario-types.ts b/extensions/qa-matrix/src/runners/contract/scenario-types.ts
index efbba7c55d50..0c4096163e3b 100644
--- a/extensions/qa-matrix/src/runners/contract/scenario-types.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenario-types.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenario types behavior.
 import type { MatrixQaObservedEvent } from "../../substrate/events.js";
 
 export type MatrixQaReplyArtifact = {
diff --git a/extensions/qa-matrix/src/runners/contract/scenarios.test.ts b/extensions/qa-matrix/src/runners/contract/scenarios.test.ts
index 7939f3f7d2b3..314630eab1a6 100644
--- a/extensions/qa-matrix/src/runners/contract/scenarios.test.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenarios.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover scenarios plugin behavior.
 import { createHash } from "node:crypto";
 import { mkdir, mkdtemp, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
 import os from "node:os";
diff --git a/extensions/qa-matrix/src/runners/contract/scenarios.ts b/extensions/qa-matrix/src/runners/contract/scenarios.ts
index 05a098e8f8cb..c37fe3daaf9d 100644
--- a/extensions/qa-matrix/src/runners/contract/scenarios.ts
+++ b/extensions/qa-matrix/src/runners/contract/scenarios.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements scenarios behavior.
 import {
   MATRIX_QA_BOT_DM_ROOM_KEY,
   MATRIX_QA_DRIVER_DM_ROOM_KEY,
diff --git a/extensions/qa-matrix/src/runtime-api.test.ts b/extensions/qa-matrix/src/runtime-api.test.ts
index 87a3796b68d4..a4a3d5ef79d4 100644
--- a/extensions/qa-matrix/src/runtime-api.test.ts
+++ b/extensions/qa-matrix/src/runtime-api.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover runtime api plugin behavior.
 import { describe, expect, it } from "vitest";
 
 describe("matrix qa runtime api surface", () => {
diff --git a/extensions/qa-matrix/src/shared/live-transport-cli.runtime.test.ts b/extensions/qa-matrix/src/shared/live-transport-cli.runtime.test.ts
index 893cd20d221b..887a46a0c0be 100644
--- a/extensions/qa-matrix/src/shared/live-transport-cli.runtime.test.ts
+++ b/extensions/qa-matrix/src/shared/live-transport-cli.runtime.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover live transport cli plugin behavior.
 import { mkdir, mkdtemp, readFile, rm } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/qa-matrix/src/shared/live-transport-cli.runtime.ts b/extensions/qa-matrix/src/shared/live-transport-cli.runtime.ts
index 1b88e484c5e1..ee2c1e52611f 100644
--- a/extensions/qa-matrix/src/shared/live-transport-cli.runtime.ts
+++ b/extensions/qa-matrix/src/shared/live-transport-cli.runtime.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements live transport cli behavior.
 import path from "node:path";
 import { resolveRepoRelativeOutputDir } from "../cli-paths.js";
 import type { QaProviderMode } from "../run-config.js";
diff --git a/extensions/qa-matrix/src/shared/live-transport-cli.ts b/extensions/qa-matrix/src/shared/live-transport-cli.ts
index 62b0abcb771b..929765fbe6bf 100644
--- a/extensions/qa-matrix/src/shared/live-transport-cli.ts
+++ b/extensions/qa-matrix/src/shared/live-transport-cli.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements live transport cli behavior.
 import {
   createLiveTransportQaCliRegistration as createSharedLiveTransportQaCliRegistration,
   type LiveTransportQaCliRegistrationOptions,
diff --git a/extensions/qa-matrix/src/shared/live-transport-scenarios.ts b/extensions/qa-matrix/src/shared/live-transport-scenarios.ts
index 38accb872893..2d9b189e6bb0 100644
--- a/extensions/qa-matrix/src/shared/live-transport-scenarios.ts
+++ b/extensions/qa-matrix/src/shared/live-transport-scenarios.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements live transport scenarios behavior.
 export {
   LIVE_TRANSPORT_BASELINE_STANDARD_SCENARIO_IDS,
   collectLiveTransportStandardScenarioCoverage,
diff --git a/extensions/qa-matrix/src/substrate/artifacts.test.ts b/extensions/qa-matrix/src/substrate/artifacts.test.ts
index 423f17252c0e..f99cc418d1bf 100644
--- a/extensions/qa-matrix/src/substrate/artifacts.test.ts
+++ b/extensions/qa-matrix/src/substrate/artifacts.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover artifacts plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildMatrixQaObservedEventsArtifact } from "./artifacts.js";
 
diff --git a/extensions/qa-matrix/src/substrate/artifacts.ts b/extensions/qa-matrix/src/substrate/artifacts.ts
index e4176db3b4fe..9883e53e8bec 100644
--- a/extensions/qa-matrix/src/substrate/artifacts.ts
+++ b/extensions/qa-matrix/src/substrate/artifacts.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements artifacts behavior.
 import type { MatrixQaObservedEvent } from "./events.js";
 
 export function buildMatrixQaObservedEventsArtifact(params: {
diff --git a/extensions/qa-matrix/src/substrate/client.test.ts b/extensions/qa-matrix/src/substrate/client.test.ts
index 8bed734e48d8..507903772827 100644
--- a/extensions/qa-matrix/src/substrate/client.test.ts
+++ b/extensions/qa-matrix/src/substrate/client.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover client plugin behavior.
 import { describe, expect, it } from "vitest";
 import { testing, createMatrixQaClient, provisionMatrixQaRoom } from "./client.js";
 import { buildDefaultMatrixQaTopologySpec } from "./topology.js";
diff --git a/extensions/qa-matrix/src/substrate/client.ts b/extensions/qa-matrix/src/substrate/client.ts
index 9b6b37f18c73..02054772c9e2 100644
--- a/extensions/qa-matrix/src/substrate/client.ts
+++ b/extensions/qa-matrix/src/substrate/client.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements client behavior.
 import { randomUUID } from "node:crypto";
 import { setTimeout as sleep } from "node:timers/promises";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
diff --git a/extensions/qa-matrix/src/substrate/config.test.ts b/extensions/qa-matrix/src/substrate/config.test.ts
index 0448a46836e8..e83c322328e8 100644
--- a/extensions/qa-matrix/src/substrate/config.test.ts
+++ b/extensions/qa-matrix/src/substrate/config.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover config plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it } from "vitest";
 import {
diff --git a/extensions/qa-matrix/src/substrate/config.ts b/extensions/qa-matrix/src/substrate/config.ts
index a085ac203349..ae935e98d922 100644
--- a/extensions/qa-matrix/src/substrate/config.ts
+++ b/extensions/qa-matrix/src/substrate/config.ts
@@ -1,3 +1,4 @@
+// Qa Matrix helper module supports config behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { normalizeStringEntries, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { MatrixQaProvisionedTopology } from "./topology.js";
diff --git a/extensions/qa-matrix/src/substrate/e2ee-client.test.ts b/extensions/qa-matrix/src/substrate/e2ee-client.test.ts
index e3888e377204..a09a7c35e067 100644
--- a/extensions/qa-matrix/src/substrate/e2ee-client.test.ts
+++ b/extensions/qa-matrix/src/substrate/e2ee-client.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover e2ee client plugin behavior.
 import path from "node:path";
 import { describe, expect, it } from "vitest";
 import { testing } from "./e2ee-client.js";
diff --git a/extensions/qa-matrix/src/substrate/e2ee-client.ts b/extensions/qa-matrix/src/substrate/e2ee-client.ts
index 1d2a33802d05..5e61354d4aa1 100644
--- a/extensions/qa-matrix/src/substrate/e2ee-client.ts
+++ b/extensions/qa-matrix/src/substrate/e2ee-client.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements e2ee client behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { setTimeout as sleep } from "node:timers/promises";
diff --git a/extensions/qa-matrix/src/substrate/events.test.ts b/extensions/qa-matrix/src/substrate/events.test.ts
index 7772f9bc79e2..32cac14c9f06 100644
--- a/extensions/qa-matrix/src/substrate/events.test.ts
+++ b/extensions/qa-matrix/src/substrate/events.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover events plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeMatrixQaObservedEvent } from "./events.js";
 
diff --git a/extensions/qa-matrix/src/substrate/events.ts b/extensions/qa-matrix/src/substrate/events.ts
index 037c5625bdbf..d6a04676f773 100644
--- a/extensions/qa-matrix/src/substrate/events.ts
+++ b/extensions/qa-matrix/src/substrate/events.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements events behavior.
 export type MatrixQaRoomEvent = {
   content?: Record<string, unknown>;
   event_id?: string;
diff --git a/extensions/qa-matrix/src/substrate/fault-proxy.test.ts b/extensions/qa-matrix/src/substrate/fault-proxy.test.ts
index 4ac155086be6..28979b58f8f0 100644
--- a/extensions/qa-matrix/src/substrate/fault-proxy.test.ts
+++ b/extensions/qa-matrix/src/substrate/fault-proxy.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover fault proxy plugin behavior.
 import { createServer } from "node:http";
 import { afterEach, describe, expect, it } from "vitest";
 import { startMatrixQaFaultProxy, type MatrixQaFaultProxy } from "./fault-proxy.js";
diff --git a/extensions/qa-matrix/src/substrate/fault-proxy.ts b/extensions/qa-matrix/src/substrate/fault-proxy.ts
index 404a1b53b7e5..73befaa25ce4 100644
--- a/extensions/qa-matrix/src/substrate/fault-proxy.ts
+++ b/extensions/qa-matrix/src/substrate/fault-proxy.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements fault proxy behavior.
 import {
   createServer,
   type IncomingHttpHeaders,
diff --git a/extensions/qa-matrix/src/substrate/harness.runtime.test.ts b/extensions/qa-matrix/src/substrate/harness.runtime.test.ts
index 8209f603dd32..c9d73a15537d 100644
--- a/extensions/qa-matrix/src/substrate/harness.runtime.test.ts
+++ b/extensions/qa-matrix/src/substrate/harness.runtime.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover harness plugin behavior.
 import { mkdtemp, readFile, rm } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/qa-matrix/src/substrate/harness.runtime.ts b/extensions/qa-matrix/src/substrate/harness.runtime.ts
index 8d86fc38c672..662951a712ac 100644
--- a/extensions/qa-matrix/src/substrate/harness.runtime.ts
+++ b/extensions/qa-matrix/src/substrate/harness.runtime.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements harness behavior.
 import { randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/qa-matrix/src/substrate/request.test.ts b/extensions/qa-matrix/src/substrate/request.test.ts
index 4c8074a9a83d..f479b6658c37 100644
--- a/extensions/qa-matrix/src/substrate/request.test.ts
+++ b/extensions/qa-matrix/src/substrate/request.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover request plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { requestMatrixJson, type MatrixQaFetchLike } from "./request.js";
diff --git a/extensions/qa-matrix/src/substrate/request.ts b/extensions/qa-matrix/src/substrate/request.ts
index fdac0e1db6ba..6a8511d91672 100644
--- a/extensions/qa-matrix/src/substrate/request.ts
+++ b/extensions/qa-matrix/src/substrate/request.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements request behavior.
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 
 export type MatrixQaFetchLike = typeof fetch;
diff --git a/extensions/qa-matrix/src/substrate/sync.test.ts b/extensions/qa-matrix/src/substrate/sync.test.ts
index 7aa81adfa0bd..893e4089dc20 100644
--- a/extensions/qa-matrix/src/substrate/sync.test.ts
+++ b/extensions/qa-matrix/src/substrate/sync.test.ts
@@ -1,3 +1,4 @@
+// Qa Matrix tests cover sync plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { MatrixQaObservedEvent } from "./events.js";
 import {
diff --git a/extensions/qa-matrix/src/substrate/sync.ts b/extensions/qa-matrix/src/substrate/sync.ts
index aafcf4d3536b..72a7ccad6a68 100644
--- a/extensions/qa-matrix/src/substrate/sync.ts
+++ b/extensions/qa-matrix/src/substrate/sync.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements sync behavior.
 import {
   findMatrixQaObservedEventMatch,
   normalizeMatrixQaObservedEvent,
diff --git a/extensions/qa-matrix/src/substrate/topology.ts b/extensions/qa-matrix/src/substrate/topology.ts
index 020f62de6b8a..58b314abe6ba 100644
--- a/extensions/qa-matrix/src/substrate/topology.ts
+++ b/extensions/qa-matrix/src/substrate/topology.ts
@@ -1,3 +1,4 @@
+// Qa Matrix plugin module implements topology behavior.
 export type MatrixQaParticipantRole = "driver" | "observer" | "sut";
 
 type MatrixQaRoomKind = "dm" | "group";
diff --git a/extensions/signal/api.ts b/extensions/signal/api.ts
index 46d9e4c1d77b..2a33ef2885de 100644
--- a/extensions/signal/api.ts
+++ b/extensions/signal/api.ts
@@ -1,3 +1,4 @@
+// Signal API module exposes the plugin public contract.
 export { signalPlugin } from "./src/channel.js";
 export { signalSetupPlugin } from "./src/channel.setup.js";
 export {
diff --git a/extensions/signal/channel-config-api.ts b/extensions/signal/channel-config-api.ts
index ac57c8356476..72013901a9e5 100644
--- a/extensions/signal/channel-config-api.ts
+++ b/extensions/signal/channel-config-api.ts
@@ -1 +1,2 @@
+// Signal API module exposes the plugin public contract.
 export { SignalChannelConfigSchema } from "./src/config-schema.js";
diff --git a/extensions/signal/channel-entry.ts b/extensions/signal/channel-entry.ts
index 38abe83a5bb2..b7f2a6138117 100644
--- a/extensions/signal/channel-entry.ts
+++ b/extensions/signal/channel-entry.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements channel entry behavior.
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelEntry({
diff --git a/extensions/signal/config-api.ts b/extensions/signal/config-api.ts
index 1fe3b520cab2..187b24326653 100644
--- a/extensions/signal/config-api.ts
+++ b/extensions/signal/config-api.ts
@@ -1,3 +1,4 @@
+// Signal API module exposes the plugin public contract.
 export {
   buildChannelConfigSchema,
   SignalConfigSchema,
diff --git a/extensions/signal/contract-api.ts b/extensions/signal/contract-api.ts
index cb72c9815920..72efe1961ef7 100644
--- a/extensions/signal/contract-api.ts
+++ b/extensions/signal/contract-api.ts
@@ -1,3 +1,4 @@
+// Signal API module exposes the plugin public contract.
 export * from "./src/install-signal-cli.js";
 export * from "./src/normalize.js";
 export { isSignalSenderAllowed, type SignalSender } from "./src/identity.js";
diff --git a/extensions/signal/index.ts b/extensions/signal/index.ts
index 5e33cdc15bfb..ea7b5654cc2c 100644
--- a/extensions/signal/index.ts
+++ b/extensions/signal/index.ts
@@ -1,3 +1,4 @@
+// Signal plugin entrypoint registers its OpenClaw integration.
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelEntry({
diff --git a/extensions/signal/reaction-runtime-api.ts b/extensions/signal/reaction-runtime-api.ts
index e02f9bf54f2b..0a3d54c33f93 100644
--- a/extensions/signal/reaction-runtime-api.ts
+++ b/extensions/signal/reaction-runtime-api.ts
@@ -1,3 +1,4 @@
+// Signal API module exposes the plugin public contract.
 export {
   removeReactionSignal,
   sendReactionSignal,
diff --git a/extensions/signal/runtime-api.ts b/extensions/signal/runtime-api.ts
index 368f3537966c..97ef1d28d7f0 100644
--- a/extensions/signal/runtime-api.ts
+++ b/extensions/signal/runtime-api.ts
@@ -1,3 +1,4 @@
+// Signal API module exposes the plugin public contract.
 export {
   applyAccountNameToChannelSection,
   buildBaseAccountStatusSnapshot,
diff --git a/extensions/signal/setup-entry.ts b/extensions/signal/setup-entry.ts
index b38447c39b66..e91f80ec4fb7 100644
--- a/extensions/signal/setup-entry.ts
+++ b/extensions/signal/setup-entry.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/signal/src/account-types.ts b/extensions/signal/src/account-types.ts
index 2cf120edc444..9d5304d32746 100644
--- a/extensions/signal/src/account-types.ts
+++ b/extensions/signal/src/account-types.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements account types behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 
 export type SignalAccountConfig = Omit<
diff --git a/extensions/signal/src/accounts.test.ts b/extensions/signal/src/accounts.test.ts
index 36947b8dabd3..49c94a423e1b 100644
--- a/extensions/signal/src/accounts.test.ts
+++ b/extensions/signal/src/accounts.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover accounts plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   listSignalAccountIds,
diff --git a/extensions/signal/src/accounts.ts b/extensions/signal/src/accounts.ts
index 80de07301e14..f409f457cf79 100644
--- a/extensions/signal/src/accounts.ts
+++ b/extensions/signal/src/accounts.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements accounts behavior.
 import {
   createAccountListHelpers,
   normalizeAccountId,
diff --git a/extensions/signal/src/approval-auth.test.ts b/extensions/signal/src/approval-auth.test.ts
index f2693fd4803c..6eb7892a2b1e 100644
--- a/extensions/signal/src/approval-auth.test.ts
+++ b/extensions/signal/src/approval-auth.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover approval auth plugin behavior.
 import { describe, expect, it } from "vitest";
 import { signalApprovalAuth } from "./approval-auth.js";
 
diff --git a/extensions/signal/src/approval-auth.ts b/extensions/signal/src/approval-auth.ts
index ecee0f9f9ab7..975438d1de2f 100644
--- a/extensions/signal/src/approval-auth.ts
+++ b/extensions/signal/src/approval-auth.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements approval auth behavior.
 import {
   createResolvedApproverActionAuthAdapter,
   resolveApprovalApprovers,
diff --git a/extensions/signal/src/approval-handler.runtime.test.ts b/extensions/signal/src/approval-handler.runtime.test.ts
index f4c60afc401b..4044f94c5123 100644
--- a/extensions/signal/src/approval-handler.runtime.test.ts
+++ b/extensions/signal/src/approval-handler.runtime.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover approval handler plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const sendMocks = vi.hoisted(() => ({
diff --git a/extensions/signal/src/approval-handler.runtime.ts b/extensions/signal/src/approval-handler.runtime.ts
index 42beca76fe11..b6d1258bf0d5 100644
--- a/extensions/signal/src/approval-handler.runtime.ts
+++ b/extensions/signal/src/approval-handler.runtime.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements approval handler behavior.
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import {
   buildChannelApprovalExpiredText,
diff --git a/extensions/signal/src/approval-native.test.ts b/extensions/signal/src/approval-native.test.ts
index 01a76d9e5d10..43765614808a 100644
--- a/extensions/signal/src/approval-native.test.ts
+++ b/extensions/signal/src/approval-native.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover approval native plugin behavior.
 import type {
   ExecApprovalRequest,
   PluginApprovalRequest,
diff --git a/extensions/signal/src/approval-native.ts b/extensions/signal/src/approval-native.ts
index 8173209eaa96..2c477cae7fe4 100644
--- a/extensions/signal/src/approval-native.ts
+++ b/extensions/signal/src/approval-native.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements approval native behavior.
 import {
   createChannelApprovalCapability,
   splitChannelApprovalCapability,
diff --git a/extensions/signal/src/approval-reactions.test.ts b/extensions/signal/src/approval-reactions.test.ts
index 77a49c299f9a..7ef35df75aa2 100644
--- a/extensions/signal/src/approval-reactions.test.ts
+++ b/extensions/signal/src/approval-reactions.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover approval reactions plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
   addSignalApprovalReactionHintToText,
diff --git a/extensions/signal/src/approval-reactions.ts b/extensions/signal/src/approval-reactions.ts
index 39bb95404f86..0b8f8731ae76 100644
--- a/extensions/signal/src/approval-reactions.ts
+++ b/extensions/signal/src/approval-reactions.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements approval reactions behavior.
 import { matchesApprovalRequestFilters } from "openclaw/plugin-sdk/approval-client-runtime";
 import {
   buildApprovalReactionHint,
diff --git a/extensions/signal/src/approval-resolver.ts b/extensions/signal/src/approval-resolver.ts
index 4e8bebdf1287..f5d43dd941e7 100644
--- a/extensions/signal/src/approval-resolver.ts
+++ b/extensions/signal/src/approval-resolver.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements approval resolver behavior.
 import { resolveApprovalOverGateway } from "openclaw/plugin-sdk/approval-gateway-runtime";
 import type { ExecApprovalReplyDecision } from "openclaw/plugin-sdk/approval-reply-runtime";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/signal/src/channel.runtime.ts b/extensions/signal/src/channel.runtime.ts
index de908d212b77..303197a3f2f0 100644
--- a/extensions/signal/src/channel.runtime.ts
+++ b/extensions/signal/src/channel.runtime.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements channel behavior.
 import { signalSetupWizard as signalSetupWizardImpl } from "./setup-surface.js";
 
 type SignalSetupWizard = typeof import("./setup-surface.js").signalSetupWizard;
diff --git a/extensions/signal/src/channel.setup.ts b/extensions/signal/src/channel.setup.ts
index 116beb4b67de..7930a29ec8a7 100644
--- a/extensions/signal/src/channel.setup.ts
+++ b/extensions/signal/src/channel.setup.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements channel.setup behavior.
 import type { ChannelPlugin } from "openclaw/plugin-sdk/core";
 import type { ResolvedSignalAccount } from "./accounts.js";
 import { signalSetupAdapter } from "./setup-core.js";
diff --git a/extensions/signal/src/channel.ts b/extensions/signal/src/channel.ts
index e7a22c9c8ff4..8ad5a639fb6c 100644
--- a/extensions/signal/src/channel.ts
+++ b/extensions/signal/src/channel.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements channel behavior.
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import { buildDmGroupAccountAllowlistAdapter } from "openclaw/plugin-sdk/allowlist-config-edit";
 import { createChatChannelPlugin, type ChannelPlugin } from "openclaw/plugin-sdk/channel-core";
diff --git a/extensions/signal/src/client-adapter.test.ts b/extensions/signal/src/client-adapter.test.ts
index 08fbaba044e9..41355b0b11df 100644
--- a/extensions/signal/src/client-adapter.test.ts
+++ b/extensions/signal/src/client-adapter.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover client adapter plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   signalRpcRequest as signalRpcRequestImpl,
diff --git a/extensions/signal/src/client-container.test.ts b/extensions/signal/src/client-container.test.ts
index ff07d1409c2d..60cd472b1b4a 100644
--- a/extensions/signal/src/client-container.test.ts
+++ b/extensions/signal/src/client-container.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover client container plugin behavior.
 import * as fetchModule from "openclaw/plugin-sdk/fetch-runtime";
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { describe, expect, it, vi, beforeEach } from "vitest";
diff --git a/extensions/signal/src/client.test.ts b/extensions/signal/src/client.test.ts
index 931ef5467058..1b92784daa37 100644
--- a/extensions/signal/src/client.test.ts
+++ b/extensions/signal/src/client.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover client plugin behavior.
 import { Buffer } from "node:buffer";
 import { once } from "node:events";
 import http, { type IncomingMessage, type ServerResponse } from "node:http";
diff --git a/extensions/signal/src/client.ts b/extensions/signal/src/client.ts
index 793d3ec8a6a1..4e925b467404 100644
--- a/extensions/signal/src/client.ts
+++ b/extensions/signal/src/client.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements client behavior.
 import { Buffer } from "node:buffer";
 import http, { type ClientRequest, type IncomingMessage } from "node:http";
 import https from "node:https";
diff --git a/extensions/signal/src/config-schema.test.ts b/extensions/signal/src/config-schema.test.ts
index beca08cc77a6..f0b047c2452d 100644
--- a/extensions/signal/src/config-schema.test.ts
+++ b/extensions/signal/src/config-schema.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover config schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { SignalConfigSchema } from "../config-api.js";
 
diff --git a/extensions/signal/src/config-schema.ts b/extensions/signal/src/config-schema.ts
index 06246393b136..bfe74da74c18 100644
--- a/extensions/signal/src/config-schema.ts
+++ b/extensions/signal/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Signal helper module supports config schema behavior.
 import { buildChannelConfigSchema, SignalConfigSchema } from "../config-api.js";
 import { signalChannelConfigUiHints } from "./config-ui-hints.js";
 
diff --git a/extensions/signal/src/config-ui-hints.ts b/extensions/signal/src/config-ui-hints.ts
index 3eae6a485894..7278b83d5350 100644
--- a/extensions/signal/src/config-ui-hints.ts
+++ b/extensions/signal/src/config-ui-hints.ts
@@ -1,3 +1,4 @@
+// Signal helper module supports config ui hints behavior.
 import type { ChannelConfigUiHint } from "openclaw/plugin-sdk/core";
 
 export const signalChannelConfigUiHints = {
diff --git a/extensions/signal/src/core.test.ts b/extensions/signal/src/core.test.ts
index e6459d045eb6..aa4225486bba 100644
--- a/extensions/signal/src/core.test.ts
+++ b/extensions/signal/src/core.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover core plugin behavior.
 import {
   createMessageReceiptFromOutboundResults,
   verifyChannelMessageAdapterCapabilityProofs,
diff --git a/extensions/signal/src/daemon.test.ts b/extensions/signal/src/daemon.test.ts
index 6adfa849df18..c5aca9d66396 100644
--- a/extensions/signal/src/daemon.test.ts
+++ b/extensions/signal/src/daemon.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover daemon plugin behavior.
 import os from "node:os";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/signal/src/daemon.ts b/extensions/signal/src/daemon.ts
index 458d24de027d..f8f477a1ad49 100644
--- a/extensions/signal/src/daemon.ts
+++ b/extensions/signal/src/daemon.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements daemon behavior.
 import { spawn } from "node:child_process";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/signal/src/format.chunking.test.ts b/extensions/signal/src/format.chunking.test.ts
index 0e04b35108c5..0b7e3123405d 100644
--- a/extensions/signal/src/format.chunking.test.ts
+++ b/extensions/signal/src/format.chunking.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover format.chunking plugin behavior.
 import { describe, expect, it } from "vitest";
 import { markdownToSignalTextChunks } from "./format.js";
 
diff --git a/extensions/signal/src/format.test.ts b/extensions/signal/src/format.test.ts
index d899492105f8..dd6a27de7f83 100644
--- a/extensions/signal/src/format.test.ts
+++ b/extensions/signal/src/format.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover format plugin behavior.
 import { describe, expect, it } from "vitest";
 import { markdownToSignalText } from "./format.js";
 
diff --git a/extensions/signal/src/format.ts b/extensions/signal/src/format.ts
index b0320c0f313b..fa47e5838d68 100644
--- a/extensions/signal/src/format.ts
+++ b/extensions/signal/src/format.ts
@@ -1,3 +1,4 @@
+// Signal helper module supports format behavior.
 import type { MarkdownTableMode } from "openclaw/plugin-sdk/config-contracts";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import {
diff --git a/extensions/signal/src/identity.ts b/extensions/signal/src/identity.ts
index 3d068a48f6de..0c19d2e5869e 100644
--- a/extensions/signal/src/identity.ts
+++ b/extensions/signal/src/identity.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements identity behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { normalizeE164 } from "openclaw/plugin-sdk/text-utility-runtime";
 import { looksLikeUuid } from "./uuid.js";
diff --git a/extensions/signal/src/inbound-context.contract.test.ts b/extensions/signal/src/inbound-context.contract.test.ts
index 7a8a7361f708..984b06224120 100644
--- a/extensions/signal/src/inbound-context.contract.test.ts
+++ b/extensions/signal/src/inbound-context.contract.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover inbound context.contract plugin behavior.
 import { expectChannelInboundContextContract } from "openclaw/plugin-sdk/channel-contract-testing";
 import { finalizeInboundContext } from "openclaw/plugin-sdk/reply-runtime";
 import { describe, it } from "vitest";
diff --git a/extensions/signal/src/install-signal-cli.test.ts b/extensions/signal/src/install-signal-cli.test.ts
index 4eca0c07a9d5..74c027030aa7 100644
--- a/extensions/signal/src/install-signal-cli.test.ts
+++ b/extensions/signal/src/install-signal-cli.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover install signal cli plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/signal/src/install-signal-cli.ts b/extensions/signal/src/install-signal-cli.ts
index 9d4d819d62dc..3b79e653bbd0 100644
--- a/extensions/signal/src/install-signal-cli.ts
+++ b/extensions/signal/src/install-signal-cli.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements install signal cli behavior.
 import { createWriteStream } from "node:fs";
 import fs from "node:fs/promises";
 import path from "node:path";
diff --git a/extensions/signal/src/message-actions.test.ts b/extensions/signal/src/message-actions.test.ts
index 7af3c25d3ff4..fd0621935416 100644
--- a/extensions/signal/src/message-actions.test.ts
+++ b/extensions/signal/src/message-actions.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover message actions plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/signal/src/message-actions.ts b/extensions/signal/src/message-actions.ts
index 7eb53babe67e..0fc52179a25d 100644
--- a/extensions/signal/src/message-actions.ts
+++ b/extensions/signal/src/message-actions.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements message actions behavior.
 import { resolveReactionMessageId } from "openclaw/plugin-sdk/channel-actions";
 import { createActionGate, jsonResult, readStringParam } from "openclaw/plugin-sdk/channel-actions";
 import type {
diff --git a/extensions/signal/src/monitor.tool-result.autostart.test.ts b/extensions/signal/src/monitor.tool-result.autostart.test.ts
index da7741d70e3f..5634e76aa134 100644
--- a/extensions/signal/src/monitor.tool-result.autostart.test.ts
+++ b/extensions/signal/src/monitor.tool-result.autostart.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover monitor.tool result.autostart plugin behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it, vi } from "vitest";
 import type { SignalDaemonExitEvent } from "./daemon.js";
diff --git a/extensions/signal/src/monitor.tool-result.pairs-uuid-only-senders-uuid-allowlist-entry.test.ts b/extensions/signal/src/monitor.tool-result.pairs-uuid-only-senders-uuid-allowlist-entry.test.ts
index ff4f4a069d8e..86b9bfd127b2 100644
--- a/extensions/signal/src/monitor.tool-result.pairs-uuid-only-senders-uuid-allowlist-entry.test.ts
+++ b/extensions/signal/src/monitor.tool-result.pairs-uuid-only-senders-uuid-allowlist-entry.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover monitor.tool result.pairs uuid only senders uuid allowlist entry plugin behavior.
 import { Buffer } from "node:buffer";
 import { describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/signal/src/monitor.tool-result.sends-tool-summaries-responseprefix.test.ts b/extensions/signal/src/monitor.tool-result.sends-tool-summaries-responseprefix.test.ts
index fe15434a448a..ef4e996bbad7 100644
--- a/extensions/signal/src/monitor.tool-result.sends-tool-summaries-responseprefix.test.ts
+++ b/extensions/signal/src/monitor.tool-result.sends-tool-summaries-responseprefix.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover monitor.tool result.sends tool summaries responseprefix plugin behavior.
 import { expectPairingReplyText } from "openclaw/plugin-sdk/channel-test-helpers";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { resolveAgentRoute } from "openclaw/plugin-sdk/routing";
diff --git a/extensions/signal/src/monitor.tool-result.test-harness.ts b/extensions/signal/src/monitor.tool-result.test-harness.ts
index 45a82d6545c4..62180df36080 100644
--- a/extensions/signal/src/monitor.tool-result.test-harness.ts
+++ b/extensions/signal/src/monitor.tool-result.test-harness.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements monitor.tool result harness behavior.
 import type { MockFn } from "openclaw/plugin-sdk/plugin-test-runtime";
 import { beforeEach, vi } from "vitest";
 import type { SignalDaemonExitEvent, SignalDaemonHandle } from "./daemon.js";
diff --git a/extensions/signal/src/monitor.ts b/extensions/signal/src/monitor.ts
index 51a04e66280e..bf5cc395a714 100644
--- a/extensions/signal/src/monitor.ts
+++ b/extensions/signal/src/monitor.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements monitor behavior.
 import { CHANNEL_APPROVAL_NATIVE_RUNTIME_CONTEXT_CAPABILITY } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
 import type { ChannelRuntimeSurface } from "openclaw/plugin-sdk/channel-contract";
 import { registerChannelRuntimeContext } from "openclaw/plugin-sdk/channel-runtime-context";
diff --git a/extensions/signal/src/monitor/access-policy.test.ts b/extensions/signal/src/monitor/access-policy.test.ts
index 6a01b1fbef40..b9b5dcdac79a 100644
--- a/extensions/signal/src/monitor/access-policy.test.ts
+++ b/extensions/signal/src/monitor/access-policy.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover access policy plugin behavior.
 import type { AccessGroupsConfig, OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it, vi } from "vitest";
 import { handleSignalDirectMessageAccess, resolveSignalAccessState } from "./access-policy.js";
diff --git a/extensions/signal/src/monitor/access-policy.ts b/extensions/signal/src/monitor/access-policy.ts
index 42cbf4489feb..8db58a440442 100644
--- a/extensions/signal/src/monitor/access-policy.ts
+++ b/extensions/signal/src/monitor/access-policy.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements access policy behavior.
 import {
   createChannelIngressResolver,
   defineStableChannelIngressIdentity,
diff --git a/extensions/signal/src/monitor/event-handler.inbound-context.test.ts b/extensions/signal/src/monitor/event-handler.inbound-context.test.ts
index b8d201b99b74..d5439a6bde70 100644
--- a/extensions/signal/src/monitor/event-handler.inbound-context.test.ts
+++ b/extensions/signal/src/monitor/event-handler.inbound-context.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover event handler.inbound context plugin behavior.
 import { expectChannelInboundContextContract as expectInboundContextContract } from "openclaw/plugin-sdk/channel-contract-testing";
 import type { MsgContext } from "openclaw/plugin-sdk/reply-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/signal/src/monitor/event-handler.mention-gating.test.ts b/extensions/signal/src/monitor/event-handler.mention-gating.test.ts
index d5f600b8f75a..e34aa49d3902 100644
--- a/extensions/signal/src/monitor/event-handler.mention-gating.test.ts
+++ b/extensions/signal/src/monitor/event-handler.mention-gating.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover event handler.mention gating plugin behavior.
 import { buildDispatchInboundCaptureMock } from "openclaw/plugin-sdk/channel-contract-testing";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { MsgContext } from "openclaw/plugin-sdk/reply-runtime";
diff --git a/extensions/signal/src/monitor/event-handler.silent-ingest.test.ts b/extensions/signal/src/monitor/event-handler.silent-ingest.test.ts
index 039e5175d53c..223197416649 100644
--- a/extensions/signal/src/monitor/event-handler.silent-ingest.test.ts
+++ b/extensions/signal/src/monitor/event-handler.silent-ingest.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover event handler.silent ingest plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   createBaseSignalEventHandlerDeps,
diff --git a/extensions/signal/src/monitor/event-handler.test-harness.ts b/extensions/signal/src/monitor/event-handler.test-harness.ts
index fad7090e3b5f..7387a8b01712 100644
--- a/extensions/signal/src/monitor/event-handler.test-harness.ts
+++ b/extensions/signal/src/monitor/event-handler.test-harness.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements event handler harness behavior.
 import type { SignalEventHandlerDeps, SignalReactionMessage } from "./event-handler.types.js";
 
 export function createBaseSignalEventHandlerDeps(
diff --git a/extensions/signal/src/monitor/event-handler.ts b/extensions/signal/src/monitor/event-handler.ts
index ccdb25f511d6..f0cb978c9094 100644
--- a/extensions/signal/src/monitor/event-handler.ts
+++ b/extensions/signal/src/monitor/event-handler.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements event handler behavior.
 import { resolveHumanDelayConfig } from "openclaw/plugin-sdk/agent-runtime";
 import { logTypingFailure } from "openclaw/plugin-sdk/channel-feedback";
 import {
diff --git a/extensions/signal/src/monitor/event-handler.types.ts b/extensions/signal/src/monitor/event-handler.types.ts
index e4dfc6c0b017..e3f592bc64b5 100644
--- a/extensions/signal/src/monitor/event-handler.types.ts
+++ b/extensions/signal/src/monitor/event-handler.types.ts
@@ -1,3 +1,4 @@
+// Signal type declarations define plugin contracts.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type {
   DmPolicy,
diff --git a/extensions/signal/src/monitor/inbound-context.ts b/extensions/signal/src/monitor/inbound-context.ts
index 70c26ae59b91..237254b944d6 100644
--- a/extensions/signal/src/monitor/inbound-context.ts
+++ b/extensions/signal/src/monitor/inbound-context.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements inbound context behavior.
 import { filterChannelInboundQuoteContext } from "openclaw/plugin-sdk/channel-inbound";
 import { resolveChannelContextVisibilityMode } from "openclaw/plugin-sdk/context-visibility-runtime";
 import type { ContextVisibilityDecision } from "openclaw/plugin-sdk/security-runtime";
diff --git a/extensions/signal/src/monitor/mentions.ts b/extensions/signal/src/monitor/mentions.ts
index 04adec9c96e2..988d34cee2cf 100644
--- a/extensions/signal/src/monitor/mentions.ts
+++ b/extensions/signal/src/monitor/mentions.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements mentions behavior.
 import type { SignalMention } from "./event-handler.types.js";
 
 const OBJECT_REPLACEMENT = "\uFFFC";
diff --git a/extensions/signal/src/normalize.test.ts b/extensions/signal/src/normalize.test.ts
index 259df234f854..964d23fa1192 100644
--- a/extensions/signal/src/normalize.test.ts
+++ b/extensions/signal/src/normalize.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover normalize plugin behavior.
 import { describe, expect, it } from "vitest";
 import { looksLikeSignalTargetId, normalizeSignalMessagingTarget } from "./normalize.js";
 
diff --git a/extensions/signal/src/normalize.ts b/extensions/signal/src/normalize.ts
index aa893bdd6f3c..023e87a0c7f4 100644
--- a/extensions/signal/src/normalize.ts
+++ b/extensions/signal/src/normalize.ts
@@ -1,3 +1,4 @@
+// Signal helper module supports normalize behavior.
 import {
   normalizeLowercaseStringOrEmpty,
   normalizeStringEntries,
diff --git a/extensions/signal/src/outbound-session.ts b/extensions/signal/src/outbound-session.ts
index 8be384284ab0..ab3b6d096973 100644
--- a/extensions/signal/src/outbound-session.ts
+++ b/extensions/signal/src/outbound-session.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements outbound session behavior.
 import type { RoutePeer } from "openclaw/plugin-sdk/routing";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { resolveSignalPeerId, resolveSignalRecipient, resolveSignalSender } from "./identity.js";
diff --git a/extensions/signal/src/probe.contract.test.ts b/extensions/signal/src/probe.contract.test.ts
index 65e6886d9f87..3c6a407eeff3 100644
--- a/extensions/signal/src/probe.contract.test.ts
+++ b/extensions/signal/src/probe.contract.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover probe.contract plugin behavior.
 import type { BaseProbeResult } from "openclaw/plugin-sdk/channel-contract";
 import { describe, expectTypeOf, it } from "vitest";
 import type { SignalProbe } from "./probe.js";
diff --git a/extensions/signal/src/probe.ts b/extensions/signal/src/probe.ts
index e618e4b3d235..15f4ada7df22 100644
--- a/extensions/signal/src/probe.ts
+++ b/extensions/signal/src/probe.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements probe behavior.
 import type { BaseProbeResult } from "openclaw/plugin-sdk/channel-contract";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { type SignalApiMode, signalCheck, signalRpcRequest } from "./client-adapter.js";
diff --git a/extensions/signal/src/reaction-level.ts b/extensions/signal/src/reaction-level.ts
index d8e9969c4f9d..db254706f04e 100644
--- a/extensions/signal/src/reaction-level.ts
+++ b/extensions/signal/src/reaction-level.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements reaction level behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
   resolveReactionLevel,
diff --git a/extensions/signal/src/rpc-context.ts b/extensions/signal/src/rpc-context.ts
index 88ac09cb05ea..596d67e74987 100644
--- a/extensions/signal/src/rpc-context.ts
+++ b/extensions/signal/src/rpc-context.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements rpc context behavior.
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { resolveSignalAccount } from "./accounts.js";
 
diff --git a/extensions/signal/src/runtime.ts b/extensions/signal/src/runtime.ts
index b7a5d2be9e7d..4fa00adc26f0 100644
--- a/extensions/signal/src/runtime.ts
+++ b/extensions/signal/src/runtime.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements runtime behavior.
 import type { PluginRuntime } from "openclaw/plugin-sdk/core";
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 
diff --git a/extensions/signal/src/send-reactions.test.ts b/extensions/signal/src/send-reactions.test.ts
index 2d526e42f9ac..58a603d5ce07 100644
--- a/extensions/signal/src/send-reactions.test.ts
+++ b/extensions/signal/src/send-reactions.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover send reactions plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const rpcMock = vi.fn();
diff --git a/extensions/signal/src/send.runtime.ts b/extensions/signal/src/send.runtime.ts
index 82258f95fa52..f2c9a08a6f48 100644
--- a/extensions/signal/src/send.runtime.ts
+++ b/extensions/signal/src/send.runtime.ts
@@ -1 +1,2 @@
+// Signal plugin module implements send behavior.
 export { sendMessageSignal, sendTypingSignal } from "./send.js";
diff --git a/extensions/signal/src/send.test.ts b/extensions/signal/src/send.test.ts
index 5e182f814ae6..8481926cf2e8 100644
--- a/extensions/signal/src/send.test.ts
+++ b/extensions/signal/src/send.test.ts
@@ -1,3 +1,4 @@
+// Signal tests cover send plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const signalRpcRequestMock = vi.hoisted(() => vi.fn());
diff --git a/extensions/signal/src/send.ts b/extensions/signal/src/send.ts
index 995e784415ff..57157eb19e0d 100644
--- a/extensions/signal/src/send.ts
+++ b/extensions/signal/src/send.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements send behavior.
 import {
   createMessageReceiptFromOutboundResults,
   type MessageReceipt,
diff --git a/extensions/signal/src/setup-core.ts b/extensions/signal/src/setup-core.ts
index ecb8727ff8f3..9fc7785e24ac 100644
--- a/extensions/signal/src/setup-core.ts
+++ b/extensions/signal/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements setup core behavior.
 import {
   createCliPathTextInput,
   createDelegatedSetupWizardProxy,
diff --git a/extensions/signal/src/setup-surface.ts b/extensions/signal/src/setup-surface.ts
index 47c68ba1daed..69a32d0116ff 100644
--- a/extensions/signal/src/setup-surface.ts
+++ b/extensions/signal/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements setup surface behavior.
 import {
   createSetupTranslator,
   createDetectedBinaryStatus,
diff --git a/extensions/signal/src/shared.ts b/extensions/signal/src/shared.ts
index 2b2c17821c10..abca6386839b 100644
--- a/extensions/signal/src/shared.ts
+++ b/extensions/signal/src/shared.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements shared behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import {
   adaptScopedAccountAccessor,
diff --git a/extensions/signal/src/sse-reconnect.ts b/extensions/signal/src/sse-reconnect.ts
index 9b168493f0a2..e213c0a997a2 100644
--- a/extensions/signal/src/sse-reconnect.ts
+++ b/extensions/signal/src/sse-reconnect.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements sse reconnect behavior.
 import {
   computeBackoff,
   logVerbose,
diff --git a/extensions/signal/src/uuid.ts b/extensions/signal/src/uuid.ts
index 4736e1949bd5..c4ead50105d3 100644
--- a/extensions/signal/src/uuid.ts
+++ b/extensions/signal/src/uuid.ts
@@ -1,3 +1,4 @@
+// Signal plugin module implements uuid behavior.
 const UUID_HYPHENATED_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 const UUID_COMPACT_RE = /^[0-9a-f]{32}$/i;
 
diff --git a/extensions/tlon/api.ts b/extensions/tlon/api.ts
index b6ce81f896b1..8e946ba11395 100644
--- a/extensions/tlon/api.ts
+++ b/extensions/tlon/api.ts
@@ -1,3 +1,4 @@
+// Tlon API module exposes the plugin public contract.
 export {
   createDedupeCache,
   createLoggerBackedRuntime,
diff --git a/extensions/tlon/channel-plugin-api.ts b/extensions/tlon/channel-plugin-api.ts
index bb19cd45b55a..0a17cdd45ef7 100644
--- a/extensions/tlon/channel-plugin-api.ts
+++ b/extensions/tlon/channel-plugin-api.ts
@@ -1 +1,2 @@
+// Tlon API module exposes the plugin public contract.
 export { tlonPlugin } from "./src/channel.js";
diff --git a/extensions/tlon/doctor-contract-api.ts b/extensions/tlon/doctor-contract-api.ts
index a7a56f234421..acae8e14eb57 100644
--- a/extensions/tlon/doctor-contract-api.ts
+++ b/extensions/tlon/doctor-contract-api.ts
@@ -1 +1,2 @@
+// Tlon API module exposes the plugin public contract.
 export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
diff --git a/extensions/tlon/index.ts b/extensions/tlon/index.ts
index 245b9b750383..7778ca2a1bc1 100644
--- a/extensions/tlon/index.ts
+++ b/extensions/tlon/index.ts
@@ -1,3 +1,4 @@
+// Tlon plugin entrypoint registers its OpenClaw integration.
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelEntry({
diff --git a/extensions/tlon/setup-api.ts b/extensions/tlon/setup-api.ts
index cf444e388fc8..30f7716f3468 100644
--- a/extensions/tlon/setup-api.ts
+++ b/extensions/tlon/setup-api.ts
@@ -1,2 +1,3 @@
+// Tlon API module exposes the plugin public contract.
 export { tlonSetupAdapter } from "./src/setup-core.js";
 export { tlonSetupWizard } from "./src/setup-surface.js";
diff --git a/extensions/tlon/setup-entry.ts b/extensions/tlon/setup-entry.ts
index f66fbe818e3f..2618b17f787e 100644
--- a/extensions/tlon/setup-entry.ts
+++ b/extensions/tlon/setup-entry.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/tlon/src/account-fields.ts b/extensions/tlon/src/account-fields.ts
index ab43c0617391..d6a3eca4312d 100644
--- a/extensions/tlon/src/account-fields.ts
+++ b/extensions/tlon/src/account-fields.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements account fields behavior.
 export type TlonAccountFieldsInput = {
   ship?: string;
   url?: string;
diff --git a/extensions/tlon/src/channel.message-adapter.test.ts b/extensions/tlon/src/channel.message-adapter.test.ts
index 666590a4dbfb..4fe71997119f 100644
--- a/extensions/tlon/src/channel.message-adapter.test.ts
+++ b/extensions/tlon/src/channel.message-adapter.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover channel.message adapter plugin behavior.
 import { verifyChannelMessageAdapterCapabilityProofs } from "openclaw/plugin-sdk/channel-outbound";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../runtime-api.js";
diff --git a/extensions/tlon/src/channel.runtime.ts b/extensions/tlon/src/channel.runtime.ts
index 1f59688618d6..89f1523d9057 100644
--- a/extensions/tlon/src/channel.runtime.ts
+++ b/extensions/tlon/src/channel.runtime.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements channel behavior.
 import crypto from "node:crypto";
 import type { ChannelAccountSnapshot } from "openclaw/plugin-sdk/channel-contract";
 import type { ChannelOutboundAdapter } from "openclaw/plugin-sdk/channel-send-result";
diff --git a/extensions/tlon/src/channel.ts b/extensions/tlon/src/channel.ts
index 7ff9af83dfc9..ff9e7c3aec8a 100644
--- a/extensions/tlon/src/channel.ts
+++ b/extensions/tlon/src/channel.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements channel behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import { createHybridChannelConfigAdapter } from "openclaw/plugin-sdk/channel-config-helpers";
diff --git a/extensions/tlon/src/config-schema.ts b/extensions/tlon/src/config-schema.ts
index 539f7265eed1..5eb9efe96c52 100644
--- a/extensions/tlon/src/config-schema.ts
+++ b/extensions/tlon/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Tlon helper module supports config schema behavior.
 import { buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-schema";
 import { z } from "zod";
 
diff --git a/extensions/tlon/src/core.test.ts b/extensions/tlon/src/core.test.ts
index ccccc4a8d7f0..8caa4320814c 100644
--- a/extensions/tlon/src/core.test.ts
+++ b/extensions/tlon/src/core.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover core plugin behavior.
 import {
   createPluginSetupWizardConfigure,
   createPluginSetupWizardStatus,
diff --git a/extensions/tlon/src/doctor-contract.ts b/extensions/tlon/src/doctor-contract.ts
index 42d9b3f642f7..80951b451d10 100644
--- a/extensions/tlon/src/doctor-contract.ts
+++ b/extensions/tlon/src/doctor-contract.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements doctor contract behavior.
 import { createLegacyPrivateNetworkDoctorContract } from "openclaw/plugin-sdk/ssrf-runtime";
 
 const contract = createLegacyPrivateNetworkDoctorContract({
diff --git a/extensions/tlon/src/doctor.test.ts b/extensions/tlon/src/doctor.test.ts
index 3596400a6f3b..f4c40e7cd93c 100644
--- a/extensions/tlon/src/doctor.test.ts
+++ b/extensions/tlon/src/doctor.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover doctor plugin behavior.
 import { describe, expect, it } from "vitest";
 import { tlonDoctor } from "./doctor.js";
 
diff --git a/extensions/tlon/src/doctor.ts b/extensions/tlon/src/doctor.ts
index a90d25ae745f..8c12e0e82de9 100644
--- a/extensions/tlon/src/doctor.ts
+++ b/extensions/tlon/src/doctor.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements doctor behavior.
 import type { ChannelDoctorAdapter } from "openclaw/plugin-sdk/channel-contract";
 import {
   legacyConfigRules as TLON_LEGACY_CONFIG_RULES,
diff --git a/extensions/tlon/src/logger-runtime.ts b/extensions/tlon/src/logger-runtime.ts
index bd132e0061a8..25728f81e878 100644
--- a/extensions/tlon/src/logger-runtime.ts
+++ b/extensions/tlon/src/logger-runtime.ts
@@ -1 +1,2 @@
+// Tlon plugin module implements logger runtime behavior.
 export { createLoggerBackedRuntime } from "openclaw/plugin-sdk/runtime";
diff --git a/extensions/tlon/src/monitor/approval-runtime.ts b/extensions/tlon/src/monitor/approval-runtime.ts
index a0ec82a2f7da..73c8c26f9af7 100644
--- a/extensions/tlon/src/monitor/approval-runtime.ts
+++ b/extensions/tlon/src/monitor/approval-runtime.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements approval runtime behavior.
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";
 import type { PendingApproval, TlonSettingsStore } from "../settings.js";
 import { normalizeShip } from "../targets.js";
diff --git a/extensions/tlon/src/monitor/approval.test.ts b/extensions/tlon/src/monitor/approval.test.ts
index 35522b87c80e..2b25150f83ba 100644
--- a/extensions/tlon/src/monitor/approval.test.ts
+++ b/extensions/tlon/src/monitor/approval.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover approval plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const cryptoMocks = vi.hoisted(() => ({
diff --git a/extensions/tlon/src/monitor/authorization.ts b/extensions/tlon/src/monitor/authorization.ts
index cbd596448693..4330d0e4c634 100644
--- a/extensions/tlon/src/monitor/authorization.ts
+++ b/extensions/tlon/src/monitor/authorization.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements authorization behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import type { TlonSettingsStore } from "../settings.js";
 
diff --git a/extensions/tlon/src/monitor/cites.ts b/extensions/tlon/src/monitor/cites.ts
index 56ba7baa0e00..2ccbbbd9a9f6 100644
--- a/extensions/tlon/src/monitor/cites.ts
+++ b/extensions/tlon/src/monitor/cites.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements cites behavior.
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";
 import { asRecord, extractCites, extractMessageText, type ParsedCite } from "./utils.js";
 
diff --git a/extensions/tlon/src/monitor/discovery.ts b/extensions/tlon/src/monitor/discovery.ts
index 885179f98f6f..942a677e46bb 100644
--- a/extensions/tlon/src/monitor/discovery.ts
+++ b/extensions/tlon/src/monitor/discovery.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements discovery behavior.
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";
 import type { Foreigns } from "../urbit/foreigns.js";
 import { asRecord, formatErrorMessage } from "./utils.js";
diff --git a/extensions/tlon/src/monitor/history.ts b/extensions/tlon/src/monitor/history.ts
index 331e5464aaf9..0486159d0a5d 100644
--- a/extensions/tlon/src/monitor/history.ts
+++ b/extensions/tlon/src/monitor/history.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements history behavior.
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";
 import { asRecord, extractMessageText, formatErrorMessage } from "./utils.js";
 
diff --git a/extensions/tlon/src/monitor/index.ts b/extensions/tlon/src/monitor/index.ts
index fffaa313182f..dce593142cb6 100644
--- a/extensions/tlon/src/monitor/index.ts
+++ b/extensions/tlon/src/monitor/index.ts
@@ -1,3 +1,4 @@
+// Tlon plugin entrypoint registers its OpenClaw integration.
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";
 import { asFiniteNumber } from "openclaw/plugin-sdk/string-coerce-runtime";
diff --git a/extensions/tlon/src/monitor/media.test.ts b/extensions/tlon/src/monitor/media.test.ts
index bbde4fa8a3c8..eccba45c149f 100644
--- a/extensions/tlon/src/monitor/media.test.ts
+++ b/extensions/tlon/src/monitor/media.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover media plugin behavior.
 import {
   readRemoteMediaBuffer,
   MAX_IMAGE_BYTES,
diff --git a/extensions/tlon/src/monitor/media.ts b/extensions/tlon/src/monitor/media.ts
index ec7061361c75..f065b412d2a3 100644
--- a/extensions/tlon/src/monitor/media.ts
+++ b/extensions/tlon/src/monitor/media.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements media behavior.
 import { randomUUID } from "node:crypto";
 import { mkdir, writeFile } from "node:fs/promises";
 import * as path from "node:path";
diff --git a/extensions/tlon/src/monitor/processed-messages.test.ts b/extensions/tlon/src/monitor/processed-messages.test.ts
index e4e350cadee8..560779bffe1c 100644
--- a/extensions/tlon/src/monitor/processed-messages.test.ts
+++ b/extensions/tlon/src/monitor/processed-messages.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover processed messages plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   createProcessedMessageTracker,
diff --git a/extensions/tlon/src/monitor/processed-messages.ts b/extensions/tlon/src/monitor/processed-messages.ts
index c1e6c62e0a72..19997247e946 100644
--- a/extensions/tlon/src/monitor/processed-messages.ts
+++ b/extensions/tlon/src/monitor/processed-messages.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements processed messages behavior.
 import { createDedupeCache } from "../../runtime-api.js";
 
 type ProcessedMessageTracker = {
diff --git a/extensions/tlon/src/monitor/settings-helpers.test.ts b/extensions/tlon/src/monitor/settings-helpers.test.ts
index ba5fbdb4d20d..06074ee7c671 100644
--- a/extensions/tlon/src/monitor/settings-helpers.test.ts
+++ b/extensions/tlon/src/monitor/settings-helpers.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover settings helpers plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { TlonResolvedAccount } from "../types.js";
 import {
diff --git a/extensions/tlon/src/monitor/settings-helpers.ts b/extensions/tlon/src/monitor/settings-helpers.ts
index d20ee09bf2e7..bec3f327458f 100644
--- a/extensions/tlon/src/monitor/settings-helpers.ts
+++ b/extensions/tlon/src/monitor/settings-helpers.ts
@@ -1,3 +1,4 @@
+// Tlon helper module supports settings helpers behavior.
 import { uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { PendingApproval, TlonSettingsStore } from "../settings.js";
 import { normalizeShip } from "../targets.js";
diff --git a/extensions/tlon/src/monitor/utils.ts b/extensions/tlon/src/monitor/utils.ts
index 9897fe172d63..dc4826fa6ec2 100644
--- a/extensions/tlon/src/monitor/utils.ts
+++ b/extensions/tlon/src/monitor/utils.ts
@@ -1,3 +1,4 @@
+// Tlon helper module supports utils behavior.
 import {
   resolveStableChannelMessageIngress,
   type StableChannelIngressIdentityParams,
diff --git a/extensions/tlon/src/runtime.ts b/extensions/tlon/src/runtime.ts
index 12aa5b21ab09..269115158d0f 100644
--- a/extensions/tlon/src/runtime.ts
+++ b/extensions/tlon/src/runtime.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements runtime behavior.
 import type { PluginRuntime } from "openclaw/plugin-sdk/plugin-runtime";
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 
diff --git a/extensions/tlon/src/session-route.ts b/extensions/tlon/src/session-route.ts
index 8f02dcef6299..697f240c91bb 100644
--- a/extensions/tlon/src/session-route.ts
+++ b/extensions/tlon/src/session-route.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements session route behavior.
 import {
   buildChannelOutboundSessionRoute,
   type ChannelOutboundSessionRouteParams,
diff --git a/extensions/tlon/src/setup-core.ts b/extensions/tlon/src/setup-core.ts
index b8167fd855e3..767bb27bee4a 100644
--- a/extensions/tlon/src/setup-core.ts
+++ b/extensions/tlon/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements setup core behavior.
 import {
   DEFAULT_ACCOUNT_ID,
   formatDocsLink,
diff --git a/extensions/tlon/src/setup-surface.ts b/extensions/tlon/src/setup-surface.ts
index 7120c6771f81..f991a9e7e28d 100644
--- a/extensions/tlon/src/setup-surface.ts
+++ b/extensions/tlon/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements setup surface behavior.
 import { createSetupTranslator } from "openclaw/plugin-sdk/setup-runtime";
 import { normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import {
diff --git a/extensions/tlon/src/targets.ts b/extensions/tlon/src/targets.ts
index dff6a07bd8f1..6c61e6a99ce0 100644
--- a/extensions/tlon/src/targets.ts
+++ b/extensions/tlon/src/targets.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements targets behavior.
 type TlonTarget =
   | { kind: "dm"; ship: string }
   | { kind: "group"; nest: string; hostShip: string; channelName: string };
diff --git a/extensions/tlon/src/tlon-api.test.ts b/extensions/tlon/src/tlon-api.test.ts
index 14c5c9ee0570..46cec83a6e87 100644
--- a/extensions/tlon/src/tlon-api.test.ts
+++ b/extensions/tlon/src/tlon-api.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover tlon api plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { authenticate } from "./urbit/auth.js";
 import { scryUrbitPath } from "./urbit/channel-ops.js";
diff --git a/extensions/tlon/src/tlon-api.ts b/extensions/tlon/src/tlon-api.ts
index a149535cd33a..f40eeb107bd2 100644
--- a/extensions/tlon/src/tlon-api.ts
+++ b/extensions/tlon/src/tlon-api.ts
@@ -1,3 +1,4 @@
+// Tlon API module exposes the plugin public contract.
 import crypto from "node:crypto";
 import { PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
 import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
diff --git a/extensions/tlon/src/types.ts b/extensions/tlon/src/types.ts
index 64869c251539..a4cf2bf9e325 100644
--- a/extensions/tlon/src/types.ts
+++ b/extensions/tlon/src/types.ts
@@ -1,3 +1,4 @@
+// Tlon type declarations define plugin contracts.
 import {
   DEFAULT_ACCOUNT_ID,
   listCombinedAccountIds,
diff --git a/extensions/tlon/src/urbit/auth.ssrf.test.ts b/extensions/tlon/src/urbit/auth.ssrf.test.ts
index e74f4a48c947..11b3b96bdbaa 100644
--- a/extensions/tlon/src/urbit/auth.ssrf.test.ts
+++ b/extensions/tlon/src/urbit/auth.ssrf.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover auth.ssrf plugin behavior.
 import { SsrFBlockedError } from "openclaw/plugin-sdk/ssrf-runtime";
 import type { LookupFn } from "openclaw/plugin-sdk/ssrf-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/tlon/src/urbit/auth.ts b/extensions/tlon/src/urbit/auth.ts
index 7136336f6b9b..f90ed811d1b6 100644
--- a/extensions/tlon/src/urbit/auth.ts
+++ b/extensions/tlon/src/urbit/auth.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements auth behavior.
 import type { LookupFn, SsrFPolicy } from "openclaw/plugin-sdk/ssrf-runtime";
 import { UrbitAuthError } from "./errors.js";
 import { urbitFetch } from "./fetch.js";
diff --git a/extensions/tlon/src/urbit/base-url.test.ts b/extensions/tlon/src/urbit/base-url.test.ts
index 117361490ea0..e8017e3d0d48 100644
--- a/extensions/tlon/src/urbit/base-url.test.ts
+++ b/extensions/tlon/src/urbit/base-url.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover base url plugin behavior.
 import { describe, expect, it } from "vitest";
 import { validateUrbitBaseUrl } from "./base-url.js";
 
diff --git a/extensions/tlon/src/urbit/base-url.ts b/extensions/tlon/src/urbit/base-url.ts
index 2dba84322e01..48f82975e15d 100644
--- a/extensions/tlon/src/urbit/base-url.ts
+++ b/extensions/tlon/src/urbit/base-url.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements base url behavior.
 import { isBlockedHostnameOrIp } from "openclaw/plugin-sdk/ssrf-runtime";
 
 type UrbitBaseUrlValidation =
diff --git a/extensions/tlon/src/urbit/channel-ops.test.ts b/extensions/tlon/src/urbit/channel-ops.test.ts
index ab3d4e45638c..157b5d3ac8c0 100644
--- a/extensions/tlon/src/urbit/channel-ops.test.ts
+++ b/extensions/tlon/src/urbit/channel-ops.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover channel ops plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { scryUrbitPath } from "./channel-ops.js";
 import { urbitFetch } from "./fetch.js";
diff --git a/extensions/tlon/src/urbit/channel-ops.ts b/extensions/tlon/src/urbit/channel-ops.ts
index 0bce546a0538..cb08dc642d23 100644
--- a/extensions/tlon/src/urbit/channel-ops.ts
+++ b/extensions/tlon/src/urbit/channel-ops.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements channel ops behavior.
 import type { LookupFn, SsrFPolicy } from "openclaw/plugin-sdk/ssrf-runtime";
 import { UrbitHttpError } from "./errors.js";
 import { urbitFetch } from "./fetch.js";
diff --git a/extensions/tlon/src/urbit/context.ts b/extensions/tlon/src/urbit/context.ts
index 1820f9d961f7..025a4c67eb46 100644
--- a/extensions/tlon/src/urbit/context.ts
+++ b/extensions/tlon/src/urbit/context.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements context behavior.
 export { ssrfPolicyFromDangerouslyAllowPrivateNetwork } from "openclaw/plugin-sdk/ssrf-runtime";
 import { normalizeUrbitHostname, validateUrbitBaseUrl } from "./base-url.js";
 import { UrbitUrlError } from "./errors.js";
diff --git a/extensions/tlon/src/urbit/errors.ts b/extensions/tlon/src/urbit/errors.ts
index 16b30236e1ae..000fb9ef0d1c 100644
--- a/extensions/tlon/src/urbit/errors.ts
+++ b/extensions/tlon/src/urbit/errors.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements errors behavior.
 type UrbitErrorCode =
   | "invalid_url"
   | "http_error"
diff --git a/extensions/tlon/src/urbit/fetch.ts b/extensions/tlon/src/urbit/fetch.ts
index 5dc4eee401c9..b4dc4fbbc742 100644
--- a/extensions/tlon/src/urbit/fetch.ts
+++ b/extensions/tlon/src/urbit/fetch.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements fetch behavior.
 import {
   fetchWithSsrFGuard,
   type LookupFn,
diff --git a/extensions/tlon/src/urbit/send.test.ts b/extensions/tlon/src/urbit/send.test.ts
index 4729365c615f..8ce1d732532d 100644
--- a/extensions/tlon/src/urbit/send.test.ts
+++ b/extensions/tlon/src/urbit/send.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover send plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 vi.mock("@urbit/aura", () => ({
diff --git a/extensions/tlon/src/urbit/send.ts b/extensions/tlon/src/urbit/send.ts
index 965e0c197fbd..62f9f0ce9bfc 100644
--- a/extensions/tlon/src/urbit/send.ts
+++ b/extensions/tlon/src/urbit/send.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements send behavior.
 import { scot, da } from "@urbit/aura";
 import {
   createMessageReceiptFromOutboundResults,
diff --git a/extensions/tlon/src/urbit/sse-client.test.ts b/extensions/tlon/src/urbit/sse-client.test.ts
index 6487f481e1c7..7d1ee0de1b7d 100644
--- a/extensions/tlon/src/urbit/sse-client.test.ts
+++ b/extensions/tlon/src/urbit/sse-client.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover sse client plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { urbitFetch } from "./fetch.js";
diff --git a/extensions/tlon/src/urbit/sse-client.ts b/extensions/tlon/src/urbit/sse-client.ts
index bd4eb85b9215..8ee6e08d8b4b 100644
--- a/extensions/tlon/src/urbit/sse-client.ts
+++ b/extensions/tlon/src/urbit/sse-client.ts
@@ -1,3 +1,4 @@
+// Tlon plugin module implements sse client behavior.
 import { randomUUID } from "node:crypto";
 import { Readable } from "node:stream";
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
diff --git a/extensions/tlon/src/urbit/upload.test.ts b/extensions/tlon/src/urbit/upload.test.ts
index 6b01bf6faee0..8eebd54d9af8 100644
--- a/extensions/tlon/src/urbit/upload.test.ts
+++ b/extensions/tlon/src/urbit/upload.test.ts
@@ -1,3 +1,4 @@
+// Tlon tests cover upload plugin behavior.
 import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime";
 import { describe, expect, it, vi, beforeEach } from "vitest";
 import { uploadFile } from "../tlon-api.js";
diff --git a/extensions/tlon/test-api.ts b/extensions/tlon/test-api.ts
index bb19cd45b55a..0a17cdd45ef7 100644
--- a/extensions/tlon/test-api.ts
+++ b/extensions/tlon/test-api.ts
@@ -1 +1,2 @@
+// Tlon API module exposes the plugin public contract.
 export { tlonPlugin } from "./src/channel.js";
diff --git a/extensions/xai/.boundary-stubs/anthropic-vertex-api.d.ts b/extensions/xai/.boundary-stubs/anthropic-vertex-api.d.ts
index 4c25821c837b..94b1d2817740 100644
--- a/extensions/xai/.boundary-stubs/anthropic-vertex-api.d.ts
+++ b/extensions/xai/.boundary-stubs/anthropic-vertex-api.d.ts
@@ -1,2 +1,3 @@
+// Xai type declarations define plugin contracts.
 export const resolveAnthropicVertexClientRegion: (...args: unknown[]) => unknown;
 export const resolveAnthropicVertexProjectId: (...args: unknown[]) => unknown;
diff --git a/extensions/xai/.boundary-stubs/ollama-api.d.ts b/extensions/xai/.boundary-stubs/ollama-api.d.ts
index 0deafeb53c70..0dbc763fd25c 100644
--- a/extensions/xai/.boundary-stubs/ollama-api.d.ts
+++ b/extensions/xai/.boundary-stubs/ollama-api.d.ts
@@ -1 +1,2 @@
+// Xai type declarations define plugin contracts.
 export const resolveOllamaApiBase: (...args: unknown[]) => unknown;
diff --git a/extensions/xai/.boundary-stubs/ollama-runtime-api.d.ts b/extensions/xai/.boundary-stubs/ollama-runtime-api.d.ts
index 74041aaf2eab..3b6eed044d75 100644
--- a/extensions/xai/.boundary-stubs/ollama-runtime-api.d.ts
+++ b/extensions/xai/.boundary-stubs/ollama-runtime-api.d.ts
@@ -1,3 +1,4 @@
+// Xai type declarations define plugin contracts.
 export type OllamaEmbeddingClient = unknown;
 
 export const buildAssistantMessage: (...args: unknown[]) => unknown;
diff --git a/extensions/xai/.boundary-stubs/speech-core-runtime-api.d.ts b/extensions/xai/.boundary-stubs/speech-core-runtime-api.d.ts
index 99111d093efb..1845352dfd8a 100644
--- a/extensions/xai/.boundary-stubs/speech-core-runtime-api.d.ts
+++ b/extensions/xai/.boundary-stubs/speech-core-runtime-api.d.ts
@@ -1,3 +1,4 @@
+// Xai type declarations define plugin contracts.
 export type ResolvedTtsConfig = unknown;
 export type ResolvedTtsModelOverrides = unknown;
 export type TtsDirectiveOverrides = unknown;
diff --git a/extensions/xai/api.test.ts b/extensions/xai/api.test.ts
index 7577db0422ae..35be4e9f09ff 100644
--- a/extensions/xai/api.test.ts
+++ b/extensions/xai/api.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover api plugin behavior.
 import { describe, expect, it } from "vitest";
 import { isXaiModelHint, resolveXaiTransport } from "./api.js";
 
diff --git a/extensions/xai/api.ts b/extensions/xai/api.ts
index 600276eaf295..0a2a5ee15e19 100644
--- a/extensions/xai/api.ts
+++ b/extensions/xai/api.ts
@@ -1,3 +1,4 @@
+// Xai API module exposes the plugin public contract.
 import { normalizeProviderId } from "openclaw/plugin-sdk/provider-model-shared";
 import {
   normalizeOptionalLowercaseString,
diff --git a/extensions/xai/code-execution-tool-shared.ts b/extensions/xai/code-execution-tool-shared.ts
index fb1159a7e037..0ea79d64ad85 100644
--- a/extensions/xai/code-execution-tool-shared.ts
+++ b/extensions/xai/code-execution-tool-shared.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements code execution tool shared behavior.
 import type { AgentToolResult } from "openclaw/plugin-sdk/agent-core";
 import { Type } from "typebox";
 
diff --git a/extensions/xai/code-execution.test.ts b/extensions/xai/code-execution.test.ts
index 92ca3a6c885b..d2cb86155ee7 100644
--- a/extensions/xai/code-execution.test.ts
+++ b/extensions/xai/code-execution.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover code execution plugin behavior.
 import { withFetchPreconnect } from "openclaw/plugin-sdk/test-env";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { createCodeExecutionTool } from "./code-execution.js";
diff --git a/extensions/xai/code-execution.ts b/extensions/xai/code-execution.ts
index e0dc52737d51..5b5ca4fa2407 100644
--- a/extensions/xai/code-execution.ts
+++ b/extensions/xai/code-execution.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements code execution behavior.
 import { jsonResult, readStringParam } from "openclaw/plugin-sdk/provider-web-search";
 import { getRuntimeConfigSnapshot } from "openclaw/plugin-sdk/runtime-config-snapshot";
 import {
diff --git a/extensions/xai/image-generation-provider.test.ts b/extensions/xai/image-generation-provider.test.ts
index 281f9bdf56cf..a979af52e887 100644
--- a/extensions/xai/image-generation-provider.test.ts
+++ b/extensions/xai/image-generation-provider.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover image generation provider plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { buildXaiImageGenerationProvider } from "./image-generation-provider.js";
 
diff --git a/extensions/xai/image-generation-provider.ts b/extensions/xai/image-generation-provider.ts
index 95f9dd552076..b1d7c05ef93d 100644
--- a/extensions/xai/image-generation-provider.ts
+++ b/extensions/xai/image-generation-provider.ts
@@ -1,3 +1,4 @@
+// Xai provider module implements model/runtime integration.
 import type {
   ImageGenerationProvider,
   ImageGenerationRequest,
diff --git a/extensions/xai/index.test.ts b/extensions/xai/index.test.ts
index a5cae7438201..4b986c648dda 100644
--- a/extensions/xai/index.test.ts
+++ b/extensions/xai/index.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover index plugin behavior.
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
 import {
diff --git a/extensions/xai/index.ts b/extensions/xai/index.ts
index 258f60a92de7..a87a52db5de9 100644
--- a/extensions/xai/index.ts
+++ b/extensions/xai/index.ts
@@ -1,3 +1,4 @@
+// Xai plugin entrypoint registers its OpenClaw integration.
 import { defineSingleProviderPluginEntry } from "openclaw/plugin-sdk/provider-entry";
 import { OPENAI_COMPATIBLE_REPLAY_HOOKS } from "openclaw/plugin-sdk/provider-model-shared";
 import { defaultToolStreamExtraParams } from "openclaw/plugin-sdk/provider-stream-shared";
diff --git a/extensions/xai/model-compat.ts b/extensions/xai/model-compat.ts
index 51445c1fc8ca..1ae0ab570507 100644
--- a/extensions/xai/model-compat.ts
+++ b/extensions/xai/model-compat.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements model compat behavior.
 import {
   applyModelCompatPatch,
   type ModelCompatConfig,
diff --git a/extensions/xai/model-definitions.ts b/extensions/xai/model-definitions.ts
index 8072dd34fc0c..fc89fc162279 100644
--- a/extensions/xai/model-definitions.ts
+++ b/extensions/xai/model-definitions.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements model definitions behavior.
 import type { ModelDefinitionConfig } from "openclaw/plugin-sdk/provider-model-shared";
 import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime";
 
diff --git a/extensions/xai/model-id.test.ts b/extensions/xai/model-id.test.ts
index 5625542f81b2..a22630d3f321 100644
--- a/extensions/xai/model-id.test.ts
+++ b/extensions/xai/model-id.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover model id plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeXaiModelId } from "./api.js";
 
diff --git a/extensions/xai/model-id.ts b/extensions/xai/model-id.ts
index 42df0984f6f9..b2a95fd3772f 100644
--- a/extensions/xai/model-id.ts
+++ b/extensions/xai/model-id.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements model id behavior.
 export function normalizeXaiModelId(id: string): string {
   if (id === "grok-code-fast-1" || id === "grok-code-fast" || id === "grok-code-fast-1-0825") {
     return "grok-build-0.1";
diff --git a/extensions/xai/onboard.test.ts b/extensions/xai/onboard.test.ts
index 6e945d3baa81..3a453fe69780 100644
--- a/extensions/xai/onboard.test.ts
+++ b/extensions/xai/onboard.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover onboard plugin behavior.
 import {
   resolveAgentModelFallbackValues,
   resolveAgentModelPrimaryValue,
diff --git a/extensions/xai/onboard.ts b/extensions/xai/onboard.ts
index cb6da4a458c3..dff95e3e436c 100644
--- a/extensions/xai/onboard.ts
+++ b/extensions/xai/onboard.ts
@@ -1,3 +1,4 @@
+// Xai setup module handles plugin onboarding behavior.
 import {
   createModelCatalogPresetAppliers,
   type OpenClawConfig,
diff --git a/extensions/xai/provider-catalog.ts b/extensions/xai/provider-catalog.ts
index f8c248d60de7..33891375bd14 100644
--- a/extensions/xai/provider-catalog.ts
+++ b/extensions/xai/provider-catalog.ts
@@ -1,3 +1,4 @@
+// Xai provider module implements model/runtime integration.
 import type { ModelProviderConfig } from "openclaw/plugin-sdk/provider-model-shared";
 import { buildXaiCatalogModels, XAI_BASE_URL } from "./model-definitions.js";
 
diff --git a/extensions/xai/provider-contract-api.ts b/extensions/xai/provider-contract-api.ts
index 94c58105f47a..dcae343e963a 100644
--- a/extensions/xai/provider-contract-api.ts
+++ b/extensions/xai/provider-contract-api.ts
@@ -1,3 +1,4 @@
+// Xai API module exposes the plugin public contract.
 import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared";
 
 export function createXaiProvider(): ProviderPlugin {
diff --git a/extensions/xai/provider-discovery.ts b/extensions/xai/provider-discovery.ts
index 44338906e91c..379edd5e864a 100644
--- a/extensions/xai/provider-discovery.ts
+++ b/extensions/xai/provider-discovery.ts
@@ -1,3 +1,4 @@
+// Xai provider module implements model/runtime integration.
 import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared";
 import { readProviderEnvValue } from "openclaw/plugin-sdk/provider-web-search";
 import { resolveFallbackXaiAuth } from "./src/tool-auth-shared.js";
diff --git a/extensions/xai/provider-models.ts b/extensions/xai/provider-models.ts
index a1123d78da5f..00b15899cd33 100644
--- a/extensions/xai/provider-models.ts
+++ b/extensions/xai/provider-models.ts
@@ -1,3 +1,4 @@
+// Xai provider module implements model/runtime integration.
 import type {
   ProviderResolveDynamicModelContext,
   ProviderRuntimeModel,
diff --git a/extensions/xai/provider-policy-api.test.ts b/extensions/xai/provider-policy-api.test.ts
index 9375aa0ef8b5..828ed4634295 100644
--- a/extensions/xai/provider-policy-api.test.ts
+++ b/extensions/xai/provider-policy-api.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover provider policy api plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveThinkingProfile } from "./provider-policy-api.js";
 
diff --git a/extensions/xai/provider-policy-api.ts b/extensions/xai/provider-policy-api.ts
index 45769a9bab9e..8e25bcf48117 100644
--- a/extensions/xai/provider-policy-api.ts
+++ b/extensions/xai/provider-policy-api.ts
@@ -1,3 +1,4 @@
+// Xai API module exposes the plugin public contract.
 import type {
   ProviderDefaultThinkingPolicyContext,
   ProviderThinkingProfile,
diff --git a/extensions/xai/realtime-transcription-provider.test.ts b/extensions/xai/realtime-transcription-provider.test.ts
index f1e611907b00..99f70a2232e9 100644
--- a/extensions/xai/realtime-transcription-provider.test.ts
+++ b/extensions/xai/realtime-transcription-provider.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover realtime transcription provider plugin behavior.
 import { createServer } from "node:http";
 import type { AddressInfo } from "node:net";
 import { afterEach, describe, expect, it, vi } from "vitest";
diff --git a/extensions/xai/realtime-transcription-provider.ts b/extensions/xai/realtime-transcription-provider.ts
index d1c31939c19e..45cec2c4b715 100644
--- a/extensions/xai/realtime-transcription-provider.ts
+++ b/extensions/xai/realtime-transcription-provider.ts
@@ -1,3 +1,4 @@
+// Xai provider module implements model/runtime integration.
 import {
   isProviderAuthProfileConfigured,
   type OpenClawConfig,
diff --git a/extensions/xai/runtime-model-compat.test.ts b/extensions/xai/runtime-model-compat.test.ts
index 30fd1ae284c4..405b2dc49566 100644
--- a/extensions/xai/runtime-model-compat.test.ts
+++ b/extensions/xai/runtime-model-compat.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover runtime model compat plugin behavior.
 import { describe, expect, it } from "vitest";
 import { applyXaiRuntimeModelCompat } from "./runtime-model-compat.js";
 
diff --git a/extensions/xai/runtime-model-compat.ts b/extensions/xai/runtime-model-compat.ts
index 7dc5affcd751..f1d34ed0e6c8 100644
--- a/extensions/xai/runtime-model-compat.ts
+++ b/extensions/xai/runtime-model-compat.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements runtime model compat behavior.
 import { applyXaiModelCompat } from "./model-compat.js";
 
 type XaiRuntimeModelCompat = {
diff --git a/extensions/xai/setup-api.ts b/extensions/xai/setup-api.ts
index a5d5cb9f9020..629b69edda54 100644
--- a/extensions/xai/setup-api.ts
+++ b/extensions/xai/setup-api.ts
@@ -1,3 +1,4 @@
+// Xai API module exposes the plugin public contract.
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { isRecord } from "./src/tool-config-shared.js";
 
diff --git a/extensions/xai/speech-provider.test.ts b/extensions/xai/speech-provider.test.ts
index bfd673d084a3..a00128b87d48 100644
--- a/extensions/xai/speech-provider.test.ts
+++ b/extensions/xai/speech-provider.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover speech provider plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { buildXaiSpeechProvider } from "./speech-provider.js";
 
diff --git a/extensions/xai/speech-provider.ts b/extensions/xai/speech-provider.ts
index be773872fe91..65f888597db8 100644
--- a/extensions/xai/speech-provider.ts
+++ b/extensions/xai/speech-provider.ts
@@ -1,3 +1,4 @@
+// Xai provider module implements model/runtime integration.
 import {
   isProviderAuthProfileConfigured,
   type OpenClawConfig,
diff --git a/extensions/xai/src/code-execution-config.ts b/extensions/xai/src/code-execution-config.ts
index 9314f94fccc6..ba5a7db558ba 100644
--- a/extensions/xai/src/code-execution-config.ts
+++ b/extensions/xai/src/code-execution-config.ts
@@ -1,3 +1,4 @@
+// Xai helper module supports code execution config behavior.
 import { isXaiToolEnabled, type XaiToolAuthContext } from "./tool-auth-shared.js";
 
 export type CodeExecutionConfig = {
diff --git a/extensions/xai/src/code-execution-shared.ts b/extensions/xai/src/code-execution-shared.ts
index 9acf840767b6..b221a5d83c44 100644
--- a/extensions/xai/src/code-execution-shared.ts
+++ b/extensions/xai/src/code-execution-shared.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements code execution shared behavior.
 import { readProviderJsonObjectResponse } from "openclaw/plugin-sdk/provider-http";
 import { postTrustedWebToolsJson } from "openclaw/plugin-sdk/provider-web-search";
 import {
diff --git a/extensions/xai/src/responses-tool-shared.test.ts b/extensions/xai/src/responses-tool-shared.test.ts
index b2486aa95e1d..f668dffb1a85 100644
--- a/extensions/xai/src/responses-tool-shared.test.ts
+++ b/extensions/xai/src/responses-tool-shared.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover responses tool shared plugin behavior.
 import { describe, expect, it } from "vitest";
 import { testing } from "./responses-tool-shared.js";
 
diff --git a/extensions/xai/src/responses-tool-shared.ts b/extensions/xai/src/responses-tool-shared.ts
index 431708e9d236..7ff35bee691c 100644
--- a/extensions/xai/src/responses-tool-shared.ts
+++ b/extensions/xai/src/responses-tool-shared.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements responses tool shared behavior.
 import {
   normalizeOptionalString as trimString,
   uniqueStrings,
diff --git a/extensions/xai/src/tool-auth-shared.test.ts b/extensions/xai/src/tool-auth-shared.test.ts
index 7513b86ff0d4..67673e3cc3aa 100644
--- a/extensions/xai/src/tool-auth-shared.test.ts
+++ b/extensions/xai/src/tool-auth-shared.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover tool auth shared plugin behavior.
 import { NON_ENV_SECRETREF_MARKER } from "openclaw/plugin-sdk/provider-auth-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/xai/src/tool-auth-shared.ts b/extensions/xai/src/tool-auth-shared.ts
index 2fb281c39913..b472dc5f7702 100644
--- a/extensions/xai/src/tool-auth-shared.ts
+++ b/extensions/xai/src/tool-auth-shared.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements tool auth shared behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { canResolveEnvSecretRefInReadOnlyPath } from "openclaw/plugin-sdk/extension-shared";
 import {
diff --git a/extensions/xai/src/tool-config-shared.test.ts b/extensions/xai/src/tool-config-shared.test.ts
index 6e22bb778cf9..eec1957e7566 100644
--- a/extensions/xai/src/tool-config-shared.test.ts
+++ b/extensions/xai/src/tool-config-shared.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover tool config shared plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   coerceXaiToolConfig,
diff --git a/extensions/xai/src/tool-config-shared.ts b/extensions/xai/src/tool-config-shared.ts
index 71a45d0906d2..3194c9cedb50 100644
--- a/extensions/xai/src/tool-config-shared.ts
+++ b/extensions/xai/src/tool-config-shared.ts
@@ -1,3 +1,4 @@
+// Xai helper module supports tool config shared behavior.
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { normalizeXaiModelId } from "../model-id.js";
 
diff --git a/extensions/xai/src/web-search-provider.runtime.ts b/extensions/xai/src/web-search-provider.runtime.ts
index 2c2396e469e2..706474438f12 100644
--- a/extensions/xai/src/web-search-provider.runtime.ts
+++ b/extensions/xai/src/web-search-provider.runtime.ts
@@ -1,3 +1,4 @@
+// Xai provider module implements model/runtime integration.
 import { resolveDefaultAgentDir } from "openclaw/plugin-sdk/agent-runtime";
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import {
diff --git a/extensions/xai/src/web-search-response.types.ts b/extensions/xai/src/web-search-response.types.ts
index c9ce32060f09..a340a33ea77c 100644
--- a/extensions/xai/src/web-search-response.types.ts
+++ b/extensions/xai/src/web-search-response.types.ts
@@ -1,3 +1,4 @@
+// Xai type declarations define plugin contracts.
 export type XaiWebSearchResponse = {
   output?: Array<{
     type?: string;
diff --git a/extensions/xai/src/web-search-shared.ts b/extensions/xai/src/web-search-shared.ts
index 2c398b766e0f..b157948d0189 100644
--- a/extensions/xai/src/web-search-shared.ts
+++ b/extensions/xai/src/web-search-shared.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements web search shared behavior.
 import { readProviderJsonObjectResponse } from "openclaw/plugin-sdk/provider-http";
 import { postTrustedWebToolsJson, wrapWebContent } from "openclaw/plugin-sdk/provider-web-search";
 import { normalizeXaiModelId } from "../model-id.js";
diff --git a/extensions/xai/src/x-search-config.ts b/extensions/xai/src/x-search-config.ts
index 580c7940b5eb..bfe5810cd050 100644
--- a/extensions/xai/src/x-search-config.ts
+++ b/extensions/xai/src/x-search-config.ts
@@ -1,3 +1,4 @@
+// Xai helper module supports x search config behavior.
 import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { isRecord } from "./tool-config-shared.js";
 
diff --git a/extensions/xai/src/x-search-shared.ts b/extensions/xai/src/x-search-shared.ts
index 7bbf3f787e50..64e320d66210 100644
--- a/extensions/xai/src/x-search-shared.ts
+++ b/extensions/xai/src/x-search-shared.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements x search shared behavior.
 import { readProviderJsonObjectResponse } from "openclaw/plugin-sdk/provider-http";
 import { postTrustedWebToolsJson, wrapWebContent } from "openclaw/plugin-sdk/provider-web-search";
 import {
diff --git a/extensions/xai/src/xai-user-agent.test.ts b/extensions/xai/src/xai-user-agent.test.ts
index 9c305d0b0bfa..5a6bb79ae9d4 100644
--- a/extensions/xai/src/xai-user-agent.test.ts
+++ b/extensions/xai/src/xai-user-agent.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover xai user agent plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { xaiUserAgent, xaiUserAgentHeaderFor } from "./xai-user-agent.js";
 
diff --git a/extensions/xai/stream.test.ts b/extensions/xai/stream.test.ts
index c3f970366208..93ac64ed7a59 100644
--- a/extensions/xai/stream.test.ts
+++ b/extensions/xai/stream.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover stream plugin behavior.
 import type { StreamFn } from "openclaw/plugin-sdk/agent-core";
 import { streamSimple, type Api, type Context, type Model } from "openclaw/plugin-sdk/llm";
 import { describe, expect, it } from "vitest";
diff --git a/extensions/xai/stream.ts b/extensions/xai/stream.ts
index 8b47711d0661..2fb45c659545 100644
--- a/extensions/xai/stream.ts
+++ b/extensions/xai/stream.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements stream behavior.
 import type { StreamFn } from "openclaw/plugin-sdk/agent-core";
 import {
   streamSimple,
diff --git a/extensions/xai/stt.test.ts b/extensions/xai/stt.test.ts
index 0d899581b1f9..33245527e792 100644
--- a/extensions/xai/stt.test.ts
+++ b/extensions/xai/stt.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover stt plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   buildXaiMediaUnderstandingProvider,
diff --git a/extensions/xai/stt.ts b/extensions/xai/stt.ts
index d355c5b784e0..eeeb4a5f2611 100644
--- a/extensions/xai/stt.ts
+++ b/extensions/xai/stt.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements stt behavior.
 import type {
   AudioTranscriptionRequest,
   AudioTranscriptionResult,
diff --git a/extensions/xai/test-api.ts b/extensions/xai/test-api.ts
index 8794fdf72f17..bac4983fa6f3 100644
--- a/extensions/xai/test-api.ts
+++ b/extensions/xai/test-api.ts
@@ -1 +1,2 @@
+// Xai API module exposes the plugin public contract.
 export { testing, testing as __testing } from "./src/web-search-provider.runtime.js";
diff --git a/extensions/xai/test-helpers.ts b/extensions/xai/test-helpers.ts
index 2af0575b64e0..20d55297c33f 100644
--- a/extensions/xai/test-helpers.ts
+++ b/extensions/xai/test-helpers.ts
@@ -1,3 +1,4 @@
+// Xai helper module supports test helpers behavior.
 import type { StreamFn } from "openclaw/plugin-sdk/agent-core";
 import type { Context, Model } from "openclaw/plugin-sdk/llm";
 import { expect } from "vitest";
diff --git a/extensions/xai/tts.test.ts b/extensions/xai/tts.test.ts
index 0e4e7aaa6c63..18286ab4ad72 100644
--- a/extensions/xai/tts.test.ts
+++ b/extensions/xai/tts.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover tts plugin behavior.
 import { mockPinnedHostnameResolution } from "openclaw/plugin-sdk/test-env";
 import { beforeEach, afterEach, describe, expect, it, vi } from "vitest";
 import { isValidXaiTtsVoice, XAI_BASE_URL, XAI_TTS_VOICES, xaiTTS } from "./tts.js";
diff --git a/extensions/xai/tts.ts b/extensions/xai/tts.ts
index 986d694a7662..2fb1a61fde12 100644
--- a/extensions/xai/tts.ts
+++ b/extensions/xai/tts.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements tts behavior.
 import { assertOkOrThrowProviderError, postJsonRequest } from "openclaw/plugin-sdk/provider-http";
 import { readResponseWithLimit } from "openclaw/plugin-sdk/response-limit-runtime";
 import { trimToUndefined } from "openclaw/plugin-sdk/speech";
diff --git a/extensions/xai/video-generation-provider.test.ts b/extensions/xai/video-generation-provider.test.ts
index 79aaa336ceff..12350bcfd18d 100644
--- a/extensions/xai/video-generation-provider.test.ts
+++ b/extensions/xai/video-generation-provider.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover video generation provider plugin behavior.
 import {
   getProviderHttpMocks,
   installProviderHttpMockCleanup,
diff --git a/extensions/xai/video-generation-provider.ts b/extensions/xai/video-generation-provider.ts
index 6d5c88bb37f9..dffeffe2d10d 100644
--- a/extensions/xai/video-generation-provider.ts
+++ b/extensions/xai/video-generation-provider.ts
@@ -1,3 +1,4 @@
+// Xai provider module implements model/runtime integration.
 import { extensionForMime } from "openclaw/plugin-sdk/media-mime";
 import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth";
 import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime";
diff --git a/extensions/xai/web-search-contract-api.ts b/extensions/xai/web-search-contract-api.ts
index c283550b72da..fabe37f17d39 100644
--- a/extensions/xai/web-search-contract-api.ts
+++ b/extensions/xai/web-search-contract-api.ts
@@ -1,3 +1,4 @@
+// Xai API module exposes the plugin public contract.
 import type { WebSearchProviderPlugin } from "openclaw/plugin-sdk/provider-web-search-config-contract";
 import { buildXaiWebSearchProviderBase } from "./web-search-provider-shared.js";
 
diff --git a/extensions/xai/web-search-provider-shared.ts b/extensions/xai/web-search-provider-shared.ts
index 7a19e13a5cc9..1db3e5ed6df0 100644
--- a/extensions/xai/web-search-provider-shared.ts
+++ b/extensions/xai/web-search-provider-shared.ts
@@ -1,3 +1,4 @@
+// Xai provider module implements model/runtime integration.
 import {
   createWebSearchProviderContractFields,
   type WebSearchProviderPlugin,
diff --git a/extensions/xai/web-search.test.ts b/extensions/xai/web-search.test.ts
index e3e7ddd148e4..1d11886ffa76 100644
--- a/extensions/xai/web-search.test.ts
+++ b/extensions/xai/web-search.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover web search plugin behavior.
 import { createTestWizardPrompter } from "openclaw/plugin-sdk/plugin-test-runtime";
 import { NON_ENV_SECRETREF_MARKER } from "openclaw/plugin-sdk/provider-auth-runtime";
 import { createNonExitingRuntime } from "openclaw/plugin-sdk/runtime-env";
diff --git a/extensions/xai/web-search.ts b/extensions/xai/web-search.ts
index e2886cb06117..5fa13defa888 100644
--- a/extensions/xai/web-search.ts
+++ b/extensions/xai/web-search.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements web search behavior.
 import type {
   WebSearchProviderPlugin,
   WebSearchProviderSetupContext,
diff --git a/extensions/xai/x-search-tool-shared.ts b/extensions/xai/x-search-tool-shared.ts
index e1fe952b0086..10da13e42f08 100644
--- a/extensions/xai/x-search-tool-shared.ts
+++ b/extensions/xai/x-search-tool-shared.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements x search tool shared behavior.
 import type { AgentToolResult } from "openclaw/plugin-sdk/agent-core";
 import { Type } from "typebox";
 
diff --git a/extensions/xai/x-search.live.test.ts b/extensions/xai/x-search.live.test.ts
index 376590970eb4..09e7ec727790 100644
--- a/extensions/xai/x-search.live.test.ts
+++ b/extensions/xai/x-search.live.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover x search plugin behavior.
 import { isBillingErrorMessage } from "openclaw/plugin-sdk/test-env";
 import { describe, expect, it } from "vitest";
 import { createXSearchTool } from "./x-search.js";
diff --git a/extensions/xai/x-search.test.ts b/extensions/xai/x-search.test.ts
index 2bd95085ac4c..528582a768f2 100644
--- a/extensions/xai/x-search.test.ts
+++ b/extensions/xai/x-search.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover x search plugin behavior.
 import { withFetchPreconnect } from "openclaw/plugin-sdk/test-env";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { createXSearchTool } from "./x-search.js";
diff --git a/extensions/xai/x-search.ts b/extensions/xai/x-search.ts
index 19aa959a472a..50c8110a9269 100644
--- a/extensions/xai/x-search.ts
+++ b/extensions/xai/x-search.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements x search behavior.
 import {
   jsonResult,
   readCache,
diff --git a/extensions/xai/xai-oauth.test.ts b/extensions/xai/xai-oauth.test.ts
index 6b292800e97d..b0a55f2c12b3 100644
--- a/extensions/xai/xai-oauth.test.ts
+++ b/extensions/xai/xai-oauth.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover xai oauth plugin behavior.
 import type { ProviderAuthContext } from "openclaw/plugin-sdk/plugin-entry";
 import {
   createRuntimeEnv,
diff --git a/extensions/xai/xai-oauth.ts b/extensions/xai/xai-oauth.ts
index 3ebf6efdb1dd..19f64d9c228f 100644
--- a/extensions/xai/xai-oauth.ts
+++ b/extensions/xai/xai-oauth.ts
@@ -1,3 +1,4 @@
+// Xai plugin module implements xai oauth behavior.
 import { randomBytes } from "node:crypto";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import {
diff --git a/extensions/xai/xai.live.test.ts b/extensions/xai/xai.live.test.ts
index 212c77dd04fa..7de11b1f8b3d 100644
--- a/extensions/xai/xai.live.test.ts
+++ b/extensions/xai/xai.live.test.ts
@@ -1,3 +1,4 @@
+// Xai tests cover xai plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/zalo/api.ts b/extensions/zalo/api.ts
index de22c3b17a29..8a1920dc98c4 100644
--- a/extensions/zalo/api.ts
+++ b/extensions/zalo/api.ts
@@ -1,3 +1,4 @@
+// Zalo API module exposes the plugin public contract.
 export { zaloPlugin } from "./src/channel.js";
 export {
   createZaloSetupWizardProxy,
diff --git a/extensions/zalo/channel-plugin-api.ts b/extensions/zalo/channel-plugin-api.ts
index 871c01eb4d04..2f2810bbeea4 100644
--- a/extensions/zalo/channel-plugin-api.ts
+++ b/extensions/zalo/channel-plugin-api.ts
@@ -1 +1,2 @@
+// Zalo API module exposes the plugin public contract.
 export { zaloPlugin } from "./src/channel.js";
diff --git a/extensions/zalo/contract-api.ts b/extensions/zalo/contract-api.ts
index 0dc98ccd3dfd..eacaff05640f 100644
--- a/extensions/zalo/contract-api.ts
+++ b/extensions/zalo/contract-api.ts
@@ -1,3 +1,4 @@
+// Zalo API module exposes the plugin public contract.
 export { resolveZaloRuntimeGroupPolicy } from "./src/group-access.js";
 export {
   collectRuntimeConfigAssignments,
diff --git a/extensions/zalo/index.test.ts b/extensions/zalo/index.test.ts
index bb56fca75691..ec6f1ddf3603 100644
--- a/extensions/zalo/index.test.ts
+++ b/extensions/zalo/index.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover index plugin behavior.
 import { assertBundledChannelEntries } from "openclaw/plugin-sdk/channel-test-helpers";
 import { describe } from "vitest";
 import entry from "./index.js";
diff --git a/extensions/zalo/index.ts b/extensions/zalo/index.ts
index ef946dc3bfc7..cd55610dc788 100644
--- a/extensions/zalo/index.ts
+++ b/extensions/zalo/index.ts
@@ -1,3 +1,4 @@
+// Zalo plugin entrypoint registers its OpenClaw integration.
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelEntry({
diff --git a/extensions/zalo/runtime-api.test.ts b/extensions/zalo/runtime-api.test.ts
index a9967fe6c2ce..db302dd265d4 100644
--- a/extensions/zalo/runtime-api.test.ts
+++ b/extensions/zalo/runtime-api.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover runtime api plugin behavior.
 import { describe, expect, it } from "vitest";
 import * as runtime from "./runtime-api.js";
 
diff --git a/extensions/zalo/runtime-api.ts b/extensions/zalo/runtime-api.ts
index c9278509b7f9..3dcaea3a0b1e 100644
--- a/extensions/zalo/runtime-api.ts
+++ b/extensions/zalo/runtime-api.ts
@@ -1,3 +1,4 @@
+// Zalo API module exposes the plugin public contract.
 export {
   addWildcardAllowFrom,
   applyAccountNameToChannelSection,
diff --git a/extensions/zalo/secret-contract-api.ts b/extensions/zalo/secret-contract-api.ts
index 9f44ef28569c..9bc247d0d1b2 100644
--- a/extensions/zalo/secret-contract-api.ts
+++ b/extensions/zalo/secret-contract-api.ts
@@ -1,3 +1,4 @@
+// Zalo API module exposes the plugin public contract.
 export {
   channelSecrets,
   collectRuntimeConfigAssignments,
diff --git a/extensions/zalo/setup-api.ts b/extensions/zalo/setup-api.ts
index 7f1804ad2fe5..525a93c2bde4 100644
--- a/extensions/zalo/setup-api.ts
+++ b/extensions/zalo/setup-api.ts
@@ -1,3 +1,4 @@
+// Zalo API module exposes the plugin public contract.
 import { loadBundledEntryExportSync } from "openclaw/plugin-sdk/channel-entry-contract";
 
 type SetupSurfaceModule = typeof import("./src/setup-surface.js");
diff --git a/extensions/zalo/setup-entry.ts b/extensions/zalo/setup-entry.ts
index e17428895884..cfde1c5ef249 100644
--- a/extensions/zalo/setup-entry.ts
+++ b/extensions/zalo/setup-entry.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/zalo/src/accounts.test.ts b/extensions/zalo/src/accounts.test.ts
index 7a2dc69ffe5c..618b8f743e29 100644
--- a/extensions/zalo/src/accounts.test.ts
+++ b/extensions/zalo/src/accounts.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover accounts plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   listEnabledZaloAccounts,
diff --git a/extensions/zalo/src/accounts.ts b/extensions/zalo/src/accounts.ts
index 5814a1bbd6e2..09a37d426a73 100644
--- a/extensions/zalo/src/accounts.ts
+++ b/extensions/zalo/src/accounts.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements accounts behavior.
 import {
   createAccountListHelpers,
   resolveMergedAccountConfig,
diff --git a/extensions/zalo/src/actions.runtime.ts b/extensions/zalo/src/actions.runtime.ts
index 0fd0a2c6f58d..38305c380eed 100644
--- a/extensions/zalo/src/actions.runtime.ts
+++ b/extensions/zalo/src/actions.runtime.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements actions behavior.
 import { sendMessageZalo as sendMessageZaloImpl } from "./send.js";
 
 export const zaloActionsRuntime = {
diff --git a/extensions/zalo/src/actions.test.ts b/extensions/zalo/src/actions.test.ts
index 4b8841a29e8d..ed4e7a4404fd 100644
--- a/extensions/zalo/src/actions.test.ts
+++ b/extensions/zalo/src/actions.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover actions plugin behavior.
 import { describe, expect, it } from "vitest";
 import { zaloMessageActions } from "./actions.js";
 import type { OpenClawConfig } from "./runtime-api.js";
diff --git a/extensions/zalo/src/actions.ts b/extensions/zalo/src/actions.ts
index ee28ec984f31..1a4ca9136900 100644
--- a/extensions/zalo/src/actions.ts
+++ b/extensions/zalo/src/actions.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements actions behavior.
 import { jsonResult, readStringParam } from "openclaw/plugin-sdk/channel-actions";
 import type {
   ChannelMessageActionAdapter,
diff --git a/extensions/zalo/src/api.test.ts b/extensions/zalo/src/api.test.ts
index f6379c19e0b7..a4df1c4cc757 100644
--- a/extensions/zalo/src/api.test.ts
+++ b/extensions/zalo/src/api.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover api plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
diff --git a/extensions/zalo/src/approval-auth.test.ts b/extensions/zalo/src/approval-auth.test.ts
index a718890fe31a..3e7b360a15e3 100644
--- a/extensions/zalo/src/approval-auth.test.ts
+++ b/extensions/zalo/src/approval-auth.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover approval auth plugin behavior.
 import { describe, expect, it } from "vitest";
 import { zaloApprovalAuth } from "./approval-auth.js";
 
diff --git a/extensions/zalo/src/approval-auth.ts b/extensions/zalo/src/approval-auth.ts
index 32ba785a8591..b3948bd7cea9 100644
--- a/extensions/zalo/src/approval-auth.ts
+++ b/extensions/zalo/src/approval-auth.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements approval auth behavior.
 import {
   createResolvedApproverActionAuthAdapter,
   resolveApprovalApprovers,
diff --git a/extensions/zalo/src/channel.directory.test.ts b/extensions/zalo/src/channel.directory.test.ts
index 7709634e0e1d..ceb2d4bfdee9 100644
--- a/extensions/zalo/src/channel.directory.test.ts
+++ b/extensions/zalo/src/channel.directory.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover channelirectory plugin behavior.
 import {
   createDirectoryTestRuntime,
   expectDirectorySurface,
diff --git a/extensions/zalo/src/channel.runtime.ts b/extensions/zalo/src/channel.runtime.ts
index 815e464b4fac..fa90eb17aa4f 100644
--- a/extensions/zalo/src/channel.runtime.ts
+++ b/extensions/zalo/src/channel.runtime.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements channel behavior.
 import { createAccountStatusSink } from "openclaw/plugin-sdk/channel-outbound";
 import { probeZalo } from "./probe.js";
 import { resolveZaloProxyFetch } from "./proxy.js";
diff --git a/extensions/zalo/src/channel.startup.test.ts b/extensions/zalo/src/channel.startup.test.ts
index c981f1d90fe9..1675b24fbd7d 100644
--- a/extensions/zalo/src/channel.startup.test.ts
+++ b/extensions/zalo/src/channel.startup.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover channel.startup plugin behavior.
 import {
   expectLifecyclePatch,
   expectPendingUntilAbort,
diff --git a/extensions/zalo/src/channel.ts b/extensions/zalo/src/channel.ts
index 50b507c70a77..2101e6d350fd 100644
--- a/extensions/zalo/src/channel.ts
+++ b/extensions/zalo/src/channel.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements channel behavior.
 import { describeWebhookAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import { formatAllowFromLowercase } from "openclaw/plugin-sdk/allow-from";
diff --git a/extensions/zalo/src/config-schema.test.ts b/extensions/zalo/src/config-schema.test.ts
index 345475234900..23083cfcb31e 100644
--- a/extensions/zalo/src/config-schema.test.ts
+++ b/extensions/zalo/src/config-schema.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover config schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { ZaloConfigSchema } from "./config-schema.js";
 
diff --git a/extensions/zalo/src/config-schema.ts b/extensions/zalo/src/config-schema.ts
index e16302bc870d..cc4cdef3fbb0 100644
--- a/extensions/zalo/src/config-schema.ts
+++ b/extensions/zalo/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Zalo helper module supports config schema behavior.
 import {
   AllowFromListSchema,
   buildCatchallMultiAccountChannelSchema,
diff --git a/extensions/zalo/src/group-access.ts b/extensions/zalo/src/group-access.ts
index 462acdc1ab6d..0a0813c3a770 100644
--- a/extensions/zalo/src/group-access.ts
+++ b/extensions/zalo/src/group-access.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements group access behavior.
 import type { GroupPolicy } from "openclaw/plugin-sdk/config-contracts";
 import { resolveOpenProviderRuntimeGroupPolicy } from "openclaw/plugin-sdk/runtime-group-policy";
 
diff --git a/extensions/zalo/src/monitor-durable.test.ts b/extensions/zalo/src/monitor-durable.test.ts
index eaa2d2392754..ea3127ca843c 100644
--- a/extensions/zalo/src/monitor-durable.test.ts
+++ b/extensions/zalo/src/monitor-durable.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover monitor durable plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   prepareZaloDurableReplyPayload,
diff --git a/extensions/zalo/src/monitor-durable.ts b/extensions/zalo/src/monitor-durable.ts
index 3413c6d95a2e..ba25e865411d 100644
--- a/extensions/zalo/src/monitor-durable.ts
+++ b/extensions/zalo/src/monitor-durable.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements monitor durable behavior.
 import type { MarkdownTableMode } from "openclaw/plugin-sdk/config-contracts";
 import { resolveSendableOutboundReplyParts } from "openclaw/plugin-sdk/reply-payload";
 import type { OutboundReplyPayload } from "openclaw/plugin-sdk/reply-payload";
diff --git a/extensions/zalo/src/monitor.group-policy.test.ts b/extensions/zalo/src/monitor.group-policy.test.ts
index 071608c0b44f..0060dea438d6 100644
--- a/extensions/zalo/src/monitor.group-policy.test.ts
+++ b/extensions/zalo/src/monitor.group-policy.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover monitor.group policy plugin behavior.
 import { resolveStableChannelMessageIngress } from "openclaw/plugin-sdk/channel-ingress-runtime";
 import type { GroupPolicy, OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";
 import { describe, expect, it, vi } from "vitest";
diff --git a/extensions/zalo/src/monitor.image.polling.test.ts b/extensions/zalo/src/monitor.image.polling.test.ts
index 1bda5e529cb9..8a0aaf343de0 100644
--- a/extensions/zalo/src/monitor.image.polling.test.ts
+++ b/extensions/zalo/src/monitor.image.polling.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover monitor.image.polling plugin behavior.
 import { createRuntimeEnv } from "openclaw/plugin-sdk/plugin-test-runtime";
 import { afterAll, beforeEach, describe, expect, it } from "vitest";
 import {
diff --git a/extensions/zalo/src/monitor.lifecycle.test.ts b/extensions/zalo/src/monitor.lifecycle.test.ts
index 98102e50162a..90fa84be243a 100644
--- a/extensions/zalo/src/monitor.lifecycle.test.ts
+++ b/extensions/zalo/src/monitor.lifecycle.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover monitor.lifecycle plugin behavior.
 import {
   createEmptyPluginRegistry,
   createRuntimeEnv,
diff --git a/extensions/zalo/src/monitor.pairing.lifecycle.test.ts b/extensions/zalo/src/monitor.pairing.lifecycle.test.ts
index cf011c86fedd..f1bb0ac84ef3 100644
--- a/extensions/zalo/src/monitor.pairing.lifecycle.test.ts
+++ b/extensions/zalo/src/monitor.pairing.lifecycle.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover monitor.pairing.lifecycle plugin behavior.
 import { withServer } from "openclaw/plugin-sdk/test-env";
 import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
 import {
diff --git a/extensions/zalo/src/monitor.polling.media-reply.test.ts b/extensions/zalo/src/monitor.polling.media-reply.test.ts
index 5eabae501252..18cabc3eaf61 100644
--- a/extensions/zalo/src/monitor.polling.media-reply.test.ts
+++ b/extensions/zalo/src/monitor.polling.media-reply.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover monitor.polling.media reply plugin behavior.
 import { chmod, mkdir, writeFile } from "node:fs/promises";
 import type { ServerResponse } from "node:http";
 import { join } from "node:path";
diff --git a/extensions/zalo/src/monitor.reply-once.lifecycle.test.ts b/extensions/zalo/src/monitor.reply-once.lifecycle.test.ts
index e0e85e5c51a1..d99c82c30353 100644
--- a/extensions/zalo/src/monitor.reply-once.lifecycle.test.ts
+++ b/extensions/zalo/src/monitor.reply-once.lifecycle.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover monitor.reply once.lifecycle plugin behavior.
 import { withServer } from "openclaw/plugin-sdk/test-env";
 import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { PluginRuntime } from "../runtime-api.js";
diff --git a/extensions/zalo/src/monitor.ts b/extensions/zalo/src/monitor.ts
index 03ecb66c2458..f7d513c8ed85 100644
--- a/extensions/zalo/src/monitor.ts
+++ b/extensions/zalo/src/monitor.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements monitor behavior.
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { logTypingFailure } from "openclaw/plugin-sdk/channel-feedback";
 import { resolveStableChannelMessageIngress } from "openclaw/plugin-sdk/channel-ingress-runtime";
diff --git a/extensions/zalo/src/monitor.types.ts b/extensions/zalo/src/monitor.types.ts
index 0ac455a2aa96..5b52278f0ff7 100644
--- a/extensions/zalo/src/monitor.types.ts
+++ b/extensions/zalo/src/monitor.types.ts
@@ -1,3 +1,4 @@
+// Zalo type declarations define plugin contracts.
 export type ZaloRuntimeEnv = {
   log?: (message: string) => void;
   error?: (message: string) => void;
diff --git a/extensions/zalo/src/monitor.webhook.test.ts b/extensions/zalo/src/monitor.webhook.test.ts
index c59a91bb96c8..28af41fe02bb 100644
--- a/extensions/zalo/src/monitor.webhook.test.ts
+++ b/extensions/zalo/src/monitor.webhook.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover monitor.webhook plugin behavior.
 import type { RequestListener } from "node:http";
 import {
   createEmptyPluginRegistry,
diff --git a/extensions/zalo/src/monitor.webhook.ts b/extensions/zalo/src/monitor.webhook.ts
index 5a142cc5f635..2ca3ecff2bf0 100644
--- a/extensions/zalo/src/monitor.webhook.ts
+++ b/extensions/zalo/src/monitor.webhook.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements monitor.webhook behavior.
 import type { IncomingMessage, ServerResponse } from "node:http";
 import { createClaimableDedupe } from "openclaw/plugin-sdk/persistent-dedupe";
 import { safeEqualSecret } from "openclaw/plugin-sdk/security-runtime";
diff --git a/extensions/zalo/src/outbound-media.test.ts b/extensions/zalo/src/outbound-media.test.ts
index f038bf359619..02dedb7b1edd 100644
--- a/extensions/zalo/src/outbound-media.test.ts
+++ b/extensions/zalo/src/outbound-media.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover outbound media plugin behavior.
 import { stat } from "node:fs/promises";
 import { join } from "node:path";
 import { resolvePreferredOpenClawTmpDir } from "openclaw/plugin-sdk/temp-path";
diff --git a/extensions/zalo/src/outbound-media.ts b/extensions/zalo/src/outbound-media.ts
index 368546ad5a60..cc5d993ac148 100644
--- a/extensions/zalo/src/outbound-media.ts
+++ b/extensions/zalo/src/outbound-media.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements outbound media behavior.
 import { randomBytes } from "node:crypto";
 import { rmSync } from "node:fs";
 import { readdir, readFile, stat, unlink } from "node:fs/promises";
diff --git a/extensions/zalo/src/outbound-payload.contract.test.ts b/extensions/zalo/src/outbound-payload.contract.test.ts
index 25933aa6310a..0ab2a6cf7676 100644
--- a/extensions/zalo/src/outbound-payload.contract.test.ts
+++ b/extensions/zalo/src/outbound-payload.contract.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover outbound payload.contract plugin behavior.
 import {
   installChannelOutboundPayloadContractSuite,
   primeChannelOutboundSendMock,
diff --git a/extensions/zalo/src/probe.ts b/extensions/zalo/src/probe.ts
index 676a5dda490a..9435b69b8d86 100644
--- a/extensions/zalo/src/probe.ts
+++ b/extensions/zalo/src/probe.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements probe behavior.
 import type { BaseProbeResult } from "openclaw/plugin-sdk/channel-contract";
 import { getMe, ZaloApiError, type ZaloBotInfo, type ZaloFetch } from "./api.js";
 
diff --git a/extensions/zalo/src/proxy.ts b/extensions/zalo/src/proxy.ts
index 266ea9874814..ba09f728f597 100644
--- a/extensions/zalo/src/proxy.ts
+++ b/extensions/zalo/src/proxy.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements proxy behavior.
 import { makeProxyFetch } from "openclaw/plugin-sdk/fetch-runtime";
 import type { ZaloFetch } from "./api.js";
 
diff --git a/extensions/zalo/src/runtime-api.ts b/extensions/zalo/src/runtime-api.ts
index 4b29931534eb..c6d41bb26af2 100644
--- a/extensions/zalo/src/runtime-api.ts
+++ b/extensions/zalo/src/runtime-api.ts
@@ -1,3 +1,4 @@
+// Zalo API module exposes the plugin public contract.
 export {
   type BaseProbeResult,
   type BaseTokenResolution,
@@ -45,16 +46,10 @@ export {
   normalizeResolvedSecretInputString,
   normalizeSecretInputString,
 } from "./runtime-support.js";
-export {
-  buildTokenChannelStatusSummary,
-  PAIRING_APPROVED_MESSAGE,
-} from "./runtime-support.js";
+export { buildTokenChannelStatusSummary, PAIRING_APPROVED_MESSAGE } from "./runtime-support.js";
 export { buildBaseAccountStatusSnapshot } from "./runtime-support.js";
 export { chunkTextForOutbound } from "./runtime-support.js";
-export {
-  formatAllowFromLowercase,
-  isNormalizedSenderAllowed,
-} from "./runtime-support.js";
+export { formatAllowFromLowercase, isNormalizedSenderAllowed } from "./runtime-support.js";
 export {
   resolveDefaultGroupPolicy,
   resolveOpenProviderRuntimeGroupPolicy,
diff --git a/extensions/zalo/src/runtime-support.ts b/extensions/zalo/src/runtime-support.ts
index c6eb554dc5c6..6caa3c0fd287 100644
--- a/extensions/zalo/src/runtime-support.ts
+++ b/extensions/zalo/src/runtime-support.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements runtime support behavior.
 export type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 export type { OpenClawConfig, GroupPolicy } from "openclaw/plugin-sdk/config-contracts";
 export type { MarkdownTableMode } from "openclaw/plugin-sdk/config-contracts";
diff --git a/extensions/zalo/src/runtime.ts b/extensions/zalo/src/runtime.ts
index c86489867a78..f241e1bb79e0 100644
--- a/extensions/zalo/src/runtime.ts
+++ b/extensions/zalo/src/runtime.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements runtime behavior.
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 import type { PluginRuntime } from "./runtime-support.js";
 
diff --git a/extensions/zalo/src/secret-contract.ts b/extensions/zalo/src/secret-contract.ts
index 535a5d5b385d..2b098cf006dd 100644
--- a/extensions/zalo/src/secret-contract.ts
+++ b/extensions/zalo/src/secret-contract.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements secret contract behavior.
 import {
   collectConditionalChannelFieldAssignments,
   getChannelSurface,
diff --git a/extensions/zalo/src/secret-input.ts b/extensions/zalo/src/secret-input.ts
index 9d29c36d424f..f293a399aefd 100644
--- a/extensions/zalo/src/secret-input.ts
+++ b/extensions/zalo/src/secret-input.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements secret input behavior.
 export {
   buildSecretInputSchema,
   normalizeResolvedSecretInputString,
diff --git a/extensions/zalo/src/send.test.ts b/extensions/zalo/src/send.test.ts
index a2dee06ce8c0..0f4e6b7f22f9 100644
--- a/extensions/zalo/src/send.test.ts
+++ b/extensions/zalo/src/send.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover send plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const sendMessageMock = vi.fn();
diff --git a/extensions/zalo/src/send.ts b/extensions/zalo/src/send.ts
index db5e773be37d..641a28fb54f4 100644
--- a/extensions/zalo/src/send.ts
+++ b/extensions/zalo/src/send.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements send behavior.
 import {
   createMessageReceiptFromOutboundResults,
   type MessageReceipt,
diff --git a/extensions/zalo/src/session-route.ts b/extensions/zalo/src/session-route.ts
index cefa05c7579a..3357e0e0e98c 100644
--- a/extensions/zalo/src/session-route.ts
+++ b/extensions/zalo/src/session-route.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements session route behavior.
 import {
   buildChannelOutboundSessionRoute,
   stripChannelTargetPrefix,
diff --git a/extensions/zalo/src/setup-allow-from.ts b/extensions/zalo/src/setup-allow-from.ts
index d73b567b3e9e..28ae625e52f8 100644
--- a/extensions/zalo/src/setup-allow-from.ts
+++ b/extensions/zalo/src/setup-allow-from.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements setup allow from behavior.
 import {
   DEFAULT_ACCOUNT_ID,
   createSetupTranslator,
diff --git a/extensions/zalo/src/setup-core.ts b/extensions/zalo/src/setup-core.ts
index aade1281cacf..a39f334dc7a9 100644
--- a/extensions/zalo/src/setup-core.ts
+++ b/extensions/zalo/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements setup core behavior.
 import {
   addWildcardAllowFrom,
   createDelegatedSetupWizardProxy,
diff --git a/extensions/zalo/src/setup-status.test.ts b/extensions/zalo/src/setup-status.test.ts
index d7a84d46583a..577dc0c27361 100644
--- a/extensions/zalo/src/setup-status.test.ts
+++ b/extensions/zalo/src/setup-status.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover setup status plugin behavior.
 import { createPluginSetupWizardStatus } from "openclaw/plugin-sdk/plugin-test-runtime";
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../runtime-api.js";
diff --git a/extensions/zalo/src/setup-surface.test.ts b/extensions/zalo/src/setup-surface.test.ts
index 5065017a6a6f..20b9fa1dc3bc 100644
--- a/extensions/zalo/src/setup-surface.test.ts
+++ b/extensions/zalo/src/setup-surface.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover setup surface plugin behavior.
 import { adaptScopedAccountAccessor } from "openclaw/plugin-sdk/channel-config-helpers";
 import {
   createPluginSetupWizardConfigure,
diff --git a/extensions/zalo/src/setup-surface.ts b/extensions/zalo/src/setup-surface.ts
index 12b5398abaec..e60a0d43dff0 100644
--- a/extensions/zalo/src/setup-surface.ts
+++ b/extensions/zalo/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements setup surface behavior.
 import {
   buildSingleChannelSecretPromptState,
   createStandardChannelSetupStatus,
diff --git a/extensions/zalo/src/status-issues.test.ts b/extensions/zalo/src/status-issues.test.ts
index 77a8e1680e22..104a46046380 100644
--- a/extensions/zalo/src/status-issues.test.ts
+++ b/extensions/zalo/src/status-issues.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover status issues plugin behavior.
 import { expectOpenDmPolicyConfigIssue } from "openclaw/plugin-sdk/channel-test-helpers";
 import { describe, it } from "vitest";
 import { collectZaloStatusIssues } from "./status-issues.js";
diff --git a/extensions/zalo/src/status-issues.ts b/extensions/zalo/src/status-issues.ts
index 43552e02da87..4d90b741d09e 100644
--- a/extensions/zalo/src/status-issues.ts
+++ b/extensions/zalo/src/status-issues.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements status issues behavior.
 import type {
   ChannelAccountSnapshot,
   ChannelStatusIssue,
diff --git a/extensions/zalo/src/test-support/lifecycle-test-support.ts b/extensions/zalo/src/test-support/lifecycle-test-support.ts
index e0976eb85b03..2c390094f00a 100644
--- a/extensions/zalo/src/test-support/lifecycle-test-support.ts
+++ b/extensions/zalo/src/test-support/lifecycle-test-support.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements lifecycle test support behavior.
 import { request as httpRequest } from "node:http";
 import { createPluginRuntimeMediaMock } from "openclaw/plugin-sdk/channel-test-helpers";
 import { expect, vi } from "vitest";
diff --git a/extensions/zalo/src/test-support/monitor-mocks-test-support.ts b/extensions/zalo/src/test-support/monitor-mocks-test-support.ts
index 2f5b81cc69aa..5fb0aeaaca37 100644
--- a/extensions/zalo/src/test-support/monitor-mocks-test-support.ts
+++ b/extensions/zalo/src/test-support/monitor-mocks-test-support.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements monitor mocks test support behavior.
 import { createPluginRuntimeMock } from "openclaw/plugin-sdk/channel-test-helpers";
 import {
   createEmptyPluginRegistry,
diff --git a/extensions/zalo/src/token.test.ts b/extensions/zalo/src/token.test.ts
index 1618ef2b5625..b9d1519ba48e 100644
--- a/extensions/zalo/src/token.test.ts
+++ b/extensions/zalo/src/token.test.ts
@@ -1,3 +1,4 @@
+// Zalo tests cover token plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/zalo/src/token.ts b/extensions/zalo/src/token.ts
index bdb0831862ce..10d1cf636f83 100644
--- a/extensions/zalo/src/token.ts
+++ b/extensions/zalo/src/token.ts
@@ -1,3 +1,4 @@
+// Zalo plugin module implements token behavior.
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import type { BaseTokenResolution } from "openclaw/plugin-sdk/channel-contract";
 import { tryReadSecretFileSync } from "openclaw/plugin-sdk/core";
diff --git a/extensions/zalo/src/types.ts b/extensions/zalo/src/types.ts
index d9f431532f59..60ec0c842084 100644
--- a/extensions/zalo/src/types.ts
+++ b/extensions/zalo/src/types.ts
@@ -1,3 +1,4 @@
+// Zalo type declarations define plugin contracts.
 import type { SecretInput } from "openclaw/plugin-sdk/secret-input";
 
 export type ZaloAccountConfig = {
diff --git a/extensions/zalo/test-api.ts b/extensions/zalo/test-api.ts
index 698683bc1d0d..3d09c2db05d0 100644
--- a/extensions/zalo/test-api.ts
+++ b/extensions/zalo/test-api.ts
@@ -1 +1,2 @@
+// Zalo API module exposes the plugin public contract.
 export { resolveZaloRuntimeGroupPolicy } from "./src/group-access.js";
diff --git a/extensions/zalouser/api.ts b/extensions/zalouser/api.ts
index 2a23915fb105..9816cc28ff08 100644
--- a/extensions/zalouser/api.ts
+++ b/extensions/zalouser/api.ts
@@ -1,3 +1,4 @@
+// Zalouser API module exposes the plugin public contract.
 export { zalouserPlugin } from "./src/channel.js";
 export { zalouserSetupPlugin } from "./src/channel.setup.js";
 export { createZalouserTool } from "./src/tool.js";
diff --git a/extensions/zalouser/contract-api.ts b/extensions/zalouser/contract-api.ts
index 4dc839515b64..cfebbcd1fafa 100644
--- a/extensions/zalouser/contract-api.ts
+++ b/extensions/zalouser/contract-api.ts
@@ -1,2 +1,3 @@
+// Zalouser API module exposes the plugin public contract.
 export { collectZalouserSecurityAuditFindings } from "./src/security-audit.js";
 export { legacyConfigRules, normalizeCompatibilityConfig } from "./src/doctor-contract.js";
diff --git a/extensions/zalouser/doctor-contract-api.ts b/extensions/zalouser/doctor-contract-api.ts
index a7a56f234421..35980450a7f0 100644
--- a/extensions/zalouser/doctor-contract-api.ts
+++ b/extensions/zalouser/doctor-contract-api.ts
@@ -1 +1,2 @@
+// Zalouser API module exposes the plugin public contract.
 export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
diff --git a/extensions/zalouser/index.ts b/extensions/zalouser/index.ts
index e63d7b752a1b..8ee33c5de6cc 100644
--- a/extensions/zalouser/index.ts
+++ b/extensions/zalouser/index.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin entrypoint registers its OpenClaw integration.
 import {
   type AnyAgentTool,
   defineBundledChannelEntry,
diff --git a/extensions/zalouser/runtime-api.ts b/extensions/zalouser/runtime-api.ts
index bccde3535ffc..2b1f6293ea18 100644
--- a/extensions/zalouser/runtime-api.ts
+++ b/extensions/zalouser/runtime-api.ts
@@ -1,3 +1,4 @@
+// Zalouser API module exposes the plugin public contract.
 export {
   collectZalouserSecurityAuditFindings,
   createZalouserSetupWizardProxy,
diff --git a/extensions/zalouser/setup-entry.ts b/extensions/zalouser/setup-entry.ts
index 727590508e81..1b86b2216473 100644
--- a/extensions/zalouser/setup-entry.ts
+++ b/extensions/zalouser/setup-entry.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({
diff --git a/extensions/zalouser/src/accounts.runtime.ts b/extensions/zalouser/src/accounts.runtime.ts
index 6a3f6dcea29a..d53fd55540c3 100644
--- a/extensions/zalouser/src/accounts.runtime.ts
+++ b/extensions/zalouser/src/accounts.runtime.ts
@@ -1 +1,2 @@
+// Zalouser plugin module implements accounts behavior.
 export { checkZaloAuthenticated, getZaloUserInfo } from "./zalo-js.js";
diff --git a/extensions/zalouser/src/accounts.test-mocks.ts b/extensions/zalouser/src/accounts.test-mocks.ts
index 9e8e1f14de3a..d251309a437a 100644
--- a/extensions/zalouser/src/accounts.test-mocks.ts
+++ b/extensions/zalouser/src/accounts.test-mocks.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements accounts mocks behavior.
 import { vi } from "vitest";
 import { createDefaultResolvedZalouserAccount } from "./test-helpers.js";
 
diff --git a/extensions/zalouser/src/accounts.test.ts b/extensions/zalouser/src/accounts.test.ts
index 0ff293befe8d..5abfb37a8906 100644
--- a/extensions/zalouser/src/accounts.test.ts
+++ b/extensions/zalouser/src/accounts.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover accounts plugin behavior.
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../runtime-api.js";
diff --git a/extensions/zalouser/src/accounts.ts b/extensions/zalouser/src/accounts.ts
index d25cfddedd12..fe1338504d11 100644
--- a/extensions/zalouser/src/accounts.ts
+++ b/extensions/zalouser/src/accounts.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements accounts behavior.
 import {
   createAccountListHelpers,
   DEFAULT_ACCOUNT_ID,
diff --git a/extensions/zalouser/src/channel-api.ts b/extensions/zalouser/src/channel-api.ts
index 8875f01a7f60..c2aaf3d64bb5 100644
--- a/extensions/zalouser/src/channel-api.ts
+++ b/extensions/zalouser/src/channel-api.ts
@@ -1,3 +1,4 @@
+// Zalouser API module exposes the plugin public contract.
 export { formatAllowFromLowercase } from "openclaw/plugin-sdk/allow-from";
 export type {
   ChannelDirectoryEntry,
diff --git a/extensions/zalouser/src/channel.adapters.ts b/extensions/zalouser/src/channel.adapters.ts
index 73cb1a283803..e94d34688acc 100644
--- a/extensions/zalouser/src/channel.adapters.ts
+++ b/extensions/zalouser/src/channel.adapters.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements channel.adapters behavior.
 import { createScopedDmSecurityResolver } from "openclaw/plugin-sdk/channel-config-helpers";
 import { defineChannelMessageAdapter } from "openclaw/plugin-sdk/channel-outbound";
 import { createPairingPrefixStripper } from "openclaw/plugin-sdk/channel-pairing";
diff --git a/extensions/zalouser/src/channel.directory.test.ts b/extensions/zalouser/src/channel.directory.test.ts
index d531ac9519bd..b8801f96dab8 100644
--- a/extensions/zalouser/src/channel.directory.test.ts
+++ b/extensions/zalouser/src/channel.directory.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover channelirectory plugin behavior.
 import { beforeEach, describe, expect, it } from "vitest";
 import "./accounts.test-mocks.js";
 import { listZalouserDirectoryGroupMembers } from "./directory.js";
diff --git a/extensions/zalouser/src/channel.runtime.ts b/extensions/zalouser/src/channel.runtime.ts
index 6e01fe9d14e3..a4d27eebcc97 100644
--- a/extensions/zalouser/src/channel.runtime.ts
+++ b/extensions/zalouser/src/channel.runtime.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements channel behavior.
 export { probeZalouser } from "./probe.js";
 export { collectZalouserSecurityAuditFindings } from "./security-audit.js";
 export { sendMessageZalouser, sendReactionZalouser } from "./send.js";
diff --git a/extensions/zalouser/src/channel.sendpayload.test.ts b/extensions/zalouser/src/channel.sendpayload.test.ts
index 62f155b1c066..c74cc7ae651e 100644
--- a/extensions/zalouser/src/channel.sendpayload.test.ts
+++ b/extensions/zalouser/src/channel.sendpayload.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover channel.sendpayload plugin behavior.
 import {
   installChannelOutboundPayloadContractSuite,
   primeChannelOutboundSendMock,
diff --git a/extensions/zalouser/src/channel.setup.test.ts b/extensions/zalouser/src/channel.setup.test.ts
index 9db2ac5707c3..584beb535cdc 100644
--- a/extensions/zalouser/src/channel.setup.test.ts
+++ b/extensions/zalouser/src/channel.setup.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover channel.setup plugin behavior.
 import { mkdtemp, rm } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
diff --git a/extensions/zalouser/src/channel.setup.ts b/extensions/zalouser/src/channel.setup.ts
index 0e1df1c1711e..de8fe9283e1b 100644
--- a/extensions/zalouser/src/channel.setup.ts
+++ b/extensions/zalouser/src/channel.setup.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements channel.setup behavior.
 import type { ResolvedZalouserAccount } from "./accounts.js";
 import type { ChannelPlugin } from "./channel-api.js";
 import { zalouserSetupAdapter } from "./setup-core.js";
diff --git a/extensions/zalouser/src/channel.test.ts b/extensions/zalouser/src/channel.test.ts
index 2248ee83dff4..d267817dd035 100644
--- a/extensions/zalouser/src/channel.test.ts
+++ b/extensions/zalouser/src/channel.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover channel plugin behavior.
 import { createNonExitingRuntimeEnv } from "openclaw/plugin-sdk/plugin-test-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import "./zalo-js.test-mocks.js";
diff --git a/extensions/zalouser/src/channel.ts b/extensions/zalouser/src/channel.ts
index 0362878bbea7..2172853d2ff4 100644
--- a/extensions/zalouser/src/channel.ts
+++ b/extensions/zalouser/src/channel.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements channel behavior.
 import { createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { createAccountStatusSink } from "openclaw/plugin-sdk/channel-outbound";
 import { buildPassiveProbedChannelStatusSummary } from "openclaw/plugin-sdk/extension-shared";
diff --git a/extensions/zalouser/src/config-schema.ts b/extensions/zalouser/src/config-schema.ts
index 3ac7bd62d926..5214e682c91b 100644
--- a/extensions/zalouser/src/config-schema.ts
+++ b/extensions/zalouser/src/config-schema.ts
@@ -1,3 +1,4 @@
+// Zalouser helper module supports config schema behavior.
 import {
   AllowFromListSchema,
   buildCatchallMultiAccountChannelSchema,
diff --git a/extensions/zalouser/src/directory.ts b/extensions/zalouser/src/directory.ts
index bfbb4ee10d9f..ab3b498ba298 100644
--- a/extensions/zalouser/src/directory.ts
+++ b/extensions/zalouser/src/directory.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements directory behavior.
 import { resolveZalouserAccountSync } from "./accounts.js";
 import type { ChannelDirectoryEntry, OpenClawConfig } from "./channel-api.js";
 import { parseZalouserDirectoryGroupId } from "./session-route.js";
diff --git a/extensions/zalouser/src/doctor-contract.ts b/extensions/zalouser/src/doctor-contract.ts
index 4b3f0cd59ba2..10f40cf43390 100644
--- a/extensions/zalouser/src/doctor-contract.ts
+++ b/extensions/zalouser/src/doctor-contract.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements doctor contract behavior.
 import type {
   ChannelDoctorConfigMutation,
   ChannelDoctorLegacyConfigRule,
diff --git a/extensions/zalouser/src/doctor.test.ts b/extensions/zalouser/src/doctor.test.ts
index fb1abafe6801..e57042316bbb 100644
--- a/extensions/zalouser/src/doctor.test.ts
+++ b/extensions/zalouser/src/doctor.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover doctor plugin behavior.
 import { describe, expect, it } from "vitest";
 import { zalouserDoctor } from "./doctor.js";
 
diff --git a/extensions/zalouser/src/doctor.ts b/extensions/zalouser/src/doctor.ts
index ef8dedaada33..90e509374c5d 100644
--- a/extensions/zalouser/src/doctor.ts
+++ b/extensions/zalouser/src/doctor.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements doctor behavior.
 import type { ChannelDoctorAdapter } from "openclaw/plugin-sdk/channel-contract";
 import { createDangerousNameMatchingMutableAllowlistWarningCollector } from "openclaw/plugin-sdk/channel-policy";
 import { legacyConfigRules, normalizeCompatibilityConfig } from "./doctor-contract.js";
diff --git a/extensions/zalouser/src/group-policy.test.ts b/extensions/zalouser/src/group-policy.test.ts
index d9b539dc861d..0603df232c1f 100644
--- a/extensions/zalouser/src/group-policy.test.ts
+++ b/extensions/zalouser/src/group-policy.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover group policy plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildZalouserGroupCandidates,
diff --git a/extensions/zalouser/src/group-policy.ts b/extensions/zalouser/src/group-policy.ts
index 0711b0d8761e..ad2a84419357 100644
--- a/extensions/zalouser/src/group-policy.ts
+++ b/extensions/zalouser/src/group-policy.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements group policy behavior.
 import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { ZalouserGroupConfig } from "./types.js";
 
diff --git a/extensions/zalouser/src/message-sid.test.ts b/extensions/zalouser/src/message-sid.test.ts
index f964b0a791aa..0a95eac9cb5b 100644
--- a/extensions/zalouser/src/message-sid.test.ts
+++ b/extensions/zalouser/src/message-sid.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover message sid plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   formatZalouserMessageSidFull,
diff --git a/extensions/zalouser/src/message-sid.ts b/extensions/zalouser/src/message-sid.ts
index f68f131177d1..e67f1ae2efa6 100644
--- a/extensions/zalouser/src/message-sid.ts
+++ b/extensions/zalouser/src/message-sid.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements message sid behavior.
 function toMessageSidPart(value?: string | number | null): string {
   if (typeof value === "string") {
     return value.trim();
diff --git a/extensions/zalouser/src/monitor.account-scope.test.ts b/extensions/zalouser/src/monitor.account-scope.test.ts
index a451b710a34c..301cd4045f7a 100644
--- a/extensions/zalouser/src/monitor.account-scope.test.ts
+++ b/extensions/zalouser/src/monitor.account-scope.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover monitor.account scope plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig, PluginRuntime } from "../runtime-api.js";
 import "./monitor.send-mocks.js";
diff --git a/extensions/zalouser/src/monitor.group-gating.test.ts b/extensions/zalouser/src/monitor.group-gating.test.ts
index 7e9741aabe7e..7168dbaa4262 100644
--- a/extensions/zalouser/src/monitor.group-gating.test.ts
+++ b/extensions/zalouser/src/monitor.group-gating.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover monitor.group gating plugin behavior.
 import { createChannelMessageReplyPipeline } from "openclaw/plugin-sdk/channel-outbound";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig, PluginRuntime } from "../runtime-api.js";
diff --git a/extensions/zalouser/src/monitor.send-mocks.ts b/extensions/zalouser/src/monitor.send-mocks.ts
index 9e576f5e8309..7ded7625dac7 100644
--- a/extensions/zalouser/src/monitor.send-mocks.ts
+++ b/extensions/zalouser/src/monitor.send-mocks.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements monitor.send mocks behavior.
 import { vi } from "vitest";
 
 const sendMocks = vi.hoisted(() => ({
diff --git a/extensions/zalouser/src/monitor.ts b/extensions/zalouser/src/monitor.ts
index 4638cd55481e..80315d7f7b0a 100644
--- a/extensions/zalouser/src/monitor.ts
+++ b/extensions/zalouser/src/monitor.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements monitor behavior.
 import { mergeAllowlist, summarizeMapping } from "openclaw/plugin-sdk/allow-from";
 import {
   implicitMentionKindWhen,
diff --git a/extensions/zalouser/src/probe.test.ts b/extensions/zalouser/src/probe.test.ts
index 46703be514ff..5bdcdbdd76d2 100644
--- a/extensions/zalouser/src/probe.test.ts
+++ b/extensions/zalouser/src/probe.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover probe plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { probeZalouser } from "./probe.js";
diff --git a/extensions/zalouser/src/probe.ts b/extensions/zalouser/src/probe.ts
index d76b78fd37b1..468d4e7b0b36 100644
--- a/extensions/zalouser/src/probe.ts
+++ b/extensions/zalouser/src/probe.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements probe behavior.
 import type { BaseProbeResult } from "openclaw/plugin-sdk/channel-contract";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
diff --git a/extensions/zalouser/src/qr-temp-file.ts b/extensions/zalouser/src/qr-temp-file.ts
index 1ba9601ec40f..7d94c21626d1 100644
--- a/extensions/zalouser/src/qr-temp-file.ts
+++ b/extensions/zalouser/src/qr-temp-file.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements qr temp file behavior.
 import fsp from "node:fs/promises";
 import path from "node:path";
 import { resolvePreferredOpenClawTmpDir } from "openclaw/plugin-sdk/temp-path";
diff --git a/extensions/zalouser/src/reaction.test.ts b/extensions/zalouser/src/reaction.test.ts
index 1804752f7a68..c76114ae2c8e 100644
--- a/extensions/zalouser/src/reaction.test.ts
+++ b/extensions/zalouser/src/reaction.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover reaction plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeZaloReactionIcon } from "./reaction.js";
 
diff --git a/extensions/zalouser/src/reaction.ts b/extensions/zalouser/src/reaction.ts
index 8fb33f5ce362..5be19acc1608 100644
--- a/extensions/zalouser/src/reaction.ts
+++ b/extensions/zalouser/src/reaction.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements reaction behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { Reactions } from "./zca-constants.js";
 
diff --git a/extensions/zalouser/src/runtime.ts b/extensions/zalouser/src/runtime.ts
index 1acefdfb9bdd..ce9cf387a6da 100644
--- a/extensions/zalouser/src/runtime.ts
+++ b/extensions/zalouser/src/runtime.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements runtime behavior.
 import type { PluginRuntime } from "openclaw/plugin-sdk/core";
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 
diff --git a/extensions/zalouser/src/security-audit.test.ts b/extensions/zalouser/src/security-audit.test.ts
index 351bbe64645c..e1a10874362e 100644
--- a/extensions/zalouser/src/security-audit.test.ts
+++ b/extensions/zalouser/src/security-audit.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover security audit plugin behavior.
 import { describe, expect, it } from "vitest";
 import { collectZalouserSecurityAuditFindings } from "./security-audit.js";
 import type { ResolvedZalouserAccount, ZalouserAccountConfig } from "./types.js";
diff --git a/extensions/zalouser/src/security-audit.ts b/extensions/zalouser/src/security-audit.ts
index 0423df4efd0f..1ca90a2a136b 100644
--- a/extensions/zalouser/src/security-audit.ts
+++ b/extensions/zalouser/src/security-audit.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements security audit behavior.
 import { isDangerousNameMatchingEnabled } from "openclaw/plugin-sdk/dangerous-name-runtime";
 import type { ResolvedZalouserAccount } from "./accounts.js";
 
diff --git a/extensions/zalouser/src/send-receipt.ts b/extensions/zalouser/src/send-receipt.ts
index 17e3104aa535..09a0d6d7beeb 100644
--- a/extensions/zalouser/src/send-receipt.ts
+++ b/extensions/zalouser/src/send-receipt.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements send receipt behavior.
 import {
   createMessageReceiptFromOutboundResults,
   type MessageReceipt,
diff --git a/extensions/zalouser/src/send.test.ts b/extensions/zalouser/src/send.test.ts
index e5d9fb5dc7db..9c54ea4e44ab 100644
--- a/extensions/zalouser/src/send.test.ts
+++ b/extensions/zalouser/src/send.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover send plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createZalouserSendReceipt } from "./send-receipt.js";
 import {
diff --git a/extensions/zalouser/src/send.ts b/extensions/zalouser/src/send.ts
index c40d5de714a4..49bc2a0896b3 100644
--- a/extensions/zalouser/src/send.ts
+++ b/extensions/zalouser/src/send.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements send behavior.
 import { createZalouserSendReceipt } from "./send-receipt.js";
 import { parseZalouserTextStyles } from "./text-styles.js";
 import type { ZaloEventMessage, ZaloSendOptions, ZaloSendResult } from "./types.js";
diff --git a/extensions/zalouser/src/session-route.ts b/extensions/zalouser/src/session-route.ts
index e9b45753a09a..b4cb3000ccdf 100644
--- a/extensions/zalouser/src/session-route.ts
+++ b/extensions/zalouser/src/session-route.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements session route behavior.
 import {
   buildChannelOutboundSessionRoute,
   type ChannelOutboundSessionRouteParams,
diff --git a/extensions/zalouser/src/setup-core.ts b/extensions/zalouser/src/setup-core.ts
index 0a9d7716f2c0..1262ab1aa529 100644
--- a/extensions/zalouser/src/setup-core.ts
+++ b/extensions/zalouser/src/setup-core.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements setup core behavior.
 import {
   createDelegatedSetupWizardProxy,
   createPatchedAccountSetupAdapter,
diff --git a/extensions/zalouser/src/setup-surface.test.ts b/extensions/zalouser/src/setup-surface.test.ts
index 78a30e565b66..47446cd0c939 100644
--- a/extensions/zalouser/src/setup-surface.test.ts
+++ b/extensions/zalouser/src/setup-surface.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover setup surface plugin behavior.
 import {
   createPluginSetupWizardConfigure,
   createTestWizardPrompter,
diff --git a/extensions/zalouser/src/setup-surface.ts b/extensions/zalouser/src/setup-surface.ts
index aa64bc93e53f..bc93bfa2b81c 100644
--- a/extensions/zalouser/src/setup-surface.ts
+++ b/extensions/zalouser/src/setup-surface.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements setup surface behavior.
 import {
   addWildcardAllowFrom,
   DEFAULT_ACCOUNT_ID,
diff --git a/extensions/zalouser/src/setup-test-helpers.ts b/extensions/zalouser/src/setup-test-helpers.ts
index 73b42d24f02c..a00a69240510 100644
--- a/extensions/zalouser/src/setup-test-helpers.ts
+++ b/extensions/zalouser/src/setup-test-helpers.ts
@@ -1,3 +1,4 @@
+// Zalouser helper module supports setup test helpers behavior.
 import { createScopedDmSecurityResolver } from "openclaw/plugin-sdk/channel-config-helpers";
 import type { OpenClawConfig } from "../runtime-api.js";
 import {
diff --git a/extensions/zalouser/src/shared.ts b/extensions/zalouser/src/shared.ts
index c973d175720b..488114fdc905 100644
--- a/extensions/zalouser/src/shared.ts
+++ b/extensions/zalouser/src/shared.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements shared behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import {
   adaptScopedAccountAccessor,
diff --git a/extensions/zalouser/src/status-issues.test.ts b/extensions/zalouser/src/status-issues.test.ts
index d85cc5b31315..858326e06b72 100644
--- a/extensions/zalouser/src/status-issues.test.ts
+++ b/extensions/zalouser/src/status-issues.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover status issues plugin behavior.
 import { expectOpenDmPolicyConfigIssue } from "openclaw/plugin-sdk/channel-test-helpers";
 import { describe, expect, it } from "vitest";
 import { collectZalouserStatusIssues } from "./status-issues.js";
diff --git a/extensions/zalouser/src/status-issues.ts b/extensions/zalouser/src/status-issues.ts
index acc32163b4a6..bf9319729891 100644
--- a/extensions/zalouser/src/status-issues.ts
+++ b/extensions/zalouser/src/status-issues.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements status issues behavior.
 import type {
   ChannelAccountSnapshot,
   ChannelStatusIssue,
diff --git a/extensions/zalouser/src/test-helpers.ts b/extensions/zalouser/src/test-helpers.ts
index 7826938450d6..b607913427a0 100644
--- a/extensions/zalouser/src/test-helpers.ts
+++ b/extensions/zalouser/src/test-helpers.ts
@@ -1,3 +1,4 @@
+// Zalouser helper module supports test helpers behavior.
 import type { RuntimeEnv } from "../runtime-api.js";
 import type { ResolvedZalouserAccount } from "./types.js";
 
diff --git a/extensions/zalouser/src/text-styles.test.ts b/extensions/zalouser/src/text-styles.test.ts
index b2540f74bb6c..5dcb4569ddd1 100644
--- a/extensions/zalouser/src/text-styles.test.ts
+++ b/extensions/zalouser/src/text-styles.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover text styles plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseZalouserTextStyles } from "./text-styles.js";
 import { TextStyle } from "./zca-constants.js";
diff --git a/extensions/zalouser/src/text-styles.ts b/extensions/zalouser/src/text-styles.ts
index f01e9bd4542c..44eced707c6c 100644
--- a/extensions/zalouser/src/text-styles.ts
+++ b/extensions/zalouser/src/text-styles.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements text styles behavior.
 import { TextStyle, type Style } from "./zca-constants.js";
 
 const ESCAPE_SENTINEL_START = "\u0001";
diff --git a/extensions/zalouser/src/tool.test.ts b/extensions/zalouser/src/tool.test.ts
index 8ba0e606aa5f..86034f11fb1b 100644
--- a/extensions/zalouser/src/tool.test.ts
+++ b/extensions/zalouser/src/tool.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover tool plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { sendImageZalouser, sendLinkZalouser, sendMessageZalouser } from "./send.js";
 import { createZalouserTool, executeZalouserTool } from "./tool.js";
diff --git a/extensions/zalouser/src/tool.ts b/extensions/zalouser/src/tool.ts
index 4d9af06fe821..1b870a87dd0a 100644
--- a/extensions/zalouser/src/tool.ts
+++ b/extensions/zalouser/src/tool.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements tool behavior.
 import { stringEnum } from "openclaw/plugin-sdk/channel-actions";
 import type { AnyAgentTool, OpenClawPluginToolContext } from "openclaw/plugin-sdk/core";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
diff --git a/extensions/zalouser/src/types.ts b/extensions/zalouser/src/types.ts
index 037da4aeef3c..3ac504156fc0 100644
--- a/extensions/zalouser/src/types.ts
+++ b/extensions/zalouser/src/types.ts
@@ -1,3 +1,4 @@
+// Zalouser type declarations define plugin contracts.
 import type { MessageReceipt } from "openclaw/plugin-sdk/channel-outbound";
 import type { Style } from "./zca-constants.js";
 
diff --git a/extensions/zalouser/src/zalo-js.credentials.test.ts b/extensions/zalouser/src/zalo-js.credentials.test.ts
index 30b0a7b812ad..26fb7508dc62 100644
--- a/extensions/zalouser/src/zalo-js.credentials.test.ts
+++ b/extensions/zalouser/src/zalo-js.credentials.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover zalo js.credentials plugin behavior.
 import {
   lstat,
   mkdir,
diff --git a/extensions/zalouser/src/zalo-js.test-mocks.ts b/extensions/zalouser/src/zalo-js.test-mocks.ts
index 5899cc706bef..e9dbedb93506 100644
--- a/extensions/zalouser/src/zalo-js.test-mocks.ts
+++ b/extensions/zalouser/src/zalo-js.test-mocks.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements zalo js mocks behavior.
 import { vi, type Mock } from "vitest";
 
 type ZaloJsModule = typeof import("./zalo-js.js");
diff --git a/extensions/zalouser/src/zalo-js.ts b/extensions/zalouser/src/zalo-js.ts
index 9d605e49e135..e71223116ee7 100644
--- a/extensions/zalouser/src/zalo-js.ts
+++ b/extensions/zalouser/src/zalo-js.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements zalo js behavior.
 import { randomUUID } from "node:crypto";
 import fs from "node:fs";
 import os from "node:os";
diff --git a/extensions/zalouser/src/zalo-quote-metadata.test.ts b/extensions/zalouser/src/zalo-quote-metadata.test.ts
index 816ca62cb05c..b8ce6152e847 100644
--- a/extensions/zalouser/src/zalo-quote-metadata.test.ts
+++ b/extensions/zalouser/src/zalo-quote-metadata.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover zalo quote metadata plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { __testing as zaloTesting } from "./zalo-js.js";
 
diff --git a/extensions/zalouser/src/zca-client.test.ts b/extensions/zalouser/src/zca-client.test.ts
index 94aa79c7a231..8d53c521aa38 100644
--- a/extensions/zalouser/src/zca-client.test.ts
+++ b/extensions/zalouser/src/zca-client.test.ts
@@ -1,3 +1,4 @@
+// Zalouser tests cover zca client plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 
 describe("zca-client runtime loading", () => {
diff --git a/extensions/zalouser/src/zca-client.ts b/extensions/zalouser/src/zca-client.ts
index 35e123ce0883..989fd0f8f103 100644
--- a/extensions/zalouser/src/zca-client.ts
+++ b/extensions/zalouser/src/zca-client.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements zca client behavior.
 import {
   LoginQRCallbackEventType,
   Reactions,
diff --git a/extensions/zalouser/src/zca-constants.ts b/extensions/zalouser/src/zca-constants.ts
index ec906427e343..3c0a76ce22b7 100644
--- a/extensions/zalouser/src/zca-constants.ts
+++ b/extensions/zalouser/src/zca-constants.ts
@@ -1,3 +1,4 @@
+// Zalouser plugin module implements zca constants behavior.
 export const ThreadType = {
   User: 0,
   Group: 1,
diff --git a/extensions/zalouser/src/zca-js-exports.d.ts b/extensions/zalouser/src/zca-js-exports.d.ts
index 78deb4c9c1f7..efb33207da8e 100644
--- a/extensions/zalouser/src/zca-js-exports.d.ts
+++ b/extensions/zalouser/src/zca-js-exports.d.ts
@@ -1,3 +1,4 @@
+// Zalouser type declarations define plugin contracts.
 declare module "zca-js" {
   export const ThreadType: {
     User: number;
diff --git a/extensions/zalouser/test-api.ts b/extensions/zalouser/test-api.ts
index 7f037712d3a4..f60e0095350d 100644
--- a/extensions/zalouser/test-api.ts
+++ b/extensions/zalouser/test-api.ts
@@ -1,3 +1,4 @@
+// Zalouser API module exposes the plugin public contract.
 export { sendMessageZalouser } from "./src/send.js";
 export { parseZalouserOutboundTarget } from "./src/session-route.js";
 export {