Initial public ModelForge release

2026-09-01 21:30:16 +02:00
commit 7082ab955a
490 changed files with 104252 additions and 0 deletions
@@ -0,0 +1,23 @@
+# ADR-0006: Stable hardware identity and typed observations
+
+**Status:** Accepted
+
+## Context
+
+Hostnames, GPU indexes and current telemetry are not stable identities. Containers can also expose an
+image-local machine ID that is identical on different hosts. Missing metrics cannot safely be stored
+as zero or ambiguous nulls.
+
+## Decision
+
+Direct nodes derive a privacy-preserving UUIDv5 from the OS machine ID; container deployments use a
+persisted UUID volume or explicit configured identity. GPU UUID is the accelerator identity within a
+node. Optional observations pair nullable values with `known`, `unknown`, `unsupported`, `unavailable`
+or `temporarily_failed`. Inventory and latest telemetry persist separately. Reconciliation preserves
+temporarily absent hardware.
+
+## Consequences
+
+Repeated scans are idempotent, container restarts preserve node identity, and absence is not confused
+with a measured zero. Moving the same GPU between nodes is represented honestly as a different node-
+accelerator relation. M1 stores only latest telemetry; history/export belongs to observability work.