mirror of
https://github.com/kennethnym/aris.git
synced 2026-03-20 09:01:19 +00:00
Kenneth
28d26b3c87
* feat: replace FeedItem.priority with signals Remove priority field from FeedItem and engine-level sorting. Add FeedItemSignals with urgency and timeRelevance fields. Update all source packages to emit signals instead of priority. Ranking is now the post-processing layer's responsibility. Urgency values are unchanged from the old priority values. Co-authored-by: Ona <no-reply@ona.com> * fix: use TimeRelevance enum in all tests Co-authored-by: Ona <no-reply@ona.com> --------- Co-authored-by: Ona <no-reply@ona.com>
57 lines
1.7 KiB
TypeScript
57 lines
1.7 KiB
TypeScript
/**
|
|
* Source-provided hints for post-processors.
|
|
*
|
|
* Sources express domain-specific relevance without determining final ranking.
|
|
* Post-processors consume these signals alongside other inputs (user affinity,
|
|
* time of day, interaction history) to produce the final feed order.
|
|
*/
|
|
export const TimeRelevance = {
|
|
/** Needs attention now (e.g., event starting in minutes, severe alert) */
|
|
Imminent: "imminent",
|
|
/** Relevant soon (e.g., event in the next hour, approaching deadline) */
|
|
Upcoming: "upcoming",
|
|
/** Background information (e.g., daily forecast, low-priority status) */
|
|
Ambient: "ambient",
|
|
} as const
|
|
|
|
export type TimeRelevance = (typeof TimeRelevance)[keyof typeof TimeRelevance]
|
|
|
|
export interface FeedItemSignals {
|
|
/** Source-assessed urgency (0-1). Post-processors use this as one ranking input. */
|
|
urgency?: number
|
|
/** How time-sensitive this item is relative to now. */
|
|
timeRelevance?: TimeRelevance
|
|
}
|
|
|
|
/**
|
|
* A single item in the feed.
|
|
*
|
|
* @example
|
|
* ```ts
|
|
* type WeatherItem = FeedItem<"weather", { temp: number; condition: string }>
|
|
*
|
|
* const item: WeatherItem = {
|
|
* id: "weather-123",
|
|
* type: "weather",
|
|
* timestamp: new Date(),
|
|
* data: { temp: 18, condition: "cloudy" },
|
|
* signals: { urgency: 0.5, timeRelevance: "ambient" },
|
|
* }
|
|
* ```
|
|
*/
|
|
export interface FeedItem<
|
|
TType extends string = string,
|
|
TData extends Record<string, unknown> = Record<string, unknown>,
|
|
> {
|
|
/** Unique identifier */
|
|
id: string
|
|
/** Item type, matches the data source type */
|
|
type: TType
|
|
/** When this item was generated */
|
|
timestamp: Date
|
|
/** Type-specific payload */
|
|
data: TData
|
|
/** Source-provided hints for post-processors. Optional — omit if no signals apply. */
|
|
signals?: FeedItemSignals
|
|
}
|