275 — tp overview counts the called and not-defined stories against the limit of the user config (#275)
Roadmap: #275
Why
The manual's limit
is on the phases that need a human: a person can hold only a few
interviews and called stories in their head, whatever the agents are
building. tp overview (#274) lists those stories but does not say how
many there are against how many the person meant to have open; its
first real run showed seven where the manual's guess is three, and
nothing on the page said so.
The limit is the person's, not a project's, since no project can know what else they have open. This story records it and shows the count. Refusing a new interview at the limit comes later (the manual's "Agent flow 3"), judged against what this count shows.
What changes
limit: Nin the user config (~/.config/task-plus/local.yaml): how many stories that need the person may be open at once; 3 when unset. Alimit:in a project'stask-plus.local.yamlis not read.tp overview: a line above the groups, "Needs you: N of LIMIT", N being the called stories and the stories not yet defined together, and saying when N is at or over the limit.overview:likewise is read from the user config only: a project'stask-plus.local.yamlno longer replaces the list (review of #274).docs/overview.md; anoverviewrow in the README's command table (review of #274).
Acceptance
The line above the groups. N = called stories + stories not yet defined, across every forge read; raw ideas, roadmap items and stories in development or review are not counted.
limit: in the user config |
N | Every forge read | The line |
|---|---|---|---|
| unset | 2 | yes | Needs you: 2 of 3 |
| unset | 0 | yes | Needs you: 0 of 3 |
| 5 | 5 | yes | Needs you: 5 of 5, at the limit |
| 5 | 7 | yes | Needs you: 7 of 5, over the limit; marked as a warning |
| 5 | 2 | one not read | Needs you: at least 2 of 5 |
| 5 | 6 | one not read | Needs you: at least 6 of 5, over the limit; marked as a warning |
The setting:
limit: |
Where | Outcome |
|---|---|---|
| a whole number above 0 | the user config | that limit |
| unset, or 0 | the user config | 3 |
| below 0, or not a number | the user config | tp overview stops with an error naming the file and the field; nothing served |
| any | a project's task-plus.local.yaml only |
not read: the limit is 3 |
| 4 | the user config, with 9 in the project's file | 4 |
overview: |
Outcome |
|---|---|
in the user config, and another list in the project's task-plus.local.yaml |
the user config's forges are read |
in the project's task-plus.local.yaml only |
no forges: the error of #274 naming the user config |
Out of scope
- Refusing
tp idea storyor an interview at the limit. - How long stories have waited undefined, which is the evidence for changing the number.
- A count per repository or per forge.
Decisions
none
Done when
- tests express the acceptance table and pass
- spec updated
- ADR written if a fork was resolved
- roadmap ticked and stamped; changelog entry
- issue closed with a link to the release