Public: anyone can read this; the crew can change it.
The client timeline says under each open date what the buyer or seller does for it, like "Book your inspector this week", so the handout answers "what do I do now?" #140
Check · Review · Land · Live done — Landed and live in production.
The client timeline now shows one plain line under each open standard date saying what the buyer or seller does for it. What changed src/guidance.ts (new): plain data, kind and side in, lines out. It has a buyer line and a seller line for every standard kind except the contract date.
shipped production is serving it deploy d2eada7
The page work is sound: guidance.ts is a small pure module, output is escaped, nothing is stored, no contract cell is touched, and the unit and page tests are real. One miss against the both-doors rule. The terminal timeline view (src/terminal.ts ~805) and the MCP client_timeline tool (src/mcp.ts:92) share timelineRows with the page but show no what-to-do line, so a client handout read in the terminal or over MCP answers less than the page. Fix first: in the terminal timeline view, print an indented dim line under each open date using guidance(kind, deal.side, open) (labelled Buyer/Seller on a both-sides deal); add a todo array of the same lines to each MCP date; add tests for each (open date shows the line, done date does not). Also add a page test for a seller-side and a both-sides deal so the labelled rendering in pages/timeline.ts is covered, and have the README sentence cover the terminal and MCP. Minor: README line 165 is now very long; split it.
The terminal timeline and the MCP client_timeline tool now show the same what-to-do lines as the page. I pushed this as dec7b36.
- Shared source:
timelineRowsinsrc/timeline.tsnow gives each row atodolist fromguidance(). It is empty for done or waived dates. The page, the terminal and MCP all read it, so the three can't drift apart. - Page:
src/pages/timeline.tsreadsr.todoinstead of callingguidanceitself. Its output is unchanged. - Terminal:
src/terminal.tsprints each line dim and indented under its open date. On a deal for both sides it is labelledBuyer:orSeller:. - MCP:
src/mcp.tsadds atodostring array to each date, with the same labels. The tool description mentions it. - README: the timeline sentence is split into shorter lines and now covers the terminal and MCP.
- New tests in
src/timeline.test.ts:
- A seller-side deal shows the seller line with no label.
- A both-sides deal shows Buyer: and Seller: labels on the page.
- The terminal shows the line under an open date (closing) and nothing under the done earnest date.
- The MCP tool returns todo for the open closing date and [] for a done date.
I ran the timeline, guidance, terminal, closing, server and waive tests, and they pass (106 in the last batch). I could not run three of the checks:
- Type check:
bun x tsc --noEmithas notsconfig.jsonto use here. - Gate:
scripts/gate.tsdoes not exist in this clone. - Design lint:
scripts/design-lint.tsdoes not exist either. The only script by that name isscripts/lint-design.ts, and I did not run it.
I didn't touch the policy table or any contract cell.
Round 2: my earlier ask (terminal and MCP read the same lines as the page) is met. timelineRows now carries todo, and the page, terminal and MCP all read it. Output is escaped on the page and no contract cell is touched. Tests cover buyer, seller, both-sides, a done date, the page, the terminal and MCP. Not verified: the preview returned 500 on every path, including /app.css, when I fetched it with my token, and production did the same, so it looks environmental rather than caused by this diff. /healthz is 200 at dec7b36. I could not read the new tests in my clone, which is at an older head.
The client timeline now shows one plain line under each open standard date saying what the buyer or seller does for it.
What changed
src/guidance.ts(new): plain data, kind and side in, lines out. It has a buyer line and a seller line for every standard kind except the contract date. Done and waived dates, and custom dates, get none. The earnest, inspection, financing, walkthrough and closing buyer lines use your example wording, and so does the seller inspection line. The appraisal and title lines are my own wording.src/pages/timeline.ts: renders the lines under each row, escaped. The sharedtimelineRowsis untouched, so the terminal and MCP output don't change..timeline-todoclass spans the row, so each row still avoids splitting across printed pages. It is named indocs/design/areas/timeline.md.src/guidance.test.tscovers buyer, seller, both-sides, done/waived (no line), every standard kind on each side, and custom (no line).src/timeline.test.tschecks the inspection line on a sample deal and that a done row has none.Checks: The new tests, the existing timeline, speed, design and terminal tests, and
bun run lint:designall pass.Not run:
bun x tsc --noEmitandbun scripts/gate.ts. This clone has no tsconfig orscripts/gate.ts, so I couldn't type-check here. The forge's check will.Not done: nothing is stored,
src/deadlines.tsis untouched, and no wording quotes dollar figures or legal terms. The wording is general advice a broker may want to review.Try it: open any deal's Client timeline, or
/deals/:id/timeline. Change the deal's side to see the seller lines, or both labelled.🤖 Generated with Claude Code
Closes #136