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: N in the user config (~/.config/task-plus/local.yaml): how many stories that need the person may be open at once; 3 when unset. A limit: in a project's task-plus.local.yaml is 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's task-plus.local.yaml no longer replaces the list (review of #274).
  • docs/overview.md; an overview row 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 story or 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