atris 3.56.0 → 3.56.2

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/autopilot-front.js

@@ -8,7 +8,10 @@ const fs = require('fs');
 const path = require('path');
 const { spawn } = require('child_process');
 const { pickRunnableMission, runBudgetSeconds } = require('./run-front');
-const { refuseHeadlessUnless, wantsJson, hasYesFlag } = require('../lib/noninteractive');
+const { wantsJson, hasYesFlag } = require('../lib/noninteractive');
+const { isUnboundScratchFolder, refuseUnboundScratch } = require('../lib/scratch-root');
+const { resolveWorkspaceRoot } = require('../lib/mission-root');
+const { personName } = require('../lib/first-minute');
 
 const CLI_PATH = path.join(__dirname, '..', 'bin', 'atris.js');
 const DEFAULT_LEG_WALL_SECONDS = 3600;
@@ -190,13 +193,23 @@ function autopilotStatus(root = process.cwd()) {
   return 0;
 }
 
+function greet(person) {
+  return person ? `hey ${person}, ` : '';
+}
+
+function inviteLines() {
+  return [
+    `${greet(personName())}I can keep working until you stop.`,
+    '',
+    'next: atris autopilot --yes',
+  ];
+}
+
 function showFrontHelp() {
   console.log('');
   console.log('Usage: atris autopilot [options]');
   console.log('');
-  console.log('Keeps the workspace moving: picks the most logical mission or member,');
-  console.log('drives it through the mission runtime, then picks the next one.');
-  console.log('Runs until you stop it.');
+  console.log('Keep working until you stop. Pass --yes to start.');
   console.log('');
   console.log('Options:');
   console.log('  --minutes N | --hours N   Total budget (default: unlimited)');
@@ -216,7 +229,7 @@ async function autopilotFront(args = []) {
   // (e.g. backend/) wrote its loop state into a nested .atris, so a later
   // `autopilot stop`/`status` from the root couldn't see the running loop.
   // Same resolver the mission/task/usage stores use; falls back to cwd.
-  const root = require('../lib/mission-root').resolveWorkspaceRoot(process.cwd());
+  const root = resolveWorkspaceRoot(process.cwd());
   if (args[0] === 'stop') return autopilotStop(root);
   if (args[0] === 'status') return autopilotStatus(root);
   if (args.includes('--help') || args.includes('-h') || args[0] === 'help') { showFrontHelp(); return 0; }
@@ -232,14 +245,16 @@ async function autopilotFront(args = []) {
     }, null, 2));
     return 2;
   }
-  // Bare headless invoke used to start a mission loop and hang. --auto is
-  // the existing proceed flag pulse and spaceship already pass. --once is
-  // a duration, not consent: it still needs --yes off a TTY.
-  if (!args.includes('--auto') && refuseHeadlessUnless(args, {
-    allowYes: true,
-    allowOnce: false,
-    usage: 'Usage: atris autopilot [--yes|--auto] [--once]',
-  })) return 2;
+  // Bare invoke used to start a loop. --auto is the proceed flag pulse
+  // and spaceship already pass. --once is a duration, not consent.
+  if (!args.includes('--auto') && !hasYesFlag(args)) {
+    for (const line of inviteLines()) console.log(line);
+    return 2;
+  }
+
+  // --yes / --auto start the loop. They are not a workspace unlock.
+  // An unbound scratch folder is not a room (same class as slack/gmail).
+  if (isUnboundScratchFolder(root)) return refuseUnboundScratch();
 
   const existing = readState(root);
   if (existing && pidAlive(existing.pid) && existing.pid !== process.pid) {
@@ -324,6 +339,7 @@ async function autopilotFront(args = []) {
 
 module.exports = {
   autopilotFront,
+  inviteLines,
   maxLegsFlag,
   stopRequested,
   requestStop,

package/commands/brainstorm.js

@@ -1,504 +1,105 @@
+'use strict';
+
 const fs = require('fs');
 const path = require('path');
-const readline = require('readline');
 const { getLogPath, ensureLogDirectory, createLogFile } = require('../lib/journal');
-// Inbox helpers live canonically (and CRLF-tolerant) in lib/file-ops; brainstorm
-// used to carry byte-identical local copies that silently missed CRLF journals.
-const {
-  parseInboxItems,
-  replaceInboxSection,
-  addInboxItemToContent,
-  getNextInboxId,
-  addInboxIdea,
-} = require('../lib/file-ops');
-const { loadConfig } = require('../utils/config');
-const { loadCredentials, ensureValidCredentials } = require('../utils/auth');
-const { apiRequestJson } = require('../utils/api');
-const { isNonInteractive } = require('../lib/noninteractive');
-const { planAtris, doAtris, reviewAtris } = require('./workflow');
-
-const pkg = require('../package.json');
-
-async function brainstormAtris() {
-  const args = process.argv.slice(3);
-  if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
-    console.log('');
-    console.log('Usage: atris brainstorm [idea] [--cloud]');
-    console.log('');
-    console.log('Description:');
-    console.log('  Guided prompt generator for exploration before planning.');
-    console.log('  Default is local-first; pass --cloud to include AtrisOS journal context.');
-    console.log('  Headless agents: pass the idea on the command line (never prompts).');
-    console.log('');
-    console.log('Options:');
-    console.log('  --cloud      Include AtrisOS journal context (optional).');
-    console.log('  --no-cloud   Force local-only mode (skip AtrisOS).');
-    console.log('  --yes        Non-interactive: capture idea args and exit.');
-    console.log('');
-    return;
-  }
-
-  const targetDir = path.join(process.cwd(), 'atris');
-  if (!fs.existsSync(targetDir)) {
-    throw new Error('atris/ folder not found. Run "atris init" first.');
-  }
-
-  ensureLogDirectory();
-  const { logFile, dateFormatted } = getLogPath();
-  if (!fs.existsSync(logFile)) {
-    createLogFile(logFile, dateFormatted);
-  }
-
-  const useCloudJournal = args.includes('--cloud') && !args.includes('--no-cloud');
-  const topicFromArgs = args.filter((arg) => !arg.startsWith('-')).join(' ').trim() || null;
-
-  // Headless agents must never hang on "Describe the desired outcome".
-  if (isNonInteractive(args)) {
-    if (topicFromArgs) {
-      const newId = addInboxIdea(logFile, topicFromArgs);
-      console.log(`captured I${newId}: ${topicFromArgs}`);
-      console.log(`journal: ${path.relative(process.cwd(), logFile) || logFile}`);
-      console.log('Next: atris plan');
-      return;
-    }
-    console.log('brainstorm is interactive without an idea on the command line.');
-    console.log(`journal: ${path.relative(process.cwd(), logFile) || logFile}`);
-    console.log('Next: atris brainstorm "<idea>"');
-    return;
-  }
+const { addInboxIdea } = require('../lib/file-ops');
+const { isFreshWorkspace, speakFirstMinute } = require('../lib/first-minute');
+const { wantsJson } = require('../lib/noninteractive');
+const { compactErrorPayload, compactSuccessPayload, printCliJson } = require('../lib/cli-json');
 
+function printHelp() {
   console.log('');
-  console.log('┌─────────────────────────────────────────────────────────────┐');
-  console.log('│ Atris Brainstorm — structured prompt generator              │');
-  console.log('└─────────────────────────────────────────────────────────────┘');
+  console.log('Usage: atris brainstorm "<idea>" [--json]');
   console.log('');
-  console.log(`Date: ${dateFormatted}`);
-  console.log('Type "exit" at any prompt to cancel.');
+  console.log('Description:');
+  console.log('  Capture an idea to today\'s inbox and exit.');
+  console.log('  Never waits on a prompt. Headless.');
+  console.log('');
+  console.log('Options:');
+  console.log('  --json       Print a JSON receipt.');
+  console.log('  --cloud      Accepted. Capture stays local.');
+  console.log('  --no-cloud   Force local-only mode.');
+  console.log('  --yes        Accepted. Always non-interactive.');
   console.log('');
-
-  // Local journal context (source of truth for Inbox)
-  let localJournalContext = '';
-  if (fs.existsSync(logFile)) {
-    localJournalContext = fs.readFileSync(logFile, 'utf8');
-  }
-
-  // Optional: fetch journal context from backend (for hints only)
-  let remoteJournalContext = '';
-  const config = loadConfig();
-  const ensured1 = await ensureValidCredentials(apiRequestJson);
-  const credentials = ensured1.error ? null : ensured1.credentials;
-
-  if (useCloudJournal && config.agent_id && credentials && credentials.token) {
-    try {
-      console.log('📖 Fetching latest journal entry from AtrisOS...');
-      const journalResult = await apiRequestJson(`/agents/${config.agent_id}/journal/today`, {
-        method: 'GET',
-        token: credentials.token,
-      });
-      
-      if (journalResult.ok && journalResult.data?.content) {
-        remoteJournalContext = journalResult.data.content;
-        console.log('✓ Loaded journal entry from backend');
-      } else {
-        // Try fetching latest entry if today doesn't exist
-        const listResult = await apiRequestJson(`/agents/${config.agent_id}/journal/?limit=1`, {
-          method: 'GET',
-          token: credentials.token,
-        });
-        
-        if (listResult.ok && listResult.data?.entries?.length > 0) {
-          remoteJournalContext = listResult.data.entries[0].content || '';
-          console.log('✓ Loaded latest journal entry from backend');
-        }
-      }
-    } catch (error) {
-      // Silently fail - we'll use local log file instead
-      console.log('ℹ️  Using local journal file (backend unavailable)');
-    }
-    console.log('');
-  }
-
-  // Keep prompts high-signal: only include "recent context" when explicitly pulled from cloud.
-  const journalHintSource = remoteJournalContext;
-
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
-  const ask = async (promptText, options = {}) => {
-    const { allowEmpty = false } = options;
-    while (true) {
-      const answer = await new Promise((resolve) => rl.question(promptText, resolve));
-      const trimmed = answer.trim();
-      if (trimmed.toLowerCase() === 'exit') {
-        throw brainstormAbortError();
-      }
-      if (!allowEmpty && trimmed === '') {
-        console.log('Please enter a value (or type "exit" to abort).');
-        continue;
-      }
-      return trimmed;
-    }
-  };
-
-  const askYesNo = async (promptText) => {
-    while (true) {
-      const response = (await ask(promptText)).toLowerCase();
-      if (response === 'y' || response === 'yes') return true;
-      if (response === 'n' || response === 'no') return false;
-      console.log('Please answer with "y" or "n" (or type "exit" to abort).');
-    }
-  };
-
-  const collectList = async (label, options = {}) => {
-    const { minimum = 0 } = options;
-    const items = [];
-    while (true) {
-      const promptSuffix = items.length === 0 ? '' : ' (blank to finish)';
-      const value = await ask(`${label} ${items.length + 1}${promptSuffix}: `, {
-        allowEmpty: items.length >= minimum,
-      });
-      if (!value) {
-        if (items.length < minimum) {
-          console.log(`Please provide at least ${minimum} ${minimum === 1 ? 'item' : 'items'}.`);
-          continue;
-        }
-        break;
-      }
-      items.push(value);
-    }
-    return items;
-  };
-
-  let selectedInboxItem = null;
-  let topicSummary = '';
-
-  try {
-    let inboxItems = parseInboxItems(localJournalContext || '');
-
-    if (topicFromArgs) {
-      topicSummary = topicFromArgs;
-      const newId = addInboxIdea(logFile, topicSummary);
-      console.log(`✓ Added I${newId} to today\'s Inbox.`);
-      selectedInboxItem = { id: newId, text: topicSummary };
-      inboxItems = parseInboxItems(fs.readFileSync(logFile, 'utf8'));
-    }
-
-    if (topicFromArgs) {
-      // Topic provided via CLI args — treat as a new brainstorm and skip source selection.
-    } else if (inboxItems.length > 0) {
-      console.log('Choose a brainstorm source:');
-      console.log('  1. Select an item from today\'s Inbox');
-      console.log('  2. Enter a new idea');
-      console.log('');
-
-      let choice;
-      while (true) {
-        choice = await ask('Choice (1-2): ');
-        if (choice === '1' || choice === '2') {
-          break;
-        }
-        console.log('Please enter 1 or 2.');
-      }
-
-      if (choice === '1') {
-        console.log('');
-        console.log('Today\'s Inbox:');
-        inboxItems.forEach((item, index) => {
-          console.log(`  ${index + 1}. I${item.id} — ${item.text}`);
-        });
-        console.log('');
-
-        while (true) {
-          const selection = await ask(`Pick an item (1-${inboxItems.length}): `);
-          const index = parseInt(selection, 10);
-          if (!Number.isNaN(index) && index >= 1 && index <= inboxItems.length) {
-            selectedInboxItem = inboxItems[index - 1];
-            break;
-          }
-          console.log(`Enter a number between 1 and ${inboxItems.length}.`);
-        }
-
-        const editedSummary = await ask('Brainstorm topic (press Enter to keep original): ', { allowEmpty: true });
-        topicSummary = editedSummary ? editedSummary : selectedInboxItem.text;
-      } else {
-        console.log('');
-        topicSummary = await ask('Describe the brainstorm topic: ');
-        const newId = addInboxIdea(logFile, topicSummary);
-        console.log(`✓ Added I${newId} to today\'s Inbox.`);
-        selectedInboxItem = { id: newId, text: topicSummary };
-      }
-    } else {
-      console.log('No items in today\'s Inbox. Capture a new idea to begin.');
-      topicSummary = await ask('Describe the brainstorm topic: ');
-      const newId = addInboxIdea(logFile, topicSummary);
-      console.log(`✓ Added I${newId} to today\'s Inbox.`);
-      selectedInboxItem = { id: newId, text: topicSummary };
-    }
-
-    const sourceLabel = selectedInboxItem ? `I${selectedInboxItem.id}` : 'Ad-hoc';
-
-    console.log('');
-    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.log('📖 Step 1: Craft the Story');
-    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.log('What should the output be? How should it feel?');
-    console.log('This helps us capture the vision before diving into details.');
-    console.log('');
-
-    const userStory = await ask('Describe the desired outcome (what should users experience?): ');
-    const feelingsVibe = await ask('Feelings/vibes we\'re aiming for? (optional): ', { allowEmpty: true });
-
-    console.log('');
-    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.log('🧠 Step 2: Brainstorm Session');
-    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.log('Now let\'s uncover what we need to build.');
-    console.log('');
-
-    const constraints = await ask('Constraints or guardrails? (optional): ', { allowEmpty: true });
-
-    // Build concise, spaced-out prompt (4-5 sentences max, lots of spacing)
-    const promptLines = [];
-    
-    // Extract key snippets from journal if available (very brief)
-    let journalHint = '';
-    if (journalHintSource && journalHintSource.trim()) {
-      const maxHint = 200;
-      const lines = journalHintSource.split('\n').slice(0, 5).join(' ').trim();
-      if (lines.length > maxHint) {
-        journalHint = lines.substring(0, maxHint) + '...';
-      } else {
-        journalHint = lines;
-      }
-    }
-
-    promptLines.push('You:');
-    promptLines.push('');
-    promptLines.push(`I want to brainstorm: ${topicSummary}`);
-    promptLines.push('');
-    
-    if (userStory) {
-      promptLines.push(`The outcome should be: ${userStory}`);
-      promptLines.push('');
-    }
-    
-    if (feelingsVibe) {
-      promptLines.push(`Vibe we\'re going for: ${feelingsVibe}`);
-      promptLines.push('');
-    }
-    
-    if (journalHint) {
-      promptLines.push(`Recent context: ${journalHint}`);
-      promptLines.push('');
-    }
-    
-    if (constraints) {
-      promptLines.push(`Constraints: ${constraints}`);
-    promptLines.push('');
-    }
-    
-    promptLines.push('Help me uncover what we need to build. Keep responses short (4-5 sentences), pause for alignment, sketch ASCII when structure helps.');
-    promptLines.push('');
-    promptLines.push('Claude:');
-
-    const promptText = promptLines.join('\n');
-
-    console.log('');
-    console.log('Copy this prompt into Claude Code (or your agent of choice):');
-    console.log('');
-    console.log('```');
-    console.log(promptText);
-    console.log('```');
-    console.log('');
-    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.log('💬 Brainstorm Mode — Thinking Together');
-    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.log('');
-    console.log('For the agent: Be conversational and supportive:');
-    console.log('  • 3-4 sentences max per response');
-    console.log('  • Ask ONE question at a time (never multiple)');
-    console.log('  • Supportive tone: "That makes sense. What about X?"');
-    console.log('  • No files created (exploration only)');
-    console.log('  • User says "ready" or "plan" to exit brainstorm');
-    console.log('');
-    console.log('Example:');
-    console.log('  User: "notifications but not sure"');
-    console.log('  You: "What bothers you about current notifications?"');
-    console.log('  User: "Easy to miss"');
-    console.log('  You: "Makes sense. What if they stayed visible until dismissed?"');
-    console.log('');
-    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-    console.log('');
-
-    const logChoice = await askYesNo('Log this brainstorm session to today\'s journal? (y/n): ');
-    if (logChoice) {
-      const sessionSummary = await ask('Session summary (1-2 sentences): ');
-      const nextStepsRaw = await ask('Next steps (optional, separate with ";"): ', { allowEmpty: true });
-      const nextSteps = nextStepsRaw
-        ? nextStepsRaw.split(';').map((item) => item.trim()).filter(Boolean)
-        : [];
-      try {
-        recordBrainstormSession(
-          logFile,
-          sourceLabel,
-          topicSummary,
-          userStory,
-          [],
-          [],
-          constraints,
-          '',
-          feelingsVibe || '',
-          nextSteps,
-          sessionSummary
-        );
-        if (selectedInboxItem) {
-          const archive = await askYesNo('Archive this Inbox idea now? (y/n): ');
-          if (archive) {
-            try {
-              let latestContent = fs.readFileSync(logFile, 'utf8');
-              latestContent = removeInboxItemFromContent(latestContent, selectedInboxItem.id);
-              if (typeof latestContent !== 'string') {
-                throw new Error('Archive operation produced invalid journal content.');
-              }
-              writeJournalFile(logFile, latestContent);
-              console.log(`✓ Archived I${selectedInboxItem.id} from Inbox.`);
-            } catch (error) {
-              console.log(`Could not archive I${selectedInboxItem.id}: ${error.message}`);
-            }
-          }
-        }
-        console.log('✓ Brainstorm session logged.');
-      } catch (error) {
-        if (error && error.__brainstormAbort) {
-          throw error;
-        }
-        console.log(`Could not log brainstorm session: ${error.message}`);
-      }
-    } else {
-      console.log('Skipped journaling. Prompt is ready for your agent.');
-    }
-
-    console.log('\nBrainstorm complete.');
-  } finally {
-    rl.close();
-  }
 }
 
-function brainstormAbortError() {
-  const error = new Error('Brainstorm cancelled by user.');
-  error.__brainstormAbort = true;
-  return error;
+function topicFromArgs(args) {
+  return args.filter((arg) => !String(arg).startsWith('-')).join(' ').trim() || null;
 }
 
-function removeInboxItemFromContent(content, id) {
-  const items = parseInboxItems(content).filter((item) => item.id !== id);
-  return replaceInboxSection(content, items);
+function journalRel(logFile) {
+  return path.relative(process.cwd(), logFile) || logFile;
 }
 
-function writeJournalFile(logFile, content) {
-  if (typeof logFile !== 'string' || logFile.trim() === '') {
-    throw new Error('Journal log file path is required.');
-  }
-  if (typeof content !== 'string') {
-    throw new Error('Journal content must be a string.');
-  }
-  const logDir = path.dirname(logFile);
-  const tempFile = path.join(logDir, `.${path.basename(logFile)}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`);
-  let tempFileWritten = false;
-  try {
-    fs.mkdirSync(logDir, { recursive: true });
-    fs.writeFileSync(tempFile, content, { encoding: 'utf8', flag: 'wx' });
-    tempFileWritten = true;
-    fs.renameSync(tempFile, logFile);
-  } catch (error) {
-    if (tempFileWritten || !error || error.code !== 'EEXIST') {
-      try {
-        fs.unlinkSync(tempFile);
-      } catch {}
-    }
-    const message = error && error.message ? error.message : String(error);
-    throw new Error(`Could not write journal file: ${message}`);
+function printCaptured(id, text, rel, args) {
+  const inboxId = `I${id}`;
+  if (wantsJson(args)) {
+    const payload = compactSuccessPayload({
+      action: 'captured',
+      ids: {
+        id,
+        inbox_id: inboxId,
+        text,
+        journal: rel,
+      },
+      next_command: 'atris plan',
+    });
+    printCliJson(payload, payload, args);
+    return;
   }
+  console.log(`captured ${inboxId}: ${text}`);
+  console.log(`journal: ${rel}`);
+  console.log('Next: atris plan');
 }
 
-function insertIntoNotesSection(content, block) {
-  const regex = /(## Notes\n)([\s\S]*?)(\n---|\n##|$)/;
-  const match = content.match(regex);
-  if (!match) {
-    return `${content}\n\n## Notes\n\n${block}\n`;
+function printIdeaRequired(rel, args) {
+  if (wantsJson(args)) {
+    const payload = compactErrorPayload({
+      reason: 'idea_required',
+      detail: 'brainstorm needs an idea on the command line',
+      next_command: 'atris brainstorm "<idea>"',
+    });
+    printCliJson(payload, payload, args);
+    return;
   }
-  const header = match[1];
-  const body = match[2];
-  const suffix = match[3];
-  const trimmedBody = body.replace(/\s*$/, '');
-  const newBody = trimmedBody
-    ? `${trimmedBody}\n\n${block}\n`
-    : `\n${block}\n`;
-  return content.replace(regex, `${header}${newBody}${suffix}`);
-}
-
-function getTimeLabel() {
-  const now = new Date();
-  const hours = String(now.getHours()).padStart(2, '0');
-  const minutes = String(now.getMinutes()).padStart(2, '0');
-  return `${hours}:${minutes}`;
+  console.log('brainstorm captures an idea on the command line and exits.');
+  console.log(`journal: ${rel}`);
+  console.log('Next: atris brainstorm "<idea>"');
 }
 
-function recordBrainstormSession(
-  logFile,
-  sourceLabel,
-  topic,
-  desiredOutcome,
-  keyQuestions,
-  focusAreas,
-  constraints,
-  references,
-  tonePreference,
-  nextSteps,
-  sessionSummary
-) {
-  let content = fs.readFileSync(logFile, 'utf8');
-  const lines = [
-    `### Brainstorm Session — ${getTimeLabel()}`,
-    `**Source:** ${sourceLabel}`,
-    `**Topic:** ${topic}`,
-  ];
-  if (desiredOutcome) {
-    lines.push(`**User Story / Desired Outcome:** ${desiredOutcome}`);
-  }
-  if (tonePreference) {
-    lines.push(`**Vibe / Feelings:** ${tonePreference}`);
-  }
-  if (keyQuestions && keyQuestions.length > 0) {
-    lines.push('**Key Questions:**');
-    keyQuestions.forEach((item) => lines.push(`- ${item}`));
-  }
-  if (focusAreas && focusAreas.length > 0) {
-    lines.push('**Focus Areas:**');
-    focusAreas.forEach((item) => lines.push(`- ${item}`));
-  }
-  if (constraints) {
-    lines.push(`**Constraints:** ${constraints}`);
+async function brainstormAtris() {
+  const args = process.argv.slice(3);
+  if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
+    printHelp();
+    return;
   }
-  if (references) {
-    lines.push(`**Context / References:** ${references}`);
+
+  const root = process.cwd();
+  if (isFreshWorkspace(root)) {
+    process.exit(speakFirstMinute({ root, fresh: true, asJson: wantsJson(args) }));
   }
-  if (sessionSummary) {
-    lines.push(`**Session Summary:** ${sessionSummary}`);
+
+  ensureLogDirectory();
+  const { logFile, dateFormatted } = getLogPath();
+  if (!fs.existsSync(logFile)) {
+    createLogFile(logFile, dateFormatted);
   }
-  if (nextSteps && nextSteps.length > 0) {
-    lines.push('**Next Steps:**');
-    nextSteps.forEach((item) => lines.push(`- ${item}`));
+
+  const idea = topicFromArgs(args);
+  const rel = journalRel(logFile);
+
+  // Named explore path: capture and exit. A TTY must not open a wizard.
+  // Scar 2026-08-24: wrote I1, then hung on "Describe the desired outcome".
+  if (idea) {
+    const newId = addInboxIdea(logFile, idea);
+    printCaptured(newId, idea, rel, args);
+    return;
   }
 
-  const block = lines.join('\n');
-  content = insertIntoNotesSection(content, block);
-  writeJournalFile(logFile, content);
+  printIdeaRequired(rel, args);
 }
 
-
 module.exports = {
-  brainstormAtris
+  brainstormAtris,
 };