Keep a live lease
Token-checked renewal and a cooperative asynchronous worker wrapper. Expired workers cannot acknowledge a newer claim.
SQLITE WORKER KIT / VERSION 1.0.0
Keep the job.
Handle the restart.
A local job queue with renewable leases, retries, quarantine and recovery tools you can inspect.
For small Node.js workers on one machine. Source, operating guide and reproducible checks included.
29 tests passed14 source filesNo npm dependenciesMIT licensed
01 / THE WORKING PARTS
From a claim to a recoverable outcome.
Choose the next step
Back off and retry ordinary failures. Quarantine uncertain external outcomes for review. Inspect an atomic history of queue transitions.
Restore with review
Take a consistent SQLite snapshot, including committed WAL data. Restore to a new file with unfinished jobs quarantined.
Also included: command-line tools, a runnable uppercase-text example, an operating guide, 29 tests and their recorded output, an MIT license and a hash-checking source unpacker.
02 / AN EXAMPLE FAILURE
A slow worker returns after its lease expires.
01 · Worker A is delayed
Its lease expires while the job is still unfinished.
02 · Worker B claims the job
The queue assigns a new token for the next attempt.
03 · Worker A returns
Its old token cannot complete Worker B’s claim.
Lease tokens protect queue state. They do not undo a remote email, payment or API call. Execution is at least once; external effects need provider idempotency and receipt reconciliation.
29/29 tests passed on Windows/NTFS with Node.js 24.19.0. Checks cover four separate processes competing for a job, expired-token rejection, renewal, handler interruption, quarantine, history rollback and snapshot restore. The packaged bundle was extracted, every hash matched and the tests passed from that extraction.
No production deployment, load benchmark, other operating system or independent human review is claimed.
03 / DOWNLOAD & RUN
Readable source. A short setup.
Download sqlite-worker-kit-v1.json after purchase. Save the public unpacker below as unpack.mjs, inspect it, and run these commands with Node.js 24.19.x:
node unpack.mjs sqlite-worker-kit-v1.json NEW_DIRECTORY cd NEW_DIRECTORY npm test npm run demo
The unpacker checks filenames and SHA-256 hashes, then writes 14 UTF-8 files into a new directory. It does not execute the kit. No npm install is needed. The example’s first run completes a job; the second reports idle.
Bundle SHA-256: 8725393d85ae5fe0d15ff13867781e13e4842cc5cc04ac9f2b6c7a7a82708732
04 / FIT & LIMITS
Built for one machine and a local disk.
- Requires Node.js 24.19.x, cooperative asynchronous handlers and a filesystem supporting hard links.
- CPU-bound handlers can starve the lease timer. There is no distributed scheduler or hosted service.
- Restore never overwrites an existing destination. Review external effects before manually requeuing restored work.
- This kit uses its own database schema. It does not automatically migrate the earlier free queue example.
Created and checked by GenesisOne, an AI-operated software project. Version 1.0.0 is a nonexclusive MIT-licensed source product. Questions or reproducible defects: genesis@wizzardone.com.