@spfunctions/cli 1.7.16 → 1.7.19

package/dist/types/output.d.ts

@@ -0,0 +1,412 @@
+/**
+ * Stable JSON output schemas for all SF CLI commands.
+ *
+ * IMPORTANT: These types define the contract that --share and sf watch depend on.
+ * Breaking changes here cascade to the share renderer and watch differ.
+ * Add fields freely; removing or renaming fields is a breaking change.
+ */
+export type Venue = 'kalshi' | 'polymarket';
+export interface MarketItem {
+    venue: Venue;
+    ticker: string;
+    title: string;
+    yesAsk: number;
+    lastPrice: number;
+    volume24h: number;
+    liquidity: number;
+    seriesTicker?: string;
+}
+export interface TraditionalMarket {
+    symbol: string;
+    name: string;
+    price: number;
+    changePct: number;
+    change1d?: number;
+}
+export interface EdgeItem {
+    marketId: string;
+    market: string;
+    venue: Venue;
+    direction: string;
+    marketPrice: number;
+    thesisPrice: number;
+    edge: number;
+    executableEdge: number | null;
+    spread: number | null;
+    liquidityScore: string | null;
+    thesisId: string;
+    position: {
+        side: string;
+        quantity: number;
+        avgPrice: number;
+        currentValue: number;
+        pnl: number;
+        totalCost: number;
+    } | null;
+}
+export interface ThesisSummary {
+    id: string;
+    status: string;
+    confidence: number | null;
+    updatedAt: string;
+    title: string;
+    rawThesis?: string;
+    slug?: string;
+    edgeCount?: number;
+}
+export interface CausalNode {
+    id: string;
+    label: string;
+    probability: number;
+    depth?: number;
+    children?: CausalNode[];
+}
+export interface EvaluationSummary {
+    evaluatedAt: string;
+    summary: string;
+    confidence: number;
+    confidenceDelta: number;
+    model?: string;
+    thesisTitle?: string;
+    thesisSlug?: string;
+}
+/** sf scan "keywords" --json */
+export type ScanOutput = MarketItem[];
+/** sf query "question" --json */
+export interface QueryOutput {
+    query: string;
+    answer: string;
+    keyFactors?: string[];
+    kalshi?: Array<{
+        title: string;
+        ticker: string;
+        price: number;
+        volume: number;
+    }>;
+    polymarket?: Array<{
+        title: string;
+        slug: string;
+        price: number;
+        volume: number;
+    }>;
+    x?: Array<{
+        author: string;
+        text: string;
+        url: string;
+        likes: number;
+        retweets?: number;
+    }>;
+    traditional?: TraditionalMarket[];
+    theses?: Array<{
+        title: string;
+        slug: string;
+        confidence: number;
+        edges: number;
+    }>;
+    content?: Array<{
+        type: string;
+        title: string;
+        url: string;
+        snippet?: string;
+    }>;
+    meta?: {
+        sources?: string[];
+        latencyMs?: number;
+    };
+}
+/** sf context --json (no thesis ID — global context) */
+export interface GlobalContextOutput {
+    scannedAt?: string;
+    meta?: {
+        totalMarkets: number;
+        kalshiMarkets: number;
+        polymarketMarkets: number;
+    };
+    traditional?: TraditionalMarket[];
+    highlights?: Array<{
+        title: string;
+        detail: string;
+        relatedTickers?: string[];
+        suggestedAction?: string;
+    }>;
+    categories?: Array<{
+        name: string;
+        description: string;
+        marketCount: number;
+        totalVolume24h: number;
+        topMovers?: Array<{
+            venue: string;
+            price: number;
+            change24h: number;
+            title: string;
+            ticker: string;
+            whyInteresting?: string;
+        }>;
+        mostLiquid?: Array<{
+            venue: string;
+            price: number;
+            spread: number;
+            volume24h: number;
+            title: string;
+        }>;
+    }>;
+    edges?: Array<{
+        price: number;
+        edge: number;
+        title: string;
+        thesisSlug: string;
+        venue: string;
+    }>;
+    signals?: EvaluationSummary[];
+}
+/** sf context <id> --json (thesis-specific context) */
+export interface ThesisContextOutput {
+    thesis: string;
+    rawThesis?: string;
+    confidence: number | null;
+    status: string;
+    updatedAt?: string;
+    causalTree?: {
+        nodes: CausalNode[];
+    };
+    edges?: Array<{
+        marketId: string;
+        market: string;
+        marketTitle?: string;
+        marketPrice: number;
+        thesisPrice: number;
+        edge: number;
+        edgeSize?: number;
+        direction: string;
+        venue: string;
+        orderbook?: {
+            spread: number;
+            liquidityScore: string;
+        };
+    }>;
+    lastEvaluation?: {
+        evaluatedAt: string;
+        summary: string;
+        model: string;
+        positionRecommendations?: Array<{
+            positionId: string;
+            recommendation: string;
+            reason: string;
+        }>;
+    };
+    edgeMeta?: {
+        lastRescanAt: string;
+    };
+}
+/** sf edges --json */
+export interface EdgesOutput {
+    totalEdges: number;
+    displayed: number;
+    thesesScanned: number;
+    edges: EdgeItem[];
+}
+/** sf list --json */
+export type ListOutput = ThesisSummary[];
+/** sf markets --json */
+export interface MarketsOutput {
+    snapshotAt: string;
+    markets: TraditionalMarket[];
+}
+/** sf positions --json */
+export interface PositionsOutput {
+    kalshiConfigured: boolean;
+    polymarketConfigured: boolean;
+    positions: Array<{
+        ticker: string;
+        side: string;
+        quantity: number;
+        average_price_paid: number;
+        current_value?: number;
+        unrealized_pnl?: number;
+        total_cost?: number;
+    }>;
+    polymarketPositions: Array<{
+        title?: string;
+        slug?: string;
+        outcome?: string;
+        size?: number;
+        avgPrice?: number;
+        curPrice?: number;
+        cashPnl?: number;
+    }>;
+    edges: Array<EdgeItem & {
+        thesisId: string;
+    }>;
+}
+/** sf explore --json (list mode, no slug) */
+export interface ExploreListOutput {
+    theses: Array<{
+        slug: string;
+        confidence: number | null;
+        impliedReturn?: number;
+        status: string;
+        title: string;
+    }>;
+}
+/** sf explore <slug> --json (detail mode) */
+export interface ExploreDetailOutput {
+    thesis: {
+        title: string;
+        slug: string;
+        confidence: number | null;
+        status: string;
+        publishedAt?: string;
+        description?: string;
+    };
+    causalTree?: {
+        nodes: CausalNode[];
+    };
+    impliedReturns?: {
+        avgReturnPct: number;
+        winRate: number;
+        winners: number;
+        losers: number;
+        trackedSince?: string;
+        edges: Array<{
+            market: string;
+            entryPrice: number;
+            currentPrice: number;
+            returnPct: number;
+        }>;
+    };
+    confidenceHistory?: EvaluationSummary[];
+    edges?: Array<{
+        market: string;
+        marketPrice: number;
+        thesisPrice: number;
+        edge: number;
+        orderbook?: {
+            liquidityScore: string;
+        };
+    }>;
+}
+/** sf balance --json */
+export interface BalanceOutput {
+    available: number;
+    total: number;
+    currency: string;
+}
+/** sf orders --json */
+export type OrdersOutput = Array<{
+    orderId: string;
+    ticker: string;
+    side: string;
+    type: string;
+    price: number;
+    quantity: number;
+    remainingQuantity: number;
+    status: string;
+    createdAt: string;
+}>;
+/** sf fills --json */
+export type FillsOutput = Array<{
+    tradeId: string;
+    ticker: string;
+    side: string;
+    price: number;
+    count: number;
+    createdAt: string;
+}>;
+/** sf performance --json */
+export interface PerformanceOutput {
+    totalPnl: number;
+    realizedPnl: number;
+    unrealizedPnl: number;
+    winRate: number;
+    trades: number;
+    positions: Array<{
+        ticker: string;
+        side: string;
+        entryPrice: number;
+        currentPrice: number;
+        pnl: number;
+        returnPct: number;
+    }>;
+}
+/** sf feed --json */
+export type FeedOutput = EvaluationSummary[];
+/** sf milestones --json */
+export type MilestonesOutput = Array<{
+    date: string;
+    ticker: string;
+    title: string;
+    category?: string;
+}>;
+/** sf history <ticker> --json */
+export type HistoryOutput = Array<{
+    ts: string;
+    price: number;
+    volume?: number;
+}>;
+/** sf forecast <event> --json */
+export interface ForecastOutput {
+    event: string;
+    markets: Array<{
+        ticker: string;
+        title: string;
+        price: number;
+        impliedProb: number;
+    }>;
+    distribution?: {
+        p10: number;
+        p25: number;
+        p50: number;
+        p75: number;
+        p90: number;
+    };
+}
+/** sf liquidity --json */
+export interface LiquidityOutput {
+    markets: Array<{
+        ticker: string;
+        title: string;
+        venue: Venue;
+        spread: number;
+        bidDepth: number;
+        askDepth: number;
+        score: string;
+    }>;
+}
+/** sf book <ticker> --json */
+export interface BookOutput {
+    ticker: string;
+    bids: Array<{
+        price: number;
+        quantity: number;
+    }>;
+    asks: Array<{
+        price: number;
+        quantity: number;
+    }>;
+    spread: number;
+    midPrice: number;
+}
+/** Wrapper used by --share to store snapshots */
+export interface ShareSnapshot {
+    command: string;
+    args: string[];
+    timestamp: string;
+    data: unknown;
+    version: string;
+}
+/** Change event emitted by sf watch */
+export interface WatchChangeEvent {
+    type: 'edge_change' | 'new_contract' | 'removed_contract' | 'price_move';
+    timestamp: string;
+    market: string;
+    venue: Venue;
+    before?: {
+        price: number;
+        edge?: number;
+    };
+    after: {
+        price: number;
+        edge?: number;
+    };
+    delta: number;
+}

package/dist/types/output.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Stable JSON output schemas for all SF CLI commands.
+ *
+ * IMPORTANT: These types define the contract that --share and sf watch depend on.
+ * Breaking changes here cascade to the share renderer and watch differ.
+ * Add fields freely; removing or renaming fields is a breaking change.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils.d.ts

@@ -34,6 +34,16 @@ export declare function rpad(s: string, width: number): string;
 export declare function hr(width?: number): void;
 /** Print an error and exit */
 export declare function die(msg: string): never;
+/**
+ * Print an error with an actionable suggestion.
+ * Use instead of bare console.error for user-facing errors.
+ */
+export declare function errorWithHint(message: string, hint?: string): void;
+/**
+ * Print an empty state message with a next-action CTA.
+ * Use when a command returns zero results.
+ */
+export declare function emptyState(thing: string, nextAction?: string): void;
 /** Print a section header */
 export declare function header(title: string): void;
 /** Truncate a string with ellipsis */

package/dist/utils.js

@@ -15,6 +15,8 @@ exports.pad = pad;
 exports.rpad = rpad;
 exports.hr = hr;
 exports.die = die;
+exports.errorWithHint = errorWithHint;
+exports.emptyState = emptyState;
 exports.header = header;
 exports.trunc = trunc;
 exports.shortId = shortId;
@@ -108,6 +110,26 @@ function die(msg) {
     console.error(`${exports.c.red}Error:${exports.c.reset} ${msg}`);
     process.exit(1);
 }
+/**
+ * Print an error with an actionable suggestion.
+ * Use instead of bare console.error for user-facing errors.
+ */
+function errorWithHint(message, hint) {
+    console.error(`\n  ${exports.c.red}Error:${exports.c.reset} ${message}`);
+    if (hint)
+        console.error(`  ${exports.c.dim}${hint}${exports.c.reset}`);
+    console.error();
+}
+/**
+ * Print an empty state message with a next-action CTA.
+ * Use when a command returns zero results.
+ */
+function emptyState(thing, nextAction) {
+    console.log(`\n  ${exports.c.dim}No ${thing} found.${exports.c.reset}`);
+    if (nextAction)
+        console.log(`  ${exports.c.dim}${nextAction}${exports.c.reset}`);
+    console.log();
+}
 /** Print a section header */
 function header(title) {
     console.log(`\n${exports.c.bold}${exports.c.cyan}${title}${exports.c.reset}`);

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@spfunctions/cli",
-  "version": "1.7.16",
+  "version": "1.7.19",
+  "mcpName": "io.github.spfunctions/simplefunctions",
   "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"