Skip to content

feat(cli): report groups by task, not only filters to one #720

Closed

Description

@blafourcade

Outcome

A person can ask where a period's effort went between tasks, in one command, the same way they can already ask it between steps, models, tools and projects.

Scope

aidd telemetry report today accepts --task <yyyy_mm>/<name> as a filter: it restricts a report to one task. There is no way to group by task. The six axes are total | day | step | model | tool | project — task is not among them, and no by_task array exists in the JSON envelope.

So the question "which of my tasks cost the most this month" can only be answered by knowing every task name up front and running the command once per name, then adding up the results by hand. Every other dimension the layer records answers it in one call.

  • Includes: a by_task breakdown in the report envelope, beside by_step, by_model, by_tool and by_project.
  • Includes: task as an --axis value, so the artefact table can be pasted like the other five.
  • Includes: sessions that wrote into no task as their own row, never folded into another and never dropped — the same rule unattributed already follows on the step axis.
  • Excludes: any change to how a task is attributed. This groups what the journal already records; it does not widen it.
  • Excludes: the link from a task to its backlog item, which is feat(framework): a task identity file linking delivery to its backlog item #649.

Why it is not covered elsewhere

Done When

  • aidd telemetry report prints a by task section, ordered like the other axes.
  • --axis task produces a table with the same columns as the other five artefacts.
  • report --json carries by_task, and its rows reconcile to totals exactly, as every other breakdown already does.
  • Work belonging to no task appears as its own row with an explicit label, and the total says how much of the period it accounts for.

Relations

Field Value
relates_to #649, #631, #656

Activity

  1. added this to the milestone on Aug 28, 2026
  2. added 2 commits that reference this issue on Aug 31, 2026
  3. removed this from the milestone on Sep 3, 2026
  4. blafourcade commented on Sep 5, 2026

    @blafourcade
    ContributorAuthor

    Delivered — verified on next at a6f7412.

    aidd telemetry report --help now lists the axis:

    --axis <axis>  Print one axis as a table to paste elsewhere: total | day |
                   step | model | agent | task | backlog | flow | tool |
                   project | person
    

    And the JSON envelope (cost_report_version 15) carries by_task. Run over a 30-day period holding 30,222 requests, it returns 19 rows — 18 declared tasks plus one row for the work that declared none — and the rows sum back to the period total, the same reconciliation every other axis satisfies.

    The scope asked for grouping rather than filtering; --task remains available as the filter it always was, and --axis task answers "which of my tasks cost the most this month" without knowing the task names up front.

  5. moved this from Ideation to Done in AIDD Roadmapon Sep 5, 2026
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

    Fields

    Priority

    Medium

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions