Visitar URL original
Say install-test-deps May Run Per-Leg Checks and Require Only That the Deploy Key Reach Its Job by ptr727 · Pull Request #4178 · ptr727/ProjectTemplate · GitHub
Skip to content

Say install-test-deps May Run Per-Leg Checks and Require Only That the Deploy Key Reach Its Job - #4178

Merged
ptr727 merged 1 commit into
developfrom
burndown/workflow-hook-deploy-docs
Nov 13, 2026
Merged

ptr727 merged 1 commit into
developfrom
burndown/workflow-hook-deploy-docs

Conversation

@ptr727

@ptr727 ptr727 commented Nov 13, 2026

Copy link
Copy Markdown
Owner

Summary

  • install-test-deps may run per-leg checks (Add a Per-Leg Check Hook or Document That install-test-deps May Run Checks #2853). The hook runs once per test-matrix leg, after the base install and before that leg's Python tests. The hook contract and hook catalog in docs/reusable-workflows.md, and the test-matrix input description in validate-task.yml, now say it may also run a check needing that leg's environment. A failure there fails the leg before its Python tests run. This is option 1 of the maintainer's 2026-11-01 answer on the issue.
  • The deploy key need only reach its job (Say Where the Deploy-Site Task Actually Requires the SSH Key #1801). WORKFLOW.md section 6's hugo row now requires DEPLOY_SSH_PRIVATE_KEY to reach the deploy job non-empty, rather than requiring the environment to carry it. The task's assert reads the merged secrets context, which cannot prove the environment store holds the key. The same row's "installs the deploy credential from the environment" drops "from the environment" for the same reason. This is option 1 of the maintainer's 2026-11-01 answer on the issue.

WORKFLOW.md D1.2 names no hook, so it needs no change, and no carried skill include moved (build_dist.py --check is current). tests/test_release_guards.py pins neither changed sentence.

Verification

  • prose_lint.py --diff origin/develop: no violation.
  • docker_lint.py markdownlint, cspell, actionlint: success.
  • build_dist.py --check: generated skill distributions are current.
  • tests/test_release_guards.py via unittest discover: OK.

Pre-existing findings, not filed

  • .github/workflows/deploy-site-task.yml:120, pre-existing correctness (comment): "An unset environment secret therefore reaches here as an empty string" is false where the caller maps a non-empty repository secret of the same name, the case Say Where the Deploy-Site Task Actually Requires the SSH Key #1801 describes. The file is outside this change's claimed set.
  • .github/workflows/deploy-site-task.yml:96, pre-existing correctness (comment): "this job's own binding is what determines the real value" holds only for a secret the environment defines. The file is outside this change's claimed set.

Closes on promotion: #2853, #1801

🤖 Generated with Claude Code

…e Deploy Key Reach Its Job

The install-test-deps hook runs once per test-matrix leg, after the base install and before that leg's Python tests.
The hook contract, the hook catalog, and the test-matrix input description now say it may also run a check needing that leg's environment.
They also say a failure there fails the leg before its Python tests run.

The WORKFLOW.md hugo row now requires DEPLOY_SSH_PRIVATE_KEY only to reach the deploy job non-empty.
The task's assert reads the merged secrets context, so it cannot prove the environment carries the key.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings November 13, 2026 20:59
@coderabbitai

coderabbitai Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 56 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

Run configuration

Commits

Reviewing files that changed from the base of the PR and between a25ac13 and 101ea82.

Files selected for processing: 3

  • .github/workflows/validate-task.yml
  • WORKFLOW.md
  • docs/reusable-workflows.md
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@ptr727

ptr727 commented Nov 13, 2026

Copy link
Copy Markdown
Owner Author

A recorded local strict-review pass covers head 101ea8206e2da39a3f17671bfb729de3c4ef1ff8, the content this pull request carries at that commit against develop, and it recorded 0 findings.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

An active documentation inconsistency remains: reusable-workflow guidance still incorrectly describes how the deploy secret is resolved when a repository secret is mapped.

1 open issue
What changed in this PR

This pull request clarifies reusable workflow contracts for per-leg checks in install-test-deps and for the deploy key required by Hugo deployments.

Changes:

  • Documents that install-test-deps may run checks using each test leg's environment and that failures stop the leg before Python tests.
  • Updates the hook catalog and test-matrix input description.
  • Requires DEPLOY_SSH_PRIVATE_KEY to reach the deploy job non-empty without requiring it to originate from the environment store.
  • A documentation inconsistency remains in the deploy-secret adoption guidance, which still describes the key as environment-store-only.
File Description
WORKFLOW.md Updates the Hugo deployment contract to require a non-empty job-visible deploy key and revises the credential installation wording.
docs/​reusable-workflows.md Documents per-leg checks for install-test-deps and updates the reusable-workflow hook catalog.
.github/​workflows/​validate-task.yml Clarifies that test-matrix hooks may perform per-leg checks and that failures occur before the leg's Python tests.

Review effort: Lite

Comment thread WORKFLOW.md Resolved
@codecov

codecov Bot commented Nov 13, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 76.71%. Comparing base (b38e084) to head (101ea82).
⚠️ Report is 202 commits behind head on develop.

Additional details and impacted files
@@             Coverage Diff             @@
##           develop    #4178      +/-   ##
===========================================
- Coverage    81.60%   76.71%   -4.89%     
===========================================
  Files           26       41      +15     
  Lines         9070    14317    +5247     
===========================================
+ Hits          7402    10984    +3582     
- Misses        1668     3333    +1665     
Flag Coverage Δ
python-3.13 76.71% <ø> (-4.89%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@ptr727

ptr727 commented Nov 13, 2026

Copy link
Copy Markdown
Owner Author

@coderabbitai review

@ptr727

ptr727 commented Nov 13, 2026

Copy link
Copy Markdown
Owner Author

/review

@coderabbitai

coderabbitai Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@ptr727
ptr727 merged commit cc8d9c4 into develop Nov 13, 2026
14 checks passed
@ptr727
ptr727 deleted the burndown/workflow-hook-deploy-docs branch November 13, 2026 21:17
ptr727 added a commit that referenced this pull request Nov 13, 2026
… Rules (#4189)

## Summary

Promotes the backlog-burndown rounds and changes from other hub sessions
from `develop` to `main`.

- Hooks and the prose gate: #4132, #4134, #4136, #4145, #4152, #4184.
The Husky hook reads its path list once and diffs a merge against
`MERGE_HEAD`. Interrupts re-raise their signal, a Markdown code span
reads as quoted data, and the gate picks a commit's diff base and
recognizes a conflicted promotion's branch cut from `main`.
- Procedures and carried rules: #4133, #4139, #4141, #4149, #4166,
#4177, #4179, #4183, #4185. Resync, audit and check-this-repo procedure
gaps, code style and shell interrupt rules, review-loop gaps across four
skills, the context and delegation section of `AGENTS.md`, question
rules in governance, the promotion line in pull request bodies,
closing-keyword behavior on promotion, and the history-rewrite premise.
- Review and cleanup tooling: #4138, #4148, #4154, #4156, #4157, #4163,
#4164, #4168, #4174, #4180. Cleanliness reads, parked handoffs, the
backlog report's JSON output, exact inline script pins, trusted inputs,
env-file includes, the bounded review wait, side-reviewer matching, and
a Copilot billing-failure notice read as a refusal.
- Workflow and runbook contract: #4153, #4155, #4169, #4171, #4178,
#4182. The runtime-secrets check, a registry entry and spec references,
the Copilot runbook pointers, credential-free checkout steps, and the
deploy-key and runner wording.
- From other hub sessions: #4159 (a repository's own .NET line under a
fleet default), #4161 (the 1Password CLI as an optional host tool),
#4162 (Codex's Windows installer and one managed opencode copy). These
carry no promotion line.

#4182 carries no promotion line by design, and #4175 holds the split-out
part of #4057's scope. Both #1448 and #4175 stay open.

Fixes #1071
Fixes #1154
Fixes #1391
Fixes #1471
Fixes #1594
Fixes #1620
Fixes #1627
Fixes #1650
Fixes #1801
Fixes #2853
Fixes #3620
Fixes #3668
Fixes #3697
Fixes #3766
Fixes #3787
Fixes #3837
Fixes #3840
Fixes #3842
Fixes #3844
Fixes #3865
Fixes #3882
Fixes #3890
Fixes #3894
Fixes #3912
Fixes #3916
Fixes #3954
Fixes #4014
Fixes #4015
Fixes #4016
Fixes #4043
Fixes #4050
Fixes #4057
Fixes #4058
Fixes #4062
Fixes #4084
Fixes #4097
Fixes #4098
Fixes #4099
Fixes #4104
Fixes #4108
Fixes #4114
Fixes #4115
Fixes #4117
Fixes #4118
Fixes #4119
Fixes #4121
Fixes #4122
Fixes #4123
Fixes #4131
Fixes #4135
Fixes #4140
Fixes #4142
Fixes #4143
Fixes #4144
Fixes #4151

🤖 Generated with [Claude Code](https://claude.com/claude-code)
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