Summary
Persist enough metadata about the installed registry release so future status, diff, regenerate, and verification workflows know exactly what local specs are based on.
Part of #5. Supports #14, #15, #16, and #17.
Current gap
datapan init and catalog install datapan-registry install the registry and preserve release evidence, but the local project needs an explicit provenance record for the installed registry snapshot. Without that, stale checks and update-impact workflows must infer too much from filenames or release evidence.
Desired behavior
Write and maintain a local registry provenance file, for example:
or:
.datapan/registry-install.json
It should include:
- installed registry path;
- registry release tag/version;
- release API URL and asset URL;
- registry artifact digest if available;
- install timestamp;
- release manifest path;
- preserved evidence paths;
- whether the user pinned a release or installed latest;
- source mode: embedded, default installed, env override, explicit path.
Acceptance criteria
datapan init and datapan catalog install datapan-registry write provenance metadata.
datapan status --json and datapan doctor --json read and expose it.
- Custom registry paths and env overrides are clearly distinguished from installed default registry state.
- Reinstall/update workflows preserve or update provenance deterministically.
- Tests cover latest install, pinned release install, explicit registry path, env registry path, and missing provenance fallback.
Notes
This is the bookkeeping layer that lets the CLI treat registry updates like dependency updates instead of opaque file replacement.
Summary
Persist enough metadata about the installed registry release so future status, diff, regenerate, and verification workflows know exactly what local specs are based on.
Part of #5. Supports #14, #15, #16, and #17.
Current gap
datapan initandcatalog install datapan-registryinstall the registry and preserve release evidence, but the local project needs an explicit provenance record for the installed registry snapshot. Without that, stale checks and update-impact workflows must infer too much from filenames or release evidence.Desired behavior
Write and maintain a local registry provenance file, for example:
or:
It should include:
Acceptance criteria
datapan initanddatapan catalog install datapan-registrywrite provenance metadata.datapan status --jsonanddatapan doctor --jsonread and expose it.Notes
This is the bookkeeping layer that lets the CLI treat registry updates like dependency updates instead of opaque file replacement.