opencandle 0.2.0 → 0.3.0

package/dist/sentiment/adapters/web.js

@@ -0,0 +1,40 @@
+import { randomUUID } from "node:crypto";
+export class WebAdapter {
+    source = "web";
+    mapToRecords(envelope, query) {
+        const fetchedAt = envelope.fetchedAt;
+        return envelope.results.map((result) => ({
+            id: randomUUID(),
+            source: this.source,
+            sourceId: canonicalizeUrl(result.url),
+            query,
+            title: result.title,
+            text: result.snippet,
+            author: result.source,
+            url: result.url,
+            publishedAt: result.published,
+            fetchedAt,
+            engagement: {
+                score: 0,
+                replies: null,
+                shares: null,
+                views: null,
+            },
+            sentiment: { score: 0, confidence: 0, method: "keyword", tickers: [] },
+            metadata: { category: result.category, provider: envelope.provider },
+        }));
+    }
+    async fetch(_query, _options) {
+        throw new Error("Use pipeline.run() instead of adapter.fetch() directly");
+    }
+}
+function canonicalizeUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.origin + parsed.pathname;
+    }
+    catch {
+        return url;
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/sentiment/adapters/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../src/sentiment/adapters/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,OAAO,UAAU;IACZ,MAAM,GAAG,KAAc,CAAC;IAEjC,YAAY,CAAC,QAA2B,EAAE,KAAa;QACrD,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;QACrC,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACvC,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC;YACrC,KAAK;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,OAAO;YACpB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,WAAW,EAAE,MAAM,CAAC,SAAS;YAC7B,SAAS;YACT,UAAU,EAAE;gBACV,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;aACZ;YACD,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,SAAkB,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/E,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;SACrE,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,QAA6B;QACvD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;CACF;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/sentiment/index.d.ts

@@ -0,0 +1,16 @@
+export type { SentinelRecord, SentinelEngagement, SentinelSentiment, SentimentAdapter, ScorerOptions, TrendBucket, TrendResult, DivergenceResult, SentimentSummary, SentimentSource, } from "./types.js";
+export { isSentinelRecord, SENTIMENT_SOURCES } from "./types.js";
+export { SentimentStore } from "./store.js";
+export { scoreRecords, keywordScore } from "./scorer.js";
+export { SentimentPipeline } from "./pipeline.js";
+export { renderSparkline, computeTrend, computeDivergence } from "./trends.js";
+export { BULLISH_TERMS, BEARISH_TERMS } from "./keywords.js";
+export { TwitterAdapter } from "./adapters/twitter.js";
+export { RedditAdapter } from "./adapters/reddit.js";
+export { WebAdapter } from "./adapters/web.js";
+import { SentimentStore } from "./store.js";
+import { SentimentPipeline } from "./pipeline.js";
+export declare function getSentimentStore(): SentimentStore;
+export declare function getSentimentPipeline(): SentimentPipeline;
+/** For testing: reset singletons */
+export declare function _resetSentimentSingletons(): void;

package/dist/sentiment/index.js

@@ -0,0 +1,44 @@
+export { isSentinelRecord, SENTIMENT_SOURCES } from "./types.js";
+export { SentimentStore } from "./store.js";
+export { scoreRecords, keywordScore } from "./scorer.js";
+export { SentimentPipeline } from "./pipeline.js";
+export { renderSparkline, computeTrend, computeDivergence } from "./trends.js";
+export { BULLISH_TERMS, BEARISH_TERMS } from "./keywords.js";
+export { TwitterAdapter } from "./adapters/twitter.js";
+export { RedditAdapter } from "./adapters/reddit.js";
+export { WebAdapter } from "./adapters/web.js";
+import { SentimentStore } from "./store.js";
+import { SentimentPipeline } from "./pipeline.js";
+import { getConfig } from "../config.js";
+import { resolveOpenCandlePath } from "../infra/opencandle-paths.js";
+let _pipeline = null;
+let _store = null;
+export function getSentimentStore() {
+    if (!_store) {
+        const dbPath = resolveOpenCandlePath("sentinel.db");
+        _store = new SentimentStore(dbPath);
+        const config = getConfig();
+        _store.prune(config.sentiment?.retentionDays ?? 30);
+    }
+    return _store;
+}
+export function getSentimentPipeline() {
+    if (!_pipeline) {
+        const store = getSentimentStore();
+        const config = getConfig();
+        _pipeline = new SentimentPipeline(store, config.sentiment);
+    }
+    return _pipeline;
+}
+/** For testing: reset singletons */
+export function _resetSentimentSingletons() {
+    if (_store) {
+        try {
+            _store.close();
+        }
+        catch { /* ignore */ }
+    }
+    _pipeline = null;
+    _store = null;
+}
+//# sourceMappingURL=index.js.map

package/dist/sentiment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sentiment/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,IAAI,SAAS,GAA6B,IAAI,CAAC;AAC/C,IAAI,MAAM,GAA0B,IAAI,CAAC;AAEzC,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,SAAS,GAAG,IAAI,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAU,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,yBAAyB;IACvC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IACD,SAAS,GAAG,IAAI,CAAC;IACjB,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC"}

package/dist/sentiment/keywords.d.ts

@@ -0,0 +1,2 @@
+export declare const BULLISH_TERMS: readonly ["moon", "buy", "undervalued", "breakout", "calls", "bullish", "rocket", "diamond hands", "accumulate", "dip buy", "long", "rip", "squeeze"];
+export declare const BEARISH_TERMS: readonly ["crash", "overvalued", "sell", "puts", "bearish", "bubble", "dump", "short", "bagholding", "exit", "drill", "tank", "rug"];

package/dist/sentiment/keywords.js

@@ -0,0 +1,9 @@
+export const BULLISH_TERMS = [
+    "moon", "buy", "undervalued", "breakout", "calls", "bullish",
+    "rocket", "diamond hands", "accumulate", "dip buy", "long", "rip", "squeeze",
+];
+export const BEARISH_TERMS = [
+    "crash", "overvalued", "sell", "puts", "bearish", "bubble",
+    "dump", "short", "bagholding", "exit", "drill", "tank", "rug",
+];
+//# sourceMappingURL=keywords.js.map

package/dist/sentiment/keywords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keywords.js","sourceRoot":"","sources":["../../src/sentiment/keywords.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS;IAC5D,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS;CACpE,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ;IAC1D,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK;CACrD,CAAC"}

package/dist/sentiment/pipeline.d.ts

@@ -0,0 +1,9 @@
+import type { SentinelRecord, SentimentSummary } from "./types.js";
+import type { SentimentConfig } from "../config.js";
+import { SentimentStore } from "./store.js";
+export declare class SentimentPipeline {
+    private store;
+    private config;
+    constructor(store: SentimentStore, config: SentimentConfig);
+    processRecords(records: SentinelRecord[], query: string): Promise<SentimentSummary>;
+}

package/dist/sentiment/pipeline.js

@@ -0,0 +1,57 @@
+import { scoreRecords } from "./scorer.js";
+import { computeTrend, computeDivergence } from "./trends.js";
+export class SentimentPipeline {
+    store;
+    config;
+    constructor(store, config) {
+        this.store = store;
+        this.config = config;
+    }
+    async processRecords(records, query) {
+        const warnings = [];
+        if (records.length === 0) {
+            return { fresh: [], trend: null, divergence: null, warnings };
+        }
+        // Check if store had prior data before this fetch
+        const priorSeries = this.store.getTimeSeries(query, { days: 30, bucketHours: 24 });
+        const hadPriorData = priorSeries.length >= 2;
+        // Score all records
+        const scored = scoreRecords(records);
+        // Insert into store
+        this.store.insert(scored);
+        // Compute trend from historical data (only if we had prior data)
+        let trend = null;
+        if (hadPriorData) {
+            const series = this.store.getTimeSeries(query, { days: 7, bucketHours: 24 });
+            if (series.length >= 2) {
+                trend = [computeTrend(series, "aggregate")];
+            }
+        }
+        // Compute divergence from fresh records
+        let divergence = null;
+        const sourceGroups = groupBySource(scored);
+        const sourceStats = {};
+        for (const [source, recs] of Object.entries(sourceGroups)) {
+            // Exclude comments from divergence calculation
+            const postLevel = recs.filter((r) => !r.metadata.isComment);
+            if (postLevel.length > 0) {
+                const avg = postLevel.reduce((sum, r) => sum + r.sentiment.score, 0) / postLevel.length;
+                sourceStats[source] = { avg, count: postLevel.length };
+            }
+        }
+        if (Object.keys(sourceStats).length >= 2) {
+            divergence = computeDivergence(sourceStats, this.config.divergenceThreshold);
+        }
+        return { fresh: scored, trend, divergence, warnings };
+    }
+}
+function groupBySource(records) {
+    const groups = {};
+    for (const r of records) {
+        if (!groups[r.source])
+            groups[r.source] = [];
+        groups[r.source].push(r);
+    }
+    return groups;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/sentiment/pipeline.js.map

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

package/dist/sentiment/scorer.d.ts

@@ -0,0 +1,9 @@
+import type { SentinelRecord } from "./types.js";
+interface ScoreResult {
+    score: number;
+    confidence: number;
+    tickers: string[];
+}
+export declare function keywordScore(record: SentinelRecord): ScoreResult;
+export declare function scoreRecords(records: SentinelRecord[]): SentinelRecord[];
+export {};

package/dist/sentiment/scorer.js

@@ -0,0 +1,64 @@
+import { BULLISH_TERMS, BEARISH_TERMS } from "./keywords.js";
+const TICKER_REGEX = /\$([A-Z]{1,5})\b/g;
+export function keywordScore(record) {
+    const lower = record.text.toLowerCase();
+    const engagement = 1 + (record.engagement.score ?? 0);
+    let bullishWeight = 0;
+    let bearishWeight = 0;
+    let bullishCount = 0;
+    let bearishCount = 0;
+    for (const term of BULLISH_TERMS) {
+        if (lower.includes(term)) {
+            bullishCount++;
+            bullishWeight += engagement;
+        }
+    }
+    for (const term of BEARISH_TERMS) {
+        if (lower.includes(term)) {
+            bearishCount++;
+            bearishWeight += engagement;
+        }
+    }
+    const totalWeight = bullishWeight + bearishWeight;
+    const score = totalWeight === 0 ? 0 : (bullishWeight - bearishWeight) / totalWeight;
+    const totalMatches = bullishCount + bearishCount;
+    let confidence = 0;
+    if (totalMatches > 0) {
+        // Base confidence from keyword matches
+        confidence = Math.min(totalMatches / 5, 1) * 0.6;
+        // Boost for longer text
+        const textLength = record.text.length;
+        confidence += Math.min(textLength / 500, 1) * 0.3;
+        // Multiple matches boost
+        if (totalMatches >= 3)
+            confidence += 0.1;
+        // Twitter penalty
+        if (record.source === "twitter")
+            confidence -= 0.1;
+        // Clamp
+        confidence = Math.max(0, Math.min(1, confidence));
+    }
+    // Extract tickers
+    const tickers = [];
+    for (const match of record.text.matchAll(TICKER_REGEX)) {
+        if (!tickers.includes(match[1])) {
+            tickers.push(match[1]);
+        }
+    }
+    return { score, confidence, tickers };
+}
+export function scoreRecords(records) {
+    return records.map((record) => {
+        const result = keywordScore(record);
+        return {
+            ...record,
+            sentiment: {
+                score: result.score,
+                confidence: result.confidence,
+                method: "keyword",
+                tickers: result.tickers,
+            },
+        };
+    });
+}
+//# sourceMappingURL=scorer.js.map

package/dist/sentiment/scorer.js.map

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

package/dist/sentiment/store.d.ts

@@ -0,0 +1,24 @@
+import type { SentinelRecord, SentimentSource, TrendBucket } from "./types.js";
+export interface SearchOptions {
+    source?: SentimentSource;
+    since?: string;
+    until?: string;
+}
+export interface TimeSeriesOptions {
+    days: number;
+    bucketHours: number;
+}
+export declare class SentimentStore {
+    private db;
+    constructor(pathOrMemory: string);
+    private initSchema;
+    getSchemaVersion(): number;
+    insert(records: SentinelRecord[]): void;
+    search(query: string, options?: SearchOptions): SentinelRecord[];
+    getByTicker(ticker: string, options?: {
+        since?: string;
+    }): SentinelRecord[];
+    getTimeSeries(query: string, options: TimeSeriesOptions): TrendBucket[];
+    prune(retentionDays: number): number;
+    close(): void;
+}

package/dist/sentiment/store.js

@@ -0,0 +1,177 @@
+import Database from "better-sqlite3";
+const SCHEMA_VERSION = 1;
+const CREATE_SCHEMA = `
+  CREATE TABLE IF NOT EXISTS schema_version (
+    version INTEGER NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS sentinel_records (
+    id TEXT NOT NULL,
+    source TEXT NOT NULL,
+    source_id TEXT NOT NULL,
+    query TEXT NOT NULL,
+    title TEXT,
+    text TEXT NOT NULL,
+    author TEXT,
+    url TEXT NOT NULL,
+    published_at TEXT,
+    fetched_at TEXT NOT NULL,
+    engagement_json TEXT NOT NULL,
+    sentiment_score REAL NOT NULL,
+    sentiment_confidence REAL NOT NULL,
+    sentiment_method TEXT NOT NULL,
+    tickers_json TEXT NOT NULL,
+    metadata_json TEXT NOT NULL,
+    UNIQUE(source, source_id, fetched_at)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_sentinel_source ON sentinel_records(source);
+  CREATE INDEX IF NOT EXISTS idx_sentinel_fetched_at ON sentinel_records(fetched_at);
+  CREATE INDEX IF NOT EXISTS idx_sentinel_query ON sentinel_records(query);
+
+  CREATE VIRTUAL TABLE IF NOT EXISTS sentinel_fts USING fts5(
+    text, title, author, query, source,
+    content=sentinel_records,
+    content_rowid=rowid
+  );
+`;
+const TRIGGERS = `
+  CREATE TRIGGER IF NOT EXISTS sentinel_ai AFTER INSERT ON sentinel_records BEGIN
+    INSERT INTO sentinel_fts(rowid, text, title, author, query, source)
+    VALUES (new.rowid, new.text, new.title, new.author, new.query, new.source);
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS sentinel_ad AFTER DELETE ON sentinel_records BEGIN
+    INSERT INTO sentinel_fts(sentinel_fts, rowid, text, title, author, query, source)
+    VALUES ('delete', old.rowid, old.text, old.title, old.author, old.query, old.source);
+  END;
+`;
+export class SentimentStore {
+    db;
+    constructor(pathOrMemory) {
+        this.db = new Database(pathOrMemory);
+        if (pathOrMemory !== ":memory:") {
+            this.db.pragma("journal_mode = WAL");
+        }
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(CREATE_SCHEMA);
+        this.db.exec(TRIGGERS);
+        const row = this.db.prepare("SELECT version FROM schema_version").get();
+        if (!row) {
+            this.db.prepare("INSERT INTO schema_version (version) VALUES (?)").run(SCHEMA_VERSION);
+        }
+    }
+    getSchemaVersion() {
+        const row = this.db.prepare("SELECT version FROM schema_version").get();
+        return row.version;
+    }
+    insert(records) {
+        const stmt = this.db.prepare(`
+      INSERT OR IGNORE INTO sentinel_records
+        (id, source, source_id, query, title, text, author, url,
+         published_at, fetched_at, engagement_json,
+         sentiment_score, sentiment_confidence, sentiment_method,
+         tickers_json, metadata_json)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        const tx = this.db.transaction((recs) => {
+            for (const r of recs) {
+                stmt.run(r.id, r.source, r.sourceId, r.query, r.title, r.text, r.author, r.url, r.publishedAt, r.fetchedAt, JSON.stringify(r.engagement), r.sentiment.score, r.sentiment.confidence, r.sentiment.method, JSON.stringify(r.sentiment.tickers), JSON.stringify(r.metadata));
+            }
+        });
+        tx(records);
+    }
+    search(query, options) {
+        let sql = `
+      SELECT sr.* FROM sentinel_records sr
+      JOIN sentinel_fts fts ON sr.rowid = fts.rowid
+      WHERE sentinel_fts MATCH ?
+    `;
+        const params = [query];
+        if (options?.source) {
+            sql += " AND sr.source = ?";
+            params.push(options.source);
+        }
+        if (options?.since) {
+            sql += " AND sr.fetched_at >= ?";
+            params.push(options.since);
+        }
+        if (options?.until) {
+            sql += " AND sr.fetched_at <= ?";
+            params.push(options.until);
+        }
+        sql += " ORDER BY bm25(sentinel_fts) LIMIT 100";
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map(rowToRecord);
+    }
+    getByTicker(ticker, options) {
+        let sql = `SELECT * FROM sentinel_records WHERE tickers_json LIKE ?`;
+        const pattern = `%"${ticker}"%`;
+        const params = [pattern];
+        if (options?.since) {
+            sql += " AND fetched_at >= ?";
+            params.push(options.since);
+        }
+        sql += " ORDER BY fetched_at DESC LIMIT 100";
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map(rowToRecord);
+    }
+    getTimeSeries(query, options) {
+        const since = new Date();
+        since.setDate(since.getDate() - options.days);
+        const sinceStr = since.toISOString();
+        const bucketSeconds = options.bucketHours * 3600;
+        const sql = `
+      SELECT
+        (CAST(strftime('%s', fetched_at) AS INTEGER) / ?) * ? AS bucket_ts,
+        AVG(sentiment_score) AS avg_score,
+        COUNT(*) AS cnt
+      FROM sentinel_records
+      WHERE query = ? AND fetched_at >= ?
+      GROUP BY bucket_ts
+      ORDER BY bucket_ts
+    `;
+        const rows = this.db.prepare(sql).all(bucketSeconds, bucketSeconds, query, sinceStr);
+        return rows.map((r) => ({
+            timestamp: new Date(r.bucket_ts * 1000).toISOString(),
+            avgScore: r.avg_score,
+            count: r.cnt,
+        }));
+    }
+    prune(retentionDays) {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - retentionDays);
+        const result = this.db
+            .prepare("DELETE FROM sentinel_records WHERE fetched_at < ?")
+            .run(cutoff.toISOString());
+        return result.changes;
+    }
+    close() {
+        this.db.close();
+    }
+}
+function rowToRecord(row) {
+    return {
+        id: row.id,
+        source: row.source,
+        sourceId: row.source_id,
+        query: row.query,
+        title: row.title,
+        text: row.text,
+        author: row.author,
+        url: row.url,
+        publishedAt: row.published_at,
+        fetchedAt: row.fetched_at,
+        engagement: JSON.parse(row.engagement_json),
+        sentiment: {
+            score: row.sentiment_score,
+            confidence: row.sentiment_confidence,
+            method: row.sentiment_method,
+            tickers: JSON.parse(row.tickers_json),
+        },
+        metadata: JSON.parse(row.metadata_json),
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/sentiment/store.js.map

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

package/dist/sentiment/trends.d.ts

@@ -0,0 +1,13 @@
+import type { TrendBucket, TrendResult, DivergenceResult, SentimentSource } from "./types.js";
+export declare function renderSparkline(values: number[]): string;
+export declare function computeTrend(buckets: TrendBucket[], source: SentimentSource | "aggregate"): TrendResult;
+export interface SourceStats {
+    avg: number;
+    count: number;
+}
+export declare function computeDivergence(sources: {
+    twitter?: SourceStats;
+    reddit?: SourceStats;
+    web?: SourceStats;
+    finnhub?: SourceStats;
+}, threshold: number): DivergenceResult;

package/dist/sentiment/trends.js

@@ -0,0 +1,73 @@
+const SPARKLINE_CHARS = "▁▂▃▄▅▆▇█";
+export function renderSparkline(values) {
+    if (values.length === 0)
+        return "";
+    const min = Math.min(...values);
+    const max = Math.max(...values);
+    const range = max - min;
+    return values
+        .map((v) => {
+        if (range === 0)
+            return SPARKLINE_CHARS[3]; // middle block for flat
+        const idx = Math.round(((v - min) / range) * 7);
+        return SPARKLINE_CHARS[idx];
+    })
+        .join("");
+}
+export function computeTrend(buckets, source) {
+    const scores = buckets.map((b) => b.avgScore);
+    const totalCount = buckets.reduce((sum, b) => sum + b.count, 0);
+    const avgScore = totalCount === 0 ? 0 : buckets.reduce((sum, b) => sum + b.avgScore * b.count, 0) / totalCount;
+    const sparkline = renderSparkline(scores);
+    // Delta: last value minus first value
+    const delta = scores.length >= 2 ? scores[scores.length - 1] - scores[0] : 0;
+    let direction;
+    if (delta > 0.1)
+        direction = "rising";
+    else if (delta < -0.1)
+        direction = "falling";
+    else
+        direction = "stable";
+    return { source, sparkline, avgScore, count: totalCount, direction, delta };
+}
+export function computeDivergence(sources, threshold) {
+    const retailSources = [];
+    if (sources.twitter && sources.twitter.count >= 5)
+        retailSources.push(sources.twitter);
+    if (sources.reddit && sources.reddit.count >= 5)
+        retailSources.push(sources.reddit);
+    const newsSources = [];
+    if (sources.web && sources.web.count >= 5)
+        newsSources.push(sources.web);
+    if (sources.finnhub && sources.finnhub.count >= 5)
+        newsSources.push(sources.finnhub);
+    if (retailSources.length === 0 || newsSources.length === 0) {
+        return {
+            detected: false,
+            retailAvg: null,
+            newsAvg: null,
+            gap: null,
+            message: "Insufficient data for divergence analysis",
+        };
+    }
+    const retailAvg = retailSources.reduce((sum, s) => sum + s.avg, 0) / retailSources.length;
+    const newsAvg = newsSources.reduce((sum, s) => sum + s.avg, 0) / newsSources.length;
+    const gap = Math.abs(retailAvg - newsAvg);
+    if (gap > threshold) {
+        return {
+            detected: true,
+            retailAvg,
+            newsAvg,
+            gap,
+            message: `⚠ DIVERGENCE: Retail sentiment (${retailAvg >= 0 ? "+" : ""}${retailAvg.toFixed(2)}) vs news sentiment (${newsAvg >= 0 ? "+" : ""}${newsAvg.toFixed(2)}) — gap of ${gap.toFixed(2)}.`,
+        };
+    }
+    return {
+        detected: false,
+        retailAvg,
+        newsAvg,
+        gap,
+        message: "Sources broadly aligned",
+    };
+}
+//# sourceMappingURL=trends.js.map

package/dist/sentiment/trends.js.map

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