Ship verified portable company-brain dump and hydrate workflow

[valiantone]

Summary

Implement the first portable HotMem company-brain clone workflow: dump a HotMem memory mount, create a small compressed package, verify it, and hydrate it into a clean instance.

Scope

• Add or extend CLI and API behavior only where required by the approved interchange contract.
• Produce a versioned manifest plus JSONL or JSONL.GZ memory payload.
• Preserve provenance and compatible stored embeddings.
• Verify integrity before hydration.
• Make hydrate idempotent and report loaded and skipped records.
• Provide a reproducible source -> package -> clean-instance restore example.
• Add a compatibility test that validates retrieval after restore.

Acceptance criteria

• A package from one clean instance hydrates into another clean instance.
• The target reports expected counts and no duplicate records on repeat hydrate.
• Integrity failures halt hydration.
• Compatible embeddings are reused; incompatible ones are handled predictably.
• Existing snapshot and hydrate JSONL and JSONL.GZ flows remain compatible.

Out of scope

• Bidirectional sync.
• Online replication.
• Encryption, key management, or distributed storage.

Dependency

HotMem interchange and company-brain clone package v1.