> ## Documentation Index
> Fetch the complete documentation index at: https://ade-ac1c6011-dependabot-github-actions-actions-cache-6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# v1.1.2

> Release notes for ADE v1.1.2 — April 22, 2026

v1.1.2 is a stability release focused on chat continuity. Chats no longer lose their history (or freeze) when you switch projects, close a tab, or come back hours later. It also folds in the iOS polish and App Store review prep that were originally planned for v1.1.1 — privacy page, Tailscale routing cleanup, iOS Work timeline stability, and a large pass on orphan-lane sessions.

***

## Chat continuity

The biggest change: the desktop renderer had no snapshot-on-resubscribe path. Switching projects (or tabbing away from Work) would drop IPC events while you were gone, and on return the pane only got the transcript tail — long chats lost earlier history, and a transient read error could leave the pane frozen with no retry.

* **In-memory per-session event ring buffer.** `agentChatService` now records every emitted envelope into a 2,000-event-per-session buffer alongside the on-disk transcript. A new `getChatEventHistory` IPC method merges the buffer with the disk transcript on first read so a late subscriber always sees the full history.
* **Freeze recovery on error.** `AgentChatPane` now clears its load-gate in the catch path when a history read fails, so a transient miss no longer traps the UI in an empty state. The Work-tab single-session tile also force-reloads on mount, matching the behavior the other chat surfaces already had.
* **Cross-run-safe dedup.** Sequence numbers restart at 0 every time a session rebuilds, so the disk-buffer merge dedupes on timestamp + event type + payload content instead — true duplicates still collapse, but streaming text fragments that land in the same millisecond stay distinct.
* **Path validation.** `getChatEventHistory` validates the session id is a registered chat session before opening any transcript file, since the endpoint is reachable over IPC.

On the Claude side:

* **Resume state survives non-terminal teardowns.** When the runtime is torn down for `idle_ttl`, `budget_eviction`, `pool_compaction`, `paused_run`, `project_close`, or `shutdown`, the V2 `sdkSessionId` and lane directive are now preserved to disk so the next turn re-attaches to the same SDK session instead of cold-starting.
* **Terminal teardowns still invalidate.** `handle_close`, `ended_session`, and `model_switch` keep the old behavior even when the runtime is already null — closing a chat invalidates its resume state so a future resume can't accidentally reattach.

The iOS side had already landed the equivalent work in the sync service (`mergeChatEventHistory`, `deduplicatedChatEventHistory`, 2 MB snapshot request, 1,000-event retention); this release brings the desktop to parity and then tightens both sides further:

* Raised iOS chat history window to 2 MB and up to 1,000 envelopes per session.
* `mergeChatEventHistory` merges truncated snapshots with existing events instead of replacing.
* Fallback to `messageId` when Claude assistant-text events are missing a non-empty `itemId`, so live-path and transcript-replay render the same number of bubbles.
* `deduplicatedChatEventHistory` now parses ISO-8601 timestamps with a fractional-seconds formatter + fallback before comparing, so mixed-precision snapshots sort chronologically instead of lexicographically.
* `recordChatEventEnvelope` falls back to the full sort path when a delayed envelope predates the last-recorded one, healing out-of-order live arrivals after a snapshot merge.

***

## Orphan lanes

Sessions whose lane isn't in the current UI lane list (archived lanes, lanes hidden by filter) now render as their own collapsible groups instead of disappearing.

* **Desktop `SessionListPane`** renders orphan-lane groups sorted by latest `startedAt`, with a `Number.isFinite` guard so malformed timestamps don't trigger `NaN` comparator ordering.
* **iOS `workSessionGroupsByLane`** mirrors the same shape: per-lane groups for orphaned sessions, sorted newest-first with alphabetical name tiebreak, trimmed-`laneName` → `laneId` fallback for empty labels, and an ISO-8601 parser that handles both fractional and non-fractional variants.
* Orphan labels use the session's preserved `laneName` when present so users still recognize which branch each belongs to.

***

## Sync and discovery

* **Unified tailnet discovery.** `SyncTailnetDiscovery` host and port candidates are consolidated. Tailnet-address detection is centralized in `syncIsTailscaleRoute`, covering MagicDNS hostnames, `ts.net` suffixes, and `100.64/10` IPv4 literals. Port `8788` is preserved as a fallback since the desktop retries there when `8787` is busy.
* **IPv6 route normalization.** `syncNormalizedRouteHost` only strips a trailing `:port` when there's exactly one colon, so unbracketed IPv6 literals (`::1`, `fc00::1`) survive normalization instead of being truncated before the allowlist check.
* **Shared desktop device ID.** `deviceRegistryService` now accepts an optional `localDeviceIdPath` so the device identity can live under `userData` instead of per-project secrets. The shared file is authoritative across projects: on first use we migrate whichever legacy per-project id we encounter (or mint a fresh UUID), and every project context afterwards returns that same identity. `O_EXCL` on the seed write prevents two concurrent contexts from racing to mint different ids.
* **Runtime discovery toggle.** `syncHostService` exposes `setDiscoveryEnabled()` to gate LAN/Tailnet advertisement at runtime, with `unpublishLanDiscovery` called on dispose so stale entries don't linger.

***

## iOS polish

* **App Store review prep.** The placeholder privacy page is replaced with an Apple-grade policy (effective date, data categories, third parties, retention, contact). `vercel.json` gained an SPA catch-all so `/privacy` and `/download` stop 404'ing — both required for external TestFlight review.
* **App icon.** Full-bleed opaque export of the centered ADE artwork so the mark matches the macOS logo and satisfies App Store upload checks.
* **Launch and root polish.** Tighter top-of-screen rhythm on the five root tabs (Work, Lanes, PRs, Files, CTO). The connection header chip meets the 44 pt hit-target minimum, and the connection-dot hover around the gear icon is consistent across tabs.

***

## Work transcript stability

* **Shared itemId resolution policy.** `WorkTranscriptParser` and `WorkEventMapping` now share a single `workStableTimelineItemId` helper (with an optional-`itemId` overload for the raw-dict transcript path). File-change events deliberately keep the raw `itemId` rather than collapsing to `logicalItemId` — OpenCode's patch emitter produces one event per file with a shared logical ID, and collapsing was dropping all but the last file.
* **Streaming-aware tool groups.** Tool cards that are still streaming inside a group auto-expand (`localExpanded || running`), so mid-stream progress doesn't disappear into the collapsed group hint.
* **Assistant-text grouping.** `buildWorkChatMessages` tracks whether the previous envelope was assistant text, so nil-`itemId` streaming fragments merge into it without being pulled across intervening tool calls or user messages.

***

## Other

* `workSessionGroupsByLane` on iOS: orphan-lane ordering tests now use distinct `startedAt` timestamps so the "latest first" sort is actually exercised.
* `SessionListPane` on desktop: blank `laneName` now trim-falls-back to `laneId` so orphan-group headers never render empty.
* `syncService.test.ts`: retry-test host mock stubs `setDiscoveryEnabled`.
* `browserMock.getEventHistory` echoes the requested session id.
* `registerIpc`: the new `agentChatGetEventHistory` handler coerces `maxEvents` to finite positive integers.
* Internal docs updated for the new chat lifecycle, iOS companion sync story, and terminals UI surfaces.