@starci/hfs 4.2.0 → 4.2.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 4.2.1 - 2026-10-10
+
+- Fixed: queue templates preserve the declared Redis database for both Queue and Worker connections, with a nonzero-database adapter regression.
+
 ## 4.2.0 - 2026-10-09
 
 - Changed: the lint runner (`lint/run.mjs`) and the bundled runtime copies follow the runtime of 1.0.0-alpha.9. Version 4.1.0 on the registry carries the copies of an earlier runtime.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starci/hfs",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "description": "The StarCi app command implementation for scaffolding, linting, checking and synchronizing one product repository.",
   "type": "module",
   "license": "MIT",

package/runtime/knowledge/hfs/canon-pins.yaml

@@ -29,14 +29,14 @@ pins:
     source: packages/grammar/package.json
     why: 'the grammar front ends read: the brand layer sets `--font-sans` and `--font-mono` and the grammar reads them; it carries the Input tel kind and the IconButton disclosure props. The runtime source version wins for a @starci package.'
   '@starci/eslint-canon-be':
-    version: 3.2.0
+    version: 3.2.1
     group: starci
     install: registry
     side: be
     source: packages/eslint/be/package.json
     why: 'the back-end ESLint canon: `loadHfs(import.meta.url)` of be/eslint.config.mjs finds the app-root hfs.json (kind app) and gives every linted file the view of the be side, and the project graph is built per side; its bundled runtime copies (slots, canon-pins, failure codes, the architecture machine) put .starcistacks and .sops.yaml at the app root; `starciBeConfig({ hfs: loadHfs(import.meta.url) })` is the typed factory and the BE-CONVENTION laws are its rules.'
   '@starci/eslint-canon-fe':
-    version: 8.2.0
+    version: 8.2.1
     group: starci
     install: registry
     side: fe
@@ -76,14 +76,14 @@ pins:
     source: packages/test-world/package.json
     why: 'the shared e2e library of every back end (R47, R48), a devDependency of every back end: the warm stack behind toxiproxy, the network-edge fakes, the Nest boot, the typed useTestWorld handle, useSandbox for contract specs and the outage lock. Kafka is real own infra (the one digest-pinned apache/kafka KRaft image, a broker listener and proxy per slot, slot-prefixed topics, consumer groups and client ids) and Postgres is schema-per-context (a schema and a login role per context in a shared database). Each worker has its own data slot (<ns>_w<k>) with its own databases, Keycloak realm, leased Redis DB, bucket/collection/topic prefixes, fakes host, toxiproxy proxies and outage lock; a run provisions min(jest workers, workers cap, default 2) slots, and state file protocol 2 pairs exactly with @starci/jest-preset (TEST_WORLD_PAIR_MISMATCH otherwise). A modules world boots real peer apps beside its modules, world.apps.<name>.during(fn) is the outage of a peer app, w.keycloak.clientSecret(client) answers the run-generated secret of a confidential realm client, world.keycloak.events/sessions read the realm user events and live sessions, world.infra.postgresql.connection(name) takes one database connection down while the others serve, and world.resolve and scope.resolve take any Nest token. Every path a declaration names (`stack`, seeds, the realm, Dockerfiles) resolves from the app root (the directory of hfs.json); the globalSetup registers the path aliases as TypeScript resolves them. Its CLI main is exported at ./cli for starci app stack.'
   '@starci/cli':
-    version: 1.2.0
+    version: 1.2.1
     group: starci
     install: registry
     side: both
     source: packages/cli/package.json
     why: 'the only StarCi command package; product repositories install it for starci app, while @starci/hfs remains its pinned transitive implementation.'
   '@starci/hfs':
-    version: 4.2.0
+    version: 4.2.1
     group: starci
     install: registry
     side: both

package/templates/be/patterns/queues/platform/bullmq-queue-transport.client.spec.ts.tpl

@@ -10,6 +10,7 @@ import type { BullmqJob, BullmqQueue, BullmqWorker, QueueFactory } from "./queue
 const options: QueueOptions = {
     redisHost: "redis.test",
     redisPort: 6380,
+    redisDb: 7,
     prefix: "spec.",
     relayIntervalMs: 100,
     relayBatch: 50,
@@ -45,7 +46,7 @@ describe("BullmqQueueTransportClient", () => {
         expect(factory.queue).toHaveBeenCalledTimes(1)
         expect(factory.queue).toHaveBeenCalledWith("orders", {
             prefix: "spec.",
-            connection: { host: "redis.test", port: 6380, maxRetriesPerRequest: null },
+            connection: { host: "redis.test", port: 6380, db: 7, maxRetriesPerRequest: null },
         })
         expect(queue.add).toHaveBeenNthCalledWith(1, "orders", payload, {
             jobId: "outbox-1",
@@ -84,7 +85,7 @@ describe("BullmqQueueTransportClient", () => {
 
         expect(factory.worker).toHaveBeenCalledWith("orders", expect.any(Function), {
             prefix: "spec.",
-            connection: { host: "redis.test", port: 6380, maxRetriesPerRequest: null },
+            connection: { host: "redis.test", port: 6380, db: 7, maxRetriesPerRequest: null },
             concurrency: 3,
         })
         const processor = factory.worker.mock.calls[0]?.[1]

package/templates/be/patterns/queues/platform/bullmq-queue-transport.client.ts.tpl

@@ -67,7 +67,12 @@ export class BullmqQueueTransportClient implements QueueTransport {
     private connection(): BullmqConnection {
         return {
             prefix: this.options.prefix,
-            connection: { host: this.options.redisHost, port: this.options.redisPort, maxRetriesPerRequest: null },
+            connection: {
+                host: this.options.redisHost,
+                port: this.options.redisPort,
+                db: this.options.redisDb,
+                maxRetriesPerRequest: null,
+            },
         }
     }
 

package/templates/be/patterns/queues/platform/queue-relay.service.spec.ts.tpl

@@ -16,6 +16,7 @@ const AT = "2026-02-03T04:05:06.000Z"
 const options: QueueOptions = {
     redisHost: "localhost",
     redisPort: 6379,
+    redisDb: 0,
     prefix: "test",
     relayIntervalMs: 100,
     relayBatch: 2,

package/templates/be/patterns/queues/platform/queue-transport.port.ts.tpl

@@ -20,6 +20,8 @@ export interface BullmqRedis {
     readonly host: string
     /** The port. */
     readonly port: number
+    /** The Redis database that holds this app's queue state. */
+    readonly db: number
     /** BullMQ answers to commands only through a client that does not retry on its own. */
     readonly maxRetriesPerRequest: number | null
 }

package/templates/be/patterns/queues/platform/queue-worker.service.spec.ts.tpl

@@ -12,6 +12,7 @@ import { QueueWorkerService } from "./queue-worker.service"
 const options: QueueOptions = {
     redisHost: "localhost",
     redisPort: 6379,
+    redisDb: 0,
     prefix: "test",
     relayIntervalMs: 100,
     relayBatch: 2,

package/templates/be/patterns/queues/platform/queue.config.ts.tpl

@@ -8,6 +8,7 @@ export type QueueConfig = Omit<QueueOptions, "connections" | "schedulers">
 export const parseQueueConfig = (env: EnvSource): QueueConfig => ({
     redisHost: env.string("QUEUE_REDIS_HOST"),
     redisPort: env.int("QUEUE_REDIS_PORT", 6379),
+    redisDb: env.int("QUEUE_REDIS_DB", 0),
     prefix: env.optional("QUEUE_PREFIX") ?? "queue",
     relayIntervalMs: env.duration("QUEUE_RELAY_INTERVAL", 200),
     relayBatch: env.int("QUEUE_RELAY_BATCH", 50),

package/templates/be/patterns/queues/platform/queue.options.ts.tpl

@@ -7,6 +7,8 @@ export interface QueueOptions {
     readonly redisHost: string
     /** The Redis port. */
     readonly redisPort: number
+    /** The Redis database that holds this app's queue state. */
+    readonly redisDb: number
     /** What every BullMQ key starts with: the shared default in a deployment, the run prefix of a test world. */
     readonly prefix: string
     /** The pause between two relay passes over an empty outbox. */