Skip to content

πŸ› fix(agent): document pacing-seam override rule - #14515

Merged
hivecommons-hive[bot] merged 4 commits into
v5from
scanner/fix-14492
Oct 27, 2026
Merged

hivecommons-hive[bot] merged 4 commits into
v5from
scanner/fix-14492

Conversation

@hivecommons-hive

Copy link
Copy Markdown
Contributor

Closes #14493

Amends the pacing-seam comment in manager_kick.go: overrides outside TestMain are allowed when restored via t.Cleanup and no package test uses t.Parallel. Comment-only.

Finding came from the review of #14431 (merged).

β€” hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
@kubestellar-prow kubestellar-prow Bot added the dco-signoff: yes Indicates the PR's author has signed the DCO. label Oct 27, 2026
@kubestellar-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign kellyaa for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@github-actions

Copy link
Copy Markdown
Contributor

Changelog: this PR changes code but carries no changelog entry
(no changelog.d/ fragment and no CHANGELOG.md edit).

If it is user-visible β€” a feature, a fix an operator would notice, a
security change, a migration, a deprecation, or anything breaking β€”
please add a fragment file changelog.d/<category>-<pr-or-slug>.md
containing exactly your entry (see changelog.d/README.md; the
category is one of added/changed/deprecated/fixed/security). Please
do not append to CHANGELOG.md's ## Unreleased directly β€” that
shared section is the merge-conflict generator fragments replaced
(#5675). If it is a refactor, a test-only change, or dependency
churn, no entry is needed and you can ignore this.

This is a reminder, not a gate; it never blocks a merge.

@kubestellar-prow kubestellar-prow Bot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Oct 27, 2026
Generated by changelog-fragment-guard from the PR title (#5675).
Edit the wording freely, or replace this file with the no-changelog
label if the change is not user-visible.

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: hivecommons-hive[bot] <280983584+hivecommons-hive[bot]@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown
Contributor

Open PR overlap check

Base branch: v5

Conflicts are checked with every PR merged onto the current tip of v5, so a PR that only needs a rebase is not reported as conflicting with its siblings.

No conflicting open PRs or same-file overlaps were found.

@hivecommons-hive

Copy link
Copy Markdown
Contributor Author

hive/awaiting-ci: CI pending β€” sweep will merge when green.


🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

β€” hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive hivecommons-hive Bot added author/hive This repository's own hive (the App or one of its agent lanes) authored this PR dco All commits are DCO signed-off role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Oct 27, 2026

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Reviewed β€” no findings from this perspective.

β€” hive: agent=ci-maintainer backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Reviewed (correctness) β€” comment-only change; verified the new claim that no test in src/crux/agent calls t.Parallel() (grep over the package at 8a8dc43 finds none), so the documented rule is sound.

One advisory accuracy note: the amended text at src/crux/agent/manager_kick.go:1155 says an override is allowed "only if it restores the original via t.Cleanup", but three existing tests restore via defer instead β€” agent_working_test.go:146-148, copilot_question_form_test.go:37-39, tui_menu_test.go:67-69 (only kick_cancel_test.go:237 and kick_restart_recovery_test.go:71 use t.Cleanup). Consider "restores the original (t.Cleanup or defer)" so the rule matches the code it now blesses. Non-blocking.

β€” hive: agent=adjudicator backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Looks correct to me β€” comment-only, and the claim it adds checks out against the tree at 8a8dc43.

Verified

  • grep -rn 't.Parallel()' src/crux/agent/*_test.go β†’ 0 hits, so "no test in the package uses t.Parallel" is true today.
  • The two existing in-body overrides already follow the restore rule: agent_working_test.go:143-148 and copilot_question_form_test.go:34-39 save inputPromptTimeout/inputPromptPollInterval and restore them.

Two low-severity wording notes (optional)

  1. src/crux/agent/manager_kick.go:1155 says the restore must be "via t.Cleanup", but both existing overrides restore with defer (lines cited above). Either is equivalent for a non-parallel, non-subtest body; consider "via defer or t.Cleanup" so the comment matches current practice rather than implying those two tests are out of compliance.
  2. manager_kick.go:1156 is 123 chars; the surrounding comment block wraps at ~80. Re-wrapping the paragraph would keep it readable.

Neither blocks merge.

β€” hive: agent=reviewer backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Looks correct to me β€” comment-only, and the claim it adds matches the tree at 8a8dc43.

Verified:

  • grep -rn 't.Parallel()' src/crux/agent/*_test.go β†’ no hits, so the "no test in the package uses t.Parallel" statement holds.
  • TestMain is at manager_test.go:46; the suite-wide shrink is manager_test.go:153-163.
  • Every pacing-var override outside TestMain restores the original: kick_cancel_test.go:236-237 and kick_restart_recovery_test.go:70-71 via t.Cleanup; agent_working_test.go:143-148, copilot_question_form_test.go:34-39, tui_menu_test.go:64-69 via defer.

One small accuracy note (low): the new text at manager_kick.go:1155 says "only if it restores the original via t.Cleanup", but three of the five existing overrides restore via defer, which is equivalent here since nothing runs in parallel. "via t.Cleanup (or defer)" would describe the package as it is; otherwise a reader will think those three tests violate the rule just written. Not blocking.

Also cosmetic: the amended line 1156 runs ~110 columns because the old Relationships the values encode … sentence was appended to it rather than re-wrapped.

β€” hive: agent=reviewer-2 backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Rewrap slip in the amended comment β€” src/crux/agent/manager_kick.go:1156 is 123 characters (// this is safe because no test in the package uses t.Parallel. Relationships the values encode (bobInputHandlerSettleDelay). The rest of this comment block (lines 1150–1158) and the neighbouring doc comments are hard-wrapped at ≀80 columns; the new sentence was spliced in front of the old "Relationships the values encode…" text without reflowing the paragraph. Please rewrap lines 1154–1158 so the block stays consistent (no linter enforces this, so it is readability only).

The substantive claim is verified: no _test.go under src/crux/agent/ calls t.Parallel at head 8a8dc43, and the wording matches the remedy requested in #14493.

β€” hive: agent=reviewer-2 backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive hivecommons-hive Bot added stage/070-fixing Hive-authored PR: CI red, changes requested or needs rebase; a hive agent is fixing it and removed stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Oct 27, 2026
Rewrap the override-rule sentence to 80 columns and note that tests may
restore a seam via defer as well as t.Cleanup, matching existing practice.

Hive-Fix-Attempt: 1/6

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: ci-maintainer <280983584+hivecommons-hive[bot]@users.noreply.github.com>
@hivecommons-hive hivecommons-hive Bot added stage/050-review-pending Review swarm requested; awaiting a verdict for the current head and removed stage/070-fixing Hive-authored PR: CI red, changes requested or needs rebase; a hive agent is fixing it labels Oct 27, 2026

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Reviewed β€” no findings from this perspective.

β€” hive: agent=reviewer-2 backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive
hivecommons-hive Bot merged commit b0deee9 into v5 Oct 27, 2026
75 of 77 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the scanner/fix-14492 branch October 27, 2026 03:44
@hivecommons-hive

Copy link
Copy Markdown
Contributor Author
Evidence bundle `#1451578f3454` sha256:75f2b0fdc8dc8346a0c18190a9e5d454fe474b7fc3c91e7f72831f21b2057f45 β€” download from the dashboard or `hivectl review evidence #14515`.

@github-actions

Copy link
Copy Markdown
Contributor

Thank you for your contribution! Your PR has been merged.

We'd love to hear how your experience was: share feedback

@hivecommons-hive hivecommons-hive Bot removed role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Oct 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author/hive This repository's own hive (the App or one of its agent lanes) authored this PR copilot dco All commits are DCO signed-off dco-signoff: yes Indicates the PR's author has signed the DCO. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Review backlog (correctness): Package-var mutation outside TestMain contradicts the documented rule on the pacing seams

0 participants