Bootstrap reanimator chart viewer

bible-local/architecture/runtime-flows.md

@@ -0,0 +1,38 @@
+# Runtime Flows
+
+## Render Snapshot Flow
+
+1. receive one Reanimator JSON snapshot from the caller
+2. decode the payload into generic/object structures without dropping unknown fields
+3. identify known top-level sections
+4. build presentation sections in preferred order
+5. for each array section, build the union of keys across rows
+6. order columns with known fields first and unknown fields after
+7. render the page
+
+## Status Presentation Flow
+
+1. read the raw `status` value from the payload
+2. normalize only for presentation matching (`OK`, `Warning`, `Critical`, `Unknown`, `Empty`)
+3. apply status badge class
+4. do not change the raw value shown to the user
+
+## Unknown Field Invariant
+
+1. if a field exists in the input, it must remain visible somewhere in the output
+2. unknown fields may appear after known fields in a section table
+3. unknown top-level sections may be rendered after known sections
+4. the viewer must never silently discard fields because they are new or unexpected
+
+## Non-Augmentation Invariant
+
+1. do not compute aggregate health summaries unless they already exist in the JSON
+2. do not derive warnings/failures counters
+3. do not infer statuses for missing fields
+4. do not merge or rewrite source values
+
+## Simplicity Rule
+
+1. prefer server-rendered HTML
+2. keep JavaScript optional and presentation-only
+3. do not introduce a frontend framework without a concrete present need