Add spec_test.go for ctxutil package

[Copilot]

The spec audit found pkg/ctxutil is the only package under pkg/ with a README.md but no companion spec_test.go, so its documented API isn't verified against source over time (33/34 packages have one).

Changes

• pkg/ctxutil/spec_test.go — new spec test following the pkg/setutil/spec_test.go pattern (//go:build !integration, external _test package, testify assertions), covering the three documented properties of OrBackground:
  • nil input falls back to context.Background()
  • non-nil input is returned unchanged, with carried values preserved
  • cancellation of the input context is not detached

t.Run("preserves cancellation of the input context", func(t *testing.T) {
	ctx, cancel := context.WithCancel(context.Background())
	got := ctxutil.OrBackground(ctx)
	cancel()
	assert.ErrorIs(t, got.Err(), context.Canceled, "...")
})

Note for reviewers

The nil case passes a var nilCtx context.Context rather than a literal nil — staticcheck SA1012 flags a literal nil context.Context argument.

No production code changes.

• Fixes [spec-librarian] Specification Audit — 2026-08-14 — 1 issue found #52728

---

Generated by 👨‍🍳 PR Sous Chef · gpt54 · 8.41 AIC · ⌖ 6.61 AIC · ⊞ 8.5K · ◷
_{Comment /souschef to run again}

---

Generated by 👨‍🍳 PR Sous Chef · gpt54 · 11.6 AIC · ⌖ 7.05 AIC · ⊞ 8.5K · ◷
_{Comment /souschef to run again}

[Copilot]

Pull request overview

Adds specification coverage for ctxutil.OrBackground.

Changes:

• Tests nil-context fallback.
• Tests value and cancellation preservation.

Show a summary per file

File	Description
pkg/ctxutil/spec_test.go	Adds README-aligned API tests for OrBackground.

Review details

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

• Files reviewed: 1/1 changed files
• Comments generated: 1
• Review effort level: Balanced

[github-actions]

PR Triage

• Category: test
• Risk: low
• Priority: low (score: 33/100)
• Score breakdown: impact 10/50, urgency 5/30, quality 18/20
• Recommended action: defer

Automated triage by PR Triage Agent.

Generated by 🔧 PR Triage Agent · auto · 64.3 AIC · ⌖ 2.94 AIC · ⊞ 7.8K · ◷

[gh-aw-bot]

@copilot All required checks are green. Please run the pr-finisher skill, confirm maintainer-ready status, and summarize any remaining blockers in one comment.

Run: https://github.com/github/gh-aw/actions/runs/31833406387

Generated by 👨‍🍳 PR Sous Chef · gpt54 · 8.41 AIC · ⌖ 6.61 AIC · ⊞ 8.5K · ◷
_{Comment /souschef to run again}

[github-actions]

PR Triage

Category: test  |  Risk: low  |  Score: 17/100

Score breakdown

• Impact: 8/50
• Urgency: 5/30
• Quality: 4/20

Recommended action: defer

CI check failing — needs fix before merge consideration.

Generated by 🔧 PR Triage Agent · auto · 68.2 AIC · ⌖ 10.7 AIC · ⊞ 7.8K · ◷

[gh-aw-bot]

@copilot Quick triage for maintainer-ready follow-up:

Unresolved review threads (newest first):

• copilot-pull-request-reviewer: Add spec_test.go for ctxutil package #52729 (comment) — checks deep structural equality, so it does not verify the documented requirement that the exact input context is returned unchanged. A distinct context value with equal internals could pass this assertion

Failed checks:

• None listed in compact candidate set.

Please refresh the branch if needed, address the unresolved review feedback, rerun validation, and use the skill before handing back.

Run: https://github.com/github/gh-aw/actions/runs/31864810198

Generated by 👨‍🍳 PR Sous Chef · gpt54 · 11.6 AIC · ⌖ 7.05 AIC · ⊞ 8.5K · ◷
_{Comment /souschef to run again}

[Copilot]

@copilot Quick triage for maintainer-ready follow-up:

Unresolved review threads (newest first):...

Addressed the unresolved thread: the non-nil passthrough case now uses assert.Same (pointer identity) instead of assert.Equal. Verified that assert.Equal would pass for two structurally-identical-but-distinct contexts while assert.Same correctly fails, so the assertion now actually enforces "returned unchanged".

Validation (BASE_REF=origin/main make agent-report-progress) passes; no other blockers.

[github-actions]

🎉 This pull request is included in a new release.

Release: v0.86.3