Luotsi 0.1.0

What changed for agent builders

• Luotsi now has a stable first-minute output loop for agents: command -> structured output -> artifact root -> replay command -> next action.
• inspect and view --json keep JSONL session semantics explicit, while one-shot commands keep the luotsi-command.v1 envelope contract for scripts and CI.
• Failed runs can start with luotsi replay packet --artifacts <artifact-root> to write run-summary.json and run-summary.md, then use replay packet --check as the packet validation gate.
• The repo includes reusable agent guidance and parser examples for extracting the next command from envelopes, JSONL logs, and persisted run-summary packets.

What changed for engineers and CI

• The CLI is packaged as self-contained release archives for Windows, Linux, macOS x64, and macOS arm64, with installer scripts, SHA-256 checksums, and release asset attestations.
• First-run setup is centered on luotsi quickstart, luotsi doctor, and luotsi doctor --fix so adb readiness, device selection, live-view prerequisites, helper APK presence, and FFmpeg view extras are visible before deeper workflows.
• Scenario runs, shared-lab device claims, JUnit/JSON reports, replay artifacts, failure capsules, replay graphs, and artifact packages now share the same evidence-first handoff model.
• Live view sharing is intended for trusted lab or development networks only; --share-bind uses raw TCP today and does not provide TLS or authentication.

Open this first

• Docs hub: https://digablesolutions.github.io/luotsi/docs/
• First five minutes: https://digablesolutions.github.io/luotsi/docs/getting-started/first-five-minutes/
• AI agent workflows: https://digablesolutions.github.io/luotsi/docs/core-workflows/ai-agent-workflows/
• Installation: https://digablesolutions.github.io/luotsi/docs/getting-started/installation/
• Replay and artifacts: https://digablesolutions.github.io/luotsi/docs/core-workflows/replay-and-artifacts/

Output and replay handoff

• For source-tree validation, run luotsi help output to see the JSON envelope, JSONL session, artifact root, and replay mental model.
• When a release note mentions failed CI runs, agent handoffs, or artifact packets, point the first follow-up to luotsi replay packet --artifacts <artifact-root> and the validation gate to luotsi replay packet --artifacts <artifact-root> --check so evaluators get run-summary.json, run-summary.md, the At a Glance summary, primary failure, recommended next action, and the 60-second checklist. Use luotsi replay open --artifacts <artifact-root> --dry-run when a human needs the replay front door without launching a browser.

What's Changed

Other changes

• [codex] Add docs architecture diagrams by @slideep in #133
• Prepare first stable release gates by @slideep in #134

Full Changelog: v0.1.0-rc.12...v0.1.0

Luotsi 0.1.0-rc.12

Highlights

• Replay, live view, scenario authoring, and device-lab workflows are moving toward a single developer-first Android automation surface.
• This prerelease is intended for early validation on real devices, CI runners, and agent-driven debugging loops.
• Open the first-five-minute, replay, and installation docs first when validating the release.

Validation Focus

• Exercise view, view setup --fix, and doctor --fix from a clean install.
• Run a small scenario with JSON/JSONL reports and inspect the replay artifacts.
• Run luotsi help output for the JSON envelope, JSONL session, artifact root, and replay handoff model.
• Start failed CI, agent, or artifact-packet triage with luotsi replay packet --artifacts <artifact-root>, then validate the packet with luotsi replay packet --artifacts <artifact-root> --check to see run-summary.json, run-summary.md, the At a Glance summary, primary failure, recommended next action, and the 60-second checklist. Use luotsi replay open --artifacts <artifact-root> --dry-run when a human needs the replay front door without launching a browser.
• Check that release packages include the expected helper APK and host-native runtime assets.

Start Here

• Docs hub: https://digablesolutions.github.io/luotsi/docs/
• First five minutes: https://digablesolutions.github.io/luotsi/docs/getting-started/first-five-minutes/
• Replay and artifacts: https://digablesolutions.github.io/luotsi/docs/core-workflows/replay-and-artifacts/
• Installation: https://digablesolutions.github.io/luotsi/docs/getting-started/installation/

What's Changed

Other changes

• [codex] Add quickstart verification gate by @slideep in #120
• [codex] Add Journey intake init handoff by @slideep in #121
• [codex] Add quickstart verify local proofs by @slideep in #122
• [codex] Add ANSI color to human CLI output by @slideep in #124
• [codex] Refresh architecture subsystem docs by @slideep in #123
• [codex] Add docs copy page actions by @slideep in #125
• [codex] Shorten README and route details to docs by @slideep in #126
• [codex] Add Luotsi agent skill by @slideep in #127
• [codex] Use generic selector examples by @slideep in #128
• [codex] Add helper diagnostics side channel by @slideep in #129
• [codex] Harden production triage packets by @slideep in #130
• [codex] Refresh documentation site styling by @slideep in #131
• [codex] Restore docs Copy Page dropdown styling by @slideep in #132

Full Changelog: v0.1.0-rc.11...v0.1.0-rc.12