operations-host-inventory

Host hardware inventory: CPU/RAM/GPU/NVIDIA-driver/Docker/disk detection + SMR probe (composes operations-drive-health)

What it is for

Host hardware inventory library crate.

Detects OS, CPU, RAM, NVIDIA GPU + driver, Docker, and a disk inventory (with an SMR probe), composing operations_drive_health for SMART grading. Shared by multiple consumers (frigate-box, bootusb, rust-inventory-ai) so detection lives in one tested place instead of being re-hand-rolled per app.

Testability

All system access goes through the CommandRunner trait (subprocess calls use strict argument vectors — never a shell — and file reads are explicit paths). Unit tests drive detection with testkit::FixtureRunner and canned tool output, so no test touches real hardware. Production uses SystemCommandRunner.

Status

Skeleton: the shared types + per-domain module signatures exist and compile; each detect() is implemented (TDD, tests-first) in the Sprint 0 fan-out.

Capabilities

DetectError

Host hardware inventory library crate.

HostReport

Host hardware inventory library crate.

CpuInfo

CPU detection (parse /proc/cpuinfo).

DiskInfo

Block-device inventory + SMR probe, composing operations_drive_health for

SmrStatus

Block-device inventory + SMR probe, composing operations_drive_health for

DockerInfo

Docker / container-runtime detection (docker version, docker info).

fingerprint (other)

Privacy-preserving host hardware fingerprint (ADR 0017).

MachineFingerprint

Privacy-preserving host hardware fingerprint (ADR 0017).

Quality

Privacy-preserving host hardware fingerprint (ADR 0017).

GpuInfo

NVIDIA GPU + driver detection (nvidia-smi, lspci fallback).

MemoryInfo

Memory detection (parse /proc/meminfo).

OsInfo

OS identity detection (parse /etc/os-release).

FixtureRunner

Test fixtures for driving detection without real hardware.

How to use it

No examples/ target and no doctest in this crate's rustdoc. The tests listed under Verification are the closest executable usage.

Module structure

operations_host_inventory

• cpu
• disk
• docker
• fingerprint
• gpu
• memory
• os
• testkit

flowchart TD
  n_operations_host_inventory["operations_host_inventory"]
  n_operations_host_inventory --> n_cpu["cpu"]
  n_operations_host_inventory --> n_disk["disk"]
  n_operations_host_inventory --> n_docker["docker"]
  n_operations_host_inventory --> n_fingerprint["fingerprint"]
  n_operations_host_inventory --> n_gpu["gpu"]
  n_operations_host_inventory --> n_memory["memory"]
  n_operations_host_inventory --> n_os["os"]
  n_operations_host_inventory --> n_testkit["testkit"]

Public surface

`crate root`

`cpu`

`disk`

`docker`

`fingerprint`

`gpu`

`memory`

`os`

`testkit`

Re-exports. Exported here, defined elsewhere.

Boundary

Depends on no other workspace tier.

Shares tier operations with 40 other crates: operations-approval-workflow, operations-assessments, operations-block-imaging, operations-boot-media, operations-browser-agent-worker, operations-camera-discovery, operations-camera-liveview, operations-camera-registry, … (40 total).

_What this crate deliberately does NOT own is a judgment. No committed registry records one for it, so none is stated here._

Where it sits

Dependencies

Runtime, in this workspace.

Runtime, from outside the workspace.

Development, from outside the workspace.

Build. None.

Depended on by. 1 workspace crate.

Signal flow — what reaches this crate, and what it reaches.

flowchart LR
  n_infrastructure_hardware_forensics["infrastructure-hardware-forensics"] -->|uses| SELF
  SELF["operations-host-inventory"]
  SELF -->|runtime| n_operations_drive_health["operations-drive-health"]
  classDef self fill:#1f883d,stroke:#1f883d,color:#fff;
  class SELF self;

Feature flags

No Cargo features are defined: every capability is unconditional, so no consumer can receive a half-wired crate.

Targets

Error model

Operational characteristics

No unsafe block, unsafe fn, unsafe impl or unsafe trait was found by the parser anywhere in this crate's source.

Configuration

No environment variable is read with a literal name anywhere in this crate. A variable whose key is computed at run time cannot be listed here, and is not claimed to be absent.

Related capabilities

1 workspace crate depends on this one: infrastructure-hardware-forensics.

Verification

Evidence by module. How often each public module is named by something executable.

What the tests establish, by name:

• empty_runner_errors — src/cpu.rs
• missing_model_name_falls_back_to_unknown — src/cpu.rs
• no_processor_entries_is_parse_err — src/cpu.rs
• parses_2core_4thread — src/cpu.rs
• parses_single_core — src/cpu.rs
• empty_blockdevices_yields_empty_vec — src/disk.rs
• empty_runner_errors — src/disk.rs
• garbage_json_is_parse_error — src/disk.rs
• handles_string_typed_flags_and_size — src/disk.rs
• missing_blockdevices_key_is_parse_error — src/disk.rs
• missing_zoned_file_is_unknown — src/disk.rs
• parses_usb_and_internal_disks_skipping_rom — src/disk.rs
• zoned_attribute_maps_to_smr_status — src/disk.rs
• daemon_unreachable_yields_none_engine_but_ok — src/docker.rs
• docker_present_without_nvidia_runtime — src/docker.rs
• empty_runner_errors — src/docker.rs
• full_docker_host_with_nvidia_runtime — src/docker.rs
• deterministic_for_same_secret_and_host — src/fingerprint.rs
• empty_host_is_quality_d_not_panic — src/fingerprint.rs
• filters_generic_oem_garbage — src/fingerprint.rs
• flags_vm_and_container — src/fingerprint.rs
• never_leaks_raw_values — src/fingerprint.rs
• quality_tiers — src/fingerprint.rs
• raw_components_and_fingerprint_agree_on_which_components_are_present — src/fingerprint.rs
• raw_components_returns_the_actual_values_fingerprint_hashes_away — src/fingerprint.rs
• secret_domain_separates — src/fingerprint.rs
• empty_runner_errors — src/gpu.rs
• lspci_fallback_gives_model_no_driver_no_uuid — src/gpu.rs
• lspci_without_nvidia_is_absent_not_error — src/gpu.rs
• nvidia_smi_counts_multiple_gpus — src/gpu.rs
• _… 22 more_

Documentation coverage

pie showData
    title Public items with rustdoc
    "Documented" : 26
    "No rustdoc detected" : 2

Metrics

pie showData
    title Public API by kind
    "constant" : 1
    "enum" : 3
    "function" : 9
    "method" : 6
    "struct" : 9

pie showData
    title Rust source composition
    "Code" : 1497
    "Blank or comment" : 477

Generation

Rendered by tools-corpus corpus readme from repository evidence alone, renderer schema 2, lexicon current. No model, network service or database was consulted. Regenerate with tools-corpus corpus readme --write; verify with --check.