Skip to content

docs: refresh stale platform counts (salvage #19053) - #20403

Merged
teknium1 merged 1 commit into
mainfrom
salvage/pr-19053
May 5, 2026
Merged

docs: refresh stale platform counts (salvage #19053)#20403
teknium1 merged 1 commit into
mainfrom
salvage/pr-19053

Conversation

@teknium1

@teknium1 teknium1 commented May 5, 2026

Copy link
Copy Markdown
Contributor

Refreshes the stale messaging-platform counts in docs and CLI tips to reflect the current 19+ core gateway adapters plus IRC and Microsoft Teams shipped as plugin platforms.

Changes:

  • hermes_cli/tips.py — "18 platforms" → "21 messaging platforms" incl. IRC and Microsoft Teams (+1/-1)
  • website/docs/integrations/index.md — "15+" → "19+", added Yuanbao to the list, kept Microsoft Teams link from current main (+1/-1)
  • website/scripts/generate-llms-txt.py — llms-txt blurb reflects 21+ platforms and the IRC/Teams plugin split (+2/-1)

Skipped from the original PR:

  • AGENTS.md — kept current main's version (already lists more platforms; PR's version was stale on this file)
  • website/docs/index.md — same, kept current main's count of 15+ (index page intentionally uses a conservative number)

Closes #19053 via salvage.

Original PR by @deep-name — authorship preserved.

…in platforms

AGENTS.md is the AI-assistant entry doc, so its counts get used as ground
truth. Several values had drifted, and the same drift had spread to a few
user-facing surfaces. Fixing all of them in one commit so the count claims
agree and clearly distinguish gateway-core from plugin-shipped platforms.

AGENTS.md:
- run_agent.py "~12k LOC" → "~14k LOC as of 2026-05-03" (actual 14,097)
- cli.py     "~11k LOC" → "~12k LOC as of 2026-05-03" (actual 12,043)
- tools/environments/ list now lists all 7 user-selectable terminal backends
  in canonical order, matching tools/terminal_tool.py:2214-2215
- gateway/platforms/ list adds yuanbao and wecom_callback; the 19 names
  match the user-facing list at website/docs/integrations/index.md
- plugins/ tree now mentions plugins/platforms/ (irc, teams)
- tests/ snapshot "~15k tests across ~700 files as of Apr 2026" →
  "~19k tests across ~890 files as of 2026-05-03"

User-facing count claims:
- hermes_cli/tips.py:195 — "19 platforms" → "21 messaging platforms" with
  IRC and Microsoft Teams added to the named list
- website/docs/index.md:49 — "6 terminal backends" → "7 terminal backends:
  ..., Vercel Sandbox" (also corrected by PR #19044; same edit content)
- website/docs/index.md:50 — "15+ platforms from one gateway" → "21+ messaging
  platforms (19 in the gateway, plus IRC and Microsoft Teams via plugins)"
- website/docs/integrations/index.md:83-85 — "15+ messaging platforms" → "19+",
  added yuanbao to the linked list. The surrounding text scopes it to "configured
  through the same gateway subsystem", so plugin platforms (IRC, Teams) are
  intentionally not in this list
- website/scripts/generate-llms-txt.py:205 — "15+ platforms" → "21+ messaging
  platforms — 19 native to the gateway plus IRC and Microsoft Teams via plugins"

LOC and date stamps follow the existing AGENTS.md "as of <date>" convention
(line 56 already used this pattern). Source of truth for the gateway count is
gateway/config.py:130-148 (PlatformID enum); plugin platforms live in
plugins/platforms/.

Out of scope:
- RELEASE_v0.9.0.md historical "16 platforms" claim (immutable history)
- userStories.json verbatim user quotes
- Programmatic count generation from gateway/config.py + plugin manifests
  is a worthwhile build-system change but separate from these content fixes
@teknium1
teknium1 merged commit 3beef57 into main May 5, 2026
9 of 11 checks passed
@teknium1
teknium1 deleted the salvage/pr-19053 branch May 5, 2026 20:45
@alt-glitch alt-glitch added type/docs Documentation improvements P3 Low — cosmetic, nice to have labels May 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P3 Low — cosmetic, nice to have type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants