atris 3.31.0 → 3.33.3

package/bin/atris.js

@@ -127,8 +127,30 @@ function isOptionValue(args, index, optionNames) {
 }
 
 function applyRunnerFlags(args) {
+  // --engine <name> is the operator-facing spelling of --runner-profile:
+  // one flag rents a specific intelligence for this run.
+  const engineFlag = readOptionArg(args, '--engine');
+  if (engineFlag) {
+    const { canonicalEngineName } = require('../commands/engine');
+    const { RUNNER_PROFILE_NAMES } = require('../lib/runner-command');
+    const canonical = canonicalEngineName(engineFlag);
+    if (!canonical) {
+      console.error(`Unknown --engine "${engineFlag}". Known engines: ${RUNNER_PROFILE_NAMES.join(', ')}.`);
+      process.exit(1);
+    }
+    process.env.ATRIS_RUNNER_PROFILE = canonical;
+  }
   const runnerProfile = readOptionArg(args, '--runner-profile');
-  if (runnerProfile) process.env.ATRIS_RUNNER_PROFILE = runnerProfile;
+  if (runnerProfile) {
+    // Fail fast at the CLI boundary: an unknown profile otherwise stays silent
+    // until a heartbeat spawn resolves it mid-loop (silent overnight outage).
+    const { RUNNER_PROFILES, RUNNER_PROFILE_NAMES } = require('../lib/runner-command');
+    if (!Object.prototype.hasOwnProperty.call(RUNNER_PROFILES, runnerProfile)) {
+      console.error(`Unknown --runner-profile "${runnerProfile}". Known profiles: ${RUNNER_PROFILE_NAMES.join(', ')}.`);
+      process.exit(1);
+    }
+    process.env.ATRIS_RUNNER_PROFILE = runnerProfile;
+  }
   const runnerBin = readOptionArg(args, '--runner-bin');
   if (runnerBin) {
     process.env.ATRIS_RUNNER_BIN = runnerBin;
@@ -144,8 +166,30 @@ function applyRunnerFlags(args) {
     process.env.ATRIS_RUNNER_MODEL = runnerModel;
     process.env.ATRIS_CLAUDE_MODEL = runnerModel;
   }
+  // No per-run choice and no env: the workspace's saved engine
+  // (.atris/engine.json, written by `atris engine <name>`) becomes the
+  // profile for every loop spawn. For the loop commands themselves, fall all
+  // the way to the house engine (atris-fast when ax is installed) so the
+  // default intelligence is our own. Heartbeats stay engine-agnostic without
+  // any loop code knowing about engines.
+  if (!process.env.ATRIS_RUNNER_PROFILE) {
+    try {
+      const engine = require('../commands/engine');
+      const saved = engine.readSavedEngine();
+      if (saved) {
+        process.env.ATRIS_RUNNER_PROFILE = saved;
+      } else if (RUNNER_SPAWNING_COMMANDS.includes(command)) {
+        const resolved = engine.resolveDefaultEngine();
+        if (resolved.source === 'house') process.env.ATRIS_RUNNER_PROFILE = resolved.name;
+      }
+    } catch {}
+  }
 }
 
+// Commands whose ticks spawn a worker engine; only these pay the engine
+// detection probe when nothing is configured.
+const RUNNER_SPAWNING_COMMANDS = ['run', 'autopilot', 'mission', 'pulse', 'gm', 'spaceship'];
+
 const isBusinessSyncSafetyCommand = command === 'sync'
   && (
     commandArgs.includes('--status')
@@ -420,11 +464,13 @@ function showHelp() {
   console.log('Quick Start:');
   console.log('');
   console.log('  1. atris                  Open a persistent AI computer for this workspace');
+  console.log('     npx atris              Same command after a local project install');
   console.log('  2. Describe what you want run, built, researched, or validated');
   console.log('  3. Atris acts with context, memory, tools, and a review loop');
   console.log('');
   console.log('Common invocations:');
-  console.log('  atris init');
+  console.log('  atris init                Global install: initialize this project');
+  console.log('  npx atris init            Local install: initialize this project');
   console.log('  atris computer');
   console.log('  atris business init "My Company"');
   console.log('  atris run');
@@ -449,7 +495,7 @@ 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('  run        - Auto-chain plan→do→review (autonomous loop, auto-pushes)');
+  console.log('  run        - One bounded mission pursuit: start or resume, tick, complete');
   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)');
@@ -483,11 +529,13 @@ function showHelp() {
   console.log('');
   console.log('Optional helpers:');
   console.log('  brainstorm - Explore ideas conversationally before planning');
-  console.log('  autopilot  - Guided loop that can clarify TODOs and run plan → do → review');
+  console.log('  autopilot  - Keep the workspace moving: mission/member loop until you stop it');
   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('  land       - The landing: what is actually done vs still in the air; --reap backs up + clears overdue');
   console.log('  autoland   - Approve the policy once; certified work lands itself, you keep irreversible calls');
+  console.log('  engine     - Bring any intelligence: roster of installed coding CLIs, default engine, --engine per run, `engine test` preflight');
+  console.log('  sign       - Co-author trailer on every commit in an atris workspace (on/off/status)');
   console.log('  visualize  - Generate a Slack/deck-ready visual from a prompt');
   console.log('  youtube    - Process YouTube videos with timestamped transcript-first analysis');
   console.log('');
@@ -547,7 +595,7 @@ function showHelp() {
   console.log('  soul       - Show, snapshot, or fork workspace identity');
   console.log('  fleet      - Inspect local fleet status');
   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('  chat       - Chat with Atris 2 Fast in this workspace (--agent for cloud 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');
@@ -557,7 +605,7 @@ function showHelp() {
   console.log('  accounts   - Manage accounts (list, add, remove)');
   console.log('');
   console.log('Integrations:');
-  console.log('  gmail      - Email commands (inbox, read)');
+  console.log('  gmail      - Email commands (inbox, read, archive)');
   console.log('  calendar   - Calendar commands (today, week)');
   console.log('  twitter    - Twitter commands (post)');
   console.log('  slack      - Slack commands (channels)');
@@ -885,7 +933,7 @@ function showAutopilotHelp() {
   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(`  --runner-profile NAME   Runner profile for this run (one of: ${require('../lib/runner-command').RUNNER_PROFILE_NAMES.join(', ')})`);
   console.log('');
   console.log('Examples:');
   console.log('  atris autopilot                        # Suggest from existing work');
@@ -927,7 +975,7 @@ const knownCommands = ['init', 'log', 'now', 'radar', 'ctop', 'launchpad', 'stat
                        'clean', 'harvest', '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', 'land', 'autoland', 'aeo', 'slop', 'strings', 'security-review', 'secure', 'deck', 'site', 'theme', 'card', 'reel', 'improve', 'xp', 'play', 'gm', 'x', 'recap', 'signup', 'clarity', 'moves',
                        'gmail', 'calendar', 'twitter', 'slack', 'imessage', 'integrations', 'setup', 'clean-workspace', 'cw',
-                       'fork', 'browse', 'publish', 'sleep', 'wake', 'feedback', 'errors', 'wiki', 'code-review', 'cr', 'soul', 'fleet', 'compile', 'spaceship', 'truth'];
+                       'fork', 'browse', 'publish', 'sleep', 'wake', 'feedback', 'errors', 'wiki', 'code-review', 'cr', 'soul', 'fleet', 'compile', 'spaceship', 'truth', 'sign', 'engine', 'engines'];
 
 // Check if command is an atris.md spec file - triggers welcome visualization
 function isSpecFile(cmd) {
@@ -1049,7 +1097,11 @@ async function interactiveEntry(userInput) {
 
   // Fresh install - offer init
   if (state.state === 'fresh') {
-    console.log('\nNo atris/ folder found. Run: atris init');
+    console.log('\nNo atris/ folder found.');
+    console.log('');
+    console.log('Start here:');
+    console.log('  atris init       if Atris is installed globally');
+    console.log('  npx atris init   if Atris was installed in this project');
     return;
   }
 
@@ -1831,23 +1883,26 @@ if (command === 'init') {
   }
   if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
     console.log('');
-    console.log('Usage: atris run [options]');
+    console.log('Usage: atris run ["objective"] [options]');
     console.log('');
-    console.log('Auto-chain plan → do → review cycles autonomously.');
-    console.log('Reads inbox ideas, creates tasks, builds them, validates, repeats.');
+    console.log('One bounded mission pursuit: start a mission from the objective');
+    console.log('(or resume the most logical runnable mission), tick it through the');
+    console.log('mission runtime, complete on pass, then exit.');
+    console.log('For an ongoing loop, use: atris autopilot');
     console.log('');
     console.log('Options:');
-    console.log('  --cycles=N    Max cycles (default: 5)');
-    console.log('  --once        Single plan→do→review cycle');
-    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('  --owner NAME      Mission owner (default: mission-lead)');
+    console.log('  --minutes N | --hours N   Time budget for the pursuit');
+    console.log('  --max-ticks N     Override the tick budget');
+    console.log('  --max-wall N      Override the wall clock in seconds');
+    console.log('  --cadence C       Mission cadence (e.g. 15m)');
+    console.log('  --no-complete     Skip auto-complete after a passing run');
+    console.log('  --legacy          Old plan→do→review loop (claude -p cycles)');
+    console.log('');
+    console.log('Legacy options (with --legacy):');
+    console.log('  --cycles=N --once --verbose --dry-run --timeout=N --no-push');
+    console.log('  --runner-bin PATH / --runner-template CMD / --runner-model MODEL');
+    console.log(`  --runner-profile NAME   Runner profile for this run (one of: ${require('../lib/runner-command').RUNNER_PROFILE_NAMES.join(', ')})`);
     console.log('');
     console.log('Subcommands:');
     console.log('  atris run logs [--tail N] [--cat FILE] [--json]  Browse glass run logs');
@@ -1860,62 +1915,81 @@ if (command === 'init') {
     process.exit(0);
   }
 
-  const verbose = args.includes('--verbose') || args.includes('-v');
-  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='));
-  const timeout = timeoutArg ? parseInt(timeoutArg.split('=')[1]) * 1000 : undefined;
 
-  require('../commands/run').runAtris({ maxCycles, verbose, dryRun, once, push, timeout })
-    .then(() => process.exit(0))
-    .catch((error) => {
-      console.error(`\u2717 Run failed: ${error.message || error}`);
-      process.exit(1);
-    });
+  if (args.includes('--legacy')) {
+    const legacyArgs = args.filter(a => a !== '--legacy');
+    const verbose = legacyArgs.includes('--verbose') || legacyArgs.includes('-v');
+    const dryRun = legacyArgs.includes('--dry-run');
+    const once = legacyArgs.includes('--once');
+    const push = !legacyArgs.includes('--no-push');
+    const cyclesArg = legacyArgs.find(a => a.startsWith('--cycles='));
+    const maxCycles = cyclesArg ? parseInt(cyclesArg.split('=')[1]) : 5;
+    const timeoutArg = legacyArgs.find(a => a.startsWith('--timeout='));
+    const timeout = timeoutArg ? parseInt(timeoutArg.split('=')[1]) * 1000 : undefined;
+
+    require('../commands/run').runAtris({ maxCycles, verbose, dryRun, once, push, timeout })
+      .then(() => process.exit(0))
+      .catch((error) => {
+        console.error(`\u2717 Run failed: ${error.message || error}`);
+        process.exit(1);
+      });
+  } else {
+    require('../commands/run-front').runMissionFront(args)
+      .then((code) => process.exit(code || 0))
+      .catch((error) => {
+        console.error(`\u2717 Run failed: ${error.message || error}`);
+        process.exit(1);
+      });
+  }
 } else if (command === 'launchpad') {
   const code = require('../commands/launchpad').launchpadCommand(process.argv.slice(3));
   process.exit(code);
 } else if (command === 'autopilot') {
   const args = process.argv.slice(3);
-  if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
-    showAutopilotHelp();
-    process.exit(0);
-  }
-
-  // Parse options
-  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, i) => !a.startsWith('-') && !isOptionValue(args, i, RUNNER_FLAG_NAMES)).join(' ').trim() || null;
-
-  const options = {
-    ...(maxIterations !== undefined && { maxIterations }),
-    verbose,
-    dryRun,
-    auto,
-    duration
-  };
 
-  let promise;
-  promise = require('../commands/autopilot').autopilotAtris(description, options);
+  if (args.includes('--legacy')) {
+    const legacyArgs = args.filter(a => a !== '--legacy');
+    if (legacyArgs.includes('--help') || legacyArgs.includes('-h') || legacyArgs[0] === 'help') {
+      showAutopilotHelp();
+      process.exit(0);
+    }
+
+    // Parse options
+    const verbose = legacyArgs.includes('--verbose') || legacyArgs.includes('-v');
+    const dryRun = legacyArgs.includes('--dry-run');
+    const auto = legacyArgs.includes('--auto');
+    const maxIterationsArg = legacyArgs.find(a => a.startsWith('--iterations='));
+    const maxIterations = maxIterationsArg ? parseInt(maxIterationsArg.split('=')[1]) : undefined;
+    const durationArg = legacyArgs.find(a => a.startsWith('--duration='));
+    const duration = durationArg ? durationArg.split('=')[1] : null;
+
+    // Get description (non-flag args)
+    const description = legacyArgs.filter((a, i) => !a.startsWith('-') && !isOptionValue(legacyArgs, i, RUNNER_FLAG_NAMES)).join(' ').trim() || null;
+
+    const options = {
+      ...(maxIterations !== undefined && { maxIterations }),
+      verbose,
+      dryRun,
+      auto,
+      duration
+    };
 
-  promise
-    .then(() => process.exit(0))
-    .catch((error) => {
-      console.error(`✗ Autopilot failed: ${error.message || error}`);
-      process.exit(1);
-    });
+    require('../commands/autopilot').autopilotAtris(description, options)
+      .then(() => process.exit(0))
+      .catch((error) => {
+        console.error(`✗ Autopilot failed: ${error.message || error}`);
+        process.exit(1);
+      });
+  } else {
+    Promise.resolve(require('../commands/autopilot-front').autopilotFront(args))
+      .then((code) => process.exit(code || 0))
+      .catch((error) => {
+        console.error(`✗ Autopilot failed: ${error.message || error}`);
+        process.exit(1);
+      });
+  }
 } else if (command === 'brainstorm') {
   require('../commands/brainstorm').brainstormAtris()
     .then(() => process.exit(0))
@@ -2240,6 +2314,17 @@ if (command === 'init') {
   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 === 'engine' || command === 'engines') {
+  // Engine: bring any intelligence — roster of installed coding CLIs, default
+  // engine per workspace, --engine <name> rides any loop for one run.
+  try {
+    const engineArgs = command === 'engines' && process.argv.length <= 3 ? [] : process.argv.slice(3);
+    process.exit(require('../commands/engine').engineCommand(engineArgs) || 0);
+  } catch (err) { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); }
+} else if (command === 'sign') {
+  // Sign: prepare-commit-msg hook that credits Atris as co-author on commits in atris workspaces.
+  try { process.exit(require('../commands/sign').signCommand(process.argv[3]) || 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)))
@@ -2638,18 +2723,21 @@ async function agentAtris() {
 
 
 async function chatAtris() {
-  // Get message from command line args
-  const message = process.argv.slice(3).join(' ').trim();
+  // Get message from command line args; --agent forces the legacy cloud-agent lane
+  const rawArgs = process.argv.slice(3);
+  const agentLane = rawArgs.includes('--agent');
+  const message = rawArgs.filter(arg => arg !== '--agent').join(' ').trim();
 
   // Respect -h / --help before any auth/state checks
   if (message === '-h' || message === '--help' || message === 'help') {
     console.log('Usage: atris chat ["message"]');
     console.log('');
-    console.log('  Open an interactive session with the selected agent, or send a one-shot message.');
-    console.log('  Requires `atris login` and `atris agent` to be run first.');
+    console.log('  Chat with Atris 2 Fast in this workspace: tools attached, same turn as `ax --fast`.');
+    console.log('  Requires `atris login`.');
     console.log('');
-    console.log('  atris chat                  Interactive REPL with selected agent');
-    console.log('  atris chat "what now?"      One-shot message');
+    console.log('  atris chat                  Interactive chat (ax --fast --chat)');
+    console.log('  atris chat "what now?"      One-shot message (ax --fast)');
+    console.log('  atris chat --agent [...]    Legacy cloud-agent lane (needs `atris agent`)');
     process.exit(0);
   }
 
@@ -2665,6 +2753,22 @@ async function chatAtris() {
     process.exit(await runLocalFastMission(missionIntent));
   }
 
+  // Workspace standard v2: `atris chat` is the same turn as `ax --fast`,
+  // Atris 2 Fast with tools attached, ax owning routing (local tool loop,
+  // cloud fallback when no backend listens). The pro-chat cloud-agent lane
+  // survives behind --agent only; it 404s the moment a saved agent is
+  // deleted server-side and cannot see the workspace.
+  if (!agentLane) {
+    try {
+      const axPath = path.join(__dirname, '..', 'ax');
+      const axArgs = message ? ['--fast', message] : ['--fast', '--chat'];
+      const run = spawnSync(process.execPath, [axPath, ...axArgs], { stdio: 'inherit' });
+      process.exit(run.status || 0);
+    } catch {
+      // ax unavailable: fall through to the agent lane.
+    }
+  }
+
   printAtrisGoalBanner(process.cwd());
 
   // Check agent selected
@@ -2714,7 +2818,13 @@ async function chatOnce(config, credentials, message) {
     await streamProChat(endpoint, credentials.token, body);
     console.log('\n\n✓ Complete\n');
   } catch (error) {
-    console.error(`\n✗ Error: ${error.message || error}`);
+    const detail = String(error.message || error);
+    if (/404/.test(detail) && /agent not found/i.test(detail)) {
+      console.error(`\n✗ Error: Agent "${config.agent_name || agentId}" no longer exists on the server.`);
+      console.error('  Run "atris agent" to pick a new one, or drop --agent to use the fast workspace lane.');
+    } else {
+      console.error(`\n✗ Error: ${detail}`);
+    }
     process.exit(1);
   }
 }
@@ -2914,6 +3024,20 @@ async function atrisFastChat() {
     process.exit(await runLocalFastMission(missionIntent));
   }
 
+  // One routing brain: `atris fast` defers to ax's AX Context Standard. A
+  // workspace-shaped question asked from inside a workspace needs local tools
+  // (this lane is a tool-less cloud one-shot and confabulates on repo
+  // questions — SwapBench 2026-07-02), so delegate the whole turn to ax.
+  try {
+    const axModule = require('../ax');
+    if (axModule.resolveRoute(message) === 'local') {
+      const run = spawnSync(process.execPath, [path.join(__dirname, '..', 'ax'), '--fast', message], { stdio: 'inherit' });
+      process.exit(run.status || 0);
+    }
+  } catch {
+    // ax unavailable: fall through to the plain cloud one-shot.
+  }
+
   printAtrisGoalBanner(process.cwd());
 
   const ensured = await ensureValidCredentials();

package/commands/autoland.js

@@ -6,6 +6,7 @@ const os = require('os');
 const { spawnSync } = require('child_process');
 
 const autoland = require('../lib/autoland');
+const { operatorReady, hasAgentJargon } = autoland;
 
 function repoRoot(cwd = process.cwd()) {
   const result = spawnSync('git', ['rev-parse', '--show-toplevel'], { cwd, encoding: 'utf8' });
@@ -17,6 +18,25 @@ function projectName(root) {
   return path.basename(root);
 }
 
+// The digest's "next, if you agree" section: top candidate moves from Atris
+// state, each with the member best suited to own it. Moves that can't explain
+// themselves are counted, not shown. Never blocks the digest.
+function digestNextMoves(root) {
+  try {
+    const { nextMoves } = require('../lib/next-moves');
+    const { resolveFunctionalOwner } = require('../lib/functional-owner');
+    const all = (nextMoves(root, 5) || []).filter((move) => move && move.title);
+    const ready = all.filter((move) => operatorReady(move.title)).slice(0, 3).map((move) => {
+      let owner = null;
+      try { owner = resolveFunctionalOwner({ title: move.title, root })?.owner || null; } catch {}
+      return { title: move.title, owner };
+    });
+    return { moves: ready, unexplained: all.length - ready.length };
+  } catch {
+    return { moves: [], unexplained: 0 };
+  }
+}
+
 function flag(args, name, fallback = '') {
   const idx = args.indexOf(name);
   if (idx === -1) return fallback;
@@ -24,9 +44,11 @@ function flag(args, name, fallback = '') {
 }
 
 function runOwnCli(root, cliArgs) {
-  const bin = path.join(root, 'bin', 'atris.js');
-  const argv = fs.existsSync(bin) ? [process.execPath, [bin, ...cliArgs]] : ['atris', [cliArgs].flat()];
-  const result = spawnSync(argv[0], argv[1], { cwd: root, encoding: 'utf8', timeout: 300000 });
+  // Always spawn the bin this module shipped with. Resolving through the
+  // target root or a global `atris` breaks whenever the tick runs a project
+  // that isn't the CLI repo on a machine without a global install (CI, cron).
+  const bin = path.resolve(__dirname, '..', 'bin', 'atris.js');
+  const result = spawnSync(process.execPath, [bin, ...cliArgs], { cwd: root, encoding: 'utf8', timeout: 300000 });
   return { status: result.status, stdout: String(result.stdout || ''), stderr: String(result.stderr || '') };
 }
 
@@ -186,6 +208,7 @@ function runDigest(root, args, { forceSend = false } = {}) {
     waiting: autoland.waitingOnHuman(tasks),
     landed: landSummarySafe(root),
     project: projectName(root),
+    nextMoves: digestNextMoves(root),
   });
   console.log(text);
   // the full story: what each piece actually was, in its own words
@@ -195,10 +218,15 @@ function runDigest(root, args, { forceSend = false } = {}) {
     return t && (t.review?.landing?.happened || t.metadata?.landing_happened);
   });
   if (storied.length > 0) {
-    console.log('');
+    let printedStoryHeader = false;
     for (const item of storied) {
       const t = byRef.get(item.ref);
       const happened = String(t.review?.landing?.happened || t.metadata?.landing_happened || '').replace(/\s+/g, ' ').slice(0, 160);
+      if (!operatorReady(happened)) continue;
+      if (!printedStoryHeader) {
+        console.log('');
+        printedStoryHeader = true;
+      }
       console.log(`  ${item.ref}  ${happened}`);
     }
   }
@@ -221,7 +249,22 @@ function runTick(root, args) {
     return 0;
   }
 
-  // 1. land what is eligible — the policy is the standing authorization
+  // 1. certify what has executable proof — re-run the runnable check named in
+  // each Review proof as a second actor. Without this the tick only lands rows
+  // some always-on mission happened to certify, and everything else waits on a
+  // human who never needed to look. Denied lanes and check-less proofs still wait.
+  if (policy.drain_reviews !== false) {
+    const certify = runOwnCli(root, ['task', 'certify-verified', '--json']);
+    try {
+      const parsed = JSON.parse(certify.stdout);
+      receipt.reviews_certified = parsed.certified ?? 0;
+      if (parsed.ok !== true) receipt.certify_error = 'certify-verified failed';
+    } catch {
+      receipt.certify_error = certify.stderr.slice(0, 200) || 'certify-verified output unreadable';
+    }
+  }
+
+  // 2. land what is eligible — the policy is the standing authorization
   const cliArgs = ['task', 'auto-accept-certified', '--json', '--limit', '12'];
   if (policy.strict_verify !== false) cliArgs.push('--strict-verify');
   const accept = runOwnCli(root, cliArgs);
@@ -232,7 +275,23 @@ function runTick(root, args) {
     receipt.accept_error = accept.stderr.slice(0, 200) || 'auto-accept output unreadable';
   }
 
-  // 2. alarm on anything waiting on a human past the line
+  // 2b. tell the operator the moment something lands: one text, one landing
+  // sentence per piece (the day-one PM sentence written at finish time),
+  // capped at three with the rest counted. Off with live_updates: false.
+  const tasksForLive = readProjection(root);
+  if (receipt.landed.length > 0 && policy.imessage_to && policy.live_updates !== false) {
+    const text = autoland.composeLiveUpdate({
+      landedRefs: receipt.landed,
+      tasks: tasksForLive,
+      project: projectName(root),
+    });
+    if (text) {
+      const sent = autoland.sendImessage(root, policy.imessage_to, text);
+      receipt.live_update_sent = sent.ok;
+    }
+  }
+
+  // 3. alarm on anything waiting on a human past the line
   const state = autoland.readState(root);
   const tasks = readProjection(root);
   const waiting = autoland.waitingOnHuman(tasks);
@@ -247,7 +306,7 @@ function runTick(root, args) {
     }
   }
 
-  // 3. daily digest at the configured hour
+  // 4. daily digest at the configured hour
   const today = new Date().toISOString().slice(0, 10);
   const digestHour = Number(policy.digest_hour ?? autoland.DEFAULT_DIGEST_HOUR);
   if (new Date().getHours() === digestHour && state.last_digest_date !== today) {
@@ -256,6 +315,7 @@ function runTick(root, args) {
       waiting,
       landed: landSummarySafe(root),
       project: projectName(root),
+      nextMoves: digestNextMoves(root),
     });
     if (policy.imessage_to) {
       const sent = autoland.sendImessage(root, policy.imessage_to, text);
@@ -264,7 +324,7 @@ function runTick(root, args) {
     receipt.digest_text = text;
     state.last_digest_date = today;
 
-    // 4. once a day, keep the receipt shelf lean: compress old run receipts
+    // 5. once a day, keep the receipt shelf lean: compress old run receipts
     // into the manifest and drop unreferenced clutter, newest 200 kept.
     const prune = runOwnCli(root, ['mission', 'prune-runs', '--apply', '--days', '14', '--keep-newest', '200', '--json']);
     try {
@@ -278,7 +338,7 @@ function runTick(root, args) {
 
   if (json) console.log(JSON.stringify(receipt));
   else {
-    console.log(`autoland tick: ${receipt.landed.length} landed${receipt.landed.length ? ` (${receipt.landed.join(', ')})` : ''}, ${receipt.alarms} alarms, digest ${receipt.digest_sent ? 'sent' : 'not due'}`);
+    console.log(`autoland tick: ${receipt.reviews_certified ?? 0} reviews certified, ${receipt.landed.length} landed${receipt.landed.length ? ` (${receipt.landed.join(', ')})` : ''}, ${receipt.alarms} alarms, digest ${receipt.digest_sent ? 'sent' : 'not due'}`);
   }
   return 0;
 }
@@ -297,15 +357,21 @@ function showHelp() {
   console.log('                                     on you past 24h');
   console.log('  atris autoland off                 back to approving every item');
   console.log('  atris autoland digest [--send]     the daily message, now');
-  console.log('  atris autoland tick                one heartbeat (what the hourly cron runs)');
+  console.log('  atris autoland tick [--json]       one heartbeat (what the hourly cron runs)');
+  console.log('');
+  console.log('help is always read-only: atris autoland tick --help never lands work.');
   console.log('');
   return 0;
 }
 
+function wantsHelp(args = []) {
+  return args.some((arg) => arg === 'help' || arg === '--help' || arg === '-h');
+}
+
 function autolandCommand(args = []) {
   const [sub, ...rest] = args;
+  if (wantsHelp(args)) return showHelp();
   if (!sub || sub.startsWith('--')) return showStatus(repoRoot(), args);
-  if (sub === 'help' || sub === '--help' || sub === '-h') return showHelp();
   const root = repoRoot();
   if (sub === 'on') return turnOn(root, rest);
   if (sub === 'off') return turnOff(root);
@@ -316,4 +382,4 @@ function autolandCommand(args = []) {
   return 1;
 }
 
-module.exports = { autolandCommand };
+module.exports = { autolandCommand, operatorReady, hasAgentJargon };