Architecture
archeious edited this page 2026-04-17 19:30:38 -06:00

Page revisions

1 Commits

Author SHA1 Message Date
archeious
461679dd64 Initial wiki: six-page documentation set
Pages:
- Home: overview, cluster-at-a-glance table, page index, with
  Monitor Dash render embedded.
- Architecture: two-architecture tradeoff (A: OTEL-native, B:
  ccusage-sourced), shared daemon contract (/usage JSON shape),
  calibration env vars.
- DataSources: architecture A implementation (docker-compose,
  otel-collector-config, prometheus.yml, Claude Code env,
  claude_code_* metric schema, PromQL per gauge, daemon sketch);
  architecture B implementation (ccusage CLI vs MCP server,
  watchdog JSONL tail, daemon sketch); recommendation.
- Hardware: four-gauge layout (5h fuel, tach, thinking ratio,
  cache hit), X27.168 steppers with SwitecX25 library, ESP32
  DevKit wiring with concrete GPIO assignments, firmware
  structure, enclosure V1 notes, BOM (~$80-90).
- Roadmap: eight phases (A daemon stdout through H character
  metrics), deferred list, out-of-scope list.
- Ideas: four exotic enclosure variants with render (steampunk
  chronometer, retro VFD array, minimalist birch e-ink,
  bio-digital cybernetic cluster), metrics brainstorm organised
  in seven categories, hardware / software wild ideas,
  unlikely-but-noted.

Images committed: monitor-dash.png referenced from Home and
Hardware; exotic-dashes.png referenced from Ideas.
2026-04-17 19:30:38 -06:00