pythx-cli 0.0.2 → 0.0.3

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> pythx@0.0.1 build /Users/zachj/Projects/pythx/packages/pythx
+> tsc
+

package/bin/pythx.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import("../dist/cli.js");

package/dist/app.d.ts

@@ -0,0 +1,5 @@
+interface AppProps {
+    apiUrl?: string;
+}
+export declare function App({ apiUrl }: AppProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/app.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { Box, Text, useApp, useInput } from "ink";
+import chalk from "chalk";
+import { Header } from "./components/header.js";
+import { EntityRow, COL } from "./components/entity-row.js";
+import { DetailPanel } from "./components/detail-panel.js";
+import { StatusBar } from "./components/status-bar.js";
+import { useLiveData } from "./hooks/use-live-data.js";
+export function App({ apiUrl }) {
+    const { data, loading, error, lastUpdated, refresh } = useLiveData(apiUrl);
+    const [activeIndex, setActiveIndex] = useState(0);
+    const [showDetail, setShowDetail] = useState(true);
+    const { exit } = useApp();
+    useInput((input, key) => {
+        if (input === "q") {
+            exit();
+        }
+        if (input === "r") {
+            refresh();
+        }
+        if (key.upArrow) {
+            setActiveIndex((i) => Math.max(0, i - 1));
+        }
+        if (key.downArrow) {
+            setActiveIndex((i) => Math.min(data.length - 1, i + 1));
+        }
+        if (key.return) {
+            setShowDetail((s) => !s);
+        }
+    });
+    const activeAnalysis = data[activeIndex];
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Header, { lastUpdated: lastUpdated, loading: loading }), error && (_jsx(Box, { paddingX: 1, children: _jsx(Text, { children: chalk.red(`Error: ${error}`) }) })), loading && data.length === 0 ? (_jsx(Box, { paddingX: 1, paddingY: 1, children: _jsx(Text, { children: chalk.yellow("⟳ Fetching sentiment data...") }) })) : (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(Box, { marginY: 1, children: _jsx(Text, { children: chalk.dim("  " +
+                                "ENTITY".padEnd(COL.name) +
+                                "SCORE".padStart(COL.score) +
+                                "  " +
+                                "TREND".padEnd(COL.trend) +
+                                "POS".padStart(COL.stat) +
+                                "NEU".padStart(COL.stat) +
+                                "NEG".padStart(COL.stat) +
+                                "TOT".padStart(COL.stat)) }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { children: chalk.dim("  " + "─".repeat(COL.name + COL.score + 2 + COL.trend + COL.stat * 4)) }) }), data.map((analysis, i) => (_jsx(EntityRow, { analysis: analysis, isActive: i === activeIndex }, analysis.entity.id)))] })), showDetail && activeAnalysis && (_jsx(DetailPanel, { analysis: activeAnalysis })), _jsx(StatusBar, {})] }));
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from "ink";
+import meow from "meow";
+import { App } from "./app.js";
+const cli = meow(`
+  Usage
+    $ pythx
+
+  Options
+    --api-url  URL of the Pythx web API (default: direct mode, no server needed)
+
+  Examples
+    $ pythx
+    $ pythx --api-url http://localhost:3000
+    $ pythx --api-url https://pythx.vercel.app
+`, {
+    importMeta: import.meta,
+    flags: {
+        apiUrl: {
+            type: "string",
+        },
+    },
+});
+// Use alternate screen buffer so re-renders don't scroll the terminal
+process.stdout.write("\x1b[?1049h"); // enter alternate screen
+process.stdout.write("\x1b[H"); // move cursor to top
+const instance = render(_jsx(App, { apiUrl: cli.flags.apiUrl }), { patchConsole: false });
+instance.waitUntilExit().then(() => {
+    process.stdout.write("\x1b[?1049l"); // restore main screen on exit
+});

package/dist/components/detail-panel.d.ts

@@ -0,0 +1,6 @@
+import type { EntityAnalysis } from "@pythx/core";
+interface DetailPanelProps {
+    analysis: EntityAnalysis;
+}
+export declare function DetailPanel({ analysis }: DetailPanelProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/detail-panel.js

@@ -0,0 +1,35 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import chalk from "chalk";
+function formatPost(post) {
+    const { sentiment } = post;
+    const labelMap = {
+        positive: chalk.green,
+        negative: chalk.red,
+        neutral: chalk.gray,
+    };
+    const colorFn = labelMap[sentiment.label];
+    const tag = colorFn(`[${sentiment.label.substring(0, 3).toUpperCase()} ${(sentiment.score * 100).toFixed(0)}%]`);
+    const author = post.authorUsername
+        ? chalk.dim(`@${post.authorUsername}`)
+        : chalk.dim("@unknown");
+    const text = post.text
+        .replace(/\n/g, " ")
+        .substring(0, 70)
+        .trim();
+    const ellipsis = post.text.length > 70 ? chalk.dim("...") : "";
+    return `  ${tag} ${author}: "${text}${ellipsis}"`;
+}
+export function DetailPanel({ analysis }) {
+    const { entity, snapshot } = analysis;
+    const scoreColor = snapshot.averageScore > 0.05
+        ? chalk.green
+        : snapshot.averageScore < -0.05
+            ? chalk.red
+            : chalk.gray;
+    const allPosts = [
+        ...snapshot.topPositive,
+        ...snapshot.topNegative,
+    ].sort((a, b) => b.sentiment.score - a.sentiment.score);
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, children: [_jsxs(Box, { justifyContent: "space-between", children: [_jsxs(Text, { children: [chalk.green("▶"), " ", chalk.bold(entity.name.toUpperCase()), chalk.dim(" — Detail")] }), _jsxs(Text, { children: [chalk.dim("avg: "), scoreColor(`${snapshot.averageScore >= 0 ? "+" : ""}${snapshot.averageScore.toFixed(3)}`)] })] }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: allPosts.length === 0 ? (_jsx(Text, { children: chalk.dim("  No posts to display") })) : (allPosts.slice(0, 8).map((post) => (_jsx(Text, { children: formatPost(post) }, post.id)))) })] }));
+}

package/dist/components/entity-row.d.ts

@@ -0,0 +1,13 @@
+import type { EntityAnalysis } from "@pythx/core";
+export declare const COL: {
+    name: number;
+    score: number;
+    trend: number;
+    stat: number;
+};
+interface EntityRowProps {
+    analysis: EntityAnalysis;
+    isActive: boolean;
+}
+export declare function EntityRow({ analysis, isActive }: EntityRowProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/entity-row.js

@@ -0,0 +1,47 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import chalk from "chalk";
+// Column widths — shared with header in app.tsx
+// cursor(2) + name(15) + score(8) + gap(2) + trend(10) + gap(2) + pos(5) + neu(5) + neg(5) + tot(5)
+export const COL = {
+    name: 15,
+    score: 8,
+    trend: 10,
+    stat: 5,
+};
+function formatScore(score) {
+    const prefix = score >= 0 ? "+" : "";
+    return `${prefix}${score.toFixed(2)}`;
+}
+function sparkline(distribution) {
+    const { positive, neutral, negative, total } = distribution;
+    if (total === 0)
+        return chalk.dim("░".repeat(COL.trend));
+    const posWidth = Math.round((positive / total) * COL.trend);
+    const negWidth = Math.round((negative / total) * COL.trend);
+    const neuWidth = COL.trend - posWidth - negWidth;
+    return (chalk.green("█".repeat(posWidth)) +
+        chalk.gray("░".repeat(Math.max(0, neuWidth))) +
+        chalk.red("█".repeat(negWidth)));
+}
+export function EntityRow({ analysis, isActive }) {
+    const { entity, snapshot } = analysis;
+    const { distribution } = snapshot;
+    const cursor = isActive ? chalk.green("▶ ") : "  ";
+    const name = entity.name.length > COL.name
+        ? entity.name.substring(0, COL.name - 1) + "…"
+        : entity.name.padEnd(COL.name);
+    const score = formatScore(snapshot.averageScore).padStart(COL.score);
+    const trend = sparkline(distribution);
+    const pos = String(distribution.positive).padStart(COL.stat);
+    const neu = String(distribution.neutral).padStart(COL.stat);
+    const neg = String(distribution.negative).padStart(COL.stat);
+    const tot = String(distribution.total).padStart(COL.stat);
+    const colorName = isActive ? chalk.green.bold(name) : chalk.white(name);
+    const colorScore = snapshot.averageScore > 0.05
+        ? chalk.green(score)
+        : snapshot.averageScore < -0.05
+            ? chalk.red(score)
+            : chalk.gray(score);
+    return (_jsx(Box, { children: _jsxs(Text, { children: [cursor, colorName, colorScore, "  ", trend, chalk.green(pos), chalk.gray(neu), chalk.red(neg), chalk.dim(tot)] }) }));
+}

package/dist/components/header.d.ts

@@ -0,0 +1,6 @@
+interface HeaderProps {
+    lastUpdated: Date | null;
+    loading: boolean;
+}
+export declare function Header({ lastUpdated, loading }: HeaderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/header.js

@@ -0,0 +1,17 @@
+import { jsxs as _jsxs, Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useState, useEffect } from "react";
+import { Box, Text } from "ink";
+import chalk from "chalk";
+export function Header({ lastUpdated, loading }) {
+    const [secondsAgo, setSecondsAgo] = useState(0);
+    useEffect(() => {
+        if (!lastUpdated)
+            return;
+        setSecondsAgo(Math.round((Date.now() - lastUpdated.getTime()) / 1000));
+        const interval = setInterval(() => {
+            setSecondsAgo(Math.round((Date.now() - lastUpdated.getTime()) / 1000));
+        }, 1000);
+        return () => clearInterval(interval);
+    }, [lastUpdated]);
+    return (_jsxs(Box, { borderStyle: "single", borderColor: "green", paddingX: 1, justifyContent: "space-between", children: [_jsxs(Text, { children: [chalk.green.bold("PYTHX"), chalk.dim("  ░░  "), chalk.white("SENTIMENT TERMINAL")] }), _jsx(Text, { children: loading ? (chalk.yellow("⟳ Loading...")) : lastUpdated ? (_jsxs(_Fragment, { children: [chalk.green("● "), chalk.dim(`LIVE · ${secondsAgo}s ago`)] })) : (chalk.dim("Waiting...")) })] }));
+}

package/dist/components/status-bar.d.ts

@@ -0,0 +1 @@
+export declare function StatusBar(): import("react/jsx-runtime").JSX.Element;

package/dist/components/status-bar.js

@@ -0,0 +1,6 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import chalk from "chalk";
+export function StatusBar() {
+    return (_jsx(Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, justifyContent: "center", children: _jsxs(Text, { children: [chalk.dim("░ "), chalk.white("q"), chalk.dim(":quit  "), chalk.white("↑↓"), chalk.dim(":navigate  "), chalk.white("enter"), chalk.dim(":expand  "), chalk.white("r"), chalk.dim(":refresh")] }) }));
+}

package/dist/hooks/use-live-data.d.ts

@@ -0,0 +1,8 @@
+import type { EntityAnalysis } from "@pythx/core";
+export declare function useLiveData(apiUrl?: string): {
+    data: EntityAnalysis[];
+    loading: boolean;
+    error: string | null;
+    lastUpdated: Date | null;
+    refresh: () => Promise<void>;
+};

package/dist/hooks/use-live-data.js

@@ -0,0 +1,75 @@
+import { useState, useEffect, useCallback } from "react";
+import { DEFAULT_ENTITIES, getProvider, classifyPosts, aggregate, } from "@pythx/core";
+const POLL_INTERVAL = 60_000;
+export function useLiveData(apiUrl) {
+    const [data, setData] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [lastUpdated, setLastUpdated] = useState(null);
+    const fetchViaApi = useCallback(async () => {
+        if (!apiUrl)
+            return;
+        try {
+            const res = await fetch(`${apiUrl}/api/compare`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    entityIds: DEFAULT_ENTITIES.map((e) => e.id),
+                    count: 50,
+                }),
+            });
+            const json = (await res.json());
+            if (json.success && json.data) {
+                setData(json.data);
+                setLastUpdated(new Date());
+                setError(null);
+            }
+            else {
+                setError(json.error ?? "API error");
+            }
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : "Fetch failed");
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [apiUrl]);
+    const fetchDirect = useCallback(async () => {
+        try {
+            const results = [];
+            for (const entity of DEFAULT_ENTITIES) {
+                const allClassified = [];
+                for (const sq of entity.queries) {
+                    const provider = getProvider(sq.source);
+                    const posts = await provider.fetchPosts(sq.query, { count: 50 });
+                    const classified = await classifyPosts(posts, provider.getModelId());
+                    allClassified.push(...classified);
+                }
+                const snapshot = aggregate(allClassified);
+                results.push({
+                    entity,
+                    snapshot,
+                    posts: allClassified,
+                    fetchedAt: new Date().toISOString(),
+                });
+            }
+            setData(results);
+            setLastUpdated(new Date());
+            setError(null);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : "Analysis failed");
+        }
+        finally {
+            setLoading(false);
+        }
+    }, []);
+    const fetchData = apiUrl ? fetchViaApi : fetchDirect;
+    useEffect(() => {
+        fetchData();
+        const interval = setInterval(fetchData, POLL_INTERVAL);
+        return () => clearInterval(interval);
+    }, [fetchData]);
+    return { data, loading, error, lastUpdated, refresh: fetchData };
+}

package/package.json

@@ -1,7 +1,30 @@
 {
   "name": "pythx-cli",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Real-time sentiment intelligence terminal for prediction markets",
+  "type": "module",
+  "bin": {
+    "pythx": "./bin/pythx.js"
+  },
+  "scripts": {
+    "dev": "tsx src/cli.tsx",
+    "build": "tsc",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@pythx/core": "workspace:*",
+    "ink": "^5.2.0",
+    "react": "^18.3.1",
+    "chalk": "^5.4.0",
+    "meow": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.0",
+    "typescript": "^5.8.0",
+    "tsx": "^4.19.0",
+    "ink-testing-library": "^4.0.0"
+  },
   "keywords": [
     "sentiment",
     "terminal",
@@ -11,5 +34,8 @@
     "x-api"
   ],
   "author": "ZachJxyz",
-  "license": "UNLICENSED"
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zachjxyz/pythx"
+  }
 }

package/src/app.tsx

@@ -0,0 +1,95 @@
+import React, { useState } from "react";
+import { Box, Text, useApp, useInput } from "ink";
+import chalk from "chalk";
+import { Header } from "./components/header.js";
+import { EntityRow, COL } from "./components/entity-row.js";
+import { DetailPanel } from "./components/detail-panel.js";
+import { StatusBar } from "./components/status-bar.js";
+import { useLiveData } from "./hooks/use-live-data.js";
+
+interface AppProps {
+  apiUrl?: string;
+}
+
+export function App({ apiUrl }: AppProps) {
+  const { data, loading, error, lastUpdated, refresh } = useLiveData(apiUrl);
+  const [activeIndex, setActiveIndex] = useState(0);
+  const [showDetail, setShowDetail] = useState(true);
+  const { exit } = useApp();
+
+  useInput((input, key) => {
+    if (input === "q") {
+      exit();
+    }
+    if (input === "r") {
+      refresh();
+    }
+    if (key.upArrow) {
+      setActiveIndex((i) => Math.max(0, i - 1));
+    }
+    if (key.downArrow) {
+      setActiveIndex((i) => Math.min(data.length - 1, i + 1));
+    }
+    if (key.return) {
+      setShowDetail((s) => !s);
+    }
+  });
+
+  const activeAnalysis = data[activeIndex];
+
+  return (
+    <Box flexDirection="column">
+      <Header lastUpdated={lastUpdated} loading={loading} />
+
+      {error && (
+        <Box paddingX={1}>
+          <Text>{chalk.red(`Error: ${error}`)}</Text>
+        </Box>
+      )}
+
+      {loading && data.length === 0 ? (
+        <Box paddingX={1} paddingY={1}>
+          <Text>{chalk.yellow("⟳ Fetching sentiment data...")}</Text>
+        </Box>
+      ) : (
+        <Box flexDirection="column" paddingX={1}>
+          <Box marginY={1}>
+            <Text>
+              {chalk.dim(
+                "  " +
+                "ENTITY".padEnd(COL.name) +
+                "SCORE".padStart(COL.score) +
+                "  " +
+                "TREND".padEnd(COL.trend) +
+                "POS".padStart(COL.stat) +
+                "NEU".padStart(COL.stat) +
+                "NEG".padStart(COL.stat) +
+                "TOT".padStart(COL.stat)
+              )}
+            </Text>
+          </Box>
+
+          <Box marginBottom={1}>
+            <Text>
+              {chalk.dim("  " + "─".repeat(COL.name + COL.score + 2 + COL.trend + COL.stat * 4))}
+            </Text>
+          </Box>
+
+          {data.map((analysis, i) => (
+            <EntityRow
+              key={analysis.entity.id}
+              analysis={analysis}
+              isActive={i === activeIndex}
+            />
+          ))}
+        </Box>
+      )}
+
+      {showDetail && activeAnalysis && (
+        <DetailPanel analysis={activeAnalysis} />
+      )}
+
+      <StatusBar />
+    </Box>
+  );
+}

package/src/cli.tsx

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import React from "react";
+import { render } from "ink";
+import meow from "meow";
+import { App } from "./app.js";
+
+const cli = meow(
+  `
+  Usage
+    $ pythx
+
+  Options
+    --api-url  URL of the Pythx web API (default: direct mode, no server needed)
+
+  Examples
+    $ pythx
+    $ pythx --api-url http://localhost:3000
+    $ pythx --api-url https://pythx.vercel.app
+`,
+  {
+    importMeta: import.meta,
+    flags: {
+      apiUrl: {
+        type: "string",
+      },
+    },
+  }
+);
+
+// Use alternate screen buffer so re-renders don't scroll the terminal
+process.stdout.write("\x1b[?1049h"); // enter alternate screen
+process.stdout.write("\x1b[H");      // move cursor to top
+
+const instance = render(<App apiUrl={cli.flags.apiUrl} />, { patchConsole: false });
+
+instance.waitUntilExit().then(() => {
+  process.stdout.write("\x1b[?1049l"); // restore main screen on exit
+});

package/src/components/detail-panel.tsx

@@ -0,0 +1,81 @@
+import React from "react";
+import { Box, Text } from "ink";
+import chalk from "chalk";
+import type { EntityAnalysis, PostWithSentiment } from "@pythx/core";
+
+interface DetailPanelProps {
+  analysis: EntityAnalysis;
+}
+
+function formatPost(post: PostWithSentiment): string {
+  const { sentiment } = post;
+  const labelMap = {
+    positive: chalk.green,
+    negative: chalk.red,
+    neutral: chalk.gray,
+  };
+  const colorFn = labelMap[sentiment.label];
+  const tag = colorFn(
+    `[${sentiment.label.substring(0, 3).toUpperCase()} ${(sentiment.score * 100).toFixed(0)}%]`
+  );
+
+  const author = post.authorUsername
+    ? chalk.dim(`@${post.authorUsername}`)
+    : chalk.dim("@unknown");
+
+  const text = post.text
+    .replace(/\n/g, " ")
+    .substring(0, 70)
+    .trim();
+
+  const ellipsis = post.text.length > 70 ? chalk.dim("...") : "";
+
+  return `  ${tag} ${author}: "${text}${ellipsis}"`;
+}
+
+export function DetailPanel({ analysis }: DetailPanelProps) {
+  const { entity, snapshot } = analysis;
+  const scoreColor =
+    snapshot.averageScore > 0.05
+      ? chalk.green
+      : snapshot.averageScore < -0.05
+        ? chalk.red
+        : chalk.gray;
+
+  const allPosts = [
+    ...snapshot.topPositive,
+    ...snapshot.topNegative,
+  ].sort((a, b) => b.sentiment.score - a.sentiment.score);
+
+  return (
+    <Box
+      flexDirection="column"
+      borderStyle="single"
+      borderColor="gray"
+      paddingX={1}
+    >
+      <Box justifyContent="space-between">
+        <Text>
+          {chalk.green("▶")} {chalk.bold(entity.name.toUpperCase())}
+          {chalk.dim(" — Detail")}
+        </Text>
+        <Text>
+          {chalk.dim("avg: ")}
+          {scoreColor(
+            `${snapshot.averageScore >= 0 ? "+" : ""}${snapshot.averageScore.toFixed(3)}`
+          )}
+        </Text>
+      </Box>
+
+      <Box marginTop={1} flexDirection="column">
+        {allPosts.length === 0 ? (
+          <Text>{chalk.dim("  No posts to display")}</Text>
+        ) : (
+          allPosts.slice(0, 8).map((post) => (
+            <Text key={post.id}>{formatPost(post)}</Text>
+          ))
+        )}
+      </Box>
+    </Box>
+  );
+}

package/src/components/entity-row.tsx

@@ -0,0 +1,83 @@
+import React from "react";
+import { Box, Text } from "ink";
+import chalk from "chalk";
+import type { EntityAnalysis } from "@pythx/core";
+
+// Column widths — shared with header in app.tsx
+// cursor(2) + name(15) + score(8) + gap(2) + trend(10) + gap(2) + pos(5) + neu(5) + neg(5) + tot(5)
+export const COL = {
+  name: 15,
+  score: 8,
+  trend: 10,
+  stat: 5,
+};
+
+interface EntityRowProps {
+  analysis: EntityAnalysis;
+  isActive: boolean;
+}
+
+function formatScore(score: number): string {
+  const prefix = score >= 0 ? "+" : "";
+  return `${prefix}${score.toFixed(2)}`;
+}
+
+function sparkline(distribution: {
+  positive: number;
+  neutral: number;
+  negative: number;
+  total: number;
+}): string {
+  const { positive, neutral, negative, total } = distribution;
+  if (total === 0) return chalk.dim("░".repeat(COL.trend));
+
+  const posWidth = Math.round((positive / total) * COL.trend);
+  const negWidth = Math.round((negative / total) * COL.trend);
+  const neuWidth = COL.trend - posWidth - negWidth;
+
+  return (
+    chalk.green("█".repeat(posWidth)) +
+    chalk.gray("░".repeat(Math.max(0, neuWidth))) +
+    chalk.red("█".repeat(negWidth))
+  );
+}
+
+export function EntityRow({ analysis, isActive }: EntityRowProps) {
+  const { entity, snapshot } = analysis;
+  const { distribution } = snapshot;
+
+  const cursor = isActive ? chalk.green("▶ ") : "  ";
+  const name = entity.name.length > COL.name
+    ? entity.name.substring(0, COL.name - 1) + "…"
+    : entity.name.padEnd(COL.name);
+  const score = formatScore(snapshot.averageScore).padStart(COL.score);
+  const trend = sparkline(distribution);
+  const pos = String(distribution.positive).padStart(COL.stat);
+  const neu = String(distribution.neutral).padStart(COL.stat);
+  const neg = String(distribution.negative).padStart(COL.stat);
+  const tot = String(distribution.total).padStart(COL.stat);
+
+  const colorName = isActive ? chalk.green.bold(name) : chalk.white(name);
+  const colorScore =
+    snapshot.averageScore > 0.05
+      ? chalk.green(score)
+      : snapshot.averageScore < -0.05
+        ? chalk.red(score)
+        : chalk.gray(score);
+
+  return (
+    <Box>
+      <Text>
+        {cursor}
+        {colorName}
+        {colorScore}
+        {"  "}
+        {trend}
+        {chalk.green(pos)}
+        {chalk.gray(neu)}
+        {chalk.red(neg)}
+        {chalk.dim(tot)}
+      </Text>
+    </Box>
+  );
+}

package/src/components/header.tsx

@@ -0,0 +1,48 @@
+import React, { useState, useEffect } from "react";
+import { Box, Text } from "ink";
+import chalk from "chalk";
+
+interface HeaderProps {
+  lastUpdated: Date | null;
+  loading: boolean;
+}
+
+export function Header({ lastUpdated, loading }: HeaderProps) {
+  const [secondsAgo, setSecondsAgo] = useState(0);
+
+  useEffect(() => {
+    if (!lastUpdated) return;
+    setSecondsAgo(Math.round((Date.now() - lastUpdated.getTime()) / 1000));
+    const interval = setInterval(() => {
+      setSecondsAgo(Math.round((Date.now() - lastUpdated.getTime()) / 1000));
+    }, 1000);
+    return () => clearInterval(interval);
+  }, [lastUpdated]);
+
+  return (
+    <Box
+      borderStyle="single"
+      borderColor="green"
+      paddingX={1}
+      justifyContent="space-between"
+    >
+      <Text>
+        {chalk.green.bold("PYTHX")}
+        {chalk.dim("  ░░  ")}
+        {chalk.white("SENTIMENT TERMINAL")}
+      </Text>
+      <Text>
+        {loading ? (
+          chalk.yellow("⟳ Loading...")
+        ) : lastUpdated ? (
+          <>
+            {chalk.green("● ")}
+            {chalk.dim(`LIVE · ${secondsAgo}s ago`)}
+          </>
+        ) : (
+          chalk.dim("Waiting...")
+        )}
+      </Text>
+    </Box>
+  );
+}

package/src/components/status-bar.tsx

@@ -0,0 +1,26 @@
+import React from "react";
+import { Box, Text } from "ink";
+import chalk from "chalk";
+
+export function StatusBar() {
+  return (
+    <Box
+      borderStyle="single"
+      borderColor="gray"
+      paddingX={1}
+      justifyContent="center"
+    >
+      <Text>
+        {chalk.dim("░ ")}
+        {chalk.white("q")}
+        {chalk.dim(":quit  ")}
+        {chalk.white("↑↓")}
+        {chalk.dim(":navigate  ")}
+        {chalk.white("enter")}
+        {chalk.dim(":expand  ")}
+        {chalk.white("r")}
+        {chalk.dim(":refresh")}
+      </Text>
+    </Box>
+  );
+}

package/src/hooks/use-live-data.ts

@@ -0,0 +1,86 @@
+import { useState, useEffect, useCallback } from "react";
+import {
+  DEFAULT_ENTITIES,
+  getProvider,
+  classifyPosts,
+  aggregate,
+} from "@pythx/core";
+import type { EntityAnalysis } from "@pythx/core";
+
+const POLL_INTERVAL = 60_000;
+
+export function useLiveData(apiUrl?: string) {
+  const [data, setData] = useState<EntityAnalysis[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  const [lastUpdated, setLastUpdated] = useState<Date | null>(null);
+
+  const fetchViaApi = useCallback(async () => {
+    if (!apiUrl) return;
+    try {
+      const res = await fetch(`${apiUrl}/api/compare`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          entityIds: DEFAULT_ENTITIES.map((e) => e.id),
+          count: 50,
+        }),
+      });
+      const json = (await res.json()) as { success: boolean; data?: EntityAnalysis[]; error?: string };
+      if (json.success && json.data) {
+        setData(json.data);
+        setLastUpdated(new Date());
+        setError(null);
+      } else {
+        setError(json.error ?? "API error");
+      }
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Fetch failed");
+    } finally {
+      setLoading(false);
+    }
+  }, [apiUrl]);
+
+  const fetchDirect = useCallback(async () => {
+    try {
+      const results: EntityAnalysis[] = [];
+
+      for (const entity of DEFAULT_ENTITIES) {
+        const allClassified = [];
+
+        for (const sq of entity.queries) {
+          const provider = getProvider(sq.source);
+          const posts = await provider.fetchPosts(sq.query, { count: 50 });
+          const classified = await classifyPosts(posts, provider.getModelId());
+          allClassified.push(...classified);
+        }
+
+        const snapshot = aggregate(allClassified);
+        results.push({
+          entity,
+          snapshot,
+          posts: allClassified,
+          fetchedAt: new Date().toISOString(),
+        });
+      }
+
+      setData(results);
+      setLastUpdated(new Date());
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Analysis failed");
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  const fetchData = apiUrl ? fetchViaApi : fetchDirect;
+
+  useEffect(() => {
+    fetchData();
+    const interval = setInterval(fetchData, POLL_INTERVAL);
+    return () => clearInterval(interval);
+  }, [fetchData]);
+
+  return { data, loading, error, lastUpdated, refresh: fetchData };
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "lib": ["ES2022"],
+    "types": ["node"],
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}

package/README.md

@@ -1,5 +0,0 @@
-# pythx
-
-Real-time sentiment intelligence terminal.
-
-Coming soon.