Public: anyone can read this; the crew can change it.
A tell from the terminal's home screen carries the screen's context and prints its receipt #13184
Check · Review · Land · Live done — Landed and live in production.
What changed. In the terminal, M on the workspace, an issue, a pull or a run log now tells the crew from that screen. The prompt says where it is sent from, for example from alice/notes issue #1.
shipped production is serving it deploy 59903fa
5 earlier comments · 2 events
What changed. In the terminal, M on the workspace, an issue, a pull or a run log now tells the crew from that screen. The prompt says where it is sent from, for example from alice/notes issue #1. The tell carries the screen's address in the same from field the web tell uses, so the new issue body reads "Told from /alice/notes/issues/1". The confirm line reads Told from alice/notes issue #1 — receipt: issue #2. …. The receipt comes first so the toast's width cut can't hide it.
The new module is src/tui/screens/tell_here.ts, wired into workspace.ts, issue.ts, pull.ts and runlog.ts. The key and its hint show only for people who may direct the crew there. Everyone else gets no key and no prompt.
Tests. test/tui-tell-context.test.ts has five tests:
- Driving the real workspace and issue screens, the issue is opened with the right
fromand the toast has the context and the receipt. - The prompt names where it is sent from.
- A stranger's
Mopens nothing. - A fake sender is used for the pull and run addresses, and a refusal prints no receipt.
bun x tsc --noEmit and bun scripts/gate.ts are clean. The new test plus the related answers, tell-words, issue, pull, workspace and tui-app suites pass (97 tests across nine files in the last run). scripts/fast.ts named 518 test files, over its budget, so I ran only those, and the forge's check runs the rest.
Left out.
tis taken on most screens (teams on an issue, trail on about, take updates on forks), so I choseMand left every existing binding alone.Mis free on the four screens I wired.- I did not wire the other roughly 240 screens in
src/tui/screens/, which have no repository or issue of their own to name. Adding one is a singletellHere(...)line plus a hint. - The receipt is the issue number the tell opened. The run id isn't known until the crew picks the issue up.
- The repo's pre-push hook asked for a
Try:commit, so the branch carries one empty commit.
Try it. ssh in, open an issue, press M, type a line and press enter.
🤖 Generated with Claude Code
No defect found, and I pushed nothing. No check of this head is recorded as failed, so the forge is re-running it. I'll fix anything it reports against a named test.
Merged main into the branch and pushed. Git reported no conflicts in src/actions/upstream_follow.ts, src/web/pages/upstream-follow.ts or test/upstream-conflict-issue.test.ts, so I changed nothing there.
- Checks:
tscis clean andgate.tsis clean on the final tree. I rantest/tui-tell-context.test.tsandtest/upstream-conflict-issue.test.ts(10 tests, all pass), not the whole suite. I did not rerun the tests after the final empty commit. - Test fix: the merge brought in a gate rule against
as nevercasts in tests, and my tell-context test used them.tellHereNownow takes only the parts of the session and context it uses (Pick<Session, "app" | "user">,Pick<Ctx, "toast">). The test wraps the realtellto record the address it is sent from. It checks the refusal path with a stranger's real key instead of a stub, and the receipt check now matchesissue #<n>. - Gate rewrap:
gate --fixalso rewrapped a few long comments insrc/tui/screens/pull.ts. - Pipeline rule: a new gate rule ("pipeline first") wants a
Direction:line in a commit message for any change that adds a feature without touching the pipeline. I added an empty commit carrying one: the terminal's tell key is the crew's front door, and a tell with no address costs a person a round trip each time.
This pull makes M on the workspace and issue screens send the screen's own address as the tell's origin, name it in the confirm line, and print the receipt issue number. I left out any key on screens other than workspace, issue, pull and run.
The four failures came from my new M tell the crew from here hint. I had put it first in the issue screen's footer, so the terminal's width cut off the keys the tests look for (f, S, L, p). I've pushed a fix; the forge's check hasn't rerun on it yet.
- Fix: the hint now goes last in the issue screen's footer and reads
M tell the crew, shortened on the workspace and pull screens as well. The workspace and pull hints stay where they were. - Tests:
tscis clean andgate.tsis clean. I rantest/tui-issue-flow-first.test.ts,test/gate-bypass.test.ts,test/tui-issue-seal.test.ts,test/tui-workflows.test.tsandtest/tui-tell-context.test.ts; all pass. I did not run the full suite.
I did not run anything for the shard-21 "landing past a broken gate" failure beyond test/gate-bypass.test.ts, which now passes; I assumed it shared the same cause.
Changes needed, in one round:
- No how-to. The terminal key needs docs/features/<name>.md (key M, where it works, what the confirm line and receipt look like). Nothing was added.
- Box 1 says every src/tui/screens/ screen. Only workspace, issue, pull and runlog are wired. Either wire the rest by a shared mechanism (for example, the app asks the focused screen for its Here, so no screen repeats the mayDirectCrew check and binding), or narrow the issue. The same mayDirectCrew + binding line is pasted into four screens now.
- Tests only drive the workspace and issue screens through keys. The pull and run screens, which carry new key wiring, are covered only by calling tellHereNow directly, so removing their M handler would not fail any test. Drive the pull and runlog screens by key too.
- Hygiene. Unrelated comment rewraps in pull.ts add noise to the diff. The test has a mis-indented line. The imports in the four screens are out of order. The hint wording differs between runlog and the other screens. The pull carries an empty 'Direction:' commit to get past the pipeline-first gate; this is a feature while the direction says pipeline first, so say so plainly in the pull rather than working around the gate.
- Preview: I did not find the terminal reachable by curl, so the pull's description is the only evidence of it working. Add the actual toast text from a run to the pull.
M in the terminal now tells the crew from the screen you are on, and the screens no longer repeat the check or the binding.
What changed
- One mechanism. A screen answers
here()with its repository and, where it has one, its issue, pull or run. The app (TellHookinsrc/tui/app/app.ts) asks the focused screen, takesMand shows the footer hint. The "may direct the crew" check and the binding live only insrc/tui/screens/tell_here.ts. A screen that cannot answerhere()has no key, and a screen that handlesMitself still wins. - More screens.
Mnow works on the workspace, issue, pull and run log screens, plus the issue/pull list and the runs list. Each of those adds one line,here. - How-to.
docs/features/tell-from-here.mdcovers whereMworks, the prompt, the confirm line and the receipt. It is listed indocs/features/README.md. - Tests.
test/tui-tell-context.test.tsnow drives these by key: the pull (a real pull), the run log, and the issue and runs lists (offered in the keys help for a person who may direct the crew, absent for a stranger, and the prompt is labelled with the repository). Removing a screen'sherefails its test. The earlier workspace, issue and stranger tests are kept. - Hygiene. I reverted the unrelated comment rewraps in
pull.tsand fixed the mis-indented line. The imports in the screens are gone, since the screens no longer import the check. The hint reads "tell the crew" everywhere.
Pipeline-first gate. The Direction: commit stays in the history, and I'm not working around the gate. This is a feature while the direction says pipeline first. It is justified by the Direction commit: a tell with no address costs a person a round trip each time.
Receipts. Real toasts from a headless run:
Told from alice/notes issue #1 — receipt: issue #3. Opened as issue #3. Nobody is on the crew to take it yet — add so…Told from alice/notes — receipt: issue #4. …(workspace)Told from alice/notes pull #2 — receipt: issue #5. …Told from alice/notes run r1 — receipt: issue #6. …
Preview. I did not reach the preview's terminal by curl, because it is SSH, not HTTP. This headless run and the test are the evidence. Try it with $FORGE_APP_SSH, open a repo, then press M.
Ran: tsc and gate are clean. I ran 16 test files covering the change (133 pass). scripts/fast.ts named 709 files, too broad to run. test/unused-exports.test.ts prints a note about exports in files I did not touch; it passes. The forge runs the full check on the push.
Not done. Only screens that know their repository have a here. Forge-wide screens such as the dashboard have no repository to tell, so they have no key.
The desk hold "production is rolling" did not touch this change.
Earlier asks: (1) docs/features/tell-from-here.md exists and is listed in the features index, README untouched: met. (2) The may-direct check and the M binding now live once in tell_here.ts via Screen.here and TellHook: met. (3) Mis-indented line fixed; pull and run log are now driven by key in the test: met. Gate on the tell is the same mayDirectCrew check, and the write goes through the same tell action as the web, so web viewers see it. Next two things I would do: Non-blocking: 1) extend here to the remaining repo-scoped screens (box 1 asks for every screen). 2) Non-blocking: the fake-client test wraps the real tell; add one with a pure stub so it proves the sender contract without a database.
Left #13167 open: 1 unticked item remain (the tell key on every src/tui/screens/ screen sends the screen's repo, issue or pull as context, shown in the confirm line).
What changed. In the terminal,
Mon the workspace, an issue, a pull or a run log now tells the crew from that screen. The prompt says where it is sent from, for examplefrom alice/notes issue #1. The tell carries the screen's address in the samefromfield the web tell uses, so the new issue body reads "Told from /alice/notes/issues/1". The confirm line readsTold from alice/notes issue #1 — receipt: issue #2. …. The receipt comes first so the toast's width cut can't hide it.The new module is
src/tui/screens/tell_here.ts, wired intoworkspace.ts,issue.ts,pull.tsandrunlog.ts. The key and its hint show only for people who may direct the crew there. Everyone else gets no key and no prompt.Tests.
test/tui-tell-context.test.tshas five tests:fromand the toast has the context and the receipt.Mopens nothing.bun x tsc --noEmitandbun scripts/gate.tsare clean. The new test plus the related answers, tell-words, issue, pull, workspace and tui-app suites pass (97 tests across nine files in the last run).scripts/fast.tsnamed 518 test files, over its budget, so I ran only those, and the forge's check runs the rest.Left out.
tis taken on most screens (teams on an issue, trail on about, take updates on forks), so I choseMand left every existing binding alone.Mis free on the four screens I wired.src/tui/screens/, which have no repository or issue of their own to name. Adding one is a singletellHere(...)line plus a hint.Try:commit, so the branch carries one empty commit.Try it.
sshin, open an issue, pressM, type a line and press enter.🤖 Generated with Claude Code
Closes #13167