export: align reanimator and enrich redfish metrics

bible-local/07-exporters.md

@@ -30,25 +30,41 @@ Implementation files:
 - `internal/exporter/reanimator_models.go`
 - `internal/exporter/reanimator_converter.go`
 - `internal/server/handlers.go`
+- `bible-local/docs/hardware-ingest-contract.md`
 
 Conversion rules:
-- canonical source is `hardware.devices`
+- canonical source is merged canonical inventory derived from `hardware.devices` plus legacy hardware slices
+- output must conform to the strict Reanimator ingest contract in `docs/hardware-ingest-contract.md`
 - timestamps are RFC3339
 - status is normalized to Reanimator-friendly values
 - missing PCIe serials may be generated from board serial + slot
+- missing CPU serials may be generated from board serial + socket
+- CPU `firmware` field means CPU microcode, not generic processor firmware inventory
 - `NULL`-style board manufacturer/product values are treated as absent
+- optional component telemetry/health fields are exported when LOGPile already has the data
+- partial `hardware.devices` must not suppress components still present only in legacy parser/collector fields
+- `present` is not serialized for exported components; presence is expressed by the existence of the component record itself
 
 ## Inclusion rules
 
 Included:
-- empty memory slots (`present=false`) for topology visibility
 - PCIe-class devices even when serial must be synthesized
+- contract `v2.4` component telemetry and health fields when source data exists
+- hardware sensors grouped into `fans`, `power`, `temperatures`, `other`
+- Redfish linked metric docs that carry component telemetry: `ProcessorMetrics`, `MemoryMetrics`, `DriveMetrics`, `EnvironmentMetrics`, `Metrics`
 
 Excluded:
+- memory with missing serial number
+- memory with `present=false` or `status=Empty`
+- CPUs with `present=false`
 - storage without `serial_number`
+- storage with `present=false`
 - power supplies without `serial_number`
+- power supplies with `present=false`
 - non-present network adapters
+- non-present PCIe / GPU devices
 - device-bound firmware duplicated at top-level firmware list
+- any field not present in the strict ingest contract
 
 ## Batch convert
 
@@ -61,3 +77,8 @@ Behavior:
 - each file is parsed independently
 - one bad file must not fail the whole batch if at least one conversion succeeds
 - result artifact is temporary and deleted after download
+
+## CSV export
+
+`GET /api/export/csv` uses the same merged canonical inventory as Reanimator export,
+with legacy network-card fallback kept only for records that still have no canonical device match.