# relay-baton v1.0.0 Release Notes

> **Note:** this documents the pre-GA "Stable Local Release" milestone (2026-05).
> The `v1.0.0` git tag was later moved to the public **GA** release — see
> [`v1.0.0-ga.md`](./v1.0.0-ga.md) and [`CHANGELOG.md`](../CHANGELOG.md).

Status: **Released**

Date: 2026-05

Theme: **Stable Local Release** — freeze the persisted contracts, guarantee the
`.ai-session/` artifacts, document every command, and stabilize the Agent Room
workflow. No new model behavior, no new external surface — just the durability
and documentation that make 1.0 safe to depend on.

## Summary

v1.0 makes relay-baton's on-disk surface a stable contract. The config and
session-metadata shapes are now versioned (`CONFIG_VERSION`,
`SESSION_SCHEMA_VERSION`) and validated. A new deterministic, read-only
`validateArtifacts` checks the shape of everything under `.ai-session/`, wired
into `doctor --deep`. The full CLI is documented in `docs/COMMANDS.md` (EN + KO),
and the Agent Room command set is finalized with a new read-only `/diagnose`.
Everything stays subprocess-only, confirmation-first, and free of auto
commit/push/PR.

## Added

- **Frozen contracts** — `CONFIG_VERSION = 1` and `SESSION_SCHEMA_VERSION = 1`
  in `@relay-baton/shared`. `validateConfig` / `validateSessionMeta` (with
  `normalizeConfig` / `normalizeSessionMeta`) verify and stamp the current
  version onto legacy payloads. Loaders normalize on read.

- **Artifact stability** — `validateArtifacts(repoRoot)` (core) performs a
  deterministic, read-only shape check of `.ai-session/`: `session.json`
  (parses + satisfies the `SessionMeta` contract), `context-budget.json` (valid
  JSON; empty → warning), `conversation.jsonl` (every non-empty line valid
  JSON). Markdown artifacts are existence-checked only. Documented in
  `docs/ARTIFACTS.md`.

- **`doctor --deep` contract checks** — now reports the config contract
  (`validateConfig`) and per-artifact shape results alongside the existing
  tooling/registry/plan/handoff diagnostics.

- **Full command reference** — `docs/COMMANDS.md` (+ `docs/i18n/COMMANDS.ko.md`)
  documenting every top-level command, its options, and the global project /
  diet / auth conventions. Linked from the README.

- **Room `/diagnose`** — a read-only room command that runs `doctor --deep`
  (config + artifact validation), no model call, no confirmation. The Agent Room
  command set is now finalized: `/plan`, `/replan`, `/execute`, `/continue`,
  `/review`, `/diagnose`, `/handoff`, `/budget`, `/status`, `/replay`,
  `/help`, `/exit`.

## Changed

- CLI version bumped to `1.0.0` (all workspace packages).
- `relay-baton.config.json` now carries `configVersion`; `session.json` now
  carries `schemaVersion`. Both are stamped automatically; older files are
  normalized up on read.
- `docs/AGENT_ROOM.md` updated with the finalized command table and v1.0 status.

## Tests

- `ContractSchema.test.ts` — config + session-meta validation and version
  normalization.
- `ArtifactValidator.test.ts` — well-formed session passes; unparseable / contract-
  violating `session.json` fails; empty budget warns; malformed
  `conversation.jsonl` fails; absent artifacts/dir stay ok.
- `RoomEngine.test.ts` — `/diagnose` is read-only (no confirmation).
- `docs.test.ts` — `docs/ARTIFACTS.md`, the EN+KO command reference, and the
  stabilized room command set are present.

## Not included (still deferred / out of scope)

- Demo gif / screenshots and a documented real-agent end-to-end path — cannot be
  produced deterministically; deferred.
- Non-interactive `run --until` orchestration, daemon / long-running prototype.
- Semantic summarization, exact tokenizers, auto commit/push/PR — permanently
  out of scope.

## Upgrade notes

- Fully additive and backward-compatible. No manual migration: existing
  `relay-baton.config.json` and `.ai-session/session.json` are normalized up to
  the current schema version on read. The new validators are read-only.

## Verification commands

```bash
pnpm build
pnpm test
relay-baton doctor --deep   # config contract + artifact shapes
relay-baton chat            # /help, then /diagnose (read-only), /exit
relay-baton verify
```