task(cluster): design the hardware inventory record (schema + template)

Design the hardware inventory record (schema + template)

Parent epic: #1080 (basement cluster program). Project home: planning/roadmaps/basement-cluster.md.

Design one inventory record per machine: CPU, motherboard, RAM (slots/size/ECC), every NVMe and HDD (model, serial, capacity, SMART summary, firmware), NICs (model, speed, ports), GPU, BMC/KVM address, BIOS/BMC versions (feeds epic 2). Template committed to developing-today/hardware-doc (the home of the VERIFICATION records) with one filled example.

Acceptance: template + example committed; a collector (script or checklist) exists that fills a record for one machine end-to-end.

CODE-234

🤖 Agent note · picked up

Agent: queue worker (repo-worker-code), lane B shift
Session / ID: queue task 2359 (triage)
Found via: queue claim
Task: Triage task(cluster): design the hardware inventory record (schema + template) #1094 — design the hardware inventory record (schema + template) for the basement cluster (epic epic(cluster): hardware inventory & first-node selection #1080).
Expectation: s — verdict + scoped follow-up packet.

🤖 Agent note · done

Agent: queue worker (repo-worker-code), lane B shift
Session / ID: queue task 2359 (triage)
Found via: queue claim
Task: Triage verdict for task(cluster): design the hardware inventory record (schema + template) #1094 — CONFIRMED unmet, and routable.
Expectation: done = verdict + follow-up packet enqueued (task 3002).

Findings:

developing-today/hardware-doc exists and is active (pushed 2026-10-28), with VERIFICATION-*.md device records and components/devices trees — but a recursive tree listing shows no machine/cluster inventory record or template (path grep for inventory/machine/cluster/template finds only unrelated device artifacts).
developing-today/code at HEAD: no "inventory record" schema in planning/ or doc/; the basement-cluster roadmap names the program but defines no record shape.
Unlike sibling cluster tasks (task(cluster): gather stats - remaining machines + boxed HDD baseline #1096 boxed HDDs, task(cluster): verify NIC and switch-gear facts #1097 NIC facts, task(cluster): collect current BIOS/BMC versions and settings - core machines #1099 BIOS/BMC — all escalated for physical/machine access), this issue is mode/online: the deliverable is a design (schema + template + collector), which an agent can produce; the one filled example can come from a worker-readable machine with real values.

Route: follow-up small_fix enqueued as queue task 3002: template + machine-readable schema + collector (script or checklist) committed to hardware-doc, with one filled example from a machine the worker actually reads (no invented serials; unreadable fields marked unknown). Issue stays open pending that PR.

🤖 Agent note · picked up

Agent: queue worker (repo-worker-code), lane B shift
Session / ID: queue task 3002 (repo-queue-worker-shift-b, 2026-10-29 run)
Found via: queue claim
Task: Implementing this issue in developing-today/hardware-doc: inventory record template + JSON Schema, a stdlib-only collector script, and one filled example record read live from the laptop amd (Framework Laptop 13) — real values only, unreadable fields marked unknown with reasons. Worktree on the laptop: ~/git/fleet/3002-1094-inventory-record, branch queue/3002-1094-inventory-record.
Expectation: m — done = PR open in hardware-doc referencing this issue, example validates against the schema, task completed.
Links: target repo https://github.com/developing-today/hardware-doc

🤖 Agent note · done

Agent: queue worker (repo-worker-code), lane B shift
Session / ID: queue task 3002 (repo-queue-worker-shift-b, 2026-10-29 run)
Found via: queue claim
Task: Delivered in developing-today/hardware-doc PR Bump checkmarx/ast-github-action from 2.0.11 to 2.0.18 #2 (merged, commit 79917dfe): new machines/ tree with the inventory record JSON Schema (all fields this issue names), the markdown template, a stdlib-only collector (collect-inventory.py), and the first filled record — the laptop amd (Framework Laptop 13, Ryzen 7 7840U, Samsung SSD 990 PRO 4TB), produced by running the collector on the machine. Values are real reads only; six fields/groups the unprivileged run could not read (DMI serial, memory slot/ECC detail, drive firmware/SMART, Wi-Fi speed, BMC) are null with reasons in the record's unknowns array.
Expectation: met — validation: npx --yes ajv-cli validate --spec=draft2020 -s machines/inventory-record.schema.json -d machines/amd.json → valid. Closing this issue; basement core-machine records stay with task(cluster): gather stats - remaining machines + boxed HDD baseline #1096/task(cluster): collect current BIOS/BMC versions and settings - core machines #1099 as scoped.
Links: PR machines: hardware inventory record — schema, template, collector, first record (amd) (#1094) hardware-doc#2

Navigation Menu

Repository navigation

task(cluster): design the hardware inventory record (schema + template) #1094

Design the hardware inventory record (schema + template)

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

task(cluster): design the hardware inventory record (schema + template) #1094

Description

Design the hardware inventory record (schema + template)

Activity

developing-today commented on Oct 27, 2026

dezren39 commented on Oct 29, 2026

dezren39 commented on Oct 29, 2026

dezren39 commented on Oct 29, 2026

dezren39 commented on Oct 29, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions