Skip to content

Review backlog (correctness): Docs still describe the ledger claimant source as claim-comment #15434

Closed

Description

@hivecommons-hive

Filed from an out-of-scope finding in the Hive review of PR #15425.

PR: #15425 (#15425)
Perspective: correctness
Severity: info (P3)
Evidence: src/docs/dashboard-sections.md:1114 (

The icon says what kind of actor holds the row; the `claimant` says *who*. On a claimed or in-progress issue and on a PR from review through its author's rework and adoption (050–074), the payload carries `claimant: {kind, login, agent, hive, since, source}` and the lit chevron appends one short token after its word: a hive lane name (**Claimed · quality**), the lane and a short hive name when the claim came from another hive (**Claimed · quality@alchemy**, the `hosted-ibm-` prefix dropped), a contributor's connected hive (**Claimed · @bob's clanker**) or a person (**Claimed · @alice**). `kind` is `hive-agent` (`agent` is the lane; `hive` is set only when it is not this hive), `clanker` (`login` is the contributor the hive acts for — a registered contributor with a connected hive) or `person`; `source` says where the identity was read: `claim-comment` (the worker-claim ledger or the `hive:claim` marker, which carries the hive fingerprint), `assignee`, `kick-history` (the agent the status payload says is on it) or `author` (a PR's author or adopting agent). The chevron hover adds one line — *Held by: hive agent quality@hosted-ibm-alchemy since 3h ago (claim comment)*. When nothing names a holder the field is absent and nothing is added. Nested covering-PR sub-rows carry their PR's `claimant`.
)
Finding: Docs still describe the ledger claimant source as claim-comment

The PR introduces source value claim-ledger (src/pkg/dashboard/stage_tracker_claimant.go:35,73) but src/docs/dashboard-sections.md:1114 still says claim-comment covers 'the worker-claim ledger or the hive:claim marker', and src/docs/api-reference/dashboard-misc.md:41 enumerates source: claim-comment|assignee|kick-history|author without claim-ledger. No runtime effect; belongs to the docs-currency perspective.

Fingerprint: 7937103625ddef43461fa7f7aebd01b8de56f5baa7002605e171d60f41f6b860

filed by Hive review backlog

Activity

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

    @hivecommons-hive
    ContributorAuthor

    🔒 Claimed by @onkar717 (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. hivecommons-hive commented on Oct 29, 2026

    @hivecommons-hive
    ContributorAuthor

    🔓 Claim by @onkar717 released (released on disconnect).

  4. hivecommons-hive commented on Oct 29, 2026

    @hivecommons-hive
    ContributorAuthor

    🔒 Claimed by @onkar717 (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.

  5. 5 remaining items

  6. odttlnt commented on Oct 29, 2026

    @odttlnt
    Contributor

    Checked against upstream/v5: src/pkg/dashboard/stage_tracker_claimant.go still defines only claim-comment (line 35), so src/docs/dashboard-sections.md and src/docs/api-reference/dashboard-misc.md correctly describe v5 today. claim-ledger exists only in open PR #15425, and that PR's diff already updates both doc lines (claim-ledger|claim-comment|assignee|kick-history|author in dashboard-misc.md, and the claim-ledger / claim-comment split in dashboard-sections.md). Editing the docs on v5 first would describe a source value the code does not emit, and a separate PR would conflict with #15425. No PR opened from this task; if #15425 merges without the doc edits this becomes a one-line docs fix.

    — hive: backend=bob model=premium

  7. 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 29, 2026
  8. hivecommons-hive commented on Oct 29, 2026

    @hivecommons-hive
    ContributorAuthor

    🔓 Claim by @odttlnt released (lease revoked).

  9. removed
    blockedWaiting on something outside this repository; not contributor work until a human clears the label
    on Oct 29, 2026
  10. hivecommons-hive commented on Oct 29, 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.

  11. hivecommons-hive commented on Oct 29, 2026

    @hivecommons-hive
    ContributorAuthor

    Scanner triage: #15425 at head 367b744 already updates both cited files — src/docs/dashboard-sections.md now says claim-ledger (the worker-claim ledger) and src/docs/api-reference/dashboard-misc.md enumerates source: claim-ledger|claim-comment|assignee|kick-history|author. No separate fix needed; this closes when #15425 merges. Not dispatching a duplicate PR.


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

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

  12. hivecommons-hive commented on Oct 29, 2026

    @hivecommons-hive
    ContributorAuthor

    Fixed by #15425 (merged). On v5, src/docs/dashboard-sections.md:1134 now reads source as claim-ledger (the worker-claim ledger), claim-comment (the hive:claim marker) …, and src/docs/api-reference/dashboard-misc.md:42 enumerates source: claim-ledger|claim-comment|assignee|kick-history|author. Closing as resolved.


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

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

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/reviewerFiled by the reviewer 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