---
name: iso-hardware-report-ingest
description: Ingest real-machine live USB hw-report evidence into a structured Colibri hardware manifest without treating static inspection as hardware proof.
---

# iso-hardware-report-ingest

Use this skill after the operator or Codex ISO Builder collects live USB evidence
from real hardware. It produces a `clawdie.iso.hardware.v1` manifest for Colibri
and dashboard consumers.

## Manifest output

Write the result to:

```sh
tmp/colibri/iso-hardware/<run_id>.json
tmp/colibri/iso-hardware/latest.json
```

Schema: `clawdie.iso.hardware.v1`. See `docs/ISO-MANIFESTS.md`.

## Inputs to collect from the live USB

Prefer files copied from the live session over paraphrased observations:

```sh
hw-report > /tmp/clawdie-hw-report.txt
pciconf -lv > /tmp/clawdie-pciconf-lv.txt
ifconfig -a > /tmp/clawdie-ifconfig-a.txt
cat /var/log/clawdie-live-gpu.log > /tmp/clawdie-live-gpu.log
```

When debugging GUI/input/audio issues, also collect the relevant exact command
output named in `PLAN-OPERATOR-USB-NEXT.md`, for example:

```sh
xinput list
xfconf-query -c pointers -lv
cat /dev/sndstat
sysctl hw.snd.default_unit
mixer
```

If `hw-probe` upload is intentionally run, record only the public probe URL in
the manifest. Do not upload private operator data without approval.

## Ingest checklist

Record these as manifest checks or evidence fields:

- machine vendor/model and firmware version when available
- CPU model
- GPU PCI IDs, selected KMS module, and reason from `clawdie-live-gpu.log`
- GL renderer if collected
- SDDM login result and XFCE session result
- internal display and external display behavior if tested
- touchpad, keyboard, webcam, audio, Wi-Fi, and USB Ethernet observations
- Tailscale status if it was part of the test
- no-blank/power behavior observed during the session
- image filename or commit shown by the live build manifest

## Finish

Write a concise summary such as:

```text
AMD ASUS UX325UA: pass for SDDM/XFCE/AMD KMS/USB Ethernet/webcam; touchpad needs follow-up.
```

Attach paths to raw captured files under `logs` or `outputs`. Keep the manifest
small enough for Colibri to ingest directly.
