@spfunctions/cli 1.1.4 → 1.1.6

package/dist/commands/announcements.d.ts

@@ -0,0 +1,3 @@
+export declare function announcementsCommand(opts: {
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/announcements.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.announcementsCommand = announcementsCommand;
+const kalshi_js_1 = require("../kalshi.js");
+const utils_js_1 = require("../utils.js");
+async function announcementsCommand(opts) {
+    const announcements = await (0, kalshi_js_1.getExchangeAnnouncements)();
+    if (opts.json) {
+        console.log(JSON.stringify(announcements, null, 2));
+        return;
+    }
+    if (announcements.length === 0) {
+        console.log(`${utils_js_1.c.dim}No announcements.${utils_js_1.c.reset}`);
+        return;
+    }
+    console.log(`${utils_js_1.c.bold}${utils_js_1.c.cyan}Exchange Announcements${utils_js_1.c.reset}`);
+    console.log(`${utils_js_1.c.dim}${'─'.repeat(70)}${utils_js_1.c.reset}`);
+    for (const a of announcements.slice(0, 20)) {
+        const time = a.created_time ? new Date(a.created_time).toLocaleDateString() : '';
+        const type = a.type ? `[${a.type}]` : '';
+        console.log(`  ${utils_js_1.c.dim}${time}${utils_js_1.c.reset}  ${type} ${a.title || a.message || ''}`);
+        if (a.body) {
+            const body = String(a.body).slice(0, 120);
+            console.log(`    ${utils_js_1.c.dim}${body}${utils_js_1.c.reset}`);
+        }
+    }
+    console.log(`\n${utils_js_1.c.dim}${announcements.length} announcement(s)${utils_js_1.c.reset}`);
+}

package/dist/commands/balance.d.ts

@@ -0,0 +1,3 @@
+export declare function balanceCommand(opts: {
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/balance.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.balanceCommand = balanceCommand;
+const kalshi_js_1 = require("../kalshi.js");
+const utils_js_1 = require("../utils.js");
+async function balanceCommand(opts) {
+    const result = await (0, kalshi_js_1.getBalance)();
+    if (!result)
+        throw new Error('Kalshi not configured. Set KALSHI_API_KEY_ID + KALSHI_PRIVATE_KEY_PATH.');
+    if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(`${utils_js_1.c.bold}${utils_js_1.c.cyan}Kalshi Account${utils_js_1.c.reset}`);
+    console.log(`  Balance:         $${result.balance.toFixed(2)}`);
+    console.log(`  Portfolio Value: $${result.portfolioValue.toFixed(2)}`);
+}

package/dist/commands/cancel.d.ts

@@ -0,0 +1,5 @@
+export declare function cancelCommand(orderId: string | undefined, opts: {
+    all?: boolean;
+    ticker?: string;
+    yesIAmSure?: boolean;
+}): Promise<void>;

package/dist/commands/cancel.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cancelCommand = cancelCommand;
+const kalshi_js_1 = require("../kalshi.js");
+const config_js_1 = require("../config.js");
+const utils_js_1 = require("../utils.js");
+async function cancelCommand(orderId, opts) {
+    (0, config_js_1.requireTrading)();
+    if (opts.all) {
+        const result = await (0, kalshi_js_1.getOrders)({ status: 'resting', limit: 200 });
+        if (!result)
+            throw new Error('Kalshi not configured.');
+        let toCancel = result.orders;
+        if (opts.ticker) {
+            toCancel = toCancel.filter((o) => (o.ticker || '').startsWith(opts.ticker));
+        }
+        if (toCancel.length === 0) {
+            console.log(`\n  ${utils_js_1.c.dim}No resting orders to cancel.${utils_js_1.c.reset}\n`);
+            return;
+        }
+        console.log(`\n  Cancelling ${toCancel.length} order(s)...`);
+        if (!opts.yesIAmSure) {
+            for (let i = 3; i > 0; i--) {
+                process.stdout.write(`  Executing in ${i}...  (Ctrl+C to cancel)\r`);
+                await new Promise(r => setTimeout(r, 1000));
+            }
+            process.stdout.write('  Executing...                              \n');
+        }
+        for (let i = 0; i < toCancel.length; i += 20) {
+            const batch = toCancel.slice(i, i + 20).map((o) => o.order_id);
+            await (0, kalshi_js_1.batchCancelOrders)(batch);
+        }
+        console.log(`\n  ${utils_js_1.c.green}✓${utils_js_1.c.reset} Cancelled ${toCancel.length} order(s).\n`);
+        return;
+    }
+    if (!orderId) {
+        throw new Error('Usage: sf cancel <orderId> or sf cancel --all');
+    }
+    await (0, kalshi_js_1.cancelOrder)(orderId);
+    console.log(`\n  ${utils_js_1.c.green}✓${utils_js_1.c.reset} Order ${orderId} cancelled.\n`);
+}

package/dist/commands/dashboard.d.ts

@@ -0,0 +1,11 @@
+/**
+ * sf dashboard — Portfolio overview
+ *
+ * One-screen summary: theses, positions, risk exposure, top unpositioned edges.
+ * Uses existing APIs + local Kalshi positions.
+ */
+export declare function dashboardCommand(opts?: {
+    json?: boolean;
+    apiKey?: string;
+    apiUrl?: string;
+}): Promise<void>;

package/dist/commands/dashboard.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * sf dashboard — Portfolio overview
+ *
+ * One-screen summary: theses, positions, risk exposure, top unpositioned edges.
+ * Uses existing APIs + local Kalshi positions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dashboardCommand = dashboardCommand;
+const client_js_1 = require("../client.js");
+const kalshi_js_1 = require("../kalshi.js");
+// ── Risk category mapping by Kalshi ticker prefix ────────────────────────────
+const RISK_CATEGORIES = {
+    KXWTIMAX: 'Oil',
+    KXWTI: 'Oil',
+    KXRECSSNBER: 'Recession',
+    KXAAAGASM: 'Gas',
+    KXCPI: 'Inflation',
+    KXINXY: 'S&P 500',
+    KXFEDDECISION: 'Fed Rate',
+    KXUNEMPLOYMENT: 'Unemployment',
+    KXCLOSEHORMUZ: 'Hormuz',
+};
+function categorize(ticker) {
+    // Match longest prefix first
+    const sorted = Object.keys(RISK_CATEGORIES).sort((a, b) => b.length - a.length);
+    for (const prefix of sorted) {
+        if (ticker.startsWith(prefix))
+            return RISK_CATEGORIES[prefix];
+    }
+    return 'Other';
+}
+function timeAgo(dateStr) {
+    const diff = Date.now() - new Date(dateStr).getTime();
+    const mins = Math.floor(diff / 60000);
+    if (mins < 60)
+        return `${mins}m ago`;
+    const hrs = Math.floor(mins / 60);
+    if (hrs < 24)
+        return `${hrs}h ago`;
+    const days = Math.floor(hrs / 24);
+    return `${days}d ago`;
+}
+async function dashboardCommand(opts) {
+    const client = new client_js_1.SFClient(opts?.apiKey, opts?.apiUrl);
+    // ── Fetch data in parallel ─────────────────────────────────────────────────
+    const [thesesResult, positions] = await Promise.all([
+        client.listTheses(),
+        (0, kalshi_js_1.getPositions)().catch(() => null),
+    ]);
+    const theses = thesesResult.theses || thesesResult;
+    // Fetch context for each thesis (edges)
+    const contexts = [];
+    for (const t of theses) {
+        try {
+            const ctx = await client.getContext(t.id);
+            contexts.push(ctx);
+        }
+        catch {
+            contexts.push(null);
+        }
+    }
+    // Enrich positions with live prices
+    if (positions) {
+        for (const pos of positions) {
+            const livePrice = await (0, kalshi_js_1.getMarketPrice)(pos.ticker);
+            if (livePrice !== null) {
+                pos.current_value = livePrice;
+                pos.unrealized_pnl = Math.round((livePrice - pos.average_price_paid) * pos.quantity);
+            }
+        }
+    }
+    // ── Collect all edges across all theses ────────────────────────────────────
+    const allEdges = [];
+    for (const ctx of contexts) {
+        if (!ctx?.edges)
+            continue;
+        for (const e of ctx.edges) {
+            allEdges.push(e);
+        }
+    }
+    // Dedupe edges by marketId (keep highest absolute edge)
+    const edgeMap = new Map();
+    for (const e of allEdges) {
+        const existing = edgeMap.get(e.marketId);
+        if (!existing || Math.abs(e.edge) > Math.abs(existing.edge)) {
+            edgeMap.set(e.marketId, e);
+        }
+    }
+    // Find positioned tickers
+    const positionedTickers = new Set(positions?.map((p) => p.ticker) || []);
+    // Unpositioned edges = edges where no position exists on that marketId
+    const unpositionedEdges = [...edgeMap.values()]
+        .filter(e => !positionedTickers.has(e.marketId))
+        .sort((a, b) => Math.abs(b.edge) - Math.abs(a.edge))
+        .slice(0, 10);
+    // ── JSON output ────────────────────────────────────────────────────────────
+    if (opts?.json) {
+        console.log(JSON.stringify({
+            theses,
+            positions,
+            unpositionedEdges,
+        }, null, 2));
+        return;
+    }
+    // ── Formatted output ───────────────────────────────────────────────────────
+    console.log();
+    console.log('  SimpleFunctions Dashboard');
+    console.log('  ' + '─'.repeat(50));
+    console.log();
+    // ── Theses ─────────────────────────────────────────────────────────────────
+    console.log('  Theses');
+    if (theses.length === 0) {
+        console.log('    (none)');
+    }
+    else {
+        for (let i = 0; i < theses.length; i++) {
+            const t = theses[i];
+            const ctx = contexts[i];
+            const id = t.id.slice(0, 8);
+            const title = (t.title || '').slice(0, 35).padEnd(35);
+            const conf = t.confidence != null ? `${Math.round(t.confidence * 100)}%` : '?%';
+            const edgeCount = ctx?.edges?.length || 0;
+            const updated = t.updatedAt ? timeAgo(t.updatedAt) : '?';
+            console.log(`    ${id}  ${title}  ${conf.padStart(4)}  ${String(edgeCount).padStart(2)} edges  updated ${updated}`);
+        }
+    }
+    console.log();
+    // ── Positions ──────────────────────────────────────────────────────────────
+    console.log('  Positions');
+    if (!positions || positions.length === 0) {
+        console.log('    (no Kalshi positions or Kalshi not configured)');
+    }
+    else {
+        let totalCost = 0;
+        let totalPnl = 0;
+        for (const p of positions) {
+            const ticker = (p.ticker || '').padEnd(22);
+            const qty = String(p.quantity || 0).padStart(5);
+            const avg = `${p.average_price_paid || 0}¢`;
+            const now = typeof p.current_value === 'number' ? `${p.current_value}¢` : '?¢';
+            const pnlCents = p.unrealized_pnl || 0;
+            const pnlDollars = (pnlCents / 100).toFixed(2);
+            const pnlStr = pnlCents >= 0 ? `+$${pnlDollars}` : `-$${Math.abs(parseFloat(pnlDollars)).toFixed(2)}`;
+            const cost = (p.average_price_paid || 0) * (p.quantity || 0);
+            totalCost += cost;
+            totalPnl += pnlCents;
+            console.log(`    ${ticker} ${qty} @ ${avg.padEnd(5)} now ${now.padEnd(5)}  ${pnlStr}`);
+        }
+        console.log('    ' + '─'.repeat(45));
+        const totalCostDollars = (totalCost / 100).toFixed(0);
+        const totalPnlDollars = (totalPnl / 100).toFixed(2);
+        const pnlDisplay = totalPnl >= 0 ? `+$${totalPnlDollars}` : `-$${Math.abs(parseFloat(totalPnlDollars)).toFixed(2)}`;
+        console.log(`    Total cost: $${totalCostDollars}  |  P&L: ${pnlDisplay}`);
+    }
+    console.log();
+    // ── Risk Exposure ──────────────────────────────────────────────────────────
+    if (positions && positions.length > 0) {
+        console.log('  Risk Exposure');
+        const riskGroups = new Map();
+        for (const p of positions) {
+            const cat = categorize(p.ticker || '');
+            const existing = riskGroups.get(cat) || { cost: 0, contracts: 0, tickers: [] };
+            const cost = (p.average_price_paid || 0) * (p.quantity || 0);
+            existing.cost += cost;
+            existing.contracts += p.quantity || 0;
+            if (!existing.tickers.includes(p.ticker))
+                existing.tickers.push(p.ticker);
+            riskGroups.set(cat, existing);
+        }
+        // Sort by cost descending
+        const sorted = [...riskGroups.entries()].sort((a, b) => b[1].cost - a[1].cost);
+        for (const [category, data] of sorted) {
+            const costDollars = `$${(data.cost / 100).toFixed(0)}`;
+            const tickerSummary = data.tickers.length <= 2
+                ? ` (${data.tickers.join('+')})`
+                : ` (${data.tickers.length} markets)`;
+            console.log(`    ${(category + tickerSummary + ':').padEnd(35)} ${costDollars.padStart(7)} cost  |  ${String(data.contracts).padStart(5)} contracts`);
+        }
+        console.log();
+    }
+    // ── Top Unpositioned Edges ─────────────────────────────────────────────────
+    if (unpositionedEdges.length > 0) {
+        console.log('  Top Unpositioned Edges');
+        for (const e of unpositionedEdges) {
+            const name = (e.market || e.marketId || '').slice(0, 25).padEnd(25);
+            const mkt = `${e.marketPrice}¢`;
+            const thesis = `${e.thesisPrice}¢`;
+            const edge = e.edge > 0 ? `+${e.edge}` : `${e.edge}`;
+            const liq = e.orderbook?.liquidityScore || '?';
+            console.log(`    ${name} ${mkt.padStart(5)} → ${thesis.padStart(5)}  edge ${edge.padStart(4)}  ${liq}`);
+        }
+        console.log();
+    }
+}

package/dist/commands/explore.d.ts

@@ -0,0 +1,13 @@
+/**
+ * sf explore [slug]
+ *
+ * Browse public theses. No authentication required.
+ *
+ * Usage:
+ *   sf explore                     — List all public theses
+ *   sf explore us-iran-war         — View a specific public thesis
+ *   sf explore us-iran-war --json  — JSON output (for agents)
+ */
+export declare function exploreCommand(slug?: string, opts?: {
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/explore.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * sf explore [slug]
+ *
+ * Browse public theses. No authentication required.
+ *
+ * Usage:
+ *   sf explore                     — List all public theses
+ *   sf explore us-iran-war         — View a specific public thesis
+ *   sf explore us-iran-war --json  — JSON output (for agents)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exploreCommand = exploreCommand;
+const BASE_URL = 'https://simplefunctions.dev';
+async function exploreCommand(slug, opts) {
+    if (!slug) {
+        // List all public theses
+        const res = await fetch(`${BASE_URL}/api/public/theses`);
+        if (!res.ok) {
+            console.error(`  Error: ${res.status} ${await res.text()}`);
+            return;
+        }
+        const { theses } = await res.json();
+        if (opts?.json) {
+            console.log(JSON.stringify(theses, null, 2));
+            return;
+        }
+        console.log('\n  Public Theses\n');
+        if (theses.length === 0) {
+            console.log('  No public theses yet.\n');
+            return;
+        }
+        for (const t of theses) {
+            const conf = t.confidence != null ? Math.round(t.confidence * 100) : '?';
+            const ret = t.impliedReturn != null ? `${t.impliedReturn > 0 ? '+' : ''}${t.impliedReturn}%` : '';
+            console.log(`  ${(t.slug || '').padEnd(35)} ${String(conf).padStart(3)}%  ${ret.padStart(8)}  ${(t.status || '').padEnd(8)} ${(t.title || '').slice(0, 45)}`);
+        }
+        console.log(`\n  ${theses.length} public theses. Use: sf explore <slug>\n`);
+        return;
+    }
+    // View a specific public thesis
+    const res = await fetch(`${BASE_URL}/api/public/thesis/${slug}`);
+    if (!res.ok) {
+        if (res.status === 404) {
+            console.error(`  Not found: ${slug}`);
+        }
+        else {
+            console.error(`  Error: ${res.status} ${await res.text()}`);
+        }
+        return;
+    }
+    const data = await res.json();
+    if (opts?.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    // Formatted output
+    const t = data.thesis;
+    const ir = data.impliedReturns;
+    console.log(`\n  ${t.title}`);
+    console.log(`  ${t.slug} | ${t.confidence != null ? Math.round(t.confidence * 100) : '?'}% | ${t.status} | published ${t.publishedAt?.slice(0, 10) || '?'}`);
+    if (t.description)
+        console.log(`  ${t.description}`);
+    console.log('');
+    // Causal tree
+    if (data.causalTree?.nodes?.length) {
+        console.log('  Causal Tree');
+        for (const n of data.causalTree.nodes) {
+            const bar = '█'.repeat(Math.round((n.probability || 0) * 10)) + '░'.repeat(10 - Math.round((n.probability || 0) * 10));
+            console.log(`    ${n.id} ${(n.label || '').slice(0, 35).padEnd(35)} ${Math.round((n.probability || 0) * 100)}% ${bar}`);
+            if (n.children) {
+                for (const c of n.children) {
+                    const cbar = '█'.repeat(Math.round((c.probability || 0) * 10)) + '░'.repeat(10 - Math.round((c.probability || 0) * 10));
+                    console.log(`      ${c.id} ${(c.label || '').slice(0, 33).padEnd(33)} ${Math.round((c.probability || 0) * 100)}% ${cbar}`);
+                }
+            }
+        }
+        console.log('');
+    }
+    // Implied returns
+    if (ir && ir.edges?.length > 0) {
+        console.log(`  Implied Returns (equal-weight, since ${ir.trackedSince?.slice(0, 10) || '?'})`);
+        console.log(`  Avg: ${ir.avgReturnPct > 0 ? '+' : ''}${ir.avgReturnPct}% | Win rate: ${ir.winRate}% (${ir.winners}W ${ir.losers}L)`);
+        console.log('');
+        for (const e of ir.edges.slice(0, 10)) {
+            const ret = e.returnPct > 0 ? `+${e.returnPct}%` : `${e.returnPct}%`;
+            console.log(`    ${(e.market || '').slice(0, 35).padEnd(35)} ${e.entryPrice}¢ → ${e.currentPrice}¢  ${ret}`);
+        }
+        console.log('');
+    }
+    // Recent evaluations
+    if (data.confidenceHistory?.length > 0) {
+        console.log('  Recent Evaluations');
+        for (const h of data.confidenceHistory.slice(-5)) {
+            const d = h.delta > 0 ? `+${Math.round(h.delta * 100)}` : `${Math.round(h.delta * 100)}`;
+            console.log(`    ${(h.evaluatedAt || '').slice(0, 16)} ${Math.round(h.confidence * 100)}% (${d}) ${(h.summary || '').slice(0, 60)}`);
+        }
+        console.log('');
+    }
+    // Top edges
+    if (data.edges?.length > 0) {
+        console.log('  Top Edges');
+        const sorted = [...data.edges].sort((a, b) => Math.abs(b.edge) - Math.abs(a.edge)).slice(0, 10);
+        for (const e of sorted) {
+            const liq = e.orderbook?.liquidityScore || '?';
+            console.log(`    ${(e.market || '').slice(0, 35).padEnd(35)} ${e.marketPrice}¢ → ${e.thesisPrice}¢  edge ${e.edge > 0 ? '+' : ''}${e.edge}  ${liq}`);
+        }
+        console.log('');
+    }
+}

package/dist/commands/fills.d.ts

@@ -0,0 +1,4 @@
+export declare function fillsCommand(opts: {
+    ticker?: string;
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/fills.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fillsCommand = fillsCommand;
+const kalshi_js_1 = require("../kalshi.js");
+const utils_js_1 = require("../utils.js");
+async function fillsCommand(opts) {
+    const result = await (0, kalshi_js_1.getFills)({ ticker: opts.ticker, limit: 50 });
+    if (!result)
+        throw new Error('Kalshi not configured. Set KALSHI_API_KEY_ID + KALSHI_PRIVATE_KEY_PATH.');
+    if (opts.json) {
+        console.log(JSON.stringify(result.fills, null, 2));
+        return;
+    }
+    if (result.fills.length === 0) {
+        console.log(`${utils_js_1.c.dim}No fills.${utils_js_1.c.reset}`);
+        return;
+    }
+    console.log(`${utils_js_1.c.bold}${utils_js_1.c.cyan}Recent Fills${utils_js_1.c.reset}`);
+    console.log(`${utils_js_1.c.dim}${'─'.repeat(80)}${utils_js_1.c.reset}`);
+    for (const f of result.fills) {
+        const price = f.yes_price_dollars ? `${parseFloat(f.yes_price_dollars) * 100}¢` : `${f.yes_price || '?'}¢`;
+        const side = f.side === 'yes' ? `${utils_js_1.c.green}YES${utils_js_1.c.reset}` : `${utils_js_1.c.red}NO${utils_js_1.c.reset}`;
+        const action = f.action || 'buy';
+        const count = f.count_fp || f.count || '?';
+        const time = f.created_time ? new Date(f.created_time).toLocaleString() : '';
+        console.log(`  ${(f.ticker || '').padEnd(35)} ${action.padEnd(5)} ${side} ${price.padEnd(8)} x${count}  ${utils_js_1.c.dim}${time}${utils_js_1.c.reset}`);
+    }
+    console.log(`\n${utils_js_1.c.dim}${result.fills.length} fill(s)${utils_js_1.c.reset}`);
+}

package/dist/commands/forecast.d.ts

@@ -0,0 +1,4 @@
+export declare function forecastCommand(eventTicker: string, opts: {
+    days?: string;
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/forecast.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forecastCommand = forecastCommand;
+const kalshi_js_1 = require("../kalshi.js");
+const utils_js_1 = require("../utils.js");
+const KALSHI_API_BASE = 'https://api.elections.kalshi.com/trade-api/v2';
+async function forecastCommand(eventTicker, opts) {
+    const days = parseInt(opts.days || '7');
+    // Get series ticker from event
+    const evtRes = await fetch(`${KALSHI_API_BASE}/events/${eventTicker}`, {
+        headers: { 'Accept': 'application/json' },
+    });
+    if (!evtRes.ok)
+        throw new Error(`Event not found: ${eventTicker}`);
+    const evtData = await evtRes.json();
+    const seriesTicker = evtData.event?.series_ticker;
+    if (!seriesTicker)
+        throw new Error(`No series_ticker for ${eventTicker}`);
+    // Align timestamps to midnight UTC — Kalshi API rejects unaligned/future timestamps
+    const todayMidnight = new Date();
+    todayMidnight.setUTCHours(0, 0, 0, 0);
+    const endTs = Math.floor(todayMidnight.getTime() / 1000);
+    const startTs = endTs - days * 86400;
+    const history = await (0, kalshi_js_1.getForecastHistory)({
+        seriesTicker,
+        eventTicker,
+        percentiles: [5000, 7500, 9000],
+        startTs,
+        endTs,
+        periodInterval: 1440,
+    });
+    if (!history || history.length === 0) {
+        console.log(`${utils_js_1.c.dim}No forecast data for ${eventTicker}${utils_js_1.c.reset}`);
+        return;
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(history, null, 2));
+        return;
+    }
+    console.log(`${utils_js_1.c.bold}${utils_js_1.c.cyan}Forecast: ${evtData.event?.title || eventTicker}${utils_js_1.c.reset}`);
+    console.log(`${utils_js_1.c.dim}Series: ${seriesTicker} | ${days} days${utils_js_1.c.reset}`);
+    console.log();
+    console.log(`${utils_js_1.c.bold}${'Date'.padEnd(14)} ${'P50'.padEnd(12)} ${'P75'.padEnd(12)} P90${utils_js_1.c.reset}`);
+    console.log(`${utils_js_1.c.dim}${'─'.repeat(52)}${utils_js_1.c.reset}`);
+    for (const point of history) {
+        const date = new Date(point.end_period_ts * 1000).toISOString().slice(0, 10);
+        const pts = point.percentile_points || [];
+        const p50 = pts.find((p) => p.percentile === 5000)?.formatted_forecast || '-';
+        const p75 = pts.find((p) => p.percentile === 7500)?.formatted_forecast || '-';
+        const p90 = pts.find((p) => p.percentile === 9000)?.formatted_forecast || '-';
+        console.log(`  ${date.padEnd(14)} ${p50.padEnd(12)} ${p75.padEnd(12)} ${p90}`);
+    }
+}

package/dist/commands/history.d.ts

@@ -0,0 +1,3 @@
+export declare function historyCommand(ticker: string, opts: {
+    json?: boolean;
+}): Promise<void>;

package/dist/commands/history.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.historyCommand = historyCommand;
+const kalshi_js_1 = require("../kalshi.js");
+const utils_js_1 = require("../utils.js");
+async function historyCommand(ticker, opts) {
+    const market = await (0, kalshi_js_1.getHistoricalMarket)(ticker);
+    if (!market) {
+        console.log(`${utils_js_1.c.dim}No historical data for ${ticker}${utils_js_1.c.reset}`);
+        return;
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(market, null, 2));
+        return;
+    }
+    console.log(`${utils_js_1.c.bold}${utils_js_1.c.cyan}${market.title || ticker}${utils_js_1.c.reset}`);
+    console.log(`${utils_js_1.c.dim}${'─'.repeat(60)}${utils_js_1.c.reset}`);
+    console.log(`  Ticker:      ${market.ticker || ticker}`);
+    console.log(`  Event:       ${market.event_ticker || '-'}`);
+    console.log(`  Status:      ${market.status || '-'}`);
+    console.log(`  Result:      ${market.result || market.market_result || '-'}`);
+    if (market.last_price_dollars) {
+        console.log(`  Last Price:  ${Math.round(parseFloat(market.last_price_dollars) * 100)}¢`);
+    }
+    if (market.settlement_value !== undefined) {
+        console.log(`  Settlement:  ${market.settlement_value}`);
+    }
+    if (market.volume) {
+        console.log(`  Volume:      ${market.volume}`);
+    }
+    if (market.open_interest) {
+        console.log(`  Open Int:    ${market.open_interest}`);
+    }
+    if (market.expiration_time) {
+        console.log(`  Expired:     ${market.expiration_time}`);
+    }
+    console.log();
+}

package/dist/commands/milestones.d.ts

@@ -0,0 +1,8 @@
+export declare function milestonesCommand(opts: {
+    category?: string;
+    thesis?: string;
+    hours?: string;
+    json?: boolean;
+    apiKey?: string;
+    apiUrl?: string;
+}): Promise<void>;

package/dist/commands/milestones.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.milestonesCommand = milestonesCommand;
+const client_js_1 = require("../client.js");
+const utils_js_1 = require("../utils.js");
+const KALSHI_API_BASE = 'https://api.elections.kalshi.com/trade-api/v2';
+async function milestonesCommand(opts) {
+    const hours = parseInt(opts.hours || '168');
+    const now = new Date();
+    const cutoff = new Date(now.getTime() + hours * 3600000);
+    // Fetch milestones (public endpoint)
+    const url = `${KALSHI_API_BASE}/milestones?limit=200&minimum_start_date=${now.toISOString()}` +
+        (opts.category ? `&category=${opts.category}` : '');
+    const res = await fetch(url, { headers: { 'Accept': 'application/json' } });
+    if (!res.ok)
+        throw new Error(`Kalshi API ${res.status}`);
+    const data = await res.json();
+    let milestones = (data.milestones || []).filter((m) => new Date(m.start_date).getTime() <= cutoff.getTime());
+    // If thesis specified, filter to matching event tickers
+    if (opts.thesis) {
+        const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
+        const ctx = await client.getContext(opts.thesis);
+        const edgeEventTickers = new Set((ctx.edges || []).map((e) => e.eventTicker).filter(Boolean));
+        // Also match by related_event_tickers overlap
+        const edgeSeriesTickers = new Set((ctx.edges || []).map((e) => e.seriesTicker).filter(Boolean));
+        milestones = milestones.filter((m) => {
+            const related = m.related_event_tickers || m.primary_event_tickers || [];
+            return related.some((t) => edgeEventTickers.has(t) || edgeSeriesTickers.has(t.split('-')[0]));
+        });
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(milestones, null, 2));
+        return;
+    }
+    if (milestones.length === 0) {
+        console.log(`${utils_js_1.c.dim}No milestones in the next ${hours} hours.${utils_js_1.c.reset}`);
+        return;
+    }
+    // Sort by date
+    milestones.sort((a, b) => new Date(a.start_date).getTime() - new Date(b.start_date).getTime());
+    console.log(`${utils_js_1.c.bold}${utils_js_1.c.cyan}Upcoming Milestones (next ${hours}h)${utils_js_1.c.reset}`);
+    console.log(`${utils_js_1.c.dim}${'─'.repeat(80)}${utils_js_1.c.reset}`);
+    for (const m of milestones) {
+        const date = new Date(m.start_date);
+        const hoursUntil = Math.round((date.getTime() - now.getTime()) / 3600000);
+        const timeStr = hoursUntil <= 24
+            ? `${utils_js_1.c.bold}${hoursUntil}h${utils_js_1.c.reset}`
+            : `${utils_js_1.c.dim}${Math.round(hoursUntil / 24)}d${utils_js_1.c.reset}`;
+        const cat = `${utils_js_1.c.dim}[${m.category}]${utils_js_1.c.reset}`;
+        const tickers = (m.related_event_tickers || []).slice(0, 3).join(', ');
+        console.log(`  ${timeStr.padEnd(12)} ${cat.padEnd(25)} ${m.title}`);
+        if (tickers)
+            console.log(`  ${' '.repeat(10)} ${utils_js_1.c.dim}${tickers}${utils_js_1.c.reset}`);
+    }
+    console.log(`\n${utils_js_1.c.dim}${milestones.length} milestone(s)${utils_js_1.c.reset}`);
+}

package/dist/commands/orders.d.ts

@@ -0,0 +1,4 @@
+export declare function ordersCommand(opts: {
+    status?: string;
+    json?: boolean;
+}): Promise<void>;