bytelyst-devops-tools/docs
Hermes VM cf5428acd1 feat(dashboard): Phase 1 — harden hermes-ops backend + tests
- Short-TTL (30s) snapshot cache + in-flight coalescing so the panel poll and
  concurrent refreshes don't fan out ~20 systemctl/git/ps/du subprocesses each
  time; snapshot carries a `cached` flag and `getHermesOpsSnapshot({force})`.
- Distinguish "unit inactive" (down) from "probe couldn't run" (unknown): a new
  exec() wrapper reports whether the command actually ran (ENOENT/timeout =
  unknown) vs exited non-zero with output (e.g. systemctl is-active -> inactive).
  Per-field ProbeStatus on gateway/dashboard/timer/repo; warnings differentiate
  "is not active" from "status could not be determined".
- Robust Bheem/Uma checks: `runuser -u uma -- systemctl --user is-active/
  is-enabled` with a ps / existsSync fallback so a failed probe degrades to the
  legacy check instead of a false "down".
- Zod schema (HermesOpsSnapshotSchema) as the stable typed contract; the route
  validates output before sending. New status fields are additive (active/
  enabled/url/etc. preserved) so the existing web client is unaffected.
- Unit tests (mock execFile/fs): healthy snapshot, down vs unknown mapping,
  runuser->ps fallback, unreadable repo, cache hit + force bypass, request
  coalescing. Backend: 16 tests green.

Roadmap: check off Phase 1 items and Phase 5 P0 in hermes_dashboard_v2_roadmap.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-05-30 06:50:32 +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: add Hermes dashboard v2 roadmap + CI/E2E delegation brief 2026-05-30 05:26:49 +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 feat(dashboard): Phase 1 — harden hermes-ops backend + tests 2026-05-30 06:50:32 +00:00
hermes-disaster-recovery.md Add Google Drive emergency bundle upload 2026-05-27 12:08:41 +00:00
hermes-operations.md Add Hermes snapshot diff view 2026-05-27 21:05:57 +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