test: reduce suite latency with safe sharding

[benvinegar]

Summary

• run the default Bun test suite as two independent file shards
• avoid Bun 1.3.14's --parallel isolation path, which breaks OpenTUI native FFI initialization
• supervise shard failures, interrupts, partial launches, and orphan cleanup
• keep Windows and macOS serial because the complete multi-process suite is validated and benchmarked on Linux
• explicitly stop detached integration-test daemons and isolate their runtime metadata
• use the same package test command across PR validation jobs

Benchmark

Bun 1.3.14 on Linux with the full test suite:

Mode	Mean wall time
Serial	43.7s
Two shards	25.2s

This reduces local wall time by about 42%. Under a simulated two-vCPU affinity, two shards reduced wall time from 46.4s to 29.3s. On Linux, higher shard counts remain available through HUNK_TEST_SHARDS, while the automatic default stays capped at two.

Validation

• ten consecutive complete two-shard suite runs before rebasing: 10/10 passed, 25.700s mean, zero detached daemons after every run
• post-rebase complete suite including the newly added examples scope: 3,030 passed, 10 skipped, zero failures, zero detached daemons
• bun test scripts/run-test-suite.test.ts
• bun run typecheck
• bun run lint
• changed-file formatting check
• direct serial baseline confirming the pre-runner suite leaves no detached daemons
• focused session CLI integration coverage confirming daemon process and runtime-metadata cleanup
• Windows CI reproduction confirming --no-orphans must be omitted and daemon assertions must follow the serving child PID
• retrying Windows temp-directory cleanup after subprocess handles are released
• ten repeated scrollbar test runs after widening Windows timer margins
• fresh Linux and Windows CI on the final commit, including test, PTY, TTY smoke, packaging, and portability jobs

This PR description was generated by Pi using gpt-5.6-sol

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
hunk-web	Ignored	Preview	Aug 24, 2026 12:35pm

[greptile-apps]

Greptile Summary

The PR replaces the serial default Bun test command with a supervisor that runs the suite in independent file shards while avoiding Bun’s isolated parallel-worker mode.

• Chooses up to two shards automatically, with a validated HUNK_TEST_SHARDS override.
• Supervises launch failures, test failures, interrupts, and forced termination.
• Routes Windows PR validation through the same package test command.
• Adds unit coverage for shard-count validation, command construction, and termination forwarding.

Confidence Score: 4/5

The PR appears safe to merge, with one non-blocking repository-convention issue around direct environment-variable access.

The shard orchestration has no established blocking failure, but the new supervisor bypasses the prescribed validated environment interface when reading the shard override and forwarding child environments.

Files Needing Attention: scripts/run-test-suite.ts

Important Files Changed

Filename	Overview
scripts/run-test-suite.ts	Introduces the shard supervisor and cleanup behavior; direct process.env access conflicts with the mounted environment-access rule.
scripts/run-test-suite.test.ts	Adds focused unit tests for shard-count resolution, generated commands, and tolerant signal forwarding.
package.json	Routes the default test script through the new Bun shard supervisor.
.github/workflows/pr-ci.yml	Updates Windows PR validation to exercise the same package-level test entry point.

Sequence Diagram

sequenceDiagram
    participant U as Caller / CI
    participant R as run-test-suite.ts
    participant S1 as Bun shard 1
    participant S2 as Bun shard 2
    U->>R: bun run test [args]
    R->>R: Resolve shard count
    par Launch file shards
        R->>S1: "bun test --shard=1/2 patterns"
        R->>S2: "bun test --shard=2/2 patterns"
    end
    alt Interrupt or partial launch
        U-->>R: SIGINT / SIGTERM
        R-->>S1: Forward signal, then SIGKILL
        R-->>S2: Forward signal, then SIGKILL
    else Normal completion
        S1-->>R: Exit code
        S2-->>R: Exit code
        R-->>U: Combined success/failure status
    end

Loading

Prompt To Fix All With AI

### Issue 1
scripts/run-test-suite.ts:76
**Direct environment access bypasses validation**

The new supervisor reads `HUNK_TEST_SHARDS` directly from `process.env` and also spreads `process.env` into each child at line 87, bypassing the repository-prescribed type-safe environment interface and establishing an inconsistent configuration-access pattern.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

_{Reviews (1): Last reviewed commit: "test: reduce suite latency with safe sha..." | Re-trigger Greptile}