Skip to content

Make decoder schemas loadable and versioned #10

Description

@zrack

Operator outcome

A contributor can add a trusted decoder schema and fixtures without editing the core frame-processing code, and an operator can identify exactly which schema interpreted a session and evidence bundle.

Scope

  • Move the canonical NSL-01 schema into a loadable, versioned registry.
  • Define signature, trust, compatibility, and migration policies.
  • Drive field decoding from schema definitions, including types, scales, enums, bounds, and units.
  • Preserve imported schema bytes and cryptographic identity in sessions and .nlb bundles.
  • Surface compatibility and unsupported-schema diagnostics without discarding raw records.

Invariants

  • Raw source records remain immutable.
  • Malformed and partial frames remain inspectable.
  • Bundled and imported sessions continue through one validation/decode/replay/export pipeline.
  • Existing NSL-01 v1 sessions remain reproducible.

Exit criteria

  • A third-party schema plus fixtures can be added without changing core frame-processing code.
  • Trust and compatibility failures have deterministic diagnostics.
  • Conformance tests cover schema identity, versioning, decoding, migration, and evidence export.

Metadata

Metadata

Assignees

No one assigned

    Labels

    architectureArchitecture, runtime, storage, and core design decisionsdecoderParser, schema, validation, checksum, and decoding workenhancementNew feature or request

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions