You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+5-12Lines changed: 5 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -105,18 +105,11 @@ failure into a **structured fault**.
105
105
> scan tool. UDS / DTC diagnostics sit *above* the signal layer, as structured, queryable
106
106
> state. Robotics just hasn't drawn it yet.
107
107
108
-
-**"I'll just set an alert."** A threshold alert fires on a raw signal and is gone - no
109
-
entity, no lifecycle, no history, and it means something different on every robot. A fault is
110
-
confirmed, persisted, entity-attributed state you can query later - and, being SOVD, it means
111
-
the same thing across robots and vendors. Alerting pages a human; diagnostics gives a machine
112
-
an answer.
113
-
-**It has to survive a fleet.** Visualization is O(humans) - one operator, one timeline, and
114
-
nobody scrubs 400 of them. A structured fault is O(1): the same code and lifecycle aggregate
115
-
across the fleet, so *"which 12 of 400 robots have a confirmed navigation fault right now?"*
116
-
is a query, not a person.
117
-
-**You can't act on a plot.** Observability is read-only by design. A structured fault is the
118
-
precondition for doing something about it - gating an OTA on robot health, triggering
119
-
remediation. You can't safely patch what you haven't first diagnosed as a fault.
108
+
| Common pushback | Why a structured fault still wins |
109
+
|---|---|
110
+
|*"I'll just set an alert."*| A threshold alert fires on a raw signal and is gone - no entity, no lifecycle, no history, and it means something different on every robot. A fault is confirmed, persisted, entity-attributed state - and, being SOVD, it means the same thing across robots and vendors. **Alerting pages a human; diagnostics gives a machine an answer.**|
111
+
|*"I'll just watch the fleet dashboard."*| Visualization is O(humans) - one operator, one timeline, and nobody scrubs 400 of them. A structured fault is O(1): the same code and lifecycle aggregate across the fleet, so *"which 12 of 400 robots have a confirmed navigation fault right now?"* is a query, not a person. |
112
+
|*"I can already see it fail."*| Observability is read-only by design. A structured fault is the precondition for doing something about it - gating an OTA on robot health, triggering remediation. **You can't safely patch what you haven't first diagnosed as a fault.**|
120
113
121
114
So it is not a replacement for your observability stack - it is the **diagnosis layer
122
115
underneath it**. medkit flags and persists the fault (readable by dashboards, fleet managers
0 commit comments