effect-jobs 0.1.0-alpha.1 → 0.1.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,92 @@
 # Changelog
 
+## 0.1.0-alpha.3 (unpublished candidate)
+
+Breaking prerelease changes since the published alpha.2 package:
+
+- Require exact Effect/sql-pg `4.1.0` and optional Drizzle `1.0.0-rc.5`, replacing
+  Effect/sql-pg `4.0.5` and the two hash-suffixed Drizzle snapshots. Node `24.15.0`
+  and Bun `1.4.2` remain pinned; the local Alchemy example uses `2.0.0-beta.85`.
+- Evaluate lazy `Job.make`, `JobProducer.make`, `JobPolicy.make` and
+  `JobPayload.encrypted` setup in their typed Effect channels. Reuse one
+  application-owned definitions Layer; do not hide setup in synchronous runners.
+- Move routing and default policy from jobs into immutable producer slot bindings:
+  `JobProducer.make(operation).pipe(JobProducer.withSlot(slot, job, { queue }))`.
+  Enqueue now takes one object containing `slot`, `operationId` and `payload`.
+  Fixed bindings forbid an enqueue queue; selectable `{ queues: [...] }` bindings
+  require a declared queue-name string. Job-level enqueue and producer `identity`
+  are removed. See [the API migration contract](./specs/api-refinements.md).
+- Replace `JobRegistry`, `JobConsumer`, `JobWorkerRuntime` and `PollingJobWorker`
+  public entrypoints with `JobGroup`, `JobApi`, `JobApiBuilder`, `JobStorage`,
+  `JobSchedule` and `JobPolling`. Declare complete catalog handlers and compose
+  the shared worker/storage graph explicitly; old imports are not aliases.
+- Configure retries through `JobRetryPolicy` and `yield* JobPolicy.make({ retry })`.
+  Replace `retryDelay`/`maxAttempts` options with `fixed`/`exponential`, optional
+  cap/jitter, and `maxFinalizedAttempts`. Public counters use `finalizedAttempts`;
+  stored `maxAttempts`/`attempts_made` keys are retained. Upgrade every reader
+  before producing `BackoffV1`/`ProportionalV1` jobs; old readers cannot process
+  them safely. Existing `FixedDelayV1` policies keep their semantics.
+- Adapt encrypted codecs to the lazy Schema-native transformation, with explicit
+  independent seal/open services. Already-protected envelopes remain supported.
+  The application still owns encryption, keys and stable keyed fingerprints.
+
+Also included: read-only bounded scheduling, nullable creation metadata and its
+application-owned `creationTimeMigration`, focused PostgreSQL implementation
+subpaths behind the unchanged public PostgreSQL export names, and bounded
+observability with application-owned exporters. Review schema readiness and
+apply required migrations before starting readers; runtime never migrates or
+resets an installation. See [retry rollout](./specs/retry-policy.md) and the
+[PostgreSQL contract](./specs/postgresql-jobs.md).
+
+This entry describes prepared source, not publication or a fresh qualification
+PASS. The release handoff binds actual commands, exceptions and cleanup to one
+immutable archive. Completed retention remains 90 days. Website/playground source
+is excluded from npm; no deployment or production guarantee is implied.
+
+## 0.1.0-alpha.2 (published)
+
+Breaking prerelease changes since alpha.1:
+
+- Rename public `Job.make({ kind })` to `{ name }`, definition/catalog and handler
+  context access from `.kind` to `.name`, and `JobIdentity.JobKind` to
+  `JobIdentity.JobName`. The public Drizzle jobs-column property also becomes
+  `.name`, including `extraIndexes` callbacks. Keep existing name values and
+  catalog versions: the physical PostgreSQL column is still `kind`, so this
+  rename alone needs no column rename, data rewrite/reset or migration. See
+  [the API migration contract](./specs/api-refinements.md).
+- Require exact Effect `4.0.5`; the qualified native PostgreSQL companion is
+  `@effect/sql-pg@4.0.5`. Optional Drizzle peers are the exact snapshots
+  `1.0.0-rc.5-ab785fc` and `1.0.0-rc.5-169397b`.
+- Bind producer slots to definitions with inferred enqueue inputs and explicit
+  application-owned transaction/service composition.
+- Extend the PostgreSQL schema/readiness contract for Cancelled jobs, guarded
+  operators, corrected redrive and durable repair lineage. Applications own
+  migration review and execution; runtime does not migrate old installations.
+
+Also included:
+
+- Focused `JobOperators` support for guarded retry acceleration, cancellation and
+  redrive; corrected redrive creates a new job and preserves source evidence.
+- Current Astro documentation, runnable application examples and the local
+  playground. The npm package excludes the website/playground implementation.
+- PostgreSQL Node/Bun CI, real-process crash/recovery tests, and a bounded manual
+  soak harness. These are scoped synthetic qualification, not production or
+  exactly-once guarantees.
+
+Completed retention remains 90 days by default. Upstream Drizzle full-declaration
+checks retain their documented known-failure exceptions; successful own-code
+checks do not mean upstream full strict PASS. The registry contains this release
+with Effect `4.0.5` and the two Drizzle snapshots; current source is not identical
+to those published bytes. Deployment is not established by registry publication.
+
+## 0.1.0-alpha.1-effect.4.0.5.local.2 (local only)
+
+- Qualify exact Drizzle snapshots `1.0.0-rc.5-ab785fc` and `1.0.0-rc.5-169397b`
+  with Effect/sql-pg 4.0.5; use `ab785fc` for the Alchemy beta.83 peer graph.
+- Preserve native PgClient transaction ownership and production runtime bytes.
+- Keep the narrowly approved seven upstream declaration diagnostics as separate
+  C FAIL; require independent A+B source and negative controls for both snapshots.
+
 ## 0.1.0-alpha.1
 
 Breaking prerelease API changes since alpha.0: