atris 3.16.0 → 3.17.0

package/bin/atris.js

@@ -36,6 +36,13 @@ const {
 
 // State detection for smart default
 const { detectWorkspaceState, loadContext } = require('../lib/state-detection');
+const {
+  saveContextProfile,
+  createStarterTask,
+  shouldGatherContext,
+  isAtrisMetaQuestion,
+  renderPrompt: renderContextGathererPrompt,
+} = require('../lib/context-gatherer');
 
 // Journal & config utilities (canonical modules)
 const { getLogPath, ensureLogDirectory, createLogFile } = require('../lib/file-ops');
@@ -107,6 +114,41 @@ if (!skipUpdateCheck && (!updateCommand || (updateCommand && !['version', 'updat
 let command = process.argv[2];
 const commandArgs = process.argv.slice(3);
 const firstCommandArg = process.argv[3];
+const RUNNER_FLAG_NAMES = ['--runner-bin', '--runner-template', '--runner-model', '--runner-profile'];
+
+function readOptionArg(args, name) {
+  const prefix = `${name}=`;
+  const inline = args.find((arg) => arg.startsWith(prefix));
+  if (inline) return inline.slice(prefix.length);
+  const index = args.indexOf(name);
+  if (index !== -1 && index < args.length - 1 && !String(args[index + 1]).startsWith('--')) return args[index + 1];
+  return null;
+}
+
+function isOptionValue(args, index, optionNames) {
+  return index > 0 && optionNames.includes(args[index - 1]);
+}
+
+function applyRunnerFlags(args) {
+  const runnerProfile = readOptionArg(args, '--runner-profile');
+  if (runnerProfile) process.env.ATRIS_RUNNER_PROFILE = runnerProfile;
+  const runnerBin = readOptionArg(args, '--runner-bin');
+  if (runnerBin) {
+    process.env.ATRIS_RUNNER_BIN = runnerBin;
+    process.env.ATRIS_CLAUDE_BIN = runnerBin;
+  }
+  const runnerTemplate = readOptionArg(args, '--runner-template');
+  if (runnerTemplate) {
+    process.env.ATRIS_RUNNER_COMMAND_TEMPLATE = runnerTemplate;
+    process.env.ATRIS_CLAUDE_COMMAND_TEMPLATE = runnerTemplate;
+  }
+  const runnerModel = readOptionArg(args, '--runner-model');
+  if (runnerModel) {
+    process.env.ATRIS_RUNNER_MODEL = runnerModel;
+    process.env.ATRIS_CLAUDE_MODEL = runnerModel;
+  }
+}
+
 const isBusinessSyncSafetyCommand = command === 'sync'
   && (
     commandArgs.includes('--status')
@@ -319,7 +361,13 @@ function showHelp() {
   console.log('  plan       - Create build spec with visualization');
   console.log('  do         - Execute tasks');
   console.log('  review     - Validate work (tests, safety checks, docs)');
+  console.log('  slop       - Detect frontend AI-slop tells (deterministic, exit 1 = found)');
+  console.log('  deck       - Generate a premium Google Slides deck from a content spec');
   console.log('  run        - Auto-chain plan→do→review (autonomous loop, auto-pushes)');
+  console.log('  run logs   - Browse glass run logs (phase reasoning persisted to disk)');
+  console.log('  run search - Search phase reasoning across all run logs');
+  console.log('  pulse      - Durable overnight self-improvement heartbeat (OS cron, install/status/tick)');
+  console.log('  spaceship  - Bounded overnight runner that survives bad ticks and emails updates');
   console.log('');
   console.log('Context & tracking:');
   console.log('  log        - Add ideas to inbox');
@@ -328,6 +376,7 @@ function showHelp() {
   console.log('  radar      - Show live agents joined with tasks, missions, and worktrees');
   console.log('  ctop       - Show a process-first live agent CPU/memory view');
   console.log('  status     - See local work and completions (`atris status <business>` for remote)');
+  console.log('  recap      - What your AI team did, in plain English (--share for paste-ready)');
   console.log('  xp         - Show Career XP and contribution graph');
   console.log('  analytics  - Show recent productivity from journals');
   console.log('  search     - Search journal history (atris search <keyword>)');
@@ -350,6 +399,7 @@ function showHelp() {
   console.log('  improve    - Run one paid RL tick (POST /api/improve, deducts credits)');
   console.log('  worktree   - Isolated Git worktrees plus guarded ship/merge for parallel agents');
   console.log('  visualize  - Generate a Slack/deck-ready visual from a prompt');
+  console.log('  youtube    - Process YouTube videos with Gemini native video analysis');
   console.log('');
   console.log('Experiments:');
   console.log('  experiments init [slug]     - Prepare atris/experiments/ or scaffold a pack');
@@ -357,6 +407,13 @@ function showHelp() {
   console.log('  experiments run <slug>      - Execute a pack or record an Endstate receipt');
   console.log('  experiments benchmark [m]   - Run validate/runtime experiment benchmarks');
   console.log('');
+  console.log('Compile loop (learn like AI, run like code):');
+  console.log('  compile record <name>       - Append an execution record (--input/--output)');
+  console.log('  compile build <name>        - Compile records into a deterministic run.js');
+  console.log('  compile backtest <name>     - Replay all records, score accuracy vs gate');
+  console.log('  compile promote <name>      - Activate (gate: accuracy >= threshold)');
+  console.log('  compile exec <name>         - Run the compiled process token-free');
+  console.log('');
   console.log('Quick commands:');
   console.log('  atris      - Load context and start (natural language)');
   console.log('  next       - Auto-advance to next step');
@@ -399,8 +456,9 @@ function showHelp() {
   console.log('  console    - Start/attach always-on coding console (tmux daemon)');
   console.log('  soul       - Show, snapshot, or fork workspace identity');
   console.log('  fleet      - Inspect local fleet status');
-  console.log('  agent      - Select cloud agent, or run `agent doctor` for local CLI wiring');
-  console.log('  chat       - Chat with the selected Atris agent');
+  console.log('  agent      - Select cloud agent, spawn worker requests, or run `agent doctor`');
+  console.log('  chat       - Chat with the selected Atris agent (or: atris chat scan)');
+  console.log('  fast       - Chat with Atris2 Fast');
   console.log('  login      - Sign in or add another account');
   console.log('  logout     - Sign out of current account');
   console.log('  whoami     - Show active account');
@@ -725,8 +783,12 @@ function showAutopilotHelp() {
   console.log('  --auto           Execute without waiting for approval');
   console.log('  --duration=TIME  Run for a time limit (e.g. 1h, 30m, 90m)');
   console.log('  --iterations=N   Max tasks before stopping');
-  console.log('  --verbose, -v    Show detailed claude output');
+  console.log('  --verbose, -v    Show detailed runner output');
   console.log('  --dry-run        Show suggestions without executing');
+  console.log('  --runner-bin PATH       Runner binary for this run');
+  console.log('  --runner-template CMD   Runner command template for this run');
+  console.log('  --runner-model MODEL    Runner model for this run');
+  console.log('  --runner-profile NAME   Runner profile for this run (e.g. atris-fast)');
   console.log('');
   console.log('Examples:');
   console.log('  atris autopilot                        # Suggest from existing work');
@@ -764,11 +826,11 @@ if (command === '2' && ['fast', 'pro'].includes(String(firstCommandArg || '').to
 
 // Check if this is a known command or natural language input
 const knownCommands = ['init', 'log', 'now', 'radar', 'ctop', 'status', 'analytics', 'visualize', 'brain', 'brainstorm', 'autopilot', 'run', 'plan', 'do', 'review', 'release',
-                       'activate', '_activate', 'agent', 'chat', 'console', 'serve', 'login', 'logout', 'whoami', 'switch', 'use', 'accounts', '_resolve', '_profile-email', '_switch-session', 'shell-init', 'update', 'upgrade', 'version', 'help', 'next', 'atris',
-                       'clean', 'verify', 'search', 'skill', 'member', 'codex-goal', 'app', 'apps', 'learn', 'lesson', 'plugin', 'experiments', 'receipt', 'proof', 'openclaw', 'pull', 'push', 'live', 'align', 'terminal', 'computer', 'diff', 'business', 'sync',
-                       'ingest', 'query', 'lint', 'loop', 'task', 'mission', 'worktree', 'aeo', 'improve', 'xp', 'play', 'gm', 'x',
+                       'activate', '_activate', 'agent', 'chat', 'fast', 'ax', 'console', 'serve', 'login', 'logout', 'whoami', 'switch', 'use', 'accounts', '_resolve', '_profile-email', '_switch-session', 'shell-init', 'update', 'upgrade', 'version', 'help', 'next', 'atris',
+                       'clean', 'verify', 'search', 'skill', 'member', 'codex-goal', 'app', 'apps', 'learn', 'lesson', 'plugin', 'experiments', 'receipt', 'proof', 'openclaw', 'pull', 'push', 'live', 'align', 'terminal', 'computer', 'diff', 'business', 'sync', 'youtube',
+                       'ingest', 'query', 'lint', 'loop', 'pulse', 'task', 'mission', 'probe', 'worktree', 'aeo', 'slop', 'deck', 'improve', 'xp', 'play', 'gm', 'x', 'recap',
                        'gmail', 'calendar', 'twitter', 'slack', 'imessage', 'integrations', 'setup', 'clean-workspace', 'cw',
-                       'fork', 'browse', 'publish', 'sleep', 'wake', 'feedback', 'errors', 'wiki', 'code-review', 'cr', 'soul', 'fleet'];
+                       'fork', 'browse', 'publish', 'sleep', 'wake', 'feedback', 'errors', 'wiki', 'code-review', 'cr', 'soul', 'fleet', 'compile', 'spaceship'];
 
 // Check if command is an atris.md spec file - triggers welcome visualization
 function isSpecFile(cmd) {
@@ -857,11 +919,24 @@ if (!command || !knownCommands.includes(command)) {
   return;
 }
 
+function printAtrisOverview() {
+  console.log('');
+  console.log('Atris is an AI computer for a workspace.');
+  console.log('It keeps project context, tasks, memory, tools, and proof in one loop: plan -> do -> review.');
+  console.log('Run `atris` to load the current workspace, or `atris help` to see commands.');
+  console.log('');
+}
+
 async function interactiveEntry(userInput) {
   const workspaceDir = process.cwd();
   const state = detectWorkspaceState(workspaceDir);
   const context = loadContext(workspaceDir);
 
+  if (isAtrisMetaQuestion(userInput)) {
+    printAtrisOverview();
+    return;
+  }
+
   // Fresh install - offer init
   if (state.state === 'fresh') {
     console.log('\nNo atris/ folder found. Run: atris init');
@@ -927,28 +1002,46 @@ async function interactiveEntry(userInput) {
   console.log('└─────────────────────────────────────────────────────────────┘');
 
   const mapStatus = context.mapStatus || (context.mapExists ? 'ready' : 'missing');
-  if (mapStatus !== 'ready') {
-    console.log('');
-    console.log('┌─────────────────────────────────────────────────────────────┐');
-    console.log('│ BOOTSTRAP REQUIRED                                          │');
-    console.log('└─────────────────────────────────────────────────────────────┘');
-    console.log('');
-    console.log('🗺️  Atris needs a real `atris/MAP.md` (navigation index with file:line refs).');
-    console.log('');
-    console.log('Copy/paste into your coding agent:');
-    console.log('─────────────────────────────────────────────────────────────');
-    console.log('Read `atris/atris.md`, then generate a complete `atris/MAP.md` for this repo.');
-    console.log('Rules: include file:line refs, keep it grep-friendly, do NOT change code.');
-    if (userInput) {
-      console.log('');
-      console.log('After MAP is generated, run:');
-      console.log(`- atris ${userInput}`);
-    } else {
+  if (shouldGatherContext({
+    root: workspaceDir,
+    userInput,
+    mapStatus,
+    liveMissionsCount,
+    wipCount,
+    backlogCount,
+    inboxCount,
+  })) {
+    const answer = String(userInput || '').trim() || await askContextGatherer(workspaceDir);
+    if (isAtrisMetaQuestion(answer)) {
+      printAtrisOverview();
+      return;
+    }
+    if (!answer.trim()) {
       console.log('');
-      console.log('Then rerun: atris');
+      console.log('No problem. When you are ready, answer in normal words.');
+      console.log('Example: "help me organize college applications" or "help me build a small website".');
+      return;
     }
-    console.log('─────────────────────────────────────────────────────────────');
+    const profile = saveContextProfile(workspaceDir, answer, { source: userInput ? 'hot_start' : 'cold_start' });
+    const starter = createStarterTask(workspaceDir, answer);
     console.log('');
+    console.log('Got it. I saved your first direction.');
+    console.log(`Focus: ${profile.first_answer}`);
+    if (starter && starter.display_id) {
+      console.log(`First task: ${starter.display_id} — ${starter.title}`);
+    } else if (starter && starter.title) {
+      console.log(`First task: ${starter.title}`);
+    }
+    if (mapStatus !== 'ready') {
+      printMapBootstrap({ userInput: answer, prefix: 'Next setup step' });
+      return;
+    }
+    await planCmd(answer);
+    return;
+  }
+
+  if (mapStatus !== 'ready') {
+    printMapBootstrap({ userInput });
     return;
   }
 
@@ -1039,9 +1132,45 @@ async function interactiveEntry(userInput) {
   await planCmd(request);
 }
 
+async function askContextGatherer(workspaceDir) {
+  console.log(renderContextGathererPrompt({ projectName: path.basename(workspaceDir) }));
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const answer = await new Promise(r => rl.question('> ', r));
+  rl.close();
+  return answer;
+}
+
+function printMapBootstrap({ userInput, prefix = 'Bootstrap required' } = {}) {
+  console.log('');
+  console.log('┌─────────────────────────────────────────────────────────────┐');
+  console.log(`│ ${String(prefix).toUpperCase().padEnd(60)}│`);
+  console.log('└─────────────────────────────────────────────────────────────┘');
+  console.log('');
+  console.log('Atris needs a real `atris/MAP.md` so future steps are grounded in the workspace.');
+  console.log('');
+  console.log('For an agent:');
+  console.log('─────────────────────────────────────────────────────────────');
+  console.log('Read `atris/atris.md`, then generate a complete `atris/MAP.md` for this repo.');
+  console.log('Rules: include file:line refs, keep it grep-friendly, do NOT change code.');
+  if (userInput) {
+    console.log('');
+    console.log('After MAP is generated, continue with:');
+    console.log(`- ${userInput}`);
+  } else {
+    console.log('');
+    console.log('Then rerun: atris');
+  }
+  console.log('─────────────────────────────────────────────────────────────');
+  console.log('');
+}
+
 // ASCII Welcome Visualization
 function showWelcomeVisualization() {
-  const { getBacklogTasks, getInProgressTasks } = require('../lib/state-detection');
+  const { getTaskCounts } = require('../lib/state-detection');
+  const { readEndgameState } = require('../commands/autopilot');
   const cwd = process.cwd();
   const atrisDir = path.join(cwd, 'atris');
   const projectName = path.basename(cwd);
@@ -1050,9 +1179,12 @@ function showWelcomeVisualization() {
   let filesIndexed = 0;
   let tasksInBacklog = 0;
   let tasksInProgress = 0;
+  let tasksInReview = 0;
+  let tasksCertified = 0;
   let journalEntries = 0;
   let hasMap = false;
   let isInitialized = fs.existsSync(atrisDir);
+  let endgameState = { slug: 'unset', horizon: '' };
 
   if (isInitialized) {
     // Check MAP.md
@@ -1065,15 +1197,22 @@ function showWelcomeVisualization() {
       filesIndexed = fileRefs ? fileRefs.length : 0;
     }
 
-    // Check TODO.md
-    const todoPath = path.join(atrisDir, 'TODO.md');
-    if (fs.existsSync(todoPath)) {
-      try {
-        tasksInBacklog = getBacklogTasks(atrisDir).length;
-        tasksInProgress = getInProgressTasks(atrisDir).length;
-      } catch {
-        // Silently fail - show 0 tasks if parsing fails
-      }
+    // Task lane counts — DB truth first, TODO.md parse as fallback
+    try {
+      const counts = getTaskCounts(atrisDir);
+      tasksInBacklog = counts.backlog;
+      tasksInProgress = counts.active;
+      tasksInReview = counts.review;
+      tasksCertified = counts.reviewCertified;
+    } catch {
+      // Silently fail - show 0 tasks if reading fails
+    }
+
+    // Read endgame state
+    try {
+      endgameState = readEndgameState(cwd);
+    } catch {
+      // Silently fail - show unset if reading fails
     }
 
     // Count journal entries today
@@ -1122,13 +1261,24 @@ function showWelcomeVisualization() {
     console.log(`    │   📄 Spec:    atris.md v${CLI_VERSION.padEnd(18)}│`);
     console.log(`    │   🗺️  Map:    ${hasMap ? (filesIndexed + ' files indexed').padEnd(26) : 'not generated yet'.padEnd(26)}│`);
     console.log(`    │   📋 Tasks:   ${(tasksInBacklog + ' backlog, ' + tasksInProgress + ' active').padEnd(26)}│`);
+    if (tasksInReview > 0) {
+      const reviewText = tasksCertified > 0
+        ? `${tasksInReview} waiting (${tasksCertified} certified)`
+        : `${tasksInReview} waiting`;
+      console.log(`    │   ⏳ Review:  ${reviewText.padEnd(26)}│`);
+    }
     console.log(`    │   📝 Journal: ${(journalEntries + ' entries today').padEnd(26)}│`);
+    if (endgameState.slug !== 'unset' && endgameState.horizon) {
+      const endgameLine = endgameState.slug + ' — ' + endgameState.horizon;
+      const paddedEndgame = endgameLine.padEnd(26);
+      console.log(`    │   🎯 Endgame: ${paddedEndgame}│`);
+    }
     console.log('    │                                          │');
     console.log('    │   ┌──────────────────────────────────┐   │');
     console.log('    │   │  MAP.md ←──── YOU ARE HERE       │   │');
     console.log('    │   │     ↓                            │   │');
-    const taskText = `${tasksInBacklog} tasks waiting`;
-    console.log(`    │   │  TODO.md ←── ${taskText.padEnd(17)}│   │`);
+    const taskText = `${tasksInBacklog} task${tasksInBacklog === 1 ? '' : 's'} waiting`;
+    console.log(`    │   │  TODO.md ←── ${taskText.padEnd(20)}│   │`);
     console.log('    │   │     ↓                            │   │');
     console.log('    │   │  navigator → executor → validator│   │');
     console.log('    │   └──────────────────────────────────┘   │');
@@ -1136,7 +1286,11 @@ function showWelcomeVisualization() {
     console.log('    └──────────────────────────────────────────┘');
   }
   console.log('');
-  console.log(`    Ready. Run 'atris plan' to start.`);
+  if (tasksCertified > 0) {
+    console.log(`    Ready. ${tasksCertified} certified await accept — run 'atris task reviews'.`);
+  } else {
+    console.log(`    Ready. Run 'atris plan' to start.`);
+  }
   console.log('');
 }
 
@@ -1165,6 +1319,16 @@ if (command === 'init') {
   Promise.resolve(require('../commands/mission').missionCommand(process.argv.slice(3)))
     .then(() => process.exit(0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'pulse') {
+  // Pulse: durable overnight self-improvement heartbeat (OS cron) for atris-cli.
+  Promise.resolve(require('../commands/pulse').pulseCommand(process.argv.slice(3)))
+    .then((res) => process.exit(res && res.ok === false ? 1 : 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'probe') {
+  // Chat-lane probe (TRR-22): one real /atris2/turn over the full tool relay.
+  Promise.resolve(require('../commands/probe').probeCommand(process.argv.slice(3)))
+    .then((code) => process.exit(code || 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'worktree') {
   Promise.resolve(require('../commands/worktree').worktreeCommand(process.argv.slice(3)))
     .then((code) => process.exit(code || 0))
@@ -1178,6 +1342,16 @@ if (command === 'init') {
   Promise.resolve(require('../commands/codex-goal').codexGoalCommand(process.argv.slice(3)))
     .then(() => process.exit(process.exitCode || 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'slop') {
+  // Slop: deterministic frontend-slop detector (no LLM). Exit 1 = slop found, for CI + the autopilot gate.
+  Promise.resolve(require('../commands/slop').slopCommand(process.argv.slice(3)))
+    .then((code) => process.exit(typeof code === 'number' ? code : 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'deck') {
+  // Deck: premium Google Slides from a plain content spec, via the Atris deck engine (anti-slop design system).
+  Promise.resolve(require('../commands/deck').run(process.argv.slice(3)))
+    .then((code) => process.exit(typeof code === 'number' ? code : 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'aeo') {
   // AEO: AI Engine Optimization — credit-metered citation drafting against the customer workspace.
   Promise.resolve(require('../commands/aeo').run(process.argv.slice(3)))
@@ -1234,6 +1408,8 @@ if (command === 'init') {
     process.exit(0);
   }
   require('../commands/now').nowAtris(args);
+} else if (command === 'recap') {
+  require('../commands/recap').recapAtris(process.argv.slice(3));
 } else if (command === 'activate') {
   const args = process.argv.slice(3);
   if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
@@ -1276,12 +1452,28 @@ if (command === 'init') {
   }
   upgradeAtris().then(() => process.exit(0)).catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'chat') {
+  if (process.argv[3] === 'scan') {
+    try {
+      require('../commands/chat-scan').chatScanCommand(process.argv.slice(4));
+      process.exit(0);
+    } catch (error) {
+      console.error(`✗ Chat scan failed: ${error.message || error}`);
+      process.exit(1);
+    }
+  }
   chatAtris()
     .then(() => process.exit(0))
     .catch((error) => {
       console.error(`✗ Chat failed: ${error.message || error}`);
       process.exit(1);
     });
+} else if (command === 'fast' || (command === 'ax' && process.argv[3] === 'fast')) {
+  atrisFastChat()
+    .then(() => process.exit(0))
+    .catch((error) => {
+      console.error(`✗ Fast chat failed: ${error.message || error}`);
+      process.exit(1);
+    });
 } else if (command === 'console') {
   consoleCmd();
 } else if (command === 'serve') {
@@ -1368,8 +1560,116 @@ if (command === 'init') {
   require('../commands/visualize').visualizeAtris(process.argv.slice(3))
     .then(() => process.exit(0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'youtube') {
+  require('../commands/youtube').youtubeCommand(process.argv.slice(3))
+    .then(() => process.exit(0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'run') {
   const args = process.argv.slice(3);
+  if (args[0] === 'logs') {
+    // Subcommand: atris run logs [--tail N] [--cat FILE] [--json]
+    const { listRunLogs } = require('../commands/run');
+    const logsArgs = args.slice(1);
+    if (logsArgs.includes('--help') || logsArgs.includes('-h')) {
+      console.log('');
+      console.log('Usage: atris run logs [options]');
+      console.log('');
+      console.log('List and read glass run logs from atris/logs/runs/.');
+      console.log('');
+      console.log('Options:');
+      console.log('  --tail N      Show last N lines of each log (default: 5)');
+      console.log('  --cat FILE    Print full contents of a specific log file');
+      console.log('  --json        Output machine-readable JSON');
+      console.log('  --help        Show this help');
+      console.log('');
+      process.exit(0);
+    }
+    listRunLogs(logsArgs);
+    process.exit(0);
+  }
+  if (args[0] === 'prune-logs') {
+    // Subcommand: atris run prune-logs [--keep N] [--dry-run]
+    const { pruneRunLogs } = require('../commands/run');
+    const pruneArgs = args.slice(1);
+    if (pruneArgs.includes('--help') || pruneArgs.includes('-h')) {
+      console.log('');
+      console.log('Usage: atris run prune-logs [options]');
+      console.log('');
+      console.log('Prune old run logs, keeping only the most recent N files.');
+      console.log('');
+      console.log('Options:');
+      console.log('  --keep N      Number of recent logs to keep (default: 50)');
+      console.log('  --dry-run     Show what would be deleted without deleting');
+      console.log('  --help        Show this help');
+      console.log('');
+      process.exit(0);
+    }
+    pruneRunLogs(pruneArgs);
+    process.exit(0);
+  }
+  if (args[0] === 'search') {
+    // Subcommand: atris run search <keyword> [--phase P] [--limit N]
+    const { searchRunLogs } = require('../commands/run');
+    const searchArgs = args.slice(1);
+    if (searchArgs.includes('--help') || searchArgs.includes('-h') || searchArgs.length === 0) {
+      console.log('');
+      console.log('Usage: atris run search <keyword> [options]');
+      console.log('');
+      console.log('Search phase reasoning across all run logs.');
+      console.log('');
+      console.log('Options:');
+      console.log('  --phase P     Limit search to a phase (plan, do, review, error)');
+      console.log('  --limit N     Max results to show (default: 20)');
+      console.log('  --help        Show this help');
+      console.log('');
+      process.exit(0);
+    }
+    searchRunLogs(searchArgs);
+    process.exit(0);
+  }
+  if (args[0] === 'stats') {
+    // Subcommand: atris run stats
+    const { statsRunLogs } = require('../commands/run');
+    statsRunLogs();
+    process.exit(0);
+  }
+  if (args[0] === 'export') {
+    // Subcommand: atris run export [--out FILE]
+    const { exportRunLogs } = require('../commands/run');
+    const exportArgs = args.slice(1);
+    if (exportArgs.includes('--help') || exportArgs.includes('-h')) {
+      console.log('');
+      console.log('Usage: atris run export [options]');
+      console.log('');
+      console.log('Export all run logs as a JSON bundle for backup or transfer.');
+      console.log('');
+      console.log('Options:');
+      console.log('  --out FILE    Write to a specific file (default: atris/logs/runs/export.json)');
+      console.log('  --help        Show this help');
+      console.log('');
+      process.exit(0);
+    }
+    exportRunLogs(exportArgs);
+    process.exit(0);
+  }
+  if (args[0] === 'diff') {
+    // Subcommand: atris run diff <file1> <file2>
+    const { diffRunLogs } = require('../commands/run');
+    const diffArgs = args.slice(1);
+    if (diffArgs.includes('--help') || diffArgs.includes('-h') || diffArgs.length === 0) {
+      console.log('');
+      console.log('Usage: atris run diff <file1> <file2>');
+      console.log('');
+      console.log('Compare two run logs side by side, showing phase-level differences.');
+      console.log('');
+      console.log('Options:');
+      console.log('  --help        Show this help');
+      console.log('');
+      process.exit(0);
+    }
+    diffRunLogs(diffArgs);
+    process.exit(0);
+  }
   if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
     console.log('');
     console.log('Usage: atris run [options]');
@@ -1380,12 +1680,24 @@ if (command === 'init') {
     console.log('Options:');
     console.log('  --cycles=N    Max cycles (default: 5)');
     console.log('  --once        Single plan→do→review cycle');
-    console.log('  --verbose     Show claude -p output');
+    console.log('  --verbose     Show configured runner output');
     console.log('  --dry-run     Preview without executing');
     console.log('  --timeout=N   Phase timeout in seconds (default: 600)');
+    console.log('  --runner-bin PATH       Runner binary for this run');
+    console.log('  --runner-template CMD   Runner command template for this run');
+    console.log('  --runner-model MODEL    Runner model for this run');
+    console.log('  --runner-profile NAME   Runner profile for this run (e.g. atris-fast)');
     console.log('  --push        Auto-push after each cycle (default: true)');
     console.log('  --no-push     Skip auto-push after each cycle');
     console.log('');
+    console.log('Subcommands:');
+    console.log('  atris run logs [--tail N] [--cat FILE] [--json]  Browse glass run logs');
+    console.log('  atris run prune-logs [--keep N] [--dry-run]      Prune old run logs');
+    console.log('  atris run search <keyword> [--phase P] [--limit N]  Search run logs');
+    console.log('  atris run stats                                  Show run log stats');
+    console.log('  atris run export [--out FILE]                    Export logs as JSON');
+    console.log('  atris run diff <file1> <file2>                   Compare two run logs');
+    console.log('');
     process.exit(0);
   }
 
@@ -1393,6 +1705,7 @@ if (command === 'init') {
   const dryRun = args.includes('--dry-run');
   const once = args.includes('--once');
   const push = !args.includes('--no-push');
+  applyRunnerFlags(args);
   const cyclesArg = args.find(a => a.startsWith('--cycles='));
   const maxCycles = cyclesArg ? parseInt(cyclesArg.split('=')[1]) : 5;
   const timeoutArg = args.find(a => a.startsWith('--timeout='));
@@ -1415,13 +1728,14 @@ if (command === 'init') {
   const verbose = args.includes('--verbose') || args.includes('-v');
   const dryRun = args.includes('--dry-run');
   const auto = args.includes('--auto');
+  applyRunnerFlags(args);
   const maxIterationsArg = args.find(a => a.startsWith('--iterations='));
   const maxIterations = maxIterationsArg ? parseInt(maxIterationsArg.split('=')[1]) : undefined;
   const durationArg = args.find(a => a.startsWith('--duration='));
   const duration = durationArg ? durationArg.split('=')[1] : null;
 
   // Get description (non-flag args)
-  const description = args.filter(a => !a.startsWith('-')).join(' ').trim() || null;
+  const description = args.filter((a, i) => !a.startsWith('-') && !isOptionValue(args, i, RUNNER_FLAG_NAMES)).join(' ').trim() || null;
 
   const options = {
     ...(maxIterations !== undefined && { maxIterations }),
@@ -1710,6 +2024,11 @@ if (command === 'init') {
   require('../commands/fleet').fleet(args)
     .then(() => process.exit(0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'spaceship') {
+  const args = process.argv.slice(3);
+  require('../commands/spaceship').spaceship(args)
+    .then(() => process.exit(0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'code-review' || command === 'cr') {
   const args = process.argv.slice(3);
   require('../commands/review').reviewCommand(...args)
@@ -1746,6 +2065,12 @@ if (command === 'init') {
   const subcommand = process.argv[3];
   const args = process.argv.slice(4);
   require('../commands/experiments').experimentsCommand(subcommand, ...args);
+} else if (command === 'compile') {
+  const subcommand = process.argv[3];
+  const args = process.argv.slice(4);
+  Promise.resolve(require('../commands/compile').compileCommand(subcommand, ...args))
+    .then(() => process.exit(process.exitCode || 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'receipt' || command === 'proof' || command === 'openclaw') {
   const subcommand = process.argv[3];
   const args = process.argv.slice(4);
@@ -1916,7 +2241,7 @@ function inspectAgentCliWiring() {
     },
   ];
 
-  const binaries = ['atris', 'claude', 'codex', 'cursor-agent', 'devin'].map((name) => ({
+  const binaries = ['atris', 'ax', 'claude', 'codex', 'cursor-agent', 'devin', 'droid'].map((name) => ({
     name,
     path: commandOnPath(name),
   }));
@@ -1953,10 +2278,13 @@ async function agentAtris() {
   // Respect -h / --help / help before any auth/state work
   const firstArg = process.argv[3];
   if (firstArg === '-h' || firstArg === '--help' || firstArg === 'help') {
-    console.log('Usage: atris agent [doctor]');
+    console.log('Usage: atris agent [doctor|dogfood|spawn|spawns|spawn-status]');
     console.log('');
     console.log('  Pick which cloud agent to chat with from this workspace.');
+    console.log('  Run `atris agent spawn <role> --task "..."` to create a worker request.');
+    console.log('  Run `atris agent spawns` to list worker requests.');
     console.log('  Run `atris agent doctor` to verify local AI CLIs can see Atris context.');
+    console.log('  Run `atris agent dogfood --live` to smoke-test Devin/Droid with GLM 5.2.');
     console.log('  Requires `atris login` first.');
     console.log('');
     console.log('  After selecting, use: atris chat ["message"]');
@@ -1966,6 +2294,22 @@ async function agentAtris() {
   if (firstArg === 'doctor') {
     agentDoctor();
   }
+  if (firstArg === 'dogfood') {
+    const result = require('../commands/agent-spawn').agentDogfoodCommand(process.argv.slice(4));
+    process.exit(result.ok ? 0 : 1);
+  }
+  if (firstArg === 'spawn') {
+    require('../commands/agent-spawn').agentSpawnCommand(process.argv.slice(4));
+    return;
+  }
+  if (firstArg === 'spawns' || firstArg === 'spawn-list' || firstArg === 'list-spawns') {
+    require('../commands/agent-spawn').agentSpawnListCommand(process.argv.slice(4));
+    return;
+  }
+  if (firstArg === 'spawn-status' || firstArg === 'spawn-show') {
+    require('../commands/agent-spawn').agentSpawnStatusCommand(process.argv.slice(4));
+    return;
+  }
 
   const targetDir = path.join(process.cwd(), 'atris');
 
@@ -2209,6 +2553,65 @@ async function chatInteractive(config, credentials) {
   });
 }
 
+function atrisFastMessageFromArgs() {
+  const offset = command === 'ax' ? 4 : 3;
+  return process.argv.slice(offset).join(' ').trim();
+}
+
+async function atrisFastChat() {
+  if (command === 'ax' && process.argv[3] !== 'fast') {
+    console.error('Usage: atris ax fast "message"');
+    process.exit(1);
+  }
+
+  const message = atrisFastMessageFromArgs();
+
+  if (message === '-h' || message === '--help' || message === 'help') {
+    console.log('Usage: atris fast ["message"]');
+    console.log('');
+    console.log('  Chat with Atris2 Fast through /api/atris2/turn.');
+    console.log('  Requires `atris login`.');
+    console.log('');
+    console.log('  atris fast "what now?"      One-shot message');
+    console.log('  atris ax fast "what now?"   Alias');
+    process.exit(0);
+  }
+
+  if (!message) {
+    console.error('Usage: atris fast "message"');
+    process.exit(1);
+  }
+
+  const ensured = await ensureValidCredentials();
+  if (ensured.error === 'not_logged_in' || !ensured.credentials?.token) {
+    console.error('✗ Error: Not logged in. Run "atris login" first.');
+    process.exit(1);
+  }
+  if (ensured.error) {
+    console.error(`✗ Error: Authentication failed: ${ensured.detail || ensured.error}. Run "atris login" to re-authenticate.`);
+    process.exit(1);
+  }
+
+  const credentials = ensured.credentials;
+  await atrisFastOnce(credentials, message);
+}
+
+async function atrisFastOnce(credentials, message) {
+  console.log('\nAtris2 Fast');
+  console.log('');
+
+  const apiUrl = getApiBaseUrl().replace(/\/api$/, '');
+  const endpoint = `${apiUrl}/api/atris2/turn`;
+  const body = JSON.stringify({
+    message,
+    model: 'atris:fast',
+    max_turns: 1,
+  });
+
+  await streamProChat(endpoint, credentials.token, body);
+  console.log('\n\n✓ Complete\n');
+}
+
 async function atrisDevEntry(userInput = null) {
   // Load workspace context and present planning-ready state
   // userInput: optional task description for hot start