atris 3.57.3 → 3.58.5

package/commands/engine.js

@@ -22,6 +22,7 @@ const { Writable } = require('stream');
 const {
   RUNNER_PROFILE_DEFS,
   RUNNER_PROFILE_NAMES,
+  HIDDEN_PROFILE_NAMES,
   buildRunnerCommand,
 } = require('../lib/runner-command');
 const { parseScopeFlag } = require('../lib/cli-scope');
@@ -124,10 +125,12 @@ function resolveDefaultEngine(root = process.cwd()) {
 
 function roster(root = process.cwd()) {
   const current = resolveDefaultEngine(root);
-  return engineRegistryView(root).map((engine) => ({
-    ...engine,
-    default: engine.id === current.name,
-  }));
+  return engineRegistryView(root)
+    .filter((engine) => !HIDDEN_PROFILE_NAMES.includes(engine.id))
+    .map((engine) => ({
+      ...engine,
+      default: engine.id === current.name,
+    }));
 }
 
 function setEngine(name, root = process.cwd()) {
@@ -932,13 +935,16 @@ function printRoster(root, { scope = 'workspace' } = {}) {
   console.log('');
 }
 
-function registryPayload(root, { scope = 'workspace' } = {}) {
+function registryPayload(root, { scope = 'workspace', includeHidden = false } = {}) {
   const current = resolveDefaultEngine(root);
   const registry = readEngineRegistry(root);
-  const engines = registry.engines.map((engine) => ({
-    ...engine,
-    default: engine.id === current.name,
-  }));
+  const engines = registry.engines
+    .map((engine) => ({
+      ...engine,
+      hidden: HIDDEN_PROFILE_NAMES.includes(engine.id),
+      default: engine.id === current.name,
+    }))
+    .filter((engine) => includeHidden || !engine.hidden);
   const scoped = scope === 'global'
     ? engines
     : engines.filter((engine) => engine.installed || engine.default || (engine.health && engine.health.status === 'ready'));
@@ -978,7 +984,8 @@ function centerChartLine(line, width, center = Math.floor((width - 1) / 2)) {
 }
 
 function renderEngineChart(registry) {
-  const engines = Array.isArray(registry) ? registry : ((registry && registry.engines) || []);
+  const engines = (Array.isArray(registry) ? registry : ((registry && registry.engines) || []))
+    .filter((entry) => !HIDDEN_PROFILE_NAMES.includes(entry.id));
   const specialDuties = new Set(ENGINE_DUTIES);
   const leaders = engines.filter((entry) => entry.duty === 'leader');
   const rolePool = engines.filter((entry) => !specialDuties.has(entry.duty));
@@ -1158,7 +1165,7 @@ function runDoctorCommand(args, root) {
     return 0;
   }
   console.log('');
-  for (const engine of engines) {
+  for (const engine of engines.filter((engine) => !HIDDEN_PROFILE_NAMES.includes(engine.id))) {
     const state = engine.installed ? 'installed' : 'missing';
     const health = engine.health.status.replace(/_/g, ' ');
     console.log(`  ${engine.id.padEnd(12)} ${String(engine.bin).padEnd(14)} ${state.padEnd(10)} health: ${health}`);
@@ -1301,6 +1308,147 @@ function writeProbeReceipt(result, root = process.cwd()) {
   }
 }
 
+function runBenchCommand(args, root, deps = {}) {
+  const probe = deps.probe || probeEngine;
+
+  const names = [];
+  let runs = 3;
+  let timeout;
+  let json = false;
+
+  for (let i = 0; i < args.length; i += 1) {
+    const a = args[i];
+    if (a === '--runs') { runs = parseInt(args[i + 1] || '3', 10); i += 1; continue; }
+    if (a.startsWith('--runs=')) { runs = parseInt(a.slice('--runs='.length), 10); continue; }
+    if (a === '--timeout') { timeout = parseInt(args[i + 1] || '0', 10) * 1000; i += 1; continue; }
+    if (a.startsWith('--timeout=')) { timeout = parseInt(a.slice('--timeout='.length), 10) * 1000; continue; }
+    if (a === '--json') { json = true; continue; }
+    if (a.startsWith('--')) continue;
+    names.push(a);
+  }
+
+  let enginesToBench;
+  if (names.length) {
+    enginesToBench = names.map((n) => {
+      const c = canonicalEngineName(n);
+      if (!c) {
+        throw new Error(`Unknown engine "${n}". Known engines: ${RUNNER_PROFILE_NAMES.join(', ')}`);
+      }
+      return c;
+    });
+  } else {
+    enginesToBench = deps.installedEngines || RUNNER_PROFILE_NAMES.filter((n) => binInstalled(RUNNER_PROFILE_DEFS[n].bin));
+    if (!enginesToBench.length) {
+      if (json) {
+        console.log(JSON.stringify({ ok: false, error: 'no installed engines to bench' }, null, 2));
+      } else {
+        console.error('\n  no installed engines to bench\n');
+      }
+      return 1;
+    }
+  }
+
+  const probeOpts = {};
+  if (timeout) probeOpts.timeout = timeout;
+
+  const results = [];
+  let allHavePasses = true;
+
+  for (const engine of enginesToBench) {
+    const passedRuns = [];
+    let passes = 0;
+    for (let i = 0; i < runs; i += 1) {
+      const res = probe(engine, probeOpts);
+      if (res.pass) {
+        passedRuns.push(res.durationMs);
+        passes += 1;
+      }
+    }
+
+    let medianMs = 0;
+    let minMs = 0;
+    let maxMs = 0;
+
+    if (passes > 0) {
+      passedRuns.sort((a, b) => a - b);
+      minMs = passedRuns[0];
+      maxMs = passedRuns[passedRuns.length - 1];
+      const mid = Math.floor(passes / 2);
+      medianMs = passes % 2 !== 0 ? passedRuns[mid] : (passedRuns[mid - 1] + passedRuns[mid]) / 2;
+    } else {
+      allHavePasses = false;
+    }
+
+    results.push({
+      engine,
+      passes,
+      runs,
+      medianMs,
+      minMs,
+      maxMs,
+    });
+  }
+
+  results.sort((a, b) => {
+    if (a.passes === 0 && b.passes !== 0) return 1;
+    if (b.passes === 0 && a.passes !== 0) return -1;
+    if (a.passes === 0 && b.passes === 0) return a.engine.localeCompare(b.engine);
+    return a.medianMs - b.medianMs;
+  });
+
+  const stateFile = path.join(root, '.atris', 'state', 'engine-bench.latest.json');
+  let previous = null;
+  try {
+    if (fs.existsSync(stateFile)) {
+      previous = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+    }
+  } catch {
+    // best-effort read
+  }
+
+  const stateObj = {
+    at: new Date().toISOString(),
+    runs,
+    results,
+  };
+
+  try {
+    fs.mkdirSync(path.dirname(stateFile), { recursive: true });
+    fs.writeFileSync(stateFile, `${JSON.stringify(stateObj, null, 2)}\n`);
+  } catch {
+    // best-effort write
+  }
+
+  if (json) {
+    console.log(JSON.stringify({ ...stateObj, previous }, null, 2));
+    return allHavePasses ? 0 : 1;
+  }
+
+  console.log('');
+  for (const r of results) {
+    let deltaStr = '';
+    if (previous && previous.results) {
+      const prevRes = previous.results.find((pr) => pr.engine === r.engine);
+      if (prevRes && prevRes.passes > 0 && r.passes > 0) {
+        const diff = Math.round(r.medianMs - prevRes.medianMs);
+        if (diff > 0) deltaStr = ` (slower by ${diff}ms)`;
+        else if (diff < 0) deltaStr = ` (faster by ${Math.abs(diff)}ms)`;
+        else deltaStr = ' (no change)';
+      }
+    }
+
+    if (r.passes > 0) {
+      const ms = Math.round(r.medianMs);
+      console.log(`  ${r.engine.padEnd(12)} ${r.passes}/${r.runs} passes, median ${ms}ms${deltaStr}`);
+    } else {
+      console.error(`  ${r.engine.padEnd(12)} FAIL, 0/${r.runs} passes`);
+    }
+  }
+  console.log('');
+
+  return allHavePasses ? 0 : 1;
+}
+
 function runEngineTest(targets, { json, root } = {}) {
   let enginesToTest;
   if (targets && targets.length) {
@@ -1344,8 +1492,8 @@ function runEngineTest(targets, { json, root } = {}) {
     for (const r of results) {
       const mark = r.pass ? '✓' : '✗';
       const line = r.pass
-        ? `  ${mark} ${r.engine.padEnd(12)} pass — ${r.message} (${r.durationMs}ms)`
-        : `  ${mark} ${r.engine.padEnd(12)} FAIL — ${r.message}`;
+        ? `  ${mark} ${r.engine.padEnd(12)} pass, ${r.message} (${r.durationMs}ms)`
+        : `  ${mark} ${r.engine.padEnd(12)} FAIL, ${r.message}`;
       if (r.pass) console.log(line);
       else console.error(line);
     }
@@ -1354,7 +1502,7 @@ function runEngineTest(targets, { json, root } = {}) {
       console.error(`  ${failures.length} engine${failures.length === 1 ? '' : 's'} failed: ${failures.map((f) => f.engine).join(', ')}`);
       console.error(`  fix the login/binary, then re-run: atris engine test${targets && targets.length ? ' ' + targets.join(' ') : ''}`);
     } else {
-      console.log(`  all engines responded — clear for flight`);
+      console.log(`  all engines responded, clear for flight`);
     }
     console.log('');
   }
@@ -1525,6 +1673,10 @@ function engineCommand(args = [], deps = {}) {
     return runEngineTest(positional.slice(1), { json, root });
   }
 
+  if (sub === 'bench') {
+    return runBenchCommand(scope.args.slice(scope.args.indexOf('bench') + 1), root, deps);
+  }
+
   if (sub === 'resolve') {
     return runResolveCommand(scope.args.slice(scope.args.indexOf('resolve') + 1), root);
   }
@@ -1552,14 +1704,15 @@ function engineCommand(args = [], deps = {}) {
   if (!sub || sub === 'list' || sub === 'status' || sub === 'help') {
     if (sub === 'help' || args.includes('--help') || args.includes('-h')) {
       console.log('\n  atris engine watch [<id>|latest] [--no-follow]\n                           follow one live transcript or list running engine work');
-      console.log('\n  atris engine            roster + current default\n  atris engines --chart   show the fleet as an org chart\n  atris engine list --json full registry: default + engines with tier, roles, fallback, health\n  atris engine set <name> --duty leader|errands|learning [--models "a, b"]\n                           arrange the fleet and save its model policy\n  atris engine resolve <role> [--json]\n                           choose the best ready engine for navigator|executor|validator\n  atris engine health <name> --set ready|not_installed|credit_out\n                           flip runtime health, for example when credits run out\n  atris engine doctor [--json]\n                           probe which engine CLIs are installed here and sync that into health policy\n  atris engine <name>     make that engine the default here\n  atris engine test [name] preflight: run the engine CLI headless, report pass/fail\n  atris engine ask "<question>" --engine <name> [--engine <name> ...]\n                           ask several engines in parallel without allowing edits\n  atris engine ask --jobs <jobs.json>\n                           ask different read-only questions in parallel\n  atris engine validate <receipt-path|latest> [--engine <name>]\n                           check ask answers with a different read-only referee\n  atris engine validate scoreboard\n                           show pass rates by worker engine\n  atris engine dispatch <task-id> [<task-id> ...] --engine cursor|codex [--prompt-file <f>] [--yolo]\n                           one-command claim, worktree, build, verify, ship, ready\n  atris engine login <provider> --yes\n                           upload a local provider CLI login to the backend vault\n  atris engine login <provider> --computer [--seat <name>]\n  atris engine login <provider> --business <id> [--seat <name>]\n                           sign in on an Atris computer by device flow\n  atris engine login --list | --remove <provider>\n                           list or remove vaulted provider logins\n  atris engine seats       show which named accounts are ready to work\n  atris engine seed <provider> --business <id>|--user\n                           push a vaulted login onto an Atris computer\n  atris engine reset      back to the house default\n  --engine <name>         one run on that engine (mission run / autopilot / run)\n');
+      console.log('\n  long read-only asks: atris engine ask "..." --engine agy --timeout <seconds>\n                           quick asks default to 120 seconds; explicit jobs allow up to 3600\n                           follow live work with atris engine watch latest');
+      console.log('\n  atris engine            roster + current default\n  atris engines --chart   show the fleet as an org chart\n  atris engine list --json [--all] full registry: default + engines with tier, roles, fallback, health (--all includes hidden engines)\n  atris engine set <name> --duty leader|errands|learning [--models "a, b"]\n                           arrange the fleet and save its model policy\n  atris engine resolve <role> [--json]\n                           choose the best ready engine for navigator|executor|validator\n  atris engine health <name> --set ready|not_installed|credit_out\n                           flip runtime health, for example when credits run out\n  atris engine doctor [--json]\n                           probe which engine CLIs are installed here and sync that into health policy\n  atris engine <name>     make that engine the default here\n  atris engine test [name] preflight: run the engine CLI headless, report pass/fail\n  atris engine bench [names...] [--runs N]\n                           ranked latency scoreboard of engine passes\n  atris engine ask "<question>" --engine <name> [--engine <name> ...]\n                           ask several engines in parallel without allowing edits\n  atris engine ask --jobs <jobs.json>\n                           ask different read-only questions in parallel\n  atris engine validate <receipt-path|latest> [--engine <name>]\n                           check ask answers with a different read-only referee\n  atris engine validate scoreboard\n                           show pass rates by worker engine\n  atris engine dispatch <task-id> [<task-id> ...] --engine cursor|codex [--prompt-file <f>] [--yolo]\n                           one-command claim, worktree, build, verify, ship, ready\n  atris engine login <provider> --yes\n                           upload a local provider CLI login to the backend vault\n  atris engine login <provider> --computer [--seat <name>]\n  atris engine login <provider> --business <id> [--seat <name>]\n                           sign in on an Atris computer by device flow\n  atris engine login --list | --remove <provider>\n                           list or remove vaulted provider logins\n  atris engine seats       show which named accounts are ready to work\n  atris engine seed <provider> --business <id>|--user\n                           push a vaulted login onto an Atris computer\n  atris engine reset      back to the house default\n  --engine <name>         one run on that engine (mission run / autopilot / run)\n');
       return 0;
     }
     if (isFreshWorkspace(root)) {
       return speakFirstMinute({ root, fresh: true, asJson: json });
     }
     if (json) {
-      console.log(JSON.stringify(registryPayload(root, { scope: scope.kind }), null, 2));
+      console.log(JSON.stringify(registryPayload(root, { scope: scope.kind, includeHidden: args.includes('--all') }), null, 2));
       return 0;
     }
     printRoster(root, { scope: scope.kind });
@@ -1569,12 +1722,12 @@ function engineCommand(args = [], deps = {}) {
   if (sub === 'reset' || sub === 'off') {
     const removed = resetEngine(root);
     console.log(removed
-      ? `\n  default engine reset — back to ${resolveDefaultEngine(root).name}\n`
-      : `\n  nothing to reset — no engine was set here\n`);
+      ? `\n  default engine reset, back to ${resolveDefaultEngine(root).name}\n`
+      : `\n  nothing to reset, no engine was set here\n`);
     return 0;
   }
 
-  // atris engine <name> — flip the default. An unknown name is a plain user
+  // atris engine <name>: flip the default. An unknown name is a plain user
   // typo, not a crash: report it cleanly (and as JSON on demand) instead of
   // letting setEngine throw a raw stack trace at a new person.
   if (!canonicalEngineName(sub)) {
@@ -1608,6 +1761,7 @@ module.exports = {
   renderEngineChart,
   parseDispatchArgs,
   runDispatchCommand,
+  runBenchCommand,
   ENGINE_LOGIN_MANIFESTS,
   expandHomePath,
   normalizeLoginProvider,

package/commands/errors.js

@@ -1,5 +1,5 @@
 /**
- * Errors command for Atris CLI — admin dashboard over atris_error_events.
+ * Errors command for Atris CLI, admin dashboard over atris_error_events.
  *
  * Usage:
  *   atris errors                      Local-only by default (no cloud dump)
@@ -121,7 +121,7 @@ async function listErrors(args) {
   }
 
   console.log(
-    `Errors — last ${data.window_hours}h — ` +
+    `Errors, last ${data.window_hours}h, ` +
       `${data.total_events} events across ${data.unique_signatures} signatures\n`,
   );
 
@@ -146,7 +146,7 @@ async function listErrors(args) {
 async function showError(errorId) {
   if (!errorId) {
     console.error('Usage: atris errors show <id>');
-    console.error('(id must be a full UUID — get one from `atris errors` output)');
+    console.error('(id must be a full UUID, get one from `atris errors` output)');
     process.exit(1);
   }
 

package/commands/experiments.js

@@ -179,6 +179,18 @@ function runMeasureJson(scriptPath, workspaceDir = process.cwd()) {
   return parsed;
 }
 
+function printKeepRevertNext(slug) {
+  console.log(`next: atris experiments revert ${slug}`);
+}
+
+function printRevertKeepNext(slug) {
+  console.log(`next: atris experiments keep ${slug}`);
+}
+
+function printKeepWatchTickNext() {
+  console.log('next: atris youtube watch tick');
+}
+
 function experimentsKeep(name) {
   const token = String(name || '').trim();
   if (!token || token === '--help' || token === '-h' || token === 'help') {
@@ -212,16 +224,19 @@ function experimentsKeep(name) {
   const measured = runMeasureJson(measurePath, workspaceDir);
   if (!measured.ok) {
     console.error(`revert ${token}: ${measured.error}. refuse keep.`);
+    printKeepRevertNext(token);
     process.exit(1);
   }
 
   if (measured.score === 1) {
     console.log(`keep ${token}: measure.py moved 0→1`);
+    printKeepWatchTickNext();
     return;
   }
 
   const stayed = measured.score === 0 ? '0' : String(measured.score);
   console.error(`revert ${token}: measure.py stayed ${stayed}. refuse keep.`);
+  printKeepRevertNext(token);
   process.exit(1);
 }
 
@@ -301,11 +316,13 @@ function experimentsRevert(name) {
     const measured = runMeasureJson(measurePath, workspaceDir);
     if (measured.ok) {
       console.log(`revert ${token}: reset.py ran. measure.py ${measured.score}`);
+      printRevertKeepNext(token);
       return;
     }
   }
 
   console.log(`revert ${token}: reset.py ran`);
+  printRevertKeepNext(token);
 }
 
 function experimentsInit(name) {
@@ -491,7 +508,7 @@ function buildBenchmarkArtifact(name, packDir, options) {
 
   let execution = null;
   let reviewStatus = options.dryRun ? 'draft' : 'fail';
-  let reviewSummary = options.dryRun ? 'dry run — benchmark task not executed' : 'benchmark run failed before review';
+  let reviewSummary = options.dryRun ? 'dry run, benchmark task not executed' : 'benchmark run failed before review';
   let tests = [{
     command: options.dryRun ? 'benchmark dry-run' : '(no explicit test command captured)',
     status: 'not_run',

package/commands/feed.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// Feed: the business group feed from the terminal — read receipts, post receipts.
+// Feed: the business group feed from the terminal, read receipts, post receipts.
 // Auth: existing atris login. Business: nearest .atris/business.json above cwd.
 
 const fs = require('fs');
@@ -181,7 +181,7 @@ async function feedCommand(args = []) {
     const when = String(p.created_at || '').slice(0, 16).replace('T', ' ');
     const who = authorLabel(p, aliases, selfId, selfEmail);
     if (full) {
-      console.log(`─── ${who} — ${when}`);
+      console.log(`─── ${who}, ${when}`);
       console.log(String(p.content || '').trim());
       console.log('');
     } else {

package/commands/feedback.js

@@ -11,7 +11,7 @@
  *   atris feedback close <id>                   Close as wontfix (admin)
  *   atris feedback delete <id>                  Delete feedback (admin)
  *
- * IDs may be the first 8 chars of the UUID — the CLI resolves the prefix
+ * IDs may be the first 8 chars of the UUID. the CLI resolves the prefix
  * against the live list before making the write request.
  */
 
@@ -87,7 +87,7 @@ async function submitFeedback(message, opts = {}) {
     }
     if (result.text && !result.data) parts.push(result.text.trim());
     if (!parts.length) parts.push('Failed to submit feedback (no feedback_id returned)');
-    console.error(`Error: ${parts.join(' — ')}`);
+    console.error(`Error: ${parts.join(', ')}`);
     process.exit(1);
   }
 
@@ -153,7 +153,7 @@ async function resolveIdPrefix(prefix, { token, businessId }) {
   if (matches.length === 0) return { error: `No feedback matches id prefix "${prefix}"` };
   if (matches.length > 1) {
     return {
-      error: `Ambiguous id "${prefix}" — matches ${matches.length} items. Use a longer prefix.`,
+      error: `Ambiguous id "${prefix}", matches ${matches.length} items. Use a longer prefix.`,
     };
   }
   return { id: matches[0].id, item: matches[0] };
@@ -294,7 +294,7 @@ function printHelp(write = console.log) {
 
 function resolveBusinessArg(value) {
   if (!value) return null;
-  // Full UUID — trust it
+  // Full UUID, trust it
   if (/^[0-9a-f-]{32,}$/i.test(value)) return value;
   // Otherwise treat as slug and look up in ~/.atris/businesses.json
   const home = require('os').homedir();

package/commands/fleet.js

@@ -1,16 +1,16 @@
 /**
- * Atris Fleet — Manage the agent swarm via Swarlo
+ * Atris Fleet: Manage the agent swarm via Swarlo
  *
  * Commands:
- *   atris fleet                  — Show fleet status
- *   atris fleet status           — Same as above
- *   atris fleet post <message>   — Post to the board
- *   atris fleet task <prompt>    — Post a task for agents to claim
- *   atris fleet claim <task_key> — Claim a task
- *   atris fleet done <task_key>  — Report task complete
- *   atris fleet members          — List members
- *   atris fleet prune            — Remove stale members
- *   atris fleet join             — Register this session
+ *   atris fleet                  : Show fleet status
+ *   atris fleet status           : Same as above
+ *   atris fleet post <message>   : Post to the board
+ *   atris fleet task <prompt>    : Post a task for agents to claim
+ *   atris fleet claim <task_key> : Claim a task
+ *   atris fleet done <task_key>  : Report task complete
+ *   atris fleet members          : List members
+ *   atris fleet prune            : Remove stale members
+ *   atris fleet join             : Register this session
  */
 
 const http = require('http');
@@ -264,7 +264,7 @@ async function fleetMembers(state) {
     console.log(`\n  Members (${res.data.count}):`);
     for (const m of res.data.members) {
       const seen = m.last_seen ? m.last_seen.slice(0, 16) : 'never';
-      console.log(`    ${m.member_type === 'human' ? '👤' : '🤖'} ${m.member_name} (${m.member_id}) — seen: ${seen}`);
+      console.log(`    ${m.member_type === 'human' ? '👤' : '🤖'} ${m.member_name} (${m.member_id}), seen: ${seen}`);
     }
     console.log();
   }
@@ -388,7 +388,7 @@ async function fleet(args = []) {
 
   if (subcommand === 'help' || subcommand === '--help' || subcommand === '-h') {
     console.log('');
-    console.log('  atris fleet — coordinate agent swarm via Swarlo');
+    console.log('  atris fleet: coordinate agent swarm via Swarlo');
     console.log('');
     console.log('  fleet              show workspace fleet (default)');
     console.log('  fleet --global     query the machine Swarlo hub');

package/commands/game.js

@@ -62,7 +62,7 @@ function publisherSupportsStoryline(script) {
 
 function clean(value, fallback = '') {
   const text = String(value == null ? '' : value)
-    .replace(/[—–]/g, '-')
+    .replace(/[\u2014\u2013]/g, '-')
     .replace(/\s+/g, ' ')
     .trim();
   return text || fallback;

package/commands/guide.js

@@ -0,0 +1,49 @@
+'use strict';
+
+const { INTENTS, matchIntent } = require('../lib/intents');
+
+function plainForIntent(intent) {
+  return `${intent.plain}${intent.confirm ? ' (asks you first)' : ''}`;
+}
+
+function printAlternatives(alternatives, limit) {
+  const nearest = alternatives.slice(0, limit);
+  if (!nearest.length) return;
+  console.log('you might also mean:');
+  nearest.forEach((intent) => console.log(`"${intent.say[0]}"`));
+}
+
+function guideCommand(args = []) {
+  const json = args.includes('--json');
+  const words = args.filter((arg) => arg !== '--json').join(' ').trim();
+
+  if (!words) {
+    if (json) {
+      console.log(JSON.stringify({ intents: INTENTS }, null, 2));
+      return 0;
+    }
+    INTENTS.forEach((intent) => {
+      console.log(`"${intent.say[0]}"  ->  ${plainForIntent(intent)}`);
+    });
+    return 0;
+  }
+
+  const result = matchIntent(words);
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return result.intent ? 0 : 1;
+  }
+
+  if (!result.intent) {
+    console.log('not sure yet. ask one question, then try again');
+    printAlternatives(result.alternatives, 3);
+    return 1;
+  }
+
+  console.log(plainForIntent(result.intent));
+  console.log(result.intent.do);
+  printAlternatives(result.alternatives, 2);
+  return 0;
+}
+
+module.exports = { guideCommand };