clawdie-iso/skills/iso-hardware-report-ingest/SKILL.md

2.1 KiB

name description
iso-hardware-report-ingest 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:

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:

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:

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:

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.