atris 3.56.1 → 3.56.2

package/bin/atris.js

@@ -211,7 +211,7 @@ function parseNaturalEntryArgs(args = []) {
   };
 }
 
-function applyRunnerFlags(args) {
+function applyRunnerFlags(args, options = {}) {
   // --engine <name> is the operator-facing spelling of --runner-profile:
   // one flag rents a specific intelligence for this run.
   const engineFlag = readOptionArg(args, '--engine');
@@ -251,6 +251,9 @@ function applyRunnerFlags(args) {
     process.env.ATRIS_RUNNER_MODEL = runnerModel;
     process.env.ATRIS_CLAUDE_MODEL = runnerModel;
   }
+  // Talk-only and unbound scratch still validate --engine / --runner-profile.
+  // They skip this seed so resolveDefaultEngine cannot mint engines.json.
+  if (options.seed === false) return;
   // 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
@@ -632,6 +635,8 @@ function showHelpAll() {
   console.log('  experiments init [slug]     - Prepare atris/experiments/ or scaffold a pack');
   console.log('  experiments validate        - Validate experiment packs');
   console.log('  experiments run <slug>      - Execute a pack or record an Endstate receipt');
+  console.log('  experiments keep <slug>     - Keep a pack only when measure.py moves 0 to 1');
+  console.log('  experiments revert <slug>   - Run a pack reset.py after a refused keep');
   console.log('  experiments benchmark [m]   - Run validate/runtime experiment benchmarks');
   console.log('  bench      - run core benchmark gates');
   console.log('');
@@ -2442,7 +2447,14 @@ if (command === 'init') {
     process.exit(0);
   }
 
-  applyRunnerFlags(args);
+  const { isUnboundScratchFolder } = require('../lib/scratch-root');
+  const { runObjective, runMissionFront } = require('../commands/run-front');
+  const runTalkOnly = !runObjective(args) && !hasYesFlag(args) && !args.includes('--legacy');
+  // Flag validation always runs. The engine-registry seed is what mints
+  // .atris/state/engines.json, so first-talk and unbound scratch skip only that.
+  applyRunnerFlags(args, {
+    seed: !runTalkOnly && !isUnboundScratchFolder(process.cwd()),
+  });
 
   if (args.includes('--legacy')) {
     const legacyArgs = args.filter(a => a !== '--legacy');
@@ -2462,7 +2474,7 @@ if (command === 'init') {
         process.exit(1);
       });
   } else {
-    require('../commands/run-front').runMissionFront(args)
+    runMissionFront(args)
       .then((code) => process.exit(code || 0))
       .catch((error) => {
         console.error(`\u2717 Run failed: ${error.message || error}`);
@@ -2486,8 +2498,8 @@ if (command === 'init') {
   if (!autopilotHelp && !autopilotControl && !autopilotJsonPlan && !autopilotTalkOnly && isUnboundScratchFolder(autopilotRoot)) {
     process.exit(refuseUnboundScratch());
   }
-  if (!autopilotHelp && !isUnboundScratchFolder(autopilotRoot)) {
-    applyRunnerFlags(args);
+  if (!autopilotHelp) {
+    applyRunnerFlags(args, { seed: !isUnboundScratchFolder(autopilotRoot) });
   }
 
   if (args.includes('--legacy')) {

package/commands/auth.js

@@ -1,4 +1,4 @@
-const { loadCredentials, saveCredentials, deleteCredentials, getCredentialsPath, openBrowser, promptUser, displayAccountSummary, ensureValidCredentials, loadProfile, listProfiles, profileNameFromEmail, deleteProfile, saveProfile, getTokenExpiryEpochSeconds, getTerminalSessionId, setSessionProfile, getSessionProfile, clearSessionProfile, cleanStaleSessions, getSessionsDir } = require('../utils/auth');
+const { AGENT_TOKEN_EXPIRED_DETAIL, loadCredentials, saveCredentials, deleteCredentials, getCredentialsPath, openBrowser, promptUser, displayAccountSummary, ensureValidCredentials, loadProfile, listProfiles, profileNameFromEmail, deleteProfile, saveProfile, getTokenExpiryEpochSeconds, getTerminalSessionId, setSessionProfile, getSessionProfile, clearSessionProfile, cleanStaleSessions, getSessionsDir } = require('../utils/auth');
 const { getAppBaseUrl, apiRequestJson } = require('../utils/api');
 const { isNonInteractive, wantsJson } = require('../lib/noninteractive');
 const { hasFlag, readFlag } = require('../lib/arg-parser');
@@ -281,6 +281,11 @@ async function mintAgentToken(args = [], deps = {}) {
 async function printWhoamiPayload(asJson) {
   const ensured = await ensureValidCredentials(apiRequestJson);
   if (ensured.error) {
+    if (!asJson && ensured.detail === AGENT_TOKEN_EXPIRED_DETAIL) {
+      console.error('the agent key expired.');
+      console.error('atris login --agent');
+      process.exit(1);
+    }
     if (asJson) {
       console.log(JSON.stringify({
         ok: false,

package/commands/engine.js

@@ -25,6 +25,7 @@ const {
   buildRunnerCommand,
 } = require('../lib/runner-command');
 const { parseScopeFlag } = require('../lib/cli-scope');
+const { isFreshWorkspace, speakFirstMinute } = require('../lib/first-minute');
 const {
   ENGINE_ROLES,
   ENGINE_DUTIES,
@@ -1541,6 +1542,9 @@ function engineCommand(args = [], deps = {}) {
   }
 
   if (sub === 'chart' || scope.args.includes('--chart') || args.includes('--chart')) {
+    if (isFreshWorkspace(root)) {
+      return speakFirstMinute({ root, fresh: true, asJson: json });
+    }
     printEngineChart(root);
     return 0;
   }
@@ -1551,6 +1555,9 @@ function engineCommand(args = [], deps = {}) {
       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');
       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));
       return 0;

package/commands/experiments.js

@@ -138,6 +138,176 @@ function runPython(scriptPath, args = [], cwd = process.cwd()) {
   }
 }
 
+function parseMeasureScore(stdout) {
+  const line = String(stdout || '').trim().split(/\r?\n/).filter(Boolean).pop();
+  if (!line) return { ok: false, error: 'measure.py printed no score' };
+  try {
+    const payload = JSON.parse(line);
+    const score = Number(payload.score);
+    if (!Number.isFinite(score)) return { ok: false, error: 'measure.py printed no score' };
+    return { ok: true, score, payload };
+  } catch {
+    return { ok: false, error: 'measure.py printed no score' };
+  }
+}
+
+function runMeasureJson(scriptPath, workspaceDir = process.cwd()) {
+  const python = resolvePython();
+  if (!python) {
+    return { ok: false, error: 'python not found. set ATRIS_EXPERIMENTS_PYTHON or install python3.' };
+  }
+
+  const result = spawnSync(python, [scriptPath], {
+    cwd: workspaceDir,
+    encoding: 'utf8',
+    env: {
+      ...process.env,
+      PYTHONDONTWRITEBYTECODE: '1',
+      ATRIS_REPO_ROOT: workspaceDir,
+    },
+  });
+
+  if (result.error) {
+    return { ok: false, error: result.error.message || 'measure.py failed to start' };
+  }
+
+  const parsed = parseMeasureScore(result.stdout);
+  if (!parsed.ok) {
+    const detail = String(result.stderr || '').trim().split(/\r?\n/).filter(Boolean).pop();
+    return { ok: false, error: detail || parsed.error };
+  }
+  return parsed;
+}
+
+function experimentsKeep(name) {
+  const token = String(name || '').trim();
+  if (!token || token === '--help' || token === '-h' || token === 'help') {
+    console.error('usage: atris experiments keep <slug>');
+    process.exit(2);
+  }
+  if (!SLUG_RE.test(token)) {
+    console.error('invalid experiment name. use a lowercase-hyphen slug.');
+    process.exit(2);
+  }
+
+  const workspaceDir = process.cwd();
+  if (!fs.existsSync(path.join(workspaceDir, 'atris'))) {
+    console.error('atris/ folder not found. run "atris init" first.');
+    process.exit(2);
+  }
+
+  const packDir = path.join(workspaceDir, 'atris', 'experiments', token);
+  if (!fs.existsSync(packDir) || !fs.statSync(packDir).isDirectory()) {
+    console.error(`experiment "${token}" not found.`);
+    process.exit(2);
+  }
+
+  const measurePath = path.join(packDir, 'measure.py');
+  if (!fs.existsSync(measurePath)) {
+    console.error(`experiment "${token}" has no measure.py.`);
+    process.exit(2);
+  }
+
+  // Change is already on disk. Minted packs start at 0; keep only if current score is 1.
+  const measured = runMeasureJson(measurePath, workspaceDir);
+  if (!measured.ok) {
+    console.error(`revert ${token}: ${measured.error}. refuse keep.`);
+    process.exit(1);
+  }
+
+  if (measured.score === 1) {
+    console.log(`keep ${token}: measure.py moved 0→1`);
+    return;
+  }
+
+  const stayed = measured.score === 0 ? '0' : String(measured.score);
+  console.error(`revert ${token}: measure.py stayed ${stayed}. refuse keep.`);
+  process.exit(1);
+}
+
+function lastProcessLine(result) {
+  const text = `${result && result.stderr ? result.stderr : ''}\n${result && result.stdout ? result.stdout : ''}`;
+  return text.trim().split(/\r?\n/).filter(Boolean).pop() || '';
+}
+
+function runResetScript(scriptPath, workspaceDir = process.cwd()) {
+  const python = resolvePython();
+  if (!python) {
+    return { ok: false, error: 'python not found. set ATRIS_EXPERIMENTS_PYTHON or install python3.' };
+  }
+
+  const result = spawnSync(python, [scriptPath], {
+    cwd: workspaceDir,
+    encoding: 'utf8',
+    env: {
+      ...process.env,
+      PYTHONDONTWRITEBYTECODE: '1',
+      ATRIS_REPO_ROOT: workspaceDir,
+    },
+  });
+
+  if (result.error) {
+    return { ok: false, error: result.error.message || 'reset.py failed to start' };
+  }
+
+  if (typeof result.status === 'number' && result.status !== 0) {
+    return { ok: false, error: lastProcessLine(result) || `reset.py exited ${result.status}` };
+  }
+
+  if (result.status == null) {
+    return { ok: false, error: lastProcessLine(result) || 'reset.py failed' };
+  }
+
+  return { ok: true };
+}
+
+function experimentsRevert(name) {
+  const token = String(name || '').trim();
+  if (!token || token === '--help' || token === '-h' || token === 'help') {
+    console.error('usage: atris experiments revert <slug>');
+    process.exit(2);
+  }
+  if (!SLUG_RE.test(token)) {
+    console.error('invalid experiment name. use a lowercase-hyphen slug.');
+    process.exit(2);
+  }
+
+  const workspaceDir = process.cwd();
+  if (!fs.existsSync(path.join(workspaceDir, 'atris'))) {
+    console.error('atris/ folder not found. run "atris init" first.');
+    process.exit(2);
+  }
+
+  const packDir = path.join(workspaceDir, 'atris', 'experiments', token);
+  if (!fs.existsSync(packDir) || !fs.statSync(packDir).isDirectory()) {
+    console.error(`experiment "${token}" not found.`);
+    process.exit(2);
+  }
+
+  const resetPath = path.join(packDir, 'reset.py');
+  if (!fs.existsSync(resetPath)) {
+    console.error(`experiment "${token}" has no reset.py.`);
+    process.exit(2);
+  }
+
+  const reset = runResetScript(resetPath, workspaceDir);
+  if (!reset.ok) {
+    console.error(`revert ${token}: ${reset.error}. refuse revert.`);
+    process.exit(1);
+  }
+
+  const measurePath = path.join(packDir, 'measure.py');
+  if (fs.existsSync(measurePath)) {
+    const measured = runMeasureJson(measurePath, workspaceDir);
+    if (measured.ok) {
+      console.log(`revert ${token}: reset.py ran. measure.py ${measured.score}`);
+      return;
+    }
+  }
+
+  console.log(`revert ${token}: reset.py ran`);
+}
+
 function experimentsInit(name) {
   const { experimentsDir } = ensureExperimentsFramework();
 
@@ -573,6 +743,10 @@ function experimentsCommand(subcommand, ...args) {
       return experimentsReplay(args[0] || 'endstate');
     case 'run':
       return experimentsRun(args[0], ...args.slice(1));
+    case 'keep':
+      return experimentsKeep(args[0]);
+    case 'revert':
+      return experimentsRevert(args[0]);
     default:
       console.log('');
       console.log('Usage: atris experiments <subcommand> [name]');
@@ -581,6 +755,8 @@ function experimentsCommand(subcommand, ...args) {
       console.log('  init [slug]          Prepare atris/experiments/ or scaffold a new pack');
       console.log('  validate [path|slug] Run structural validation on packs or a single pack');
       console.log('  run <slug>           Execute a pack or record an Endstate benchmark receipt');
+      console.log('  keep <slug>          Keep a pack only when measure.py moves 0 to 1');
+      console.log('  revert <slug>        Run a pack reset.py to restore the working tree');
       console.log('  compare endstate     Compare the latest baseline and stack receipts');
       console.log('  replay endstate      Validate, dry-run, and compare the public benchmark flow');
       console.log('  benchmark [mode]     Run validate/runtime/all benchmark harness');
@@ -592,6 +768,8 @@ function experimentsCommand(subcommand, ...args) {
       console.log('  atris experiments init self-heal');
       console.log('  atris experiments validate');
       console.log('  atris experiments run endstate-baseline --dry-run');
+      console.log('  atris experiments keep teach-teach01-s1');
+      console.log('  atris experiments revert teach-teach01-s1');
       console.log('  atris experiments compare endstate');
       console.log('  atris experiments replay endstate');
       console.log('  atris experiments benchmark runtime');

package/commands/founder.js

@@ -3,6 +3,7 @@
 const fs = require('node:fs');
 const path = require('node:path');
 const { spawnSync } = require('node:child_process');
+const { isFreshWorkspace, speakFirstMinute } = require('../lib/first-minute');
 
 const DAY_MS = 24 * 60 * 60 * 1000;
 const DEFAULT_DAYS = 28;
@@ -321,6 +322,17 @@ function founderCommand(args = [], options = {}) {
 
   const cwd = path.resolve(options.cwd || process.cwd());
   const currentWorkspace = workspaceRoot(cwd);
+
+  // Empty folder talks like bare atris. Do not write scorecard.jsonl.
+  // After init, founder still lists and scores.
+  if (isFreshWorkspace(cwd) || isFreshWorkspace(currentWorkspace)) {
+    return speakFirstMinute({
+      root: cwd,
+      fresh: true,
+      asJson: parsed.json,
+    });
+  }
+
   const root = parsed.root
     ? path.resolve(cwd, parsed.root)
     : (parsed.global ? defaultScanRoot(cwd, currentWorkspace) : currentWorkspace);

package/commands/human-missions.js

@@ -14,7 +14,15 @@ const {
 const { apiRequestJson } = require('../utils/api');
 const { decodeJwtClaims, loadCredentials } = require('../utils/auth');
 const { isHelpToken } = require('../lib/noninteractive');
-const { isFreshWorkspace, speakFirstMinute, speakNothingRunning } = require('../lib/first-minute');
+const {
+  buildFirstMinute,
+  isClaimMinute,
+  isFreshWorkspace,
+  isKeepWorkingMinute,
+  speakFirstMinute,
+  speakKeepWorkingMinute,
+  speakNothingRunning,
+} = require('../lib/first-minute');
 
 const PACKAGE_PATH = path.join(__dirname, '..', 'package.json');
 const HUMAN_STATES = Object.freeze({
@@ -168,8 +176,10 @@ function parseMissionId(args = []) {
 
 /**
  * Scratch / unbound folders must not drive account-current cloud work.
- * Empty-folder stop talks first-talk instead. After a room exists,
- * require an explicit mission/task id: atris stop --mission <id>
+ * Empty-folder stop talks first-talk instead. After do/claim, nothing
+ * running talks keep-working instead. After init, claim-ready talks
+ * the claim instead. After a room exists without that keep-working
+ * or claim next, require an explicit id: atris stop --mission <id>
  */
 function refuseUnboundCloudComputer(args = [], options = {}, commandName = 'stop') {
   const root = options.root || process.cwd();
@@ -739,6 +749,15 @@ async function approveCommand(args, options = {}) {
   return changeCurrentMission('approve', {}, args, options);
 }
 
+function hasLiveKeepWorkingRun(root = process.cwd()) {
+  try {
+    const { pickLiveLocalMission } = require('./mission');
+    return Boolean(pickLiveLocalMission(root));
+  } catch {
+    return false;
+  }
+}
+
 async function stopCommand(args, options = {}) {
   if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
     (options.log || console.log)('Usage: atris stop [--mission <id>] [--json]');
@@ -746,16 +765,35 @@ async function stopCommand(args, options = {}) {
   }
   const root = options.root || process.cwd();
   const asJson = args.includes('--json');
+  const speak = {
+    root,
+    asJson,
+    log: options.log || console.log,
+  };
   // Fresh folder: empty talks first-talk. A file already here
   // names that file, same as bare atris. Do not mint a room.
   if (isFreshWorkspace(root) && !parseMissionId(args)) {
     const unbound = refuseUnboundCloudComputer(args, options, 'stop');
     if (unbound) {
-      return speakNothingRunning({
-        root,
-        asJson,
-        log: options.log || console.log,
-      });
+      return speakNothingRunning(speak);
+    }
+  }
+  // After do/claim, nothing running: same two keep-working
+  // lines as bare atris / status / recap. After init, next
+  // is claim: same two lines as bare atris / status / now.
+  // Not factory cloud-computer. Do not mint a room or bind
+  // a computer. A bound computer still stops the current
+  // mission.
+  if (!parseMissionId(args) && !hasLiveKeepWorkingRun(root)) {
+    const unbound = refuseUnboundCloudComputer(args, options, 'stop');
+    if (unbound) {
+      const minute = buildFirstMinute({ root });
+      if (isKeepWorkingMinute(minute)) {
+        return speakKeepWorkingMinute(speak);
+      }
+      if (isClaimMinute(minute)) {
+        return speakFirstMinute(speak);
+      }
     }
   }
   return changeCurrentMission('stop', {}, args, options);

package/commands/launchpad.js

@@ -3,6 +3,14 @@
 const fs = require('fs');
 const path = require('path');
 const { hasFlag, readFlag } = require('../lib/arg-parser');
+const {
+  isFreshWorkspace,
+  isKeepWorkingMinute,
+  isClaimMinute,
+  buildFirstMinute,
+  speakFirstMinute,
+  speakKeepWorkingMinute,
+} = require('../lib/first-minute');
 
 const ACTIVE_MISSION_STATUSES = new Set(['planning', 'running', 'ready']);
 
@@ -185,15 +193,18 @@ function loadTaskProjection(root) {
   };
 }
 
-function chooseNextAction({ root, actor, tasks, missions, brain, endgame }) {
-  if (!fs.existsSync(path.join(root, 'atris'))) {
-    return {
-      kind: 'bootstrap',
-      label: 'Initialize this workspace',
-      command: 'atris init',
-      why: 'No atris/ directory exists yet.',
-    };
+function hasLiveKeepWorkingRun(root = process.cwd()) {
+  try {
+    const { pickLiveLocalMission } = require('./mission');
+    return Boolean(pickLiveLocalMission(root));
+  } catch {
+    return false;
   }
+}
+
+function chooseNextAction({ actor, tasks, missions, brain, endgame }) {
+  // No-room folders belong to first-minute, not factory init.
+  // launchpadCommand speaks those two lines before this ranking runs.
 
   const ownClaimed = newest(tasks.filter(task => (
     task.status === 'claimed'
@@ -609,8 +620,32 @@ function launchpadCommand(args = []) {
     showLaunchpadHelp();
     return 0;
   }
-  const payload = collectLaunchpad(process.cwd(), args);
-  if (hasFlag(args, '--json')) {
+  const asJson = hasFlag(args, '--json');
+  const root = process.cwd();
+
+  // Fresh folder: empty talks first-talk. A file already here
+  // names that file, same as bare atris. Do not mint a room.
+  if (isFreshWorkspace(root)) {
+    return speakFirstMinute({ root, fresh: true, asJson });
+  }
+
+  // Just-minted file folder, nothing running: same two lines as
+  // first-minute / the next keep-working ready. After init, next is claim: same
+  // two lines as bare atris / status / now. Not factory init.
+  // A live mission still gets the board. --json on the claim
+  // path keeps the factory card for scripts.
+  if (!hasLiveKeepWorkingRun(root)) {
+    const minute = buildFirstMinute({ root });
+    if (isKeepWorkingMinute(minute)) {
+      return speakKeepWorkingMinute({ root, asJson });
+    }
+    if (!asJson && isClaimMinute(minute)) {
+      return speakFirstMinute({ root });
+    }
+  }
+
+  const payload = collectLaunchpad(root, args);
+  if (asJson) {
     console.log(JSON.stringify(payload, null, 2));
   } else {
     process.stdout.write(renderLaunchpad(payload));

package/commands/now.js

@@ -3,6 +3,13 @@ const path = require('path');
 const { hasRenderedSections, isOpenSection } = require('../lib/todo-sections');
 const { renderMorningCardRow } = require('../lib/receipt-block');
 const { historicalLandingText } = require('../lib/autoland');
+const {
+  buildFirstMinute,
+  isFreshWorkspace,
+  isKeepWorkingMinute,
+  speakFirstMinute,
+  speakKeepWorkingMinute,
+} = require('../lib/first-minute');
 
 const NOW_PATH = path.join('atris', 'now.md');
 const TASK_EPISODES_PATH = path.join('.atris', 'state', 'task_episodes.jsonl');
@@ -589,8 +596,16 @@ function printNowJson(payload) {
   console.log(JSON.stringify(payload, null, 2));
 }
 
+function hasLiveKeepWorkingRun(root = process.cwd()) {
+  try {
+    const { pickLiveLocalMission } = require('./mission');
+    return Boolean(pickLiveLocalMission(root));
+  } catch {
+    return false;
+  }
+}
+
 function nowJsonPayload(root = process.cwd()) {
-  const { buildFirstMinute, isFreshWorkspace } = require('../lib/first-minute');
   const fresh = isFreshWorkspace(root);
   const screen = buildFirstMinute({ root, fresh });
   const payload = { ok: !fresh };
@@ -630,6 +645,26 @@ function nowAtris(args = process.argv.slice(3), root = process.cwd()) {
       return payload.ok ? 0 : 2;
     }
 
+    // Fresh folder: empty talks first-talk. A file already here
+    // names that file, same as bare atris / now --json. Do not mint.
+    // Just-minted file folder, nothing running: same two lines as
+    // first-minute / status / recap. Not factory MAP.md.
+    // After init, next is claim: same two lines as bare atris /
+    // now --json. Not factory now.md.
+    // --init / --refresh / --all / --path still write now.md.
+    if (!init && !refresh && !all && !pathOnly) {
+      if (isFreshWorkspace(root)) {
+        return speakFirstMinute({ root, fresh: true });
+      }
+      if (!hasLiveKeepWorkingRun(root)) {
+        const minute = buildFirstMinute({ root });
+        if (isKeepWorkingMinute(minute)) {
+          return speakKeepWorkingMinute({ root });
+        }
+        return speakFirstMinute({ root });
+      }
+    }
+
     let result;
     if (all) {
       const workspaces = findChildWorkspaces(root);

package/commands/recap.js

@@ -4,11 +4,13 @@ const {
   isCertifiedReview,
   isFreshWorkspace,
   isKeepWorkingMinute,
+  isClaimMinute,
   buildFirstMinute,
   listUserVisibleWork,
   personName,
   speakFirstMinute,
   speakKeepWorkingMinute,
+  taskCommand,
 } = require('../lib/first-minute');
 const { isRealTestRunnerProof, quoteVerifierCommand } = require('../lib/verifier-quality');
 
@@ -319,7 +321,7 @@ function renderRecapMinute(data, { person } = {}) {
       return [
         `${greet}${named} is already yours.`,
         '',
-        'next: atris do',
+        `next: ${taskCommand({ display_id: item.id, status: 'claimed' })}`,
       ].join('\n');
     }
     if (named) return `${greet}${named} is ready to claim.`;
@@ -348,7 +350,22 @@ function recapAtris(args = []) {
     printRecapHelp();
     return;
   }
-  const root = process.cwd();
+  const cwd = process.cwd();
+  const taskDb = loadTaskDb();
+  let root = cwd;
+  try {
+    root = taskDb ? taskDb.workspaceRoot(cwd) : cwd;
+  } catch {
+    root = cwd;
+  }
+  // cd src in a real git project still recaps that project. An empty
+  // child under /tmp stays its own room and does not inherit /tmp.
+  let inProjectSubdir = false;
+  try {
+    inProjectSubdir = fs.realpathSync(cwd) !== fs.realpathSync(root);
+  } catch {
+    inProjectSubdir = path.resolve(cwd) !== path.resolve(root);
+  }
   const visibleBefore = listUserVisibleWork(root);
   const daysIdx = args.indexOf('--days');
   const days = daysIdx !== -1 ? Number(args[daysIdx + 1]) : DEFAULT_DAYS;
@@ -356,6 +373,7 @@ function recapAtris(args = []) {
   if (
     data.empty
     && isFreshWorkspace(root)
+    && !inProjectSubdir
     && !args.includes('--verbose')
     && !args.includes('--full')
     && !args.includes('--share')
@@ -367,13 +385,18 @@ function recapAtris(args = []) {
     });
   }
   // Just-minted file folder, nothing running: same two lines as
-  // first-minute / status / the next do. Not factory MAP.md.
+  // first-minute / status / recap. After the work is yours, next
+  // is task ready so keep-working is not a do loop. Not factory MAP.md.
+  // After init, next is claim: same two lines as bare atris /
+  // status / now / stop. --json keeps the recap receipt and
+  // fills next from first-minute so it is not silent.
   // A claimed non-seed task still recaps that work. A live mission
   // and --verbose / --share keep the recap report.
   if (
     !args.includes('--verbose')
     && !args.includes('--full')
     && !args.includes('--share')
+    && !inProjectSubdir
     && !hasLiveKeepWorkingRun(root)
   ) {
     const minute = buildFirstMinute({ root, files: visibleBefore });
@@ -383,6 +406,14 @@ function recapAtris(args = []) {
         asJson: args.includes('--json'),
       });
     }
+    if (isClaimMinute(minute)) {
+      if (args.includes('--json')) {
+        data.next = minute.nextCommand || null;
+        console.log(JSON.stringify(data, null, 2));
+        return;
+      }
+      return speakFirstMinute({ root });
+    }
   }
   if (args.includes('--json')) {
     console.log(JSON.stringify(data, null, 2));