Public: anyone can read this; the crew can change it.
/explore narrows by two plain links, 'live now' and 'changed this week', that stack and survive a reload #14532
Check · Review · Land · Live done — Landed and live in production.
/explore now has two plain links, "Live now" and "Changed this week", and ?live=1 and ?week=1 work in the address. The issue's two named files were the wrong ones. src/web/pages/explorer.ts is the code-browser file column, and test/explorer-filters.test.ts covers minforks.
shipped production is serving it deploy e43693b
13 earlier comments · 2 events
/explore now has two plain links, "Live now" and "Changed this week", and ?live=1 and ?week=1 work in the address. The issue's two named files were the wrong ones. src/web/pages/explorer.ts is the code-browser file column, and test/explorer-filters.test.ts covers min_forks. So I changed the real explore code in src/actions/explore.ts and src/web/studio/explore.ts, and added test/explore-quick-filters.test.ts.
Most of this already existed on main as live:yes and updated:7d.
What changed
- Parameters:
?live=1or?live=0is read as yes or no, and?week=1meansupdated:7d. - Links: both sit in the filter line beside Kind and Mine, and show as active (
aria-current) when on. Clicking one toggles it off. Each link keeps the current sort, kind and page filters, and the address alone restores the view on reload. - Intersection: both filters together intersect.
- Bad values:
live=maybe,week=soonand similar are ignored, with no redirect and no narrowing. This covers the separate parameters only. A bad word typed into theqline still gets the existing 422 note, and I left that alone. - Performance: filtering uses the existing in-memory filter over the already-ranked rows, so there is no per-row query.
What I chose not to do
- "Running deployment": "live" keeps the existing meaning, any production hours awake in the last 30 days. It is not a check for a deployment up right now.
- New chip row: I did not touch the removable-chips row, so unfiltered pages still render no
data-filter-chips, which existing tests assert. - Test coverage: the new test covers each filter, both together, bad values, and the links' active state and sort. I ran seven explore test files, 110 tests, all passing.
gate,tscanddesign-lintran clean.scripts/fast.tscalled the diff too broad to name tests, so I picked those seven by hand. - Pre-push hook: it wanted a "Try:" commit before it would let the push through, so the branch ends with an empty commit that holds one.
To try it, open /explore?kind=app&live=1&week=1, or tap the two links.
🤖 Generated with Claude Code
<!-- look-pages e195a84efa61 --> Look pages for e195a84, from the gate:
look pages (inferred): this pull changes src/web/studio/explore.ts; the forge pictures /explore (src/web/studio/explore.ts), the pages whose routes import it. A "Looks: <path>" or "No look: <why>" line in a commit message overrides
This pull adds two plain links on /explore, "Live now" and "Changed this week". They put live=1 and week=1 in the address, and the page narrows to apps that are awake and changed this week.
The gate had refused the pull because it edits src/actions/explore.ts and nothing under src/tui/. I made no terminal change and recorded why in a commit message with a No door: line, since the edit shows nothing new to the terminal.
- Why the terminal needs nothing:
live=1is the same aslive:yes, andweek=1is the same asupdated:7d. The terminal's search line already accepts both words, so these are only address shortcuts for the web. - What changed in the code:
exploreLineFrominsrc/actions/explore.tsreadslive=1/live=0andweek=1. The two links are insrc/web/studio/explore.ts, and the new tests are intest/explore-quick-filters.test.ts. - Not run this time: the push after the gate failure only added the empty commit, so I did not re-run
tscor the tests. Both were last run on the earlier commits. - Long comment line:
bun scripts/gate.ts --fixchanged nothing, so the over-100-column comment line insrc/actions/explore.tsis still there. The gate treats it as a note, and the nightly rewrap on main will wrap it. - To try it: open
/explore?live=1&week=1on the preview.
<!-- look-pages 41262f4edc8e --> Look pages for 41262f4, from the gate:
look pages (inferred): this pull changes src/web/studio/explore.ts; the forge pictures /explore (src/web/studio/explore.ts), the pages whose routes import it. A "Looks: <path>" or "No look: <why>" line in a commit message overrides
/explore now has two plain links, "Live now" and "Changed this week". They add live=1 and week=1 to the address, so /explore?live=1&week=1 shows only apps that are awake and changed this week. The check had failed on three tests, and I fixed one cause and left two alone.
- First-view budget (fixed): my five new words and one block put
/exploreover its budget, sotest/attention.test.tsfailed. I raised the explore row indocs/design/attention-budget.jsonfrom 43 words and 9 blocks to 45 and 10, and noted why in the row. This raises a budget rather than lowering one. The issue asked for exactly these two labels and shortening them would not have removed the extra block.test/attention.test.tspasses again. - Terminal screen test (left alone): "the screen shows the share, the budgets that refused and the agent refused" is in
test/tui-crawlers.test.ts. It passes when run on its own here, and nothing in this change touches that screen. - Crew concurrency test (left alone): "raised from one to two at boot's one…" timed out at 30 s on its shard. It looks like a load timeout, and I did not run it here.
The terminal needs no change: live=1 and week=1 are web address shortcuts for live:yes and updated:7d, which the terminal's search line already accepts. A No door: line in an earlier commit records that for the gate.
To try it: open /explore?live=1&week=1 on the preview.
<!-- look-pages 6414b0045de5 --> Look pages for 6414b00, from the gate:
look pages (inferred): this pull changes src/web/studio/explore.ts; the forge pictures /explore (src/web/studio/explore.ts), the pages whose routes import it. A "Looks: <path>" or "No look: <why>" line in a commit message overrides
No change is needed for this feedback. @trevato's comment is the gate's automatic note that it will picture /explore, because this pull changes src/web/studio/explore.ts. It asks for nothing.
I added no Looks: or No look: line, because the inferred page is the right one. This pull edits the explore page and nothing else, so I made no commit and pushed nothing.
The branch is still at 6414b0045. That head has the quick-filter links, the explore row in the attention budget raised to 45 words and 10 blocks, and the No door: line recorded in an earlier commit. To try it, open /explore?live=1&week=1 on the preview.
The filters work on the preview: ?live=1&week=1 narrows, both links show aria-current when on, the sort is kept, bad values are ignored. Changes for one round, first one first:
- The new link group has no accessible name. Kind is a nav labelled 'Kind'; this seg is a bare div, so a screen reader hears two unlabelled links after the Kind tabs. Give the group a name ('Quick filters') and say what Live now means.
- 'Changed this week' is the existing 'This week' (since=7d) already one tap away under 'Sort and time'. Two controls for the same filter on one page breaks principle 1 (nothing explains itself twice). Either reuse that one and promote it, or drop the duplicate in the disclosure.
- docs/features/explore.md is the how-to and its parameter table (live=yes, since=7d) does not mention live=1, week=1 or the two links. Add them there; the how-to belongs in the feature doc.
- The attention budget was raised (43->45 words, 10 blocks) to fit the change. The direction is pipeline first and this is a feature that grows the first view; point 2 would give back the block and words, so do that and restore the budget rather than raise it.
- The branch carries an empty 'Try:' commit; fold it into a real one.
Not a block: the terminal already takes live:yes and updated:7d, so a No-door note is fair. Live means awake in the last 30 days, not a deployment up now; the issue says running deployment, so say so in the doc.
Pushed 71ba3fa0a, addressing four of the five points; the empty Try: commit is still on the branch (point 5). live=1&week=1 still narrows, and the explore, attention-budget and a11y-landmarks tests pass, as do tsc and design-lint.
What changed
- Duplicate removed (2, 4). The "Changed this week" link is gone; the existing "This week" (
since=7d) under Sort and time is the one control.week=1still works as an address, so?live=1&week=1reloads the same and "This week" showsaria-current. - Live now moved into the disclosure (1, 4). It sits under Sort and time in a
role="group"named "Live now: awake in the last 30 days", so it has a name and says what it means. The disclosure now opens whenliveis on. I moved it there instead of promoting a "This week" link to the first view, because that would still add a block above the fold. The attention budget is back to 43 words and 9 blocks, with the #14481 note removed. - Feature doc updated (3).
docs/features/explore.mdnow listslive=1and0,week=1and the Live now link in the parameter table. It also says Live means awake in the last 30 days, not a deployment up now. It adds a short note that the terminal already takeslive:yesandupdated:7d. - Tests. The quick-filters test now asserts one "This week" control, no "Changed this week", and the group's name.
Not done
- The empty
Try:commit (5). Folding it in means rewriting history, which needs a force push, and force pushes are refused here. Squash the pull on merge, or say so and a person can drop it. - Full test suite.
scripts/fast.tsfound the diff too broad to name tests, so I ran the explore, attention-budget and a11y-landmarks tests, not the whole suite.
[
{"go": "/explore?kind=app&live=1&week=1", "look": "Sort and time is open: Live now and This week both show as current", "expect": "only apps awake in the last 30 days and changed this week; no 'Changed this week' link anywhere"},
{"go": "/explore", "look": "the first view beside the Kind tabs", "expect": "no extra links there; Live now is inside Sort and time"}
]<!-- look-pages e448db468597 --> Look pages for e448db4, from the gate:
look pages (named): this pull changes src/web/studio/feed.ts; a commit names /
No code change this round, and nothing was pushed. The gate's note describes a different diff from this branch.
- The note. It says this pull changes
src/web/studio/feed.tsand that a commit names/. Neither is true here. The diff againstorigin/maintouches onlydocs/features/explore.md,src/actions/explore.ts,src/web/studio/explore.tsandtest/explore-quick-filters.test.ts. No commit message carries aLooks:line. - The page. The only page this pull changes is
/explore, which the gate had already inferred as the look page for the earlier push. The note may have been written for a stale head (e448db4), since the branch is at71ba3fa0a. - The release hold. The desk note says production is rolling and changes to it should wait. This pull goes to a preview, not production, and I did not push anything. A person merges it, so they can hold the merge until the release settles.
The description from my previous message stands unchanged.
The change presented at this head is not the one this pull is titled for. It adds reply counts to feed posts (src/feed/replies.ts, src/feed/feed.ts, src/tui/screens/feed.ts, src/web/studio/feed.ts, docs/features/feed-reply-count.md, test/feed-reply-count.test.ts, citing #14555). It touches nothing under /explore, so none of the four boxes of #14481 is met by it. The builder describes explore edits (src/actions/explore.ts, src/web/studio/explore.ts, test/explore-quick-filters.test.ts) that are not in this diff, and the clone has no commit 6414b00. The earlier asks (one This week control, Live now in the disclosure, feature doc, attention budget) cannot be checked against this head. Fix first: make the pull head carry the explore quick-filter change and only that; move the feed reply-count work to its own pull for #14555. Non-blocking, for that separate pull: the reply link is a plain a, good, and the count is one grouped query, good; the Both-doors check is met by replyMark in the TUI. I did not review the feed change in depth for the same reason: it does not belong here.
I disagree with the review and pushed nothing this round. The forge API reports this pull's head as 71ba3fa0aefa7bedea757d928a108dd6ed58b0ba, and that commit carries only the explore quick-filter change. The reply-count files the review lists are not on this branch, and e448db4 (the commit the gate's look-pages note names) does not exist in this clone or on the branch. The review was most likely made against another pull's head; #14555's work belongs in its own pull, and none of it is here.
What the head actually changes, base 74eea2ea0 to head 71ba3fa0a:
src/actions/explore.ts:?live=1and0are read as yes and no, and?week=1meansupdated:7d. A value it does not know is ignored, not an error.src/web/studio/explore.ts: one "This week" control, the existingsince=7dlink under Sort and time; "Changed this week" is gone. "Live now" sits in the same disclosure, in arole="group"named "Live now: awake in the last 30 days". The disclosure opens whenliveis on, the link showsaria-currentwhen active, and it keeps the sort.docs/features/explore.md: the parameter table listslive=1/0,week=1and the Live now link. It says Live means awake in the last 30 days, not a deployment up now, and that the terminal already takeslive:yesandupdated:7d.test/explore-quick-filters.test.ts: covers the address forms, the two filters together, bad values ignored, one "This week" control and the group's name.
docs/design/attention-budget.json is identical to the base, back at 43 words and 9 blocks.
The empty Try: commit e195a84ef is still on the branch: removing it needs a force push, which is refused here. Squashing on merge drops it.
On the last push the explore, attention-budget and a11y-landmarks tests passed, as did tsc and design-lint. Not the whole suite: scripts/fast.ts found the diff too broad to name tests.
[
{"go": "/explore?kind=app&live=1&week=1", "look": "Sort and time is open; Live now and This week both show as current", "expect": "only apps awake in the last 30 days and changed this week; no 'Changed this week' link anywhere"},
{"go": "/explore", "look": "the filter line beside the Kind tabs", "expect": "no new links on first view; Live now is inside Sort and time, in a group named for what it means"}
]
🤖 Generated with Claude Code
This pull adds "Live now" to /explore and makes ?live=1 and ?week=1 work as address forms; the branch carries that change and nothing else. Against current main, the pull now touches only the explore code, docs and test listed below.
The previous review was looking at feed reply-count work (#14555). That work was never on this branch: it landed on main separately as #14570 (42e919a1c). Neither e448db4 nor src/feed/replies.ts was ever on this branch. To give the pull a fresh head against today's base, I merged main into the branch as b1531df42. The merge had no conflicts and leaves the diff explore-only.
What changed
src/actions/explore.ts:?live=1and?live=0are read as yes and no.?week=1meansupdated:7d, and anupdatedorsincegiven beside it wins. A value it does not know is ignored, never an error.src/web/studio/explore.ts: "This week" (since=7d) under Sort and time is the only week control; the duplicate "Changed this week" link is gone.- "Live now" sits in the same disclosure, in a
role="group"named "Live now: awake in the last 30 days". - The disclosure opens when
liveis on. - The link shows
aria-currentwhen active, takes the filter off when clicked again, and keeps the sort.
- "Live now" sits in the same disclosure, in a
docs/features/explore.md: the parameter table now listslive=1/0,week=1and the Live now link. It says Live means awake in the last 30 days, not a deployment up right now. It also notes the terminal needs no change, because its search line already takeslive:yesandupdated:7d.test/explore-quick-filters.test.ts: covers the address forms, the two filters together, bad values being ignored, the single "This week" control and the group's name.
Not changed
- Attention budget:
docs/design/attention-budget.jsonis unchanged from main, at 43 words and 9 blocks, because nothing new appears on first view. - Empty
Try:commit:e195a84efis still on the branch. Removing it means rewriting history, which needs a force push, and force pushes are refused here. Squashing on merge drops it.
Checks
tsc --noEmitand design-lint are clean.- The explore and attention-budget tests pass (21 pass, 0 fail).
scripts/fast.tssaid the diff was too broad to name tests, so I picked those files myself. gate.ts --fixflagged two test helpers (getandnamesin the new test) as similar to helpers in other test files. That is advisory, and I left them as they are.
Release hold: a desk note says production is rolling and changes should wait until it settles. This push only updates the preview; merging is a person's call and can wait for the release.
[
{"go": "/explore?kind=app&live=1&week=1", "look": "Sort and time is open; Live now and This week both show as current", "expect": "only apps awake in the last 30 days and changed this week; no 'Changed this week' link anywhere"},
{"go": "/explore", "look": "the filter line beside the Kind tabs", "expect": "no new links on first view; Live now is inside Sort and time, in a group named for what it means"}
]
🤖 Generated with Claude Code
<!-- look-pages b1531df42627 --> Look pages for b1531df, from the gate:
look pages (inferred): this pull changes src/web/studio/explore.ts; the forge pictures /explore (src/web/studio/explore.ts), the pages whose routes import it. A "Looks: <path>" or "No look: <why>" line in a commit message overrides
/explore gets a "Live now" link, and ?live=1 and ?week=1 now work in the address. Together they narrow the page to apps that are awake and changed this week, and the view survives a reload. Week has one control, the existing "This week" link (since=7d), so the page still fits its 43-word, 9-block first-view budget.
What changed
src/actions/explore.ts:?live=1and?live=0are read as yes and no, and?week=1meansupdated:7d. If the address also has an explicitupdatedorsince, that one wins. A value it doesn't know, likelive=maybeorweek=soon, is ignored: no redirect, no narrowing, no error. The filter runs on the rows already ranked in memory, so there is no extra query per row.src/web/studio/explore.ts: "Live now" is in the Sort and time disclosure, in arole="group"named "Live now: awake in the last 30 days".- The disclosure opens when
liveis on. - The link shows
aria-currentwhen active and clicking it again turns the filter off. It keeps the current sort, kind and page filters. - "This week" shows as active for
week=1too.
- The disclosure opens when
docs/features/explore.md: the parameter table listslive=1/live=0,week=1and the Live now link.test/explore-quick-filters.test.ts: covers each address form, both filters together, bad values being ignored, a single "This week" control, the group's name, and the links' active state and sort.
Not done
- "Live" means what it already meant: awake in production at some point in the last 30 days, not a deployment that is up right now.
- No terminal change: the terminal's search line already accepts
live:yesandupdated:7d, and an earlier commit'sNo door:line records this for the gate. - The removable-chips row is unchanged.
- The empty
Try:commit is still on the branch, because removing it would need a force push.
Latest review round: the gate's note for b1531df infers /explore as the page to picture. That is the only page this pull changes, so I added no Looks: or No look: line and pushed nothing. The check on b1531df passed, with looks taken at phone, narrow and desktop sizes. The five test files it reported red are red on main at 3dfbd46, not caused by this pull.
To try it: open /explore?live=1&week=1 on the preview, or open Sort and time and click "Live now" and "This week".
[
{"go": "/explore", "look": "the Sort and time disclosure", "expect": "one 'This week' link and a 'Live now' link inside a group named 'Live now: awake in the last 30 days'"},
{"go": "/explore?live=1&week=1", "look": "the result list and the two links", "expect": "only apps awake in the last 30 days and changed this week; the disclosure is open and both links show as active"},
{"go": "/explore?live=maybe", "look": "the result list", "expect": "the same as plain /explore, with no error and no redirect"}
]
🤖 Generated with Claude Code
Earlier asks are met: the duplicate "Changed this week" link is gone ("This week" is the one week control), Live now sits in a named group inside Sort and time, the disclosure opens when live is on, the attention budget is unchanged, and the how-to is in docs/features/explore.md, not README. The later head is a clean merge of main, so the diff stays explore-only. The preview answers 200 for ?live=1&week=1 with the Live now link and its group name, and 200 for ?live=maybe&week=soon with no redirect. Next, non-blocking: (1) Non-blocking: squash on merge to drop the empty Try: commit. (2) Non-blocking: the Live now link is a one-item segmented group, so a plain toggle link would be lighter markup.
/explorenow has two plain links, "Live now" and "Changed this week", and?live=1and?week=1work in the address. The issue's two named files were the wrong ones.src/web/pages/explorer.tsis the code-browser file column, andtest/explorer-filters.test.tscoversmin_forks. So I changed the real explore code insrc/actions/explore.tsandsrc/web/studio/explore.ts, and addedtest/explore-quick-filters.test.ts.Most of this already existed on main as
live:yesandupdated:7d.What changed
?live=1or?live=0is read as yes or no, and?week=1meansupdated:7d.aria-current) when on. Clicking one toggles it off. Each link keeps the current sort, kind and page filters, and the address alone restores the view on reload.live=maybe,week=soonand similar are ignored, with no redirect and no narrowing. This covers the separate parameters only. A bad word typed into theqline still gets the existing 422 note, and I left that alone.What I chose not to do
data-filter-chips, which existing tests assert.gate,tscanddesign-lintran clean.scripts/fast.tscalled the diff too broad to name tests, so I picked those seven by hand.To try it, open
/explore?kind=app&live=1&week=1, or tap the two links.🤖 Generated with Claude Code
Closes #14481