[ovflowd]

Description

This PR lets runGenerators keep none of the requested generators' output. It's the third part of a stack that splits #1205.

generate and preview collected every target's output into the arrays runGenerators returns, though neither reads them. With { results: false } it drains them instead: each generator still runs to its end, and once nothing else reads its output, its chunks go as they're recorded. Both commands now use it.

Validation

Added tests for draining a result alongside its other readers, a non-streaming result and a generator that fails, for the chunks of a drained result being let go as they are recorded, and for runGenerators running every generator but keeping no results. Built on 12 of Node.js's API docs at 1 and 4 threads, the output is byte-identical to main's.

Related Issues

Refs: #1205

Check List

• I have read the Contributing Guidelines and made commit messages that follow the guideline.
• I have run node --run test and all tests passed.
• I have check code formatting with node --run format:check & node --run lint.
• I've covered new added functionality with unit tests if necessary.

[vercel]

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

Project	Deployment	Actions	Updated
api-docs-tooling	Ready	Preview	Nov 4, 2026 6:25pm UTC

[codecov]

Codecov Report

❌ Patch coverage is 98.62069% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 94.36%. Comparing base (557f319) to head (1abb9ef).

Files with missing lines	Patch %	Lines
packages/cli/bin/commands/generate.mjs	0.00%	1 Missing ⚠️
packages/cli/bin/commands/preview.mjs	0.00%	1 Missing ⚠️

Additional details and impacted files

@@                  Coverage Diff                  @@
##           perf/stream-cache    #1239      +/-   ##
=====================================================
+ Coverage              94.34%   94.36%   +0.02%     
=====================================================
  Files                    293      293              
  Lines                  30157    30292     +135     
  Branches                3068     3087      +19     
=====================================================
+ Hits                   28451    28586     +135     
  Misses                  1684     1684              
  Partials                  22       22              

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

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[cloudflare-workers-and-pages]

🚀 Deploying Preview to Cloudflare 🚀

Preview Deployments by commit

Status	Deployment URL	Commit	Updated (UTC)	See this deployment's details
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	1abb9ef	2026-11-04T18:25:28.082Z	View logs ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	bad221d	2026-11-03T19:35:02.780Z	View logs ↗

[kgeminicdev]

Checked that drain can't stall with no reader attached: createReplay pulls the generator in record() on its own, so ended settles whether or not anyone reads. With forget() called and no readers, trim() lets each chunk go right after it's pushed. When a target is also a dependency that hasn't started streaming, release doesn't reach zero, so its chunks are kept until that reader starts, as they should be. The CLI's generate and preview are the only runGenerators callers and neither uses the return value, and the default stays results: true for API users. LGTM.