v0.3.0

Highlights

This release adds the first supported acquisition pipeline for pulling agent work out of sbx sandboxes and normalizing it into sheal’s own raw session registry.

sheal pull for sbx sandboxes

sheal pull can now discover and capture work from local sbx sandboxes.

sheal pull --list
sheal pull sbx <name>
sheal pull sbx --all

• sheal pull --list shows available local sandboxes.
• sheal pull sbx <name> captures one sandbox.
• sheal pull sbx --all captures all eligible sbx sandboxes.
• Unknown sandbox names now fail with a clear error instead of producing partial output.

Captured material includes workspace diffs, agent-home evidence, transcripts where available, provenance metadata, and gap logs when expected evidence is missing.

Raw session registry

Pulled and imported sessions are normalized into a project-local raw registry:

.sheal/sessions/raw/<stable-session-id>/

This gives sheal a durable copy of captured session evidence, preserves provenance, and deduplicates repeated captures of the same underlying session.

Live-home session import

sheal sessions import can now normalize sessions from local agent homes, including Claude and Codex session stores.

sheal sessions import
sheal sessions import --source /tmp/agent-home
sheal sessions import --format json

Checkpoint capture

Long-running or fragile environments can be checkpointed manually or through configured checkpoint targets.

sheal pull sbx <name> --checkpoint
sheal pull --checkpoint-run

Package hardening

• The npm package install path is smoke-tested in a clean Docker container.
• The unpublished @liwala/agent-sessions workspace dependency is bundled and verified.
• npm audit reports zero vulnerabilities.
• CI runs build, tests, and package install smoke.

Install

npm install -g @liwala/sheal@0.3.0

Verification

This release was checked with:

npm run build
npm test
npm run lint
npm audit
npm run smoke:install:docker
sheal check