@metisos/cascade-cli 0.1.0 → 0.2.0

package/dist/bin/cascade.js

@@ -12,11 +12,24 @@ const portfolio_js_1 = require("../commands/portfolio.js");
 const graph_js_1 = require("../commands/graph.js");
 const skills_js_1 = require("../commands/skills.js");
 const config_js_2 = require("../commands/config.js");
+const welcome_js_1 = require("../tui/welcome.js");
+const BANNER = `
+\x1b[33m   ██████╗ █████╗ ███████╗ ██████╗ █████╗ ██████╗ ███████╗\x1b[0m
+\x1b[33m  ██╔════╝██╔══██╗██╔════╝██╔════╝██╔══██╗██╔══██╗██╔════╝\x1b[0m
+\x1b[33m  ██║     ███████║███████╗██║     ███████║██║  ██║█████╗  \x1b[0m
+\x1b[33m  ██║     ██╔══██║╚════██║██║     ██╔══██║██║  ██║██╔══╝  \x1b[0m
+\x1b[33m  ╚██████╗██║  ██║███████║╚██████╗██║  ██║██████╔╝███████╗\x1b[0m
+\x1b[33m   ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝╚═════╝ ╚══════╝\x1b[0m
+
+\x1b[2m  Real-Time Event Propagation Intelligence\x1b[0m
+\x1b[2m  See the cascade before it hits.\x1b[0m
+`;
 const program = new commander_1.Command();
 program
     .name("cascade")
     .description("Cascade CLI — Real-time geopolitical and economic intelligence")
-    .version("0.1.0");
+    .version("0.2.0")
+    .addHelpText("beforeAll", BANNER);
 // Global format option
 function addFormat(cmd) {
     return cmd.option("-f, --format <format>", "Output format: table, json, csv", (0, config_js_1.loadConfig)().output || "table");
@@ -81,5 +94,14 @@ function handleError(err) {
     console.error(`Error: ${err.message}`);
     process.exit(1);
 }
-// Parse
-program.parse();
+// No args → launch interactive welcome menu
+if (process.argv.length <= 2) {
+    (0, welcome_js_1.startWelcome)().catch((err) => {
+        console.error(err.message);
+        process.exit(1);
+    });
+}
+else {
+    // Subcommand provided → run command mode
+    program.parse();
+}

package/dist/tui/welcome.d.ts

@@ -0,0 +1 @@
+export declare function startWelcome(): Promise<void>;

package/dist/tui/welcome.js

@@ -0,0 +1,336 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startWelcome = startWelcome;
+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 BANNER = `
+\x1b[33m   ██████╗ █████╗ ███████╗ ██████╗ █████╗ ██████╗ ███████╗\x1b[0m
+\x1b[33m  ██╔════╝██╔══██╗██╔════╝██╔════╝██╔══██╗██╔══██╗██╔════╝\x1b[0m
+\x1b[33m  ██║     ███████║███████╗██║     ███████║██║  ██║█████╗  \x1b[0m
+\x1b[33m  ██║     ██╔══██║╚════██║██║     ██╔══██║██║  ██║██╔══╝  \x1b[0m
+\x1b[33m  ╚██████╗██║  ██║███████║╚██████╗██║  ██║██████╔╝███████╗\x1b[0m
+\x1b[33m   ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝╚═════╝ ╚══════╝\x1b[0m
+\x1b[2m  Real-Time Event Propagation Intelligence\x1b[0m
+`;
+function dim(s) { return `\x1b[2m${s}\x1b[0m`; }
+function bold(s) { return `\x1b[1m${s}\x1b[0m`; }
+function gold(s) { return `\x1b[33m${s}\x1b[0m`; }
+function green(s) { return `\x1b[32m${s}\x1b[0m`; }
+function red(s) { return `\x1b[31m${s}\x1b[0m`; }
+function cyan(s) { return `\x1b[36m${s}\x1b[0m`; }
+function clearScreen() {
+    process.stdout.write("\x1b[2J\x1b[H");
+}
+function hideCursor() { process.stdout.write("\x1b[?25l"); }
+function showCursor() { process.stdout.write("\x1b[?25h"); }
+function prompt(question) {
+    const rl = readline_1.default.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+async function signInWithBrowser() {
+    showCursor();
+    const config = (0, config_js_1.loadConfig)();
+    const endpoint = config.endpoint;
+    console.log();
+    console.log(bold("  Sign in with browser"));
+    console.log(dim("  Opening your browser to authorize the CLI..."));
+    console.log();
+    // Step 1: Create a pending auth session
+    let code;
+    try {
+        const res = await fetch(`${endpoint}/api/cli-auth`, { method: "POST" });
+        const data = await res.json();
+        code = data.code;
+    }
+    catch {
+        console.log(red("  ✗ Failed to reach Cascade. Check your endpoint."));
+        hideCursor();
+        await pause(2000);
+        return;
+    }
+    // Step 2: Open browser
+    const authUrl = `${endpoint}/cli-auth?code=${code}`;
+    console.log(dim(`  URL: ${authUrl}`));
+    console.log();
+    try {
+        const platform = process.platform;
+        if (platform === "darwin")
+            (0, child_process_1.execSync)(`open "${authUrl}"`);
+        else if (platform === "win32")
+            (0, child_process_1.execSync)(`start "${authUrl}"`);
+        else
+            (0, child_process_1.execSync)(`xdg-open "${authUrl}" 2>/dev/null || echo ""`);
+        console.log(dim("  Browser opened. Approve the request, then come back here."));
+    }
+    catch {
+        console.log(`  Open this URL in your browser:`);
+        console.log(gold(`  ${authUrl}`));
+    }
+    console.log();
+    console.log(dim("  Waiting for approval..."));
+    // Step 3: Poll for approval
+    const startTime = Date.now();
+    const timeout = 10 * 60 * 1000; // 10 minutes
+    while (Date.now() - startTime < timeout) {
+        await pause(2000);
+        try {
+            const res = await fetch(`${endpoint}/api/cli-auth?code=${code}`);
+            const data = await res.json();
+            if (data.status === "approved" && data.apiKey) {
+                (0, config_js_1.saveConfig)({ api_key: data.apiKey });
+                console.log();
+                console.log(green("  ✓ Authenticated! API key saved."));
+                hideCursor();
+                await pause(1500);
+                return;
+            }
+            if (data.status === "expired") {
+                console.log(red("  ✗ Session expired. Try again."));
+                hideCursor();
+                await pause(2000);
+                return;
+            }
+            // Still pending — show a dot
+            process.stdout.write(dim("."));
+        }
+        catch {
+            // Network error — keep trying
+        }
+    }
+    console.log();
+    console.log(red("  ✗ Timed out. Try again."));
+    hideCursor();
+    await pause(2000);
+}
+async function setupApiKey() {
+    showCursor();
+    console.log();
+    console.log(bold("  Configure API Key"));
+    console.log(dim("  Get your key from Portal → Settings → Developer & API"));
+    console.log();
+    const key = await prompt("  Paste your API key: ");
+    if (key && key.startsWith("csk_")) {
+        (0, config_js_1.saveConfig)({ api_key: key });
+        console.log(green("  ✓ API key saved to " + (0, config_js_1.getConfigPath)()));
+    }
+    else if (key) {
+        console.log(red("  ✗ Invalid key format. Keys start with csk_live_"));
+    }
+    hideCursor();
+    await pause(1500);
+}
+async function setupEndpoint() {
+    showCursor();
+    console.log();
+    const config = (0, config_js_1.loadConfig)();
+    console.log(dim(`  Current endpoint: ${config.endpoint}`));
+    const ep = await prompt("  Enter endpoint URL: ");
+    if (ep) {
+        (0, config_js_1.saveConfig)({ endpoint: ep });
+        console.log(green("  ✓ Endpoint set to " + ep));
+    }
+    hideCursor();
+    await pause(1000);
+}
+async function testConnection() {
+    console.log();
+    console.log(dim("  Testing connection..."));
+    try {
+        const client = new client_js_1.CascadeClient();
+        const { data } = await client.getState();
+        const state = data;
+        const nodes = (state.graph?.nodes ?? []);
+        console.log(green(`  ✓ Connected — Step ${state.step}, ${nodes.length} entities`));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        console.log(red(`  ✗ Connection failed: ${msg}`));
+    }
+    await pause(2000);
+}
+async function quickStatus() {
+    try {
+        const client = new client_js_1.CascadeClient();
+        const { data } = await client.getState();
+        const state = data;
+        const nodes = state.graph?.nodes ?? [];
+        const nodeArr = nodes;
+        let maxDev = 0;
+        const movers = [];
+        for (const n of nodeArr) {
+            const devs = n.deviation_pct ?? [];
+            const avg = devs.reduce((s, v) => s + Math.abs(v), 0) / (devs.length || 1);
+            if (avg > maxDev)
+                maxDev = avg;
+            movers.push({ name: String(n.name), dev: avg });
+        }
+        movers.sort((a, b) => b.dev - a.dev);
+        const health = maxDev > 15 ? red("CRITICAL") : maxDev > 8 ? gold("WARNING") : green("NOMINAL");
+        console.log();
+        console.log(`  ${bold("System Status")}   ${health}`);
+        console.log(`  ${dim("Step")} ${state.step}   ${dim("Entities")} ${nodeArr.length}   ${dim("Peak deviation")} ${maxDev.toFixed(1)}%`);
+        console.log();
+        console.log(`  ${dim("Top movers:")}`);
+        for (const m of movers.slice(0, 5)) {
+            const bar = "█".repeat(Math.min(Math.round(m.dev / 2), 20));
+            const color = m.dev > 10 ? red : m.dev > 5 ? gold : green;
+            console.log(`  ${m.name.replace(/_/g, " ").padEnd(22)} ${color(bar)} ${m.dev.toFixed(1)}%`);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Unknown error";
+        console.log(red(`  Error: ${msg}`));
+    }
+    console.log();
+    console.log(dim("  Press any key to continue..."));
+    await waitForKey();
+}
+async function showHelp() {
+    console.log();
+    console.log(bold("  Command Reference"));
+    console.log();
+    const cmds = [
+        ["cascade status", "System health overview"],
+        ["cascade entities", "All entities with deviations"],
+        ["cascade entity <name>", "Detail for specific entity"],
+        ["cascade events", "Event feed (--watch for live)"],
+        ["cascade prices", "All tracked tickers"],
+        ["cascade price <entity>", "Live price data"],
+        ["cascade chat \"question\"", "Ask Cascade AI"],
+        ["cascade dossier --entities X,Y", "Intelligence report"],
+        ["cascade skills", "AI agent skills file"],
+        ["cascade config show", "Show configuration"],
+    ];
+    for (const [cmd, desc] of cmds) {
+        console.log(`  ${cyan(cmd.padEnd(32))} ${dim(desc)}`);
+    }
+    console.log();
+    console.log(dim("  All commands support --format json|csv|table"));
+    console.log();
+    console.log(dim("  Press any key to continue..."));
+    await waitForKey();
+}
+function pause(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function waitForKey() {
+    return new Promise((resolve) => {
+        const wasRaw = process.stdin.isRaw;
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.once("data", () => {
+            process.stdin.setRawMode(wasRaw ?? false);
+            process.stdin.pause();
+            resolve();
+        });
+    });
+}
+async function startWelcome() {
+    const config = (0, config_js_1.loadConfig)();
+    const hasKey = !!config.api_key;
+    const items = [];
+    if (hasKey) {
+        items.push({ label: "Dashboard", hint: "View system status and top movers", action: quickStatus });
+    }
+    items.push({ label: "Sign in with browser", hint: "Authenticate via your Cascade portal", action: signInWithBrowser });
+    items.push({ label: hasKey ? "Change API Key" : "Paste API Key", hint: hasKey ? `Current: ${config.api_key.slice(0, 16)}...` : "Manually enter a key", action: setupApiKey });
+    items.push({ label: "Set Endpoint", hint: config.endpoint, action: setupEndpoint });
+    if (hasKey) {
+        items.push({ label: "Test Connection", hint: "Verify API key and endpoint", action: testConnection });
+    }
+    items.push({ label: "Commands", hint: "View all available commands", action: showHelp });
+    items.push({ label: "Quit", hint: "Exit Cascade CLI", action: () => { showCursor(); process.exit(0); } });
+    let selected = 0;
+    const render = () => {
+        clearScreen();
+        console.log(BANNER);
+        // Config status
+        if (hasKey) {
+            console.log(`  ${green("●")} Connected   ${dim("Key:")} ${config.api_key.slice(0, 16)}...   ${dim("Endpoint:")} ${config.endpoint}`);
+        }
+        else {
+            console.log(`  ${red("●")} Not configured   ${dim("Set your API key to get started")}`);
+        }
+        console.log();
+        // Menu
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            if (i === selected) {
+                console.log(`  ${gold("▸")} ${bold(item.label.padEnd(20))} ${dim(item.hint)}`);
+            }
+            else {
+                console.log(`    ${dim(item.label.padEnd(20))} ${dim(item.hint)}`);
+            }
+        }
+        console.log();
+        console.log(dim("  ↑↓ Navigate   Enter Select   q Quit"));
+    };
+    hideCursor();
+    render();
+    // Input loop
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    const handleKey = async (data) => {
+        const key = data.toString();
+        if (key === "q" || key === "\x03") {
+            // q or Ctrl+C
+            showCursor();
+            clearScreen();
+            process.exit(0);
+        }
+        if (key === "\x1b[A") {
+            // Up arrow
+            selected = (selected - 1 + items.length) % items.length;
+            render();
+            return;
+        }
+        if (key === "\x1b[B") {
+            // Down arrow
+            selected = (selected + 1) % items.length;
+            render();
+            return;
+        }
+        if (key === "\r" || key === "\n") {
+            // Enter
+            process.stdin.removeListener("data", handleKey);
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            clearScreen();
+            console.log(BANNER);
+            await items[selected].action();
+            // After action, re-render menu
+            // Rebuild items in case config changed
+            const newConfig = (0, config_js_1.loadConfig)();
+            const newHasKey = !!newConfig.api_key;
+            items.length = 0;
+            if (newHasKey) {
+                items.push({ label: "Dashboard", hint: "View system status and top movers", action: quickStatus });
+            }
+            items.push({ label: "Sign in with browser", hint: "Authenticate via your Cascade portal", action: signInWithBrowser });
+            items.push({ label: newHasKey ? "Change API Key" : "Paste API Key", hint: newHasKey ? `Current: ${newConfig.api_key.slice(0, 16)}...` : "Manually enter a key", action: setupApiKey });
+            items.push({ label: "Set Endpoint", hint: newConfig.endpoint, action: setupEndpoint });
+            if (newHasKey) {
+                items.push({ label: "Test Connection", hint: "Verify API key and endpoint", action: testConnection });
+            }
+            items.push({ label: "Commands", hint: "View all available commands", action: showHelp });
+            items.push({ label: "Quit", hint: "Exit Cascade CLI", action: () => { showCursor(); process.exit(0); } });
+            if (selected >= items.length)
+                selected = 0;
+            process.stdin.setRawMode(true);
+            process.stdin.resume();
+            process.stdin.on("data", handleKey);
+            render();
+        }
+    };
+    process.stdin.on("data", handleKey);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metisos/cascade-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Cascade CLI — Real-time geopolitical and economic intelligence from your terminal",
   "bin": {
     "cascade": "./dist/bin/cascade.js"