Skip to content

Planning System Persistence

Serialization layer for project containers.

Key Classes

Class Purpose
ContainerSerializer Read/write ProjectContainer as msgpack (raw or gzip-compressed)

Notes

  • save() writes raw msgpack (for local working copies)
  • save_compressed() writes gzip-compressed msgpack (for R2 upload)
  • load() auto-detects format (gzip or raw msgpack)
  • All writes use write_file_atomically() to prevent corruption
  • File extension: .msgpack.gz (defined in constants/schema.py)