feat: signal source abstraction — generalize beyond Todoist #78

New Issue

alvis · 2026-04-16T15:25:11Z

alvis commented

2026-04-16 15:25:11 +00:00

Motivation

Currently the recommender is hard-wired to Todoist. To support Google Calendar, Apple Health, manual input, and AI-generated advice, we need a SignalSource interface that normalizes heterogeneous data into a common signal stream.

Design

interface SignalSource {
  id: string;                    // e.g. 'todoist', 'google-calendar', 'manual'
  fetchSignals(userId: string): Promise<Signal[]>;
  act?(userId: string, signalId: string, action: string): Promise<void>;
}

interface Signal {
  id: string;
  source: string;
  kind: 'task' | 'event' | 'habit' | 'insight';
  content: string;
  metadata: Record<string, unknown>;
  features: Record<string, number | boolean>;
  timestamp: string;
}

Tasks

Define SignalSource interface in packages/shared-types
Refactor Todoist fetcher to implement SignalSource
Create SignalAggregator that merges signals from all connected sources
Update recommender to consume Signal[] instead of CachedTask[]
ADR for signal normalization strategy

## Motivation Currently the recommender is hard-wired to Todoist. To support Google Calendar, Apple Health, manual input, and AI-generated advice, we need a `SignalSource` interface that normalizes heterogeneous data into a common signal stream. ## Design ```typescript interface SignalSource { id: string; // e.g. 'todoist', 'google-calendar', 'manual' fetchSignals(userId: string): Promise<Signal[]>; act?(userId: string, signalId: string, action: string): Promise<void>; } interface Signal { id: string; source: string; kind: 'task' | 'event' | 'habit' | 'insight'; content: string; metadata: Record<string, unknown>; features: Record<string, number | boolean>; timestamp: string; } ``` ## Tasks - [ ] Define `SignalSource` interface in `packages/shared-types` - [ ] Refactor Todoist fetcher to implement `SignalSource` - [ ] Create `SignalAggregator` that merges signals from all connected sources - [ ] Update recommender to consume `Signal[]` instead of `CachedTask[]` - [ ] ADR for signal normalization strategy

alvis added this to the M2 — AI tips + multi-source signals milestone 2026-04-16 15:25:11 +00:00

alvis referenced this issue from a commit

2026-04-24 15:10:18 +00:00

feat: SignalSource abstraction — generalize signal ingestion beyond Todoist (#78)

alvis closed this issue

2026-04-25 17:15:46 +00:00

alvis referenced this issue from a commit

2026-04-26 12:08:52 +00:00

fix(signals): add missing source field to TaskSyncedEvent (#78)

alvis referenced this issue from a commit

2026-04-26 12:08:52 +00:00

docs(services): update integrations + recommender READMEs for signal abstraction (#78)