hardware-evidence-capture

Hardware evidence capture

Use mhs_discover and mhs_meta_info to inspect the named device and current capabilities, directions and limits. All currently supported devices are simulated. Preserve that label in every result; never infer physical state, calibration, safety or camera coverage.

Read sensors or images with mhs_read and retain the returned original artifact path, byte count, SHA256, command/state identity, method and units. Generated simulator images are synthetic data and cannot become factual original evidence. Do not upload or publish observations without separate authority.

For a write, provide one explicit command ID and exact parameters. Hard limits cannot be overridden. confirm=true cannot approve a soft override or a confirmation-required operation. Return the full approval proposal for an operator's review; only the separately configured host file can authorize it. Do not write that file on the operator's behalf without an explicit instruction. An awaiting proposal has not attempted its action. A terminal command ID replays its receipt and never re-executes.

After a failed write, inspect mhs_health_check before any new write. Inspect the executed command, effective limits and resulting state in its receipt. Emergency stop latches the simulator off. Soft recovery needs its own exact host approval. Neither outcome proves physical stop or recovery effectiveness.

Physical adapters are unavailable pending named owner qualification. Stop on missing authority or an unknown result; preserve the error and receipt rather than inventing a device observation or automatically retrying.