Skip to content

chore(ci): add security.yml version marker + document >5-repos switchover#21

Merged
DTTerastar merged 1 commit into
mainfrom
chore/security-yml-version-marker
May 19, 2026
Merged

chore(ci): add security.yml version marker + document >5-repos switchover#21
DTTerastar merged 1 commit into
mainfrom
chore/security-yml-version-marker

Conversation

@Terastar-Paperclip
Copy link
Copy Markdown
Contributor

Summary

Follow-up from Lead Go Engineer review on PR #5. Two small, behavior-neutral additions so the next person who edits the workflow knows the rules.

  • Add a version-marker comment (# security.yml v1 — source of truth: quantcli/common; sync changes to every *-export-cli.) at the top of .github/workflows/security.yml. A future drift-check job will key off this marker.
  • Document the >5 repos → workflow_call switchover trigger in CONTRIBUTING.md under "Supply-chain and security", with the rationale (drift mitigation vs. centralization cost) and the original review link for context.

No behavior change to the workflow itself. The same marker is being added to withings-export-cli/.github/workflows/security.yml in a parallel PR; liftoff-export-cli and crono-export-cli pick it up when they onboard the workflow.

What changed

  • .github/workflows/security.yml: 4-line marker prepended above name: (kept the existing 3-line block intact — those are propagation hints, the marker is the version key).
  • CONTRIBUTING.md: new "Where the workflow lives, and when to centralize it" subsection under "Supply-chain and security".

Why

  • Without a version marker there is no anchor for a future drift-check job that compares each export-cli's copy against common's copy.
  • The >5-repos threshold lives in PR chore(ci): supply-chain security workflow + harden ci.yml #5's review thread today, which is not a discoverable place to look when the 6th repo is being onboarded. Putting it in CONTRIBUTING.md makes the trigger explicit.

Implications for per-service CLIs

  • When this lands, withings-export-cli gets the same marker (its security.yml is byte-identical today).
  • Future copies in liftoff-export-cli and crono-export-cli must include the marker on day one. The CONTRIBUTING.md note codifies this.

Test plan

  • CI green (security + ci workflows).
  • No behavior change in the security workflow — diff is comment-only.
  • Visual check: marker appears at the top of security.yml and the new subsection renders cleanly in CONTRIBUTING.md.

Refs QUA-47.

🤖 Generated with Claude Code

…over

The security workflow is copy-and-propagated across repos today; without a
version marker at the top of the file there is no key for a future drift
check to bind to. Add the marker per Lead Go review on PR #5, and document
the >5-repos threshold for switching to a workflow_call reusable workflow
in CONTRIBUTING.md so the next person who edits the workflow knows the rule.

No behavior change to the workflow itself. Withings-export-cli carries the
same marker in a parallel PR.

Refs QUA-47.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
@DTTerastar DTTerastar merged commit 6a36169 into main May 19, 2026
7 checks passed
@DTTerastar DTTerastar deleted the chore/security-yml-version-marker branch May 19, 2026 11:47
DTTerastar pushed a commit to quantcli/withings-export-cli that referenced this pull request May 19, 2026
Mirrors quantcli/common#21. The security workflow is copy-and-propagated
across repos today; a version marker at the top of the file gives a future
drift-check job a stable key to bind to. No behavior change.

Per Lead Go review on quantcli/common#5:
quantcli/common#5 (review)

Refs QUA-47.

Co-authored-by: QualitySecurity <qualitysecurity@quantcli.local>
Co-authored-by: Paperclip <noreply@paperclip.ing>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants