Skip to content

Agent task: add schema-backed NLBoot evidence validation #3

@mdheller

Description

@mdheller

Target repo

SourceOS-Linux/sourceos-devtools

Context

sourceosctl read-only/dry-run scaffold is merged. SourceOS spec now has canonical schemas for NLBootPlan, ArtifactCacheRecord, BootProofRecord, AppleSiliconAdapterEvidence, ReleaseSet, Fingerprint, ConfigSource, TokenDoor, and GitRefBuild. Devtools should validate local evidence files against these schemas instead of only printing JSON summaries.

Scope

Implement the smallest bounded change that does the following:

  1. Add a schema-backed validation mode to sourceosctl nlboot evidence inspect <path> or a new adjacent read-only command.
  2. Add fixtures for valid and invalid evidence records.
  3. Vendor/copy only the minimal schemas needed, or load repo-local schema fixtures; do not add network fetches.
  4. Update tests and make validate.
  5. Update README/docs usage.

Acceptance criteria

  • make validate passes.
  • CLI remains read-only; no host mutation.
  • Valid evidence fixture passes validation.
  • Invalid fixture fails with a clear error.
  • PR body includes validation evidence.

Validation commands

make validate

Boundaries / non-goals

  • Do not implement backend services.
  • Do not fetch schemas from the network at runtime.
  • Do not implement real host mutation.
  • Do not commit secrets, tokens, model weights, datasets, or training runs.
  • One PR only.

Metadata

Metadata

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions