@sprinterai/runtime 0.6.0 → 0.8.0

package/dist/feed/digest.js

@@ -0,0 +1,273 @@
+import { validateFeedParams } from './filters.js';
+import { computeForYouScores } from './ranking.js';
+import { rowsToFeedItems } from './transformers.js';
+/**
+ * Resolve a daily digest of high-impact activities.
+ *
+ * Generates a summary of the most important activities from the past 24 hours.
+ * Useful for daily email digests, notifications, and summaries.
+ *
+ * Flow:
+ * 1. Query activities from the past 24 hours
+ * 2. Rank by importance + recency
+ * 3. Filter by score threshold (optional)
+ * 4. Select top N items
+ * 5. Compute summary statistics
+ * 6. Return FeedDigest with items and metadata
+ *
+ * @param store ActivityStore implementation
+ * @param config Digest configuration
+ * @returns FeedDigest with items and summary
+ * @throws Error if store query fails
+ */
+export async function resolveDigest(store, config) {
+    const { tenantId, digestLimit = 10, minScoreThreshold = 0.3, includeImportance = true, importanceWeight = 1.5, // Importance matters more in digests
+    recencyWeight = 1.0, entityId, actorId, action, } = config;
+    // Validate parameters
+    const { limit: digestLimitSafe } = validateFeedParams(digestLimit);
+    const { threshold } = validateFeedParams(undefined, minScoreThreshold);
+    // Query activities from past 24 hours
+    const now = new Date();
+    const yesterday = new Date(now.getTime() - 24 * 60 * 60 * 1000);
+    const queryOptions = {
+        limit: digestLimitSafe * 2, // Fetch extra to account for filtering
+        entityId,
+        actorId,
+        action,
+    };
+    const records = await store.listActivities(queryOptions);
+    // Filter to past 24 hours
+    const yesterdayTime = yesterday.getTime();
+    const recentRecords = records.filter((r) => new Date(r.created_at).getTime() >= yesterdayTime);
+    if (recentRecords.length === 0) {
+        return buildEmptyDigest(tenantId, new Date());
+    }
+    // Convert to FeedItems and rank
+    let items = rowsToFeedItems(recentRecords);
+    items = items.map((item) => {
+        const score = computeForYouScores({
+            createdAt: item.createdAt,
+            metadata: item.metadata,
+            importance: includeImportance ? extractImportanceFromMetadata(item.metadata) : undefined,
+            now,
+            recencyWeight,
+            importanceWeight,
+        });
+        return {
+            ...item,
+            score,
+        };
+    });
+    // Sort by score (highest first)
+    items = items.sort((a, b) => b.score - a.score);
+    // Filter by score threshold
+    const filteredItems = items.filter((item) => item.score >= threshold);
+    // Take top N
+    const digestItems = filteredItems.slice(0, digestLimitSafe);
+    // Build summary statistics
+    const summary = buildDigestSummary(digestItems);
+    // Generate email subject and preview
+    const emailSubject = buildDigestEmailSubject(summary, new Date());
+    const emailPreview = buildDigestEmailPreview(digestItems);
+    return {
+        date: now.toISOString().split('T')[0], // YYYY-MM-DD
+        tenantId,
+        items: digestItems,
+        summary,
+        emailSubject,
+        emailPreview,
+    };
+}
+/**
+ * Build an empty digest for when no activities exist.
+ * Used as a placeholder when there's nothing to report.
+ *
+ * @param tenantId Tenant identifier
+ * @param date Date of the digest
+ * @returns Empty FeedDigest
+ */
+function buildEmptyDigest(tenantId, date) {
+    return {
+        date: date.toISOString().split('T')[0],
+        tenantId,
+        items: [],
+        summary: {
+            total: 0,
+            byAction: {},
+            byActor: {},
+        },
+        emailSubject: 'No activity today',
+        emailPreview: '',
+    };
+}
+/**
+ * Compute summary statistics for digest items.
+ * Counts activities by action type and actor.
+ *
+ * @param items Digest items
+ * @returns Summary with total and breakdown by action/actor
+ */
+function buildDigestSummary(items) {
+    const byAction = {};
+    const byActor = {};
+    for (const item of items) {
+        // Count by action
+        const action = item.action;
+        byAction[action] = (byAction[action] ?? 0) + 1;
+        // Count by actor
+        const actor = item.actorName ?? item.actorId ?? 'System';
+        byActor[actor] = (byActor[actor] ?? 0) + 1;
+    }
+    return {
+        total: items.length,
+        byAction,
+        byActor,
+    };
+}
+/**
+ * Build a human-readable email subject line for digest.
+ *
+ * Examples:
+ * - "Daily Digest — 5 updates"
+ * - "Daily Digest — 12 activities"
+ * - "Daily Digest for Tuesday, Apr 8"
+ *
+ * @param summary Digest summary
+ * @param date Digest date
+ * @returns Email subject line
+ */
+function buildDigestEmailSubject(summary, _date) {
+    const total = summary.total;
+    if (total === 0) {
+        return 'Daily Digest — No activity';
+    }
+    const itemWord = total === 1 ? 'activity' : 'activities';
+    return `Daily Digest — ${total} ${itemWord}`;
+}
+/**
+ * Build a preview text for digest email.
+ * Creates a bulleted summary suitable for email rendering.
+ *
+ * Format:
+ * ```
+ * • Alice updated Project ABC
+ * • Bob commented on Task 123
+ * • System created Entity XYZ
+ * ```
+ *
+ * @param items Digest items (typically 5-10)
+ * @returns Plain text preview suitable for email
+ */
+function buildDigestEmailPreview(items) {
+    if (items.length === 0) {
+        return 'No activity in the past 24 hours.';
+    }
+    const lines = items
+        .slice(0, 10) // Cap at 10 items for email preview
+        .map((item) => {
+        const actor = item.actorName ?? 'System';
+        const action = formatActionForPreview(item.action);
+        const entity = item.entityName ?? item.entityId ?? 'item';
+        return `• ${actor} ${action} ${entity}`;
+    });
+    return lines.join('\n');
+}
+/**
+ * Format action type for preview display.
+ *
+ * @param action Action code
+ * @returns Display-friendly action phrase
+ */
+function formatActionForPreview(action) {
+    const map = {
+        INSERT: 'created',
+        UPDATE: 'updated',
+        DELETE: 'deleted',
+        comment: 'commented on',
+        assigned: 'assigned',
+        shared: 'shared',
+    };
+    return map[action] ?? action.toLowerCase();
+}
+/**
+ * Extract importance value from activity metadata.
+ * Looks for 'importance' or 'priority' fields.
+ *
+ * @param metadata Activity metadata
+ * @returns Importance value or null
+ */
+function extractImportanceFromMetadata(metadata) {
+    if (!metadata)
+        return null;
+    if ('importance' in metadata) {
+        const imp = metadata.importance;
+        if (typeof imp === 'number' || typeof imp === 'string') {
+            return imp;
+        }
+    }
+    if ('priority' in metadata) {
+        const pri = metadata.priority;
+        if (typeof pri === 'number' || typeof pri === 'string') {
+            return pri;
+        }
+    }
+    return null;
+}
+/**
+ * Build a multi-day digest.
+ *
+ * Generates a digest spanning multiple days.
+ * Useful for weekly/monthly summaries.
+ *
+ * @param store ActivityStore
+ * @param config Digest config
+ * @param days Number of days to include (default 7 for weekly)
+ * @returns FeedDigest combining items from multiple days
+ */
+export async function resolveMultiDayDigest(store, config, days = 7) {
+    const { tenantId, digestLimit = 20, minScoreThreshold = 0.4, includeImportance = true, importanceWeight = 1.5, recencyWeight = 1.0, } = config;
+    const { limit: digestLimitSafe } = validateFeedParams(digestLimit);
+    const { threshold } = validateFeedParams(undefined, minScoreThreshold);
+    const now = new Date();
+    const startDate = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    const queryOptions = {
+        limit: digestLimitSafe * 3, // Fetch extra for filtering
+    };
+    const records = await store.listActivities(queryOptions);
+    // Filter to date range
+    const startTime = startDate.getTime();
+    const filteredRecords = records.filter((r) => new Date(r.created_at).getTime() >= startTime);
+    if (filteredRecords.length === 0) {
+        return buildEmptyDigest(tenantId, now);
+    }
+    // Rank and filter
+    let items = rowsToFeedItems(filteredRecords);
+    items = items.map((item) => {
+        const score = computeForYouScores({
+            createdAt: item.createdAt,
+            metadata: item.metadata,
+            importance: includeImportance ? extractImportanceFromMetadata(item.metadata) : undefined,
+            now,
+            recencyWeight,
+            importanceWeight,
+        });
+        return {
+            ...item,
+            score,
+        };
+    });
+    items = items.sort((a, b) => b.score - a.score);
+    const digestItems = items.filter((item) => item.score >= threshold).slice(0, digestLimitSafe);
+    const summary = buildDigestSummary(digestItems);
+    const emailSubject = `Weekly Digest — ${digestItems.length} activities`;
+    const emailPreview = buildDigestEmailPreview(digestItems);
+    return {
+        date: now.toISOString().split('T')[0],
+        tenantId,
+        items: digestItems,
+        summary,
+        emailSubject,
+        emailPreview,
+    };
+}
+//# sourceMappingURL=digest.js.map

package/dist/feed/digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.js","sourceRoot":"","sources":["../../src/feed/digest.ts"],"names":[],"mappings":"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"}

package/dist/feed/filters.d.ts

@@ -0,0 +1,41 @@
+import type { FeedTimeRange } from './types.js';
+/**
+ * Get the start of a time range as an ISO timestamp.
+ * Used to filter activities by time window.
+ *
+ * @param timeRange Time range identifier ('today', 'week', etc)
+ * @param referenceDate Optional reference date (default: now)
+ * @returns ISO timestamp string (start of range)
+ */
+export declare function getTimeRangeStart(timeRange: FeedTimeRange, referenceDate?: Date): string;
+/**
+ * Get the sort column for a feed tab.
+ * Determines primary sort order for different view types.
+ *
+ * 'all' and 'digest' use created_at (reverse chronological)
+ * 'for-you' uses computed score (highest first) with created_at as tie-breaker
+ *
+ * @param tab Feed tab type
+ * @returns Column name for sorting ('created_at' or 'score')
+ */
+export declare function getTabSortColumn(tab: 'all' | 'for-you' | 'digest'): 'created_at' | 'score';
+/**
+ * Get the sort direction for a feed tab.
+ *
+ * @param tab Feed tab type
+ * @returns Sort direction ('DESC' for recent-first, 'ASC' for oldest-first)
+ */
+export declare function getTabSortDirection(tab: 'all' | 'for-you' | 'digest'): 'ASC' | 'DESC';
+/**
+ * Validate feed configuration parameters.
+ * Ensures limits and thresholds are within acceptable ranges.
+ *
+ * @param limit Maximum items to return
+ * @param threshold Score threshold (0-1)
+ * @returns Object with validated/clamped values
+ */
+export declare function validateFeedParams(limit?: number, threshold?: number): {
+    limit: number;
+    threshold: number;
+};
+//# sourceMappingURL=filters.d.ts.map

package/dist/feed/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/feed/filters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,aAAa,EAAE,aAAa,OAAa,GAAG,MAAM,CAwC9F;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAM1F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAOrF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB;IACD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAeA"}

package/dist/feed/filters.js

@@ -0,0 +1,97 @@
+/**
+ * Get the start of a time range as an ISO timestamp.
+ * Used to filter activities by time window.
+ *
+ * @param timeRange Time range identifier ('today', 'week', etc)
+ * @param referenceDate Optional reference date (default: now)
+ * @returns ISO timestamp string (start of range)
+ */
+export function getTimeRangeStart(timeRange, referenceDate = new Date()) {
+    const ref = new Date(referenceDate);
+    switch (timeRange) {
+        case 'today': {
+            // Start of today
+            const today = new Date(ref.getFullYear(), ref.getMonth(), ref.getDate());
+            return today.toISOString();
+        }
+        case 'yesterday': {
+            // Start of yesterday
+            const yesterday = new Date(ref);
+            yesterday.setDate(yesterday.getDate() - 1);
+            const start = new Date(yesterday.getFullYear(), yesterday.getMonth(), yesterday.getDate());
+            return start.toISOString();
+        }
+        case 'week': {
+            // Start of this calendar week (Monday, or Sunday if in ISO)
+            // Using ISO: Monday = 1, Sunday = 0
+            const dayOfWeek = ref.getDay(); // 0 = Sunday, 6 = Saturday
+            const daysToMonday = dayOfWeek === 0 ? 6 : dayOfWeek - 1;
+            const monday = new Date(ref);
+            monday.setDate(monday.getDate() - daysToMonday);
+            const start = new Date(monday.getFullYear(), monday.getMonth(), monday.getDate());
+            return start.toISOString();
+        }
+        case 'month': {
+            // Start of this month
+            const start = new Date(ref.getFullYear(), ref.getMonth(), 1);
+            return start.toISOString();
+        }
+        case 'all':
+        default:
+            // Beginning of epoch or very far back
+            return new Date(0).toISOString();
+    }
+}
+/**
+ * Get the sort column for a feed tab.
+ * Determines primary sort order for different view types.
+ *
+ * 'all' and 'digest' use created_at (reverse chronological)
+ * 'for-you' uses computed score (highest first) with created_at as tie-breaker
+ *
+ * @param tab Feed tab type
+ * @returns Column name for sorting ('created_at' or 'score')
+ */
+export function getTabSortColumn(tab) {
+    if (tab === 'for-you') {
+        return 'score';
+    }
+    // 'all' and 'digest' default to chronological
+    return 'created_at';
+}
+/**
+ * Get the sort direction for a feed tab.
+ *
+ * @param tab Feed tab type
+ * @returns Sort direction ('DESC' for recent-first, 'ASC' for oldest-first)
+ */
+export function getTabSortDirection(tab) {
+    if (tab === 'for-you') {
+        // Score: highest first (DESC)
+        return 'DESC';
+    }
+    // Chronological: most recent first (DESC)
+    return 'DESC';
+}
+/**
+ * Validate feed configuration parameters.
+ * Ensures limits and thresholds are within acceptable ranges.
+ *
+ * @param limit Maximum items to return
+ * @param threshold Score threshold (0-1)
+ * @returns Object with validated/clamped values
+ */
+export function validateFeedParams(limit, threshold) {
+    const MIN_LIMIT = 1;
+    const MAX_LIMIT = 500;
+    const DEFAULT_LIMIT = 50;
+    const MIN_THRESHOLD = 0;
+    const MAX_THRESHOLD = 1;
+    const safeLimit = limit ? Math.max(MIN_LIMIT, Math.min(MAX_LIMIT, limit)) : DEFAULT_LIMIT;
+    const safeThreshold = threshold ? Math.max(MIN_THRESHOLD, Math.min(MAX_THRESHOLD, threshold)) : 0;
+    return {
+        limit: safeLimit,
+        threshold: safeThreshold,
+    };
+}
+//# sourceMappingURL=filters.js.map

package/dist/feed/filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../src/feed/filters.ts"],"names":[],"mappings":"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"}

package/dist/feed/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Feed system module.
+ *
+ * Provides activity aggregation, personalized ranking, and digest generation.
+ * Storage-agnostic: works with any ActivityStore implementation.
+ *
+ * Key exports:
+ * - resolveFeed() — Main entry point for personalized feeds
+ * - resolveDigest() — Daily digest of high-impact activities
+ * - computeForYouScores() — Temporal decay + importance ranking
+ * - FeedItem, FeedConfig, FeedDigest — Type contracts
+ */
+export type { FeedItem, FeedConfig, FeedTimeRange, FeedTab, RankingInput } from './types.js';
+export type { DigestConfig, FeedDigest } from './types.js';
+export { resolveFeed, resolveFeedWithTimeFilter, resolveFeedPage, buildFeedDelta, } from './resolver.js';
+export { resolveDigest, resolveMultiDayDigest } from './digest.js';
+export { computeForYouScores, sortByScore, filterByScore } from './ranking.js';
+export { rowToFeedItem, rowsToFeedItems, extractFeedPreview, extractActorDisplay, extractEntityDisplay, formatActivityPlainText, } from './transformers.js';
+export { getTimeRangeStart, getTabSortColumn, getTabSortDirection, validateFeedParams, } from './filters.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/feed/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/feed/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGxD,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGhE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG5E,OAAO,EACL,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,WAAW,CAAC"}

package/dist/feed/index.js

@@ -0,0 +1,23 @@
+/**
+ * Feed system module.
+ *
+ * Provides activity aggregation, personalized ranking, and digest generation.
+ * Storage-agnostic: works with any ActivityStore implementation.
+ *
+ * Key exports:
+ * - resolveFeed() — Main entry point for personalized feeds
+ * - resolveDigest() — Daily digest of high-impact activities
+ * - computeForYouScores() — Temporal decay + importance ranking
+ * - FeedItem, FeedConfig, FeedDigest — Type contracts
+ */
+// ─── Resolver (Main Entry Points) ────────────────────────────────
+export { resolveFeed, resolveFeedWithTimeFilter, resolveFeedPage, buildFeedDelta, } from './resolver.js';
+// ─── Digest ──────────────────────────────────────────────────────
+export { resolveDigest, resolveMultiDayDigest } from './digest.js';
+// ─── Ranking Algorithm ───────────────────────────────────────────
+export { computeForYouScores, sortByScore, filterByScore } from './ranking.js';
+// ─── Transformers (ActivityRecord → FeedItem) ───────────────────
+export { rowToFeedItem, rowsToFeedItems, extractFeedPreview, extractActorDisplay, extractEntityDisplay, formatActivityPlainText, } from './transformers.js';
+// ─── Filters & Sorting ───────────────────────────────────────────
+export { getTimeRangeStart, getTabSortColumn, getTabSortDirection, validateFeedParams, } from './filters.js';
+//# sourceMappingURL=index.js.map

package/dist/feed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/feed/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,oEAAoE;AACpE,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEhE,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE5E,mEAAmE;AACnE,OAAO,EACL,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,oEAAoE;AACpE,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,WAAW,CAAC"}

package/dist/feed/ranking.d.ts

@@ -0,0 +1,42 @@
+import type { RankingInput } from './types.js';
+/**
+ * Compute "For You" relevance score for an activity.
+ *
+ * Combines:
+ * 1. Temporal score (recent > old): exponential decay with 24h half-life
+ * 2. Importance score (high > low): from metadata or direct value
+ * 3. Configurable weights for tuning (default 1.0 for both)
+ *
+ * Final score = (temporal * recencyWeight + importance * importanceWeight) / 2
+ *
+ * The score is normalized to 0-1 range and should be interpreted as:
+ * - 0.9-1.0: Highly relevant (just happened, high importance)
+ * - 0.5-0.9: Moderately relevant (recent or important)
+ * - 0.0-0.5: Lower relevance (older and/or low importance)
+ *
+ * @param input Ranking input with activity data and configuration
+ * @returns Score from 0 to 1
+ */
+export declare function computeForYouScores(input: RankingInput): number;
+/**
+ * Sort feed items by score (descending).
+ * Items with equal scores maintain relative order (stable sort).
+ *
+ * @param items Feed items to sort
+ * @returns Sorted items (highest score first)
+ */
+export declare function sortByScore<T extends {
+    score: number;
+}>(items: T[]): T[];
+/**
+ * Filter items by score threshold.
+ * Useful for digest generation and importance-based filtering.
+ *
+ * @param items Feed items to filter
+ * @param minScore Minimum score (0-1)
+ * @returns Items with score >= minScore
+ */
+export declare function filterByScore<T extends {
+    score: number;
+}>(items: T[], minScore: number): T[];
+//# sourceMappingURL=ranking.d.ts.map

package/dist/feed/ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.d.ts","sourceRoot":"","sources":["../../src/feed/ranking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAkF5C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAmB/D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAOxE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,EAAE,CAG5F"}

package/dist/feed/ranking.js

@@ -0,0 +1,133 @@
+/**
+ * Scoring constants for ranking algorithm.
+ */
+const TEMPORAL_DECAY_HALF_LIFE_HOURS = 24;
+const DEFAULT_IMPORTANCE = 0.5;
+const IMPORTANCE_MULTIPLIER_MAP = {
+    critical: 1.0,
+    high: 0.8,
+    medium: 0.5,
+    low: 0.3,
+};
+/**
+ * Compute exponential temporal decay score.
+ * Recent activities score high, older activities decay exponentially.
+ *
+ * Uses exponential decay with half-life: score(t) = 2^(-t / halfLife)
+ * At half-life hours ago: score = 0.5
+ * At 2x half-life hours ago: score = 0.25
+ * At 3x half-life hours ago: score = 0.125
+ *
+ * @param createdAt ISO timestamp string
+ * @param now Current date for computing elapsed time
+ * @returns Temporal score (0-1)
+ */
+function computeTemporalScore(createdAt, now) {
+    const activityTime = new Date(createdAt).getTime();
+    const nowTime = now.getTime();
+    const elapsedMs = Math.max(0, nowTime - activityTime);
+    const elapsedHours = elapsedMs / (1000 * 60 * 60);
+    // Exponential decay: 2^(-elapsed / half-life)
+    const temporalScore = Math.pow(2, -elapsedHours / TEMPORAL_DECAY_HALF_LIFE_HOURS);
+    return Math.max(0, Math.min(1, temporalScore));
+}
+/**
+ * Extract and normalize importance value from metadata or direct input.
+ * Handles string ('high', 'low', etc) and numeric (0-1) formats.
+ *
+ * @param importance Direct importance value if available
+ * @param metadata Activity metadata which may contain importance signal
+ * @returns Normalized importance score (0-1)
+ */
+function getImportanceScore(importance, metadata) {
+    // Use direct importance if provided
+    if (importance !== null && importance !== undefined) {
+        if (typeof importance === 'number') {
+            return Math.max(0, Math.min(1, importance));
+        }
+        if (typeof importance === 'string') {
+            return IMPORTANCE_MULTIPLIER_MAP[importance.toLowerCase()] ?? DEFAULT_IMPORTANCE;
+        }
+    }
+    // Check metadata for importance signal
+    if (metadata) {
+        const metaImportance = metadata.importance;
+        if (typeof metaImportance === 'number') {
+            return Math.max(0, Math.min(1, metaImportance));
+        }
+        if (typeof metaImportance === 'string') {
+            return IMPORTANCE_MULTIPLIER_MAP[metaImportance.toLowerCase()] ?? DEFAULT_IMPORTANCE;
+        }
+        const metaPriority = metadata.priority;
+        if (typeof metaPriority === 'number') {
+            return Math.max(0, Math.min(1, metaPriority));
+        }
+        if (typeof metaPriority === 'string') {
+            return IMPORTANCE_MULTIPLIER_MAP[metaPriority.toLowerCase()] ?? DEFAULT_IMPORTANCE;
+        }
+    }
+    return DEFAULT_IMPORTANCE;
+}
+/**
+ * Compute "For You" relevance score for an activity.
+ *
+ * Combines:
+ * 1. Temporal score (recent > old): exponential decay with 24h half-life
+ * 2. Importance score (high > low): from metadata or direct value
+ * 3. Configurable weights for tuning (default 1.0 for both)
+ *
+ * Final score = (temporal * recencyWeight + importance * importanceWeight) / 2
+ *
+ * The score is normalized to 0-1 range and should be interpreted as:
+ * - 0.9-1.0: Highly relevant (just happened, high importance)
+ * - 0.5-0.9: Moderately relevant (recent or important)
+ * - 0.0-0.5: Lower relevance (older and/or low importance)
+ *
+ * @param input Ranking input with activity data and configuration
+ * @returns Score from 0 to 1
+ */
+export function computeForYouScores(input) {
+    const { createdAt, metadata, importance, now, recencyWeight, importanceWeight } = input;
+    // Compute component scores
+    const temporalScore = computeTemporalScore(createdAt, now);
+    const importanceScore = getImportanceScore(importance, metadata);
+    // Apply weights (clamped to 0-2 range for safety)
+    const safeRecencyWeight = Math.max(0, Math.min(2, recencyWeight || 1));
+    const safeImportanceWeight = Math.max(0, Math.min(2, importanceWeight || 1));
+    // Weighted average of temporal and importance
+    // Both components equally important by default, but weights allow tuning
+    const weightedTemporal = temporalScore * safeRecencyWeight;
+    const weightedImportance = importanceScore * safeImportanceWeight;
+    const totalWeight = safeRecencyWeight + safeImportanceWeight;
+    const finalScore = (weightedTemporal + weightedImportance) / totalWeight;
+    return Math.max(0, Math.min(1, finalScore));
+}
+/**
+ * Sort feed items by score (descending).
+ * Items with equal scores maintain relative order (stable sort).
+ *
+ * @param items Feed items to sort
+ * @returns Sorted items (highest score first)
+ */
+export function sortByScore(items) {
+    return items.slice().sort((a, b) => {
+        const scoreDiff = b.score - a.score;
+        if (scoreDiff !== 0)
+            return scoreDiff;
+        // Tie-breaker: maintain insertion order (stable sort)
+        return 0;
+    });
+}
+/**
+ * Filter items by score threshold.
+ * Useful for digest generation and importance-based filtering.
+ *
+ * @param items Feed items to filter
+ * @param minScore Minimum score (0-1)
+ * @returns Items with score >= minScore
+ */
+export function filterByScore(items, minScore) {
+    const safeThreshold = Math.max(0, Math.min(1, minScore));
+    return items.filter((item) => item.score >= safeThreshold);
+}
+//# sourceMappingURL=ranking.js.map