halo-agent 2.2.2 → 2.2.3

package/index.js

@@ -38,14 +38,18 @@ async function main() {
     let v = '';
     try { v = require('./package.json').version; } catch {}
     ui.banner(v);
+    console.log(`  ${ui.bold('Usage')}  ${ui.gray('halo-agent <command>')}`);
     console.log('');
-    console.log(`  ${ui.bold('Usage')}`);
-    console.log(`    ${ui.cyan('halo-agent pair')} ${ui.gray('<code>')}            One-click pair with the dashboard`);
-    console.log(`    ${ui.cyan('halo-agent start')}                   Start the agent`);
-    console.log(`    ${ui.cyan('halo-agent install-autostart')}       Auto-start at login`);
-    console.log(`    ${ui.cyan('halo-agent uninstall-autostart')}     Remove login auto-start`);
-    console.log(`    ${ui.cyan('halo-agent init')}                    First-time setup (legacy: token paste)`);
-    console.log(`    ${ui.cyan('halo-agent token')} ${ui.gray('<value>')}          Update auth token`);
+    ui.commandTable([
+      ['pair <code>',           'One-click pair with the HALO dashboard'],
+      ['start',                 'Connect to Chrome and run the agent'],
+      ['install-autostart',     'Run automatically at every login'],
+      ['uninstall-autostart',   'Remove the login auto-start'],
+      ['init',                  'First-time setup (legacy token paste)'],
+      ['token <value>',         'Update the auth token'],
+    ]);
+    console.log('');
+    ui.hint('Get a pairing code: HALO dashboard → Profile → Auto-apply agent → Get pairing code.');
     console.log('');
     process.exit(1);
   }
@@ -123,7 +127,8 @@ async function runPair(code) {
   spin.stop(`Paired with HALO`);
   ui.muted(`  Token saved to ~/.halo-agent/config.json`);
   console.log('');
-  console.log(`  ${ui.gray('Next:')} ${ui.cyan('halo-agent start')}`);
+  ui.nextStep('halo-agent start', 'connect Chrome and start applying');
+  ui.hint('Or `halo-agent install-autostart` to run it at every login.');
   console.log('');
 }
 
@@ -308,7 +313,7 @@ async function runInit() {
   saveConfig(config);
   console.log('');
   ui.success('Config saved to ~/.halo-agent/config.json');
-  console.log(`  ${ui.gray('Next:')} ${ui.cyan('halo-agent start')}`);
+  ui.nextStep('halo-agent start', 'connect Chrome and start applying');
   console.log('');
 }
 
@@ -467,8 +472,8 @@ async function waitForChromeGone(timeoutMs) {
 async function runStart() {
   const config = loadConfig();
   if (!config || !config.token) {
-    ui.fail('No config found.');
-    console.log(`  ${ui.gray('Run')} ${ui.cyan('halo-agent pair <code>')} ${ui.gray('first. Get a code from the HALO dashboard.')}`);
+    ui.fail('Not paired yet — no config found.');
+    ui.nextStep('halo-agent pair <code>', 'get a code from the HALO dashboard');
     process.exit(1);
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "halo-agent",
-  "version": "2.2.2",
+  "version": "2.2.3",
   "description": "HALO local apply agent — auto-fills job applications using your real Chrome session",
   "main": "index.js",
   "bin": {

package/poller.js

@@ -15,7 +15,8 @@ let sessionId = null;
 
 async function startPolling(chromeConn, config) {
   ui.success('Listening for jobs');
-  ui.muted(`  Polling every 5s. ${ui.cyan('Ctrl-C')} to stop.`);
+  ui.hint(`Queue one from HALO: a job's prep page → Approve & send to agent.`);
+  ui.muted(`  Polling every 5s · ${ui.cyan('Ctrl-C')} to stop`);
   console.log('');
 
   // Register agent session with backend

package/ui.js

@@ -41,15 +41,56 @@ const warn    = (msg) => console.log(`${yellow('!')} ${msg}`);
 const muted   = (msg) => console.log(gray(msg));
 const step    = (msg) => console.log(`${gray(sym.dot)} ${msg}`);
 
-// Banner shown on `start`. Three lines so it has presence on camera without
-// being a giant ASCII-art block that ages badly.
+// Strip ANSI so box math measures the VISIBLE width, not the escape-padded
+// string length. Without this, colored content overflows the box border.
+const STRIP_ANSI = /\x1b\[[0-9;]*m/g;
+const visLen = (s) => String(s).replace(STRIP_ANSI, '').length;
+
+// Box-drawing glyphs (rounded). ASCII fallback on legacy Windows terminals.
+const box = (process.platform === 'win32' && !process.env.WT_SESSION)
+  ? { tl: '+', tr: '+', bl: '+', br: '+', h: '-', v: '|' }
+  : { tl: '╭', tr: '╮', bl: '╰', br: '╯', h: '─', v: '│' };
+
+// The compact boxed wordmark. Ember mark + tagline + version, in a rounded
+// box — the Vercel/Bun look. Reads well on camera and in a small terminal,
+// and ages better than big ASCII art. The ⬢ is HALO's hex mark.
 function banner(version) {
-  const v = version ? gray(`v${version}`) : '';
-  const line = gray('─'.repeat(40));
+  const mark = `${ember('⬢')} ${ember(bold('HALO'))}`;
+  const ver  = version ? `${gray('agent')} ${gray('v' + version)}` : gray('agent');
+  // Two content lines.
+  const line1 = `${mark}  ${gray('·')}  ${ver}`;
+  const line2 = gray('auto-apply, in your own Chrome');
+  const inner = Math.max(visLen(line1), visLen(line2)) + 2; // 1 space padding each side
+  const pad = (s) => ' ' + s + ' '.repeat(inner - visLen(s) - 1);
+  const top = gray(box.tl + box.h.repeat(inner) + box.tr);
+  const bot = gray(box.bl + box.h.repeat(inner) + box.br);
+  const bar = gray(box.v);
+  console.log('');
+  console.log(`  ${top}`);
+  console.log(`  ${bar}${pad(line1)}${bar}`);
+  console.log(`  ${bar}${pad(line2)}${bar}`);
+  console.log(`  ${bot}`);
   console.log('');
-  console.log(`  ${ember(bold('HALO'))} ${bold('Agent')}  ${v}`);
-  console.log(`  ${gray('Auto-apply, in your own Chrome.')}`);
-  console.log(`  ${line}`);
+}
+
+// Affordance helper: the obvious next command, rendered consistently so the
+// user always knows what to type next. Shown after pair/init/etc.
+function nextStep(cmd, note) {
+  const tail = note ? `   ${gray(note)}` : '';
+  console.log(`  ${gray('Next')} ${gray(sym.arrow)} ${cyan(cmd)}${tail}`);
+}
+
+// A hint line — softer than nextStep, for "you can also…" affordances.
+function hint(msg) {
+  console.log(`  ${gray(sym.dot)} ${gray(msg)}`);
+}
+
+// Aligned command table for the usage screen. rows: [[cmd, desc], ...].
+function commandTable(rows) {
+  const w = Math.max(...rows.map(([c]) => c.length));
+  for (const [cmd, desc] of rows) {
+    console.log(`    ${cyan(cmd.padEnd(w))}   ${gray(desc)}`);
+  }
 }
 
 // Lightweight spinner for waiting states ("Connecting to Chrome..."). Frames
@@ -81,5 +122,6 @@ function spinner(message) {
 
 module.exports = {
   bold, dim, red, green, yellow, blue, magenta, cyan, gray, ember,
-  sym, success, fail, info, warn, muted, step, banner, spinner,
+  sym, success, fail, info, warn, muted, step,
+  banner, spinner, nextStep, hint, commandTable, visLen,
 };