Repository navigation
Process crash and reopen experiments for real SQLite connections, with updated artifact support and public project documentation.
Fixed
-
Use preinstalled Google Chrome for Linux CI browser tests, avoiding APT mirror availability failures while keeping the full UI suite.
-
Pin Linux CI and release builds to Ubuntu 24.04 LTS for a stable browser-dependency and libc baseline.
-
Allow up to 15 seconds for large-recording completion messages in the CPU-throttled UI test, including on slower macOS Intel runners.
-
Restore frontend builds with Vite 8 by migrating editor chunk configuration to Rolldown's code splitting API.
-
Match the Biome configuration schema to version 2.6.4.
Added
- Typed
crashandreopenscenario steps: forcibly terminate one connection's worker process between confirmed statements, then open the same database file with a new worker. Available in scenarios, the CLI, recording replay and the workbench through Crash and Reopen on each connection card. - Three experiments for a process crash with an uncommitted transaction, after a confirmed COMMIT, and during a synthetic partially applied migration.
- Artifact format version 2 for scenarios and recordings that contain crash or reopen steps. Version 1 files are still read, and a version 1 scenario without such steps is still exported and recorded as version 1.
- Worker generation numbers in
readyand lifecycle events, per-connection state in the workbench, and rollback journal size in filesystem samples. - Contribution, conduct and security policies, GitHub issue forms and a pull request template.
- Editor settings matching Rustfmt and Biome, with LF line endings and protection for generated captures.
- Repository and packaging checks for documentation links, ignored local files and policy files in release archives.
Changed
- Update bundled SQLite from 3.53.2 to 3.54.1 through rusqlite 0.41.1.
- Rewrite the README for first-time readers, add a documentation index and a repository layout, and restructure the architecture guide.
- Workbench: experiments are grouped by topic in the list, each schedule step shows its explanation, Crash is visually secondary to Run, and the "fresh database" notice clears once a step runs.
- Redraw the project icon as two overlapping transactions on separate connection lanes.
- Pin workflow actions to commit SHAs, cancel superseded CI runs and require release archive uploads to contain files.
- Include community policies and the changelog in future release archives.
Downloads and compatibility
Archives are provided for Linux x86_64, macOS ARM64, macOS Intel (x86_64) and Windows x86_64. Each includes the executable, documentation, policies, scenarios and recordings, with a matching SHA-256 file and SQLite environment metadata. Node.js and a system SQLite installation are not required.
Extract the archive and run ./txnstage serve (txnstage.exe serve on Windows). Open the complete local URL printed in the terminal. Experiments use only TxnStage-owned disposable databases.
Crash steps terminate a worker process at a confirmed statement boundary; they do not simulate a power outage, OS crash or storage-device failure. Reopen starts a new worker against the same experiment database. Format version 2 is used for scenarios and recordings with lifecycle steps; format version 1 remains readable and is still used for SQL-only exports. Older executables do not support version 2 lifecycle artifacts.
macOS binaries have no Developer ID signature or notarization; Windows binaries are unsigned. The Linux binary requires glibc 2.39 or newer.
Verification
Source commit: 15ac272751c340a21f0cdbc16647b40b11d6bc1d. Release builds and tests: https://github.com/0then0/txnstage/actions/runs/43049144754. General CI: https://github.com/0then0/txnstage/actions/runs/43049089471.
All four release jobs passed repository checks, frontend checks, native tests and the full UI suite. Archives were verified for SHA-256 integrity, binary architecture, versions and exact package contents. The downloaded macOS ARM64 executable also passed standalone asset serving and cleanup checks, plus all three crash/reopen scenarios.