Skip to content

docs: Host Feed, Remote Host and device-owned notification preferences (ADR-0243) - #2506

Merged
DoodleBears merged 1 commit into
mainfrom
claude/project-thread-fst88w
Oct 21, 2026
Merged

DoodleBears merged 1 commit into
mainfrom
claude/project-thread-fst88w

Conversation

@DoodleBears

Copy link
Copy Markdown
Contributor

Requested by Vain · project thread

Why the change

After #2505 a browser can reach Remote Hosts, but every new synced state (avatars, activity, unread, Activity Center) would have to be built twice, and it was unclear who decides a notification across devices / 记录多设备同步与通知归属的设计结论,避免每次新增同步状态都要做两遍。

Refs #2500, #2180. This records the outcome of a grill-with-docs session with Vain (9 decisions).

Special things to note

  • Merge risk: docs only (CONTEXT.md, CONTEXT.zh.md, ADRs). No code. Revert is a plain revert.
  • Decisions recorded in ADR-0243:
    • Every client reads every Host, This Host included, through one Host Feed; This Host migrates onto it in slices (avatars, activity, unread first, then Activity Center).
    • The Host decides what deserves attention (Human Inbox); the Paired Device owns its Device Notification Preference and pushes a copy to each Host for closed-app sends. Marks ADR-0202's Host-owned switches as superseded.
    • A phone is only ever a Paired Device; a browser on Host A is a Paired Device of Host B.
    • Browser alerts only while the page is open for now; Web Push later.
    • Language: This Host / Remote Host; Chinese UI 本机 / 远程, never 电脑, so Computer keeps its glossary meaning (the PersonaBots' shared desktop). ADR-0242 is reworded accordingly.
  • Verification: pnpm lint, pnpm format:check pass; apps/docs/test/ passes (incl. dev-design-surface.test.ts, which checks en/zh glossary term parity).
  • CI test plan: expected affected (docs).

Change outline

  • CONTEXT.md / CONTEXT.zh.md: new terms This Host, Remote Host, Paired Device, Host Feed, Device Notification Preference.
  • New docs/adr/0243-every-client-reads-every-host-through-one-host-feed.md.
  • ADR-0242: Computer → Remote Host. ADR-0202 status: superseded in part by ADR-0243.

No UI change in this PR; the 本机/远程 wording and the Host Feed slices follow in the next PR.


Generated by Claude Code

…ferences

Records the grill-with-docs outcome: every client reads every Host,
This Host included, through one Host Feed; the Host decides attention
and the Paired Device owns its Device Notification Preference; a phone
is only a Paired Device. Renames Computer to Remote Host in ADR-0242.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Asbot1EHttjnKA6hQuCC6r
@DoodleBears DoodleBears self-assigned this Oct 21, 2026
@coderabbitai

coderabbitai Bot commented Oct 21, 2026

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 27 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used all 2 included reviews currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration
  • Configuration used: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 0550b1ed-9ce7-413b-9424-805a6b28faf9
📥 Commits

Reviewing files that changed from the base of the PR and between cda84e7 and cadda28.

📒 Files selected for processing: 5
  • CONTEXT.md
  • CONTEXT.zh.md
  • docs/adr/0202-phone-push-is-a-content-free-projection-of-the-human-inbox.md
  • docs/adr/0242-a-browser-pairs-other-computers-through-their-device-gateway.md
  • docs/adr/0243-every-client-reads-every-host-through-one-host-feed.md
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@DoodleBears
DoodleBears merged commit 2311909 into main Oct 21, 2026
10 checks passed
@DoodleBears
DoodleBears deleted the claude/project-thread-fst88w branch October 21, 2026 13:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants