Skip to content

Open source Grok Bot alternative, Bring your own agent and subscription: message Claude Code, Codex, Gemini CLI, Cursor, Copilot and 40+ AI agents as bots on your own computer, from iPhone, Mac, Windows, Linux or terminal. Agent-agnostic and free. Also a Muse and Dots alternative. Built in Rust.

docs: record the PostHog error triage and tidy the docs folders

leepokai297ca161c707
diff --git a/README.md b/README.md
index 4578a1ba..5ab5991d 100644
--- a/README.md
+++ b/README.md
@@ -74,7 +74,7 @@ The host (`codync-host`, Rust) runs on macOS, Windows and Linux; every client ta
**Looking for the former native Mac app (SwiftUI + AppKit)?** Version 2.7.0 moved Mac and
Linux to one Electron desktop app. The native implementation is preserved in Git history;
see the [changelog and source lookup commands](#changelog) and the
-[archived AppKit chat implementation notes](docs/archive/macos-chat-swiftui.md).
+[archived AppKit chat implementation notes](docs/archive/macos-chat-swiftui-2026-10-05.md).
## How it works
@@ -231,7 +231,7 @@ Details: [desktop app](docs/architecture/desktop-app.md).
**Native Mac source (SwiftUI + AppKit).** The last native revision is `1055636`, the parent
of migration commit `41135ac`. It includes `apps/macos/` and the Mac code paths in `kit/`.
The chat used `MacChatList`, an AppKit `NSScrollView` hosting SwiftUI message rows;
-see the [archived implementation notes](docs/archive/macos-chat-swiftui.md).
+see the [archived implementation notes](docs/archive/macos-chat-swiftui-2026-10-05.md).
```bash
git show 1055636:apps/macos/Views/ChatWindow.swift
diff --git a/docs/README.md b/docs/README.md
index 5530f10b..ed1c3623 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,6 +1,6 @@
# Codync documentation
-Current documentation describes the checked-out implementation. Last reviewed: **2026-09-26**.
+Current documentation describes the checked-out implementation. Index last checked against the tree: **2026-10-19**.
Source review, a passing build, local integration tests and production acceptance are different checks; a feature documented here is not a claim that its deployed service has been verified.
## Start here
@@ -8,53 +8,74 @@ Source review, a passing build, local integration tests and production acceptanc
| Task | Read |
|---|---|
| Find a module or decide where a file belongs | [File structure](architecture/file-structure.md) |
-| Understand clients, host, cloud and data ownership | [Architecture](architecture/overview.md) |
-| Work on the macOS, Linux and Windows desktop app (Electron) | [Desktop app](architecture/desktop-app.md) |
-| Build, install, restart and run checks | [Development](guides/development.md) |
-| Upgrade Sean's local app and private infrastructure | [Local upgrade guide](guides/local-upgrades.md) |
+| Understand clients, host, cloud and data ownership | [Architecture](architecture/overview.md), [conversation runtime](architecture/conversation-runtime.md) |
+| Work on the macOS, Linux and Windows desktop app (Electron) | [Desktop app](architecture/desktop-app.md), [desktop styles](guides/desktop-styles.md) |
+| Build, install, restart and run checks | [Development](guides/development.md), [Codync Dev beside production](guides/dev-app.md) |
+| Write or refactor code in any module | [Clean code](guides/clean-code.md) |
+| Change an iPhone or desktop screen or button | [UI conventions](design/ui-conventions.md) |
+| Change the composer | [Composer behavior and checks](guides/composer.md) |
+| Ship app and host updates | [Updates](guides/updates.md), [client and host compatibility](reference/compatibility.md) |
| Plan and build Android | [Android plan](plans/android-app.md), [Android status](../apps/android/README.md) |
| Test a phone over Cloudflare instead of LAN | [Cloudflare testing](guides/cloudflare-testing.md) |
| Configure dev/main or deploy the services | [Environments and deployment](guides/environments-and-deployment.md) |
| Run the host on a Linux server or cloud VM | [Linux servers](guides/linux-servers.md) |
| Reproduce or check something on Windows (UTM VM) | [Windows testing](guides/windows-testing.md) |
| Set up accounts, approvals or desktop SSH | [Accounts and SSH](guides/accounts-and-ssh.md) |
+| Check connectors against live services | [Connector verification](guides/connector-verification.md) |
| Change transport or cryptography | [Remote protocol](reference/remote-relay.md) and [shared vectors](reference/fixtures/README.md) |
-| Change what the host and clients exchange | [Client and host compatibility](reference/compatibility.md) |
-| Change an iPhone or desktop screen or button | [UI conventions](design/ui-conventions.md) |
-| Write or refactor code in any module | [Clean code](guides/clean-code.md) |
+| Look into errors or failed turns users hit | [Usage analytics](features/analytics.md), [investigations](#investigations) |
## Features
+- [Chat messages](features/chat-messages.md)
- [Group chats and reply threads](features/groups-and-threads.md)
- [Bot-to-bot collaboration](features/bot-collaboration.md)
- [Context and memory](features/context-and-memory.md)
- [Bot memory and compaction](design/bot-memory.md) (design; storage, gate and dreaming built, compaction to come)
-- [Harness memory](plans/harness-memory.md) (the switch that keeps a harness's own memory on; a choice of it instead of Codync's, planned)
- [Bot memory research](design/bot-memory-research.md) (files vs. database, embeddings, open-source systems, harness instructions)
- [Bot workspaces](features/bot-workspaces.md)
+- [Routines](features/routines.md)
- [Voice calls](features/voice-call.md)
- [File attachments](features/file-attachments.md)
-- [Remote screen](features/remote-screen.md)
+- [Remote screen](features/remote-screen.md) and [computer use](features/computer-use.md)
+- [Computer identity and list ordering](features/computer-order.md)
- [Notch island (desktop)](features/notch-island.md)
- [Extensions and agent setup](features/marketplace.md)
- [Connector setup and credentials](features/connector-credentials.md)
-- [Routines](features/routines.md)
+- [Usage analytics and error tracking](features/analytics.md)
- [Widgets, Live Activities and onboarding](design/mobile-widgets.md)
- [Notifications and background Live Activity updates](design/push-and-live-activity.md)
+## Plans
+
+- [Android parity and acceptance](plans/android-app.md)
+- [Harness memory](plans/harness-memory.md) (the switch that keeps a harness's own memory on; a choice of it instead of Codync's, planned)
+- [Error tracking detail](plans/error-tracking-detail.md) (proposal: symbolicated iPhone crashes, sessions, consented problem reports)
+
+## Investigations
+
+Production signals (PostHog errors, failed turns) traced to a root cause, newest first. Dated
+records: the fixes they name have shipped or are listed as open.
+
+- [PostHog error triage, 2026-10-19](investigations/posthog-errors-2026-10-19.md): host panics, desktop and iPhone crashes, failed Claude turns
+- [npm agents failing to start on Windows, 2026-10-14](investigations/windows-npm-agents-2026-10-14.md)
+
## Documentation layout
```text
docs/
├── README.md # Navigation and maintenance rules
├── architecture/ # Current boundaries, data flow and file ownership
+├── features/ # Current behavior and implementation entry points
+├── design/ # UI rules, system integration and design write-ups for larger features
+│ └── reference/ # Reference screenshots the designs follow
├── guides/ # Build, configuration, testing and deployment steps
├── reference/ # Wire contracts and shared executable fixtures
│ └── fixtures/
-├── features/ # Current behavior and implementation entry points
-├── design/ # UI rules, rendering and system integration
├── plans/ # Work planned or in progress, not released yet
-└── archive/ # Dated plans/audits; never current instructions
+├── investigations/ # Dated root-cause records of production errors
+├── archive/ # Dated plans/audits; never current instructions
+└── screenshots/ # Images the repository README shows
```
Service-local entry points remain in [cloud/README.md](../cloud/README.md) and [relay/README.md](../relay/README.md). Repository-wide development rules remain in [AGENTS.md](../AGENTS.md) and [CLAUDE.md](../CLAUDE.md).
diff --git a/docs/architecture/file-structure.md b/docs/architecture/file-structure.md
index 797c97a4..9c963a98 100644
--- a/docs/architecture/file-structure.md
+++ b/docs/architecture/file-structure.md
@@ -61,7 +61,7 @@ Codync/
│ └── test/ # workerd tests; e2e/ runs against a real test host
├── relay/ # Separate APNs push Worker; src/ and test/
├── discord/ # Discord GitHub-role Worker (discord.codync.dev)
-├── docs/ # Architecture, guides, reference, features, design, archive
+├── docs/ # Architecture, features, design, guides, reference, plans, investigations, archive
├── tools/ # Release, App Store submission and font scripts
├── packaging/ # Distribution templates
├── marketing/app-store-screenshots/ # App Store screenshot editor (bun dev; Export bundle → out/)
diff --git a/docs/archive/README.md b/docs/archive/README.md
index 90323e2a..0e09d03c 100644
--- a/docs/archive/README.md
+++ b/docs/archive/README.md
@@ -7,9 +7,8 @@ These documents retain decisions and observations from before the current refact
| [Cloudflare account/device plan](cloudflare-account-device-plan-2026-09-25.md) | 2026-09-25 | [Architecture](../architecture/overview.md), [protocol](../reference/remote-relay.md), [environments](../guides/environments-and-deployment.md) |
| [Bot/computer/SSH plan](bot-computer-ssh-plan-2026-09-25.md) | 2026-09-25 | [Accounts and SSH](../guides/accounts-and-ssh.md), [file structure](../architecture/file-structure.md) |
| [UI audit](ui-audit-2026-09-25.md) | 2026-09-25 | [UI conventions](../design/ui-conventions.md), [widgets](../design/mobile-widgets.md) |
-| [SwiftUI Mac chat](macos-chat-swiftui.md) | 2026-10-05 | [Desktop app](../architecture/desktop-app.md) |
+| [SwiftUI Mac chat](macos-chat-swiftui-2026-10-05.md) | 2026-10-05 | [Desktop app](../architecture/desktop-app.md) |
Do not interpret old “not implemented” statements, delegation assignments, version numbers or test reports as the state of the current checkout. Reassess an audit finding against source before turning it into work.
- [Widget verification record, 2026-09-26](mobile-widgets-verification-2026-09-26.md): historical observations and remaining system integration checks.
-- [npm agents failing to start on Windows, 2026-10-14](windows-npm-agents-2026-10-14.md): PostHog signal, VM reproduction, root cause and fix (2.16.1).
diff --git a/docs/archive/macos-chat-swiftui.md b/docs/archive/macos-chat-swiftui-2026-10-05.md
similarity index 100%
rename from docs/archive/macos-chat-swiftui.md
rename to docs/archive/macos-chat-swiftui-2026-10-05.md
diff --git a/docs/design/composer-attachments.md b/docs/design/composer-attachments.md
deleted file mode 100644
index ae17ef92..00000000
--- a/docs/design/composer-attachments.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# Composer attachments
-
-iPhone and the desktop app show local image attachments as thumbnails above the text field,
-with a remove button in the upper-right corner. The entire image fits inside the
-preview; its original data remains the attachment sent to the host. On iPhone,
-ImageIO creates display-sized thumbnails off the main actor; the desktop app
-(`views/thread/ComposerAttachment.tsx`) lets the browser decode the image. Invalid image data falls
-back to the filename chip, as do non-image files. Multiple attachments scroll
-horizontally and remain removable individually.
-
-On the iPhone a copied image goes in through **Paste** in the + menu; the
-composer never suggests the clipboard on its own, and focusing it does not read
-or attach clipboard contents. Picking a
-photo or image file uses the same preview. A draft containing only attachments
-shows Send, including when another reply is running (the message is queued).
-
-The TUI retains its filename row and backspace removal: its text renderer does
-not implement terminal image protocols.
-No upload API, message format, or attachment limit changes.
diff --git a/docs/features/analytics.md b/docs/features/analytics.md
index 31134d98..5e0f61bd 100644
--- a/docs/features/analytics.md
+++ b/docs/features/analytics.md
@@ -100,6 +100,9 @@ crash or error in a day* (`$exception` > 0, checked daily) and *Failed agent tur
hour* (`turn_finished` with `outcome = failed`, checked hourly; a normal hour has a few). Error
tracking's own issue alerts (new, reopened, spiking) need a Slack or Discord destination.
+Errors traced to a root cause are written up in [investigations](../README.md#investigations);
+ways to record more detail are proposed in [error tracking detail](../plans/error-tracking-detail.md).
+
## Metrics
Shared filters: `env = 'main'`, internal accounts excluded, UTC days. A *user* is a PostHog
diff --git a/docs/guides/composer.md b/docs/guides/composer.md
index 6da3720f..9f7deff0 100644
--- a/docs/guides/composer.md
+++ b/docs/guides/composer.md
@@ -20,6 +20,25 @@ The Electron composer restores the draft and layout behavior previously fixed in
The terminal uses immediate text layout, with Shift/Alt-Enter (where supported)
or Ctrl+J for a newline; it has no voice button or graphical inspector animation.
+## Attachments
+
+iPhone and the desktop app show local image attachments as thumbnails above the text field,
+with a remove button in the upper-right corner. The entire image fits inside the
+preview; its original data remains the attachment sent to the host. On iPhone,
+ImageIO creates display-sized thumbnails off the main actor; the desktop app
+(`views/thread/ComposerAttachment.tsx`) lets the browser decode the image. Invalid image data falls
+back to the filename chip, as do non-image files. Multiple attachments scroll
+horizontally and remain removable individually.
+
+On the iPhone a copied image goes in through **Paste** in the + menu; the
+composer never suggests the clipboard on its own, and focusing it does not read
+or attach clipboard contents. Picking a photo or image file uses the same preview.
+A draft containing only attachments shows Send, including when another reply is
+running (the message is queued).
+
+The terminal UI keeps its filename row and backspace removal: its text renderer does
+not implement terminal image protocols. Sending and limits: [file attachments](../features/file-attachments.md).
+
## Draft lifetime
Text is saved exactly, including leading/trailing whitespace, blank lines and emoji.
diff --git a/docs/guides/windows-testing.md b/docs/guides/windows-testing.md
index bc29c575..25294321 100644
--- a/docs/guides/windows-testing.md
+++ b/docs/guides/windows-testing.md
@@ -58,4 +58,4 @@ e2e); use the VM for a full e2e, or when a change or a bug depends on Windows it
- `cfg(windows)` code can still be compile-checked on the Mac by copying it into a scratch crate and
running clippy with the pinned toolchain's `--target x86_64-pc-windows-gnu`.
-Investigations done this way: [npm agents failing to start on Windows, 2026-10-14](../archive/windows-npm-agents-2026-10-14.md).
+Investigations done this way: [npm agents failing to start on Windows, 2026-10-14](../investigations/windows-npm-agents-2026-10-14.md).
diff --git a/docs/investigations/posthog-errors-2026-10-19.md b/docs/investigations/posthog-errors-2026-10-19.md
new file mode 100644
index 00000000..62581483
--- /dev/null
+++ b/docs/investigations/posthog-errors-2026-10-19.md
@@ -0,0 +1,58 @@
+# PostHog error triage — 2026-10-19
+
+A pass over production errors and failed agent turns in PostHog (project "Codync App", 649427),
+2026-10-12 to 2026-10-19, `env = main`. Each finding names the evidence, the root cause as far as
+it could be established, the fix and what is still open. Version numbers are the first release
+with the fix. Error tracking itself is described in [usage analytics](../features/analytics.md);
+richer error detail is proposed in [error tracking detail](../plans/error-tracking-detail.md).
+
+## Method
+
+- **Issues**: error tracking issues ranked by users, then by first seen; sample `$exception`
+ events per issue (`query-error-tracking-issue-events` with `onlyAppFrames: false`).
+- **Who**: SQL over `$exception` grouped by issue, `process`, `app_version`, `$os`; persons checked
+ against cohort 618410 (internal and test hosts). Every person below is a real user.
+- **Failed turns**: `turn_finished` with `outcome = failed`, by agent, `error`, `rpc_code`, `source`,
+ and per hour for the heaviest person.
+- **Desktop renderer frames**: the renderer bundle is reproducible. `git archive v2.18.0
+ apps/desktop`, link `node_modules`, `npx electron-vite build`: the same `index-<hash>.js`
+ comes out, so a frame's line and column map to source.
+- **iPhone frames** (`Codync + <offset>`, the offset into the binary's text segment): the dSYM of
+ that version comes from its Xcode Cloud run ([iOS releases](../guides/development.md#ios-releases-xcode-cloud)).
+ With the App Store Connect API: `GET /v1/ciProducts/<iOS product>/buildRuns?sort=-number` (the
+ commit message names the version) → `/v1/ciBuildRuns/<id>/actions` → `/v1/ciBuildActions/<id>/artifacts`;
+ the `ARCHIVE` artifact's `downloadUrl` (`/v1/ciArtifacts/<id>`) is a zipped `.xcarchive` with
+ `dSYMs/Codync.app.dSYM`. Then `atos -o <dSYM>/Contents/Resources/DWARF/Codync -arch arm64
+ -l 0x100000000 <0x100000000 + offset>`.
+
+## Findings
+
+| # | Signal | Users | Root cause | Fix |
+|---|---|---|---|---|
+| 1 | Host panic `JoinHandle polled after completion` (tokio `core.rs:427`), Linux and macOS | 3 | `remote/channel.rs` `run` awaited the writer task again after `serve` had already taken its end (a phone's transport closed first). Reproduced by a unit test. | 2.19.0 (`b0c2e8fe`) |
+| 2 | Host panic in std `stdio.rs` `print_to`, macOS and Windows | 4 | tracing-subscriber's fmt layer `eprintln!`s when a log write fails; with stderr gone too (closed terminal, full disk) that panics. Inferred from the location and the source, not reproduced. | 2.19.0 (`b0c2e8fe`): `log_internal_errors(false)` |
+| 3 | Desktop renderer `TypeError` in `MemoryCard` (2.18.0) | 1 | `view.dreams.length` (mapped from the rebuilt bundle): a 2.18 app talking to a host before 2.18, whose `memory` method still answered with the Engram listing. | 2.19.0 (`37689bd6`): desktop and iPhone show "Update Codync on your computer…" |
+| 4 | Desktop renderer `NonError`, mechanism `onerror`, 48 events, mostly Windows | 5 | Error events that carry no error object (the ResizeObserver loop notice, cross-origin "Script error."). Nothing to act on. | 2.19.0 (`74e71a6b`): no longer reported |
+| 5 | `GPUGone`, `UtilityGone`, `RendererGone` with reason `killed`, all in the same millisecond | 4 | The app being torn down (logout, shutdown, an update), not a crash. | 2.19.0 (`74e71a6b`): no longer reported |
+| 6 | `GPUGone` reason `launch-failed`, Linux, up to 10 per launch | 4 | Chromium couldn't start a GPU process and fell back to software rendering; the same people went on to send 30+ messages. | 2.19.1 (`aa269562`): no longer reported |
+| 7 | `turn_finished` failed, `agent_error` `-32603`, Claude: 333 on 2026-10-17 from one person, 307 of them under 2 s with `source = bot` | 1 heavy, a few each for others | Most likely a dead adapter session: once its query stream ends, Claude's adapter answers every later prompt on that session with "The Claude Agent session has ended" until the session is closed, and a busy bot never went idle long enough for the idle release. Established from the adapter's source and an e2e fixture; the person's actual messages are not recorded. | 2.19.1 (`430e87e4`, folded into `close_reloadable` by `c014f70f`): the session is closed after such a failure and loaded again on the next message. Failed turns now carry the adapter's own category as `agent_reason`. |
+| 8 | iPhone 2.17.0 `EXC_BREAKPOINT` | 1 | `URLSessionSocket.ping()` (`HostConnector.swift:100`): `sendPing`'s handler resumed the checked continuation twice (the trap is in `libswift_Concurrency` right after the closure). | 2.19.1 (`49e116d4`): resumes once |
+| 9 | iPhone 2.17.0 `EXC_CRASH` (SIGABRT from an Objective-C exception in AVFAudio) | 1 | `OnDeviceEngine.listen()` installed a microphone tap on a 0 Hz input format (the microphone briefly unavailable). | 2.19.1 (`49e116d4`): `MicTap.format(of:)` throws instead, used by every engine and dictation; the macOS speech helper got the same guard |
+| 10 | iPhone 2.17.0 `EXC_BREAKPOINT` inside SwiftUI (iOS 27.2) | 1 | Unknown: the report kept only the 50 frames nearest the crash, all SwiftUI and AttributeGraph. | Open. 2.19.1 keeps 200 frames, so the next one shows the app's frames |
+| 11 | Desktop renderer `NotFoundError`, mechanism `unhandledrejection`, Windows 2.17.5 and macOS 2.17.1 | 3 | Unknown: a `DOMException` has no stack, and its message isn't sent. Not the microphone (`microphone()` rewraps its errors). | Open |
+
+Also seen, not ours: a fork (`realbot/Codync`, versions 2.18.7 and 2.18.9, above any real tag,
+frames from `localhost:5173`) reports into the project with `env = main`. Its `deleteChat` and
+`lastMessagePreview` errors are fork code. Ignore versions newer than the latest `v*` tag.
+
+## Verification
+
+- 1: `a_device_that_stops_reading_ends_the_channel_cleanly` reproduces the exact panic without the fix.
+- 3: desktop sandbox against a 2.17.5 debug host (Memory → Dreams shows the update message) and against the fixed host (normal).
+- 7: `a_session_that_ended_in_the_agent_is_closed_and_loaded_again` (`tests/fixtures/ended_session_agent.py` mimics the adapter) fails without the fix; a real Claude bot still answers through the sandbox.
+- 8, 9: iPhone simulator paired with a sandbox host: chat, a voice call, and killing the host under a connected phone, without a crash. The 0 Hz microphone case itself couldn't be produced on the simulator.
+
+## Open
+
+- 10 and 11 need more detail than the reports carry; see [error tracking detail](../plans/error-tracking-detail.md).
+- 7: watch `agent_reason` and `rpc_code` on failed Claude turns after 2.19.1; bursts that remain with `rate_limit` or `overloaded` are the provider, not Codync.
diff --git a/docs/archive/windows-npm-agents-2026-10-14.md b/docs/investigations/windows-npm-agents-2026-10-14.md
similarity index 100%
rename from docs/archive/windows-npm-agents-2026-10-14.md
rename to docs/investigations/windows-npm-agents-2026-10-14.md
diff --git a/docs/plans/error-tracking-detail.md b/docs/plans/error-tracking-detail.md
new file mode 100644
index 00000000..2adb53a1
--- /dev/null
+++ b/docs/plans/error-tracking-detail.md
@@ -0,0 +1,56 @@
+# Error tracking detail
+
+Proposal, not built. What PostHog could record so a production error can be acted on without
+asking the user, and what each step costs in privacy. Today's rules and payloads:
+[usage analytics](../features/analytics.md#error-tracking). The 2026-10-19 triage that prompted
+this: [PostHog error triage](../investigations/posthog-errors-2026-10-19.md) (two of its eleven
+findings stayed unexplained for lack of detail).
+
+## What's missing today
+
+| Client | What an error report carries | Gap |
+|---|---|---|
+| Host | Panic location (file and line) and a literal panic message; release builds are stripped, so no frames | Which code path led there; a formatted panic message (`failed printing to stderr: …`) is dropped |
+| Desktop | Type, mechanism and readable frames (the renderer is built unminified) | A `DOMException` or a rejection has no stack, and no message is sent, so `NotFoundError` can't be placed |
+| iPhone | MetricKit type, signal and `binary + offset` frames | Frames need a manual dSYM lookup per version |
+| Android | Type and frames (class, method, file, line) | — |
+| All | Each error stands alone | No session: PostHog can't show what the person did just before (error tracking shows 0 sessions) |
+
+The public promise (`web/app/privacy/page.tsx`, *Crash and error reports*) says an error's message
+is never sent and paths are cut down to Codync's own files. Options A keep it; B and C change it.
+
+## A. More detail without changing the promise
+
+1. **iPhone frames symbolicated by PostHog.** Send MetricKit frames as PostHog `apple` frames
+ (`instruction_addr`, `image_addr` = `address − offsetIntoBinaryTextSegment`, `module`, `in_app`)
+ with an event-level `$debug_images` list (`debug_id` = the frame's `binaryUUID`, `image_addr`,
+ `type: macho`, `arch: arm64`). Upload each release's dSYMs from Xcode Cloud
+ (`ci_scripts/ci_post_xcodebuild.sh`, `posthog-cli` 0.7.7 or later, a personal API key with
+ *error tracking write* as an Xcode Cloud secret). PostHog then shows function, file and line
+ for every iPhone crash. Only addresses and binary UUIDs leave the device.
+2. **A session per launch.** A `$session_id` (UUIDv7, new on each app launch and host start) on
+ every event lets PostHog's error page show the feature events that led up to an exception.
+ Those events are already sent; nothing new is recorded.
+3. **Context properties on `$exception`.** The screen or sheet that was open, the call engine, the
+ connection (direct or relay), the agent of the bot involved: catalog names, as other events carry.
+4. **Host frames.** The same server-side symbolication for the host: capture instruction addresses
+ and the binary's build ID on panic, and upload split debug info from the release workflow for
+ macOS, Linux and Windows. The most work for the least gain (panics already carry their location).
+
+## B. Scrubbed messages (changes the promise)
+
+Send an error's message after removing paths, URLs, e-mail addresses, quoted strings, long tokens
+and numbers. It explains most errors at a glance (`Requested device not found`, `Broken pipe`), but
+messages from agents and the OS can still carry a user's content in shapes a scrubber misses. Needs
+the privacy page and the four in-app analytics texts updated (listed in [usage analytics](../features/analytics.md)).
+
+## C. A problem report the user sends (changes the promise, with consent)
+
+A *Report a problem* action that shows exactly what will be sent (recent errors with messages, the
+host log tail, versions) and sends it only when the person confirms. Full detail, explicit consent,
+but UI in every client.
+
+## Recommendation
+
+A1 and A2 first: the largest gain (readable iPhone crashes, the steps before every error) with no
+change to the promise. Then C if a bug needs a message to be understood. Avoid B.