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 queryat level 3: a story whose issue is not labelleddefinedstandsnot defined, and its next step is the human's: to accept the story, thentp story define. The row comes aftercalledand 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 definenames 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;StandsandNext stepsay 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