---
title: Roadmap
updated: 2026-03-24
---

## API: Constellation Integration

Add a Constellation client to the Go API for enriching search results with social signals.

- [x] Constellation XRPC client (`internal/constellation/`) with `getBacklinksCount` and `getBacklinks`
- [x] User-agent header with project name and contact
- [x] Enrich search results with star counts from Constellation
- [x] Profile summary endpoint (`GET /profiles/{did}/summary`) with follower/following counts from Constellation
- [x] Cache Constellation responses with short TTL (star/follower counts change infrequently)

## API: Semantic Search Pipeline

Nomic Embed Text v1.5 via Railway template, async embedding pipeline.

- [ ] Deploy nomic-embed Railway template (`POST /api/embeddings` with Bearer auth)
- [ ] Embedding client in Go API (`internal/embedding/`) calling the Nomic service
- [ ] Embed-worker: consume `embedding_jobs` queue, generate 768-dim vectors, store in `document_embeddings`
- [ ] `GET /search/semantic` endpoint using DiskANN vector_top_k
- [ ] Reembed command for bulk re-generation

## API: Hybrid Search

Combine keyword and semantic results.

- [ ] Score normalization (keyword BM25 → [0,1], semantic cosine → [0,1])
- [ ] Weighted merge (0.65 keyword + 0.35 semantic, configurable)
- [ ] Deduplication by document ID
- [ ] `matched_by` metadata in results

## API: Search Quality

- [ ] Field weight tuning based on real queries
- [ ] Recency boost for recently updated content
- [ ] Star count ranking signal (via Constellation)
- [ ] State filtering defaults (exclude closed issues)
- [ ] Better snippets with longer context
- [ ] Relevance test fixtures

## API: Observability

- [ ] Structured metrics: ingestion rate, search latency, embedding throughput
- [ ] Dashboard or log-based monitoring

## App: Search & Discovery

Wire the Explore tab to the search API and add activity feed.

**Depends on:** API: Constellation Integration

- [x] Search service pointing at Twister API
- [x] Constellation service for star/follower counts
- [x] Debounced search on Explore tab with segmented results
- [x] Recent search history (local)
- [x] Graceful fallback when search API unavailable
- [x] Activity feed data source investigation (Jetstream vs polling)
- [x] Activity tab with filters, infinite scroll, pull-to-refresh
- [x] Home tab: surface recently viewed repos/profiles

## App: Authentication & Social

Bluesky OAuth and authenticated actions.

**Depends on:** App: Search & Discovery (for Constellation service), API: Constellation Integration

- [ ] OAuth setup with `@atcute/oauth-browser-client`
- [ ] Login page, OAuth flow, callback handling
- [ ] Capacitor deep link configuration
- [ ] Session management (restore, refresh, logout, account switcher)
- [ ] Auth-aware XRPC client using dpopFetch
- [ ] Star repos (write to PDS, count from Constellation)
- [ ] Follow users (write to PDS, count from Constellation)
- [ ] React to content (write to PDS, count from Constellation)
- [ ] Authenticated profile tab (pinned repos, stats, starred, following)
- [ ] Personalized feed ("For You" / "Global" toggle)

## App: Write Features

**Depends on:** App: Authentication & Social

- [ ] Create issue (title + markdown body)
- [ ] Comment on issues and PRs (threaded)
- [ ] Close/reopen issues
- [ ] Edit profile (bio, links, avatar, pinned repos)
- [ ] OAuth scope upgrade flow

## App: Offline & Performance

**Depends on:** App: Search & Discovery (for cache persistence of search/feed data)

- [ ] Dexie setup with database schema (query cache + pinned content tables)
- [ ] TanStack Query persister backed by Dexie
- [ ] Pinned content store (save/unsave files for offline reading)
- [ ] Pinned files UI (list, pin/unpin actions on file viewer, last-fetched timestamp)
- [ ] Offline detection and banner
- [ ] Secure token storage (Capacitor Secure Storage)
- [ ] Cache eviction (per-type limits and TTL, pinned content exempt)
- [ ] List virtualization for large datasets
- [ ] Lazy-load avatars, prefetch on hover
- [ ] Code splitting and bundle optimization (target <500KB JS)

## App: Real-Time & Advanced

**Depends on:** App: Authentication & Social, App: Offline & Performance

- [ ] Jetstream integration for live `sh.tangled.*` events
- [ ] Live UI indicators (new commits, new feed items, PR status)
- [ ] Custom feed presets ("My repos", "Watching", "Team")
- [ ] Repo forking
- [ ] Labels (display, filter, manage)
- [ ] Expanded reactions with emoji picker
- [ ] PR interdiff (compare rounds)
- [ ] Knot info display

## App: Push Notifications

**Depends on:** App: Authentication & Social

- [ ] Register device token on login
- [ ] Subscribe to relevant events
- [ ] Deliver via APNs/FCM
- [ ] Handle notification taps (deep link to relevant screen)