meta.json format

meta.json is written next to payload and is required for diff and restore.

Top-level fields

• id
• createdAt (ISO-8601 instant)
• createdBy
• targetType
• targetValue
• mode
• fileCount
• totalBytes
• hashAlgo
• files (array)

Note: - Some versions may include note - Readers tolerate missing optional fields

File entry fields

Each item in files[] contains: - path (unix-style, relative) - size (bytes) - sha256 (hex string, may be empty)

Strictness

• Diff refuses missing meta.json
• Diff and restore refuse invalid meta.json
• Restore validates payload integrity using:
  • sha256 (preferred)
  • size (fallback)

Conceptual model

• meta.json describes payload files
• payload stores copies, not live server files