Skip to content

Extend external pin lifecycle governance without policy drift #12

@CMCDragonkai

Description

@CMCDragonkai

Problem

External pin constraints are enforced, but lifecycle operations (freshness handling, review workflow ergonomics, rollback clarity) can be further formalized.

Intent

Improve maintainability and operational clarity while preserving the current policy principle: package files remain source-of-truth for pinned refs.

Scope

  • Keep source-of-truth refs in pkgs/ package definitions.
  • Keep allowlist metadata in checks/policy-pin-allowlist.nix.
  • Improve lifecycle reporting and review workflow documentation.
  • Define explicit rollback/update procedure.

Non-goals

  • No migration to opaque external policy registries.
  • No duplication of pinned refs in policy metadata.

Tasks

  1. Tighten external pin review runbook and failure handling docs.
  2. Improve lifecycle script output for issue/PR automation consumption.
  3. Add any minimal check refinements needed for lifecycle policy invariants.

Acceptance criteria

  • Maintainers have a documented review/update/rollback path.
  • Lifecycle outputs are actionable and machine-consumable.
  • Policy remains single-source and deterministic.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions