Skip to content

gsoc26: Structured Run Manifest System #64

Description

@DhanashreePetare

Feature Request

Description:
Add an optional --manifest flag to the download, deploy, and delete commands. When provided, every detail of the operation — input parameters, resolved file URLs, checksums, per-file success/failure status, and error details — is recorded into a JSON-LD manifest file. When not provided, behavior is completely unchanged.

Feature importance:
There is currently no structured record of what was run, what succeeded, or what failed. A manifest gives every operation a reproducible, inspectable audit trail — the foundation for replay in a later milestone.

Alternative:
Plain text logging is unstructured and not replayable.

Key design points

  • All three API functions gain exactly one new optional parameter manifest_context=None — existing logic is completely untouched
  • Schema versioned via dbus:schemaVersion for forward compatibility
  • Stores pre-construction CLI inputs (not computed outputs) so future replay can reconstruct operations correctly
  • Per-file structured error capture (message, traceback) on failure
  • Never writes user paths, API keys, tokens, or any sensitive data

Metadata

Metadata

Labels

enhancementNew feature or request

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions