vibecarbon 0.1.0

package/src/console.js

@@ -0,0 +1,155 @@
+/**
+ * `vibecarbon console <node>`
+ *
+ * Last-resort debug helper: opens the Hetzner web VNC console for a
+ * server. Useful when SSH is broken (firewall change, cloud-init
+ * failure, kernel panic) and the only way to see what the node is
+ * doing is through Hetzner's out-of-band console.
+ *
+ * The node argument is a substring matched against server names — most
+ * common is the project-name+role suffix, e.g. `master`, `supabase`,
+ * `worker-1`, or the full server name.
+ *
+ * Tries `hcloud server request-console` (which prints the noVNC URL
+ * directly) when available; otherwise falls back to printing the
+ * Hetzner Cloud Console URL and the server ID so the operator can
+ * click through. Does NOT auto-open a browser — the operator may be
+ * remote/headless; printing the URL is the lowest-friction path.
+ */
+
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { renderHelp } from './lib/cli/help.js';
+import { parseFlags } from './lib/cli/parse-flags.js';
+import { c } from './lib/colors.js';
+
+/** @type {import('./lib/cli/parse-flags.js').CommandSpec & { summary?: string, examples?: Array<{ command: string, description?: string }> }} */
+const SPEC = {
+  name: 'console',
+  summary: "Open Hetzner's web VNC console for a node",
+  positional: [
+    {
+      name: 'node',
+      description:
+        'Substring of a server name (e.g. "master", "supabase", or a full name like "myproject-prod-master")',
+    },
+  ],
+  flags: [{ name: 'h', boolean: true, description: 'Show this help' }],
+  examples: [
+    {
+      command: 'vibecarbon console master',
+      description: 'opens the noVNC URL for the master node (kernel-boot debug)',
+    },
+  ],
+};
+
+function loadHcloudToken() {
+  const credPath = join(homedir(), '.vibecarbon', 'credentials.json');
+  if (!existsSync(credPath)) return null;
+  try {
+    const data = JSON.parse(readFileSync(credPath, 'utf-8'));
+    return data?.hetzner?.apiToken ?? data?.hetznerApiToken ?? null;
+  } catch {
+    return null;
+  }
+}
+
+export async function run(args) {
+  // No-args invocation prints help and exits 1 (the legacy behavior —
+  // console requires a node substring; no useful default).
+  if (args.length === 0) {
+    process.stdout.write(renderHelp(SPEC));
+    process.exit(1);
+  }
+
+  const { values, positional, errors } = parseFlags(args, SPEC);
+
+  if (errors.length > 0) {
+    for (const e of errors) {
+      process.stderr.write(`${c.error('✗')} ${e}\n`);
+    }
+    process.stderr.write(`Run ${c.info('vibecarbon console -h')} for usage.\n`);
+    process.exit(1);
+  }
+
+  if (values.h) {
+    process.stdout.write(renderHelp(SPEC));
+    process.exit(0);
+  }
+
+  const needle = /** @type {string|undefined} */ (positional.node);
+  if (!needle) {
+    console.error(c.error('Error: server name or substring is required'));
+    process.stdout.write(renderHelp(SPEC));
+    process.exit(1);
+  }
+
+  const token = loadHcloudToken();
+  if (!token) {
+    console.error(c.error('Error: HCLOUD_TOKEN not found in ~/.vibecarbon/credentials.json'));
+    process.exit(1);
+  }
+
+  const env = { ...process.env, HCLOUD_TOKEN: token };
+
+  // Resolve the node substring → server ID via hcloud CLI.
+  let serversJson;
+  try {
+    serversJson = execFileSync('hcloud', ['server', 'list', '-o', 'json'], {
+      env,
+      encoding: 'utf-8',
+      stdio: ['ignore', 'pipe', 'pipe'],
+    });
+  } catch (err) {
+    console.error(c.error('Failed to query hcloud server list:'));
+    console.error(err.message ?? err);
+    process.exit(1);
+  }
+
+  let servers;
+  try {
+    servers = JSON.parse(serversJson);
+  } catch {
+    console.error(c.error('hcloud returned non-JSON output; is hcloud >= 1.30 installed?'));
+    process.exit(1);
+  }
+
+  const matches = servers.filter((s) => s.name?.includes(needle));
+  if (matches.length === 0) {
+    console.error(c.error(`No server matched "${needle}".`));
+    console.error('Servers in this project:');
+    for (const s of servers) console.error(`  - ${s.name} (${s.id})`);
+    process.exit(1);
+  }
+  if (matches.length > 1) {
+    console.error(c.warning(`Ambiguous match — ${matches.length} servers matched "${needle}":`));
+    for (const s of matches) console.error(`  - ${s.name} (${s.id})`);
+    console.error('Re-run with a more specific substring or the exact name.');
+    process.exit(1);
+  }
+
+  const server = matches[0];
+  console.log(`${c.bold('Server:')}  ${server.name} (id=${server.id})`);
+
+  // Try `hcloud server request-console` first — gives a direct noVNC URL.
+  try {
+    const consoleOut = execFileSync(
+      'hcloud',
+      ['server', 'request-console', String(server.id), '-o', 'json'],
+      { env, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] },
+    );
+    const data = JSON.parse(consoleOut);
+    console.log(`${c.bold('noVNC URL:')} ${data.wss_url ?? '(none returned)'}`);
+    console.log(`${c.bold('Password:')}  ${data.password ?? '(none)'}`);
+    console.log('');
+    console.log(c.dim('Paste the URL into a noVNC client, or use the Hetzner web console.'));
+  } catch {
+    // Fallback: print the Hetzner Cloud Console URL.
+    console.log(
+      `${c.bold('Open in Hetzner Cloud Console:')} https://console.hetzner.cloud/projects/_/servers/${server.id}/graphics`,
+    );
+    console.log(c.dim('(Replace `_` with your project ID — visible in the URL when logged in.)'));
+  }
+}