@spfunctions/cli 1.4.4 → 1.5.0

package/dist/telegram/commands.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Telegram slash command handlers — direct API calls, zero LLM cost
+ */
+import { SFClient } from '../client.js';
+export declare function handleContext(client: SFClient, thesisId: string): Promise<string>;
+export declare function handlePositions(): Promise<string>;
+export declare function handleEdges(client: SFClient): Promise<string>;
+export declare function handleBalance(): Promise<string>;
+export declare function handleOrders(): Promise<string>;
+export declare function handleEval(client: SFClient, thesisId: string): Promise<string>;
+export declare function handleList(client: SFClient): Promise<string>;

package/dist/telegram/commands.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Telegram slash command handlers — direct API calls, zero LLM cost
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleContext = handleContext;
+exports.handlePositions = handlePositions;
+exports.handleEdges = handleEdges;
+exports.handleBalance = handleBalance;
+exports.handleOrders = handleOrders;
+exports.handleEval = handleEval;
+exports.handleList = handleList;
+const kalshi_js_1 = require("../kalshi.js");
+const format_js_1 = require("./format.js");
+async function handleContext(client, thesisId) {
+    const ctx = await client.getContext(thesisId);
+    const conf = typeof ctx.confidence === 'number' ? Math.round(ctx.confidence * 100) : '?';
+    const thesis = ctx.thesis || ctx.rawThesis || 'N/A';
+    let text = `📋 <b>${(0, format_js_1.escapeHtml)(thesis.slice(0, 80))}</b>\n`;
+    text += `Confidence: <b>${conf}%</b> | Status: ${ctx.status}\n\n`;
+    const edges = (ctx.edges || []).slice(0, 8);
+    if (edges.length > 0) {
+        text += `<b>Top Edges:</b>\n<pre>`;
+        for (const e of edges) {
+            const name = (e.market || e.marketTitle || '???').slice(0, 35);
+            text += `${name.padEnd(36)} ${String(e.edge || 0).padStart(3)}¢ ${e.direction || 'yes'}\n`;
+        }
+        text += `</pre>`;
+    }
+    return text;
+}
+async function handlePositions() {
+    if (!(0, kalshi_js_1.isKalshiConfigured)())
+        return '⚠️ Kalshi not configured. Run <code>sf setup --kalshi</code>';
+    const positions = await (0, kalshi_js_1.getPositions)();
+    if (!positions || positions.length === 0)
+        return 'No open positions.';
+    // Enrich with live prices
+    let totalPnlCents = 0;
+    const lines = [];
+    for (const pos of positions) {
+        const livePrice = await (0, kalshi_js_1.getMarketPrice)(pos.ticker);
+        const current = livePrice ?? pos.average_price_paid;
+        const pnlCents = (current - pos.average_price_paid) * pos.quantity;
+        totalPnlCents += pnlCents;
+        const pnl = (0, format_js_1.fmtDollar)(pnlCents);
+        lines.push(`${pos.ticker.slice(0, 28).padEnd(29)} ${String(pos.quantity).padStart(5)} ${String(pos.average_price_paid).padStart(3)}¢→${String(current).padStart(3)}¢ ${pnl}`);
+    }
+    let text = `📊 <b>Positions</b>\n<pre>`;
+    text += lines.join('\n');
+    text += `\n${'─'.repeat(50)}\nTotal P&L: ${(0, format_js_1.fmtDollar)(totalPnlCents)}`;
+    text += `</pre>`;
+    return text;
+}
+async function handleEdges(client) {
+    const { theses } = await client.listTheses();
+    const active = (theses || []).filter((t) => t.status === 'active');
+    const results = await Promise.allSettled(active.map(async (t) => {
+        const ctx = await client.getContext(t.id);
+        return (ctx.edges || []).map((e) => ({ ...e, thesisId: t.id }));
+    }));
+    const allEdges = [];
+    for (const r of results) {
+        if (r.status === 'fulfilled')
+            allEdges.push(...r.value);
+    }
+    allEdges.sort((a, b) => Math.abs(b.edge || 0) - Math.abs(a.edge || 0));
+    const top = allEdges.slice(0, 10);
+    if (top.length === 0)
+        return 'No edges found.';
+    let text = `📈 <b>Top Edges</b>\n<pre>`;
+    for (const e of top) {
+        const name = (e.market || '???').slice(0, 35);
+        const liq = e.orderbook?.liquidityScore || '?';
+        text += `${name.padEnd(36)} +${String(e.edge || 0).padStart(2)}¢ ${liq}\n`;
+    }
+    text += `</pre>`;
+    return text;
+}
+async function handleBalance() {
+    if (!(0, kalshi_js_1.isKalshiConfigured)())
+        return '⚠️ Kalshi not configured.';
+    const bal = await (0, kalshi_js_1.getBalance)();
+    if (!bal)
+        return '⚠️ Failed to fetch balance.';
+    return `💰 Balance: <b>$${bal.balance.toFixed(2)}</b> | Portfolio: <b>$${bal.portfolioValue.toFixed(2)}</b>`;
+}
+async function handleOrders() {
+    if (!(0, kalshi_js_1.isKalshiConfigured)())
+        return '⚠️ Kalshi not configured.';
+    const result = await (0, kalshi_js_1.getOrders)({ status: 'resting', limit: 20 });
+    if (!result || !result.orders || result.orders.length === 0)
+        return 'No resting orders.';
+    let text = `📋 <b>Resting Orders</b>\n<pre>`;
+    for (const o of result.orders) {
+        const qty = Math.round(parseFloat(o.remaining_count_fp || '0'));
+        const price = Math.round(parseFloat(o.yes_price_dollars || '0') * 100);
+        const ticker = (o.ticker || '???').slice(0, 25);
+        text += `${o.action} ${qty}x ${ticker} @ ${price}¢\n`;
+    }
+    text += `</pre>`;
+    return text;
+}
+async function handleEval(client, thesisId) {
+    await client.evaluate(thesisId);
+    return '⚡ Evaluation triggered. Results in ~2 minutes.';
+}
+async function handleList(client) {
+    const { theses } = await client.listTheses();
+    if (!theses || theses.length === 0)
+        return 'No theses.';
+    let text = `📝 <b>Theses</b>\n<pre>`;
+    for (const t of theses) {
+        const conf = typeof t.confidence === 'number' ? Math.round(t.confidence * 100) : 0;
+        const title = (t.rawThesis || t.thesis || '').slice(0, 50);
+        text += `${t.id.slice(0, 8)} ${String(conf).padStart(3)}% ${t.status.padEnd(8)} ${title}\n`;
+    }
+    text += `</pre>`;
+    return text;
+}

package/dist/telegram/format.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Telegram message formatting utilities
+ */
+/** Split long text into chunks under Telegram's 4096 char limit */
+export declare function splitMessage(text: string, maxLen?: number): string[];
+/** Format a number as dollars */
+export declare function fmtDollar(cents: number): string;
+/** Simple sparkline */
+export declare function sparkline(values: number[]): string;
+/** Escape HTML special characters for Telegram HTML parse mode */
+export declare function escapeHtml(s: string): string;

package/dist/telegram/format.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Telegram message formatting utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitMessage = splitMessage;
+exports.fmtDollar = fmtDollar;
+exports.sparkline = sparkline;
+exports.escapeHtml = escapeHtml;
+/** Split long text into chunks under Telegram's 4096 char limit */
+function splitMessage(text, maxLen = 4000) {
+    if (text.length <= maxLen)
+        return [text];
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= maxLen) {
+            chunks.push(remaining);
+            break;
+        }
+        // Find a good split point (newline near maxLen)
+        let splitAt = remaining.lastIndexOf('\n', maxLen);
+        if (splitAt < maxLen * 0.5)
+            splitAt = maxLen;
+        chunks.push(remaining.slice(0, splitAt));
+        remaining = remaining.slice(splitAt);
+    }
+    return chunks;
+}
+/** Format a number as dollars */
+function fmtDollar(cents) {
+    const d = cents / 100;
+    return d >= 0 ? `+$${d.toFixed(2)}` : `-$${Math.abs(d).toFixed(2)}`;
+}
+/** Simple sparkline */
+function sparkline(values) {
+    if (values.length === 0)
+        return '';
+    const min = Math.min(...values);
+    const max = Math.max(...values);
+    const range = max - min || 1;
+    const blocks = '▁▂▃▄▅▆▇█';
+    return values.map(v => {
+        const idx = Math.round(((v - min) / range) * 7);
+        return blocks[idx];
+    }).join('');
+}
+/** Escape HTML special characters for Telegram HTML parse mode */
+function escapeHtml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}

package/dist/telegram/format.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/telegram/format.test.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const format_js_1 = require("./format.js");
+(0, vitest_1.describe)('splitMessage', () => {
+    (0, vitest_1.it)('returns single chunk for short text', () => {
+        (0, vitest_1.expect)((0, format_js_1.splitMessage)('short text')).toEqual(['short text']);
+    });
+    (0, vitest_1.it)('splits long text at newlines', () => {
+        const lines = Array.from({ length: 50 }, (_, i) => `Line ${i}`).join('\n');
+        const chunks = (0, format_js_1.splitMessage)(lines, 100);
+        for (const chunk of chunks) {
+            (0, vitest_1.expect)(chunk.length).toBeLessThanOrEqual(100);
+        }
+        (0, vitest_1.expect)(chunks.join('')).toBe(lines);
+    });
+    (0, vitest_1.it)('splits at maxLen when no good newline found', () => {
+        const long = 'x'.repeat(200);
+        const chunks = (0, format_js_1.splitMessage)(long, 100);
+        (0, vitest_1.expect)(chunks.length).toBe(2);
+        (0, vitest_1.expect)(chunks[0].length).toBe(100);
+    });
+    (0, vitest_1.it)('handles empty string', () => {
+        (0, vitest_1.expect)((0, format_js_1.splitMessage)('')).toEqual(['']);
+    });
+});
+(0, vitest_1.describe)('fmtDollar', () => {
+    (0, vitest_1.it)('formats positive cents', () => {
+        (0, vitest_1.expect)((0, format_js_1.fmtDollar)(550)).toBe('+$5.50');
+    });
+    (0, vitest_1.it)('formats negative cents', () => {
+        (0, vitest_1.expect)((0, format_js_1.fmtDollar)(-200)).toBe('-$2.00');
+    });
+    (0, vitest_1.it)('formats zero', () => {
+        (0, vitest_1.expect)((0, format_js_1.fmtDollar)(0)).toBe('+$0.00');
+    });
+});
+(0, vitest_1.describe)('sparkline', () => {
+    (0, vitest_1.it)('generates sparkline of correct length', () => {
+        const result = (0, format_js_1.sparkline)([1, 5, 3, 8, 2]);
+        (0, vitest_1.expect)(result.length).toBe(5);
+    });
+    (0, vitest_1.it)('returns empty for empty array', () => {
+        (0, vitest_1.expect)((0, format_js_1.sparkline)([])).toBe('');
+    });
+    (0, vitest_1.it)('handles single value', () => {
+        const result = (0, format_js_1.sparkline)([5]);
+        (0, vitest_1.expect)(result.length).toBe(1);
+    });
+    (0, vitest_1.it)('handles equal values', () => {
+        const result = (0, format_js_1.sparkline)([3, 3, 3]);
+        (0, vitest_1.expect)(result.length).toBe(3);
+    });
+    (0, vitest_1.it)('uses correct block chars for min/max', () => {
+        const result = (0, format_js_1.sparkline)([0, 100]);
+        (0, vitest_1.expect)(result[0]).toBe('▁');
+        (0, vitest_1.expect)(result[1]).toBe('█');
+    });
+});
+(0, vitest_1.describe)('escapeHtml', () => {
+    (0, vitest_1.it)('escapes ampersands', () => {
+        (0, vitest_1.expect)((0, format_js_1.escapeHtml)('a&b')).toBe('a&b');
+    });
+    (0, vitest_1.it)('escapes angle brackets', () => {
+        (0, vitest_1.expect)((0, format_js_1.escapeHtml)('<div>')).toBe('&lt;div&gt;');
+    });
+    (0, vitest_1.it)('escapes multiple characters', () => {
+        (0, vitest_1.expect)((0, format_js_1.escapeHtml)('<script>alert("xss")&</script>')).toBe('&lt;script&gt;alert("xss")&amp;&lt;/script&gt;');
+    });
+    (0, vitest_1.it)('leaves safe strings unchanged', () => {
+        (0, vitest_1.expect)((0, format_js_1.escapeHtml)('hello world')).toBe('hello world');
+    });
+});

package/dist/telegram/poller.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Delta API poller — push confidence changes to Telegram
+ */
+import type { Bot } from 'grammy';
+import { SFClient } from '../client.js';
+export declare function startPoller(bot: Bot, chatId: number, client: SFClient, thesisId: string): NodeJS.Timeout;

package/dist/telegram/poller.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Delta API poller — push confidence changes to Telegram
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startPoller = startPoller;
+const format_js_1 = require("./format.js");
+function startPoller(bot, chatId, client, thesisId) {
+    let lastCheck = new Date().toISOString();
+    return setInterval(async () => {
+        try {
+            const changes = await client.getChanges(thesisId, lastCheck);
+            lastCheck = new Date().toISOString();
+            if (!changes || !changes.changed)
+                return;
+            const delta = changes.confidenceDelta ?? changes.delta ?? 0;
+            if (Math.abs(delta) < 0.02)
+                return;
+            const conf = typeof changes.confidence === 'number' ? Math.round(changes.confidence * 100) : '?';
+            const arrow = delta > 0 ? '📈' : '📉';
+            const sign = delta > 0 ? '+' : '';
+            const summary = changes.summary || changes.latestSummary || '';
+            let text = `${arrow} <b>Confidence ${sign}${Math.round(delta * 100)}% → ${conf}%</b>\n`;
+            if (summary)
+                text += `${(0, format_js_1.escapeHtml)(summary.slice(0, 200))}`;
+            await bot.api.sendMessage(chatId, text, { parse_mode: 'HTML' });
+        }
+        catch {
+            // Silent — polling errors should not crash the bot
+        }
+    }, 60_000); // every 60 seconds
+}

package/dist/topics.d.ts

@@ -3,6 +3,9 @@
  *
  * Shared between dashboard, liquidity scanner, and other commands
  * that need to categorize markets by topic.
+ *
+ * Sourced from Kalshi's top series by volume (non-sports).
+ * Run `sf scan` to discover new series.
  */
 export declare const TOPIC_SERIES: Record<string, string[]>;
 /** Map a series prefix to a human-readable category name (for dashboard display) */

package/dist/topics.js

@@ -4,29 +4,87 @@
  *
  * Shared between dashboard, liquidity scanner, and other commands
  * that need to categorize markets by topic.
+ *
+ * Sourced from Kalshi's top series by volume (non-sports).
+ * Run `sf scan` to discover new series.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RISK_CATEGORIES = exports.TOPIC_SERIES = void 0;
 exports.tickerToTopic = tickerToTopic;
 exports.TOPIC_SERIES = {
-    oil: ['KXWTIMAX', 'KXWTIW', 'KXWTID'],
+    oil: ['KXWTIMAX', 'KXWTIW', 'KXWTID', 'KXWTI'],
+    gas: ['KXAAAGASM', 'KXAAAGASW', 'KXCPIGAS'],
+    fed: ['KXFEDDECISION', 'KXFED', 'KXRATECUT', 'KXRATECUTCOUNT'],
+    cpi: ['KXCPI', 'KXCPIYOY'],
     recession: ['KXRECSSNBER'],
-    fed: ['KXFEDDECISION'],
-    cpi: ['KXCPI'],
-    gas: ['KXAAAGASM'],
-    sp500: ['KXINXY'],
+    sp500: ['KXINXY', 'KXINXU', 'KXINX'],
+    nasdaq: ['KXNASDAQ100', 'KXNASDAQ100U', 'KXNASDAQ100Y'],
+    crypto: ['KXBTCD', 'KXBTC', 'KXBTC15M', 'KXBTCMAXY', 'KXBTCMINY', 'KXBTCY',
+        'KXETHD', 'KXETH', 'KXETH15M', 'KXETHMAXY', 'KXETHMINY',
+        'KXSOL15M', 'KXXRP15M'],
+    unemployment: ['KXU3', 'KXPAYROLLS'],
+    gdp: ['KXGDP'],
+    treasury: ['KXTNOTEW', 'KXTNOTED'],
+    geopolitics: ['KXCLOSEHORMUZ', 'KXHORMUZTRAFFICW', 'KXHORMUZTRAFFIC', 'KXHORMUZNORM',
+        'KXLEADERSOUT', 'KXLEADEROUT', 'KXMADUROOUT', 'KXKHAMENEIOUT'],
+    elections: ['PRES', 'KXFEDCHAIRNOM', 'KXPRESNOMD', 'KXPRESNOMR', 'KXPRESPERSON',
+        'KXNEXTPOPE', 'KXTRUMPOUT', 'KXCANADAPM'],
+    politics: ['KXGOVSHUT', 'KXGOVTSHUTDOWN', 'KXGOVSHUTLENGTH', 'KXGOVTCUTS',
+        'KXTRUMPMENTION', 'KXEOWEEK', 'KXGREENLAND', 'KXCANCOALITION'],
+    centralbanks: ['KXCBDECISIONJAPAN', 'KXCBDECISIONENGLAND', 'KXCBDECISIONEU',
+        'KXCBDECISIONAUSTRALIA', 'KXCBDECISIONCANADA', 'KXCBDECISIONCHINA',
+        'KXCBDECISIONMEXICO', 'KXCBDECISIONKOREA'],
+    forex: ['KXUSDJPY'],
+    tariffs: ['KXTARIFFRATEPRC', 'KXTARIFFRATECAN', 'KXTARIFFRATECA',
+        'KXTARIFFRATEINDIA', 'KXTARIFFRATEBR', 'KXTARIFFRATEEU',
+        'KXTARIFFRATEJP', 'KXTARIFFRATEKR'],
+    tech: ['KXLLM1', 'KXTOPMODEL', 'KXALIENS'],
 };
 /** Map a series prefix to a human-readable category name (for dashboard display) */
 exports.RISK_CATEGORIES = {
     KXWTIMAX: 'Oil',
+    KXWTIW: 'Oil',
+    KXWTID: 'Oil',
     KXWTI: 'Oil',
-    KXRECSSNBER: 'Recession',
     KXAAAGASM: 'Gas',
+    KXAAAGASW: 'Gas',
+    KXCPIGAS: 'Gas',
+    KXRECSSNBER: 'Recession',
     KXCPI: 'Inflation',
+    KXCPIYOY: 'Inflation',
     KXINXY: 'S&P 500',
+    KXINXU: 'S&P 500',
+    KXINX: 'S&P 500',
+    KXNASDAQ100: 'Nasdaq',
+    KXNASDAQ100U: 'Nasdaq',
+    KXNASDAQ100Y: 'Nasdaq',
     KXFEDDECISION: 'Fed Rate',
-    KXUNEMPLOYMENT: 'Unemployment',
+    KXFED: 'Fed Rate',
+    KXRATECUT: 'Fed Rate',
+    KXRATECUTCOUNT: 'Fed Rate',
+    KXBTCD: 'Bitcoin',
+    KXBTC: 'Bitcoin',
+    KXBTC15M: 'Bitcoin',
+    KXETHD: 'Ethereum',
+    KXETH: 'Ethereum',
+    KXETH15M: 'Ethereum',
+    KXU3: 'Unemployment',
+    KXPAYROLLS: 'Jobs',
+    KXGDP: 'GDP',
+    KXTNOTEW: 'Treasury',
+    KXTNOTED: 'Treasury',
     KXCLOSEHORMUZ: 'Hormuz',
+    KXHORMUZTRAFFICW: 'Hormuz',
+    KXHORMUZTRAFFIC: 'Hormuz',
+    KXUSDJPY: 'USD/JPY',
+    KXGOVSHUT: 'Govt Shutdown',
+    KXGOVTSHUTDOWN: 'Govt Shutdown',
+    PRES: 'Elections',
+    KXFEDCHAIRNOM: 'Elections',
+    KXTARIFFRATEPRC: 'Tariffs',
+    KXCBDECISIONJAPAN: 'Central Banks',
+    KXCBDECISIONENGLAND: 'Central Banks',
+    KXCBDECISIONEU: 'Central Banks',
 };
 /**
  * Given a ticker string, return the topic name (uppercased).

package/dist/topics.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/topics.test.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const topics_js_1 = require("./topics.js");
+(0, vitest_1.describe)('tickerToTopic', () => {
+    (0, vitest_1.it)('matches oil tickers (longest prefix first)', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXWTIMAX-26DEC31-T135')).toBe('OIL');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXWTID-something')).toBe('OIL');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXWTIW-2026')).toBe('OIL');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXWTI-26MAR24-T100')).toBe('OIL');
+    });
+    (0, vitest_1.it)('matches recession', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXRECSSNBER-26')).toBe('RECESSION');
+    });
+    (0, vitest_1.it)('matches fed', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXFEDDECISION-2026')).toBe('FED');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXFED-something')).toBe('FED');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXRATECUT-2026')).toBe('FED');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXRATECUTCOUNT-2026')).toBe('FED');
+    });
+    (0, vitest_1.it)('matches cpi', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXCPI-26MAY-T0.4')).toBe('CPI');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXCPIYOY-2026')).toBe('CPI');
+    });
+    (0, vitest_1.it)('matches gas', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXAAAGASM-26MAR31-4.40')).toBe('GAS');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXAAAGASW-2026')).toBe('GAS');
+    });
+    (0, vitest_1.it)('matches sp500', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXINXY-26DEC31H1600-T4000')).toBe('SP500');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXINXU-2026')).toBe('SP500');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXINX-2026')).toBe('SP500');
+    });
+    (0, vitest_1.it)('matches nasdaq', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXNASDAQ100-2026')).toBe('NASDAQ');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXNASDAQ100U-2026')).toBe('NASDAQ');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXNASDAQ100Y-2026')).toBe('NASDAQ');
+    });
+    (0, vitest_1.it)('matches crypto', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXBTCD-2026')).toBe('CRYPTO');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXBTC15M-2026')).toBe('CRYPTO');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXBTCMAXY-2026')).toBe('CRYPTO');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXETHD-2026')).toBe('CRYPTO');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXETH15M-2026')).toBe('CRYPTO');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXSOL15M-2026')).toBe('CRYPTO');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXXRP15M-2026')).toBe('CRYPTO');
+    });
+    (0, vitest_1.it)('matches unemployment & jobs', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXU3-2026')).toBe('UNEMPLOYMENT');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXPAYROLLS-2026')).toBe('UNEMPLOYMENT');
+    });
+    (0, vitest_1.it)('matches gdp', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXGDP-Q1-2026')).toBe('GDP');
+    });
+    (0, vitest_1.it)('matches geopolitics', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXCLOSEHORMUZ-2026')).toBe('GEOPOLITICS');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXHORMUZTRAFFICW-26MAR')).toBe('GEOPOLITICS');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXKHAMENEIOUT-2026')).toBe('GEOPOLITICS');
+    });
+    (0, vitest_1.it)('matches elections', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('PRES-2028')).toBe('ELECTIONS');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXFEDCHAIRNOM-2026')).toBe('ELECTIONS');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXTRUMPOUT-2026')).toBe('ELECTIONS');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXNEXTPOPE-2026')).toBe('ELECTIONS');
+    });
+    (0, vitest_1.it)('matches politics', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXGOVSHUT-2026')).toBe('POLITICS');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXGOVTSHUTDOWN-2026')).toBe('POLITICS');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXGREENLAND-2026')).toBe('POLITICS');
+    });
+    (0, vitest_1.it)('matches central banks', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXCBDECISIONJAPAN-2026')).toBe('CENTRALBANKS');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXCBDECISIONEU-2026')).toBe('CENTRALBANKS');
+    });
+    (0, vitest_1.it)('matches tariffs', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXTARIFFRATEPRC-2026')).toBe('TARIFFS');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXTARIFFRATECA-2026')).toBe('TARIFFS');
+    });
+    (0, vitest_1.it)('matches treasury', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXTNOTEW-2026')).toBe('TREASURY');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXTNOTED-2026')).toBe('TREASURY');
+    });
+    (0, vitest_1.it)('matches forex', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXUSDJPY-2026')).toBe('FOREX');
+    });
+    (0, vitest_1.it)('matches tech', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXLLM1-2026')).toBe('TECH');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('KXTOPMODEL-2026')).toBe('TECH');
+    });
+    (0, vitest_1.it)('returns OTHER for unknown tickers', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('UNKNOWN-TICKER')).toBe('OTHER');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('RANDOMSERIES-123')).toBe('OTHER');
+    });
+    (0, vitest_1.it)('is case-insensitive', () => {
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('kxwtimax-lower')).toBe('OIL');
+        (0, vitest_1.expect)((0, topics_js_1.tickerToTopic)('kxbtcd-lower')).toBe('CRYPTO');
+    });
+});
+(0, vitest_1.describe)('TOPIC_SERIES', () => {
+    (0, vitest_1.it)('has all expected topics', () => {
+        const topics = Object.keys(topics_js_1.TOPIC_SERIES);
+        (0, vitest_1.expect)(topics).toEqual(vitest_1.expect.arrayContaining([
+            'oil', 'gas', 'fed', 'cpi', 'recession', 'sp500', 'nasdaq',
+            'crypto', 'unemployment', 'gdp', 'treasury', 'geopolitics',
+            'elections', 'politics', 'centralbanks', 'forex', 'tariffs', 'tech',
+        ]));
+    });
+    (0, vitest_1.it)('has at least 18 topics', () => {
+        (0, vitest_1.expect)(Object.keys(topics_js_1.TOPIC_SERIES).length).toBeGreaterThanOrEqual(18);
+    });
+    (0, vitest_1.it)('each topic has at least one series', () => {
+        for (const [, series] of Object.entries(topics_js_1.TOPIC_SERIES)) {
+            (0, vitest_1.expect)(series.length).toBeGreaterThan(0);
+        }
+    });
+});
+(0, vitest_1.describe)('RISK_CATEGORIES', () => {
+    (0, vitest_1.it)('maps oil series to Oil', () => {
+        (0, vitest_1.expect)(topics_js_1.RISK_CATEGORIES['KXWTIMAX']).toBe('Oil');
+        (0, vitest_1.expect)(topics_js_1.RISK_CATEGORIES['KXWTI']).toBe('Oil');
+    });
+    (0, vitest_1.it)('maps crypto series', () => {
+        (0, vitest_1.expect)(topics_js_1.RISK_CATEGORIES['KXBTCD']).toBe('Bitcoin');
+        (0, vitest_1.expect)(topics_js_1.RISK_CATEGORIES['KXETHD']).toBe('Ethereum');
+    });
+    (0, vitest_1.it)('maps financial series', () => {
+        (0, vitest_1.expect)(topics_js_1.RISK_CATEGORIES['KXINXY']).toBe('S&P 500');
+        (0, vitest_1.expect)(topics_js_1.RISK_CATEGORIES['KXNASDAQ100']).toBe('Nasdaq');
+        (0, vitest_1.expect)(topics_js_1.RISK_CATEGORIES['KXFEDDECISION']).toBe('Fed Rate');
+    });
+});

package/dist/tui/border.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Border drawing — thin box-drawing characters
+ */
+import type { ScreenBuffer } from './screen.js';
+import type { Region } from './layout.js';
+export declare const rgb: (r: number, g: number, b: number) => string;
+export declare const bgRgb: (r: number, g: number, b: number) => string;
+export declare const CLR: {
+    border: string;
+    borderDim: string;
+    title: string;
+    text: string;
+    dim: string;
+    veryDim: string;
+    emerald: string;
+    green: string;
+    red: string;
+    yellow: string;
+    white: string;
+    bg: string;
+    bgPanel: string;
+};
+/** Draw a bordered box with title */
+export declare function drawBorder(screen: ScreenBuffer, region: Region, title?: string): void;
+/** Draw a horizontal divider across a region at a relative row */
+export declare function drawHDivider(screen: ScreenBuffer, region: Region, relRow: number): void;
+/** Pad/truncate string to exact width */
+export declare function fit(s: string, width: number, align?: 'left' | 'right'): string;
+/** Build sparkline from values */
+export declare function sparkline(values: number[], colorFn?: (v: number) => string): Array<{
+    text: string;
+    fg?: string;
+}>;