atris 3.53.0 → 3.55.0

package/commands/workflow.js

@@ -1,6 +1,20 @@
 const fs = require('fs');
 const path = require('path');
 const { getLogPath } = require('../lib/journal');
+const {
+  buildFirstMinute,
+  folderName,
+  freshMinuteJson,
+  isCertifiedReview,
+  isFreshWorkspace,
+  personName,
+  pickNext,
+  renderWorkspace,
+  speakFirstMinute,
+  taskCommand,
+} = require('../lib/first-minute');
+const { isNonInteractive } = require('../lib/noninteractive');
+const { loadContext } = require('../lib/state-detection');
 const { buildToolResultBody } = require('../lib/tool-result-encode');
 
 function wrapWorkflowText(text, width = 76) {
@@ -42,6 +56,98 @@ function printWorkflowBrief(lines) {
   console.log('');
 }
 
+function reviewSoftTitle(title, maxWords = 5) {
+  const words = String(title || '').replace(/\s+/g, ' ').trim().split(' ').filter(Boolean);
+  if (!words.length) return '';
+  const text = words.slice(0, maxWords).join(' ').replace(/[.,;:!?]+$/g, '');
+  return `"${text.toLowerCase()}"`;
+}
+
+function isHumanDeskNext(command) {
+  return /^atris task (?:claim|ready|accept)\b/.test(String(command || ''));
+}
+
+function loadReviewTasks(root = process.cwd()) {
+  try {
+    const taskDb = require('../lib/task-db');
+    const db = taskDb.open();
+    const workspaceRoot = taskDb.workspaceRoot(root);
+    const rows = taskDb.listTasks(db, { workspaceRoot, limit: 200 });
+    if (Array.isArray(rows) && rows.length) return taskDb.withTaskDisplayRefs(rows);
+  } catch {
+    // Fall through to the local projection. Tests and fresh folders often have no db.
+  }
+  const projectionPath = path.join(root, '.atris', 'state', 'tasks.projection.json');
+  try {
+    const parsed = JSON.parse(fs.readFileSync(projectionPath, 'utf8'));
+    return Array.isArray(parsed.tasks) ? parsed.tasks : [];
+  } catch {
+    return [];
+  }
+}
+
+function wantsReviewQueue(args = []) {
+  const list = Array.isArray(args) ? args : [];
+  return list.includes('--json')
+    || list.includes('--all')
+    || list.includes('--limit')
+    || list.includes('--group-by');
+}
+
+function renderReviewMinute({
+  root = process.cwd(),
+  person,
+  tasks,
+} = {}) {
+  const who = person != null ? person : personName();
+  const greet = who ? `hey ${who}, ` : '';
+  const all = Array.isArray(tasks) ? tasks : loadReviewTasks(root);
+  const reviews = all.filter((task) => task && task.status === 'review');
+  const checking = reviews.filter((task) => !isCertifiedReview(task));
+  const picked = pickNext({ tasks: reviews, person: who });
+  const task = picked.task || null;
+  const title = task ? reviewSoftTitle(task.title) : '';
+
+  if (task && isCertifiedReview(task)) {
+    const win = title
+      ? `${greet}${title} is waiting for your ok.`
+      : `${greet}one finished thing is waiting for your ok.`;
+    const lines = [win];
+    if (checking.length === 1) lines.push('1 still being checked.');
+    if (checking.length > 1) lines.push(`${checking.length} still being checked.`);
+    lines.push('');
+    lines.push(`next: ${taskCommand(task, who)}`);
+    return lines.join('\n');
+  }
+
+  if (checking.length === 1) {
+    const named = title || reviewSoftTitle(checking[0] && checking[0].title);
+    if (named) return `${greet}${named} is still being checked.`;
+    return `${greet}1 finished thing is still being checked.`;
+  }
+  if (checking.length > 1) {
+    return `${greet}${checking.length} finished things are still being checked.`;
+  }
+
+  // Review is the human desk. If first-minute next is claim, ready, or
+  // accept, say that same next. "nothing is waiting" is only for an empty desk.
+  if (tasks === undefined) {
+    const screen = buildFirstMinute({ root, person: who });
+    if (isHumanDeskNext(screen.nextCommand)) return screen.text;
+  } else {
+    const room = pickNext({ tasks: all, person: who });
+    if (isHumanDeskNext(room.command)) {
+      return renderWorkspace({
+        person: who,
+        folder: folderName(root),
+        task: room.task || null,
+        nextCommand: room.command,
+      });
+    }
+  }
+  return 'nothing is waiting on you.';
+}
+
 const CONFIDENCE_GATE_LINES = [
   'Confidence Gate:',
   '1) Ask: am I factually confident enough to move this forward?',
@@ -375,6 +481,11 @@ async function planAtris(userInput = null) {
   const args = process.argv.slice(3);
   const executeFlag = args.includes('--execute');
   const showFull = args.includes('--full') || args.includes('--verbose');
+  const leftoverRequest = args
+    .filter((token) => !['--execute', '--full', '--verbose', '--json', '--prompt'].includes(token))
+    .join(' ')
+    .trim();
+  const showPrompt = showFull || args.includes('--prompt');
 
   const config = loadConfig();
   // Auto-enable local execution mode for "2 fast" / "2 pro" product aliases.
@@ -388,21 +499,32 @@ async function planAtris(userInput = null) {
     return;
   }
 
-  const targetDir = path.join(process.cwd(), 'atris');
-  const navigatorFile = fs.existsSync(path.join(targetDir, 'team', 'navigator', 'MEMBER.md'))
-    ? path.join(targetDir, 'team', 'navigator', 'MEMBER.md')
-    : path.join(targetDir, 'team', 'navigator.md');
+  const cwd = process.cwd();
+  const targetDir = path.join(cwd, 'atris');
+
+  // Empty folder talks like bare atris. Missing navigator.md after
+  // init --minimal is optional context, not a factory bounce.
+  if (!fs.existsSync(targetDir)) {
+    if (args.includes('--json')) {
+      console.log(JSON.stringify(freshMinuteJson(), null, 2));
+      process.exit(2);
+    }
+    const screen = buildFirstMinute({ root: cwd, fresh: true });
+    console.log('');
+    console.log(screen.text);
+    return;
+  }
+
+  const memberNavigator = path.join(targetDir, 'team', 'navigator', 'MEMBER.md');
+  const legacyNavigator = path.join(targetDir, 'team', 'navigator.md');
+  const navigatorFile = fs.existsSync(memberNavigator)
+    ? memberNavigator
+    : (fs.existsSync(legacyNavigator) ? legacyNavigator : null);
   const personaPath = path.join(targetDir, 'PERSONA.md');
   const mapFilePath = path.join(targetDir, 'MAP.md');
   const featuresReadmePath = path.join(targetDir, 'features', 'README.md');
 
-  if (!fs.existsSync(navigatorFile)) {
-    console.log('✗ navigator.md not found. Run "atris init" first.');
-    process.exit(1);
-  }
-
-  // Read navigator.md
-  const navigatorSpec = fs.readFileSync(navigatorFile, 'utf8');
+  const navigatorSpec = navigatorFile ? fs.readFileSync(navigatorFile, 'utf8') : '';
 
   // Read journal Inbox for context
   const { logFile } = getLogPath();
@@ -429,14 +551,15 @@ async function planAtris(userInput = null) {
 
   // Detect uncertainty in inbox context (or direct user input)
   const uncertaintySignals = ['not sure', 'maybe', 'but ', 'thinking about', 'uncertain', 'unclear', 'unsure', 'don\'t know'];
-  const combinedContext = [userInput, inboxContext].filter(Boolean).join('\n');
+  const requestText = String(userInput || leftoverRequest || '').trim();
+  const combinedContext = [requestText, inboxContext].filter(Boolean).join('\n');
   const hasUncertainty = combinedContext && uncertaintySignals.some(signal =>
     combinedContext.toLowerCase().includes(signal)
   );
 
   const taskSourcePath = taskFilePath ? path.relative(process.cwd(), taskFilePath) : null;
   const journalPath = path.relative(process.cwd(), logFile);
-  const navigatorPath = path.relative(process.cwd(), navigatorFile);
+  const navigatorPath = navigatorFile ? path.relative(process.cwd(), navigatorFile) : null;
   const personaFileRef = fs.existsSync(personaPath) ? path.relative(process.cwd(), personaPath) : null;
   const mapFileRef = fs.existsSync(mapFilePath) ? path.relative(process.cwd(), mapFilePath) : null;
   const featuresReadmeRef = fs.existsSync(featuresReadmePath) ? path.relative(process.cwd(), featuresReadmePath) : null;
@@ -460,7 +583,30 @@ async function planAtris(userInput = null) {
         .length
     : 0;
 
-  console.log('');
+  let firstMinute = null;
+  try {
+    firstMinute = buildFirstMinute({
+      root: cwd,
+      context: loadContext(cwd) || {},
+    });
+  } catch {
+    firstMinute = null;
+  }
+  const showFactory = showPrompt || Boolean(requestText);
+
+  if (showFactory || executionMode !== 'prompt') {
+    console.log(executionMode === 'prompt' ? 'PROMPT ONLY' : 'ACTION TAKEN');
+    console.log('');
+    if (firstMinute && firstMinute.text) {
+      console.log(firstMinute.text);
+      console.log('');
+    }
+  } else if (firstMinute && firstMinute.text) {
+    console.log('');
+    console.log(firstMinute.text);
+  }
+
+  if (showFactory) {
   console.log('┌─────────────────────────────────────────────────────────────┐');
   console.log('│ Atris Plan — Navigator Agent Activated                      │');
   console.log('└─────────────────────────────────────────────────────────────┘');
@@ -479,16 +625,16 @@ async function planAtris(userInput = null) {
     console.log('');
   }
 
-  if (userInput) {
+  if (requestText) {
     console.log('🎯 DIRECT REQUEST:');
     console.log('─────────────────────────────────────────────────────────────');
-    console.log(userInput);
+    console.log(requestText);
     console.log('');
     console.log('─────────────────────────────────────────────────────────────');
     console.log('');
   }
   console.log('📁 CONTEXT FILES (agent should read):');
-  console.log(`- Navigator spec: ${navigatorPath}`);
+  console.log(`- Navigator spec: ${navigatorPath || 'atris/team/navigator/MEMBER.md (missing)'}`);
   console.log(`- Persona: ${personaFileRef || 'atris/PERSONA.md (missing)'}`);
   const mapDisplay = mapFileRef
     ? `${mapFileRef}${mapIsPlaceholder ? ' (placeholder — generate first)' : ''}`
@@ -519,10 +665,12 @@ async function planAtris(userInput = null) {
   console.log('');
 
   if (showFull) {
-    console.log('📋 NAVIGATOR SPEC (full):');
-    console.log('─────────────────────────────────────────────────────────────');
-    console.log(navigatorSpec);
-    console.log('');
+    if (navigatorSpec) {
+      console.log('📋 NAVIGATOR SPEC (full):');
+      console.log('─────────────────────────────────────────────────────────────');
+      console.log(navigatorSpec);
+      console.log('');
+    }
     console.log('📥 INBOX CONTEXT (full):');
     console.log('─────────────────────────────────────────────────────────────');
     console.log(inboxContext || '(No items in Inbox)');
@@ -540,7 +688,7 @@ async function planAtris(userInput = null) {
   console.log('You are the Navigator.');
   console.log('');
   console.log('Read these files:');
-  console.log(`- ${navigatorPath}`);
+  if (navigatorPath) console.log(`- ${navigatorPath}`);
   if (personaFileRef) console.log(`- ${personaFileRef}`);
   if (mapFileRef) console.log(`- ${mapFileRef}`);
   if (taskSourcePath) console.log(`- ${taskSourcePath}`);
@@ -552,9 +700,9 @@ async function planAtris(userInput = null) {
     console.log('Note: If `atris/MAP.md` is missing or placeholder, generate it from `atris/atris.md` before writing tasks.');
     console.log('');
   }
-  if (userInput) {
+  if (requestText) {
     console.log('Direct request:');
-    console.log(userInput);
+    console.log(requestText);
     console.log('');
   }
   console.log('Workflow:');
@@ -578,6 +726,7 @@ async function planAtris(userInput = null) {
   }
   console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
   console.log('');
+  }
 
   // Check execution mode
   if (executionMode === 'agent') {
@@ -613,8 +762,8 @@ async function planAtris(userInput = null) {
     let userPrompt = `You are the Navigator. Take ideas from Inbox → break them down into perfect, manageable tasks.\n\n`;
     userPrompt += `⚠️ CRITICAL: You MUST create visualizations BEFORE writing tasks!\n\n`;
 
-    if (userInput) {
-      userPrompt += `## DIRECT REQUEST:\n${userInput}\n\n`;
+    if (requestText) {
+      userPrompt += `## DIRECT REQUEST:\n${requestText}\n\n`;
     }
 
     if (inboxContext) {
@@ -720,22 +869,33 @@ async function doAtris() {
   const { executeCodeExecution } = require('../utils/claude_sdk');
   const args = process.argv.slice(3);
   const executeFlag = args.includes('--execute');
-  const showFull = args.includes('--full') || args.includes('--verbose');
+  const showFull = args.includes('--full') || args.includes('--verbose') || args.includes('--prompt');
 
   const config = loadConfig();
   const executionMode = executeFlag ? 'agent' : (config.execution_mode || 'prompt');
 
   const cwd = process.cwd();
   const targetDir = path.join(cwd, 'atris');
-  const executorFile = fs.existsSync(path.join(targetDir, 'team', 'executor', 'MEMBER.md'))
-    ? path.join(targetDir, 'team', 'executor', 'MEMBER.md')
-    : path.join(targetDir, 'team', 'executor.md');
 
-  if (!fs.existsSync(executorFile)) {
-    console.log('✗ executor.md not found. Run "atris init" first.');
-    process.exit(1);
+  // Empty folder talks like bare atris. Missing executor.md after
+  // init --minimal is optional context, not a factory bounce.
+  if (!fs.existsSync(targetDir)) {
+    if (args.includes('--json')) {
+      console.log(JSON.stringify(freshMinuteJson(), null, 2));
+      process.exit(2);
+    }
+    const screen = buildFirstMinute({ root: cwd, fresh: true });
+    console.log('');
+    console.log(screen.text);
+    return;
   }
 
+  const memberExecutor = path.join(targetDir, 'team', 'executor', 'MEMBER.md');
+  const legacyExecutor = path.join(targetDir, 'team', 'executor.md');
+  const executorFile = fs.existsSync(memberExecutor)
+    ? memberExecutor
+    : (fs.existsSync(legacyExecutor) ? legacyExecutor : null);
+
   // Load project profile for context
   let context = 'ROOT';
   let profile = null;
@@ -754,8 +914,7 @@ async function doAtris() {
     }
   }
 
-  // Load executor spec
-  const executorSpec = fs.readFileSync(executorFile, 'utf8');
+  const executorSpec = executorFile ? fs.readFileSync(executorFile, 'utf8') : '';
 
   // Load PERSONA.md
   const personaFile = path.join(targetDir, 'PERSONA.md');
@@ -798,7 +957,7 @@ async function doAtris() {
   // All tasks available (no tag filtering)
   const filteredTasks = tasksContent;
 
-  const executorPath = path.relative(process.cwd(), executorFile);
+  const executorPath = executorFile ? path.relative(process.cwd(), executorFile) : null;
   const personaFileRef = fs.existsSync(personaFile) ? path.relative(process.cwd(), personaFile) : null;
   const taskSourcePath = taskFilePath ? path.relative(process.cwd(), taskFilePath) : null;
   const featuresReadmePath = path.join(targetDir, 'features', 'README.md');
@@ -829,44 +988,35 @@ async function doAtris() {
 
   let workspaceSummary = null;
   try {
-    const { loadContext } = require('../lib/state-detection');
     workspaceSummary = loadContext(cwd);
   } catch {
     workspaceSummary = null;
   }
 
-  // Prompt-mode output (keep concise by default)
-  console.log('');
-  console.log('┌─────────────────────────────────────────────────────────────┐');
-  console.log('│ Atris Do — Executor Agent Activated                         │');
-  console.log(`│ Context: ${context}                                           │`);
-  console.log('└─────────────────────────────────────────────────────────────┘');
-  console.log('');
-
-  console.log('📁 CONTEXT FILES (agent should read):');
-  console.log(`- Executor spec: ${executorPath}`);
-  console.log(`- Persona: ${personaFileRef || 'atris/PERSONA.md (missing)'}`);
-  const mapDisplay = mapPath
-    ? `${mapPath}${mapIsPlaceholder ? ' (placeholder — generate first)' : ''}`
-    : 'atris/MAP.md (missing)';
-  console.log(`- MAP: ${mapDisplay}`);
-  console.log(`- TODO: ${taskSourcePath || 'atris/TODO.md (missing)'}`);
-  console.log(`- Features index: ${featuresReadmeRef || 'atris/features/README.md (missing)'}`);
-
-  // Show top learnings during execution
+  let firstMinute = null;
   try {
-    const { loadLearnings } = require('../lib/learnings');
-    const learnings = loadLearnings().filter(e => e._effectiveConfidence >= 7 && e.insight !== '[REMOVED]').slice(0, 3);
-    if (learnings.length > 0) {
+    firstMinute = buildFirstMinute({
+      root: cwd,
+      context: workspaceSummary || {},
+    });
+  } catch {
+    firstMinute = null;
+  }
+  const liveStatus = firstMinute && firstMinute.task && firstMinute.task.status;
+  const hasLiveTask = liveStatus === 'claimed' || liveStatus === 'review' || liveStatus === 'open';
+
+  // Default stays the first-minute two lines. The factory paste stays on --prompt.
+  if (showFull || executionMode !== 'prompt') {
+    console.log(executionMode === 'prompt' ? 'PROMPT ONLY' : 'ACTION TAKEN');
+    console.log('');
+    if (firstMinute && firstMinute.text) {
+      console.log(firstMinute.text);
       console.log('');
-      console.log('🧠 Prior learnings (apply during build):');
-      for (const l of learnings) {
-        console.log(`  [${l._effectiveConfidence}/10] ${l.type}/${l.key}: ${l.insight}`);
-      }
     }
-  } catch {}
-
-  console.log('');
+  } else if (firstMinute && firstMinute.text) {
+    console.log('');
+    console.log(firstMinute.text);
+  }
 
   const backlogCount = workspaceSummary && Array.isArray(workspaceSummary.backlogTasks)
     ? workspaceSummary.backlogTasks.length
@@ -875,51 +1025,77 @@ async function doAtris() {
     ? workspaceSummary.inProgressFeatures.length
     : 0;
 
-  if (inProgressCount > 0) {
-    console.log(`🔨 In-progress features: ${workspaceSummary.inProgressFeatures.join(', ')}`);
-  }
-  console.log(`🧱 Feature build plans found: ${featureBuildPlanRefs.length}`);
-  if (featureBuildPlanRefs.length > 0) {
-    featureBuildPlanRefs.slice(0, 3).forEach((ref) => console.log(`- ${ref}`));
-    if (featureBuildPlanRefs.length > 3) {
-      console.log(`- ... (+${featureBuildPlanRefs.length - 3} more)`);
+  if (showFull) {
+    console.log('📁 CONTEXT FILES (agent should read):');
+    console.log(`- Executor spec: ${executorPath || 'atris/team/executor/MEMBER.md (missing)'}`);
+    console.log(`- Persona: ${personaFileRef || 'atris/PERSONA.md (missing)'}`);
+    const mapDisplay = mapPath
+      ? `${mapPath}${mapIsPlaceholder ? ' (placeholder — generate first)' : ''}`
+      : 'atris/MAP.md (missing)';
+    console.log(`- MAP: ${mapDisplay}`);
+    console.log(`- TODO: ${taskSourcePath || 'atris/TODO.md (missing)'}`);
+    console.log(`- Features index: ${featuresReadmeRef || 'atris/features/README.md (missing)'}`);
+
+    try {
+      const { loadLearnings } = require('../lib/learnings');
+      const learnings = loadLearnings().filter(e => e._effectiveConfidence >= 7 && e.insight !== '[REMOVED]').slice(0, 3);
+      if (learnings.length > 0) {
+        console.log('');
+        console.log('🧠 Prior learnings (apply during build):');
+        for (const l of learnings) {
+          console.log(`  [${l._effectiveConfidence}/10] ${l.type}/${l.key}: ${l.insight}`);
+        }
+      }
+    } catch {}
+
+    console.log('');
+
+    if (inProgressCount > 0) {
+      console.log(`🔨 In-progress features: ${workspaceSummary.inProgressFeatures.join(', ')}`);
     }
-  }
-  console.log(`📋 Backlog tasks: ${backlogCount}`);
-  console.log('');
+    console.log(`🧱 Feature build plans found: ${featureBuildPlanRefs.length}`);
+    if (featureBuildPlanRefs.length > 0) {
+      featureBuildPlanRefs.slice(0, 3).forEach((ref) => console.log(`- ${ref}`));
+      if (featureBuildPlanRefs.length > 3) {
+        console.log(`- ... (+${featureBuildPlanRefs.length - 3} more)`);
+      }
+    }
+    if (!(hasLiveTask && backlogCount === 0)) {
+      console.log(`📋 Backlog tasks: ${backlogCount}`);
+    }
+    console.log('');
 
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('📋 COPY/PASTE PROMPT FOR YOUR CODING AGENT:');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('');
-  console.log('You are the Executor.');
-  console.log('');
-  console.log('Read these files:');
-  console.log(`- ${executorPath}`);
-  if (personaFileRef) console.log(`- ${personaFileRef}`);
-  if (mapPath) console.log(`- ${mapPath}`);
-  if (taskSourcePath) console.log(`- ${taskSourcePath}`);
-  if (featuresReadmeRef) console.log(`- ${featuresReadmeRef}`);
-  console.log('');
-  if (!mapPath || mapIsPlaceholder) {
-    console.log('Note: If `atris/MAP.md` is missing or placeholder, generate it from `atris/atris.md` before navigating the codebase.');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('📋 COPY/PASTE PROMPT FOR YOUR CODING AGENT:');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('');
+    console.log('You are the Executor.');
+    console.log('');
+    console.log('Read these files:');
+    if (executorPath) console.log(`- ${executorPath}`);
+    if (personaFileRef) console.log(`- ${personaFileRef}`);
+    if (mapPath) console.log(`- ${mapPath}`);
+    if (taskSourcePath) console.log(`- ${taskSourcePath}`);
+    if (featuresReadmeRef) console.log(`- ${featuresReadmeRef}`);
+    console.log('');
+    if (!mapPath || mapIsPlaceholder) {
+      console.log('Note: If `atris/MAP.md` is missing or placeholder, generate it from `atris/atris.md` before navigating the codebase.');
+      console.log('');
+    }
+    console.log('Workflow:');
+    console.log('1) Read atris/TODO.md — claim next unclaimed Backlog task');
+    console.log('   Move to ## In Progress: add "Claimed by: executor at YYYY-MM-DD HH:MM"');
+    console.log('2) Run the Confidence Gate against the task before editing');
+    printConfidenceGate('   ');
+    console.log('3) Execute step-by-step. Run tests as you go.');
+    console.log('4) Before completion, rerun the gate against proof and residual risk');
+    console.log('5) When done, move task to ## Completed');
+    console.log('6) Log to atris/team/executor/logs/YYYY-MM-DD.md');
+    console.log('   (Task, Delivered, Errors hit, Learned)');
+    console.log('');
+    console.log('⛔ Do NOT plan — just execute what\'s written.');
     console.log('');
-  }
-  console.log('Workflow:');
-  console.log('1) Read atris/TODO.md — claim next unclaimed Backlog task');
-  console.log('   Move to ## In Progress: add "Claimed by: executor at YYYY-MM-DD HH:MM"');
-  console.log('2) Run the Confidence Gate against the task before editing');
-  printConfidenceGate('   ');
-  console.log('3) Execute step-by-step. Run tests as you go.');
-  console.log('4) Before completion, rerun the gate against proof and residual risk');
-  console.log('5) When done, move task to ## Completed');
-  console.log('6) Log to atris/team/executor/logs/YYYY-MM-DD.md');
-  console.log('   (Task, Delivered, Errors hit, Learned)');
-  console.log('');
-  console.log('⛔ Do NOT plan — just execute what\'s written.');
-  console.log('');
 
-  if (showFull) {
     console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
     console.log('📎 APPENDIX (full context dumps):');
     console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
@@ -932,10 +1108,12 @@ async function doAtris() {
       console.log('');
     }
 
-    console.log('🔧 EXECUTOR SPEC (full):');
-    console.log('─────────────────────────────────────────────────────────────');
-    console.log(executorSpec);
-    console.log('');
+    if (executorSpec) {
+      console.log('🔧 EXECUTOR SPEC (full):');
+      console.log('─────────────────────────────────────────────────────────────');
+      console.log(executorSpec);
+      console.log('');
+    }
 
     if (filteredTasks) {
       console.log(`📋 TASKS TO EXECUTE (full, from ${taskSource}):`);
@@ -944,16 +1122,14 @@ async function doAtris() {
       console.log('');
     }
 
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    if (!hasLiveTask) {
+      console.log('💡 Next: Run "atris review" after execution');
+    }
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('');
   }
 
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('💡 Next: Run "atris review" after execution');
-  if (!showFull) {
-    console.log('   Tip: `atris do --full` prints full spec/context for copy/paste.');
-  }
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('');
-
   // Check execution mode
   if (executionMode === 'agent') {
     // Agent mode: execute via backend API
@@ -1075,41 +1251,44 @@ async function reviewAtris() {
   const executeFlag = args.includes('--execute');
   const showFull = args.includes('--full') || args.includes('--verbose');
   const wantsTaskJson = args.includes('--json');
+  const root = process.cwd();
+  const queueShape = args.some((arg) => arg === '--all' || arg === '--limit' || arg === '--group-by');
+
+  // Empty folder talks like bare atris, including --verbose. After init, stay
+  // in the room. A missing validator spec is optional context, not "run init".
+  if (isFreshWorkspace(root) && !queueShape) {
+    const code = speakFirstMinute({
+      root,
+      fresh: true,
+      asJson: wantsTaskJson,
+    });
+    if (code !== 0) process.exit(code);
+    return;
+  }
 
   if (!executeFlag && !showFull) {
     const forwarded = ['reviews', ...args.filter(arg => !['--execute', '--full', '--verbose'].includes(arg))];
     const { run: runTaskCommand } = require('./task');
-    if (!wantsTaskJson) {
-      printWorkflowBrief([
-        'Atris Review is the human checkpoint for proof-ready work.',
-        'Accept only when the proof is real; revise when the claim is vague, stale, or too narrow.',
-        'Agents can add review proof here, but XP waits for human accept.',
-      ]);
-    }
-    await runTaskCommand(forwarded);
-    if (!wantsTaskJson) {
-      printWorkflowBrief([
-        'Need the legacy Validator prompt? Run `atris review --verbose`.',
-      ]);
+    if (wantsTaskJson || wantsReviewQueue(args)) {
+      await runTaskCommand(forwarded);
+      return;
     }
+    console.log('');
+    console.log(renderReviewMinute());
     return;
   }
 
   const config = loadConfig();
   const executionMode = executeFlag ? 'agent' : (config.execution_mode || 'prompt');
 
-  const targetDir = path.join(process.cwd(), 'atris');
-  const validatorFile = fs.existsSync(path.join(targetDir, 'team', 'validator', 'MEMBER.md'))
-    ? path.join(targetDir, 'team', 'validator', 'MEMBER.md')
-    : path.join(targetDir, 'team', 'validator.md');
-
-  if (!fs.existsSync(validatorFile)) {
-    console.log('✗ validator.md not found. Run "atris init" first.');
-    process.exit(1);
-  }
+  const targetDir = path.join(root, 'atris');
+  const memberValidator = path.join(targetDir, 'team', 'validator', 'MEMBER.md');
+  const legacyValidator = path.join(targetDir, 'team', 'validator.md');
+  const validatorFile = fs.existsSync(memberValidator)
+    ? memberValidator
+    : (fs.existsSync(legacyValidator) ? legacyValidator : null);
 
-  // Read validator.md
-  const validatorSpec = fs.readFileSync(validatorFile, 'utf8');
+  const validatorSpec = validatorFile ? fs.readFileSync(validatorFile, 'utf8') : '';
 
   // Read project-specific testing guide if it exists (optional - projects can add their own)
   // Checks common locations: root, backend/, atris/ directories
@@ -1188,7 +1367,9 @@ async function reviewAtris() {
     }
   })();
 
-  const validatorPath = path.relative(process.cwd(), validatorFile);
+  const validatorPath = validatorFile
+    ? path.relative(process.cwd(), validatorFile)
+    : 'atris/team/validator/MEMBER.md (missing)';
   const todoPathRef = taskFilePath ? path.relative(process.cwd(), taskFilePath) : null;
   const journalPathRef = path.relative(process.cwd(), logFile);
   const personaPath = path.join(targetDir, 'PERSONA.md');
@@ -1494,8 +1675,8 @@ async function reviewAtris() {
     }
   }
 
-  // Prompt for learnings (skip if stdin is not a TTY)
-  if (!process.stdin.isTTY) return;
+  // Prompt for learnings. Headless and forced non-interactive never ask.
+  if (isNonInteractive()) return;
 
   console.log('');
   if (showFull) {
@@ -1648,6 +1829,7 @@ module.exports = {
   planAtris,
   doAtris,
   reviewAtris,
+  renderReviewMinute,
   executeAgentSDKFast,
   makeCloudExecutor,
   postToolResult