Skip to content

Expose stderr terminal state through Stdio - #8686

Open
ChrisPrapas wants to merge 2 commits into
Effect-TS:mainfrom
ChrisPrapas:fix/effect-8639
Open

ChrisPrapas wants to merge 2 commits into
Effect-TS:mainfrom
ChrisPrapas:fix/effect-8639

Conversation

@ChrisPrapas

Copy link
Copy Markdown

Summary

Adds stderrIsTerminal to Stdio, next to stdinIsTerminal and stdoutIsTerminal, following #7090. A program that reuses stdout's answer for stderr gets it wrong for cases like tool | less (stdout piped, stderr a terminal) and tool 2>log.txt (stderr redirected, stdout a terminal).

This PR was prepared with the help of an AI assistant (Claude Code).

Changes

  • Stdio interface gains stderrIsTerminal: Effect.Effect<boolean>. make and layerTest default it to false, like the other two.
  • Node (NodeStdio): process.stderr.isTTY === true, read each time the effect runs. Bun and Node pick it up through node-shared.
  • Deno (DenoStdio): Deno.stderr.isTerminal(), read each time the effect runs.
  • Tests: the existing Stdio, NodeStdio and DenoStdio tests are extended so stderr differs from stdout in each case, so a crossed wire fails.
  • Patch changeset for effect, @effect/platform-node-shared and @effect/platform-deno.

Compatibility

Like #7090, this adds a required member to the Stdio interface. Callers that use make or layerTest are unaffected. Hand-built Stdio object literals need the new field.

Assumption

I assumed stderr was not left out on purpose. Happy to close this if it was.

Testing

Run with npx -y pnpm@11.20.0:

  • pnpm test --run packages/effect/test/Stdio.test.ts packages/platform/node-shared/test/NodeStdio.test.ts packages/platform/deno/test/DenoStdio.test.ts: 2 files passed, 3 tests passed. The Deno test file was skipped under Node.

Not run by me before opening this draft (stated plainly so reviewers do not assume otherwise): pnpm check, pnpm lint, pnpm circular, pnpm jsdocs --check, pnpm ai-docgen, and the Deno runtime tests and deno check. The Deno changes are therefore untested under Deno. I'll rely on CI for the rest.

Closes #8639

🤖 Generated with Claude Code

Expose whether standard error is a terminal next to stdinIsTerminal and
stdoutIsTerminal. make and layerTest default it to false; the Node and
Deno layers read the real stream state each time the effect runs. Bun
and Node pick it up through node-shared.

Closes Effect-TS#8639

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@changeset-bot

changeset-bot Bot commented Oct 3, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 6137f50

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 32 packages
Name Type
effect Patch
@effect/platform-node-shared Patch
@effect/platform-deno Patch
@effect/opentelemetry Patch
@effect/vitest Patch
@effect/ai-anthropic Patch
@effect/ai-cloudflare Patch
@effect/ai-openai-compat Patch
@effect/ai-openai Patch
@effect/ai-openrouter Patch
@effect/ai-typesafe Patch
@effect/atom-react Patch
@effect/atom-solid Patch
@effect/atom-vue Patch
@effect/platform-browser Patch
@effect/platform-bun Patch
@effect/platform-node Patch
@effect/sql-clickhouse Patch
@effect/sql-d1 Patch
@effect/sql-libsql Patch
@effect/sql-mssql Patch
@effect/sql-mysql2 Patch
@effect/sql-pg Patch
@effect/sql-pglite Patch
@effect/sql-sqlite-bun Patch
@effect/sql-sqlite-do Patch
@effect/sql-sqlite-node Patch
@effect/sql-sqlite-react-native Patch
@effect/sql-sqlite-wasm Patch
@effect/docgen Patch
@effect/doctest Patch
@effect/openapi-generator Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions

github-actions Bot commented Oct 3, 2026 •

Copy link
Copy Markdown
Contributor

Bundle Size Analysis

Generated from PR build output; treat the content below as untrusted.

File Name Current Size Previous Size Difference
arbitrary-combinators.ts 38.90 KB 38.90 KB 0.00 KB (0.00%)
basic.ts 7.04 KB 7.04 KB 0.00 KB (0.00%)
batching.ts 10.13 KB 10.13 KB 0.00 KB (0.00%)
brand.ts 6.72 KB 6.72 KB 0.00 KB (0.00%)
cache.ts 10.88 KB 10.88 KB 0.00 KB (0.00%)
config.ts 22.15 KB 22.15 KB 0.00 KB (0.00%)
differ.ts 21.29 KB 21.29 KB 0.00 KB (0.00%)
http-client.ts 22.43 KB 22.43 KB 0.00 KB (0.00%)
http-router.ts 33.74 KB 33.74 KB 0.00 KB (0.00%)
logger.ts 11.08 KB 11.08 KB 0.00 KB (0.00%)
metric.ts 9.02 KB 9.02 KB 0.00 KB (0.00%)
optic.ts 6.95 KB 6.95 KB 0.00 KB (0.00%)
pubsub.ts 15.16 KB 15.16 KB 0.00 KB (0.00%)
queue.ts 12.08 KB 12.08 KB 0.00 KB (0.00%)
schedule.ts 11.18 KB 11.18 KB 0.00 KB (0.00%)
schema-bigdecimal.ts 13.73 KB 13.73 KB 0.00 KB (0.00%)
schema-binary.ts 39.95 KB 39.95 KB 0.00 KB (0.00%)
schema-class.ts 21.03 KB 21.03 KB 0.00 KB (0.00%)
schema-fromJsonSchemaDocument.ts 32.06 KB 32.06 KB 0.00 KB (0.00%)
schema-representation-roundtrip.ts 27.24 KB 27.24 KB 0.00 KB (0.00%)
schema-string-transformation.ts 14.46 KB 14.46 KB 0.00 KB (0.00%)
schema-string.ts 11.99 KB 11.99 KB 0.00 KB (0.00%)
schema-template-literal.ts 16.05 KB 16.05 KB 0.00 KB (0.00%)
schema-toArbitrary.ts 38.44 KB 38.44 KB 0.00 KB (0.00%)
schema-toCodeDocument.ts 25.26 KB 25.26 KB 0.00 KB (0.00%)
schema-toCodecJson.ts 20.21 KB 20.21 KB 0.00 KB (0.00%)
schema-toEquivalence.ts 20.41 KB 20.41 KB 0.00 KB (0.00%)
schema-toFormatter.ts 20.54 KB 20.54 KB 0.00 KB (0.00%)
schema-toJsonSchemaDocument.ts 25.00 KB 25.00 KB 0.00 KB (0.00%)
schema-toRepresentation.ts 20.50 KB 20.50 KB 0.00 KB (0.00%)
schema.ts 20.25 KB 20.25 KB 0.00 KB (0.00%)
stm.ts 13.08 KB 13.08 KB 0.00 KB (0.00%)
stream.ts 9.98 KB 9.98 KB 0.00 KB (0.00%)

@ChrisPrapas
ChrisPrapas marked this pull request as ready for review October 5, 2026 08:21

This branch is waiting to be deployed

1 waiting deployment
fork — 6137f50d Waiting Oct 5, 2026 by ChrisPrapas via approval-gate #17305
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

DRAFT: Stdio: no stderrIsTerminal, so a program can't tell whether stderr is a terminal

1 participant