feat!: adopt unthrown v5 (beta)

[btravers]

Summary

Adopts unthrown 5.0.0-beta.3 across the monorepo. beta.2 fixed the async-flatMap inference regression; beta.3 fixes the two remaining v5 inference regressions (concrete Err/Ok widening into a generic error union, and fromPromise T inference with an inline Promise.resolve().then(...) argument — the async-qualify ban moved off qualify's return type onto a phantom rest-tuple guard). The consumer code now compiles against the v5 error-channel API with no inference workarounds — except one fromThrowable-related re-assert, noted below.

Changes

• Bump: catalog unthrown and @unthrown/vitest at 5.0.0-beta.3; peer ranges ^5.0.0-beta.3 in packages/{core,client,worker}.
• Enter changesets beta pre-mode (.changeset/pre.json, tag beta).
• Migrate to the v5 error-channel API: the error combinators (mapErr / flatMapErr / recoverErr / tapErr / flatTapErr) and match's err handler now take a ts-pattern matcher callback that returns an exhaustive builder (the combinator owns .exhaustive()). Rough counts across packages/* + examples/*:
  • ~45 matcher callbacks introduced
  • 20 P._ catch-all branches
  • 8 matchTags call sites removed — folded into match(...).with(tag(...), …)
  • 5 tag(...) pattern usages
  • qualify boundaries unchanged in shape (already (cause, defect) => …).
• Docs / agent rules updated (docs/guide/upgrading.md, .agents/rules/handlers.md).

Inference workarounds

• Removed (fixed by beta.3): packages/worker/src/worker.ts — the createContext seed's fromPromise<Record<string, unknown>, HandlerError>(…) explicit type args, added under beta.2 because T collapsed to unknown. Now plain fromPromise(…) and inference holds.
• Kept (deliberate, unrelated to the beta.3 fixes): packages/core/src/parsing.ts — safeJsonParse's E & NotThenable<E> re-assert at its fromThrowable boundary. beta.3 did not move fromThrowable's NotThenable constraint off qualify's return type, and TypeScript cannot prove it for an unconstrained generic E; the assert collapses to plain E for every real (non-thenable) error type.

Gate (all green locally)

Command	Result
pnpm format --check	pass
pnpm lint	pass
pnpm typecheck	pass
pnpm knip	pass
pnpm test (coverage thresholds intact)	pass
pnpm build (incl. build:docs, 0 errors)	pass

Integration tests (Docker/RabbitMQ) were not run in this environment.

Release

Major changeset added (unthrown peer ^4 → ^5, now ^5.0.0-beta.3). In beta pre-mode this publishes the fixed group at 3.0.0-beta.0 (from 2.4.0) on merge. changeset version was not run.

[Copilot]

Pull request overview

This PR upgrades the monorepo to unthrown v5.0.0-beta.2, migrating error-channel combinators and Result.match’s err branch to the new ts-pattern matcher-callback API, and sets the repo up for a beta pre-release via Changesets.

Changes:

• Bumped unthrown and @unthrown/vitest to 5.0.0-beta.2 (catalog + lockfile) and updated package peer ranges to ^5.0.0-beta.2.
• Migrated worker/client code to v5’s matcher-callback shape for mapErr / flatMapErr / tapErr and updated docs/examples accordingly.
• Entered Changesets pre mode (tag: beta) and added a major changeset for the fixed group.

Reviewed changes

Copilot reviewed 19 out of 20 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
pnpm-workspace.yaml	Bumps catalog entries for unthrown + @unthrown/vitest to v5 beta.2.
pnpm-lock.yaml	Updates resolved versions/snapshots for the v5 beta.2 upgrade.
packages/worker/src/worker.ts	Migrates worker error combinators to v5 matcher-callback API; adds one explicit fromPromise type arg workaround.
packages/worker/src/retry.ts	Updates retry publish error recovery to v5 matcher-callback API.
packages/worker/src/errors.ts	Updates docs/comments to describe v5 matcher-based tagged-error dispatch.
packages/worker/package.json	Bumps unthrown peer dependency range to ^5.0.0-beta.2.
packages/core/src/parsing.ts	Adapts safeJsonParse to v5’s NotThenable-intersected qualify typing.
packages/core/src/errors.ts	Updates docs/comments to describe v5 matcher-based tagged-error dispatch.
packages/core/package.json	Bumps unthrown peer dependency range to ^5.0.0-beta.2.
packages/client/src/interceptors.ts	Updates interceptor docs to reflect v5 matcher-callback usage.
packages/client/src/interceptors.spec.ts	Updates tests to v5 matcher-callback API.
packages/client/src/client.ts	Migrates client error combinators / examples to v5 matcher-callback API.
packages/client/package.json	Bumps unthrown peer dependency range to ^5.0.0-beta.2.
examples/basic-order-processing-worker/src/index.ts	Updates example worker error handling to v5 matcher-callback API.
examples/basic-order-processing-client/src/index.ts	Updates example client error handling to v5 matcher-callback API.
examples/basic-order-processing-client/package.json	Moves unthrown to runtime deps to support new runtime import usage.
docs/guide/upgrading.md	Updates upgrade guide wording/snippets for v5 matcher-based dispatch.
.changeset/pre.json	Enters Changesets pre-mode for beta publishing.
.changeset/adopt-unthrown-v5-beta.md	Adds major changeset describing the v5 beta migration and peer bump.
.agents/rules/handlers.md	Updates agent guidance to document v5 matcher-callback API and match semantics.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file