I built this repository to record a conservative recovery policy for local AI equipment. The private source contains commissioning records, policy, verification evidence, an example configuration, and five close-up controller photographs. This public branch keeps the engineering relationship and safety decisions while removing actionable physical and logical maps.
- Read-only triage using independent reachability and identity signals.
- Refusal for shared outages, partial failures, maintenance, alarms, high temperature, uncertain mapping, or cooldown.
- A one-time decision bound to evidence, mapping digest, identity, and operation ID.
- Journal-before-actuation, verify-after-transition, restore-on-interruption, and no-loop behavior.
- A fan/environment role separated from compute recovery.
- Example TSV and shell assets that produce decisions without controlling hardware.
| Observation | Source evidence | Status |
|---|---|---|
| Controller label: 1,800 W at 120 V / 15 A aggregate | source photograph and README | Historical hardware reading |
| Healthy scheduled pass; no outlet changed | source verification | Historical |
| Isolated failure eligible after three consecutive checks | source policy/verification | Fixture result |
| Two simultaneous failures classified shared-outage/no-cycle | source policy/verification | Fixture result |
| Compute relationships checked against expected identity before authority | source implementation record | Commissioning lesson |
| Supported local AC-ADA8 API not established | source limitations | Unresolved boundary |
A missed ping is not permission to remove power. The system should refuse more often than it acts and must leave shared infrastructure outside recovery authority.
The contract preserves multi-signal triage, maintenance pause, temperature/alarm safeguards, cooldown, serialized operations, and readback. Exact controller names, outlets, addresses, rack photographs, and operational thresholds are not reproduced.
See docs/ARCHITECTURE.md.
- docs/CASE-STUDY.md
- docs/RECOVERY-EVIDENCE.md
- docs/PUBLICATION-SAFETY.md
- examples/synthetic-recovery-decision.json
The readings above are historical source evidence, not current status. This is a public project interface, not a live power-control repository. It publishes no vendor/controller identity, outlet map, address, credential, raw telemetry, or command targeting real equipment.
Gumbii Digital's original code, documentation, examples, data, diagrams, and media are available under the MIT License. Third-party components, assets, product names, and trademarks retain their respective terms; see COPYRIGHT.md for scope.