@spfunctions/cli 1.1.3 → 1.1.4

package/dist/commands/agent.js

@@ -520,7 +520,7 @@ async function agentCommand(thesisId, opts) {
                     const series = await (0, client_js_1.kalshiFetchAllSeries)();
                     const keywords = params.query.toLowerCase().split(/\s+/);
                     const matched = series
-                        .filter((s) => keywords.some((kw) => (s.title || '').toLowerCase().includes(kw) ||
+                        .filter((s) => keywords.every((kw) => (s.title || '').toLowerCase().includes(kw) ||
                         (s.ticker || '').toLowerCase().includes(kw)))
                         .slice(0, 15);
                     result = matched;

package/dist/commands/edges.d.ts

@@ -0,0 +1,21 @@
+/**
+ * sf edges — Top edges across all active theses
+ *
+ * The most important output of the entire system: "what to trade now."
+ *
+ * Flow:
+ * 1. GET /api/thesis → all active theses
+ * 2. For each: GET /api/thesis/:id/context → edges with orderbook
+ * 3. Optional: getPositions() → Kalshi positions with live prices
+ * 4. Merge edges, dedupe by marketId (keep highest edge, note source thesis)
+ * 5. Sort by executableEdge descending
+ * 6. Display table with position overlay + summary
+ */
+interface EdgesOpts {
+    json?: boolean;
+    limit?: string;
+    apiKey?: string;
+    apiUrl?: string;
+}
+export declare function edgesCommand(opts: EdgesOpts): Promise<void>;
+export {};

package/dist/commands/edges.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * sf edges — Top edges across all active theses
+ *
+ * The most important output of the entire system: "what to trade now."
+ *
+ * Flow:
+ * 1. GET /api/thesis → all active theses
+ * 2. For each: GET /api/thesis/:id/context → edges with orderbook
+ * 3. Optional: getPositions() → Kalshi positions with live prices
+ * 4. Merge edges, dedupe by marketId (keep highest edge, note source thesis)
+ * 5. Sort by executableEdge descending
+ * 6. Display table with position overlay + summary
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.edgesCommand = edgesCommand;
+const client_js_1 = require("../client.js");
+const kalshi_js_1 = require("../kalshi.js");
+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');
+    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}`);
+    const allEdges = [];
+    const contextPromises = theses.map(async (t) => {
+        try {
+            const ctx = await client.getContext(t.id);
+            return { thesisId: t.id, edges: ctx.edges || [] };
+        }
+        catch {
+            return { thesisId: t.id, edges: [] };
+        }
+    });
+    const results = await Promise.all(contextPromises);
+    for (const { thesisId, edges } of results) {
+        for (const e of edges) {
+            allEdges.push({
+                marketId: e.marketId || '',
+                market: e.market || e.marketTitle || e.marketId || '',
+                venue: e.venue || 'kalshi',
+                direction: e.direction || 'yes',
+                marketPrice: typeof e.marketPrice === 'number' ? e.marketPrice : 0,
+                thesisPrice: typeof e.thesisPrice === 'number' ? e.thesisPrice : 0,
+                edge: typeof e.edge === 'number' ? e.edge : 0,
+                executableEdge: typeof e.executableEdge === 'number' ? e.executableEdge : null,
+                spread: e.orderbook?.spread ?? null,
+                liquidityScore: e.orderbook?.liquidityScore ?? null,
+                thesisId,
+                position: null,
+            });
+        }
+    }
+    if (allEdges.length === 0) {
+        console.log(`${utils_js_1.c.yellow}No edges found across ${theses.length} theses.${utils_js_1.c.reset}`);
+        return;
+    }
+    // ── Step 3: Dedupe by marketId — keep highest absolute edge ────────────────
+    const deduped = new Map();
+    for (const edge of allEdges) {
+        const key = edge.marketId;
+        if (!key)
+            continue;
+        const existing = deduped.get(key);
+        if (!existing || Math.abs(edge.edge) > Math.abs(existing.edge)) {
+            deduped.set(key, edge);
+        }
+    }
+    let merged = Array.from(deduped.values());
+    // ── Step 4: Fetch positions (optional) ─────────────────────────────────────
+    let positions = null;
+    if ((0, kalshi_js_1.isKalshiConfigured)()) {
+        console.log(`${utils_js_1.c.dim}Fetching Kalshi positions...${utils_js_1.c.reset}`);
+        positions = await (0, kalshi_js_1.getPositions)();
+        if (positions) {
+            // Enrich with live prices
+            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);
+                }
+            }
+            // Match positions to edges
+            for (const edge of merged) {
+                const pos = positions.find(p => p.ticker === edge.marketId ||
+                    (edge.marketId && p.ticker?.includes(edge.marketId)));
+                if (pos) {
+                    edge.position = {
+                        side: pos.side || 'yes',
+                        quantity: pos.quantity,
+                        avgPrice: pos.average_price_paid,
+                        currentValue: pos.current_value,
+                        pnl: pos.unrealized_pnl || 0,
+                        totalCost: pos.total_cost || Math.round(pos.average_price_paid * pos.quantity),
+                    };
+                }
+            }
+        }
+    }
+    // ── 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);
+    });
+    // Apply limit
+    const display = merged.slice(0, limit);
+    // ── Step 6: JSON output ────────────────────────────────────────────────────
+    if (opts.json) {
+        console.log(JSON.stringify({
+            totalEdges: merged.length,
+            displayed: display.length,
+            thesesScanned: theses.length,
+            edges: display,
+        }, null, 2));
+        return;
+    }
+    // ── Step 6: Pretty output ──────────────────────────────────────────────────
+    console.log();
+    (0, utils_js_1.header)(`Top Edges Across ${theses.length} Theses`);
+    console.log();
+    // Header row
+    const hdr = [
+        (0, utils_js_1.pad)('Market', 32),
+        (0, utils_js_1.rpad)('Mkt', 5),
+        (0, utils_js_1.rpad)('Thesis', 7),
+        (0, utils_js_1.rpad)('Edge', 6),
+        (0, utils_js_1.rpad)('Exec', 6),
+        (0, utils_js_1.rpad)('Sprd', 5),
+        (0, utils_js_1.pad)('Liq', 5),
+        (0, utils_js_1.pad)('Thesis', 10),
+        (0, utils_js_1.pad)('Position', 20),
+    ].join(' ');
+    console.log(`${utils_js_1.c.dim}${hdr}${utils_js_1.c.reset}`);
+    (0, utils_js_1.hr)(100);
+    for (const edge of display) {
+        const name = (0, utils_js_1.trunc)(edge.market, 31);
+        const mktStr = `${edge.marketPrice}¢`;
+        const thesisStr = `${edge.thesisPrice}¢`;
+        const edgeStr = edge.edge > 0 ? `+${edge.edge}` : `${edge.edge}`;
+        const execStr = edge.executableEdge !== null ? (edge.executableEdge > 0 ? `+${edge.executableEdge}` : `${edge.executableEdge}`) : '—';
+        const spreadStr = edge.spread !== null ? `${edge.spread}¢` : '—';
+        const liqStr = edge.liquidityScore || '—';
+        const thesisIdStr = (0, utils_js_1.shortId)(edge.thesisId);
+        // Color the edge values
+        const edgeColor = edge.edge > 0 ? utils_js_1.c.green : edge.edge < 0 ? utils_js_1.c.red : utils_js_1.c.dim;
+        const execColor = edge.executableEdge !== null ? (edge.executableEdge > 0 ? utils_js_1.c.green : utils_js_1.c.red) : utils_js_1.c.dim;
+        const liqColor = liqStr === 'high' ? utils_js_1.c.green : liqStr === 'medium' ? utils_js_1.c.yellow : utils_js_1.c.dim;
+        // Position string
+        let posStr = `${utils_js_1.c.dim}—${utils_js_1.c.reset}`;
+        if (edge.position) {
+            const p = edge.position;
+            const pnlStr = p.pnl >= 0 ? `${utils_js_1.c.green}+$${(p.pnl / 100).toFixed(0)}${utils_js_1.c.reset}` : `${utils_js_1.c.red}-$${(Math.abs(p.pnl) / 100).toFixed(0)}${utils_js_1.c.reset}`;
+            posStr = `${utils_js_1.c.green}${p.quantity}@${p.avgPrice}¢${utils_js_1.c.reset} ${pnlStr}`;
+        }
+        const row = [
+            edge.position ? `${utils_js_1.c.green}${(0, utils_js_1.pad)(name, 32)}${utils_js_1.c.reset}` : (0, utils_js_1.pad)(name, 32),
+            (0, utils_js_1.rpad)(mktStr, 5),
+            (0, utils_js_1.rpad)(thesisStr, 7),
+            `${edgeColor}${(0, utils_js_1.rpad)(edgeStr, 6)}${utils_js_1.c.reset}`,
+            `${execColor}${(0, utils_js_1.rpad)(execStr, 6)}${utils_js_1.c.reset}`,
+            (0, utils_js_1.rpad)(spreadStr, 5),
+            `${liqColor}${(0, utils_js_1.pad)(liqStr, 5)}${utils_js_1.c.reset}`,
+            `${utils_js_1.c.dim}${(0, utils_js_1.pad)(thesisIdStr, 10)}${utils_js_1.c.reset}`,
+            posStr,
+        ].join(' ');
+        console.log(row);
+    }
+    // ── Summary ────────────────────────────────────────────────────────────────
+    (0, utils_js_1.hr)(100);
+    // Positioned summary
+    const positioned = display.filter(e => e.position);
+    if (positioned.length > 0) {
+        let totalCost = 0;
+        let totalPnl = 0;
+        for (const e of positioned) {
+            totalCost += e.position.totalCost;
+            totalPnl += e.position.pnl;
+        }
+        const costStr = `$${(totalCost / 100).toFixed(0)}`;
+        const pnlColor = totalPnl >= 0 ? utils_js_1.c.green : utils_js_1.c.red;
+        const pnlSign = totalPnl >= 0 ? '+' : '-';
+        const pnlStr = `${pnlColor}${pnlSign}$${(Math.abs(totalPnl) / 100).toFixed(0)}${utils_js_1.c.reset}`;
+        console.log(`${utils_js_1.c.bold}Total positioned:${utils_js_1.c.reset} ${costStr} cost | P&L: ${pnlStr}`);
+    }
+    // Top unpositioned
+    const unpositioned = display.filter(e => !e.position && e.edge > 0);
+    if (unpositioned.length > 0) {
+        const top = unpositioned[0];
+        const execLabel = top.executableEdge !== null ? `exec +${top.executableEdge}` : `edge +${top.edge}`;
+        const liq = top.liquidityScore ? `, ${top.liquidityScore} liq` : '';
+        console.log(`${utils_js_1.c.bold}Top unpositioned:${utils_js_1.c.reset} ${(0, utils_js_1.trunc)(top.market, 30)} @ ${top.marketPrice}¢ (${execLabel}${liq})`);
+    }
+    console.log();
+}

package/dist/commands/setup.d.ts

@@ -0,0 +1,20 @@
+/**
+ * sf setup — Interactive configuration wizard
+ *
+ * Walks user through:
+ *   1. SF API key (required)
+ *   2. OpenRouter API key (optional, for agent)
+ *   3. Kalshi exchange credentials (optional, for positions)
+ *   4. Tavily API key (optional, for web search)
+ *   5. First thesis creation (if none exist)
+ *
+ * Each key is validated in real-time.
+ * Config is saved to ~/.sf/config.json.
+ */
+interface SetupOpts {
+    check?: boolean;
+    reset?: boolean;
+    key?: string;
+}
+export declare function setupCommand(opts: SetupOpts): Promise<void>;
+export {};

package/dist/commands/setup.js

@@ -0,0 +1,569 @@
+"use strict";
+/**
+ * sf setup — Interactive configuration wizard
+ *
+ * Walks user through:
+ *   1. SF API key (required)
+ *   2. OpenRouter API key (optional, for agent)
+ *   3. Kalshi exchange credentials (optional, for positions)
+ *   4. Tavily API key (optional, for web search)
+ *   5. First thesis creation (if none exist)
+ *
+ * Each key is validated in real-time.
+ * Config is saved to ~/.sf/config.json.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupCommand = setupCommand;
+const readline_1 = __importDefault(require("readline"));
+const child_process_1 = require("child_process");
+const config_js_1 = require("../config.js");
+const client_js_1 = require("../client.js");
+const kalshi_js_1 = require("../kalshi.js");
+const agent_js_1 = require("./agent.js");
+// ─── ANSI helpers ────────────────────────────────────────────────────────────
+const green = (s) => `\x1b[32m${s}\x1b[39m`;
+const red = (s) => `\x1b[31m${s}\x1b[39m`;
+const dim = (s) => `\x1b[2m${s}\x1b[22m`;
+const bold = (s) => `\x1b[1m${s}\x1b[22m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[39m`;
+function ok(msg) { console.log(`  ${green('✓')} ${msg}`); }
+function fail(msg) { console.log(`  ${red('✗')} ${msg}`); }
+function info(msg) { console.log(`  ${msg}`); }
+function blank() { console.log(); }
+// ─── Prompt helper ───────────────────────────────────────────────────────────
+function prompt(question) {
+    const rl = readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        terminal: true,
+    });
+    return new Promise(resolve => {
+        rl.question(question, answer => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+function promptYN(question, defaultYes = true) {
+    return prompt(question).then(ans => {
+        if (!ans)
+            return defaultYes;
+        return ans.toLowerCase().startsWith('y');
+    });
+}
+function openBrowser(url) {
+    const cmd = process.platform === 'darwin' ? 'open' :
+        process.platform === 'win32' ? 'start' : 'xdg-open';
+    (0, child_process_1.exec)(`${cmd} ${url}`);
+}
+function mask(s) {
+    if (!s || s.length <= 12)
+        return s;
+    return s.slice(0, 8) + '...' + s.slice(-4);
+}
+// ─── Validators ──────────────────────────────────────────────────────────────
+async function validateSFKey(key, apiUrl) {
+    try {
+        const res = await fetch(`${apiUrl}/api/thesis`, {
+            headers: { 'Authorization': `Bearer ${key}` },
+        });
+        if (res.ok)
+            return { valid: true, msg: `API Key 有效 — 连接到 ${apiUrl.replace('https://', '')}` };
+        if (res.status === 401)
+            return { valid: false, msg: '无效 key，请重试' };
+        return { valid: false, msg: `服务器返回 ${res.status}` };
+    }
+    catch (err) {
+        return { valid: false, msg: `连接失败: ${err.message}` };
+    }
+}
+async function validateOpenRouterKey(key) {
+    try {
+        const res = await fetch('https://openrouter.ai/api/v1/models', {
+            headers: { 'Authorization': `Bearer ${key}` },
+        });
+        if (res.ok)
+            return { valid: true, msg: 'OpenRouter 连接正常 — 可用模型: claude-sonnet-4.6' };
+        return { valid: false, msg: `OpenRouter 返回 ${res.status}` };
+    }
+    catch (err) {
+        return { valid: false, msg: `连接失败: ${err.message}` };
+    }
+}
+async function validateKalshi() {
+    try {
+        const positions = await (0, kalshi_js_1.getPositions)();
+        if (positions === null)
+            return { valid: false, msg: 'Kalshi 认证失败', posCount: 0 };
+        return { valid: true, msg: `Kalshi 认证成功 — 发现 ${positions.length} 个持仓`, posCount: positions.length };
+    }
+    catch (err) {
+        return { valid: false, msg: `Kalshi 连接失败: ${err.message}`, posCount: 0 };
+    }
+}
+async function validateTavily(key) {
+    try {
+        const res = await fetch('https://api.tavily.com/search', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ api_key: key, query: 'test', max_results: 1 }),
+        });
+        if (res.ok)
+            return { valid: true, msg: 'Tavily 连接正常' };
+        return { valid: false, msg: `Tavily 返回 ${res.status}` };
+    }
+    catch (err) {
+        return { valid: false, msg: `连接失败: ${err.message}` };
+    }
+}
+async function setupCommand(opts) {
+    // ── sf setup --check ──────────────────────────────────────────────────────
+    if (opts.check) {
+        return showCheck();
+    }
+    // ── sf setup --reset ──────────────────────────────────────────────────────
+    if (opts.reset) {
+        (0, config_js_1.resetConfig)();
+        ok('配置已重置');
+        blank();
+        info('运行 sf setup 重新配置');
+        blank();
+        return;
+    }
+    // ── sf setup --key <key> (non-interactive) ────────────────────────────────
+    if (opts.key) {
+        const apiUrl = process.env.SF_API_URL || 'https://simplefunctions.dev';
+        const result = await validateSFKey(opts.key, apiUrl);
+        if (!result.valid) {
+            fail(result.msg);
+            process.exit(1);
+        }
+        const existing = (0, config_js_1.loadFileConfig)();
+        (0, config_js_1.saveConfig)({ ...existing, apiKey: opts.key, apiUrl });
+        ok(result.msg);
+        ok(`保存到 ${(0, config_js_1.getConfigPath)()}`);
+        return;
+    }
+    // ── Full interactive wizard ───────────────────────────────────────────────
+    return runWizard();
+}
+// ─── Check command ───────────────────────────────────────────────────────────
+async function showCheck() {
+    const config = (0, config_js_1.loadConfig)();
+    blank();
+    console.log(`  ${bold('SimpleFunctions 配置状态')}`);
+    console.log(`  ${dim('─'.repeat(35))}`);
+    blank();
+    // SF API Key
+    if (config.apiKey) {
+        ok(`SF_API_KEY        ${dim(mask(config.apiKey))}`);
+    }
+    else {
+        fail('SF_API_KEY        未配置（必须）');
+    }
+    // OpenRouter
+    if (config.openrouterKey) {
+        ok(`OPENROUTER_KEY    ${dim(mask(config.openrouterKey))}`);
+    }
+    else {
+        fail(`OPENROUTER_KEY    未配置（agent 不可用）`);
+    }
+    // Kalshi
+    if (config.kalshiKeyId && config.kalshiPrivateKeyPath) {
+        ok(`KALSHI            ${dim(mask(config.kalshiKeyId))}`);
+    }
+    else {
+        info(`${dim('○')} KALSHI            ${dim('跳过')}`);
+    }
+    // Tavily
+    if (config.tavilyKey) {
+        ok(`TAVILY            ${dim(mask(config.tavilyKey))}`);
+    }
+    else {
+        info(`${dim('○')} TAVILY            ${dim('跳过')}`);
+    }
+    blank();
+    console.log(`  ${dim('配置文件: ' + (0, config_js_1.getConfigPath)())}`);
+    blank();
+}
+// ─── Interactive Wizard ──────────────────────────────────────────────────────
+async function runWizard() {
+    blank();
+    console.log(`  ${bold('SimpleFunctions Setup')}`);
+    console.log(`  ${dim('─'.repeat(25))}`);
+    blank();
+    const config = (0, config_js_1.loadFileConfig)();
+    const apiUrl = config.apiUrl || 'https://simplefunctions.dev';
+    // ════════════════════════════════════════════════════════════════════════════
+    // Step 1: SF API Key
+    // ════════════════════════════════════════════════════════════════════════════
+    console.log(`  ${bold('第 1 步：API Key')}`);
+    blank();
+    const existingSfKey = process.env.SF_API_KEY || config.apiKey;
+    if (existingSfKey) {
+        const result = await validateSFKey(existingSfKey, apiUrl);
+        if (result.valid) {
+            ok(`已检测到 SF_API_KEY — ${dim(mask(existingSfKey))}`);
+            info(dim('跳过。'));
+            config.apiKey = existingSfKey;
+            blank();
+        }
+        else {
+            fail(`已有 key 无效: ${result.msg}`);
+            config.apiKey = await promptForSFKey(apiUrl);
+        }
+    }
+    else {
+        config.apiKey = await promptForSFKey(apiUrl);
+    }
+    // Save after each step (so partial progress is preserved)
+    config.apiUrl = apiUrl;
+    (0, config_js_1.saveConfig)(config);
+    // Also apply so subsequent validation calls can use it
+    process.env.SF_API_KEY = config.apiKey;
+    // ════════════════════════════════════════════════════════════════════════════
+    // Step 2: OpenRouter API Key
+    // ════════════════════════════════════════════════════════════════════════════
+    console.log(`  ${bold('第 2 步：AI 模型（用于 sf agent）')}`);
+    blank();
+    const existingOrKey = process.env.OPENROUTER_API_KEY || config.openrouterKey;
+    if (existingOrKey) {
+        const result = await validateOpenRouterKey(existingOrKey);
+        if (result.valid) {
+            ok(`已检测到 OPENROUTER_API_KEY — ${dim(mask(existingOrKey))}`);
+            info(dim('跳过。'));
+            config.openrouterKey = existingOrKey;
+            blank();
+        }
+        else {
+            fail(`已有 key 无效: ${result.msg}`);
+            config.openrouterKey = await promptForOpenRouterKey();
+        }
+    }
+    else {
+        config.openrouterKey = await promptForOpenRouterKey();
+    }
+    (0, config_js_1.saveConfig)(config);
+    if (config.openrouterKey)
+        process.env.OPENROUTER_API_KEY = config.openrouterKey;
+    // ════════════════════════════════════════════════════════════════════════════
+    // Step 3: Kalshi Exchange
+    // ════════════════════════════════════════════════════════════════════════════
+    console.log(`  ${bold('第 3 步：Kalshi 交易所（可选）')}`);
+    blank();
+    const existingKalshiId = process.env.KALSHI_API_KEY_ID || config.kalshiKeyId;
+    const existingKalshiPath = process.env.KALSHI_PRIVATE_KEY_PATH || config.kalshiPrivateKeyPath;
+    if (existingKalshiId && existingKalshiPath) {
+        // Temporarily apply for validation
+        process.env.KALSHI_API_KEY_ID = existingKalshiId;
+        process.env.KALSHI_PRIVATE_KEY_PATH = existingKalshiPath;
+        const result = await validateKalshi();
+        if (result.valid) {
+            ok(`已检测到 Kalshi — ${dim(mask(existingKalshiId))} (${result.posCount} 个持仓)`);
+            info(dim('跳过。'));
+            config.kalshiKeyId = existingKalshiId;
+            config.kalshiPrivateKeyPath = existingKalshiPath;
+            blank();
+        }
+        else {
+            fail(`已有凭证无效: ${result.msg}`);
+            await promptForKalshi(config);
+        }
+    }
+    else {
+        await promptForKalshi(config);
+    }
+    (0, config_js_1.saveConfig)(config);
+    // ════════════════════════════════════════════════════════════════════════════
+    // Step 4: Tavily
+    // ════════════════════════════════════════════════════════════════════════════
+    console.log(`  ${bold('第 4 步：新闻搜索（可选）')}`);
+    blank();
+    const existingTavily = process.env.TAVILY_API_KEY || config.tavilyKey;
+    if (existingTavily) {
+        const result = await validateTavily(existingTavily);
+        if (result.valid) {
+            ok(`已检测到 TAVILY_API_KEY — ${dim(mask(existingTavily))}`);
+            info(dim('跳过。'));
+            config.tavilyKey = existingTavily;
+            blank();
+        }
+        else {
+            fail(`已有 key 无效: ${result.msg}`);
+            config.tavilyKey = await promptForTavily();
+        }
+    }
+    else {
+        config.tavilyKey = await promptForTavily();
+    }
+    (0, config_js_1.saveConfig)(config);
+    if (config.tavilyKey)
+        process.env.TAVILY_API_KEY = config.tavilyKey;
+    // ════════════════════════════════════════════════════════════════════════════
+    // Summary
+    // ════════════════════════════════════════════════════════════════════════════
+    console.log(`  ${dim('─'.repeat(25))}`);
+    info(`配置保存到 ${dim((0, config_js_1.getConfigPath)())}`);
+    blank();
+    if (config.apiKey)
+        ok('SF_API_KEY        已配置');
+    else
+        fail('SF_API_KEY        未配置');
+    if (config.openrouterKey)
+        ok('OPENROUTER_KEY    已配置');
+    else
+        fail('OPENROUTER_KEY    跳过');
+    if (config.kalshiKeyId)
+        ok('KALSHI            已配置');
+    else
+        info(`${dim('○')} KALSHI            跳过`);
+    if (config.tavilyKey)
+        ok('TAVILY            已配置');
+    else
+        info(`${dim('○')} TAVILY            跳过`);
+    blank();
+    // ════════════════════════════════════════════════════════════════════════════
+    // Step 5: Thesis creation
+    // ════════════════════════════════════════════════════════════════════════════
+    if (config.apiKey) {
+        await handleThesisStep(config);
+    }
+}
+// ─── Step prompt helpers ─────────────────────────────────────────────────────
+async function promptForSFKey(apiUrl) {
+    info(`还没有 key？去 ${cyan('https://simplefunctions.dev/dashboard')} 注册获取。`);
+    info('按 Enter 打开浏览器，或直接粘贴你的 key：');
+    blank();
+    while (true) {
+        const answer = await prompt('  > ');
+        if (!answer) {
+            // Open browser
+            openBrowser('https://simplefunctions.dev/dashboard');
+            info(dim('浏览器已打开。获取 key 后粘贴到这里：'));
+            continue;
+        }
+        info(dim('验证中...'));
+        const result = await validateSFKey(answer, apiUrl);
+        if (result.valid) {
+            ok(result.msg);
+            blank();
+            return answer;
+        }
+        else {
+            fail(result.msg);
+        }
+    }
+}
+async function promptForOpenRouterKey() {
+    info(`需要 OpenRouter API key。去 ${cyan('https://openrouter.ai/settings/keys')} 获取。`);
+    info('按 Enter 跳过（agent 功能不可用），或粘贴 key：');
+    blank();
+    const answer = await prompt('  > ');
+    if (!answer) {
+        info(dim('跳过。'));
+        blank();
+        return undefined;
+    }
+    info(dim('验证中...'));
+    const result = await validateOpenRouterKey(answer);
+    if (result.valid) {
+        ok(result.msg);
+    }
+    else {
+        fail(result.msg);
+        info(dim('已保存，之后可以重新运行 sf setup 修正。'));
+    }
+    blank();
+    return answer;
+}
+async function promptForKalshi(config) {
+    info(`连接 Kalshi 查看你的持仓和盈亏。`);
+    info(`需要 API Key ID 和私钥文件。`);
+    info(`${cyan('https://kalshi.com/account/api-keys')} 获取。`);
+    info('按 Enter 跳过，或粘贴 Key ID：');
+    blank();
+    const keyId = await prompt('  > ');
+    if (!keyId) {
+        info(dim('跳过。'));
+        blank();
+        return;
+    }
+    info('私钥文件路径（默认 ~/.kalshi/private.pem）：');
+    const keyPathInput = await prompt('  > ');
+    const keyPath = keyPathInput || '~/.kalshi/private.pem';
+    config.kalshiKeyId = keyId;
+    config.kalshiPrivateKeyPath = keyPath;
+    // Temporarily set for validation
+    process.env.KALSHI_API_KEY_ID = keyId;
+    process.env.KALSHI_PRIVATE_KEY_PATH = keyPath;
+    info(dim('验证中...'));
+    const result = await validateKalshi();
+    if (result.valid) {
+        ok(result.msg);
+    }
+    else {
+        fail(result.msg);
+        info(dim('已保存，之后可以重新运行 sf setup 修正。'));
+    }
+    blank();
+}
+async function promptForTavily() {
+    info(`Tavily API 用于 agent 的 web_search 功能。`);
+    info(`${cyan('https://tavily.com')} 获取免费 key。`);
+    info('按 Enter 跳过：');
+    blank();
+    const answer = await prompt('  > ');
+    if (!answer) {
+        info(dim('跳过。'));
+        blank();
+        return undefined;
+    }
+    info(dim('验证中...'));
+    const result = await validateTavily(answer);
+    if (result.valid) {
+        ok(result.msg);
+    }
+    else {
+        fail(result.msg);
+        info(dim('已保存，之后可以重新运行 sf setup 修正。'));
+    }
+    blank();
+    return answer;
+}
+// ─── Step 5: Thesis ──────────────────────────────────────────────────────────
+async function handleThesisStep(config) {
+    try {
+        const client = new client_js_1.SFClient(config.apiKey, config.apiUrl);
+        const data = await client.listTheses();
+        const theses = data.theses || [];
+        const activeTheses = theses.filter((t) => t.status === 'active');
+        if (activeTheses.length > 0) {
+            console.log(`  ${bold('第 5 步：论文')}`);
+            blank();
+            ok(`已有 ${activeTheses.length} 个活跃论文：`);
+            for (const t of activeTheses.slice(0, 5)) {
+                const conf = typeof t.confidence === 'number' ? Math.round(t.confidence * 100) : 0;
+                const thesis = (t.rawThesis || t.thesis || t.title || '').slice(0, 60);
+                info(`  ${dim(t.id.slice(0, 8))} — ${thesis} — ${conf}%`);
+            }
+            info(dim('跳过创建。'));
+            blank();
+            // Offer to launch agent
+            if (config.openrouterKey) {
+                console.log(`  ${dim('─'.repeat(25))}`);
+                console.log(`  ${bold('全部就绪！')}`);
+                blank();
+                info(`  ${cyan('sf agent')}             和你的论文对话`);
+                info(`  ${cyan('sf context <id>')}      查看论文快照`);
+                info(`  ${cyan('sf positions')}         查看持仓`);
+                info(`  ${cyan('sf setup --check')}     检查配置`);
+                blank();
+                const shouldLaunch = await promptYN(`  要不要现在启动 agent？(Y/n) `);
+                if (shouldLaunch) {
+                    blank();
+                    info('启动中...');
+                    blank();
+                    await (0, agent_js_1.agentCommand)(activeTheses[0].id, { model: config.model });
+                }
+            }
+            else {
+                blank();
+                console.log(`  ${bold('全部就绪！')}`);
+                blank();
+                info(`  ${cyan('sf list')}              查看所有论文`);
+                info(`  ${cyan('sf context <id>')}      查看论文快照`);
+                info(`  ${cyan('sf positions')}         查看持仓`);
+                info(`  ${cyan('sf setup --check')}     检查配置`);
+                blank();
+            }
+            return;
+        }
+        // No theses — offer to create one
+        console.log(`  ${bold('第 5 步：创建你的第一个论文')}`);
+        blank();
+        info('论文是你对市场的一个核心判断。系统会基于它构建因果模型，');
+        info('然后持续扫描预测市场寻找被错误定价的合约。');
+        blank();
+        info('比如：');
+        info(`  ${dim('"美联储2026年不会降息，通胀因油价持续高企"')}`);
+        info(`  ${dim('"AI裁员潮导致消费萎缩，标普年底跌20%"')}`);
+        info(`  ${dim('"Trump无法退出伊朗战争，油价维持$100以上六个月"')}`);
+        blank();
+        const thesis = await prompt('  输入你的论文（按 Enter 跳过，之后用 sf create）：\n  > ');
+        if (!thesis) {
+            blank();
+            info(dim('跳过。之后用 sf create "你的论文" 创建。'));
+            blank();
+            showFinalHints(config);
+            return;
+        }
+        blank();
+        info('构建因果模型中...（约30秒）');
+        blank();
+        try {
+            const result = await client.createThesis(thesis, true);
+            if (result.id) {
+                const nodeCount = result.causalTree?.nodes?.length || 0;
+                const edgeCount = result.edgeAnalysis?.edges?.length || 0;
+                const totalMarkets = result.edgeAnalysis?.totalMarketsAnalyzed || 0;
+                const confidence = Math.round((parseFloat(result.confidence) || 0.5) * 100);
+                ok(`因果树：${nodeCount} 个节点`);
+                ok(`扫描 ${totalMarkets} 个市场，找到 ${edgeCount} 个有边际的合约`);
+                ok(`置信度：${confidence}%`);
+                ok(`论文 ID：${result.id.slice(0, 8)}`);
+                blank();
+                // Offer to launch agent
+                if (config.openrouterKey) {
+                    console.log(`  ${dim('─'.repeat(25))}`);
+                    console.log(`  ${bold('全部就绪！')}`);
+                    blank();
+                    const shouldLaunch = await promptYN(`  要不要现在启动 agent？(Y/n) `);
+                    if (shouldLaunch) {
+                        blank();
+                        info('启动中...');
+                        blank();
+                        await (0, agent_js_1.agentCommand)(result.id, { model: config.model });
+                    }
+                    else {
+                        blank();
+                        showFinalHints(config);
+                    }
+                }
+                else {
+                    showFinalHints(config);
+                }
+            }
+            else {
+                fail(`创建失败：${result.error || '未知错误'}`);
+                info(dim('之后可以用 sf create "你的论文" 重试'));
+                blank();
+                showFinalHints(config);
+            }
+        }
+        catch (err) {
+            fail(`创建失败：${err.message}`);
+            info(dim('之后可以用 sf create "你的论文" 重试'));
+            blank();
+            showFinalHints(config);
+        }
+    }
+    catch {
+        // Can't connect to API, skip thesis step
+        blank();
+        showFinalHints(config);
+    }
+}
+function showFinalHints(config) {
+    console.log(`  ${dim('─'.repeat(25))}`);
+    console.log(`  ${bold('全部就绪！')}`);
+    blank();
+    info(`  ${cyan('sf agent')}             和你的论文对话`);
+    info(`  ${cyan('sf list')}              查看所有论文`);
+    info(`  ${cyan('sf context <id>')}      查看论文快照`);
+    info(`  ${cyan('sf positions')}         查看持仓`);
+    info(`  ${cyan('sf setup --check')}     检查配置`);
+    blank();
+}

package/dist/config.d.ts

@@ -0,0 +1,50 @@
+/**
+ * CLI Configuration — ~/.sf/config.json
+ *
+ * Priority: env vars > config file > defaults
+ *
+ * After `sf setup`, all keys are stored in config.json.
+ * `applyConfig()` sets process.env from config so all existing code
+ * (client.ts, kalshi.ts, agent.ts) keeps working without changes.
+ */
+export interface SFConfig {
+    apiKey?: string;
+    apiUrl?: string;
+    openrouterKey?: string;
+    kalshiKeyId?: string;
+    kalshiPrivateKeyPath?: string;
+    tavilyKey?: string;
+    model?: string;
+    configuredAt?: string;
+}
+/**
+ * Load config from file. Does NOT apply env overrides — use resolveConfig() for that.
+ */
+export declare function loadFileConfig(): SFConfig;
+/**
+ * Resolve final config: env vars > config file > defaults.
+ */
+export declare function loadConfig(): SFConfig;
+/**
+ * Save config to ~/.sf/config.json.
+ */
+export declare function saveConfig(config: SFConfig): void;
+/**
+ * Delete config file (for --reset).
+ */
+export declare function resetConfig(): void;
+/**
+ * Apply config to process.env.
+ *
+ * Call this ONCE at CLI startup, before any command runs.
+ * This means client.ts, kalshi.ts, agent.ts etc. keep reading process.env
+ * and just work — no code changes needed in those files.
+ *
+ * Env vars already set by the user take priority (we only fill gaps).
+ */
+export declare function applyConfig(): void;
+/**
+ * Check if SF API key is configured (from any source).
+ */
+export declare function isConfigured(): boolean;
+export declare function getConfigPath(): string;

package/dist/config.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * CLI Configuration — ~/.sf/config.json
+ *
+ * Priority: env vars > config file > defaults
+ *
+ * After `sf setup`, all keys are stored in config.json.
+ * `applyConfig()` sets process.env from config so all existing code
+ * (client.ts, kalshi.ts, agent.ts) keeps working without changes.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadFileConfig = loadFileConfig;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.resetConfig = resetConfig;
+exports.applyConfig = applyConfig;
+exports.isConfigured = isConfigured;
+exports.getConfigPath = getConfigPath;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.sf');
+const CONFIG_PATH = path_1.default.join(CONFIG_DIR, 'config.json');
+const DEFAULT_API_URL = 'https://simplefunctions.dev';
+const DEFAULT_MODEL = 'anthropic/claude-sonnet-4.6';
+/**
+ * Load config from file. Does NOT apply env overrides — use resolveConfig() for that.
+ */
+function loadFileConfig() {
+    try {
+        if (fs_1.default.existsSync(CONFIG_PATH)) {
+            return JSON.parse(fs_1.default.readFileSync(CONFIG_PATH, 'utf-8'));
+        }
+    }
+    catch { /* corrupt file, ignore */ }
+    return {};
+}
+/**
+ * Resolve final config: env vars > config file > defaults.
+ */
+function loadConfig() {
+    const file = loadFileConfig();
+    return {
+        apiKey: process.env.SF_API_KEY || file.apiKey,
+        apiUrl: process.env.SF_API_URL || file.apiUrl || DEFAULT_API_URL,
+        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,
+        tavilyKey: process.env.TAVILY_API_KEY || file.tavilyKey,
+        model: process.env.SF_MODEL || file.model || DEFAULT_MODEL,
+    };
+}
+/**
+ * Save config to ~/.sf/config.json.
+ */
+function saveConfig(config) {
+    fs_1.default.mkdirSync(CONFIG_DIR, { recursive: true });
+    fs_1.default.writeFileSync(CONFIG_PATH, JSON.stringify({ ...config, configuredAt: new Date().toISOString() }, null, 2));
+}
+/**
+ * Delete config file (for --reset).
+ */
+function resetConfig() {
+    try {
+        if (fs_1.default.existsSync(CONFIG_PATH)) {
+            fs_1.default.unlinkSync(CONFIG_PATH);
+        }
+    }
+    catch { /* ignore */ }
+}
+/**
+ * Apply config to process.env.
+ *
+ * Call this ONCE at CLI startup, before any command runs.
+ * This means client.ts, kalshi.ts, agent.ts etc. keep reading process.env
+ * and just work — no code changes needed in those files.
+ *
+ * Env vars already set by the user take priority (we only fill gaps).
+ */
+function applyConfig() {
+    const file = loadFileConfig();
+    // Only set process.env if not already set (env vars > config file)
+    if (!process.env.SF_API_KEY && file.apiKey) {
+        process.env.SF_API_KEY = file.apiKey;
+    }
+    if (!process.env.SF_API_URL && file.apiUrl) {
+        process.env.SF_API_URL = file.apiUrl;
+    }
+    if (!process.env.OPENROUTER_API_KEY && file.openrouterKey) {
+        process.env.OPENROUTER_API_KEY = file.openrouterKey;
+    }
+    if (!process.env.KALSHI_API_KEY_ID && file.kalshiKeyId) {
+        process.env.KALSHI_API_KEY_ID = file.kalshiKeyId;
+    }
+    if (!process.env.KALSHI_PRIVATE_KEY_PATH && file.kalshiPrivateKeyPath) {
+        process.env.KALSHI_PRIVATE_KEY_PATH = file.kalshiPrivateKeyPath;
+    }
+    if (!process.env.TAVILY_API_KEY && file.tavilyKey) {
+        process.env.TAVILY_API_KEY = file.tavilyKey;
+    }
+    if (!process.env.SF_MODEL && file.model) {
+        process.env.SF_MODEL = file.model;
+    }
+}
+/**
+ * Check if SF API key is configured (from any source).
+ */
+function isConfigured() {
+    const config = loadConfig();
+    return !!config.apiKey;
+}
+function getConfigPath() {
+    return CONFIG_PATH;
+}

package/dist/index.d.ts

@@ -6,12 +6,15 @@
  * Zero heavy dependencies: commander + native fetch.
  *
  * Usage:
- *   sf list
- *   sf get <id>
- *   sf context <id> [--json]
+ *   sf setup                        — Interactive configuration wizard
+ *   sf list                         — List all theses
+ *   sf get <id>                     — Full thesis details
+ *   sf context <id> [--json]        — Thesis context snapshot
  *   sf create "thesis text" [--async]
  *   sf signal <id> "content" [--type news|user_note|external]
  *   sf evaluate <id>
  *   sf scan "keywords" [--series TICKER] [--market TICKER] [--json]
+ *   sf positions                    — Kalshi positions with edge overlay
+ *   sf agent [thesisId]             — Interactive agent mode
  */
 export {};

package/dist/index.js

@@ -7,16 +7,20 @@
  * Zero heavy dependencies: commander + native fetch.
  *
  * Usage:
- *   sf list
- *   sf get <id>
- *   sf context <id> [--json]
+ *   sf setup                        — Interactive configuration wizard
+ *   sf list                         — List all theses
+ *   sf get <id>                     — Full thesis details
+ *   sf context <id> [--json]        — Thesis context snapshot
  *   sf create "thesis text" [--async]
  *   sf signal <id> "content" [--type news|user_note|external]
  *   sf evaluate <id>
  *   sf scan "keywords" [--series TICKER] [--market TICKER] [--json]
+ *   sf positions                    — Kalshi positions with edge overlay
+ *   sf agent [thesisId]             — Interactive agent mode
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
+const config_js_1 = require("./config.js");
 const list_js_1 = require("./commands/list.js");
 const get_js_1 = require("./commands/get.js");
 const context_js_1 = require("./commands/context.js");
@@ -25,8 +29,13 @@ const signal_js_1 = require("./commands/signal.js");
 const evaluate_js_1 = require("./commands/evaluate.js");
 const scan_js_1 = require("./commands/scan.js");
 const positions_js_1 = require("./commands/positions.js");
+const edges_js_1 = require("./commands/edges.js");
 const agent_js_1 = require("./commands/agent.js");
+const setup_js_1 = require("./commands/setup.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();
 program
     .name('sf')
@@ -34,14 +43,33 @@ program
     .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)');
-// Helper to extract global opts from any command's opts chain
-function globalOpts(opts) {
-    // Commander merges parent opts into child opts when using .optsWithGlobals()
-    return {
-        apiKey: opts.apiKey || opts.parent?.apiKey,
-        apiUrl: opts.apiUrl || opts.parent?.apiUrl,
-    };
-}
+// ── Pre-action guard: check configuration ────────────────────────────────────
+const NO_CONFIG_COMMANDS = new Set(['setup', 'help', 'scan']);
+program.hook('preAction', (thisCommand) => {
+    const cmdName = thisCommand.name();
+    if (NO_CONFIG_COMMANDS.has(cmdName))
+        return;
+    // --api-key flag overrides config check
+    const g = thisCommand.optsWithGlobals?.() || thisCommand.opts();
+    if (g.apiKey)
+        return;
+    if (!(0, config_js_1.isConfigured)()) {
+        console.log();
+        console.log('  SimpleFunctions 未配置。运行 \x1b[36msf setup\x1b[39m 开始。');
+        console.log();
+        process.exit(1);
+    }
+});
+// ── sf setup ──────────────────────────────────────────────────────────────────
+program
+    .command('setup')
+    .description('Interactive configuration wizard')
+    .option('--check', 'Show current configuration status')
+    .option('--reset', 'Delete config and start over')
+    .option('--key <key>', 'Set SF API key (non-interactive, for CI)')
+    .action(async (opts) => {
+    await run(() => (0, setup_js_1.setupCommand)({ check: opts.check, reset: opts.reset, key: opts.key }));
+});
 // ── sf list ──────────────────────────────────────────────────────────────────
 program
     .command('list')
@@ -116,6 +144,21 @@ program
         apiUrl: g.apiUrl,
     }));
 });
+// ── sf edges ──────────────────────────────────────────────────────────────────
+program
+    .command('edges')
+    .description('Top edges across all theses — what to trade now')
+    .option('--json', 'JSON output for agents')
+    .option('--limit <n>', 'Max edges to show', '20')
+    .action(async (opts, cmd) => {
+    const g = cmd.optsWithGlobals();
+    await run(() => (0, edges_js_1.edgesCommand)({
+        json: opts.json,
+        limit: opts.limit,
+        apiKey: g.apiKey,
+        apiUrl: g.apiUrl,
+    }));
+});
 // ── sf positions ──────────────────────────────────────────────────────────────
 program
     .command('positions')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spfunctions/cli",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "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"