@softize/opus 21.0.0 → 21.0.1

package/CHANGELOG.md

@@ -7,6 +7,16 @@ Depois de qualquer bump, rode os gates (`typecheck` · `test` · `opus check` ·
 `opus copy --check` · `base copy check` · `manifest:check`) — eles apontam o que a
 mudança cobra do seu código.
 
+## 21.0.1 — 2026-09-26
+
+**Correção.** O `status()` do driver BullMQ podia devolver `status: 'done'` com `data: null` para um
+job que concluiu com resultado. O driver lia o job e depois o estado em duas consultas separadas;
+quando o worker terminava entre as duas, o estado já era terminal e o job lido ainda era o do
+processamento, sem resultado. Quem acompanhava o job por polling encerrava a espera sem o
+resultado e não voltava a consultar. O mesmo valia para `failed` sem o motivo. Agora, quando o
+estado é terminal e o job lido ainda não traz a conclusão, o driver relê o job antes de montar o
+handle. Nenhuma mudança é necessária no seu código.
+
 ## 21.0.0 — 2026-09-26
 
 As reactions passam a fazer o que a declaração promete. `retry`, `timeout`, `dedup` e

package/docs/ownership-vs-shadcn-lock.md

@@ -16,6 +16,11 @@
    tem opinião.
 4. Com o tempo, a biblioteca inteira converge pra "ours" naturalmente, pelo uso — sem
    big-bang, sem cerimônia de virada.
+5. **O ledger acompanha o ejetado.** Editar um componente `ejected` continua livre, mas a
+   edição atualiza no mesmo commit o `localHash` e, quando muda o comportamento, o `delta`
+   do `registry.lock.json`. O `lock.test` confere o hash dos ejetados com esse propósito: não
+   impede a edição, impede que o registro de proveniência derive em silêncio (set/2026, depois
+   de doze ejetados ficarem com hash desatualizado sem nenhum gate perceber).
 
 ## Princípio irmão: sobrescrita sancionada
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softize/opus",
-  "version": "21.0.0",
+  "version": "21.0.1",
   "description": "End-to-end action protocol for TypeScript. Single package with subpath exports (core + adapters).",
   "license": "MIT",
   "type": "module",

package/src/queue/drivers/bullmq.ts

@@ -93,9 +93,18 @@ export function bullmqQueue(options: BullmqQueueOptions): QueueAdapter {
     },
 
     async status(jobId: string): Promise<JobHandle | null> {
-      const job = await queue.getJob(jobId)
+      let job = await queue.getJob(jobId)
       if (job === undefined || job === null) return null
-      const state = await job.getState()
+      let state = await job.getState()
+      // `getJob` e `getState` são leituras separadas: se o worker concluir entre as duas, o
+      // snapshot ainda é o do job ativo, sem `returnvalue`, e o estado já é terminal. O BullMQ
+      // grava resultado e `finishedOn` no mesmo passo atômico; estado terminal sem `finishedOn`
+      // denuncia snapshot anterior à conclusão, e uma releitura enxerga o registro completo.
+      if (isFinished(state) && job.finishedOn === undefined) {
+        job = await queue.getJob(jobId)
+        if (job === undefined || job === null) return null
+        state = await job.getState()
+      }
       const action = readAction(job)
       return jobToHandle(action, job, mapState(state))
     },
@@ -165,6 +174,10 @@ export function mapState(state: BullMQState): JobStatus {
   }
 }
 
+function isFinished(state: BullMQState): boolean {
+  return state === 'completed' || state === 'failed'
+}
+
 function jobToHandle(
   action: string,
   job: BullMQJob,