knoxis-helper 1.0.0

package/bin/knoxis-helper.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+
+/**
+ * Knoxis Helper - First-time setup + local agent launcher
+ *
+ * Usage:
+ *   npx knoxis-helper                     # Interactive setup (first time)
+ *   npx knoxis-helper --backend wss://...  # Connect to specific backend
+ *   npx knoxis-helper --status             # Check connection status
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const readline = require('readline');
+
+const CONFIG_DIR = path.join(os.homedir(), '.knoxis');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const DEFAULT_BACKEND = 'wss://voice-backend.qig.ai';
+
+function loadConfig() {
+  try {
+    if (fs.existsSync(CONFIG_FILE)) {
+      return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+    }
+  } catch (e) {}
+  return {};
+}
+
+function saveConfig(config) {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+function parseArgs() {
+  const args = {};
+  for (let i = 2; i < process.argv.length; i++) {
+    const arg = process.argv[i];
+    if (arg === '--status') { args.status = true; continue; }
+    if (arg === '--reset') { args.reset = true; continue; }
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2);
+      const next = process.argv[i + 1];
+      if (next && !next.startsWith('--')) {
+        args[key] = next;
+        i++;
+      } else {
+        args[key] = true;
+      }
+    }
+  }
+  return args;
+}
+
+function ask(rl, question) {
+  return new Promise(resolve => rl.question(question, resolve));
+}
+
+async function firstTimeSetup(args) {
+  const config = loadConfig();
+
+  console.log('');
+  console.log('  Knoxis Helper - First Time Setup');
+  console.log('  ================================');
+  console.log('');
+  console.log('  This connects your machine to Knoxis so it can');
+  console.log('  open terminals and run pair programming sessions.');
+  console.log('');
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  // Backend URL
+  let backend = args.backend || config.backendWsUrl;
+  if (!backend) {
+    const answer = await ask(rl, `  Backend URL [${DEFAULT_BACKEND}]: `);
+    backend = answer.trim() || DEFAULT_BACKEND;
+  }
+
+  // Normalize - ensure ws/wss protocol
+  if (backend.startsWith('http://')) {
+    backend = backend.replace('http://', 'ws://');
+  } else if (backend.startsWith('https://')) {
+    backend = backend.replace('https://', 'wss://');
+  } else if (!backend.startsWith('ws://') && !backend.startsWith('wss://')) {
+    backend = 'wss://' + backend;
+  }
+
+  // User ID
+  let userId = args.userId || args.user || config.userId;
+  if (!userId) {
+    console.log('');
+    console.log('  Your user ID is on your profile page at qig.ai/settings.');
+    const answer = await ask(rl, '  User ID: ');
+    userId = answer.trim();
+
+    if (!userId) {
+      console.error('  User ID is required. Find it at qig.ai/settings.');
+      rl.close();
+      process.exit(1);
+    }
+  }
+
+  rl.close();
+
+  // Save config
+  config.backendWsUrl = backend;
+  config.userId = userId;
+  config.configuredAt = new Date().toISOString();
+  saveConfig(config);
+
+  console.log('');
+  console.log('  Configuration saved to ~/.knoxis/config.json');
+  console.log(`  Backend: ${backend}`);
+  console.log(`  User:    ${userId}`);
+  console.log('');
+
+  return config;
+}
+
+async function main() {
+  const args = parseArgs();
+
+  // Reset
+  if (args.reset) {
+    try { fs.unlinkSync(CONFIG_FILE); } catch (e) {}
+    console.log('Configuration cleared. Run again to set up.');
+    process.exit(0);
+  }
+
+  // Status check
+  if (args.status) {
+    const config = loadConfig();
+    if (!config.backendWsUrl || !config.userId) {
+      console.log('Not configured. Run: npx knoxis-helper');
+    } else {
+      console.log('Configured:');
+      console.log(`  Backend: ${config.backendWsUrl}`);
+      console.log(`  User:    ${config.userId}`);
+    }
+    process.exit(0);
+  }
+
+  // Load or create config
+  let config = loadConfig();
+  const needsSetup = !config.backendWsUrl || !config.userId || args.backend || args.userId;
+
+  if (needsSetup) {
+    config = await firstTimeSetup(args);
+  } else {
+    console.log('');
+    console.log(`  Knoxis Helper - Connecting to ${config.backendWsUrl}`);
+    console.log(`  User: ${config.userId}`);
+    console.log('');
+  }
+
+  // Set environment variables for the local agent
+  process.env.KNOXIS_BACKEND_WS_URL = config.backendWsUrl;
+  process.env.KNOXIS_USER_ID = config.userId;
+
+  // Launch the local agent
+  // Try to find it in common locations
+  const agentLocations = [
+    path.join(__dirname, '..', 'lib', 'knoxis-local-agent.js'),
+    path.join(__dirname, '..', '..', 'knoxis-local-agent.js'),
+    path.join(process.cwd(), 'scripts', 'knoxis-local-agent.js'),
+  ];
+
+  let agentPath = null;
+  for (const loc of agentLocations) {
+    if (fs.existsSync(loc)) {
+      agentPath = loc;
+      break;
+    }
+  }
+
+  if (!agentPath) {
+    console.error('Could not find knoxis-local-agent.js.');
+    console.error('Expected in:', agentLocations.map(l => '  ' + l).join('\n'));
+    process.exit(1);
+  }
+
+  // Load and execute the agent in the same process
+  require(agentPath);
+}
+
+main().catch(err => {
+  console.error('Error:', err.message);
+  process.exit(1);
+});