048 — tp story query says a story not defined waits for acceptance (#254)

Why

At code level 3 an agent does what tp story query says and nothing else. The query reads called off the story's issue and not defined, so a story no human has accepted reads as any other: not begun (commit the story's work), no fragment (add it), not pushed (tp story land). The first two send the agent to build a story that is not accepted; the third sends it to tp story land, which refuses with #n is not defined. The refusal is right and the query is wrong: it names a step that cannot be taken, and whose step it is (the human's) is nowhere said.

What changes

  • tp story query at level 3: a story whose issue is not labelled defined stands not defined, and its next step is the human's: to accept the story, then tp story define. The row comes after called and before every row that builds or lands.
  • docs/story.md: the row in "Where a story stands".

Acceptance

tp story query on story/<n>-<slug>. The rows above the new one are as today and win first; every row below it is reached only by a story that is defined, or whose labels were not read.

maturity.code Branch Issue #n Stands Next step Who
3 in the base, released or untagged any labels released in vX or landed on main, as today tidy, as today agent
3 not in the base called, defined or not (tp story call -undefined leaves it both) called, as today answer the call, then tp story answer, as today human
3 just cut from the base, nothing of its own committed open, not defined, not called not defined accept the story on #n, then tp story define on the branch human
3 commits of its own, in any state: no fragment, not pushed, behind, unbuilt, in a pull request open, not defined, not called not defined the same human
3 any open, defined, not called as today as today as today
3 any labels not read: -offline, the forge failing, or the issue not open as today as today as today
1, trunk flow any any as today: defined is not a label below level 3 as today as today

The next step names the issue and the branch, as the called row does.

Out of scope

  • Telling a story with blank acceptance cells from one that is complete and waits only for the human: the query does not read the story file, and tp story define names the blank cells when it refuses.
  • tp story land's refusal, which is already worded as wanted.
  • Not ready: an undefined story adds no line there; Stands and Next step say it.
  • Who may run tp story define: still on the human's word only.

Decisions

None.

Done when

  • tests express the acceptance table and pass
  • spec updated
  • changelog entry
  • issue closed with a link to the release