Objective
Detect drift between packaged workflow stubs in resources/github-actions and existing consumer workflow files managed by dev-tools:sync.
Current Limitation
dev-tools:sync copies workflow stubs when missing and can overwrite when explicitly requested, but it does not report when an existing consumer workflow has drifted from the packaged default.
Proposed Work
Add workflow stub drift detection so maintainers can see when consumer repositories are behind or customized relative to the packaged resources.
Scope
- Compare packaged workflow stubs from
resources/github-actions/*.yml with matching files under .github/workflows/.
- Report missing, matching, drifted, and intentionally overwritten files.
- Do not overwrite drifted files unless the existing overwrite option requests it.
- Make drift output actionable by naming source and target paths.
- Add tests for matching, missing, drifted, and overwrite cases.
Non-goals
- Auto-merging workflow customizations.
- Rewriting all consumer workflows by default.
- Introducing a new workflow templating system.
Acceptance Criteria
Delivery Criteria
Architectural / Isolation Criteria
Objective
Detect drift between packaged workflow stubs in
resources/github-actionsand existing consumer workflow files managed bydev-tools:sync.Current Limitation
dev-tools:synccopies workflow stubs when missing and can overwrite when explicitly requested, but it does not report when an existing consumer workflow has drifted from the packaged default.Proposed Work
Add workflow stub drift detection so maintainers can see when consumer repositories are behind or customized relative to the packaged resources.
Scope
resources/github-actions/*.ymlwith matching files under.github/workflows/.Non-goals
Acceptance Criteria
Delivery Criteria
dev-tools:syncreports when an existing workflow stub differs from its packaged source.Architectural / Isolation Criteria
SyncCommandorchestration.--checkor status modes.