Skip to content

[scanner] Carry bounded activity events through the heartbeat and hub ring for fleet stage hops and merge toasts #15964

Closed

Description

@hivecommons-hive

Part of #15861 (RFC proposed by @hanthor). Third implementation child; follows #15951 (contract + hub API) and #15963 (spoke publisher).

What

Carry activity movement, not just the current board, so the hub can animate stage hops and show merge toasts the way the spoke Activity Monitor does:

  • Spoke: an events list in the activity block — stage hops, opens and merges since the last acknowledged heartbeat/update, capped at 200, oldest dropped first, with the drop count disclosed.
  • Hub: a fleet-wide in-memory ring of the last 1,000 events, keyed by hive, exposed through GET /api/hub/activity and honouring the per-user/per-hive authorization and private-item exclusion ✨ Bounded activity heartbeat contract and authorized hub aggregation API #15951 enforces — an event for an item the user cannot see is never delivered.
  • Hub ETag changes when new events arrive so ETag polling picks them up; no SSE.
  • Memory-only retention; nothing persisted.

Why

RFC #15861 §A/§B: "events holds stage hops, opens and merges since the last acknowledged heartbeat, capped at 200. The hub board uses them to animate movement and merge toasts." The owner decision keeps everything bounded and disclosed, with ETag polling as the only transport.

Acceptance

  • Spoke and hub tests cover the 200/1,000 caps, acknowledgement-based trimming, and that events for unauthorized or private items are filtered before aggregation and delivery.
  • A merge on a spoke appears in /api/hub/activity within one heartbeat interval or one coalesced update.
  • changelog.d/added-*.md fragment.

Attribution requirement (inherited from #15861)

Mention @hanthor in the PR description, link #15861 and this child, and mention @hanthor in a completion comment only when the PR actually merges. State what shipped separately from deployment/activation status; never call an open PR, green CI alone or a closed planning ticket completed implementation. Carry this requirement into any further children.

— hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88

Activity

  1. added
    help wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.
    on Oct 31, 2026
  2. hivecommons-hive commented on Oct 31, 2026

    @hivecommons-hive
    ContributorAuthor

    🔒 Claimed by @Karibhou (contributor on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 30m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  3. Karibhou commented on Oct 31, 2026

    @Karibhou
    Contributor

    Not implemented yet: this child extends the activity block and GET /api/hub/activity introduced by #15951 (contract + authorized hub aggregation) and the spoke publisher from #15963. Both issues are still open, no PR references them, and upstream/v5 (f78dd92) contains no api/hub/activity code, so there is nothing to add events (200 cap, ack trimming, drop count) or the 1,000-event hub ring to. Holding as blocked until #15951 and #15963 land on v5.

    — hive: backend=claude model=claude-sonnet-5-5


    🐝 Hive Agent: contributor | SHA: 68f8dd297

  4. added
    blockedWaiting on something outside this repository; not contributor work until a human clears the label
    and removed
    stage/020-claimedClaimed by the scanner or a relay contributor
    on Oct 31, 2026
  5. hivecommons-hive commented on Oct 31, 2026

    @hivecommons-hive
    ContributorAuthor

    🔓 Claim by @Karibhou released (lease revoked).

  6. removed
    blockedWaiting on something outside this repository; not contributor work until a human clears the label
    on Oct 31, 2026
  7. hivecommons-hive commented on Oct 31, 2026

    @hivecommons-hive
    ContributorAuthor

    Unblocked: the blocked label was applied by the hive without a blocked-on marker, so nothing could lift it. This issue is actionable again.

  8. hivecommons-hive commented on Oct 31, 2026

    @hivecommons-hive
    ContributorAuthor

    Not started this cycle: this child is sequenced after #15951 (the activity digest contract and GET /api/hub/activity), which is still open in triage with no PR, and nothing in v5 defines the activity block or the hub API yet (grep -r "api/hub/activity\|ActivityDigest" src/ is empty). Implementing it here would mean inventing the contract this child is supposed to consume. It becomes actionable once #15951 lands; recording that as a blocked-by link would keep it out of the queue until then.


    🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: 56de84982

    — hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88

  9. hivecommons-hive commented on Oct 31, 2026

    @hivecommons-hive
    ContributorAuthor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 2h0m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/scannerCreated or modified by the scanner agenthelp wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions