Discovery: follows wiring, who-to-follow, search, trending, per-user feed sharding

[iduartgomez]

Workstream split out from tracking #8.

Scope

• Wire follows contract to UI. Remove // TODO: wire to follows contract at web/src/components/post-card.ts:130.
• Real "who to follow" backed by follows graph (2nd-degree connections, popularity). Replaces mock data in web/src/components/right-panel.ts.
• Search: handles + post content. See design issue for client-side scan vs. dedicated index contract.
• Trending topics: hashtag extraction + counting contract. Replaces mock trending data.
• Per-user posts contract sharding so feeds scale (instead of one global posts contract keyed by __MODEL_CONTRACT__). Subscribe to followed users' contracts.

Dependencies

• Per-user posts sharding depends on the per-user contract model from the Users / identity workstream.
• Search and trending may depend on design decisions (index contracts).
• Wire-follows-to-UI is the smallest unit and can ship independently.

References

• web/src/components/post-card.ts:130 — follow-button TODO.
• web/src/components/right-panel.ts — mock who-to-follow + trending.
• web/src/freenet-api.ts:95 — __MODEL_CONTRACT__ single-contract subscription point.
• contracts/follows/src/lib.rs — existing follow graph contract.

Parent: #8

[iduartgomez]

Status update (2026-05-27): per-user feed sharding is DONE; stale refs.

The big-ticket item here — per-user posts contract sharding so feeds scale — landed in ADR-0001 Phase 4 (#30). The web app reads+writes a per-owner user shard keyed by blake3(code_hash || owner_VK_bytes). The global __MODEL_CONTRACT__ single-contract subscription point referenced here was removed in #33; contracts/follows/src/lib.rs was also removed (follows now live in the user shard, #26).

Remaining (unchanged in spirit, stale in refs):

• Subscribe to followed users' shards to assemble a following feed — gated on the fanout design in Design: "following" feed subscription strategy (fanout-on-read vs. fanout-on-write) #19.
• Who-to-follow, search, trending — still mock data, untouched by ADR-0001.

Update file refs: __MODEL_CONTRACT__ / contracts/follows are gone; follows graph is in contracts/user-shard + common/src/.

[iduartgomez]

Update from #40: Explore screen + Trending panel + Who-to-follow panel scaffolds shipped (editorial design). All show empty states until the discovery indexing comes online. Search input filters client-side over an empty array currently. Discovery data wiring + per-user feed sharding still open — keeping this issue open to track the backend.