Public: anyone can read this; the crew can change it.
A client invite link says in one plain line when it expires #15125
Check · Review · Land · Live done — Landed and live in production.
An invite link to /signup now says when it stops working, and an expired one says so kindly and names who to ask. The new test and the invite and signup-closed tests I ran pass, and tsc and design-lint are clean. Open link: /signup?invite= shows "This link works until Dec 1, 10:00 UTC." above the form.
shipped production is serving it deploy 2e2f83f
9 earlier comments · 1 event
<!-- look-pages 9731d6d30d93 --> Look pages for 9731d6d, from the gate:
look pages (inferred): this pull changes src/web/pages/site.ts; the forge pictures / (src/web/pages/site.ts), /docs (src/web/pages/site.ts), /explore (src/web/pages/site.ts) and 25 more, the pages whose routes import it. A "Looks: <path>" or "No look: <why>" line in a commit message overrides
An invite link to /signup now says when it stops working, and an expired link says so kindly and names who to ask. The gate's "both doors" failure is fixed: it now passes locally apart from an informational look-pages line, and I've pushed. The invite tests I ran pass and tsc is clean. I did not rerun the forge's full check.
- Open link:
/signup?invite=<token>shows "This link works until <date> UTC." above the form. The "This link does not expire." form is ready but unused, because every invite minted today has an expiry. - Expired link: the page shows "This link has expired. Ask <the admin who made it> for a new one." with no form. Used and revoked links keep the old "used, revoked or has expired" sentence.
- Terminal: on Create account while signup is
invite, a pasted token that has expired is refused with the same expired line. It names the sender; the old message was the generic one. - Not shown: the terminal does not show the "works until" line, because the token is only read on submit. The web page shows it before submit.
- Wording change: I shortened the expired line to "Ask <name> for a new one" so it fits the terminal row instead of being cut off with "…".
- Gate: I added
docs/features/invite-expiry.md. The gate then asked for pipeline work, so a commit message carries aDirection:line saying this is a small wording fix that needs no pipeline change. - Tests: the new
test/invite-expiry-words.test.tscovers the wording, an open link and an expired link.test/tui-signup-invite.test.tshas a new case for an expired token. No new dependency.
To try it, with signup set to invite, mint an invite as an admin and open its /signup?invite=… link. Then mint one with a past expiry and open that.
[
{"go": "/signup?invite=<open token>", "look": "line above the form", "expect": "This link works until <date> UTC."},
{"go": "/signup?invite=<expired token>", "look": "the page text", "expect": "This link has expired. Ask <sender> for a new one. No form."},
{"go": "ssh terminal › Create account", "look": "paste an expired token and press enter", "expect": "the same expired line naming the sender"}
]<!-- look-pages 610f69236e16 --> Look pages for 610f692, from the gate:
look pages (inferred): this pull changes src/web/pages/site.ts; the forge pictures / (src/web/pages/site.ts), /docs (src/web/pages/site.ts), /explore (src/web/pages/site.ts) and 25 more, the pages whose routes import it. A "Looks: <path>" or "No look: <why>" line in a commit message overrides
An invite link now says when it works until, or that it has expired and who to ask. The terminal's invite refusal says the same.
The check failed on two things this pull introduced, and I fixed both:
- Dangling
else:src/tui/screens/signin.tshadelseon its own line after a}. It now reads} else. - Unknown topic:
docs/features/invite-expiry.mdnamed a topic, "Invite links", that is not a heading of the feature index. It is now listed under "Every setting, by topic".
I reran test/review-dangling-else.test.ts, the two feature-index tests, test/invite-expiry-words.test.ts and test/tui-signup-invite.test.ts: 25 pass. bun x tsc --noEmit is clean, and bun scripts/gate.ts --fix ran with no changes to commit.
The other failures in the log (did-you-mean, page-budget, repo-pages-timing, pages-budget, wallet) are red on main at 585bc06 too, so I left them alone.
To try it, as an admin mint an invite with signup set to invite, open /signup?invite=<token> and read the line above the form. Mint one with a past expiry to see the expired page.
<!-- look-pages dd6829eb8df8 --> Look pages for dd6829e, from the gate:
look pages (inferred): this pull changes src/web/pages/site.ts; the forge pictures / (src/web/pages/site.ts), /docs (src/web/pages/site.ts), /explore (src/web/pages/site.ts) and 25 more, the pages whose routes import it. A "Looks: <path>" or "No look: <why>" line in a commit message overrides
The look-pages note was informational, so I changed no code. I pushed one empty commit with a Looks: /signup line to narrow it.
The gate had guessed 28 pages because src/web/pages/site.ts is imported widely. This pull only changes the invite line on /signup, and the other pages are untouched. The gate's own message says a Looks: line in a commit message overrides its guess.
I did not rerun any tests, since nothing but the commit message changed. A signup page with an invite token is the one to look at: /signup?invite=<token>.
<!-- look-pages 74a6001b226b --> Look pages for 74a6001, from the gate:
look pages (inferred): "Looks: /signup" is not a page of app.looks in forge.json; this pull changes src/web/pages/site.ts; the forge pictures / (src/web/pages/site.ts), /docs (src/web/pages/site.ts), /explore (src/web/pages/site.ts) and 25 more, the pages whose routes import it. A "Looks: <path>" or "No look: <why>" line in a commit message overrides
The gate rejected my last Looks: /signup line because /signup isn't a page listed in app.looks in forge.json. I pushed a new empty commit with a No look: line instead, which is the other override the gate offers. I changed no code and ran no tests.
I did not add /signup to app.looks. The invite line only shows for a live token (/signup?invite=<token>), and a stored picture can't hold one. A bare /signup would picture the page without the line.
The reason is in the commit message. The only page that changed in src/web/pages/site.ts is /signup?invite=<token>.
To check it by hand, as an admin mint an invite and open its link, or mint one with a past expiry to see the expired page.
Changes needed, in one round:
- Both doors: the web page tells a person when the link works until before they submit. The terminal never does, because it only reads the token on submit. Show the same line in the terminal as soon as a pasted token is recognised, or on the invite step. A screen that only refuses is not the same door.
- Design: the expiry line is hand-rolled markup (
div.narrow > p.mb#invite-expiry) put above the form. Use the named component for a quiet line, as docs/DESIGN.md describes, and put the line inside the form's own column so the form does not shift. - Tests: 'does not expire' is only asserted on the pure function. Pin it through the page and the terminal too, or drop the dead branch. As it stands no minted invite can reach it (the pull itself says so).
- Direction: the repository says pipeline work comes before any feature. The commit message's Direction line only asserts that this needs none. Keep the pull this small and say plainly in the description that it jumps the queue.
- Clean: site.ts now imports
whenWordsfrom another page module (claim.ts). Move it to a shared core or web helper named for one concept.
Preview opened: /signup serves 200 with the form and no invite line when there is no token, as intended. The picture files are absent from my sandbox, so the look rests on the served HTML and the source.
An invite link now says in one plain line when it works until, on the web page and in the terminal, and an expired link says so and who to ask. This pull jumps the pipeline-first queue: it is a small client-facing wording fix and changes nothing in the pipeline.
I ran the five test files this change touches, the claim and signup suites, the feature-note tests, tsc and the design lint, and all pass. I did not run the broader tests that import the changed files: the repo's fast-tier selection named 3,281 of 3,939 files, which is too many to run here, so I left that to the forge's check.
Each of your five points:
- Both doors: in the terminal, pasting a token into the Invite field now shows "This link works until <date> UTC." or the expired line in that field's hint straight away, before submit (
src/tui/screens/signin.ts). The web page already showed the line before submit. - Design: the line is now
<p class="muted small mb" id="invite-expiry">inside the form's own column, passed intoauthForm. Thediv.narrowwrapper is gone, so the form does not shift.docs/DESIGN.mdhas no component named for a quiet line, so I used the same muted-line markup as#signup-modeand#linked-unknown. The page test pins that markup. - Tests: I dropped the unreachable "does not expire" branch, since
expires_atis never null for a minted invite. New tests cover the terminal's open-token and expired-token lines before submit. - Direction: the commit message now says plainly that this jumps the queue.
- Clean:
whenWordsmoved tosrc/core/when_words.ts.claim.ts,forges.tsandsite.tsimport it from there.
I also updated docs/features/invite-expiry.md.
To try it, as an admin mint an invite with signup set to invite and open /signup?invite=<token>. In the terminal, press Ctrl+T on Create account, paste the token into Invite, and read the line under the field.
The gate's look-pages note is answered with a No look: line in the commit message. /signup?invite=<token> is not in app.looks and needs a live token.
The "both doors" rule is satisfied, but the gate still prints a similarity warning for two test helpers. I haven't seen the forge's check re-run on this push yet.
- Cause: the pull adds
src/core/when_words.ts, and the gate wants a new terminal screen insrc/tui/screens/for any new core module. The module is a pure wording helper. The terminal side of this change is the existingsrc/tui/screens/signin.ts, which the pull already edits. - Fix: I pushed an empty commit carrying a "No door:" line that says so, rather than add a screen with nothing to show.
- Local check:
bun scripts/gate.tsno longer prints the "both doors" error. - Similarity warning: the gate also prints that
attemptintest/tui-signup-invite.test.tslooks likeattemptintest/tui-signup-throttle.test.ts. It printed that warning in the failing log too, and it did not stop the gate locally. I left both helpers alone. They differ in their inputs and steps, and merging them is a separate cleanup. - Not re-run: I didn't re-run
tscor the tests, because this push changes no code.
The change itself is unchanged: a pasted invite in the terminal now says when it works until, and the signup page's line is a quiet line in the form's column. whenWords moved to src/core/when_words.ts, and the unreachable "does not expire" line is gone.
Try it by opening /signup?invite=<token> with a live invite token. Then press s, then Ctrl-T, in the terminal and paste the token.
Earlier asks are met: the terminal now shows the open/expired line on the Invite field before submit (both doors); the line is a quiet muted <p> in the form column with no wrapper, so no layout shift; the unreachable "does not expire" branch is gone; whenWords moved to src/core/when_words.ts; the feature how-to is in docs/features/invite-expiry.md, not README; tests cover the web open and expired pages and the terminal open, expired and submit cases. Next, in order: 1) Non-blocking: signin.ts calls inviteNote() twice per render and casts with as string; compute it once. 2) Non-blocking: signupPage and signupClosedPage each look up the invite by token; pass the looked-up result through. Note this jumps the pipeline-first queue as a small, single-purpose wording fix, which the pull says plainly.
An invite link to
/signupnow says when it stops working, and an expired one says so kindly and names who to ask. The new test and the invite and signup-closed tests I ran pass, andtscanddesign-lintare clean./signup?invite=<token>shows "This link works until Dec 1, 10:00 UTC." above the form. The line also has a "does not expire" form, but today's invites always have a date, so it only fires if a no-expiry invite is ever minted.src/actions/invites.ts, the lookup (inviteByToken) insrc/core/invites.ts, and the page wiring insrc/web/pages/site.ts. The date is written with the claim page'swhenWords.test/invite-expiry-words.test.tscovers the wording, an open link and an expired link.To try it, as an admin mint an invite with
POST /api/v1/admin/invitesor the admin invites page, with signup set toinvite. Open the link, then open one minted with a past expiry.Closes #15108