Module schema 

Registry file format + per-row validation.

Bumping MAX_SUPPORTED_SCHEMA is the additive-evolution path: readers of the previous bound still skip-and-log new files; old disk files keep validating because the v1 reader stays intact.

Structs

NamedAgentRecord

On-disk envelope. The data field’s shape is gated by schema_version; readers should match on the version before projecting.

NamedAgentRecordV1

v1 payload. Add new optional fields here under #[serde(default)] and bump MAX_SUPPORTED_SCHEMA — old readers will skip the new version, new readers fill defaults for old files.

Enums

ValidationError

Constants

MAX_SUPPORTED_SCHEMA

Highest envelope schema this binary will write or read. Bumped per release that adds fields.

MIN_SUPPORTED_SCHEMA

Lowest envelope schema this binary will load. Bumped only with a deprecation cycle (see SPEC §6).

Functions

is_safe_relative_subpath 🔒

validate

Per-row validation. Fails fast on anything that would let a malformed file be returned to the launch modal. Validation failures are skipped (not auto-fixed), logged, and the file stays on disk for ops triage.