haltest 1.0.0

package/bin/haltest.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+
+/**
+ * HalTest CLI Launcher — bin/haltest.js
+ *
+ * Starts the HalTest backend server, runs pre-requisite checks,
+ * auto-opens the browser, and handles graceful shutdown.
+ */
+
+import { spawn } from 'child_process';
+import net from 'net';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// ── Resolve paths ──────────────────────────────────────────────────────────
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// bin/ is one level inside apps/cli → go up two levels to reach the monorepo root
+const MONOREPO_ROOT = path.resolve(__dirname, '..', '..', '..');
+const BACKEND_ENTRY = path.join(MONOREPO_ROOT, 'apps', 'backend', 'app.js');
+
+const PORT = parseInt(process.env.PORT || '2001', 10);
+const APP_URL = `http://localhost:${PORT}/app/`;
+const OLLAMA_PORT = 11434;
+
+// ── ANSI helpers ───────────────────────────────────────────────────────────
+const c = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    magenta: '\x1b[35m',
+    blue: '\x1b[34m',
+    white: '\x1b[97m',
+};
+const style = (color, text) => `${color}${text}${c.reset}`;
+
+// ── Banner ─────────────────────────────────────────────────────────────────
+function printBanner() {
+    console.log('');
+    console.log(style(c.cyan + c.bold, '  ██╗  ██╗ █████╗ ██╗  ████████╗███████╗███████╗████████╗'));
+    console.log(style(c.cyan + c.bold, '  ██║  ██║██╔══██╗██║  ╚══██╔══╝██╔════╝██╔════╝╚══██╔══╝'));
+    console.log(style(c.cyan + c.bold, '  ███████║███████║██║     ██║   █████╗  ███████╗   ██║   '));
+    console.log(style(c.cyan + c.bold, '  ██╔══██║██╔══██║██║     ██║   ██╔══╝  ╚════██║   ██║   '));
+    console.log(style(c.cyan + c.bold, '  ██║  ██║██║  ██║███████╗██║   ███████╗███████║   ██║   '));
+    console.log(style(c.cyan + c.bold, '  ╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝╚═╝   ╚══════╝╚══════╝   ╚═╝   '));
+    console.log('');
+    console.log(style(c.white + c.bold, '  Browser Automation & Orchestration Platform'));
+    console.log(style(c.dim + c.white, '  ─────────────────────────────────────────────────────────'));
+    console.log('');
+}
+
+// ── Port check helper ──────────────────────────────────────────────────────
+function isPortListening(port) {
+    return new Promise((resolve) => {
+        const socket = net.createConnection({ port, host: '127.0.0.1' });
+        socket.once('connect', () => { socket.destroy(); resolve(true); });
+        socket.once('error', () => { socket.destroy(); resolve(false); });
+        socket.setTimeout(500, () => { socket.destroy(); resolve(false); });
+    });
+}
+
+// ── Pre-requisite checks ───────────────────────────────────────────────────
+async function runPreRequisiteChecks() {
+    console.log(style(c.bold, '  🔍 Running pre-requisite checks...\n'));
+
+    // Check Ollama
+    const ollamaOk = await isPortListening(OLLAMA_PORT);
+    if (ollamaOk) {
+        console.log(style(c.green, `  ✅ Ollama   — detected on port ${OLLAMA_PORT}. Local AI is active.`));
+    } else {
+        console.log(
+            style(c.yellow, `  ⚠️  Ollama   — not detected on port ${OLLAMA_PORT}.`) +
+            style(c.dim, ' Local AI features will be disabled until Ollama is started.')
+        );
+        console.log(
+            style(c.dim, `             Run: `) +
+            style(c.white, 'ollama serve') +
+            style(c.dim, ' in a separate terminal to enable AI features.')
+        );
+    }
+
+    // Check Playwright (probe for the chromium executable)
+    try {
+        const { chromium } = await import('playwright');
+        const execPath = chromium.executablePath();
+        // executablePath() throws if not installed
+        void execPath;
+        console.log(style(c.green, '  ✅ Playwright — Chromium browser found.'));
+    } catch {
+        console.log(
+            style(c.yellow, '  ⚠️  Playwright — Chromium not found.') +
+            style(c.dim, ' Run: npx playwright install chromium')
+        );
+    }
+
+    console.log('');
+}
+
+// ── Open browser (dynamic import for ESM compatibility) ────────────────────
+async function openBrowser(url) {
+    try {
+        const { default: open } = await import('open');
+        await open(url);
+    } catch {
+        console.log(style(c.dim, `  ℹ️  Could not auto-open browser. Navigate to: ${url}`));
+    }
+}
+
+// ── Main ───────────────────────────────────────────────────────────────────
+printBanner();
+
+await runPreRequisiteChecks();
+
+console.log(style(c.bold, `  🚀 Starting HalTest Server...`));
+console.log(style(c.dim, `     Entry: ${BACKEND_ENTRY}`));
+console.log('');
+
+// Spawn the backend server
+const server = spawn('node', [BACKEND_ENTRY], {
+    cwd: MONOREPO_ROOT,
+    stdio: ['ignore', 'pipe', 'pipe'],
+    env: { ...process.env, NODE_ENV: process.env.NODE_ENV || 'production' },
+});
+
+let browserOpened = false;
+
+// Forward stdout — detect ready signal
+server.stdout.on('data', (data) => {
+    const text = data.toString();
+    process.stdout.write(text);
+
+    // Detect the backend "ready" line
+    if (!browserOpened && text.includes('HaltTest Server is Up')) {
+        browserOpened = true;
+        console.log('');
+        console.log(style(c.green + c.bold, `  ✅ Server is up! Opening browser at ${APP_URL}`));
+        console.log(style(c.dim, '     Press Ctrl+C to stop the server.\n'));
+        openBrowser(APP_URL).catch(() => { });
+    }
+});
+
+// Forward stderr
+server.stderr.on('data', (data) => {
+    process.stderr.write(data);
+});
+
+// Handle unexpected server exit
+server.on('exit', (code, signal) => {
+    if (signal) {
+        // Killed by us during shutdown — silent
+        return;
+    }
+    if (code !== 0) {
+        console.error(style(c.red, `\n  ❌ Server exited with code ${code}.`));
+        process.exit(code ?? 1);
+    }
+});
+
+server.on('error', (err) => {
+    console.error(style(c.red, `\n  ❌ Failed to start server: ${err.message}`));
+    console.error(style(c.dim, `     Make sure you're inside the HalTest monorepo directory.`));
+    process.exit(1);
+});
+
+// ── Graceful Shutdown ──────────────────────────────────────────────────────
+function shutdown(signal) {
+    console.log('');
+    console.log(style(c.magenta + c.bold, `\n  👋 Received ${signal}. Shutting down HalTest gracefully...`));
+
+    if (!server.killed) {
+        server.kill('SIGTERM');
+
+        // Force-kill after 5 s if the child doesn't exit
+        const forceKill = setTimeout(() => {
+            if (!server.killed) {
+                server.kill('SIGKILL');
+            }
+        }, 5000);
+
+        server.on('exit', () => {
+            clearTimeout(forceKill);
+            console.log(style(c.green, '  ✅ Server stopped cleanly. Goodbye!\n'));
+            process.exit(0);
+        });
+    } else {
+        console.log(style(c.green, '  ✅ Server already stopped. Goodbye!\n'));
+        process.exit(0);
+    }
+}
+
+process.on('SIGINT', () => shutdown('SIGINT'));
+process.on('SIGTERM', () => shutdown('SIGTERM'));

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "haltest",
+  "version": "1.0.0",
+  "description": "CLI launcher for the HalTest browser automation & orchestration platform",
+  "main": "bin/haltest.js",
+  "type": "module",
+  "bin": {
+    "haltest": "./bin/haltest.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "scripts": {
+    "start": "node bin/haltest.js",
+    "dev": "node bin/haltest.js",
+    "cli": "node src/index.js"
+  },
+  "dependencies": {
+    "axios": "^1.7.9",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "dotenv": "^16.4.7",
+    "form-data": "^4.0.1",
+    "open": "^10.1.0",
+    "ora": "^8.2.0",
+    "socket.io-client": "^4.8.3",
+    "terminal-image": "^4.2.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "private": false
+}

package/src/index.js

@@ -0,0 +1,218 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import axios from "axios";
+import dotenv from "dotenv";
+import { fileURLToPath } from "url";
+import path from "path";
+import { io } from "socket.io-client";
+import fs from "fs/promises";
+
+// Load .env
+dotenv.config();
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// Use baseUrl but fallback to localhost:2001
+const API_URL = (
+  process.env.HALTEST_API_URL || "http://localhost:2001/api"
+).replace(/\/$/, "");
+const SOCKET_URL = API_URL.replace("/api", "");
+
+const program = new Command();
+
+program
+  .name("haltest")
+  .description("CLI for HAL-TEST automation framework")
+  .version("1.0.0");
+
+// --- STATUS COMMAND ---
+program
+  .command("status")
+  .description("Check the status of the HAL-TEST server")
+  .action(async () => {
+    const spinner = ora("Connecting to HAL-TEST server...").start();
+    try {
+      const response = await axios.get(`${API_URL}/status`);
+      spinner.succeed(chalk.green("HAL-TEST Server is ONLINE"));
+      console.log(chalk.gray(`URL: ${API_URL}`));
+      console.log(
+        chalk.cyan(`Environment: ${response.data.environment || "N/A"}`),
+      );
+    } catch (error) {
+      spinner.fail(chalk.red("HAL-TEST Server is OFFLINE"));
+      console.error(chalk.gray(`Tried: ${API_URL}`));
+      console.error(chalk.red(error.message));
+    }
+  });
+
+// --- LIST COMMAND ---
+program
+  .command("list")
+  .description("List all available flows")
+  .action(async () => {
+    const spinner = ora("Fetching flows...").start();
+    try {
+      const projectsRes = await axios.get(`${API_URL}/projects`);
+      spinner.succeed(chalk.blue("Available Flows:"));
+
+      projectsRes.data.forEach((project) => {
+        console.log(
+          `\n📂 Project: ${chalk.bold(project.name)} ${chalk.gray(`(${project.id})`)}`,
+        );
+        project.flows?.forEach((flow) => {
+          console.log(
+            `  - ${chalk.cyan(flow.name)} ${chalk.gray(`ID: ${flow.id}`)}`,
+          );
+        });
+      });
+    } catch (error) {
+      spinner.fail(chalk.red("Failed to fetch flows"));
+      console.error(chalk.red(error.message));
+    }
+  });
+
+// --- RUN COMMAND ---
+program
+  .command("run <flowId>")
+  .description("Execute a flow and stream real-time logs")
+  .option("-p, --project <projectId>", "Project ID", "default-project-1")
+  .option(
+    "-h, --headed",
+    "Run with visible browser (overrides headless)",
+    false,
+  )
+  .option("-o, --output <path>", "Save execution report to file (JSON)")
+  .action(async (flowId, options) => {
+    const { project: projectId, headed, output } = options;
+
+    console.log(
+      chalk.bold.blue(`\n🚀 Initializing execution for flow: ${flowId}`),
+    );
+    const spinner = ora("Handshaking with server...").start();
+
+    // 1. Connect to Socket for logs
+    const socket = io(SOCKET_URL);
+    let currentRunId = null;
+
+    socket.on("connect", () => {
+      spinner.text = "Connected to socket, waiting for execution start...";
+    });
+
+    socket.on("execution-log", (data) => {
+      const time = chalk.gray(
+        `[${new Date(data.timestamp).toLocaleTimeString()}]`,
+      );
+      const node = data.nodeId
+        ? chalk.magenta(`[${data.nodeId.split("-")[0]}]`)
+        : "";
+
+      let msg = data.message;
+      if (data.type === "error") msg = chalk.red(msg);
+      else if (data.type === "success") msg = chalk.green(msg);
+      else if (data.type === "warning") msg = chalk.yellow(msg);
+
+      console.log(`${time} ${node} ${msg}`);
+    });
+
+    socket.on("execution-status", (data) => {
+      if (data.status === "failed") {
+        console.log(
+          chalk.red(
+            `\n❌ Node [${data.stepId}] failed: ${data.error || "Unknown error"}`,
+          ),
+        );
+      }
+    });
+
+    // AUTO-TERMINATE LOGIC
+    socket.on("flow-finished", async (data) => {
+      if (data.runId !== currentRunId) return;
+
+      console.log(chalk.bold("\n" + "=".repeat(40)));
+      console.log(
+        chalk.bold(`🏁 EXECUTION FINISHED: ${data.status.toUpperCase()}`),
+      );
+      console.log(chalk.bold("=".repeat(40) + "\n"));
+
+      const reportSpinner = ora("Generating final report...").start();
+
+      try {
+        // Fetch full report from API
+        const runRes = await axios.get(`${API_URL}/runs/${currentRunId}`);
+        const runData = runRes.data.data;
+        reportSpinner.succeed("Report generated");
+
+        // Print summary table-like info
+        console.log(chalk.cyan(`Run ID:    `) + runData.id);
+        console.log(
+          chalk.cyan(`Duration:  `) +
+            `${(runData.duration_ms / 1000).toFixed(2)}s`,
+        );
+        console.log(chalk.cyan(`Steps:     `) + runData.steps?.length);
+
+        const errors =
+          runData.steps?.filter((s) => s.status === "failed") || [];
+        if (errors.length > 0) {
+          console.log(chalk.red(`Errors:    `) + errors.length);
+          errors.forEach((e) => {
+            console.log(
+              chalk.red(`  ! [${e.node_id}] ${e.node_type}: ${e.error}`),
+            );
+          });
+        } else {
+          console.log(chalk.green(`Errors:    0`));
+        }
+
+        // Save to file if requested
+        if (output) {
+          await fs.writeFile(output, JSON.stringify(runData, null, 2));
+          console.log(chalk.green(`\n💾 Report saved to: ${output}`));
+        }
+      } catch (err) {
+        reportSpinner.fail("Failed to fetch run details");
+        console.error(chalk.red(err.message));
+      }
+
+      socket.disconnect();
+      process.exit(data.status === "completed" ? 0 : 1);
+    });
+
+    try {
+      // 2. Trigger the run
+      const response = await axios.post(`${API_URL}/runs/start`, {
+        flowId,
+        projectId,
+        overrides: {
+          headless: !headed,
+        },
+      });
+
+      currentRunId = response.data.runId;
+      spinner.succeed(
+        chalk.green(`Execution started! Run ID: ${currentRunId}`),
+      );
+      console.log(chalk.gray("--- Streaming Logs ---\n"));
+    } catch (error) {
+      spinner.fail(chalk.red("Execution failed to start"));
+      socket.disconnect();
+      if (error.response) {
+        const backendError =
+          error.response.data.message ||
+          error.response.data.error ||
+          error.response.statusText;
+        console.error(chalk.red(`Error: ${backendError}`));
+      } else {
+        console.error(chalk.red(error.message));
+      }
+      process.exit(1);
+    }
+  });
+
+// Show help if no command is provided
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+} else {
+  program.parse();
+}