Repository navigation
kindling v0.4.0
kindling 0.4.0
Integration-hardening release. Closes out the post-0.3 downstream-integration
work the daemon/client contract needed before anvil could depend on it in
anger: redaction evidence, published fixtures, an authenticated TCP transport,
atomic capsule close, honest --db routing, outage spooling that stays flat
under a deep backlog, and composite scope indexes for keyset reads. It also
carries the CodeQL path-injection fix and the cleartext-logging triage.
Breaking for
kindling-server(build_routergains atcp_secret
argument), for mixed-version TCP deployments (the daemon now requires a
bearer token on loopback TCP), and for the schema contract (v5 to v6).
Pre-1.0, a breaking change bumps the minor, hence 0.4.0.
npm publishing discontinued. kindling no longer publishes to npm (D-010).
This is the first GitHub Release since v0.1.2, and it ships as Release assets
(the 7 prebuiltkindlingbinaries, attached to a Release for the first
time, and the VS Code / Cursor / Windsurf VSIX), the Homebrew tap, and
crates.io. The npm packages@eddacraft/kindling,
@eddacraft/kindling-adapter-opencodeand
@eddacraft/kindling-adapter-pocketflowstay at the retired 0.1.2
TypeScript engine and are being deprecated with a notice pointing at the
binary install. Their source stays in the repository: the thin client is
bundled into the VSIX, and the adapters can be used from a clone.
Highlights
- Authenticated loopback-TCP transport (KINTEG-010). The daemon mints a
per-daemon secret, stores it in an owner-only token file beside the port
file, and rejects every request exceptGET /v1/healththat does not carry
it as a bearer token. The client reads the token automatically. UDS is
unchanged. - Redaction evidence (KINTEG-006). Append responses report how many
secret matches were masked and which classes matched, never the values, so a
consumer can prove sensitive content was handled without re-leaking it. - Published hook-payload fixtures (KINTEG-007). A versioned
fixtures/hook-payloads/claude-code.json, also exported from
@eddacraft/kindlingas./fixtures, gives adapter authors a stable
artefact to test against. The export-bundle compatibility guarantee is now
documented indocs/data-model.md. - Flat outage spooling (KINTEG-013).
SpooledClientno longer rescans or
rewrites the whole backlog per append, and backs off a known-unavailable
daemon instead of retrying on every observation. - Composite scope indexes (KINTEG-014, schema v6). Keyset list queries over
a repo or session no longer sort through a temporary B-tree. - Correctness fixes: capsule close is atomic when the summary is missing
(KINTEG-011);--via-daemonwith--dbis rejected instead of silently
routing to a different project's database (KINTEG-012). - Security: database paths are validated before anything is created on
disk (CodeQLrust/path-injection#15); therust/cleartext-loggingalerts
#11 to #14 are triaged as false positives with a CodeQL model pack and a
written disposition inSECURITY.md.
Breaking changes and upgrade
- TCP transport requires a bearer token. A 0.3 client talking to a 0.4
daemon over TCP (the Windows default) receives 401. Upgrade the client and
the daemon together. No configuration changes: the token file is derived
from the existing port-file rendezvous. kindling_server::build_router(state, tcp_secret). PassNonewhen
embedding the router over UDS only.- Schema v5 to v6. Read-write opens migrate in place on first open.
Read-only opens of v5 databases still work. A v6 database cannot be opened
by a 0.3 engine, so do not downgrade after the first open.
Install
# Rust SDK (daemon-backed), with the durable-emit spool
cargo add kindling-client@0.4 --features spool
# one-dependency embedded runtime
cargo add kindling-runtime@0.4
# CLI binary
cargo install eddacraft-kindling@0.4
# Homebrew (macOS/Linux)
brew install eddacraft/tap/kindling
# install script (resolves the latest GitHub Release)
curl -fsSL https://raw.githubusercontent.com/eddacraft/kindling/main/install.sh | shThe editor extension is the kindling-0.4.0.vsix asset on this Release; see
the Cursor and Windsurf quickstart.
Notes
- The Rust crates are published to crates.io separately via
scripts/publish.shin dependency order (types, store, provider, service,
server, client, runtime, kindling).kindling-benchispublish = false. - Publishing this GitHub Release triggers
release.yml(binary archives and
the VSIX attached to the Release, plus the automatedhomebrew-tapPR, which
needs theHOMEBREW_TAP_TOKENsecret). Nothing is published to npm.
Changelog: see CHANGELOG.md ·
Full diff: v0.3.0...v0.4.0