bytelyst-devops-tools/docs
Hermes VM a8cf61a281 docs: Phase 8 — Telegram convention + delegation brief
Closes the Phase 8 line that's actually a docs/codebase change. The
other two Phase 8 items are VM-ops work (bot tokens + watchdog
extensions) and live as a delegation brief.

What's in this repo
  - `docs/hermes-operations.md` gains a "Telegram Notification
    Convention" section codifying:
      * routing per instance (Vijay → root chat, Bheem → Uma chat,
        cross-cutting → root)
      * silent-on-healthy + post-on-recovery
      * the numbered-emoji progress convention (`1️⃣`, `2️⃣`, …) and
        why it survives Telegram client rendering
      * approval-prompt UI expectation
      * "don't paste secrets" pointer back to `lib/logger.ts`'s
        redaction path-list
  - `docs/prompts/phase8-telegram-loop.md` — full delegation brief
    for the VM-side implementation. Design: dashboard backend writes
    new warnings (with `instance=<id>` tag, deduped over 1h) to an
    append-only log; both watchdogs tail it and route through the
    existing Telegram delivery path. Avoids splitting the delivery
    code into two places that would each need rate-limit + token-
    rotation handling. Brief is gated on Phase 4 — Uma's watchdog
    must exist first.
  - Roadmap Phase 8 ticked for "preserve numbered-emoji convention"
    (codified in operations doc); the other two items have notes
    pointing at the brief.

Phase 8 doesn't fully close in this repo because the delivery loop
needs real bot tokens and the Phase 4 Uma watchdog before it can be
end-to-end validated. The codebase's contribution is everything that
doesn't need a token: the convention, the design, and the delegation
brief.

Generated with [Devin](https://cli.devin.ai/docs)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-05-30 08:05:52 +00:00
..
adr docs(docker): roadmap v8 — peakpulse Phase A done + A3 ADR-0001 accepted 2026-05-27 02:54:08 -07:00
prompts docs: Phase 8 — Telegram convention + delegation brief 2026-05-30 08:05:52 +00:00
docker-build-optimization-roadmap.md docs(roadmap): record post-roadmap follow-ups complete (v15) 2026-05-28 18:07:36 -07:00
getting-started.md setup: handle managed python pre-commit installs 2026-05-05 03:26:55 +00:00
hermes_dashboard_roadmap.md Add Hermes snapshot diff view 2026-05-27 21:05:57 +00:00
hermes_dashboard_v2_roadmap.md docs: Phase 8 — Telegram convention + delegation brief 2026-05-30 08:05:52 +00:00
hermes-disaster-recovery.md Add Google Drive emergency bundle upload 2026-05-27 12:08:41 +00:00
hermes-operations.md docs: Phase 8 — Telegram convention + delegation brief 2026-05-30 08:05:52 +00:00
hermes-setup-upgrade-roadmap.md Add Hermes dashboard improvement backlog 2026-05-27 21:02:23 +00:00
hostinger-vm-maintenance.md add HostingerVM health-check and cleanup scripts 2026-05-27 18:53:20 +00:00
llm-utility-workflows.md docs: document local LLM utility workflows 2026-05-28 00:21:06 +00:00
operations.md feat: add gitea backup timer assets 2026-05-27 18:53:20 +00:00
remove_user_interactive.md docs: align repo navigation and operations notes 2026-05-05 03:11:46 +00:00
repo-map.md docs(repo-map): register agent-queue tool directory 2026-05-28 21:35:59 -07:00
tooling-status.md Add safe templates and tooling adoption docs 2026-05-05 01:16:27 +00:00
VM_OBSERVABILITY_ROADMAP.md feat(vm): fix devops-backend VM module — Phase 0.1 complete 2026-05-27 21:13:45 +00:00
vm-exposure-inventory.md fix: bind DevOps dashboard ports to loopback 2026-05-27 21:55:46 +00:00
vm-security-blind-spots-roadmap.md fix: bind DevOps dashboard ports to loopback 2026-05-27 21:55:46 +00:00