How advx2026/return works
ReTurn is a local-first personal context assistant: sampler processes gather work traces, the Apple client lets people review history, ask questions, save context and resume, and a home server stores data and performs search and AI workflows. The main daily path is capture → server ingestion → timeline/search and conversation → Save → overnight briefing → return. README documents the major product capabilities and LAN boundary; source excerpts confirm selected API, search, persistence and meeting-task links. Unsampled subsystem links are limited to documented relationships.
Main entry points: routes.ts API routes · APIClient.swift API transport · query.ts Hybrid search · repo.ts Domain repository
Components 21
Capture
- Activity sources
packages/sampler/src/sources - Sampler runtime
packages/sampler/src/index.ts - Offline outbox
packages/sampler/src/outbox.ts
Apple client
- Apple app
clients/apple/ReTurn/App/ReTurnApp.swift - API transport
clients/apple/ReTurn/Core/Networking/APIClient.swift - Connection setup
clients/apple/ReTurn/Core/Networking/APIEnvironment.swift - Before timeline
clients/apple/ReTurn/Features/Timeline/Shared/Stores/TimelineStore.swift - Now conversation
clients/apple/ReTurn/Features/Home/Shared/Stores/ChatStore.swift - After cards
clients/apple/ReTurn/Features/After/Shared/CardsStore.swift - Health signals
clients/apple/ReTurn/Features/Health/Shared/Stores/HealthStore.swift
Home server
- HTTP service
packages/server/src/app.ts - API routes
packages/server/src/routes.ts - SQLite store
packages/server/src/db/schema.ts - Domain repository
packages/server/src/db/repo.ts
Context workflows
- Hybrid search
packages/server/src/search/query.ts - Chat and resume
packages/server/src/services/chat.ts - Save and ferment
packages/server/src/services/save.ts - Meeting task queue
packages/server/src/services/meeting-tasks.ts - Timeline statistics
packages/server/src/stats/compute.ts
Other components
- User
- Model services
Connections 24
- User → Apple app: uses
- Activity sources → Sampler runtime: supplies traces
- Sampler runtime → Offline outbox: buffers offline
packages/sampler/src/index.ts - Sampler runtime → HTTP service: uploads traces
- Apple app → API transport: requests data
- Connection setup → API transport: configures access
clients/apple/ReTurn/Core/Networking/APIEnvironment.swift - API transport → HTTP service: calls over LAN
- HTTP service → API routes: registers routes
packages/server/src/app.ts - API routes → Domain repository: reads and writes
packages/server/src/routes.ts - Domain repository → SQLite store: queries
packages/server/src/db/repo.ts - API routes → Hybrid search: dispatches search
packages/server/src/routes.ts - Hybrid search → Domain repository: loads matches
packages/server/src/search/query.ts - API routes → Chat and resume: dispatches chat
packages/server/src/routes.ts - API routes → Save and ferment: dispatches Save
packages/server/src/routes.ts - API routes → Meeting task queue: starts tasks
packages/server/src/app.ts - Meeting task queue → Domain repository: persists results
packages/server/src/services/meeting-tasks.ts - API routes → Timeline statistics: requests statistics
packages/server/src/routes.ts - Before timeline → API transport: loads history
- Now conversation → API transport: sends questions
- After cards → API transport: loads suggestions
- Health signals → API transport: syncs health
- Chat and resume → Hybrid search: retrieves context
- Save and ferment → Model services: ferments context
- Hybrid search → Model services: embeds queries