Hint for Jobs Test Case

[UdeshyaDhungana]

Note

Medium Risk
Touches shared assertion/error-message plumbing used across tests, so regressions could affect many failure outputs and fixture generation behavior. Functional changes are limited to diagnostics and test harness behavior, not user-facing shell execution.

Overview
Adds support for appending an extra hint line to colored assertion error messages by extending utils.BuildColoredErrorMessage and wiring it through SingleLineAssertion/EmptyLineAssertion.

Updates the jobs builtin test case to generate a specific hint when a finished job line incorrectly includes a trailing &, and adds a new failing scenario/fixture (background_jobs_extra_ampersand) to exercise this.

Adjusts stage_bg3 to skip fixture recording/evaluation for a known timing-dependent output ordering case.

^{Written by Cursor Bugbot for commit 48f9c66. This will update automatically on new commits. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Autofix prepared a fix for the issue found in the latest run.

• ✅ Fixed: Hint message text mismatches test fixture expectation
  • Changed the ErrorHintGenerator return string from 'Finished job entry should not have a trailing ampersand' to 'Expected job entry to not have trailing ampersand' to match the test fixture expectation.

Or push these changes by commenting:

@cursor push d1627339c4

Preview (d1627339c4)

diff --git a/internal/test_cases/jobs_builtin_response_test_case.go b/internal/test_cases/jobs_builtin_response_test_case.go
--- a/internal/test_cases/jobs_builtin_response_test_case.go
+++ b/internal/test_cases/jobs_builtin_response_test_case.go
@@ -122,7 +122,7 @@
 					return ""
 				}
 
-				return "Finished job entry should not have a trailing ampersand"
+				return "Expected job entry to not have trailing ampersand"
 			},
 		})

_{You can send follow-ups to this agent here.}

[UdeshyaDhungana]

More context on this: https://github.com/codecrafters-io/shell-tester/actions/runs/23781348969/job/69294613752.

There is no way to guarantee if the first 'cat' job will have been reaped or not by the time we print the logs.