@spfunctions/cli 1.7.8 → 1.7.11

package/dist/commands/context.js

@@ -4,10 +4,11 @@ exports.contextCommand = contextCommand;
 const client_js_1 = require("../client.js");
 const kalshi_js_1 = require("../kalshi.js");
 const utils_js_1 = require("../utils.js");
+const SF_API_URL = process.env.SF_API_URL || 'https://simplefunctions.dev';
 async function contextCommand(id, opts) {
-    // No thesis ID → global market snapshot
+    // ── Mode 1: No thesis ID → global market intelligence ─────────────────────
     if (!id) {
-        const res = await fetch('https://simplefunctions.dev/api/public/context');
+        const res = await fetch(`${opts.apiUrl || SF_API_URL}/api/public/context`);
         if (!res.ok) {
             console.error(`  Error: ${res.status} ${await res.text()}`);
             return;
@@ -17,63 +18,103 @@ async function contextCommand(id, opts) {
             console.log(JSON.stringify(data, null, 2));
             return;
         }
-        console.log(`\n${utils_js_1.c.bold}Market Snapshot${utils_js_1.c.reset}  ${(0, utils_js_1.shortDate)(data.snapshotAt)}\n`);
-        if (data.edges?.length > 0) {
-            console.log(`${utils_js_1.c.bold}Thesis Edges${utils_js_1.c.reset}`);
-            for (const m of data.edges.slice(0, 10)) {
+        const scanTime = data.scannedAt ? (0, utils_js_1.shortDate)(data.scannedAt) : 'no scan yet';
+        console.log(`\n${utils_js_1.c.bold}Markets${utils_js_1.c.reset}  ${utils_js_1.c.dim}scan: ${scanTime}${utils_js_1.c.reset}\n`);
+        // ── Traditional markets ticker bar ──────────────────────────────────────
+        const trad = data.traditional || [];
+        if (trad.length > 0) {
+            const line = trad.map((m) => {
+                const ch = m.changePct || 0;
+                const color = ch > 0 ? utils_js_1.c.green : ch < 0 ? utils_js_1.c.red : utils_js_1.c.dim;
+                const sign = ch > 0 ? '+' : '';
+                return `${utils_js_1.c.bold}${m.symbol}${utils_js_1.c.reset} ${m.price}  ${color}${sign}${ch.toFixed(1)}%${utils_js_1.c.reset}`;
+            }).join('    ');
+            console.log(`  ${line}`);
+            console.log();
+        }
+        // ── Movers ─────────────────────────────────────────────────────────────
+        const movers = data.movers || [];
+        if (movers.length > 0) {
+            console.log(`${utils_js_1.c.bold}Movers (24h)${utils_js_1.c.reset}`);
+            for (const m of movers.slice(0, 8)) {
                 const venue = m.venue === 'kalshi' ? `${utils_js_1.c.cyan}K${utils_js_1.c.reset}` : `${utils_js_1.c.magenta}P${utils_js_1.c.reset}`;
-                const edgeStr = m.edge > 0 ? `${utils_js_1.c.green}+${m.edge}¢${utils_js_1.c.reset}` : `${utils_js_1.c.red}${m.edge}¢${utils_js_1.c.reset}`;
-                console.log(`  ${venue} ${String(m.price).padStart(3)}¢  edge ${edgeStr.padStart(14)}  ${m.title.slice(0, 50)}`);
+                const ch = m.change24h || 0;
+                const chColor = ch > 0 ? utils_js_1.c.green : utils_js_1.c.red;
+                const chStr = `${chColor}${ch > 0 ? '+' : ''}${ch}¢${utils_js_1.c.reset}`;
+                const cat = m.category ? `${utils_js_1.c.dim}[${m.category}]${utils_js_1.c.reset}` : '';
+                console.log(`  ${venue} ${(0, utils_js_1.rpad)(`${m.price}¢`, 5)} ${(0, utils_js_1.rpad)(chStr, 16)}  ${(0, utils_js_1.trunc)(m.title, 50)}  ${cat}`);
+                // Actionable: show command to dig deeper
+                if (m.venue === 'kalshi' && m.ticker) {
+                    console.log(`    ${utils_js_1.c.dim}→ sf book ${m.ticker}${utils_js_1.c.reset}`);
+                }
+                else {
+                    console.log(`    ${utils_js_1.c.dim}→ sf query "${extractQuery(m.title)}"${utils_js_1.c.reset}`);
+                }
             }
             console.log();
         }
-        if (data.movers?.length > 0) {
-            console.log(`${utils_js_1.c.bold}Movers (24h)${utils_js_1.c.reset}`);
-            for (const m of data.movers.slice(0, 8)) {
+        // ── Liquid markets ─────────────────────────────────────────────────────
+        const liquid = data.liquid || [];
+        if (liquid.length > 0) {
+            console.log(`${utils_js_1.c.bold}Most Liquid${utils_js_1.c.reset}`);
+            for (const m of liquid.slice(0, 6)) {
                 const venue = m.venue === 'kalshi' ? `${utils_js_1.c.cyan}K${utils_js_1.c.reset}` : `${utils_js_1.c.magenta}P${utils_js_1.c.reset}`;
-                const ch = m.change24h > 0 ? `${utils_js_1.c.green}+${m.change24h}¢${utils_js_1.c.reset}` : `${utils_js_1.c.red}${m.change24h}¢${utils_js_1.c.reset}`;
-                console.log(`  ${venue} ${String(m.price).padStart(3)}¢ ${ch.padStart(16)}  ${m.title.slice(0, 55)}`);
+                console.log(`  ${venue} ${(0, utils_js_1.rpad)(`${m.price}¢`, 5)}  spread ${m.spread}¢  vol ${(0, utils_js_1.vol)(Math.round(m.volume24h))}  ${(0, utils_js_1.trunc)(m.title, 45)}`);
             }
             console.log();
         }
-        if (data.milestones?.length > 0) {
-            console.log(`${utils_js_1.c.bold}Upcoming (48h)${utils_js_1.c.reset}`);
-            for (const m of data.milestones.slice(0, 8)) {
-                console.log(`  ${utils_js_1.c.dim}${String(m.hoursUntil).padStart(3)}h${utils_js_1.c.reset}  ${m.title.slice(0, 55)}  ${utils_js_1.c.dim}${m.category}${utils_js_1.c.reset}`);
+        // ── Categories ─────────────────────────────────────────────────────────
+        const cats = data.categories || [];
+        if (cats.length > 0) {
+            console.log(`${utils_js_1.c.bold}Categories${utils_js_1.c.reset}`);
+            for (const cat of cats.slice(0, 8)) {
+                const mover = cat.topMover;
+                const moverStr = mover
+                    ? `${utils_js_1.c.dim}top: ${(0, utils_js_1.trunc)(mover.title, 30)} ${mover.change24h > 0 ? utils_js_1.c.green + '+' : utils_js_1.c.red}${mover.change24h}¢${utils_js_1.c.reset}`
+                    : '';
+                console.log(`  ${(0, utils_js_1.pad)(cat.name, 14)} ${(0, utils_js_1.rpad)(String(cat.marketCount) + ' mkts', 10)} vol ${(0, utils_js_1.vol)(cat.totalVolume24h)}  ${moverStr}`);
             }
             console.log();
         }
-        if (data.liquid?.length > 0) {
-            console.log(`${utils_js_1.c.bold}Liquid${utils_js_1.c.reset}`);
-            for (const m of data.liquid.slice(0, 8)) {
-                const venue = m.venue === 'kalshi' ? `${utils_js_1.c.cyan}K${utils_js_1.c.reset}` : `${utils_js_1.c.magenta}P${utils_js_1.c.reset}`;
-                console.log(`  ${venue} ${String(m.price).padStart(3)}¢  spread ${m.spread}¢  ${m.title.slice(0, 55)}`);
+        // ── Thesis edges (from public theses) ──────────────────────────────────
+        const edges = data.edges || [];
+        if (edges.length > 0) {
+            console.log(`${utils_js_1.c.bold}Thesis Edges${utils_js_1.c.reset}`);
+            for (const e of edges.slice(0, 6)) {
+                const venue = e.venue === 'kalshi' ? `${utils_js_1.c.cyan}K${utils_js_1.c.reset}` : `${utils_js_1.c.magenta}P${utils_js_1.c.reset}`;
+                const edgeColor = e.edge > 0 ? utils_js_1.c.green : utils_js_1.c.red;
+                console.log(`  ${venue} ${(0, utils_js_1.rpad)(`${e.price}¢`, 5)}  ${edgeColor}edge ${e.edge > 0 ? '+' : ''}${e.edge}¢${utils_js_1.c.reset}  ${(0, utils_js_1.trunc)(e.title, 40)}  ${utils_js_1.c.dim}${e.thesisSlug || ''}${utils_js_1.c.reset}`);
             }
             console.log();
         }
-        if (data.signals?.length > 0) {
-            console.log(`${utils_js_1.c.bold}Recent Signals${utils_js_1.c.reset}`);
-            for (const s of data.signals.slice(0, 5)) {
-                const d = s.confidenceDelta > 0 ? `${utils_js_1.c.green}▲${s.confidenceDelta}${utils_js_1.c.reset}` : s.confidenceDelta < 0 ? `${utils_js_1.c.red}▼${s.confidenceDelta}${utils_js_1.c.reset}` : `${s.confidenceDelta}`;
-                console.log(`  ${d} ${s.confidence}%  ${s.summary.slice(0, 60)}`);
-                console.log(`  ${utils_js_1.c.dim}${s.thesisTitle.slice(0, 40)}  ${(0, utils_js_1.shortDate)(s.evaluatedAt)}${utils_js_1.c.reset}`);
+        // ── Recent evaluations ─────────────────────────────────────────────────
+        const signals = data.signals || [];
+        if (signals.length > 0) {
+            console.log(`${utils_js_1.c.bold}Recent Evaluations${utils_js_1.c.reset}`);
+            for (const s of signals.slice(0, 5)) {
+                const d = s.confidenceDelta;
+                const dStr = d > 0 ? `${utils_js_1.c.green}+${d}%${utils_js_1.c.reset}` : d < 0 ? `${utils_js_1.c.red}${d}%${utils_js_1.c.reset}` : `${utils_js_1.c.dim}0%${utils_js_1.c.reset}`;
+                const ago = timeAgo(s.evaluatedAt);
+                console.log(`  ${(0, utils_js_1.rpad)(ago, 5)} ${(0, utils_js_1.rpad)(s.thesisSlug || '?', 18)} ${(0, utils_js_1.rpad)(dStr, 14)} ${(0, utils_js_1.trunc)(s.summary, 50)}`);
             }
             console.log();
         }
-        console.log(`  ${utils_js_1.c.dim}Create a thesis for focused context: sf create "your market view"${utils_js_1.c.reset}\n`);
+        // ── Actions ────────────────────────────────────────────────────────────
+        console.log(`${utils_js_1.c.dim}${'─'.repeat(60)}${utils_js_1.c.reset}`);
+        console.log(`  ${utils_js_1.c.cyan}sf query${utils_js_1.c.reset} "topic"       ${utils_js_1.c.dim}ask anything${utils_js_1.c.reset}`);
+        console.log(`  ${utils_js_1.c.cyan}sf scan${utils_js_1.c.reset} "keywords"     ${utils_js_1.c.dim}search markets${utils_js_1.c.reset}`);
+        console.log(`  ${utils_js_1.c.cyan}sf explore${utils_js_1.c.reset}             ${utils_js_1.c.dim}public theses${utils_js_1.c.reset}`);
+        console.log(`  ${utils_js_1.c.cyan}sf create${utils_js_1.c.reset} "thesis"     ${utils_js_1.c.dim}start monitoring${utils_js_1.c.reset}`);
+        console.log();
         return;
     }
+    // ── Mode 2: Thesis-specific context (requires API key) ────────────────────
     const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
     const ctx = await client.getContext(id);
     if (opts.json) {
         console.log(JSON.stringify(ctx, null, 2));
         return;
     }
-    // Context API shape:
-    // { thesisId, thesis, title, status, confidence (number|null),
-    //   causalTree: { nodes: FlatNode[] }, edges: Edge[], edgeMeta,
-    //   lastEvaluation: { summary, confidenceDelta, ... }, updatedAt, ... }
-    // Thesis header
     console.log(`\n${utils_js_1.c.bold}Thesis:${utils_js_1.c.reset} ${ctx.thesis || ctx.rawThesis || '(unknown)'}`);
     const confStr = ctx.confidence !== null && ctx.confidence !== undefined ? (0, utils_js_1.pct)(ctx.confidence) : '-';
     const confDelta = ctx.lastEvaluation?.confidenceDelta;
@@ -81,7 +122,7 @@ async function contextCommand(id, opts) {
     console.log(`${utils_js_1.c.bold}Confidence:${utils_js_1.c.reset} ${confStr}${deltaStr}`);
     console.log(`${utils_js_1.c.bold}Status:${utils_js_1.c.reset} ${ctx.status}`);
     console.log(`${utils_js_1.c.bold}Last Updated:${utils_js_1.c.reset} ${(0, utils_js_1.shortDate)(ctx.updatedAt)}`);
-    // Causal tree nodes (flat array from API)
+    // Causal tree nodes
     const nodes = ctx.causalTree?.nodes;
     if (nodes && nodes.length > 0) {
         (0, utils_js_1.header)('Causal Tree');
@@ -92,53 +133,45 @@ async function contextCommand(id, opts) {
             console.log(`${indent}${utils_js_1.c.cyan}${node.id}${utils_js_1.c.reset}  ${(0, utils_js_1.pad)(label, 40)} ${(0, utils_js_1.rpad)(prob, 5)}`);
         }
     }
-    // Fetch positions if Kalshi is configured (local only, no server)
+    // Fetch positions if Kalshi is configured
     let positions = null;
     if ((0, kalshi_js_1.isKalshiConfigured)()) {
         try {
             positions = await (0, kalshi_js_1.getPositions)();
         }
-        catch {
-            // silently skip — positions are optional
-        }
+        catch { /* optional */ }
     }
     const posMap = new Map();
     if (positions) {
-        for (const p of positions) {
+        for (const p of positions)
             posMap.set(p.ticker, p);
-        }
     }
-    // Top edges (sorted by absolute edge size)
+    // Top edges
     const edges = ctx.edges;
     if (edges && edges.length > 0) {
-        (0, utils_js_1.header)('Top Edges (by edge size)');
+        (0, utils_js_1.header)('Top Edges');
         const sorted = [...edges].sort((a, b) => Math.abs(b.edge ?? b.edgeSize ?? 0) - Math.abs(a.edge ?? a.edgeSize ?? 0));
         for (const edge of sorted.slice(0, 10)) {
             const edgeSize = edge.edge ?? edge.edgeSize ?? 0;
             const edgeColor = edgeSize > 10 ? utils_js_1.c.green : edgeSize > 0 ? utils_js_1.c.yellow : utils_js_1.c.red;
             const mktPrice = edge.marketPrice ?? edge.currentPrice ?? 0;
             const title = edge.market || edge.marketTitle || edge.marketId || '?';
-            // Orderbook info (if enriched by rescan)
             const ob = edge.orderbook;
             const obStr = ob ? `  ${utils_js_1.c.dim}spread ${ob.spread}¢ ${ob.liquidityScore}${utils_js_1.c.reset}` : '';
-            // Position overlay (if user has Kalshi positions)
             const pos = posMap.get(edge.marketId);
             let posStr = '';
             if (pos) {
                 const pnl = pos.unrealized_pnl || 0;
                 const pnlColor = pnl > 0 ? utils_js_1.c.green : pnl < 0 ? utils_js_1.c.red : utils_js_1.c.dim;
                 const pnlFmt = pnl >= 0 ? `+$${(pnl / 100).toFixed(0)}` : `-$${(Math.abs(pnl) / 100).toFixed(0)}`;
-                posStr = `  ${utils_js_1.c.cyan}← ${pos.quantity}张 @ ${pos.average_price_paid}¢  ${pnlColor}${pnlFmt}${utils_js_1.c.reset}`;
+                posStr = `  ${utils_js_1.c.cyan}← ${pos.quantity}@${pos.average_price_paid}¢ ${pnlColor}${pnlFmt}${utils_js_1.c.reset}`;
             }
-            console.log(`  ${(0, utils_js_1.pad)(title, 35)}` +
-                `  ${(0, utils_js_1.rpad)(mktPrice.toFixed(0) + '¢', 5)}` +
+            console.log(`  ${(0, utils_js_1.pad)(title, 35)}  ${(0, utils_js_1.rpad)(mktPrice.toFixed(0) + '¢', 5)}` +
                 `  ${edgeColor}edge ${edgeSize > 0 ? '+' : ''}${edgeSize.toFixed(1)}${utils_js_1.c.reset}` +
-                `  ${utils_js_1.c.dim}${edge.venue || ''}${utils_js_1.c.reset}` +
-                obStr +
-                posStr);
+                `  ${utils_js_1.c.dim}${edge.venue || ''}${utils_js_1.c.reset}` + obStr + posStr);
         }
     }
-    // Last evaluation summary
+    // Last evaluation
     if (ctx.lastEvaluation?.summary) {
         (0, utils_js_1.header)('Last Evaluation');
         console.log(`  ${utils_js_1.c.dim}${(0, utils_js_1.shortDate)(ctx.lastEvaluation.evaluatedAt)} | model: ${ctx.lastEvaluation.model || ''}${utils_js_1.c.reset}`);
@@ -151,9 +184,30 @@ async function contextCommand(id, opts) {
             }
         }
     }
-    // Edge meta (last rescan time)
     if (ctx.edgeMeta?.lastRescanAt) {
         console.log(`\n${utils_js_1.c.dim}Last rescan: ${(0, utils_js_1.shortDate)(ctx.edgeMeta.lastRescanAt)}${utils_js_1.c.reset}`);
     }
     console.log('');
 }
+/** Extract a short search query from a market title */
+function extractQuery(title) {
+    return title
+        .replace(/^Will\s+/i, '')
+        .replace(/\?.*$/, '')
+        .replace(/by\s+\w+\s+\d{1,2}.*$/i, '')
+        .replace(/\*\*/g, '')
+        .trim()
+        .slice(0, 40)
+        .trim();
+}
+/** Human-readable time ago */
+function timeAgo(iso) {
+    const ms = Date.now() - new Date(iso).getTime();
+    const min = Math.round(ms / 60000);
+    if (min < 60)
+        return `${min}m`;
+    const hr = Math.round(min / 60);
+    if (hr < 24)
+        return `${hr}h`;
+    return `${Math.round(hr / 24)}d`;
+}

package/dist/commands/delta.d.ts

@@ -0,0 +1,16 @@
+/**
+ * sf delta <thesisId> — Changes since a timestamp.
+ *
+ * Calls GET /api/thesis/:id/changes?since=<ts>
+ * Shows: confidence delta, new signals, node probability changes, edge movements.
+ */
+interface DeltaOpts {
+    since?: string;
+    hours?: string;
+    json?: boolean;
+    watch?: boolean;
+    apiKey?: string;
+    apiUrl?: string;
+}
+export declare function deltaCommand(thesisId: string, opts: DeltaOpts): Promise<void>;
+export {};

package/dist/commands/delta.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * sf delta <thesisId> — Changes since a timestamp.
+ *
+ * Calls GET /api/thesis/:id/changes?since=<ts>
+ * Shows: confidence delta, new signals, node probability changes, edge movements.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deltaCommand = deltaCommand;
+const client_js_1 = require("../client.js");
+const utils_js_1 = require("../utils.js");
+async function deltaCommand(thesisId, opts) {
+    const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
+    // Resolve "since" — either explicit timestamp or --hours offset
+    const sinceDate = opts.since
+        ? new Date(opts.since)
+        : new Date(Date.now() - (parseInt(opts.hours || '6') * 3600000));
+    if (isNaN(sinceDate.getTime())) {
+        throw new Error(`Invalid timestamp: "${opts.since}". Use ISO 8601 format (e.g., 2026-03-28T14:00:00Z)`);
+    }
+    const run = async () => {
+        const since = sinceDate.toISOString();
+        const data = await client.getChanges(thesisId, since);
+        if (opts.json) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        if (!data.changed) {
+            console.log(`${utils_js_1.c.dim}No changes since ${sinceDate.toLocaleString()}.${utils_js_1.c.reset}`);
+            return;
+        }
+        // Header
+        const id = (0, utils_js_1.shortId)(thesisId);
+        console.log();
+        console.log(`${utils_js_1.c.bold}${utils_js_1.c.cyan}Delta: ${id}${utils_js_1.c.reset}${utils_js_1.c.dim} — since ${sinceDate.toLocaleString()}${utils_js_1.c.reset}`);
+        console.log(`${utils_js_1.c.dim}${'─'.repeat(65)}${utils_js_1.c.reset}`);
+        // Confidence change
+        if (data.confidence !== undefined) {
+            const conf = Math.round(data.confidence * 100);
+            const prev = data.previousConfidence !== undefined ? Math.round(data.previousConfidence * 100) : null;
+            const delta = prev !== null ? conf - prev : null;
+            let deltaStr = '';
+            if (delta !== null) {
+                deltaStr = delta > 0 ? `${utils_js_1.c.green} (+${delta}%)${utils_js_1.c.reset}` : delta < 0 ? `${utils_js_1.c.red} (${delta}%)${utils_js_1.c.reset}` : `${utils_js_1.c.dim} (0%)${utils_js_1.c.reset}`;
+            }
+            console.log(`  Confidence: ${utils_js_1.c.bold}${conf}%${utils_js_1.c.reset}${deltaStr}`);
+        }
+        // Evaluation count
+        if (data.evaluationCount) {
+            console.log(`  Evaluations: ${data.evaluationCount} cycle(s)`);
+        }
+        // Updated nodes
+        const nodes = data.updatedNodes || [];
+        if (nodes.length > 0) {
+            console.log();
+            console.log(`  ${utils_js_1.c.bold}Node Changes (${nodes.length}):${utils_js_1.c.reset}`);
+            for (const n of nodes) {
+                const prob = Math.round((n.newProbability ?? n.newProb ?? 0) * 100);
+                const prev = n.previousProbability ?? n.prevProb;
+                let changeStr = '';
+                if (prev !== undefined && prev !== null) {
+                    const prevPct = Math.round(prev * 100);
+                    const d = prob - prevPct;
+                    changeStr = d > 0 ? ` ${utils_js_1.c.green}+${d}%${utils_js_1.c.reset}` : d < 0 ? ` ${utils_js_1.c.red}${d}%${utils_js_1.c.reset}` : '';
+                }
+                const label = n.label || n.nodeId || '?';
+                console.log(`    ${label.slice(0, 40).padEnd(40)} ${prob}%${changeStr}`);
+            }
+        }
+        // New signals
+        const signals = data.newSignals || [];
+        if (signals.length > 0) {
+            console.log();
+            console.log(`  ${utils_js_1.c.bold}New Signals (${signals.length}):${utils_js_1.c.reset}`);
+            for (const s of signals) {
+                const type = s.type || 'signal';
+                const content = (s.content || s.title || '').replace(/\n/g, ' ').slice(0, 70);
+                console.log(`    ${utils_js_1.c.dim}[${type}]${utils_js_1.c.reset} ${content}`);
+            }
+        }
+        // Edge changes
+        const edges = data.edgeChanges || data.edges || [];
+        if (edges.length > 0) {
+            console.log();
+            console.log(`  ${utils_js_1.c.bold}Edge Movements (${edges.length}):${utils_js_1.c.reset}`);
+            for (const e of edges.slice(0, 15)) {
+                const market = (e.market || e.marketId || '').slice(0, 35).padEnd(35);
+                const edge = e.edge ?? 0;
+                const prev = e.previousEdge ?? null;
+                const edgeStr = edge > 0 ? `+${edge}` : `${edge}`;
+                let changeStr = '';
+                if (prev !== null) {
+                    const d = edge - prev;
+                    changeStr = d > 0 ? ` ${utils_js_1.c.green}(+${d})${utils_js_1.c.reset}` : d < 0 ? ` ${utils_js_1.c.red}(${d})${utils_js_1.c.reset}` : '';
+                }
+                const color = edge > 0 ? utils_js_1.c.green : edge < 0 ? utils_js_1.c.red : utils_js_1.c.dim;
+                console.log(`    ${market} ${color}${edgeStr}${utils_js_1.c.reset}${changeStr}`);
+            }
+        }
+        console.log(`${utils_js_1.c.dim}${'─'.repeat(65)}${utils_js_1.c.reset}`);
+        console.log();
+    };
+    if (opts.watch) {
+        console.log(`${utils_js_1.c.dim}Watching for changes every 60s... (Ctrl+C to stop)${utils_js_1.c.reset}`);
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            await run();
+            await new Promise(r => setTimeout(r, 60_000));
+            console.clear();
+        }
+    }
+    else {
+        await run();
+    }
+}

package/dist/commands/edges.d.ts

@@ -14,6 +14,10 @@
 interface EdgesOpts {
     json?: boolean;
     limit?: string;
+    thesis?: string;
+    minEdge?: string;
+    minLiquidity?: string;
+    sort?: string;
     apiKey?: string;
     apiUrl?: string;
 }

package/dist/commands/edges.js

@@ -20,17 +20,30 @@ const utils_js_1 = require("../utils.js");
 async function edgesCommand(opts) {
     const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
     const limit = parseInt(opts.limit || '20');
-    // ── Step 1: Fetch all active theses ────────────────────────────────────────
-    console.log(`${utils_js_1.c.dim}Fetching theses...${utils_js_1.c.reset}`);
-    const data = await client.listTheses();
-    const rawTheses = data.theses || data;
-    const theses = (Array.isArray(rawTheses) ? rawTheses : []).filter((t) => t.status === 'active');
+    const minEdge = opts.minEdge ? parseInt(opts.minEdge) : 0;
+    const minLiq = opts.minLiquidity?.toLowerCase() || '';
+    const sortBy = opts.sort || 'edge';
+    // Support both letter grades (A/B/C/D) and word grades (high/medium/low)
+    const liqRank = { a: 4, high: 4, b: 3, medium: 3, c: 2, low: 2, d: 1 };
+    // ── Step 1: Fetch theses (or single thesis) ────────────────────────────────
+    let theses;
+    if (opts.thesis) {
+        // Single thesis mode — skip listing, fetch context directly
+        console.log(`${utils_js_1.c.dim}Fetching edges for thesis ${opts.thesis}...${utils_js_1.c.reset}`);
+        theses = [{ id: opts.thesis }];
+    }
+    else {
+        console.log(`${utils_js_1.c.dim}Fetching theses...${utils_js_1.c.reset}`);
+        const data = await client.listTheses();
+        const rawTheses = data.theses || data;
+        theses = (Array.isArray(rawTheses) ? rawTheses : []).filter((t) => t.status === 'active');
+    }
     if (theses.length === 0) {
         console.log(`${utils_js_1.c.yellow}No active theses found.${utils_js_1.c.reset} Create one: sf create "your thesis"`);
         return;
     }
     // ── Step 2: Fetch context for each thesis (parallel) ───────────────────────
-    console.log(`${utils_js_1.c.dim}Fetching edges from ${theses.length} theses...${utils_js_1.c.reset}`);
+    console.log(`${utils_js_1.c.dim}Fetching edges from ${theses.length} ${theses.length === 1 ? 'thesis' : 'theses'}...${utils_js_1.c.reset}`);
     const allEdges = [];
     const contextPromises = theses.map(async (t) => {
         try {
@@ -76,6 +89,13 @@ async function edgesCommand(opts) {
         }
     }
     let merged = Array.from(deduped.values());
+    // ── Step 3b: Apply filters ─────────────────────────────────────────────────
+    if (minEdge > 0) {
+        merged = merged.filter(e => Math.abs(e.edge) >= minEdge);
+    }
+    if (minLiq && liqRank[minLiq]) {
+        merged = merged.filter(e => e.liquidityScore && (liqRank[e.liquidityScore.toLowerCase()] || 0) >= liqRank[minLiq]);
+    }
     // ── Step 4: Fetch positions (optional) ─────────────────────────────────────
     let positions = null;
     if ((0, kalshi_js_1.isKalshiConfigured)()) {
@@ -107,12 +127,18 @@ async function edgesCommand(opts) {
             }
         }
     }
-    // ── Step 5: Sort by executableEdge (or edge) descending ────────────────────
-    merged.sort((a, b) => {
-        const aVal = a.executableEdge !== null ? a.executableEdge : a.edge;
-        const bVal = b.executableEdge !== null ? b.executableEdge : b.edge;
-        return Math.abs(bVal) - Math.abs(aVal);
-    });
+    // ── Step 5: Sort ────────────────────────────────────────────────────────────
+    if (sortBy === 'spread') {
+        merged.sort((a, b) => (a.spread ?? 999) - (b.spread ?? 999));
+    }
+    else {
+        // Default: sort by executableEdge (or edge) descending
+        merged.sort((a, b) => {
+            const aVal = a.executableEdge !== null ? a.executableEdge : a.edge;
+            const bVal = b.executableEdge !== null ? b.executableEdge : b.edge;
+            return Math.abs(bVal) - Math.abs(aVal);
+        });
+    }
     // Apply limit
     const display = merged.slice(0, limit);
     // ── Step 6: JSON output ────────────────────────────────────────────────────

package/dist/commands/query.js

@@ -55,13 +55,15 @@ async function queryCommand(q, opts) {
         console.log('  \x1b[1mMarkets\x1b[22m');
         for (const m of kalshiList.slice(0, 8)) {
             const vol = fmtVol(m.volume);
-            console.log(`    \x1b[36mK\x1b[39m ${String(m.price).padStart(3)}¢  vol ${vol.padStart(6)}  ${m.title.slice(0, 55)}`);
+            const id = m.ticker ? ` \x1b[2m${m.ticker}\x1b[22m` : '';
+            console.log(`    \x1b[36mK\x1b[39m ${String(m.price).padStart(3)}¢  vol ${vol.padStart(6)}  ${m.title.slice(0, 55)}${id}`);
         }
         if (kalshiList.length > 0 && polyList.length > 0)
             console.log();
         for (const m of polyList.slice(0, 8)) {
             const vol = fmtVol(m.volume);
-            console.log(`    \x1b[35mP\x1b[39m ${String(m.price).padStart(3)}¢  vol ${vol.padStart(6)}  ${m.title.slice(0, 55)}`);
+            const id = m.slug ? ` \x1b[2m${m.slug}\x1b[22m` : '';
+            console.log(`    \x1b[35mP\x1b[39m ${String(m.price).padStart(3)}¢  vol ${vol.padStart(6)}  ${m.title.slice(0, 55)}${id}`);
         }
         console.log();
     }

package/dist/commands/scan.js

@@ -4,6 +4,8 @@ exports.scanCommand = scanCommand;
 const client_js_1 = require("../client.js");
 const polymarket_js_1 = require("../polymarket.js");
 const utils_js_1 = require("../utils.js");
+// SF API base — scan goes through the server which holds the proxy key
+const SF_API_URL = process.env.SF_API_URL || 'https://simplefunctions.dev';
 async function scanCommand(query, opts) {
     // Mode 1: --market TICKER — single market detail
     if (opts.market) {
@@ -79,7 +81,6 @@ async function showSeries(seriesTicker, json) {
     }
 }
 async function keywordScan(query, json, venue = 'all') {
-    const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
     // ── Polymarket search (runs in parallel with Kalshi) ───────────────────────
     const polyPromise = (venue === 'kalshi')
         ? Promise.resolve([])
@@ -90,68 +91,36 @@ async function keywordScan(query, json, venue = 'all') {
     if (venue !== 'kalshi') {
         console.log(`${utils_js_1.c.dim}Scanning Polymarket for: "${query}"...${utils_js_1.c.reset}`);
     }
-    const allSeries = venue === 'polymarket' ? [] : await (0, client_js_1.kalshiFetchAllSeries)();
-    // Score each series
-    const thesisKeywords = [
-        'oil', 'wti', 'gas', 'recession', 'gdp', 'fed', 'inflation',
-        'unemployment', 'cpi', 'interest rate', 'congress', 'election',
-        'iran', 'hormuz', 'war', 'tariff', 'trade', 'rate',
-    ];
-    const matches = [];
-    for (const s of allSeries) {
-        const text = `${s.title} ${s.ticker} ${(s.tags || []).join(' ')} ${s.category}`.toLowerCase();
-        let score = 0;
-        for (const term of terms) {
-            if (text.includes(term))
-                score += 10;
-        }
-        for (const kw of thesisKeywords) {
-            if (text.includes(kw))
-                score += 5;
-        }
-        const v = parseFloat(s.volume_fp || '0');
-        if (v > 1_000_000)
-            score += 3;
-        else if (v > 100_000)
-            score += 1;
-        if (score > 0 && v > 1000)
-            matches.push({ series: s, score, volume: v });
-    }
-    // Sort by score first, then by volume as tiebreaker
-    matches.sort((a, b) => b.score - a.score || b.volume - a.volume);
-    const topSeries = matches.slice(0, 15);
-    console.log(`\n${utils_js_1.c.bold}Found ${matches.length} relevant series. Top ${topSeries.length}:${utils_js_1.c.reset}\n`);
-    for (const { series: s, volume } of topSeries) {
-        const volStr = volume >= 1_000_000 ? `$${(volume / 1_000_000).toFixed(1)}M` : volume >= 1000 ? `$${(volume / 1000).toFixed(0)}k` : `$${volume.toFixed(0)}`;
-        console.log(`  ${(0, utils_js_1.rpad)(volStr, 10)} ${(0, utils_js_1.pad)(s.ticker, 25)} ${s.title}`);
-    }
-    // Fetch live markets for top 10
-    console.log(`\n${utils_js_1.c.dim}Fetching live markets...${utils_js_1.c.reset}\n`);
+    // ── Kalshi via SF API /scan (proxies to CF worker, key stays server-side)
     const allMarkets = [];
-    for (const { series: s } of topSeries.slice(0, 10)) {
+    if (venue !== 'polymarket') {
         try {
-            const events = await (0, client_js_1.kalshiFetchEvents)(s.ticker);
-            for (const event of events) {
-                const markets = event.markets || [];
-                for (const m of markets) {
-                    if (m.status === 'open' || m.status === 'active') {
-                        allMarkets.push({
-                            venue: 'kalshi',
-                            seriesTicker: s.ticker,
-                            ticker: m.ticker,
-                            title: m.title || m.subtitle || '',
-                            yesAsk: parseFloat(m.yes_ask_dollars || '0'),
-                            lastPrice: parseFloat(m.last_price_dollars || '0'),
-                            volume24h: parseFloat(m.volume_24h_fp || '0'),
-                            liquidity: parseFloat(m.open_interest_fp || m.liquidity_dollars || '0'),
-                        });
-                    }
-                }
+            const scanUrl = `${SF_API_URL}/api/public/scan?q=${encodeURIComponent(query)}&limit=30`;
+            const res = await fetch(scanUrl);
+            if (!res.ok)
+                throw new Error(`Proxy ${res.status}`);
+            const data = await res.json();
+            const matchedSeries = data.matchedSeries || [];
+            const markets = data.markets || [];
+            console.log(`\n${utils_js_1.c.bold}Matched ${matchedSeries.length} series via proxy:${utils_js_1.c.reset}\n`);
+            for (const s of matchedSeries.slice(0, 15)) {
+                console.log(`  ${(0, utils_js_1.pad)(s.ticker, 25)} score=${s.score}  ${s.title || ''}`);
+            }
+            for (const m of markets) {
+                allMarkets.push({
+                    venue: 'kalshi',
+                    seriesTicker: m.series_ticker,
+                    ticker: m.ticker,
+                    title: m.title || m.exchange_title || '',
+                    yesAsk: parseFloat(m.yes_ask_dollars || '0'),
+                    lastPrice: parseFloat(m.last_price_dollars || '0'),
+                    volume24h: parseFloat(m.volume_24h_fp || '0'),
+                    liquidity: parseFloat(m.open_interest_fp || m.liquidity_dollars || '0'),
+                });
             }
-            await new Promise(r => setTimeout(r, 150));
         }
-        catch {
-            // skip failed series
+        catch (err) {
+            console.warn(`${utils_js_1.c.dim}Kalshi scan failed: ${err}${utils_js_1.c.reset}`);
         }
     }
     allMarkets.sort((a, b) => b.liquidity - a.liquidity);

package/dist/commands/trade.js

@@ -21,11 +21,22 @@ async function executeOrder(ticker, qty, action, opts) {
     if (isNaN(quantity) || quantity <= 0)
         throw new Error('Quantity must be a positive integer');
     const side = (opts.side || 'yes');
+    if (!opts.market && !opts.price) {
+        throw new Error('Limit order requires --price <cents>. Example: sf buy TICKER 10 --price 45\nFor market orders use: sf buy TICKER 10 --market --price 99');
+    }
+    // Kalshi API always requires yes_price — even for "market" orders.
+    // For market orders without --price: auto-fetch current market price.
     const orderType = opts.market ? 'market' : 'limit';
-    if (orderType === 'limit' && !opts.price) {
-        throw new Error('Limit order requires --price <cents>. Use --market for market orders.');
+    let priceCents = opts.price ? parseInt(opts.price) : undefined;
+    if (opts.market && !priceCents) {
+        console.log(`${utils_js_1.c.dim}Fetching current market price for ${ticker}...${utils_js_1.c.reset}`);
+        const livePrice = await (0, kalshi_js_1.getMarketPrice)(ticker.toUpperCase());
+        if (!livePrice) {
+            throw new Error(`Could not fetch market price for ${ticker}. Use --price <cents> to set manually.`);
+        }
+        priceCents = livePrice;
+        console.log(`${utils_js_1.c.dim}Using market price: ${livePrice}¢${utils_js_1.c.reset}`);
     }
-    const priceCents = opts.price ? parseInt(opts.price) : undefined;
     if (priceCents !== undefined && (priceCents < 1 || priceCents > 99)) {
         throw new Error('Price must be 1-99 cents.');
     }

package/dist/index.js

@@ -57,6 +57,7 @@ const book_js_1 = require("./commands/book.js");
 const prompt_js_1 = require("./commands/prompt.js");
 const augment_js_1 = require("./commands/augment.js");
 const telegram_js_1 = require("./commands/telegram.js");
+const delta_js_1 = require("./commands/delta.js");
 const query_js_1 = require("./commands/query.js");
 const markets_js_1 = require("./commands/markets.js");
 const x_js_1 = require("./commands/x.js");
@@ -128,6 +129,7 @@ const GROUPED_HELP = `
 
 \x1b[1mInfo\x1b[22m
   \x1b[36mfeed\x1b[39m                       Evaluation history stream
+  \x1b[36mdelta\x1b[39m <id>                  Changes since timestamp
   \x1b[36mmilestones\x1b[39m                 Upcoming Kalshi events
   \x1b[36mschedule\x1b[39m                   Exchange status
   \x1b[36mannouncements\x1b[39m              Exchange announcements
@@ -359,11 +361,19 @@ program
     .description('Top edges across all theses — what to trade now')
     .option('--json', 'JSON output for agents')
     .option('--limit <n>', 'Max edges to show', '20')
+    .option('--thesis <id>', 'Filter to a single thesis')
+    .option('--min-edge <cents>', 'Minimum absolute edge size in cents')
+    .option('--min-liquidity <grade>', 'Minimum liquidity (high/medium/low or A/B/C)')
+    .option('--sort <by>', 'Sort by: edge (default), spread')
     .action(async (opts, cmd) => {
     const g = cmd.optsWithGlobals();
     await run(() => (0, edges_js_1.edgesCommand)({
         json: opts.json,
         limit: opts.limit,
+        thesis: opts.thesis,
+        minEdge: opts.minEdge,
+        minLiquidity: opts.minLiquidity,
+        sort: opts.sort,
         apiKey: g.apiKey,
         apiUrl: g.apiUrl,
     }));
@@ -434,8 +444,8 @@ program
 // ── sf milestones ────────────────────────────────────────────────────────────
 program
     .command('milestones')
-    .description('Upcoming events from Kalshi calendar')
-    .option('--category <cat>', 'Filter by category')
+    .description('Upcoming events from Kalshi calendar. Use --category to filter (e.g., Economics, Politics, Financials, Climate)')
+    .option('--category <cat>', 'Filter by category (e.g., Economics, Politics, Financials, Climate, Sports)')
     .option('--thesis <id>', 'Show milestones matching thesis edges')
     .option('--hours <n>', 'Hours ahead (default 168)', '168')
     .option('--json', 'JSON output')
@@ -446,7 +456,7 @@ program
 // ── sf forecast <eventTicker> ────────────────────────────────────────────────
 program
     .command('forecast <eventTicker>')
-    .description('Market distribution forecast (P50/P75/P90 history)')
+    .description('Market distribution forecast (P50/P75/P90). Use EVENT ticker (e.g., KXWTIMAX-26DEC31), not series ticker.')
     .option('--days <n>', 'Days of history (default 7)', '7')
     .option('--json', 'JSON output')
     .action(async (eventTicker, opts) => {
@@ -499,6 +509,18 @@ program
     const g = cmd.optsWithGlobals();
     await run(() => (0, feed_js_1.feedCommand)({ ...opts, apiKey: g.apiKey, apiUrl: g.apiUrl }));
 });
+// ── sf delta <thesisId> ───────────────────────────────────────────────────────
+program
+    .command('delta <thesisId>')
+    .description('Changes since a timestamp — confidence, nodes, signals, edges')
+    .option('--since <timestamp>', 'ISO 8601 start time (e.g., 2026-03-28T14:00:00Z)')
+    .option('--hours <n>', 'Hours to look back (default 6)', '6')
+    .option('--watch', 'Continuously poll every 60s')
+    .option('--json', 'JSON output')
+    .action(async (thesisId, opts, cmd) => {
+    const g = cmd.optsWithGlobals();
+    await run(() => (0, delta_js_1.deltaCommand)(thesisId, { ...opts, apiKey: g.apiKey, apiUrl: g.apiUrl }));
+});
 // ── sf whatif <thesisId> ──────────────────────────────────────────────────────
 program
     .command('whatif <thesisId>')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spfunctions/cli",
-  "version": "1.7.8",
+  "version": "1.7.11",
   "description": "Prediction market intelligence CLI. Causal thesis model, 24/7 Kalshi/Polymarket scan, live orderbook, edge detection. Interactive agent mode with tool calling.",
   "bin": {
     "sf": "./dist/index.js"