@metisos/cascade-cli 0.1.1 → 0.3.0

package/dist/bin/cascade.js

@@ -12,6 +12,7 @@ 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
@@ -27,7 +28,7 @@ const program = new commander_1.Command();
 program
     .name("cascade")
     .description("Cascade CLI — Real-time geopolitical and economic intelligence")
-    .version("0.1.1")
+    .version("0.3.0")
     .addHelpText("beforeAll", BANNER);
 // Global format option
 function addFormat(cmd) {
@@ -93,10 +94,14 @@ function handleError(err) {
     console.error(`Error: ${err.message}`);
     process.exit(1);
 }
-// No args → show help (banner included via addHelpText)
+// No args → launch interactive welcome menu
 if (process.argv.length <= 2) {
-    program.outputHelp();
-    process.exit(0);
+    (0, welcome_js_1.startWelcome)().catch((err) => {
+        console.error(err.message);
+        process.exit(1);
+    });
+}
+else {
+    // Subcommand provided → run command mode
+    program.parse();
 }
-// Parse
-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,519 @@
+"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 promptLine(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()); });
+    });
+}
+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();
+        });
+    });
+}
+function getClient() {
+    try {
+        return new client_js_1.CascadeClient();
+    }
+    catch {
+        return null;
+    }
+}
+// ── Actions ──
+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();
+    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;
+    }
+    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..."));
+    const startTime = Date.now();
+    while (Date.now() - startTime < 10 * 60 * 1000) {
+        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;
+            }
+            process.stdout.write(dim("."));
+        }
+        catch { /* keep trying */ }
+    }
+    console.log();
+    console.log(red("  ✗ Timed out."));
+    hideCursor();
+    await pause(2000);
+}
+async function setupApiKey() {
+    showCursor();
+    console.log();
+    console.log(bold("  Paste API Key"));
+    console.log(dim("  Get your key from Portal → Settings → Developer & API"));
+    console.log();
+    const key = await promptLine("  API key: ");
+    if (key && key.startsWith("csk_")) {
+        (0, config_js_1.saveConfig)({ api_key: key });
+        console.log(green("  ✓ Saved to " + (0, config_js_1.getConfigPath)()));
+    }
+    else if (key) {
+        console.log(red("  ✗ Invalid format. Keys start with csk_"));
+    }
+    hideCursor();
+    await pause(1500);
+}
+async function setupEndpoint() {
+    showCursor();
+    console.log();
+    const config = (0, config_js_1.loadConfig)();
+    console.log(dim(`  Current: ${config.endpoint}`));
+    const ep = await promptLine("  Endpoint URL: ");
+    if (ep) {
+        (0, config_js_1.saveConfig)({ endpoint: ep });
+        console.log(green("  ✓ Set to " + ep));
+    }
+    hideCursor();
+    await pause(1000);
+}
+async function testConnection() {
+    console.log();
+    console.log(dim("  Testing..."));
+    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) {
+        console.log(red(`  ✗ ${err instanceof Error ? err.message : "Failed"}`));
+    }
+    await pause(2000);
+}
+async function viewDashboard() {
+    const client = getClient();
+    if (!client) {
+        console.log(red("\n  Not configured. Set API key first."));
+        await pause(1500);
+        return;
+    }
+    try {
+        const { data } = await client.getState();
+        const state = data;
+        const nodes = (state.graph?.nodes ?? []);
+        let maxDev = 0;
+        const movers = [];
+        for (const n of nodes) {
+            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")} ${nodes.length}   ${dim("Peak")} ${maxDev.toFixed(1)}%`);
+        console.log();
+        for (const m of movers.slice(0, 8)) {
+            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(24)} ${color(bar)} ${m.dev.toFixed(1)}%`);
+        }
+    }
+    catch (err) {
+        console.log(red(`\n  ${err instanceof Error ? err.message : "Failed"}`));
+    }
+    console.log();
+    console.log(dim("  Press any key..."));
+    await waitForKey();
+}
+async function viewEntities() {
+    const client = getClient();
+    if (!client) {
+        console.log(red("\n  Not configured."));
+        await pause(1500);
+        return;
+    }
+    try {
+        const { data } = await client.getState();
+        const nodes = data.graph?.nodes ?? [];
+        const rows = nodes.map((n) => {
+            const devs = n.deviation_pct ?? [];
+            const avg = devs.reduce((s, v) => s + Math.abs(v), 0) / (devs.length || 1);
+            return { name: String(n.name), cat: String(n.category), dev: avg, econ: devs[1] ?? 0 };
+        }).sort((a, b) => b.dev - a.dev);
+        console.log();
+        console.log(`  ${dim("Entity".padEnd(26))} ${dim("Category".padEnd(10))} ${dim("Deviation".padEnd(10))} ${dim("Econ")}`);
+        console.log(`  ${"─".repeat(60)}`);
+        for (const r of rows.slice(0, 20)) {
+            const color = r.dev > 10 ? red : r.dev > 5 ? gold : green;
+            console.log(`  ${r.name.replace(/_/g, " ").padEnd(26)} ${r.cat.padEnd(10)} ${color(r.dev.toFixed(1).padStart(5) + "%")}     ${r.econ >= 0 ? "+" : ""}${r.econ.toFixed(1)}%`);
+        }
+        if (rows.length > 20)
+            console.log(dim(`\n  ...and ${rows.length - 20} more`));
+    }
+    catch (err) {
+        console.log(red(`\n  ${err instanceof Error ? err.message : "Failed"}`));
+    }
+    console.log();
+    console.log(dim("  Press any key..."));
+    await waitForKey();
+}
+async function viewEvents() {
+    const client = getClient();
+    if (!client) {
+        console.log(red("\n  Not configured."));
+        await pause(1500);
+        return;
+    }
+    try {
+        const { data } = await client.getEvents(15);
+        const events = data.events ?? [];
+        console.log();
+        console.log(`  ${dim("Time".padEnd(10))} ${dim("Type".padEnd(22))} ${dim("Entity".padEnd(20))} ${dim("Sev")}`);
+        console.log(`  ${"─".repeat(60)}`);
+        for (const e of events) {
+            const time = String(e.timestamp ?? "").slice(11, 19);
+            const type = String(e.event_type ?? "").replace(/_/g, " ");
+            const entity = String(e.entity_name ?? "");
+            const sev = Math.round((e.severity ?? 0) * 100);
+            const color = sev >= 70 ? red : sev >= 30 ? gold : green;
+            console.log(`  ${time.padEnd(10)} ${type.padEnd(22)} ${entity.replace(/_/g, " ").padEnd(20)} ${color(sev + "%")}`);
+        }
+    }
+    catch (err) {
+        console.log(red(`\n  ${err instanceof Error ? err.message : "Failed"}`));
+    }
+    console.log();
+    console.log(dim("  Press any key..."));
+    await waitForKey();
+}
+async function viewPrices() {
+    const client = getClient();
+    if (!client) {
+        console.log(red("\n  Not configured."));
+        await pause(1500);
+        return;
+    }
+    try {
+        const { data } = await client.getPrices();
+        const tickers = data.tickers ?? [];
+        console.log();
+        for (const t of tickers) {
+            const name = String(t.name).replace(/_/g, " ");
+            const symbol = String(t.symbol);
+            try {
+                const { data: priceData } = await client.getPrice(String(t.name), "5d");
+                const bars = priceData.data ?? [];
+                if (bars.length >= 2) {
+                    const last = bars[bars.length - 1];
+                    const first = bars[0];
+                    const price = last.close.toFixed(2);
+                    const change = (last.close - first.close);
+                    const pct = (change / first.close) * 100;
+                    const color = change >= 0 ? green : red;
+                    console.log(`  ${name.padEnd(18)} ${dim(symbol.padEnd(10))} ${price.padStart(10)}  ${color((change >= 0 ? "+" : "") + pct.toFixed(2) + "%")}`);
+                }
+                else {
+                    console.log(`  ${name.padEnd(18)} ${dim(symbol.padEnd(10))} ${dim("no data")}`);
+                }
+            }
+            catch {
+                console.log(`  ${name.padEnd(18)} ${dim(symbol.padEnd(10))} ${dim("—")}`);
+            }
+        }
+    }
+    catch (err) {
+        console.log(red(`\n  ${err instanceof Error ? err.message : "Failed"}`));
+    }
+    console.log();
+    console.log(dim("  Press any key..."));
+    await waitForKey();
+}
+async function interactiveChat() {
+    const client = getClient();
+    if (!client) {
+        console.log(red("\n  Not configured."));
+        await pause(1500);
+        return;
+    }
+    showCursor();
+    clearScreen();
+    console.log(BANNER);
+    console.log(bold("  Cascade Intelligence Chat"));
+    console.log(dim("  Ask about entities, events, risks, prices. Type 'exit' to return.\n"));
+    const rl = readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: gold("  You: "),
+    });
+    rl.prompt();
+    rl.on("line", async (line) => {
+        const msg = line.trim();
+        if (!msg) {
+            rl.prompt();
+            return;
+        }
+        if (msg.toLowerCase() === "exit" || msg.toLowerCase() === "quit") {
+            rl.close();
+            hideCursor();
+            return;
+        }
+        console.log(dim("  Thinking..."));
+        try {
+            const { data } = await client.chat(msg);
+            console.log();
+            // Word wrap the response
+            const content = data.content;
+            const lines = content.split("\n");
+            for (const l of lines) {
+                const words = l.split(" ");
+                let line = "  ";
+                for (const w of words) {
+                    if (line.length + w.length > 90) {
+                        console.log(cyan(line));
+                        line = "  " + w + " ";
+                    }
+                    else {
+                        line += w + " ";
+                    }
+                }
+                if (line.trim())
+                    console.log(cyan(line));
+            }
+            console.log();
+        }
+        catch (err) {
+            console.log(red(`  Error: ${err instanceof Error ? err.message : "Failed"}`));
+            console.log();
+        }
+        rl.prompt();
+    });
+    rl.on("close", () => {
+        // Return to menu handled by caller
+    });
+    // Wait for chat to end
+    await new Promise((resolve) => { rl.on("close", resolve); });
+}
+async function viewCorrelations() {
+    const client = getClient();
+    if (!client) {
+        console.log(red("\n  Not configured."));
+        await pause(1500);
+        return;
+    }
+    try {
+        const { data } = await client.getCorrelations(1);
+        const d = data;
+        const entities = d.entities ?? [];
+        const nObs = d.n_observations ?? 0;
+        console.log();
+        console.log(`  ${bold("Correlation Matrix")} ${dim(`(Econ, ${nObs} observations)`)}`);
+        if (nObs < 30) {
+            console.log(dim(`\n  Need ${30 - nObs} more observations for correlation data.`));
+        }
+        else {
+            const matrix = d.empirical ?? [];
+            // Show top correlated pairs
+            const pairs = [];
+            for (let i = 0; i < entities.length; i++) {
+                for (let j = i + 1; j < entities.length; j++) {
+                    pairs.push({ a: entities[i], b: entities[j], corr: matrix[i]?.[j] ?? 0 });
+                }
+            }
+            pairs.sort((a, b) => Math.abs(b.corr) - Math.abs(a.corr));
+            console.log(`\n  ${dim("Strongest relationships:")}`);
+            for (const p of pairs.slice(0, 12)) {
+                const color = p.corr > 0.3 ? green : p.corr < -0.3 ? red : dim;
+                const sign = p.corr >= 0 ? "+" : "";
+                console.log(`  ${p.a.replace(/_/g, " ").padEnd(20)} ↔ ${p.b.replace(/_/g, " ").padEnd(20)} ${color(sign + p.corr.toFixed(2))}`);
+            }
+        }
+    }
+    catch (err) {
+        console.log(red(`\n  ${err instanceof Error ? err.message : "Failed"}`));
+    }
+    console.log();
+    console.log(dim("  Press any key..."));
+    await waitForKey();
+}
+async function generateSkills() {
+    showCursor();
+    console.log();
+    const { skillsCommand } = await import("../commands/skills.js");
+    await skillsCommand({ output: "CASCADE_SKILLS.md" });
+    hideCursor();
+    await pause(1500);
+}
+// ── Main Menu ──
+function buildMenu() {
+    const config = (0, config_js_1.loadConfig)();
+    const hasKey = !!config.api_key;
+    const items = [];
+    if (hasKey) {
+        items.push({ label: "Dashboard", hint: "System status and top movers", action: viewDashboard });
+        items.push({ label: "Chat", hint: "Ask Cascade AI anything", action: interactiveChat });
+        items.push({ label: "Entities", hint: "All entities with deviations", action: viewEntities });
+        items.push({ label: "Events", hint: "Recent event feed", action: viewEvents });
+        items.push({ label: "Prices", hint: "Live market data", action: viewPrices });
+        items.push({ label: "Correlations", hint: "Entity co-movement", action: viewCorrelations });
+        items.push({ label: "Generate Skills", hint: "CASCADE_SKILLS.md for AI agents", action: generateSkills, separator: true });
+    }
+    items.push({ label: "Sign in with browser", hint: "Authenticate via Cascade portal", action: signInWithBrowser });
+    items.push({ label: "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 key and endpoint", action: testConnection });
+    }
+    items.push({ label: "Quit", hint: "", action: () => { showCursor(); clearScreen(); process.exit(0); } });
+    return items;
+}
+async function startWelcome() {
+    let items = buildMenu();
+    let selected = 0;
+    const render = () => {
+        clearScreen();
+        console.log(BANNER);
+        const config = (0, config_js_1.loadConfig)();
+        if (config.api_key) {
+            console.log(`  ${green("●")} Connected   ${dim("Key:")} ${config.api_key.slice(0, 16)}...   ${dim("Endpoint:")} ${config.endpoint}`);
+        }
+        else {
+            console.log(`  ${red("●")} Not configured   ${dim("Sign in or paste API key to get started")}`);
+        }
+        console.log();
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            if (item.separator && i > 0)
+                console.log();
+            if (i === selected) {
+                console.log(`  ${gold("▸")} ${bold(item.label.padEnd(22))} ${dim(item.hint)}`);
+            }
+            else {
+                console.log(`    ${dim(item.label.padEnd(22))} ${dim(item.hint)}`);
+            }
+        }
+        console.log();
+        console.log(dim("  ↑↓ Navigate   Enter Select   q Quit"));
+    };
+    hideCursor();
+    render();
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    const handleKey = async (data) => {
+        const key = data.toString();
+        if (key === "q" || key === "\x03") {
+            showCursor();
+            clearScreen();
+            process.exit(0);
+        }
+        if (key === "\x1b[A") {
+            selected = (selected - 1 + items.length) % items.length;
+            render();
+            return;
+        }
+        if (key === "\x1b[B") {
+            selected = (selected + 1) % items.length;
+            render();
+            return;
+        }
+        if (key === "\r" || key === "\n") {
+            process.stdin.removeListener("data", handleKey);
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            clearScreen();
+            console.log(BANNER);
+            await items[selected].action();
+            // Rebuild menu (config may have changed)
+            items = buildMenu();
+            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.1",
+  "version": "0.3.0",
   "description": "Cascade CLI — Real-time geopolitical and economic intelligence from your terminal",
   "bin": {
     "cascade": "./dist/bin/cascade.js"