docs: overnight documentation sweep

[virtuadex]

Summary

• Reviewed the full codebase for documentation drift against origin/main (local main was 308 commits behind; branch created from origin/main).
• Updated documentation to match current implementation (plugin platform adapters, deferred registry loading, slash-command registry, curator invariants).
• Saved run progress in /tmp/overnight-docs-sweep.md.

Sweep window

• From: 2026-06-28 00:00
• To: 2026-06-29 00:00 (host local TZ)

Recent changes reviewed

• 27f03243a fix(dashboard): stop ElevenLabs voice-list 401 log spam
• 95f2919f9 perf(startup): lazy-load gateway platform adapters (perf(startup): lazy-load gateway platform adapters #54448)
• 4c2961c51 fix(curator): never archive cron-referenced skills + floor use=0 pruning (fix(curator): never archive cron-referenced skills + floor use=0 pruning #54443)
• b31b0b9d9 docs: reconcile docs with code across last 3 releases (docs: reconcile docs with code across last 3 releases #54254)
• Plus ~35 additional commits in the window (desktop remote picker, Windows console fixes, gateway session persistence, etc.)

Documentation checked

• hermes_cli/commands.py ↔ website/docs/reference/slash-commands.md
• gateway/platform_registry.py, plugins/platforms/ ↔ website/docs/developer-guide/gateway-internals.md, SECURITY.md, SECURITY.es.md
• agent/curator.py ↔ website/docs/user-guide/features/curator.md
• Drift checklist: skills/.../overnight-docs-sweep/references/hermes-agent-drift-checklist.md

Documentation updated

• website/docs/developer-guide/gateway-internals.md — Key Files table + deferred platform loader behavior
• website/i18n/zh-Hans/.../gateway-internals.md — Key Files table (en sync)
• SECURITY.md, SECURITY.es.md — gateway external-surface adapter paths
• website/docs/reference/slash-commands.md — /reasoning full/clamp; CLI-only /prompt, /timestamps
• website/docs/user-guide/features/curator.md — cron-referenced skills + use_count == 0 grace

Verification

• git diff --check — passed
• npm run docs:build — skipped: script not configured
• npm run build (website/) — failed: docusaurus: not found (node_modules not installed in this environment)

Open questions / risks

• Operator machine had unrelated dirty apps/desktop/electron/main.cjs — stashed before branching; pop stash on main after sweep.
• zh-Hans gateway-internals Platform Adapters prose not fully re-translated (Key Files table only).

Autoreview

• Docs-only diff; no secrets or /tmp paths committed.
• Claims grounded in commands.py, platform_registry.py, curator.py, and existing gateway-internals Platform Adapters section.

[tonydwb]

Code Review Summary

Verdict: LGTM

Documentation sweep covering SECURITY.md updates for plugin architecture, gateway internals table, slash-commands reference, curator docs, and Chinese translation. All changes accurately reflect the current codebase structure.

Looks Good

• Platform adapter paths correctly updated to plugins/platforms/
• /reasoning command documentation expanded with full/clamp modes
• Cron-referenced skills and never-used skill policies documented in curator
• Deferred loader explanation added to gateway internals

---

Reviewed by Hermes Agent

[teknium1]

Thanks for the focused documentation audit. The deferred-loader and curator updates match current implementation: hermes_cli/plugins.py:1433-1445 registers bundled platform adapters lazily, and agent/curator.py:334-369 protects cron-referenced and recently never-used skills.

Problems

• website/docs/reference/slash-commands.md documents full / clamp for messaging /reasoning, but the gateway handler only supports display toggles, reset, none, and effort levels (gateway/slash_commands.py:2715-2737). full / clamp are classic-CLI behavior (hermes_cli/cli_commands_mixin.py:2518-2531).

Suggested changes

• Remove full|clamp from the messaging command row; retain them in the CLI row.

Automated hermes-sweeper review.

[teknium1]

full and clamp are not handled by the messaging gateway: gateway/slash_commands.py:2715-2737 accepts show/hide, reset, none, and effort levels only. Please omit these two options from the messaging row; they are implemented by the classic CLI in hermes_cli/cli_commands_mixin.py:2518-2531.

[teknium1]

Closing with credit — the curator documentation facts you surfaced here (cron-referenced skills protected from auto-archive, the never-used grace floor) landed via #74190 in their additive form, and the gateway deferred-loader documentation landed via the fresher #72422 variant. The remaining hunks were superseded by #73979. Thanks for the consistent sweeps — this cluster caught real drift!