lwc v0.14.7

LWC v0.14.7 is a reliability release for checkpoint recovery and binary installation. It keeps canonical Wiki state, generated Markdown, and the document graph synchronized after a restore, and makes recovery failures explicit and retryable instead of leaving derived state silently stale.

Highlights

Projection-safe checkpoint restore

• lwc checkpoint restore now queues observable document-graph Work after canonical recovery and returns its identifier as graph_work.
• Full projection reconciles both restored documents and stale graph keys, so nodes introduced after the checkpoint are removed and lwc graph verify returns clean.
• Graph-disabled projects keep the existing no-projection behavior.

Atomic recovery safeguards

• Checkpoints are prepared and validated in a private temporary database before live state changes.
• Restore records its canonical operation in the candidate database before publication, preventing a malformed or read-only checkpoint from partially replacing the live Wiki.
• A pre-restore safety checkpoint is created automatically, and a live revision guard rejects concurrent writes instead of overwriting them.
• SQLite busy/locked states have a bounded deadline and return a retryable database_busy error rather than waiting indefinitely.
• Temporary candidates are cleaned up with handle-safe ordering and are never exposed as user checkpoints.
• Checkpoints created with non-default SQLite page sizes remain restorable.

Actionable partial-failure reporting

• Markdown materialization and graph projection are attempted independently after canonical restore.
• If either derived projection cannot be completed, the error states that canonical recovery succeeded, includes the safety checkpoint, and provides scope-correct recovery commands.

Installer reliability

• The npm installer now applies a 30-second timeout to each GitHub asset request.
• Transient download failures are retried twice with bounded exponential backoff.
• Final errors preserve the underlying HTTP, timeout, or transport cause.
• Archive selection and checksum verification remain unchanged.

Work lifecycle coverage

• Release tests now exercise a real document-graph Work through cancel, terminal cancelled, resume, terminal succeeded, and final graph verify.

Compatibility

• No intentional breaking CLI or Wiki schema changes.
• Existing checkpoints, Wiki databases, Agent integrations, document graphs, and CodeGraph indexes remain compatible.
• This release supersedes v0.14.6 for checkpoint restore workflows; users of document-graph checkpoints should upgrade.

Install and upgrade

Shell installer:

curl --proto '=https' --tlsv1.2 -fsSL \
  https://github.com/JanYork/llm-wiki-cli/releases/latest/download/install.sh | sh

npm:

npm install --global @i-xor/lwc@0.14.7

Refresh installed Agent integrations after upgrading:

lwc agent refresh --target auto --location global

All native archives are covered by the published SHA256SUMS; both installers verify the selected archive before installation.

Verification

The release candidate passed:

• Rust formatting and Clippy with warnings denied.
• The full Rust suite: 378 passed, 0 failed, with 4 opt-in performance benchmarks ignored by design.
• npm and Agent integration contracts: 14 passed, 0 failed.
• Release-mode installation from the repository.
• A real checkpoint create, post-checkpoint mutation, graph projection, restore, Work watch, canonical deletion check, and clean graph verify flow.
• Dynamic Codex, Claude Code, and Pi lifecycle Hook checks plus the standard read-only LWC MCP handshake.
• Final adversarial review of checkpoint atomicity, temporary-file ownership, Windows handle ordering, retry bounds, recovery scope, and npm timeout behavior.

GitHub Actions additionally builds, tests, packages, and smoke-tests native archives for x86_64 and arm64 macOS, glibc Linux, and Windows before publishing the Release.

Full changelog: v0.14.6...v0.14.7