Skip to content

Agent-work report spec: thread rows and the done / total percent rule #13019

Closed

Description

@gHashTag

Owner request (translated, 2026-11-01): report on the work of the agents online, with a dashboard, an infographic and visuals. A one-off inline snapshot exists in the Claude Code session; this issue is the durable data model behind it, so that a T27 OS tile can later draw the same rows from a feed.

Conventions to follow, read-only: specs/t27os/queen_dash.t27 writes "no feed" for a number whose feed does not exist, and uses a sentinel for "not read". This spec follows that wording and does not edit that file. Epic-progress rule: a percent is shown only with its countable source (done / total), otherwise "not measured".

Boundary

  • specs/t27os/agent_report.t27

User Scenarios

  • Given three threads in states blocked, running and done, when the rows are built, then there are 3 rows ordered blocked, running, done.
  • Given done = 2 and total = 4, when the percent is formed, then it is 50 and the text "2 / 4" is written beside it.
  • Given total = 0 or a missing feed, when the percent is formed, then the result is the not-measured sentinel and the text "not measured", never 0 and never an invented number.
  • Given a thread whose issue number is 0, when its row is built, then the row carries the flag no-issue so the violation is visible.

Requirements

  • FR-001: The spec MUST be a pure module T27osAgentReport with no @extern and no window wiring.
  • FR-002: A row MUST hold an issue number, a title (str), an agent name, a state code (blocked, running, idle, done), check counts (pass, fail, pending) and a visual-core impact (str, or internal-only).
  • FR-003: percent(done, total) MUST return the not-measured sentinel when total is 0, and the text writer MUST put "done / total" beside every number it prints.
  • FR-004: Row ordering MUST put blocked first, then running, idle and done, and keep the input order inside a state.
  • FR-005: A row with issue number 0 MUST set the no-issue flag.
  • FR-006: Tests MUST cover the four scenarios plus the ordering of all four states, at least 6 tests, with 0 vacuous passes.
  • FR-007: The diff MUST add no hand-written non-t27 file.

Success Criteria

  • t27c test-report specs/t27os/agent_report.t27 reports 0 failing tests and 0 vacuous passes, exit 0.
  • git diff --name-only origin/master lists 1 file.

Activity

  1. added a commit that references this issue on Oct 31, 2026
    43951a1
  2. gHashTag commented on Nov 17, 2026

    @gHashTag
    CollaboratorAuthor

    Spec created: specs/tri/agent_work_report.t27 (typecheck OK, 1 test passes).

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

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions