Teknium
b31b0b9d95
docs: reconcile docs with code across last 3 releases ( #54254 )
...
Audited the last 3 releases (v2026.5.28..main) against the docs site and
fixed code-vs-docs drift:
- slash-commands: add /moa, /prompt, /pet, /hatch, /timestamps
- cli-commands: add hermes pets / project / desktop / whatsapp-cloud +
dashboard register; correct --insecure (now a deprecated no-op);
add gateway migrate-legacy + enroll --wake-url + dashboard --skip-build
- environment-variables: document the remaining ~48 env vars (SimpleX,
Photon, Teams adapter, per-platform *_ALLOW_ALL_USERS, home-channel vars,
IRC, Brave/Krea/Notion/Linear/Airtable/Tenor keys, QQ_SANDBOX) — full
OPTIONAL_ENV_VARS (265) now covered
- configuration: document tool_loop_guardrails, goals, prompt_caching,
network, onboarding, dashboard config blocks
- toolsets/tools-reference + tools.md: add coding/project toolsets and
read_terminal/project_* tools; remove the stale messaging toolset and
send_message agent tool (removed in #47856 ); drop stale RL-training prose
- messaging: new IRC channel page (adapter shipped without docs) + index
row + sidebar + env vars
- pets: document the /hatch AI generation pipeline + Nous/OpenRouter image
backend
- web-dashboard: document the bearer-token / TokenPrincipal service auth path
- purge agent-callable send_message references across guides/features and
the research-paper-writing skill (tool removed in #47856 )
Verified: docusaurus build succeeds; all authored internal links resolve.
2026-06-28 12:47:50 -07:00
Teknium
2d099fed1e
docs: deep audit — registry drift, stale claims, 2-week PR coverage, dashboard screenshot ( #40952 )
...
Full-corpus correctness audit of the hand-written docs against the codebase,
plus a 2-week merged-PR coverage sweep and one live dashboard screenshot.
Correctness (verified against COMMAND_REGISTRY / PROVIDER_REGISTRY / TOOLSETS /
tools.registry / DEFAULT_CONFIG / source):
- reference: add /version slash command, context_engine toolset, openai-api +
novita-ai to --provider; fix tool count 64->71; model_catalog ttl 24->1;
add profile describe to summary table; add real provider env vars
(LM_API_KEY/LM_BASE_URL, KIMI_CODING_API_KEY, ALIBABA_CODING_PLAN_*,
ANTHROPIC_BASE_URL, COPILOT_API_BASE_URL); fix faq "Windows: not natively".
- user-guide: fix broken `hermes -w -q` (->-z) and `hermes logs --tail` (->-f);
language list 8->16; aux slots 8->11; docker separate-dashboard claim;
_SECURITY_ARGS -> _BASE_SECURITY_ARGS.
- features: curator prune_builtins truth + missing CLI verbs; codex-runtime aux
keys (context_compression->compression, vision_detect->vision); kanban
terminate endpoint + promote/reassign/schedule/diagnostics/edit + per-profile
cap; mcp mTLS (client_cert/client_key); built-in-plugins nemo_relay +
teams_pipeline; api-server run approval endpoint; computer-use frontmatter.
- features N-Z + integrations: StepFun step-3-mini->step-3.5-flash; web-search
backends 4->8; tool-gateway image-model IDs; voice-mode STT/TTS enums; remove
phantom `rl` toolset; nous-portal status subcommand.
- messaging: WeCom typing/streaming cols; telegram transport default edit->auto;
sms host default; simplex/ntfy `gateway setup` + pairing approve; line
smart-chunking; matrix MATRIX_DM_AUTO_THREAD.
- developer-guide: build-a-plugin code examples (register_command signature,
ContextEngine/ImageGenProvider/MemoryProvider ABCs); model-provider-plugin
entry-point group hermes.plugins->hermes_agent.plugins; PLUGIN.yaml->plugin.yaml;
agent-loop stale LOC; web-search-provider phantom crawl().
PR coverage (2-week window, 149 feat PRs):
- desktop.md refreshed for ~15 shipped features (zh-Hans switcher, rebindable
shortcuts + zoom + Cmd+K, status-bar model picker + YOLO toggle, session-by-id
+ archive, multi-profile concurrent + cross-profile @session, composer history,
Providers pane, per-profile remote hosts, Grok OAuth, aux-pin warning).
- configuration.md gateway-streaming default corrected to per-platform.
- tool-gateway.md free tool pool entitlement note.
Media:
- New /img/dashboard/admin-config.png — live dashboard Config admin page
(captured from a clean profile, no secrets/personalization).
2026-06-07 01:39:06 -07:00
Teknium
8b6beaab5f
docs: 30-day overhaul — correctness audit, PR coverage, Nous Portal weave, sidebar reorg ( #33782 )
...
* docs(audit): correctness pass across getting-started, reference, features, messaging, developer-guide, guides, integrations, user-guide
* docs: add PR coverage for last 30d + Nous Portal weave + nav reorg + build fixes
- Add docs for top user-visible PRs that shipped without docs (api-server
session control, kanban features, telegram pin/edit, provider client tag,
xAI retired-model migration, cron name lookup, --branch update flag, etc.)
- Apply Nous Portal weave across 23 pages (tasteful one-liners on
getting-started/learning-path, configuration, overview, vision, x-search,
credential-pools, provider-routing, cron, codex-runtime, profiles, docker,
messaging/index, multiple guides, plus FAQ + index promotion)
- Reorganize sidebar: split Messaging into Popular/M365/Chinese/Other,
Reference into Command/Configuration/Tools-Skills sub-categories, add
orphan developer-guide pages (web-search-provider-plugin,
browser-supervisor), move features from Integrations back to Features,
fold lone spotify into Media & Web.
- Regenerate skill stubs + catalogs (kanban-codex-lane, hermes-s6-container-
supervision, web-pentest)
- Fix broken anchor links (security/cron, configuration/fallback, telegram
large-files, adding-platform-adapters step-by-step)
2026-05-28 02:41:36 -07:00
Teknium
3b096d6f6d
ntfy: tighten robustness, dedupe auth/truncation, add docs
...
Robustness:
- Surface 401/404 stream failures via _set_fatal_error() so the gateway's
runtime status reflects 'fatal: ntfy_unauthorized' / 'ntfy_topic_not_found'
instead of staying 'connected' when the reconnect loop halts. Matches
the pattern in whatsapp / telegram / sms adapters.
- Strip whitespace from auth tokens so pasted tokens with trailing
newlines don't produce malformed Authorization headers.
Simplicity:
- Extract _build_auth_header() and _truncate_body() to module-level
helpers, used by both NtfyAdapter and _standalone_send. Removes the
duplicated auth/truncation logic between the two paths.
Docs:
- website/docs/user-guide/messaging/ntfy.md — full setup guide,
identity-model warning, self-hosting, cron usage, troubleshooting.
- website/docs/reference/environment-variables.md — all 9 NTFY_* vars.
- website/docs/user-guide/messaging/index.md — platform comparison row.
- website/sidebars.ts — sidebar entry between simplex and open-webui.
Tests: 78/78 (+ 10 new robustness tests covering token hygiene, fatal
error propagation for 401/404, and the _truncate_body helper).
2026-05-23 16:13:01 -07:00
