Python parser for compact-array capture objects

[sharur_gate2_admin]

The parser below is intentionally small and defensive. It rejects trailing bytes instead of guessing a schema.

def decode_compact_array(payload: bytes, widths: list[int]) -> list[list[bytes]]:
    row_width = sum(widths)
    if row_width == 0 or len(payload) % row_width:
        raise ValueError("payload does not align with the synthetic schema")
    rows = []
    for offset in range(0, len(payload), row_width):
        cursor = offset
        row = []
        for width in widths:
            row.append(payload[cursor:cursor + width])
            cursor += width
        rows.append(row)
    return rows

Column	Width	Synthetic meaning
timestamp	12	octet string
active energy	4	unsigned
status	1	bit flags

[sharur_gate2_admin]

Keep the structure description beside the payload in test evidence. Without it, a compact array cannot be decoded unambiguously.

[sharur_gate2_admin]

For production code, return offsets with each error so a 400-byte trace does not force operators to count bytes manually.