id(chat): presence heartbeat protocol over gossip (ephemeral, TTL-based)

Follow-up from the IRC-first chat investigation (#2049, doc in PR #2807 §2.4; synthesis consumer #2051).

Build: presence as specified: per-node {node-id, channels[], status, ts} heartbeats over direct connections fanned out via the already-wired gossip ALPN, short TTL (60–90 s suggested), stale = gone, no leave messages. Roster = backing-group fold annotated with last-seen liveness. Presence is NEVER journaled, synced, or replayed.

Done when: two nodes show each other live/stale correctly across a simulated netsplit (kill -STOP / resume), and typing-indicator TTLs ride the same path. Hand the result to #2051.

Acceptance criteria

Two nodes exchange presence heartbeats ({node-id, channels[], status, ts}) over direct connections fanned out via the already-wired gossip ALPN, with a short TTL (60–90 s suggested); stale entries read as gone; no leave messages.
Roster = backing-group fold annotated with last-seen liveness, demonstrated across a simulated netsplit (kill -STOP / resume): both nodes show each other live, then stale, then live again correctly.
Presence is never journaled, synced, or replayed (verified in the implementation); typing-indicator TTLs ride the same path.
Result handed to the synthesis consumer id: design: ID chat v1 #2051.

Intake review

Related: investigation id: investigate: IRC-first chat on ID — channels, graph-linked objects, presence #2049 (doc in PR docs: IRC-first chat on ID investigation (#2049) #2807 §2.4), synthesis consumer id: design: ID chat v1 #2051 (OPEN), sibling PoC id(chat): PoC — two CLI nodes exchanging channel frames with a blob link #2808.
Notes: Spec is unusually complete for a follow-up (heartbeat shape, TTL range, roster definition, the never-journal rule). The body's "Done when" is formalized into the acceptance criteria section. Still live — no presence implementation has landed.
Risks: The failure mode to test hardest is the netsplit: stale detection must not flap on resume, and presence must stay out of the journal/sync path.
Suggested approach: Build directly to the §2.4 spec on the existing gossip ALPN; the kill -STOP/resume transcript is the verification artifact.

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), openchamber-scheduled-lane
Session / ID: task 5799
Found via: id: design: ID chat v1 #2051 synthesis queue triage
Task: Implement ephemeral channel presence with bounded TTL and roster liveness, without journaling or syncing it.
Expectation: effort/m; simulated netsplit stop/resume transcript, stale expiry, and typing TTL on the same path.
Links: queue task 5799; parent design id: design: ID chat v1 #2051; bridge constraints id: investigate: bridge semantics — hosted (HTTPS/WS) edition syncing with native Iroh nodes #2058

agent-note:v1

task: 5799
state: picked up (lane E resume)
branch: queue/5799-2809-id-chat-presence
worktree: ~/git/fleet/5799 (laptop)
note: Resumed from prior park (clean at ec305bf, zero implementation). Revalidated fresh: issue id(chat): presence heartbeat protocol over gossip (ephemeral, TTL-based) #2809 OPEN, no held/user-owned/do-not-merge/do-not-auto-edit labels, no open PR for id(chat): presence heartbeat protocol over gossip (ephemeral, TTL-based) #2809. Implementing presence protocol per acceptance.

fix(id): brace the presence/announcement receive branch (#2809)

fix(id): brace the presence/announcement receive branch; fmt chat_pre…

fix(id): dedupe heartbeat channels without moving the input; no expec…

fix(id): Codex review - authenticate presence sender, stamp-based exp…

fix(id): sign presence heartbeats - gossip does not authenticate auth…

fix(id): serve signs its presence heartbeat and verifies received ones (

Merge pull request #3956 from developing-today/queue/5799-2809-id-cha…

agent-note:v1

task: 5799
state: done (fixed_merged)
pr: feat(id): chat presence heartbeat protocol over gossip (#2809) #3956 — merged 628436e
note: Presence protocol implemented as specified. pkgs/id/src/chat_presence.rs: signed per-node {node, channels[], status, ts} heartbeats, 75 s TTL (60–90 s band), no leave messages, stamp-based expiry (replays cannot extend a claim), roster = backing-group fold annotated with last-seen liveness, receipt-side membership filtering + viewer-scoped rosters for private channels, typing on a 12 s TTL over the same path. The table is in-memory only — never journaled, synced, or replayed. serve broadcasts/verifies presence frames on the existing gossip ALPN. Codex round (3 P2 findings: authentication, duplicate-extended expiry, pruning) fixed and replied on the PR threads.
tests: laptop cargo test -p id chat_presence — 10 passed, 0 failed (TTL, two-node stop/resume frame exchange, roster annotation, private-channel scoping, typing TTL, replay/out-of-order refusal, duplicate-expiry, signature authentication, frame magic, memory-only).
handoff: result handed to id: design: ID chat v1 #2051 (comment there). Pre-existing unrelated failure found on main: id-core test target does not compile (vt100 used in world_presentation tests, not an id-core dev-dependency after the crate split).

Navigation Menu

Repository navigation

id(chat): presence heartbeat protocol over gossip (ephemeral, TTL-based) #2809

Acceptance criteria

Intake review

19 remaining items

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

id(chat): presence heartbeat protocol over gossip (ephemeral, TTL-based) #2809

Description

Acceptance criteria

Activity

dezren39 commented on Oct 31, 2026

Intake review

dezren39 commented on Nov 1, 2026

19 remaining items

dezren39 commented on Nov 1, 2026

dezren39 commented on Nov 1, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions