[quickbeard]

Pin leads every session's ⋮ / ⋯ menu and reads Unpin once set. Pinned sessions move out of Recents into a Pinned section above it, and the View all list grows a matching Pinned group above Today.

Projects                     Rename                  Pin
  my-project                 Share...                ─────────────
                     →       Archive          →      Rename
Pinned                       ─────────────           Share...
  Fix scroll state           Delete                  Archive
                                                     ─────────────
Recents                                              Delete
  Session B
  View all

Pinned is a second SidebarSection, not a new one

It is the same component Recents renders, passed name="pinned" — the header toggle, chevron, aria-expanded, keyboard operability and 28px folded height all come along unduplicated. Its collapse state slots into the same Persist.global("sidebar.sections") record, which was already keyed by section name for exactly this: no new stored key, no migration, and the two fold independently.

The one addition to the shared component is a grow?: boolean. It hard-coded flex-1 when open, which was right while Recents was the only section but would have had two open sections halve the column. Pinned passes grow={false} and sizes to its rows, scrolling past five, so Recents can never be squeezed out.

Where the pins live

A fork-only context/pinned-sessions.tsx, not state inside createHomeModel(). The sidebar and the home screen each hold their own model, so two persisted stores over one key would write the same storage without sharing memory — a pin in the sidebar would not reach View all until a reload. Same reason the project selection already lives in useLayout().

Ids are keyed by server (session ids are only unique within one), ordered newest-pin-first so a pinned row does not reshuffle when its session is touched, and resolved through the records list — which drops pins whose session was deleted elsewhere and keeps the stored list self-healing. Deleting a session drops the pins of its whole subtree.

The Pinned list is keyed by session id, matching what #185 did for the other two lists: it renders the same rebuilt record wrappers, so a reference-keyed <For> would have given its rows the first-click defect that PR removed.

Tests

Unit tests for orderPinnedRecords / togglePinnedIDs (pin order over recency, unresolvable ids dropped, no duplicates, no mutation), and e2e for: pin moves the row and persists across reload, the label swaps to Unpin and unpinning restores it, Pin leads the menu, Pinned hugs its rows instead of halving the column, the View all group, and both sections folding independently.

All 8 new or changed assertions were run against the pre-change source and fail there, with the pre-existing collapse tests still passing.

Divergences

Four upstream files change — home.tsx (the pinned group), message-timeline.tsx (header menu), layout-new.tsx (provider) and the en/es dicts — under one DIVERGENCES.md row, filed beside the two existing home.tsx rows. Its on-conflict note flags the one thing that would silently break: the header must resolve the pin's server key the same way the sidebar's selection does, or one user's pins split in two.

Rebased onto main

#185, #186 and #188 have since landed. Rebased with four conflicts resolved:

• app-sidebar-rows.ts — both sides had added an identical fitsRecentsRow. Kept main's, with a note that Pinned lifts the thresholds ~60px while expanded.
• app-sidebar.tsx — took main's id-keyed Recents <For>, and applied the same keying to the new Pinned list, which the rebase would otherwise have left reference-keyed and therefore first-click broken.
• sidebar-section-collapse.spec.ts — merged the two height sweeps, keeping 440 since Pinned raises the clipping threshold.
• CHANGELOG.md — docs: fold the seven sidebar entries into one #188 had folded the older entries into the 1.18.4-8 sidebar entry, so my duplicate "half-cut View all" entry is gone (that fix shipped in fix(app): open session row menus on the first click, and stop clipping View all #185) and the Pin copy is now folded into that same entry rather than standing alone: the Pinned section joins the sections narrative, Pin joins the row-menu list, and feat(app): pin sessions to a Pinned section above Recents #189 joins its PR list. ## Unreleased is left empty, as docs: fold the seven sidebar entries into one #188 left it.

Both earlier caveats are now moot — the clipping guard is on main, and pin/unpin opens on the first click.

Verification (rebased onto #190)

• bun typecheck (packages/app) — clean
• bun test (packages/app) — 638 pass
• bun test:e2e:local — 130 passed, 0 failed. The two remote-session-settings failures every earlier run reported are gone: fix(app): press the settings shortcut the modifier the page expects #190 fixed them, and this branch now sits on top of it.
• bun lint — 4746 warnings + 1 error, identical to main's baseline

🤖 Generated with Claude Code