feat(web): add story filtering and number jump

[Bobbyap72]

web: add title filter and number-jump on the Stories board (#104)

Adds a client-side filter box on the Stories page that narrows
visible stories by title match, and lets a bare story number jump
straight to that story. Numbers already on the board resolve
locally; numbers outside the board's 7-day window fall back to
GET /v1/projects/:projectId/stories/:number.

Known gap: the 409 ambiguous_story_number response doesn't
currently return the candidate repos, so ambiguous numbers show
a message rather than a repo picker. Extending that response is
a natural follow-up, kept out of this PR to stay scoped to
apps/web.

[adrian-lorenzo]

Thanks for the contribution!

Story-number jumps need to handle duplicates before this can merge. localMatch uses the first matching story, so if two repositories have the same number, pressing Enter can silently open the wrong one. Off-board duplicates also leave the user without a working way to choose a repository. Please make ambiguous matches explicit and add tests covering both local and API ambiguity.

The branch also conflicts with main. When rebasing, please preserve the Builder plan policy by passing builderPlanRequired through StoriesBoard to each IssueRow. Please also distinguish API failures from a genuine 404, fix the import ordering, and update the title and commit subject to an allowed Conventional Commit such as feat(web): add story filtering and number jump.

With those changes, we can approve and merge it!

[Bobbyap72]

Thanks for the thorough review — pushed a rebased, squashed commit addressing all six points:

1. Ambiguity handling: both local and off-board duplicates are now explicit, not silently resolved to the first match. Locally, resolveLocalJump reports ambiguous if two repos on the board share a number. Off-board, the 409 response from /stories/:number now includes the candidate repos (repoId/repoOwner/repoName/storyType) — the UI renders a real picker instead of a dead-end message. Covered by apps/web/test/story-jump.test.ts.
2. Rebased onto current main.
3. builderPlanRequired now threaded through StoriesBoard → IssueRow.
4. API failures vs. genuine 404: interpretJumpResponse now distinguishes a real 404 from a 5xx/network failure — the UI says "couldn't check" rather than implying non-existence.
5. Import ordering fixed via pnpm exec biome check --write.
6. Title/commit updated to feat(web): add story filtering and number jump.

One note on scope: this does touch services/api now (the 409 response body), beyond the original apps/web-only plan — necessary since building a real picker needed the candidate data the API wasn't returning.

Also flagging: pnpm --filter @facility/api typecheck currently reports 43 pre-existing errors on main (missing builderPlanPolicy/workspaceBaseSha types, traced to #205). Confirmed unrelated by running the identical typecheck against a clean upstream/main checkout — same 43 errors, same files/lines, before any of this branch's changes were applied. Not touched here to keep this PR to one intent.

[Bobbyap72]

Confirmed the title and commit subject landed correctly:

$ gh pr view 150 --repo theam/facility --json title,commits --jq '.title, .commits[-1].messageHeadline'
feat(web): add story filtering and number jump
feat(web): add story filtering and number jump

Ready for another look whenever you get a chance.

[Bobbyap72]

Good Morning Adrián, Thanks for that. Pushed a rebased, squashed commit addressing all six points, plus a couple of follow-up comments on the PR with details and verification output. Ready for your review, whenever it works for you. Thanks, Bobby AP

…

On Thu, Aug 27, 2026 at 3:41 PM Adrián Lorenzo ***@***.***> wrote: ***@***.**** requested changes on this pull request. Thanks for the contribution! Story-number jumps need to handle duplicates before this can merge. localMatch uses the first matching story, so if two repositories have the same number, pressing Enter can silently open the wrong one. Off-board duplicates also leave the user without a working way to choose a repository. Please make ambiguous matches explicit and add tests covering both local and API ambiguity. The branch also conflicts with main. When rebasing, please preserve the Builder plan policy by passing builderPlanRequired through StoriesBoard to each IssueRow. Please also distinguish API failures from a genuine 404, fix the import ordering, and update the title and commit subject to an allowed Conventional Commit such as feat(web): add story filtering and number jump. With those changes, we can approve and merge it! — Reply to this email directly, view it on GitHub <#150?email_source=notifications&email_token=BSPX7VAM5ZGWAHAELHRMRF35MBCDNA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTKMBUGIYTANBZGQ42M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KYZTPN52GK4S7MNWGSY3L#pullrequestreview-5042104949>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BSPX7VGDUY4TDUSHSYLSPGD5MBCDNAVCNFSNUABGKJSXA33TNF2G64TZHMYTENRXGI2DQNZQGA5US43TOVSTWNJRGUYDCOJWG44TNILWAI> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/BSPX7VHCGR5GIN7PD3XUXKT5MBCDNA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTKMBUGIYTANBZGQ42M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KUZTPN52GK4S7NFXXG> and Android <https://github.com/notifications/mobile/android/BSPX7VBYODIUWKMBBVW6IMT5MBCDNA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTKMBUGIYTANBZGQ42M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2K4ZTPN52GK4S7MFXGI4TPNFSA>. Download it today! You are receiving this because you authored the thread.Message ID: ***@***.***>

[adrian-lorenzo]

Thanks for the thoughtful revision!

The original issues are addressed, but the off-board lookup still has a race. If someone submits one number and then changes or submits another before the first request completes, the older response can arrive last and navigate them to the wrong story or overwrite the current status. Please cancel superseded requests or ignore their responses, and add a component-level regression covering out-of-order responses.

Please also announce the asynchronous lookup result through an aria-live region, use links for the repository choices, and extend the API integration test to verify the 409 response’s matches data that the picker now depends on.

With those small improvements, this should be ready to approve.

[Bobbyap72]

Dear Adrián, Good Evening! Thanks for the follow-up review. Pushed fixes for all four points, plus a couple of comments on the PR with the details and verification. Please check it out, at your convenience. Thanks, Bobby AP

…

On Fri, Aug 28, 2026 at 1:13 PM Adrián Lorenzo ***@***.***> wrote: ***@***.**** requested changes on this pull request. Thanks for the thoughtful revision! The original issues are addressed, but the off-board lookup still has a race. If someone submits one number and then changes or submits another before the first request completes, the older response can arrive last and navigate them to the wrong story or overwrite the current status. Please cancel superseded requests or ignore their responses, and add a component-level regression covering out-of-order responses. Please also announce the asynchronous lookup result through an aria-live region, use links for the repository choices, and extend the API integration test to verify the 409 response’s matches data that the picker now depends on. With those small improvements, this should be ready to approve. — Reply to this email directly, view it on GitHub <#150?email_source=notifications&email_token=BSPX7VFEOQVIP434MO7QQ3D5MFZP3A5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTKMBVGA4TKMZXGQ2KM4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KYZTPN52GK4S7MNWGSY3L#pullrequestreview-5050953744>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BSPX7VGHX5ZHL4ZMMS22C4T5MFZP3AVCNFSNUABGKJSXA33TNF2G64TZHMYTENRXGI2DQNZQGA5US43TOVSTWNJRGUYDCOJWG44TNILWAI> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/BSPX7VBBLMRZZWGGW3DCU235MFZP3A5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTKMBVGA4TKMZXGQ2KM4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KUZTPN52GK4S7NFXXG> and Android <https://github.com/notifications/mobile/android/BSPX7VENDAIASLOZV2CBPKD5MFZP3A5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTKMBVGA4TKMZXGQ2KM4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2K4ZTPN52GK4S7MFXGI4TPNFSA>. Download it today! You are receiving this because you authored the thread.Message ID: ***@***.***>