# Release Notes This directory records versioned release notes for relay-baton. Each note should explain: - What changed - Why it changed - User-facing commands or behavior - Compatibility notes - Recommended next work Release notes are user-facing changelogs, not agent handoff material — that role belongs to `.ai-session/handoff.md`. Keep release notes free of one-shot validation logs or test inventories; those go stale and duplicate CI / git history. English notes live at the directory root; per-language translations live in subdirectories by locale code (`ko/`, `ja/`, `zh-CN/`, `zh-TW/`, `es/`, `fr/`, `de/`, `pt-BR/`, `ru/`). Current post-GA releases (v1.2.0, GA) are translated into all ten README locales; older alpha notes are English + Korean only. ## Versions - [v1.6.1](./v1.6.1.md) — One-click Windows install: the NSIS setup skips the Welcome and Choose-Location pages (custom template) so double-clicking installs straight to the per-user location and shows a brand finish screen. Brand artwork and no-UAC install unchanged. - [한국어](./ko/v1.6.1.md) · [日本語](./ja/v1.6.1.md) · [简体中文](./zh-CN/v1.6.1.md) · [繁體中文](./zh-TW/v1.6.1.md) · [Español](./es/v1.6.1.md) · [Français](./fr/v1.6.1.md) · [Deutsch](./de/v1.6.1.md) · [Português](./pt-BR/v1.6.1.md) · [Русский](./ru/v1.6.1.md) - [v1.6.0](./v1.6.0.md) — Modern Windows installer: the desktop app ships as a brand-styled NSIS `…-setup.exe` (warm-dark welcome panel, per-user install, no UAC) instead of the classic MSI wizard. CLI channels (npm/brew/scoop/winget), macOS, and Linux unchanged. - [한국어](./ko/v1.6.0.md) · [日本語](./ja/v1.6.0.md) · [简体中文](./zh-CN/v1.6.0.md) · [繁體中文](./zh-TW/v1.6.0.md) · [Español](./es/v1.6.0.md) · [Français](./fr/v1.6.0.md) · [Deutsch](./de/v1.6.0.md) · [Português](./pt-BR/v1.6.0.md) · [Русский](./ru/v1.6.0.md) - [v1.5.1](./v1.5.1.md) — Honest run endings & quieter live output: a relay chain that ends on a failed agent now exits `4` (the desktop run card colors its chip red instead of green), and claude's routine `rate_limit_event` telemetry is suppressed from the live card. No new commands. - [한국어](./ko/v1.5.1.md) · [日本語](./ja/v1.5.1.md) · [简体中文](./zh-CN/v1.5.1.md) · [繁體中文](./zh-TW/v1.5.1.md) · [Español](./es/v1.5.1.md) · [Français](./fr/v1.5.1.md) · [Deutsch](./de/v1.5.1.md) · [Português](./pt-BR/v1.5.1.md) · [Русский](./ru/v1.5.1.md) - [v1.5.0](./v1.5.0.md) — Run agents from the desktop app, confirmation-first: `/run ` + a "Run here" button on the /plan /execute /handoff confirm modals; output streams into a live timeline card (--pretty) with cancel and a done/exit chip; scoped shell spawn/kill capabilities. The GUI stays business-logic-free. - [한국어](./ko/v1.5.0.md) · [日本語](./ja/v1.5.0.md) · [简体中文](./zh-CN/v1.5.0.md) · [繁體中文](./zh-TW/v1.5.0.md) · [Español](./es/v1.5.0.md) · [Français](./fr/v1.5.0.md) · [Deutsch](./de/v1.5.0.md) · [Português](./pt-BR/v1.5.0.md) · [Русский](./ru/v1.5.0.md) - [v1.4.1](./v1.4.1.md) — Desktop timeline polish: result cards survive timeline reloads (kept in memory, merged back by timestamp, cleared on project switch) and rows are role-coded (blue user border + lighter background, amber relay-baton, agent colors for claude/codex, mono commands). No CLI changes. - [한국어](./ko/v1.4.1.md) · [日本語](./ja/v1.4.1.md) · [简体中文](./zh-CN/v1.4.1.md) · [繁體中文](./zh-TW/v1.4.1.md) · [Español](./es/v1.4.1.md) · [Français](./fr/v1.4.1.md) · [Deutsch](./de/v1.4.1.md) · [Português](./pt-BR/v1.4.1.md) · [Русский](./ru/v1.4.1.md) - [v1.4.0](./v1.4.0.md) — Friendly agent stream & desktop result cards: opt-in `--pretty` on `run`/`plan`/`execute`/`handoff` renders the agent CLI's structured JSONL stream (claude stream-json / codex `--json`) as readable lines with a token/cost receipt; Agent Room slash-command results become structured cards (chips, budget gauge, git file rows, plan checklists) with a collapsed raw-json fallback. - [한국어](./ko/v1.4.0.md) · [日本語](./ja/v1.4.0.md) · [简体中文](./zh-CN/v1.4.0.md) · [繁體中文](./zh-TW/v1.4.0.md) · [Español](./es/v1.4.0.md) · [Français](./fr/v1.4.0.md) · [Deutsch](./de/v1.4.0.md) · [Português](./pt-BR/v1.4.0.md) · [Русский](./ru/v1.4.0.md) - [v1.3.1](./v1.3.1.md) — Desktop hotfix: unsigned desktop builds (MSI/DMG/AppImage) panicked at startup because the updater plugin was registered without its config; now registered only when configured. No CLI changes. - [한국어](./ko/v1.3.1.md) · [日本語](./ja/v1.3.1.md) · [简体中文](./zh-CN/v1.3.1.md) · [繁體中文](./zh-TW/v1.3.1.md) · [Español](./es/v1.3.1.md) · [Français](./fr/v1.3.1.md) · [Deutsch](./de/v1.3.1.md) · [Português](./pt-BR/v1.3.1.md) · [Русский](./ru/v1.3.1.md) - [v1.3.0](./v1.3.0.md) — Route preview & polish: new read-only `route` command (advisory chain preview + matched strengths), friendly `ui` output extended to `doctor`/`init`/`status`/`login`/`handoff` (NO_COLOR/non-TTY respected), `doctor` surfaces `handoffTriggers` state, v1.2.0 features fully documented, record-ready demo scenario (`scripts/demo/`). - [한국어](./ko/v1.3.0.md) · [日本語](./ja/v1.3.0.md) · [简体中文](./zh-CN/v1.3.0.md) · [繁體中文](./zh-TW/v1.3.0.md) · [Español](./es/v1.3.0.md) · [Français](./fr/v1.3.0.md) · [Deutsch](./de/v1.3.0.md) · [Português](./pt-BR/v1.3.0.md) · [Русский](./ru/v1.3.0.md) - [v1.2.0](./v1.2.0.md) — Smarter relay & friendly UI (first post-GA feature release; v1.1.x tag names were used by the pre-GA line): opt-in `handoffTriggers` thresholds + `run --handoff-now` manual trigger (confirmation-first), advisory routing hints from registry `strengths` tags, friendly CLI output (✓/✗/hints, non-TTY confirm fix), warm desktop restyle. - [한국어](./ko/v1.2.0.md) · [日本語](./ja/v1.2.0.md) · [简体中文](./zh-CN/v1.2.0.md) · [繁體中文](./zh-TW/v1.2.0.md) · [Español](./es/v1.2.0.md) · [Français](./fr/v1.2.0.md) · [Deutsch](./de/v1.2.0.md) · [Português](./pt-BR/v1.2.0.md) · [Русский](./ru/v1.2.0.md) - [v1.0.0 (GA)](./v1.0.0-ga.md) — First public release: MIT license, npm `@relay-baton/cli` + libs, Homebrew/Scoop/Winget, GA versioning, one-tag release fan-out. (The older [`v1.0.0.md`](./v1.0.0.md) is the pre-GA "Stable Local Release" milestone, kept for history.) - [한국어](./ko/v1.0.0-ga.md) · [日本語](./ja/v1.0.0-ga.md) · [简体中文](./zh-CN/v1.0.0-ga.md) · [繁體中文](./zh-TW/v1.0.0-ga.md) · [Español](./es/v1.0.0-ga.md) · [Français](./fr/v1.0.0-ga.md) · [Deutsch](./de/v1.0.0-ga.md) · [Português](./pt-BR/v1.0.0-ga.md) · [Русский](./ru/v1.0.0-ga.md) - [v2.6.0-alpha.0](./v2.6.0-alpha.0.md) / [한국어](./ko/v2.6.0-alpha.0.md) - Multi-session workspace: named work items (`session new|switch|items`, `WorkspaceManager`, legacy flat = `default`, zero migration), per-agent assignment (`session assign`, `run` honors it), and safe parallelism via git worktrees (`session worktree add`, `run` executes in the isolated checkout). - [v2.5.0-alpha.0](./v2.5.0-alpha.0.md) / [한국어](./ko/v2.5.0-alpha.0.md) - Guarded automation & extensibility: bounded auto-orchestration (`run --until `, confirmation-first, `BoundedOrchestrator` = LoopController + GuardrailPolicy) and project recipes/hooks (`hooks.preHandoff`/`postExecute` via `HookRunner`, local-only). Never an unattended daemon. - [v2.4.0-alpha.0](./v2.4.0-alpha.0.md) / [한국어](./ko/v2.4.0-alpha.0.md) - Smarter handoff: deterministic compaction v2 (symbol/heading-aware repo map via `SymbolOutline` + relevance-ranked diff `compactRanked`) and local usage insight (`UsageLedger` + `relay-baton usage`, token proxy, never transmitted). No embeddings. - [v2.3.0-alpha.0](./v2.3.0-alpha.0.md) / [한국어](./ko/v2.3.0-alpha.0.md) - Multi-agent breadth: central agent registry (tier/install/login/fallback), OpenCode/Gemini/Aider promoted to supported + Cursor CLI added, registry-driven `login`/`doctor`, and N-way + reverse relay (`run --chain`/`--primary`/`--fallback`). - [v2.2.0-alpha.0](./v2.2.0-alpha.0.md) / [한국어](./ko/v2.2.0-alpha.0.md) - Trust & supply chain: untrusted-bundle/path-traversal safety (`resolveWithin` guard + size cap + `trust:` flag), SLSA build provenance by default (`attest-build-provenance`), and supply-chain hardening (SHA-pinned actions, Dependabot, SBOM diff). - [v2.1.0-alpha.2](./v2.1.0-alpha.2.md) / [한국어](./ko/v2.1.0-alpha.2.md) - Secret-leak regression scan + `--allow-api-key-env` audit (names only); v2.1 reliability & secret-safety line complete. - [v2.1.0-alpha.1](./v2.1.0-alpha.1.md) / [한국어](./ko/v2.1.0-alpha.1.md) - Redact before handoff: a Redaction Gate blocks launching the next agent on high-severity secret findings in the generated handoff (unless `--force`). - [v2.1.0-alpha.0](./v2.1.0-alpha.0.md) / [한국어](./ko/v2.1.0-alpha.0.md) - Windows-safe agent spawn: `safeSpawn` (cross-spawn) resolves npm-global `.cmd` shims and escapes arguments, fixing `doctor`/`run`/`login` on Windows. - [v2.0.0-alpha.6](./v2.0.0-alpha.6.md) / [한국어](./ko/v2.0.0-alpha.6.md) - Conversation-event schema versioning + `session export`; v2.0 feature-complete and a "Beyond v2.0" roadmap (additions + hardening). - [v2.0.0-alpha.5](./v2.0.0-alpha.5.md) / [한국어](./ko/v2.0.0-alpha.5.md) - Session archive prune policy (`session prune`, disabled by default, dry-run unless `--apply`) + a CI release-creation race fix. - [v2.0.0-alpha.4](./v2.0.0-alpha.4.md) / [한국어](./ko/v2.0.0-alpha.4.md) - git-baseline.json brought under the versioned schema contract (registry + migrate/doctor coverage + legacy normalization). No version bump. - [v2.0.0-alpha.3](./v2.0.0-alpha.3.md) / [한국어](./ko/v2.0.0-alpha.3.md) - Installer/update finalized + public docs pass: a locked distribution policy in RELEASE.md and a consolidated `docs/GUIDE.md` (EN+KO) for install, workflows, and safety. - [v2.0.0-alpha.2](./v2.0.0-alpha.2.md) / [한국어](./ko/v2.0.0-alpha.2.md) - Stability guards: desktop i18n parity test (en/ko/ja/zh) enforcing the stable desktop contract, and a hard-constraints test locking the auth policy + no-LLM-client rule. - [v2.0.0-alpha.1](./v2.0.0-alpha.1.md) / [한국어](./ko/v2.0.0-alpha.1.md) - Schema migrator apply path: `relay-baton migrate --apply [--dry-run]` normalizes legacy artifacts (stamps schemaVersion) with timestamped backups, opt-in and idempotent. - [v2.0.0-alpha.0](./v2.0.0-alpha.0.md) / [한국어](./ko/v2.0.0-alpha.0.md) - v2.0 stability line opens: read-only artifact schema migration checks (`relay-baton migrate`, `ARTIFACT_SCHEMA_VERSIONS` registry, `doctor --deep` schema lines). Detection + guidance only. - [v1.9.0-alpha.0](./v1.9.0-alpha.0.md) / [한국어](./ko/v1.9.0-alpha.0.md) - Team handoff package: portable `relay-baton handoff bundle` (manifest + SHA-256 + redaction pass), `handoff inspect`, a markdown `report`, and a desktop team-handoff export card + Agent Room `/bundle` `/report`. No cloud upload. - [v1.8.0-alpha.1](./v1.8.0-alpha.1.md) / [한국어](./ko/v1.8.0-alpha.1.md) - Project intelligence complete: `relay-baton profile` (framework tags + recommended commands), `inventory` (scripts/packages/CI/release files), and a desktop project-inspector panel + Agent Room `/workspace` `/profile` `/inventory`. - [v1.8.0-alpha.0](./v1.8.0-alpha.0.md) / [한국어](./ko/v1.8.0-alpha.0.md) - Project intelligence start: deterministic, bounded `relay-baton workspace` map (package managers, languages, monorepo packages, scripts, entry points, docs, AGENTS/CLAUDE files). No semantic indexing. - [v1.7.0-alpha.0](./v1.7.0-alpha.0.md) / [한국어](./ko/v1.7.0-alpha.0.md) - Guarded execution workflow: deterministic read-only `checkpoint add`/`list`/`summary`, `guard` stop-condition policy, `risk` classifier, and a desktop guarded-execution panel + Agent Room `/checkpoints` `/guard` `/risk`. - [v1.6.0-alpha.0](./v1.6.0-alpha.0.md) / [한국어](./ko/v1.6.0-alpha.0.md) - Session archives, recovery, and desktop browsing: read-only `relay-baton session list`/`inspect`/`resume` (manifest + SHA-256 integrity, stale/incomplete diagnosis), plus a desktop session-archive panel and Agent Room `/sessions` `/inspect` `/resume`. - [v1.5.0-alpha.1](./v1.5.0-alpha.1.md) / [한국어](./ko/v1.5.0-alpha.1.md) - Distribution cleanup: opt-in/manual desktop updater wiring, signed updater artifact/latest.json release support, v1.4 deferred-item closure, and v1.6-to-v2.0 roadmap. - [v1.5.0-alpha.0](./v1.5.0-alpha.0.md) / [한국어](./ko/v1.5.0-alpha.0.md) - Git tracking first cut: read-only `relay-baton git status --json`, non-git project fallback, desktop Git panel, and `/git` in Agent Room. - [v1.4.0-alpha.1](./v1.4.0-alpha.1.md) / [한국어](./ko/v1.4.0-alpha.1.md) - Distribution polish: one-line installers with SHA-256 verification, release SHA256SUMS/SBOM metadata, package-manager starter files, optional signing hooks, and a desktop Codex/Claude preview switcher. - [v1.3.0-alpha.1](./v1.3.0-alpha.1.md) / [한국어](./ko/v1.3.0-alpha.1.md) - Desktop Agent Room UX revamp: tabbed dashboard/room layout, full-height chat timeline, handoff modal, slash-command palette with descriptions, hover tooltips, and an expanded `?` usage guide. Localized en/ko/ja/zh. - [v1.3.0-alpha.0](./v1.3.0-alpha.0.md) / [한국어](./ko/v1.3.0-alpha.0.md) - Desktop conversation and project-scoped sessions: Agent Room composer, `conversation append` JSON surface, persisted messages/command echoes, and preview-only agent actions. - [v1.2.0-alpha.3](./v1.2.0-alpha.3.md) / [한국어](./ko/v1.2.0-alpha.3.md) - Desktop project management and i18n: add projects via folder picker, remove with confirmation, CLI JSON contract for add/remove, and English/Korean/Japanese/Simplified Chinese UI chrome. - [v1.2.0-alpha.2](./v1.2.0-alpha.2.md) / [한국어](./ko/v1.2.0-alpha.2.md) - Desktop sidecar fix: webview now loads Tauri APIs via `withGlobalTauri`/`window.__TAURI__` (bare ES imports don't resolve in the no-bundler frontend), so the GUI panels actually talk to the bundled CLI. - [v1.2.0-alpha.1](./v1.2.0-alpha.1.md) / [한국어](./ko/v1.2.0-alpha.1.md) - Desktop prerelease completed: Windows `.msi` build fix (plain semver app version) so all 6 assets ship, plus Phase D (signing docs, window-state persistence, light/dark theme, TUI-mirrored keyboard shortcuts). - [v1.2.0-alpha.0](./v1.2.0-alpha.0.md) / [한국어](./ko/v1.2.0-alpha.0.md) - Desktop GUI prerelease (Phase A+B): `build-desktop` release job attaching `.dmg`/`.msi`/`.AppImage`, deterministic icon generation, sidecar staging script, read-only desktop dashboard, and CLI JSON surface (`project list/current --json`, `handoff show`). Unsigned/ad-hoc installers; GUI is read-only. - [v1.1.3](./v1.1.3.md) / [한국어](./ko/v1.1.3.md) - Release pipeline hotfix #3: pinned exact bundler versions (`esbuild@0.28.0`, `postject@1.0.0-alpha.6`) — `postject@^1` resolved to nothing because its "latest" is a prerelease. No behavior changes. - [v1.1.2](./v1.1.2.md) / [한국어](./ko/v1.1.2.md) - Release pipeline hotfix #2: `npx --yes esbuild/postject` failed with exit 127 on CI runners, so the workflow now installs them with `npm install -g` and calls them directly (recipe verified locally end-to-end). No behavior changes. - [v1.1.1](./v1.1.1.md) / [한국어](./ko/v1.1.1.md) - Release pipeline hotfix: fixed `release.yml` line 115 (a leading `&` in the Windows smoke-test step made the workflow invalid YAML, so no job ran for v1.1.0 and no binaries were attached). New tag re-runs the corrected pipeline. No behavior changes. - [v1.1.0](./v1.1.0.md) / [한국어](./ko/v1.1.0.md) - Distributable: standalone single-file executables per OS (Node SEA), automated GitHub Release pipeline (`.github/workflows/release.yml`), README download links, and a Tauri desktop shell scaffold (`desktop/`, CLI sidecar). No new model behavior; all hard constraints intact. - [v1.0.0](./v1.0.0.md) / [한국어](./ko/v1.0.0.md) - Stable Local Release: frozen config/session contracts (`CONFIG_VERSION`/`SESSION_SCHEMA_VERSION`, `validateConfig`/`validateSessionMeta`), `.ai-session/` artifact validation (`validateArtifacts` + `doctor --deep`), full command reference (`docs/COMMANDS.md` EN+KO), finalized Agent Room set with read-only `/diagnose`. - [v0.9.0](./v0.9.0.md) / [한국어](./ko/v0.9.0.md) - Automation & Runtime (bounded): `LoopController`, room `/continue --max-steps N` / `/replan` / `/replay`, `relay-baton replay`, adaptive per-agent compression thresholds. - [v0.8.0](./v0.8.0.md) / [한국어](./ko/v0.8.0.md) - Adapter Expansion + Agent Room (first cut): OpenCode/Gemini/Aider adapter scaffolds, project-level fallback overrides, OS CI matrix, `relay-baton chat`/`room` (turn-based, confirmation-first REPL). - [v0.7.0](./v0.7.0.md) / [한국어](./ko/v0.7.0.md) - Review & Diagnose: `relay-baton review` (deterministic diff-vs-plan), execution receipts, plan diffing, `--json` for status/budget/review, conversation event schema (draft). - [v0.6.0](./v0.6.0.md) / [한국어](./ko/v0.6.0.md) - Trust & Verify: `relay-baton verify` (simulated end-to-end check, no real model calls), `doctor --deep` extended diagnostics, TUI mode panel, and `docs/ROADMAP.md`. - [v0.5.0](./v0.5.0.md) / [한국어](./ko/v0.5.0.md) - Plan-execute mode (`plan` / `execute`, planner→executor, PlanQualityGate) + context compression mode (`compress-context`, deterministic mid-session compaction with a rollback gate). 124 tests. - [v0.4.0](./v0.4.0.md) / [한국어](./ko/v0.4.0.md) - GitHub Actions CI, critical-path test coverage (99 tests), CLI smoke test, session observability (`startedAt`/`endedAt`/`durationMs`/`handoffCount`), and `relay-baton handoff history`. - [v0.3.0](./v0.3.0.md) / [한국어](./ko/v0.3.0.md) - Side-effect-free resolver, registry recovery, `RELAY_BATON_PROJECTS_FILE` override, fallback `lastError` cleanup. - [v0.2.0](./v0.2.0.md) / [한국어](./ko/v0.2.0.md) - Project registry, project-aware commands, improved TUI dashboard, and release documentation. - [v0.1.0](./v0.1.0.md) / [한국어](./ko/v0.1.0.md) - Initial MVP with Codex/Claude handoff, token diet, fallback detection, session files, quality gates, and auth-safe subprocess execution.