@spfunctions/cli 1.4.5 → 1.5.1

package/dist/commands/positions.js

@@ -14,6 +14,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.positionsCommand = positionsCommand;
 const client_js_1 = require("../client.js");
 const kalshi_js_1 = require("../kalshi.js");
+const polymarket_js_1 = require("../polymarket.js");
+const config_js_1 = require("../config.js");
 const utils_js_1 = require("../utils.js");
 async function positionsCommand(opts) {
     const client = new client_js_1.SFClient(opts.apiKey, opts.apiUrl);
@@ -23,6 +25,18 @@ async function positionsCommand(opts) {
         console.log(`${utils_js_1.c.dim}Fetching Kalshi positions...${utils_js_1.c.reset}`);
         positions = await (0, kalshi_js_1.getPositions)();
     }
+    // ── Step 1b: Fetch Polymarket positions (if wallet configured) ──
+    const config = (0, config_js_1.loadConfig)();
+    let polyPositions = [];
+    if (config.polymarketWalletAddress) {
+        console.log(`${utils_js_1.c.dim}Fetching Polymarket positions...${utils_js_1.c.reset}`);
+        try {
+            polyPositions = await (0, polymarket_js_1.polymarketGetPositions)(config.polymarketWalletAddress);
+        }
+        catch {
+            // skip
+        }
+    }
     // ── Step 2: Fetch all theses and their edges (via SF API) ──
     console.log(`${utils_js_1.c.dim}Fetching thesis edges...${utils_js_1.c.reset}`);
     let theses = [];
@@ -100,7 +114,9 @@ async function positionsCommand(opts) {
     if (opts.json) {
         console.log(JSON.stringify({
             kalshiConfigured: (0, kalshi_js_1.isKalshiConfigured)(),
+            polymarketConfigured: !!config.polymarketWalletAddress,
             positions: positions || [],
+            polymarketPositions: polyPositions,
             edges: allEdges.map(e => ({ ...e.edge, thesisId: e.thesisId })),
         }, null, 2));
         return;
@@ -169,6 +185,40 @@ async function positionsCommand(opts) {
     else {
         console.log(`\n${utils_js_1.c.yellow}Kalshi not configured.${utils_js_1.c.reset} Set KALSHI_API_KEY_ID and KALSHI_PRIVATE_KEY_PATH to see positions.\n`);
     }
+    // C) Polymarket positions
+    if (polyPositions.length > 0) {
+        (0, utils_js_1.header)('Polymarket Positions');
+        console.log('  ' + utils_js_1.c.bold +
+            (0, utils_js_1.pad)('Market', 35) +
+            (0, utils_js_1.rpad)('Side', 5) +
+            (0, utils_js_1.rpad)('Size', 8) +
+            (0, utils_js_1.rpad)('Avg', 6) +
+            (0, utils_js_1.rpad)('Now', 6) +
+            (0, utils_js_1.rpad)('P&L', 9) +
+            utils_js_1.c.reset);
+        console.log('  ' + utils_js_1.c.dim + '─'.repeat(75) + utils_js_1.c.reset);
+        for (const pos of polyPositions) {
+            const title = (pos.title || pos.slug || pos.asset || '').slice(0, 34);
+            const side = pos.outcome || 'YES';
+            const size = pos.size || 0;
+            const avgPrice = Math.round((pos.avgPrice || 0) * 100);
+            const curPrice = Math.round((pos.curPrice || pos.currentPrice || 0) * 100);
+            const pnl = pos.cashPnl || ((curPrice - avgPrice) * size / 100);
+            const pnlColor = pnl >= 0 ? utils_js_1.c.green : utils_js_1.c.red;
+            const pnlStr = pnl >= 0 ? `+$${pnl.toFixed(2)}` : `-$${Math.abs(pnl).toFixed(2)}`;
+            console.log('  ' +
+                (0, utils_js_1.pad)(title, 35) +
+                (0, utils_js_1.rpad)(side.toUpperCase(), 5) +
+                (0, utils_js_1.rpad)(String(Math.round(size)), 8) +
+                (0, utils_js_1.rpad)(`${avgPrice}¢`, 6) +
+                (0, utils_js_1.rpad)(`${curPrice}¢`, 6) +
+                `${pnlColor}${(0, utils_js_1.rpad)(pnlStr, 9)}${utils_js_1.c.reset}`);
+        }
+        console.log('');
+    }
+    else if (config.polymarketWalletAddress) {
+        console.log(`${utils_js_1.c.dim}No open positions on Polymarket.${utils_js_1.c.reset}\n`);
+    }
     // B) Unpositioned edges (edges without matching positions)
     const positionedTickers = new Set((positions || []).map(p => p.ticker));
     const unpositionedEdges = allEdges.filter(e => !positionedTickers.has(e.edge.marketId));

package/dist/commands/scan.d.ts

@@ -1,6 +1,7 @@
 interface ScanOpts {
     series?: string;
     market?: string;
+    venue?: string;
     json?: boolean;
     apiKey?: string;
     apiUrl?: string;

package/dist/commands/scan.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scanCommand = scanCommand;
 const client_js_1 = require("../client.js");
+const polymarket_js_1 = require("../polymarket.js");
 const utils_js_1 = require("../utils.js");
 async function scanCommand(query, opts) {
     // Mode 1: --market TICKER — single market detail
@@ -14,8 +15,8 @@ async function scanCommand(query, opts) {
         await showSeries(opts.series.toUpperCase(), opts.json);
         return;
     }
-    // Mode 3: keyword scan across all series
-    await keywordScan(query, opts.json);
+    // Mode 3: keyword scan across all series + Polymarket
+    await keywordScan(query, opts.json, opts.venue || 'all');
 }
 async function showMarket(ticker, json) {
     console.log(`${utils_js_1.c.dim}Fetching market ${ticker}...${utils_js_1.c.reset}`);
@@ -77,10 +78,19 @@ async function showSeries(seriesTicker, json) {
         printMarketsTable(markets);
     }
 }
-async function keywordScan(query, json) {
+async function keywordScan(query, json, venue = 'all') {
     const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
-    console.log(`${utils_js_1.c.dim}Scanning Kalshi for: "${query}"...${utils_js_1.c.reset}`);
-    const allSeries = await (0, client_js_1.kalshiFetchAllSeries)();
+    // ── Polymarket search (runs in parallel with Kalshi) ───────────────────────
+    const polyPromise = (venue === 'kalshi')
+        ? Promise.resolve([])
+        : (0, polymarket_js_1.polymarketSearch)(query, 10).catch(() => []);
+    if (venue !== 'polymarket') {
+        console.log(`${utils_js_1.c.dim}Scanning Kalshi for: "${query}"...${utils_js_1.c.reset}`);
+    }
+    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',
@@ -126,13 +136,14 @@ async function keywordScan(query, json) {
                 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.liquidity_dollars || '0'),
+                            liquidity: parseFloat(m.open_interest_fp || m.liquidity_dollars || '0'),
                         });
                     }
                 }
@@ -144,27 +155,67 @@ async function keywordScan(query, json) {
         }
     }
     allMarkets.sort((a, b) => b.liquidity - a.liquidity);
+    // ── Polymarket results ──────────────────────────────────────────────────────
+    const polyEvents = await polyPromise;
+    const polyMarkets = [];
+    for (const event of polyEvents) {
+        for (const m of (event.markets || [])) {
+            if (!m.active || m.closed)
+                continue;
+            const prices = (0, polymarket_js_1.parseOutcomePrices)(m.outcomePrices);
+            const yesPrice = prices[0] || 0;
+            polyMarkets.push({
+                venue: 'polymarket',
+                ticker: m.conditionId?.slice(0, 16) || m.id,
+                title: m.groupItemTitle
+                    ? `${event.title}: ${m.groupItemTitle}`
+                    : m.question || event.title,
+                yesAsk: yesPrice,
+                lastPrice: m.lastTradePrice || yesPrice,
+                volume24h: m.volume24hr || 0,
+                liquidity: m.liquidityNum || 0,
+            });
+        }
+    }
+    // ── Merge & output ─────────────────────────────────────────────────────────
+    // Tag Kalshi markets with venue
+    for (const m of allMarkets) {
+        if (!m.venue)
+            m.venue = 'kalshi';
+    }
+    const combined = [...allMarkets, ...polyMarkets];
+    combined.sort((a, b) => b.liquidity - a.liquidity);
     if (json) {
-        console.log(JSON.stringify(allMarkets, null, 2));
+        console.log(JSON.stringify(combined, null, 2));
         return;
     }
-    (0, utils_js_1.header)(`${allMarkets.length} Live Markets`);
+    (0, utils_js_1.header)(`${combined.length} Live Markets (${allMarkets.length} Kalshi + ${polyMarkets.length} Polymarket)`);
     console.log(utils_js_1.c.bold +
-        (0, utils_js_1.pad)('Ticker', 35) +
+        (0, utils_js_1.pad)('', 5) +
+        (0, utils_js_1.pad)('Ticker', 30) +
         (0, utils_js_1.rpad)('Yes', 6) +
         (0, utils_js_1.rpad)('Last', 6) +
         (0, utils_js_1.rpad)('Vol24h', 10) +
         (0, utils_js_1.rpad)('Liq', 10) +
         '  Title' +
         utils_js_1.c.reset);
-    (0, utils_js_1.hr)(110);
-    for (const m of allMarkets.slice(0, 50)) {
-        console.log((0, utils_js_1.pad)(m.ticker, 35) +
+    (0, utils_js_1.hr)(120);
+    for (const m of combined.slice(0, 60)) {
+        // Venue tag: fixed 5-char column, color applied AFTER padding
+        const venuePad = m.venue === 'polymarket' ? 'POLY ' : 'KLSH ';
+        const venueColored = m.venue === 'polymarket'
+            ? utils_js_1.c.blue + venuePad + utils_js_1.c.reset
+            : utils_js_1.c.cyan + venuePad + utils_js_1.c.reset;
+        const tickerStr = m.venue === 'polymarket'
+            ? (m.ticker || '').slice(0, 28)
+            : (m.ticker || '').slice(0, 28);
+        console.log(venueColored +
+            (0, utils_js_1.pad)(tickerStr, 30) +
             (0, utils_js_1.rpad)(`${Math.round(m.yesAsk * 100)}¢`, 6) +
             (0, utils_js_1.rpad)(`${Math.round(m.lastPrice * 100)}¢`, 6) +
-            (0, utils_js_1.rpad)((0, utils_js_1.vol)(m.volume24h), 10) +
-            (0, utils_js_1.rpad)((0, utils_js_1.vol)(m.liquidity), 10) +
-            `  ${m.title.slice(0, 55)}`);
+            (0, utils_js_1.rpad)((0, utils_js_1.vol)(Math.round(m.volume24h)), 10) +
+            (0, utils_js_1.rpad)((0, utils_js_1.vol)(Math.round(m.liquidity)), 10) +
+            `  ${(m.title || '').slice(0, 55)}`);
     }
     console.log('');
 }

package/dist/commands/setup.d.ts

@@ -18,6 +18,7 @@ interface SetupOpts {
     enableTrading?: boolean;
     disableTrading?: boolean;
     kalshi?: boolean;
+    polymarket?: boolean;
 }
 export declare function setupCommand(opts: SetupOpts): Promise<void>;
 export {};

package/dist/commands/setup.js

@@ -165,6 +165,17 @@ async function setupCommand(opts) {
         blank();
         return;
     }
+    // ── sf setup --polymarket (reconfigure Polymarket credentials) ──────────
+    if (opts.polymarket) {
+        const existing = (0, config_js_1.loadFileConfig)();
+        blank();
+        console.log(`  ${bold('Reconfigure Polymarket Credentials')}`);
+        blank();
+        await promptForPolymarket(existing);
+        (0, config_js_1.saveConfig)(existing);
+        blank();
+        return;
+    }
     // ── sf setup --enable-trading / --disable-trading ────────────────────────
     if (opts.enableTrading) {
         const existing = (0, config_js_1.loadFileConfig)();
@@ -211,6 +222,13 @@ async function showCheck() {
     else {
         info(`${dim('○')} KALSHI            ${dim('skipped')}`);
     }
+    // Polymarket
+    if (config.polymarketWalletAddress) {
+        ok(`POLYMARKET        ${dim(mask(config.polymarketWalletAddress))}`);
+    }
+    else {
+        info(`${dim('○')} POLYMARKET        ${dim('skipped')}`);
+    }
     // Tavily
     if (config.tavilyKey) {
         ok(`TAVILY            ${dim(mask(config.tavilyKey))}`);
@@ -318,9 +336,27 @@ async function runWizard() {
     }
     (0, config_js_1.saveConfig)(config);
     // ════════════════════════════════════════════════════════════════════════════
-    // Step 4: Tavily
+    // Step 4: Polymarket
+    // ════════════════════════════════════════════════════════════════════════════
+    console.log(`  ${bold('Step 4: Polymarket (optional)')}`);
+    blank();
+    const existingPolyWallet = process.env.POLYMARKET_WALLET_ADDRESS || config.polymarketWalletAddress;
+    if (existingPolyWallet) {
+        ok(`Detected wallet — ${dim(mask(existingPolyWallet))}`);
+        info(dim('Skipping.'));
+        config.polymarketWalletAddress = existingPolyWallet;
+        blank();
+    }
+    else {
+        await promptForPolymarket(config);
+    }
+    (0, config_js_1.saveConfig)(config);
+    if (config.polymarketWalletAddress)
+        process.env.POLYMARKET_WALLET_ADDRESS = config.polymarketWalletAddress;
+    // ════════════════════════════════════════════════════════════════════════════
+    // Step 5: Tavily
     // ════════════════════════════════════════════════════════════════════════════
-    console.log(`  ${bold('Step 4: News Search (optional)')}`);
+    console.log(`  ${bold('Step 5: News Search (optional)')}`);
     blank();
     const existingTavily = process.env.TAVILY_API_KEY || config.tavilyKey;
     if (existingTavily) {
@@ -346,7 +382,7 @@ async function runWizard() {
     // Step 5: Trading
     // ════════════════════════════════════════════════════════════════════════════
     if (config.kalshiKeyId) {
-        console.log(`  ${bold('Step 5: Trading (optional)')}`);
+        console.log(`  ${bold('Step 6: Trading (optional)')}`);
         blank();
         info('Warning: enabling this unlocks sf buy / sf sell / sf cancel.');
         info('Your Kalshi API key must have read+write permissions.');
@@ -493,7 +529,36 @@ async function promptForTavily() {
     blank();
     return answer;
 }
-// ─── Step 6: Thesis ──────────────────────────────────────────────────────────
+async function promptForPolymarket(config) {
+    info('Connect Polymarket to view positions and scan orderbooks.');
+    info('Your Polygon wallet address is needed (starts with 0x...).');
+    info(`Find it at ${cyan('https://polymarket.com')} → Settings → Profile.`);
+    info('Press Enter to skip:');
+    blank();
+    const walletAddress = await prompt('  Wallet address > ');
+    if (!walletAddress) {
+        info(dim('Skipped.'));
+        blank();
+        return;
+    }
+    if (!walletAddress.startsWith('0x') || walletAddress.length < 40) {
+        fail('Invalid wallet address (must start with 0x and be 42 characters)');
+        info(dim('Saved anyway. You can fix it later with sf setup.'));
+    }
+    else {
+        ok(`Wallet: ${mask(walletAddress)}`);
+    }
+    config.polymarketWalletAddress = walletAddress;
+    // Optionally configure private key for future trading
+    info(dim('Private key (for future trading) — press Enter to skip:'));
+    const keyPath = await prompt('  Key path > ');
+    if (keyPath) {
+        config.polymarketPrivateKeyPath = keyPath;
+        ok(`Private key path: ${dim(keyPath)}`);
+    }
+    blank();
+}
+// ─── Step 7: Thesis ──────────────────────────────────────────────────────────
 async function handleThesisStep(config) {
     try {
         const client = new client_js_1.SFClient(config.apiKey, config.apiUrl);
@@ -501,7 +566,7 @@ async function handleThesisStep(config) {
         const theses = data.theses || [];
         const activeTheses = theses.filter((t) => t.status === 'active');
         if (activeTheses.length > 0) {
-            console.log(`  ${bold('Step 6: Theses')}`);
+            console.log(`  ${bold('Step 7: Theses')}`);
             blank();
             ok(`Found ${activeTheses.length} active thesis(es):`);
             for (const t of activeTheses.slice(0, 5)) {
@@ -542,7 +607,7 @@ async function handleThesisStep(config) {
             return;
         }
         // No theses — offer to create one
-        console.log(`  ${bold('Step 6: Create Your First Thesis')}`);
+        console.log(`  ${bold('Step 7: Create Your First Thesis')}`);
         blank();
         info('A thesis is your core market conviction. The system builds a causal model');
         info('from it, then continuously scans prediction markets for mispriced contracts.');

package/dist/config.d.ts

@@ -13,6 +13,8 @@ export interface SFConfig {
     openrouterKey?: string;
     kalshiKeyId?: string;
     kalshiPrivateKeyPath?: string;
+    polymarketWalletAddress?: string;
+    polymarketPrivateKeyPath?: string;
     tavilyKey?: string;
     model?: string;
     tradingEnabled?: boolean;

package/dist/config.js

@@ -50,6 +50,8 @@ function loadConfig() {
         openrouterKey: process.env.OPENROUTER_API_KEY || file.openrouterKey,
         kalshiKeyId: process.env.KALSHI_API_KEY_ID || file.kalshiKeyId,
         kalshiPrivateKeyPath: process.env.KALSHI_PRIVATE_KEY_PATH || file.kalshiPrivateKeyPath,
+        polymarketWalletAddress: process.env.POLYMARKET_WALLET_ADDRESS || file.polymarketWalletAddress,
+        polymarketPrivateKeyPath: process.env.POLYMARKET_PRIVATE_KEY_PATH || file.polymarketPrivateKeyPath,
         tavilyKey: process.env.TAVILY_API_KEY || file.tavilyKey,
         model: process.env.SF_MODEL || file.model || DEFAULT_MODEL,
         tradingEnabled: file.tradingEnabled || false,
@@ -101,6 +103,12 @@ function applyConfig() {
     if (!process.env.KALSHI_PRIVATE_KEY_PATH && file.kalshiPrivateKeyPath) {
         process.env.KALSHI_PRIVATE_KEY_PATH = file.kalshiPrivateKeyPath;
     }
+    if (!process.env.POLYMARKET_WALLET_ADDRESS && file.polymarketWalletAddress) {
+        process.env.POLYMARKET_WALLET_ADDRESS = file.polymarketWalletAddress;
+    }
+    if (!process.env.POLYMARKET_PRIVATE_KEY_PATH && file.polymarketPrivateKeyPath) {
+        process.env.POLYMARKET_PRIVATE_KEY_PATH = file.polymarketPrivateKeyPath;
+    }
     if (!process.env.TAVILY_API_KEY && file.tavilyKey) {
         process.env.TAVILY_API_KEY = file.tavilyKey;
     }

package/dist/index.js

@@ -52,18 +52,84 @@ const announcements_js_1 = require("./commands/announcements.js");
 const history_js_1 = require("./commands/history.js");
 const performance_js_1 = require("./commands/performance.js");
 const liquidity_js_1 = require("./commands/liquidity.js");
+const book_js_1 = require("./commands/book.js");
 const telegram_js_1 = require("./commands/telegram.js");
 const utils_js_1 = require("./utils.js");
 // ── Apply ~/.sf/config.json to process.env BEFORE any command ────────────────
 // This means client.ts, kalshi.ts, agent.ts keep reading process.env and just work.
 (0, config_js_1.applyConfig)();
 const program = new commander_1.Command();
+const GROUPED_HELP = `
+\x1b[1mSimpleFunctions CLI\x1b[22m — prediction market thesis agent
+
+\x1b[1mUsage:\x1b[22m  sf <command> [options]
+        sf <command> --help for detailed options
+
+\x1b[1mSetup\x1b[22m
+  \x1b[36msetup\x1b[39m                     Interactive config wizard
+  \x1b[36msetup --check\x1b[39m              Show config status
+  \x1b[36msetup --polymarket\x1b[39m         Configure Polymarket wallet
+
+\x1b[1mThesis\x1b[22m
+  \x1b[36mlist\x1b[39m                       List all theses
+  \x1b[36mget\x1b[39m <id>                   Full thesis details
+  \x1b[36mcontext\x1b[39m <id> [--json]      Thesis snapshot \x1b[2m(primary for agents)\x1b[22m
+  \x1b[36mcreate\x1b[39m "thesis"            Create a new thesis
+  \x1b[36msignal\x1b[39m <id> "content"      Inject a signal
+  \x1b[36mevaluate\x1b[39m <id>              Trigger deep evaluation
+  \x1b[36mpublish\x1b[39m / \x1b[36munpublish\x1b[39m <id>  Manage public visibility
+
+\x1b[1mMarkets\x1b[22m
+  \x1b[36mscan\x1b[39m "keywords"            Search Kalshi + Polymarket
+  \x1b[36mscan\x1b[39m --series TICKER       Browse a Kalshi series
+  \x1b[36medges\x1b[39m [--json]             Top edges across all theses
+  \x1b[36mwhatif\x1b[39m <id>                What-if scenario analysis
+  \x1b[36mliquidity\x1b[39m [topic]          Orderbook liquidity scanner
+  \x1b[36mbook\x1b[39m <ticker> [ticker2...]  Orderbook depth for specific markets
+  \x1b[36mexplore\x1b[39m [slug]             Browse public theses
+  \x1b[36mforecast\x1b[39m <event>           Market distribution (P50/P75/P90)
+
+\x1b[1mPortfolio\x1b[22m
+  \x1b[36mpositions\x1b[39m                  Kalshi + Polymarket positions
+  \x1b[36mbalance\x1b[39m                    Account balance
+  \x1b[36morders\x1b[39m                     Resting orders
+  \x1b[36mfills\x1b[39m                      Recent trade fills
+  \x1b[36msettlements\x1b[39m                Settled contracts with P&L
+  \x1b[36mperformance\x1b[39m                P&L over time
+  \x1b[36mdashboard\x1b[39m                  Interactive TUI overview
+
+\x1b[1mTrading\x1b[22m  \x1b[2m(requires sf setup --enable-trading)\x1b[22m
+  \x1b[36mbuy\x1b[39m <ticker> <qty>         Buy contracts
+  \x1b[36msell\x1b[39m <ticker> <qty>        Sell contracts
+  \x1b[36mcancel\x1b[39m [orderId]           Cancel order(s)
+  \x1b[36mrfq\x1b[39m <ticker> <qty>        Request for quote
+
+\x1b[1mInteractive\x1b[22m
+  \x1b[36magent\x1b[39m [id]                 Agent with natural language + tools
+  \x1b[36mtelegram\x1b[39m                   Telegram bot for monitoring
+
+\x1b[1mInfo\x1b[22m
+  \x1b[36mfeed\x1b[39m                       Evaluation history stream
+  \x1b[36mmilestones\x1b[39m                 Upcoming Kalshi events
+  \x1b[36mschedule\x1b[39m                   Exchange status
+  \x1b[36mannouncements\x1b[39m              Exchange announcements
+  \x1b[36mhistory\x1b[39m <ticker>           Historical market data
+`;
 program
     .name('sf')
     .description('SimpleFunctions CLI — prediction market thesis agent')
     .version('0.1.0')
     .option('--api-key <key>', 'API key (or set SF_API_KEY env var)')
-    .option('--api-url <url>', 'API base URL (or set SF_API_URL env var)');
+    .option('--api-url <url>', 'API base URL (or set SF_API_URL env var)')
+    .configureHelp({
+    formatHelp: (cmd, helper) => {
+        // For subcommands, use default help
+        if (cmd.parent)
+            return helper.formatHelp(cmd, helper);
+        // For main program, show grouped help
+        return GROUPED_HELP;
+    },
+});
 // ── Pre-action guard: check configuration ────────────────────────────────────
 const NO_CONFIG_COMMANDS = new Set(['setup', 'help', 'scan', 'explore', 'milestones', 'forecast', 'settlements', 'balance', 'orders', 'fills', 'schedule', 'announcements', 'history', 'liquidity']);
 program.hook('preAction', (thisCommand, actionCommand) => {
@@ -91,16 +157,18 @@ program
     .option('--enable-trading', 'Enable trading (sf buy/sell/cancel)')
     .option('--disable-trading', 'Disable trading')
     .option('--kalshi', 'Reconfigure Kalshi API credentials')
+    .option('--polymarket', 'Reconfigure Polymarket wallet address')
     .action(async (opts) => {
-    await run(() => (0, setup_js_1.setupCommand)({ check: opts.check, reset: opts.reset, key: opts.key, enableTrading: opts.enableTrading, disableTrading: opts.disableTrading, kalshi: opts.kalshi }));
+    await run(() => (0, setup_js_1.setupCommand)({ check: opts.check, reset: opts.reset, key: opts.key, enableTrading: opts.enableTrading, disableTrading: opts.disableTrading, kalshi: opts.kalshi, polymarket: opts.polymarket }));
 });
 // ── sf list ──────────────────────────────────────────────────────────────────
 program
     .command('list')
     .description('List all theses')
-    .action(async (_opts, cmd) => {
+    .option('--json', 'JSON output')
+    .action(async (opts, cmd) => {
     const g = cmd.optsWithGlobals();
-    await run(() => (0, list_js_1.listCommand)({ apiKey: g.apiKey, apiUrl: g.apiUrl }));
+    await run(() => (0, list_js_1.listCommand)({ json: opts.json, apiKey: g.apiKey, apiUrl: g.apiUrl }));
 });
 // ── sf get <id> ───────────────────────────────────────────────────────────────
 program
@@ -125,9 +193,10 @@ program
     .command('create <thesis>')
     .description('Create a new thesis (sync by default — waits for formation)')
     .option('--async', 'Async mode — return immediately without waiting')
+    .option('--json', 'JSON output')
     .action(async (thesis, opts, cmd) => {
     const g = cmd.optsWithGlobals();
-    await run(() => (0, create_js_1.createCommand)(thesis, { async: opts.async, apiKey: g.apiKey, apiUrl: g.apiUrl }));
+    await run(() => (0, create_js_1.createCommand)(thesis, { async: opts.async, json: opts.json, apiKey: g.apiKey, apiUrl: g.apiUrl }));
 });
 // ── sf signal <id> <content> ──────────────────────────────────────────────────
 program
@@ -149,9 +218,10 @@ program
 // ── sf scan [query] ───────────────────────────────────────────────────────────
 program
     .command('scan [query]')
-    .description('Explore Kalshi markets (no auth required)')
+    .description('Explore Kalshi + Polymarket markets')
     .option('--series <ticker>', 'List events + markets for a series (e.g. KXWTIMAX)')
     .option('--market <ticker>', 'Get single market detail (e.g. KXWTIMAX-26DEC31-T140)')
+    .option('--venue <venue>', 'Filter by venue: kalshi, polymarket, or all (default: all)')
     .option('--json', 'Output raw JSON')
     .action(async (query, opts, cmd) => {
     const g = cmd.optsWithGlobals();
@@ -163,6 +233,7 @@ program
     await run(() => (0, scan_js_1.scanCommand)(q, {
         series: opts.series,
         market: opts.market,
+        venue: opts.venue,
         json: opts.json,
         apiKey: g.apiKey,
         apiUrl: g.apiUrl,
@@ -402,14 +473,29 @@ program
 });
 // ── sf liquidity ─────────────────────────────────────────────────────────────
 program
-    .command('liquidity')
-    .description('Market liquidity scanner by topic and horizon')
-    .option('--topic <topic>', 'Filter topic (oil, recession, fed, cpi, gas, sp500)')
+    .command('liquidity [topic]')
+    .description('Market liquidity scanner — run without args to see topics')
+    .option('--all', 'Scan all topics')
+    .option('--venue <venue>', 'Filter venue: kalshi, polymarket, all (default: all)')
     .option('--horizon <horizon>', 'Filter horizon (weekly, monthly, long-term)')
     .option('--min-depth <depth>', 'Minimum bid+ask depth', parseInt)
     .option('--json', 'JSON output')
-    .action(async (opts) => {
-    await run(() => (0, liquidity_js_1.liquidityCommand)(opts));
+    .action(async (topic, opts) => {
+    await run(() => (0, liquidity_js_1.liquidityCommand)({ ...opts, topic }));
+});
+// ── sf book ──────────────────────────────────────────────────────────────────
+program
+    .command('book [tickers...]')
+    .description('Orderbook depth, spread, and liquidity for specific markets')
+    .option('--poly <query>', 'Search Polymarket markets by keyword')
+    .option('--history', 'Include 7-day price history sparkline')
+    .option('--json', 'JSON output')
+    .action(async (tickers, opts) => {
+    if (tickers.length === 0 && !opts.poly) {
+        console.error('Usage: sf book <ticker> [ticker2...]  OR  sf book --poly "oil price"');
+        process.exit(1);
+    }
+    await run(() => (0, book_js_1.bookCommand)(tickers, opts));
 });
 // ── sf telegram ──────────────────────────────────────────────────────────────
 program