Repository navigation
1.0.0-rc.4
Pre-releaseA release candidate on the 1.0 baseline. rc.5 comes next, a reorganisation of the source so it can be maintained by hand again, and 1.0.0 after it. The data model is the rc.3 model with four counters widened to 32-bit integers and one new feature, lanes. What changed since rc.3 answers the external reviews of it: the execution and alerting paths, the installed routines, and what a release has to prove.
Upgrade: reprovision every release-candidate database, on every provider. The baseline is cut once more: runtimes.failure_count, steps.attempt_number, definitions.max_attempts (with its override and effective columns), and alerts.retry_count widen to 32-bit integers, and startup refuses a database an earlier release candidate provisioned, naming the mismatch. Reprovisioning drops Acta's schema and installs it from docs/reference/schema-<provider>.sql, so drain or export what you need first. Recreate an outbox table created before this release from the DDL API. A new job status, Blocked (15), marks a laned job waiting behind its lane's head. IDefinitions.UpdateOverridesAsync and RetireAsync take the reason before the actor, control bodies refuse members the endpoint does not take, and the local-only guard also requires the host to be named localhost or an IP address. The release notes list every change a consumer must make.
Highlights
- Lanes.
.Lane("customer-42")on an enqueue, or[Job("...", Lane = "...")]on a definition, runs a lane's jobs one at a time in enqueue order, across the whole fleet. Only the head is claimable; the rest waitBlockedand are promoted as the head settles, so a deep lane costs no claim work. The outbox keeps a lane's staging order. - The claim seeks each priority band. On SQL Server the stuck-job reclaim locks only its own rows and a lane's members are found by seek instead of walking the job table, and alerts take their job's lock first everywhere.
- Completion and start writes repeat until they land, and a lost answer is reconciled against the row instead of re-run. A claim whose answer was lost goes back to Ready through the heartbeat, a Bulk completion stays owned until it settles, and recovery runs on capacity the executors cannot exhaust.
- Workers' lifecycle states hold through outages and drains: a worker killed mid-drain is marked Dead, and a worker marked Dead through a database outage is Active again when it heartbeats.
- Installed objects carry a version that startup checks; PostgreSQL routines and views are replaced in place, and an older release never overwrites a database a newer one upgraded.
- Alerting: an incident at
AuditLevel.Failurescloses on its own. - Retention keeps a completed child while its parent is live.
- Scheduling: an operator's pause holds until an operator resumes it, and a timed pause ends by the schedule's misfire policy.
- Dashboard and HTTP API: per-route authorizer verbs, exact control bodies, the outbox family authorized like the others, and schedule overrides and alert notes saved again.
Evidence
- Six chaos-certification seals on the certified commit
d616c72b, all PASS with real chaos, underdocs/certification/: PostgreSQL and SQL Server at 10,000 jobs and 64 slots, SQLite reduced at 48 slots, the three-participant ensemble, and a million jobs each on PostgreSQL and SQL Server through 1,536 concurrent slots with a worker killed every five seconds. Lanes held their order and drained on every provider while their heads' workers were killed, every rate meter stayed inside its budget, and no step was recorded twice. AtMostOnce charges a kill interrupted inside their guarded step ended Failed, as the contract requires. - The benchmark round in
docs/benchmarks/rc4-release-round-20261002.md: level with rc.3 on drain, enqueue, and latency at thereleasepreset, except SQL Server's one-worker drain and Direct drain at sixteen workers and the job list query; SQLite pays about an eighth for lanes. At full scale, PostgreSQL's Bulk drain at sixteen workers reads about 13 percent below rc.3, cause not yet found.
Install with --prerelease: dotnet add package Acta.Sqlite --prerelease.
Full notes: docs/release-notes.md.