@northflare/runner 0.0.1

package/bin/northflare-runner

@@ -0,0 +1,367 @@
+#!/usr/bin/env node
+
+/**
+ * CLI executable for Northflare Runner
+ */
+
+const { program, Command } = require("commander");
+const pkg = require("../package.json");
+
+/**
+ * Helper function to fetch runner ID from orchestrator
+ */
+async function fetchRunnerId(orchestratorUrl, token) {
+  try {
+    const response = await fetch(`${orchestratorUrl}/api/runner/id`, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${token}`,
+      },
+    });
+
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: response.statusText }));
+      throw new Error(`Failed to fetch runner ID: ${error.error || response.statusText}`);
+    }
+
+    const data = await response.json();
+    if (!data.runnerId) {
+      throw new Error("Server did not return runnerId");
+    }
+
+    return data.runnerId;
+  } catch (error) {
+    throw new Error(`Failed to fetch runner ID: ${error.message}`);
+  }
+}
+
+// Create the start command
+const startCommand = new Command("start")
+  .description("start the runner")
+  .option("-c, --config <path>", "path to configuration file")
+  .option("-d, --debug", "enable debug logging")
+  .option("--data-dir <path>", "override data directory")
+  .option(
+    "--workspace-dir <path>",
+    "workspace directory for Git checkouts (default: uses env-paths data directory)"
+  )
+  .option("--token <token>", "authentication token")
+  .action(async (options, command) => {
+    // Set environment variables from CLI options
+    if (options.debug) {
+      process.env.DEBUG = "true";
+    }
+    if (options.dataDir) {
+      process.env.NORTHFLARE_DATA_DIR = options.dataDir;
+    }
+    if (options.workspaceDir) {
+      process.env.NORTHFLARE_WORKSPACE_DIR = options.workspaceDir;
+    }
+    const token = options.token || command.parent?.opts().token;
+    if (token) {
+      process.env.NORTHFLARE_RUNNER_TOKEN = token;
+    }
+
+    // Load the main module with config path if provided
+    // Clear argv[2] since it contains 'start' command
+    process.argv.splice(2);
+    const configPath = options.config || command.parent?.opts().config;
+    if (configPath) {
+      process.argv[2] = configPath;
+    }
+
+    // Manually call the main function since require.main won't match
+    const { main } = require("../dist");
+    await main().catch((error) => {
+      console.error("Fatal error:", error.message);
+      process.exit(1);
+    });
+  });
+
+// Create the validate command
+const validateCommand = new Command("validate")
+  .description("validate configuration without starting")
+  .option("-c, --config <path>", "path to configuration file")
+  .option("--token <token>", "authentication token")
+  .option("--data-dir <path>", "override data directory")
+  .option(
+    "--workspace-dir <path>",
+    "workspace directory for Git checkouts (default: uses env-paths data directory)"
+  )
+  .action(async (options, command) => {
+    try {
+      // Set environment variables from CLI options before validation
+      const token = options.token || command.parent?.opts().token;
+      if (token) {
+        process.env.NORTHFLARE_RUNNER_TOKEN = token;
+      }
+      if (options.dataDir) {
+        process.env.NORTHFLARE_DATA_DIR = options.dataDir;
+      }
+      if (options.workspaceDir) {
+        process.env.NORTHFLARE_WORKSPACE_DIR = options.workspaceDir;
+      }
+
+      const { ConfigManager } = require("../dist/utils/config.js");
+      const configPath = options.config || command.parent?.opts().config;
+      const config = await ConfigManager.loadConfig(configPath);
+      console.log("Configuration is valid");
+      console.log("Runner ID:", config.runnerId);
+      console.log("ElectricSQL URL:", config.electricUrl);
+      console.log("Orchestrator URL:", config.orchestratorUrl);
+      console.log("Workspace Directory:", process.env.NORTHFLARE_WORKSPACE_DIR);
+      process.exit(0);
+    } catch (error) {
+      console.error("Configuration validation failed:", error.message);
+      process.exit(1);
+    }
+  });
+
+// Create the list-repos command
+const listReposCommand = new Command("list-repos")
+  .description("list current runner repositories")
+  .option(
+    "-c, --config <path>",
+    "path to configuration file (defaults to ~/.config/northflare-runner/config.json)"
+  )
+  .option("--token <token>", "authentication token")
+  .action(async (options, command) => {
+    try {
+      const fs = require("fs").promises;
+      const path = require("path");
+      const envPaths = require("env-paths").default || require("env-paths");
+
+      // Get token from command options, parent options, or environment
+      const token = options.token || command.parent?.opts().token || process.env.NORTHFLARE_RUNNER_TOKEN;
+      if (!token) {
+        console.error("Error: NORTHFLARE_RUNNER_TOKEN is required. Provide it via --token or environment variable.");
+        process.exit(1);
+      }
+
+      // Get default config path
+      const paths = envPaths("northflare-runner", { suffix: "" });
+
+      // Determine config path from command options, parent options, or default
+      const configOption = options.config || command.parent?.opts().config;
+      let configPath;
+      if (configOption) {
+        configPath = path.resolve(configOption);
+      } else {
+        configPath = path.join(paths.config, "config.json");
+      }
+
+      // Load config file
+      let config = {};
+      try {
+        const content = await fs.readFile(configPath, "utf-8");
+        config = JSON.parse(content);
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          if (options.config) {
+            console.error(`Configuration file not found: ${configPath}`);
+            process.exit(1);
+          } else {
+            console.log(
+              `No configuration file found at default location: ${configPath}`
+            );
+            console.log(
+              "Use -c/--config to specify a config file or add-repo to create one."
+            );
+            process.exit(0);
+          }
+        }
+        throw error;
+      }
+
+      // Log config file location in debug mode
+      if (process.env.DEBUG) {
+        console.log(`Config file location: ${configPath}`);
+      }
+
+      // Get orchestrator URL from config or environment
+      const orchestratorUrl = config.orchestratorUrl || process.env.NORTHFLARE_ORCHESTRATOR_URL || "https://api.northflare.ai";
+
+      // Fetch runner ID
+      const runnerId = await fetchRunnerId(orchestratorUrl, token);
+      console.log(`Runner ID: ${runnerId}\n`);
+
+      // Ensure runnerRepos is properly structured
+      if (!config.runnerRepos || typeof config.runnerRepos !== "object") {
+        config.runnerRepos = {};
+      }
+
+      // Get repos for this runner
+      const repos = config.runnerRepos[runnerId] || [];
+
+      // List runner repos
+      if (repos.length > 0) {
+        console.log(`Found ${repos.length} runner repositories:`);
+        repos.forEach((repo, index) => {
+          console.log(
+            `${index + 1}. ${repo.name} (${repo.path})${
+              repo.uuid ? ` [UUID: ${repo.uuid}]` : ""
+            }`
+          );
+        });
+      } else {
+        console.log("No runner repositories configured for this runner.");
+      }
+
+      process.exit(0);
+    } catch (error) {
+      console.error("Error listing repositories:", error.message);
+      process.exit(1);
+    }
+  });
+
+// Create the add-repo command
+const addRepoCommand = new Command("add-repo")
+  .description("add a repository to the configuration")
+  .argument("<path>", "path to the repository")
+  .option(
+    "-c, --config <path>",
+    "path to configuration file (defaults to ~/.config/northflare-runner/config.json)"
+  )
+  .option("-n, --name <name>", "repository name (defaults to folder name)")
+  .option("--token <token>", "authentication token")
+  .action(async (repoPath, options, command) => {
+    try {
+      const fs = require("fs").promises;
+      const path = require("path");
+      const envPaths = require("env-paths").default || require("env-paths");
+      const crypto = require("crypto");
+
+      // Get token from command options, parent options, or environment
+      const token = options.token || command.parent?.opts().token || process.env.NORTHFLARE_RUNNER_TOKEN;
+      if (!token) {
+        console.error("Error: NORTHFLARE_RUNNER_TOKEN is required. Provide it via --token or environment variable.");
+        process.exit(1);
+      }
+
+      // Get default config path
+      const paths = envPaths("northflare-runner", { suffix: "" });
+
+      // Determine config path from command options, parent options, or default
+      const configOption = options.config || command.parent?.opts().config;
+      let configPath;
+      if (configOption) {
+        configPath = path.resolve(configOption);
+      } else {
+        configPath = path.join(paths.config, "config.json");
+        // Ensure config directory exists
+        await fs.mkdir(paths.config, { recursive: true });
+      }
+
+      // Load existing config
+      let config = {};
+      try {
+        const content = await fs.readFile(configPath, "utf-8");
+        config = JSON.parse(content);
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          console.log(
+            `Configuration file not found: ${configPath}. Creating new config file.`
+          );
+          config = {};
+        } else {
+          throw error;
+        }
+      }
+
+      // Log config file location in debug mode
+      if (process.env.DEBUG) {
+        console.log(`Config file location: ${configPath}`);
+      }
+
+      // Get orchestrator URL from config or environment
+      const orchestratorUrl = config.orchestratorUrl || process.env.NORTHFLARE_ORCHESTRATOR_URL || "https://api.northflare.ai";
+
+      // Fetch runner ID
+      const runnerId = await fetchRunnerId(orchestratorUrl, token);
+      console.log(`Runner ID: ${runnerId}`);
+
+      // Ensure runnerRepos is properly structured
+      if (!config.runnerRepos || typeof config.runnerRepos !== "object" || Array.isArray(config.runnerRepos)) {
+        config.runnerRepos = {};
+      }
+
+      // Initialize repos array for this runner if not present
+      if (!config.runnerRepos[runnerId] || !Array.isArray(config.runnerRepos[runnerId])) {
+        config.runnerRepos[runnerId] = [];
+      }
+
+      // Resolve the repository path
+      const absoluteRepoPath = path.resolve(repoPath);
+
+      // Check if path exists
+      try {
+        const stats = await fs.stat(absoluteRepoPath);
+        if (!stats.isDirectory()) {
+          console.error(`Error: ${absoluteRepoPath} is not a directory`);
+          process.exit(1);
+        }
+      } catch (error) {
+        console.error(
+          `Error: Repository path does not exist: ${absoluteRepoPath}`
+        );
+        process.exit(1);
+      }
+
+      // Check for duplicates
+      const duplicate = config.runnerRepos[runnerId].find(
+        (repo) => repo.path === absoluteRepoPath
+      );
+      if (duplicate) {
+        console.error(
+          `Error: Repository already exists in configuration: ${duplicate.name} (${duplicate.path})`
+        );
+        process.exit(1);
+      }
+
+      // Determine repository name
+      const repoName = options.name || path.basename(absoluteRepoPath);
+
+      // Generate UUID for the repository
+      const repoUuid = crypto.randomUUID();
+
+      // Add new repository
+      const newRepo = {
+        uuid: repoUuid,
+        name: repoName,
+        path: absoluteRepoPath,
+      };
+
+      config.runnerRepos[runnerId].push(newRepo);
+
+      // Save updated config
+      const { ConfigManager } = require("../dist/utils/config.js");
+      await ConfigManager.saveConfigFile(configPath, config);
+
+      console.log(
+        `Successfully added repository: ${repoName} (${absoluteRepoPath})`
+      );
+      console.log(`UUID: ${repoUuid}`);
+      console.log(`Total repositories for this runner: ${config.runnerRepos[runnerId].length}`);
+
+      process.exit(0);
+    } catch (error) {
+      console.error("Error adding repository:", error.message);
+      process.exit(1);
+    }
+  });
+
+// Set up the main program
+program
+  .name("northflare-runner")
+  .description("Distributed conversation runner for Northflare")
+  .version(pkg.version)
+  .option("--token <token>", "authentication token (can be used with any command)")
+  .option("-c, --config <path>", "path to configuration file (can be used with any command)")
+  .enablePositionalOptions()  // Allow options to be placed before or after positional arguments
+  .passThroughOptions()       // Pass options through to subcommands
+  .addCommand(startCommand, { isDefault: true })
+  .addCommand(validateCommand)
+  .addCommand(listReposCommand)
+  .addCommand(addRepoCommand);
+
+program.parse(process.argv);

package/coverage/base.css

@@ -0,0 +1,224 @@
+body, html {
+  margin:0; padding: 0;
+  height: 100%;
+}
+body {
+    font-family: Helvetica Neue, Helvetica, Arial;
+    font-size: 14px;
+    color:#333;
+}
+.small { font-size: 12px; }
+*, *:after, *:before {
+  -webkit-box-sizing:border-box;
+     -moz-box-sizing:border-box;
+          box-sizing:border-box;
+  }
+h1 { font-size: 20px; margin: 0;}
+h2 { font-size: 14px; }
+pre {
+    font: 12px/1.4 Consolas, "Liberation Mono", Menlo, Courier, monospace;
+    margin: 0;
+    padding: 0;
+    -moz-tab-size: 2;
+    -o-tab-size:  2;
+    tab-size: 2;
+}
+a { color:#0074D9; text-decoration:none; }
+a:hover { text-decoration:underline; }
+.strong { font-weight: bold; }
+.space-top1 { padding: 10px 0 0 0; }
+.pad2y { padding: 20px 0; }
+.pad1y { padding: 10px 0; }
+.pad2x { padding: 0 20px; }
+.pad2 { padding: 20px; }
+.pad1 { padding: 10px; }
+.space-left2 { padding-left:55px; }
+.space-right2 { padding-right:20px; }
+.center { text-align:center; }
+.clearfix { display:block; }
+.clearfix:after {
+  content:'';
+  display:block;
+  height:0;
+  clear:both;
+  visibility:hidden;
+  }
+.fl { float: left; }
+@media only screen and (max-width:640px) {
+  .col3 { width:100%; max-width:100%; }
+  .hide-mobile { display:none!important; }
+}
+
+.quiet {
+  color: #7f7f7f;
+  color: rgba(0,0,0,0.5);
+}
+.quiet a { opacity: 0.7; }
+
+.fraction {
+  font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace;
+  font-size: 10px;
+  color: #555;
+  background: #E8E8E8;
+  padding: 4px 5px;
+  border-radius: 3px;
+  vertical-align: middle;
+}
+
+div.path a:link, div.path a:visited { color: #333; }
+table.coverage {
+  border-collapse: collapse;
+  margin: 10px 0 0 0;
+  padding: 0;
+}
+
+table.coverage td {
+  margin: 0;
+  padding: 0;
+  vertical-align: top;
+}
+table.coverage td.line-count {
+    text-align: right;
+    padding: 0 5px 0 20px;
+}
+table.coverage td.line-coverage {
+    text-align: right;
+    padding-right: 10px;
+    min-width:20px;
+}
+
+table.coverage td span.cline-any {
+    display: inline-block;
+    padding: 0 5px;
+    width: 100%;
+}
+.missing-if-branch {
+    display: inline-block;
+    margin-right: 5px;
+    border-radius: 3px;
+    position: relative;
+    padding: 0 4px;
+    background: #333;
+    color: yellow;
+}
+
+.skip-if-branch {
+    display: none;
+    margin-right: 10px;
+    position: relative;
+    padding: 0 4px;
+    background: #ccc;
+    color: white;
+}
+.missing-if-branch .typ, .skip-if-branch .typ {
+    color: inherit !important;
+}
+.coverage-summary {
+  border-collapse: collapse;
+  width: 100%;
+}
+.coverage-summary tr { border-bottom: 1px solid #bbb; }
+.keyline-all { border: 1px solid #ddd; }
+.coverage-summary td, .coverage-summary th { padding: 10px; }
+.coverage-summary tbody { border: 1px solid #bbb; }
+.coverage-summary td { border-right: 1px solid #bbb; }
+.coverage-summary td:last-child { border-right: none; }
+.coverage-summary th {
+  text-align: left;
+  font-weight: normal;
+  white-space: nowrap;
+}
+.coverage-summary th.file { border-right: none !important; }
+.coverage-summary th.pct { }
+.coverage-summary th.pic,
+.coverage-summary th.abs,
+.coverage-summary td.pct,
+.coverage-summary td.abs { text-align: right; }
+.coverage-summary td.file { white-space: nowrap;  }
+.coverage-summary td.pic { min-width: 120px !important;  }
+.coverage-summary tfoot td { }
+
+.coverage-summary .sorter {
+    height: 10px;
+    width: 7px;
+    display: inline-block;
+    margin-left: 0.5em;
+    background: url(sort-arrow-sprite.png) no-repeat scroll 0 0 transparent;
+}
+.coverage-summary .sorted .sorter {
+    background-position: 0 -20px;
+}
+.coverage-summary .sorted-desc .sorter {
+    background-position: 0 -10px;
+}
+.status-line {  height: 10px; }
+/* yellow */
+.cbranch-no { background: yellow !important; color: #111; }
+/* dark red */
+.red.solid, .status-line.low, .low .cover-fill { background:#C21F39 }
+.low .chart { border:1px solid #C21F39 }
+.highlighted,
+.highlighted .cstat-no, .highlighted .fstat-no, .highlighted .cbranch-no{
+  background: #C21F39 !important;
+}
+/* medium red */
+.cstat-no, .fstat-no, .cbranch-no, .cbranch-no { background:#F6C6CE }
+/* light red */
+.low, .cline-no { background:#FCE1E5 }
+/* light green */
+.high, .cline-yes { background:rgb(230,245,208) }
+/* medium green */
+.cstat-yes { background:rgb(161,215,106) }
+/* dark green */
+.status-line.high, .high .cover-fill { background:rgb(77,146,33) }
+.high .chart { border:1px solid rgb(77,146,33) }
+/* dark yellow (gold) */
+.status-line.medium, .medium .cover-fill { background: #f9cd0b; }
+.medium .chart { border:1px solid #f9cd0b; }
+/* light yellow */
+.medium { background: #fff4c2; }
+
+.cstat-skip { background: #ddd; color: #111; }
+.fstat-skip { background: #ddd; color: #111 !important; }
+.cbranch-skip { background: #ddd !important; color: #111; }
+
+span.cline-neutral { background: #eaeaea; }
+
+.coverage-summary td.empty {
+    opacity: .5;
+    padding-top: 4px;
+    padding-bottom: 4px;
+    line-height: 1;
+    color: #888;
+}
+
+.cover-fill, .cover-empty {
+  display:inline-block;
+  height: 12px;
+}
+.chart {
+  line-height: 0;
+}
+.cover-empty {
+    background: white;
+}
+.cover-full {
+    border-right: none !important;
+}
+pre.prettyprint {
+    border: none !important;
+    padding: 0 !important;
+    margin: 0 !important;
+}
+.com { color: #999 !important; }
+.ignore-none { color: #999; font-weight: normal; }
+
+.wrapper {
+  min-height: 100%;
+  height: auto !important;
+  height: 100%;
+  margin: 0 auto -48px;
+}
+.footer, .push {
+  height: 48px;
+}

package/coverage/block-navigation.js

@@ -0,0 +1,87 @@
+/* eslint-disable */
+var jumpToCode = (function init() {
+    // Classes of code we would like to highlight in the file view
+    var missingCoverageClasses = ['.cbranch-no', '.cstat-no', '.fstat-no'];
+
+    // Elements to highlight in the file listing view
+    var fileListingElements = ['td.pct.low'];
+
+    // We don't want to select elements that are direct descendants of another match
+    var notSelector = ':not(' + missingCoverageClasses.join('):not(') + ') > '; // becomes `:not(a):not(b) > `
+
+    // Selecter that finds elements on the page to which we can jump
+    var selector =
+        fileListingElements.join(', ') +
+        ', ' +
+        notSelector +
+        missingCoverageClasses.join(', ' + notSelector); // becomes `:not(a):not(b) > a, :not(a):not(b) > b`
+
+    // The NodeList of matching elements
+    var missingCoverageElements = document.querySelectorAll(selector);
+
+    var currentIndex;
+
+    function toggleClass(index) {
+        missingCoverageElements
+            .item(currentIndex)
+            .classList.remove('highlighted');
+        missingCoverageElements.item(index).classList.add('highlighted');
+    }
+
+    function makeCurrent(index) {
+        toggleClass(index);
+        currentIndex = index;
+        missingCoverageElements.item(index).scrollIntoView({
+            behavior: 'smooth',
+            block: 'center',
+            inline: 'center'
+        });
+    }
+
+    function goToPrevious() {
+        var nextIndex = 0;
+        if (typeof currentIndex !== 'number' || currentIndex === 0) {
+            nextIndex = missingCoverageElements.length - 1;
+        } else if (missingCoverageElements.length > 1) {
+            nextIndex = currentIndex - 1;
+        }
+
+        makeCurrent(nextIndex);
+    }
+
+    function goToNext() {
+        var nextIndex = 0;
+
+        if (
+            typeof currentIndex === 'number' &&
+            currentIndex < missingCoverageElements.length - 1
+        ) {
+            nextIndex = currentIndex + 1;
+        }
+
+        makeCurrent(nextIndex);
+    }
+
+    return function jump(event) {
+        if (
+            document.getElementById('fileSearch') === document.activeElement &&
+            document.activeElement != null
+        ) {
+            // if we're currently focused on the search input, we don't want to navigate
+            return;
+        }
+
+        switch (event.which) {
+            case 78: // n
+            case 74: // j
+                goToNext();
+                break;
+            case 66: // b
+            case 75: // k
+            case 80: // p
+                goToPrevious();
+                break;
+        }
+    };
+})();
+window.addEventListener('keydown', jumpToCode);