Skip to content

chore(services): remove BullMQ vaporware, reframe cluster packages as Redis-free-first#1840

Merged
xuyushun441-sys merged 2 commits into
mainfrom
chore/cluster-pkg-cleanup
Jun 14, 2026
Merged

chore(services): remove BullMQ vaporware, reframe cluster packages as Redis-free-first#1840
xuyushun441-sys merged 2 commits into
mainfrom
chore/cluster-pkg-cleanup

Conversation

@xuyushun441-sys

Copy link
Copy Markdown
Contributor

What

The queue/cluster packages presented Redis/BullMQ as the production path, which contradicts the platform's actual direction (DB-first, single-node affinity, Redis-free Cloud/EE). This cleans up the misleading surface — no behavior change to working code paths.

service-queue

  • Delete the BullMQQueueAdapter skeleton (every method threw "not yet implemented (M10.43)"); remove the 'bullmq' adapter option, the dead throw branch, the reserved redisUrl field, and the index exports. No external consumers (grep-verified).
  • DbQueueAdapter (sys_job_queue, lease-based claim) is the durable, multi-node, broker-free path.
  • Rewrite the README: it documented a fictional add/process/REST API and framed BullMQ/Redis as "production". Replaced with the real publish/subscribe + DLQ surface and the db/memory/auto adapters.

service-cluster

  • Downgrade the header doc: only the redis remote driver exists (postgres/nats are not built). Call out the memory-driver split-brain footgun for multi-replica deployments.

service-cluster-redis

  • Add a README positioning it as a community-optional reference driver that proves the registerClusterDriver() SPI — explicitly not on the Redis-free Cloud/EE deployment path. Fix the wiring example to the real defineCluster({ driver: 'redis' }) / ClusterServicePlugin({ config }) API.

Why

Open-core boundary: cluster primitives are open mechanisms (one-app-across-N-processes), not multi-tenancy. The platform's multi-node story is Redis-free (DB-backed queue + per-env affinity routing). The packages' docs/stubs implied a Redis-first production path that doesn't exist and isn't the direction.

Verification

  • turbo run build green (CJS + ESM + DTS) for all three packages.
  • service-queue tests: 20/20 pass.

Follow-up (not in this PR)

  • Memory-driver split-brain runtime guard (detect multi-replica + memory driver → warn/refuse) is documented here but not yet implemented.

🤖 Generated with Claude Code

… Redis-free-first

The queue/cluster packages presented Redis/BullMQ as the production path,
which contradicts the platform's actual direction (DB-first, single-node
affinity, Redis-free Cloud/EE). Clean up the misleading surface:

service-queue:
- Delete the BullMQQueueAdapter skeleton (every method threw "not yet
  implemented (M10.43)"); remove the 'bullmq' adapter option, the dead
  throw branch, the reserved redisUrl field, and the index exports. No
  external consumers (grep-verified). DbQueueAdapter (sys_job_queue,
  lease-based claim) is the durable, multi-node, broker-free path.
- Rewrite the README: it documented a fictional add/process/REST API and
  framed BullMQ/Redis as "production". Replace with the real
  publish/subscribe + DLQ surface and the db/memory/auto adapters.

service-cluster:
- Downgrade the header doc: only the redis remote driver exists
  (postgres/nats are not built). Call out the memory-driver split-brain
  footgun for multi-replica deployments.

service-cluster-redis:
- Add a README positioning it as a community-optional reference driver
  that proves the registerClusterDriver() SPI — explicitly NOT on the
  Redis-free Cloud/EE deployment path. Fix the wiring example to the real
  defineCluster({ driver: 'redis' }) / ClusterServicePlugin({ config }) API.

Verified: turbo build green (CJS+ESM+DTS) for all three packages;
service-queue 20/20 tests pass.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 14, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
spec Canceled Canceled Jun 14, 2026 6:40am

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation dependencies Pull requests that update a dependency file size/l labels Jun 14, 2026
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@xuyushun441-sys
xuyushun441-sys merged commit 20690dd into main Jun 14, 2026
12 of 13 checks passed
@xuyushun441-sys
xuyushun441-sys deleted the chore/cluster-pkg-cleanup branch June 14, 2026 06:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file documentation Improvements or additions to documentation size/l tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants