atris 3.30.12 → 3.31.0

package/ax

@@ -1165,6 +1165,51 @@ function formatApprovalTime(value) {
   return `${months[Number(month) - 1] || month} ${Number(day)}, ${year} at ${hour12}:${minute} ${ampm}`;
 }
 
+function previewText(value, limit = 80) {
+  return String(value || '').replace(/\s+/g, ' ').trim().slice(0, limit);
+}
+
+function previewContact(value) {
+  if (!value) return '';
+  if (typeof value === 'string') return previewText(value, 120);
+  if (typeof value !== 'object') return previewText(value, 120);
+  return previewText(value.email || value.address || value.value || value.name || '', 120);
+}
+
+function previewContacts(value) {
+  const values = Array.isArray(value)
+    ? value
+    : String(value || '').includes(',')
+      ? String(value).split(',')
+      : [value];
+  return values
+    .map(previewContact)
+    .filter(Boolean)
+    .slice(0, 3)
+    .join(', ');
+}
+
+function gmailApprovalDetails(receipt, request, approvalEvent = null) {
+  const payload = request && request.payload && typeof request.payload === 'object' ? request.payload : {};
+  const taskPreview = receipt && receipt.task_preview && typeof receipt.task_preview === 'object' ? receipt.task_preview : {};
+  const slots = taskPreview.slots && typeof taskPreview.slots === 'object' ? taskPreview.slots : {};
+  const preview = approvalEvent && approvalEvent.preview && typeof approvalEvent.preview === 'object' ? approvalEvent.preview : {};
+  return {
+    to: previewContacts(payload.to || payload.recipient || payload.recipients || payload.email || slots.to || slots.recipient || preview.to),
+    subject: previewText(payload.subject || payload.title || slots.subject || preview.subject, 80),
+  };
+}
+
+function isGmailApproval(request, approvalEvent = null, accept = {}) {
+  const connector = canonicalConnectorId((request && request.connector) || (approvalEvent && approvalEvent.tool));
+  const action = String(
+    (request && (request.executor_action_type || request.action_type || request.action))
+    || accept.task
+    || ''
+  ).toLowerCase().replace(/_/g, ' ');
+  return connector === 'gmail' && /\b(send|reply|compose)\b/.test(action);
+}
+
 function formatApprovalReceipt(receipt) {
   if (!receipt || typeof receipt !== 'object') return null;
   const events = Array.isArray(receipt.tool_events) ? receipt.tool_events : [];
@@ -1182,6 +1227,15 @@ function formatApprovalReceipt(receipt) {
     return `Approval needed before creation: calendar event "${String(title).slice(0, 80)}"${when ? ` ${when}` : ''}`;
   }
 
+  if (isGmailApproval(request, approvalEvent, accept)) {
+    const details = gmailApprovalDetails(receipt, request, approvalEvent);
+    const parts = [
+      details.to ? `to ${details.to}` : '',
+      details.subject ? `subject "${details.subject}"` : '',
+    ].filter(Boolean);
+    return `Approval needed before sending Gmail${parts.length ? `: ${parts.join(' ')}` : ''} (body hidden until approved)`;
+  }
+
   const connector = String(request.connector || approvalEvent.tool || 'connector').replace(/_/g, ' ');
   const action = String(request.action || actionType || 'action').replace(/_/g, ' ');
   return `Approval needed before ${action}: ${connector}`;
@@ -1210,6 +1264,16 @@ function formatTaskPreviewPlan(receipt) {
   if (!taskPreview) return null;
   const task = String(taskPreview.task || '').trim();
   const slots = taskPreview.slots && typeof taskPreview.slots === 'object' ? taskPreview.slots : {};
+  const approvalEvent = taskPreviewApprovalEvent(receipt);
+  const request = approvalEvent && approvalEvent.approval_request;
+  if (isGmailApproval(request, approvalEvent, receipt.task_accept_receipt || {}) || task === 'gmail.send_message') {
+    const details = gmailApprovalDetails(receipt, request || { payload: slots }, approvalEvent);
+    return [
+      'send Gmail',
+      details.to ? `to ${details.to}` : '',
+      details.subject ? `subject "${details.subject}"` : '',
+    ].filter(Boolean).join(' ');
+  }
   if (task === 'calendar.create_event') {
     const title = taskPreviewTitle(receipt);
     const start = slots.start || (receipt.task_accept_receipt && receipt.task_accept_receipt.start);
@@ -1712,12 +1776,30 @@ function buildMessage(message, history = []) {
   return String(message || '').trim();
 }
 
+function createTurnId() {
+  return `axt_${Date.now().toString(36)}_${crypto.randomBytes(4).toString('hex')}`;
+}
+
+function connectorTurnPolicy(message, options = {}) {
+  if (!connectorWriteIntent(message)) return null;
+  const policy = {
+    schema: 'ax.connector_turn.v1',
+    scope: 'current_turn_only',
+    policy: 'preview_then_explicit_approval',
+    writes_require_approval: true,
+  };
+  if (options.turnId) policy.turn_id = String(options.turnId);
+  if (options.conversationId) policy.conversation_id = String(options.conversationId);
+  return policy;
+}
+
 function buildPayload(message, options = {}) {
   const mode = normalizeMode(options.mode);
   const route = options.business ? 'local' : resolveRoute(message, options);
   const local = route !== 'cloud';
   const verifyCommand = String(options.verify || '').trim();
   const previousMessages = structuredHistory(options.history || []);
+  const turnId = String(options.turnId || '').trim();
   const payload = {
     message: buildMessage(message, options.history || []),
     model: modelForMode(mode),
@@ -1730,6 +1812,14 @@ function buildPayload(message, options = {}) {
   if (options.conversationId) {
     payload.conversation_id = String(options.conversationId);
   }
+  if (turnId) {
+    payload.turn_id = turnId;
+  }
+  const connectorPolicy = !local ? connectorTurnPolicy(message, { ...options, turnId }) : null;
+  if (connectorPolicy) {
+    payload.connector_turn = connectorPolicy;
+    payload.external_action_policy = 'preview_then_explicit_approval';
+  }
   if (options.business) {
     // Business cloud workspace: the model loop stays on the backend and every
     // file/bash tool call relays here, executing on the business EC2 via the
@@ -1882,6 +1972,7 @@ async function postTurn(message, options = {}) {
   const local = route !== 'cloud';
   const endpointRoute = options.business ? 'cloud' : route;
   const token = authToken();
+  const turnId = options.turnId || createTurnId();
   const shouldSendConnectionContext = options.connectionContext
     || route === 'cloud'
     || mentionsConnector(message)
@@ -1890,7 +1981,7 @@ async function postTurn(message, options = {}) {
     ? await buildConnectionContext({ token, localWorkspace: local })
     : null);
   const connectionUserId = !local && isLoopbackBackend({ route: endpointRoute }) ? authUserId() : '';
-  const payload = buildPayload(message, { ...options, route, connectionContext, connectionUserId });
+  const payload = buildPayload(message, { ...options, route, connectionContext, connectionUserId, turnId });
   const postData = JSON.stringify(payload);
   const output = options.output || process.stdout;
   // Relayed business turns wait on EC2 terminal calls (up to 60s each) with no
@@ -2269,7 +2360,8 @@ async function chat(options = {}) {
     const turnRoute = options.business ? 'cloud' : resolveRoute(trimmed, { route });
     if (!(await ensureRuntimeReady(turnRoute))) return false;
     const turnFunction = options.turnFunction || turnFunctionForMode(mode);
-    const result = await turnFunction(trimmed, { mode, cwd, history, output, route, business: options.business, verify: options.verify, conversationId });
+    const turnId = options.turnId || createTurnId();
+    const result = await turnFunction(trimmed, { mode, cwd, history, output, route, business: options.business, verify: options.verify, conversationId, turnId });
     if (result.output && !result.output.endsWith('\n')) output.write('\n');
     const approvalExecution = normalizeMode(mode) === 'code-fast'
       ? null
@@ -2331,7 +2423,7 @@ function printBackendHint(options = {}) {
 }
 
 function backendStartCommand() {
-  return `cd /Users/keshavrao/arena/atrisos-backend/backend && ATRIS2_ALLOW_LOCAL_WORKSPACE=1 ENVIRONMENT=development ENV=development ../venv/bin/uvicorn main:app --host ${BACKEND.host} --port ${BACKEND.port}`;
+  return `cd ${process.env.HOME}/arena/atrisos-backend/backend && ATRIS2_ALLOW_LOCAL_WORKSPACE=1 ENVIRONMENT=development ENV=development ../venv/bin/uvicorn main:app --host ${BACKEND.host} --port ${BACKEND.port}`;
 }
 
 function formatBackendHint(options = {}) {

package/bin/atris.js

@@ -468,6 +468,7 @@ function showHelp() {
   console.log('  analytics  - Show recent productivity from journals');
   console.log('  search     - Search journal history (atris search <keyword>)');
   console.log('  clean      - Housekeeping (stale tasks, archive journals, broken refs)');
+  console.log('  harvest    - Find bugs and next actions from receipts, run logs, and thinking');
   console.log('  verify     - Validate work is done (tests, MAP.md, changes)');
   console.log('  task       - Local agent task plane (atomic claims, TODO import)');
   console.log('  mission    - Goal + loop + member owner + verifier + receipt');
@@ -485,8 +486,10 @@ function showHelp() {
   console.log('  autopilot  - Guided loop that can clarify TODOs and run plan → do → review');
   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('  visualize  - Generate a Slack/deck-ready visual from a prompt');
-  console.log('  youtube    - Process YouTube videos with Gemini native video analysis');
+  console.log('  youtube    - Process YouTube videos with timestamped transcript-first analysis');
   console.log('');
   console.log('Experiments:');
   console.log('  experiments init [slug]     - Prepare atris/experiments/ or scaffold a pack');
@@ -831,22 +834,27 @@ function showServeHelp() {
 
 function showLoopHelp() {
   console.log('');
-  console.log('Usage: atris loop [--dry-run] [--json] [--limit=N]');
+  console.log('Usage: atris loop [add|start|status|report|stop|wiki] [options]');
   console.log('');
   console.log('Description:');
-  console.log('  Inspect wiki upkeep state and optionally refresh wiki status/log files.');
+  console.log('  One front door for the self-improvement loop. It reads ROADMAP.md,');
+  console.log('  runs bounded proof-backed work, and keeps wiki upkeep under loop wiki.');
   console.log('');
-  console.log('Options:');
-  console.log('  --dry-run    Preview wiki loop state without writing files.');
-  console.log('  --json       Print the loop report as JSON.');
-  console.log('  --limit=N    Limit suggested source count.');
-  console.log('  --help, -h   Show this help.');
+  console.log('Commands:');
+  console.log('  atris loop add "<task>"        Put a bounded task into the loop queue.');
+  console.log('  atris loop start [--once]      Run the local loop.');
+  console.log('  atris loop start --overnight   Install the durable heartbeat.');
+  console.log('  atris loop status [--json]     Show heartbeat, local runs, and next moves.');
+  console.log('  atris loop report [--json]     Show proof of handled and queued loop work.');
+  console.log('  atris loop stop                Remove the durable heartbeat.');
+  console.log('  atris loop wiki                Run the wiki upkeep loop.');
+  console.log('  --help, -h                     Show this help.');
   console.log('');
 }
 
 function showCleanHelp() {
   console.log('');
-  console.log('Usage: atris clean [--dry-run]');
+  console.log('Usage: atris clean [--dry-run] [--json]');
   console.log('');
   console.log('Description:');
   console.log('  Check workspace housekeeping: stale tasks, MAP.md refs, old journals,');
@@ -854,6 +862,7 @@ function showCleanHelp() {
   console.log('');
   console.log('Options:');
   console.log('  --dry-run, -n   Preview cleanup without changing files.');
+  console.log('  --json          Print machine-readable cleanup results.');
   console.log('  --help, -h      Show this help.');
   console.log('');
 }
@@ -913,12 +922,12 @@ if (command === '2' && ['fast', 'pro'].includes(String(firstCommandArg || '').to
 }
 
 // Check if this is a known command or natural language input
-const knownCommands = ['init', 'log', 'now', 'radar', 'ctop', 'launchpad', 'status', 'analytics', 'visualize', 'brain', 'brainstorm', 'autopilot', 'run', 'plan', 'do', 'review', 'release',
+const knownCommands = ['init', 'log', 'now', 'radar', 'ctop', 'launchpad', 'status', 'analytics', 'visualize', 'brain', 'brainstorm', 'autopilot', 'run', '_start', 'plan', 'do', 'review', 'release',
                        'activate', '_activate', 'agent', 'chat', 'fast', 'ax', 'console', 'serve', 'login', 'logout', 'whoami', 'switch', 'use', 'accounts', '_resolve', '_profile-email', '_switch-session', 'shell-init', 'update', 'upgrade', 'version', 'help', 'next', 'atris',
-                       'clean', 'verify', 'search', 'skill', 'member', 'codex-goal', 'app', 'apps', 'learn', 'lesson', 'plugin', 'experiments', 'receipt', 'proof', 'openclaw', 'pull', 'push', 'live', 'align', 'terminal', 'computer', 'diff', 'business', 'sync', 'youtube',
-                       'ingest', 'query', 'lint', 'loop', 'pulse', 'task', 'mission', 'probe', 'worktree', 'aeo', 'slop', 'security-review', 'secure', 'deck', 'site', 'theme', 'card', 'reel', 'improve', 'xp', 'play', 'gm', 'x', 'recap', 'signup', 'clarity', 'moves',
+                       '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'];
+                       'fork', 'browse', 'publish', 'sleep', 'wake', 'feedback', 'errors', 'wiki', 'code-review', 'cr', 'soul', 'fleet', 'compile', 'spaceship', 'truth'];
 
 // Check if command is an atris.md spec file - triggers welcome visualization
 function isSpecFile(cmd) {
@@ -940,7 +949,15 @@ if (command === '--version' || command === '-v' || process.argv.includes('--vers
 // If no command OR command is not recognized, treat as natural language
 // Voice-friendly aliases — natural language → command mapping
 // Solves speech-to-text issues (inspired by gstack v0.14.6 voice-triggers)
+const START_MISSION_OBJECTIVE = 'self improve goal after goal: pick one useful bounded mission from current Atris state, run proof, and continue only with real next work';
+
 const voiceTriggers = {
+  'start': '_start',
+  'start now': '_start',
+  'go': '_start',
+  'keep going': '_start',
+  'keepgoing': '_start',
+  'keep-going': '_start',
   'review my code': 'code-review',
   'check my code': 'code-review',
   'run a review': 'code-review',
@@ -965,7 +982,12 @@ const voiceTriggers = {
 if (!command || !knownCommands.includes(command)) {
   // Check voice triggers before falling through to natural language
   const fullInput = process.argv.slice(2).join(' ').toLowerCase().trim();
-  const triggered = voiceTriggers[fullInput];
+  const fullInputWithoutFlags = process.argv.slice(2)
+    .filter((arg, index, args) => !String(arg).startsWith('-') && !isOptionValue(args, index, RUNNER_FLAG_NAMES))
+    .join(' ')
+    .toLowerCase()
+    .trim();
+  const triggered = voiceTriggers[fullInput] || voiceTriggers[fullInputWithoutFlags];
   if (triggered) {
     command = triggered;
     // Re-check — if it's now a known command, fall through to dispatch
@@ -1355,6 +1377,12 @@ function showWelcomeVisualization() {
         : `${tasksInReview} waiting`;
       console.log(`    │   ⏳ Review:  ${reviewText.padEnd(26)}│`);
     }
+    let landInfo = null;
+    try { landInfo = require('../commands/land').landSummary(process.cwd()); } catch (err) { landInfo = null; }
+    if (landInfo && landInfo.branches > 0) {
+      const landText = `${landInfo.branches} in the air, ${landInfo.due} overdue`;
+      console.log(`    │   🛬 Land:    ${landText.padEnd(26)}│`);
+    }
     console.log(`    │   📝 Journal: ${(journalEntries + ' entries today').padEnd(26)}│`);
     if (endgameState.slug !== 'unset' && endgameState.horizon) {
       const endgameLine = endgameState.slug + ' — ' + endgameState.horizon;
@@ -1377,7 +1405,13 @@ function showWelcomeVisualization() {
   if (tasksCertified > 0) {
     console.log(`    Ready. ${tasksCertified} certified await accept — run 'atris task reviews'.`);
   } else {
-    console.log(`    Ready. Run 'atris plan' to start.`);
+    let landHint = null;
+    try { landHint = require('../commands/land').landSummary(process.cwd()); } catch (err) { landHint = null; }
+    if (landHint && landHint.due > 0) {
+      console.log(`    Ready. ${landHint.due} overdue in the landing — run 'atris land --reap'.`);
+    } else {
+      console.log(`    Ready. Run 'atris plan' to start.`);
+    }
   }
   console.log('');
 }
@@ -1398,6 +1432,40 @@ if (command === 'init') {
       console.error(`✗ Error: ${error.message || error}`);
       process.exit(1);
     });
+} else if (command === '_start') {
+  const args = process.argv.slice(3);
+  if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
+    console.log('');
+    console.log('Usage: atris start [options]');
+    console.log('');
+    console.log('Starts the durable mission loop for one useful self-improvement mission.');
+    console.log('');
+    console.log('Options:');
+    console.log('  --json       Print the mission route without starting it.');
+    console.log('  --owner X    Override mission owner.');
+    console.log('  --cadence X  Override mission cadence.');
+    console.log('');
+    process.exit(0);
+  }
+
+  if (args.includes('--json')) {
+    console.log(JSON.stringify({
+      ok: true,
+      action: 'start_mission_run',
+      route: `atris mission run "${START_MISSION_OBJECTIVE}"`,
+      reason: 'casual_launch',
+      objective: START_MISSION_OBJECTIVE,
+      expected_loop: 'mission_run',
+    }, null, 2));
+    process.exit(0);
+  }
+
+  Promise.resolve(require('../commands/mission').missionCommand(['run', START_MISSION_OBJECTIVE, ...args]))
+    .then(() => process.exit(process.exitCode || 0))
+    .catch((error) => {
+      console.error(`✗ Start failed: ${error.message || error}`);
+      process.exit(1);
+    });
 } else if (command === 'task') {
   // SQLite-backed task plane. ~/.atris/tasks.db, gitignored, per-workspace.
   Promise.resolve(require('../commands/task').run(process.argv.slice(3)))
@@ -1421,11 +1489,24 @@ if (command === 'init') {
   Promise.resolve(require('../commands/worktree').worktreeCommand(process.argv.slice(3)))
     .then((code) => process.exit(code || 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'autoland') {
+  Promise.resolve(require('../commands/autoland').autolandCommand(process.argv.slice(3)))
+    .then((code) => process.exit(code || 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'land') {
+  Promise.resolve(require('../commands/land').landCommand(process.argv.slice(3)))
+    .then((code) => process.exit(code || 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'radar' || command === 'ctop') {
   const radarArgs = command === 'ctop' ? ['--agents', ...process.argv.slice(3)] : process.argv.slice(3);
   Promise.resolve(require('../commands/radar').radarCommand(radarArgs))
     .then((code) => process.exit(code || 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'truth') {
+  // Truth: one table rolling up mission state, tasks, feature proof receipts, and loop heartbeats.
+  Promise.resolve(require('../commands/truth').truthCommand(process.argv.slice(3)))
+    .then((code) => process.exit(code || 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'codex-goal') {
   Promise.resolve(require('../commands/codex-goal').codexGoalCommand(process.argv.slice(3)))
     .then(() => process.exit(process.exitCode || 0))
@@ -1922,7 +2003,14 @@ if (command === 'init') {
     process.exit(0);
   }
   const dryRun = process.argv.includes('--dry-run') || process.argv.includes('-n');
-  require('../commands/clean').cleanAtris({ dryRun });
+  const json = process.argv.includes('--json');
+  require('../commands/clean').cleanAtris({ dryRun, json });
+} else if (command === 'harvest') {
+  Promise.resolve(require('../commands/harvest').harvestCommand(process.argv.slice(3)))
+    .catch((err) => {
+      console.error(err.message || err);
+      process.exit(1);
+    });
 } else if (command === 'verify') {
   const args = process.argv.slice(3);
   if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
@@ -2130,8 +2218,8 @@ if (command === 'init') {
     showLoopHelp();
     process.exit(0);
   }
-  require('../commands/loop').loopAtris(args)
-    .then(() => process.exit(0))
+  Promise.resolve(require('../commands/loop-front').loopFront(args))
+    .then((code) => process.exit(typeof code === 'number' ? code : 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'clean-workspace' || command === 'cw') {
   const { cleanWorkspace } = require('../commands/workspace-clean');
@@ -2157,6 +2245,12 @@ if (command === 'init') {
   Promise.resolve(require('../commands/slop').slopCommand(process.argv.slice(3)))
     .then((code) => process.exit(typeof code === 'number' ? code : 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'strings') {
+  // Strings: content design system from live code (no LLM). Extracts UI strings, flags variants,
+  // enforces preferred terms at the gate. Exit 1 = variants/banned terms found, for CI + the gate.
+  Promise.resolve(require('../commands/strings').stringsCommand(process.argv.slice(3)))
+    .then((code) => process.exit(typeof code === 'number' ? code : 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'security-review' || command === 'secure') {
   // Security review: deterministic secrets/PII/code-risk scan (no LLM). Exit 1 = HIGH finding,
   // for the autopilot/mission/CI gate + a SOC 2 evidence artifact via --json.
@@ -2410,13 +2504,12 @@ async function agentAtris() {
   // Respect -h / --help / help before any auth/state work
   const firstArg = process.argv[3];
   if (firstArg === '-h' || firstArg === '--help' || firstArg === 'help') {
-    console.log('Usage: atris agent [doctor|dogfood|spawn|spawns|spawn-status]');
+    console.log('Usage: atris agent [doctor|spawn|spawns|spawn-status]');
     console.log('');
     console.log('  Pick which cloud agent to chat with from this workspace.');
     console.log('  Run `atris agent spawn <role> --task "..."` to create a worker request.');
     console.log('  Run `atris agent spawns` to list worker requests.');
     console.log('  Run `atris agent doctor` to verify local AI CLIs can see Atris context.');
-    console.log('  Run `atris agent dogfood --live` to smoke-test Devin/Droid with GLM 5.2.');
     console.log('  Requires `atris login` first.');
     console.log('');
     console.log('  After selecting, use: atris chat ["message"]');
@@ -2427,7 +2520,19 @@ async function agentAtris() {
     agentDoctor();
   }
   if (firstArg === 'dogfood') {
-    const result = require('../commands/agent-spawn').agentDogfoodCommand(process.argv.slice(4));
+    // Internal diagnostic, gated off the public CLI. Operators use `atris agent doctor`.
+    if (!process.env.ATRIS_INTERNAL_AGENT_DOGFOOD) {
+      console.error('atris agent dogfood is an internal diagnostic and is not part of the public CLI.');
+      console.error('Run `atris agent doctor` to verify local AI CLIs can see Atris context.');
+      process.exit(1);
+    }
+    const dogfoodArgs = process.argv.slice(4);
+    if (dogfoodArgs.includes('--help') || dogfoodArgs.includes('-h') || dogfoodArgs[0] === 'help') {
+      console.log('Internal usage: atris agent dogfood [--live]');
+      console.log('  Smoke-test Devin/Droid with GLM 5.2. Gated behind ATRIS_INTERNAL_AGENT_DOGFOOD.');
+      process.exit(0);
+    }
+    const result = require('../commands/agent-spawn').agentDogfoodCommand(dogfoodArgs);
     process.exit(result.ok ? 0 : 1);
   }
   if (firstArg === 'spawn') {
@@ -2840,135 +2945,3 @@ async function atrisFastOnce(credentials, message) {
   await streamProChat(endpoint, credentials.token, body);
   console.log('\n\n✓ Complete\n');
 }
-
-async function atrisDevEntry(userInput = null) {
-  // Load workspace context and present planning-ready state
-  // userInput: optional task description for hot start
-  const targetDir = path.join(process.cwd(), 'atris');
-
-  // Check if Atris is initialized
-  if (!fs.existsSync(targetDir)) {
-    console.log('');
-    console.log('🚀 Welcome to Atris\n');
-    console.log('Not initialized yet. Let\'s get started:\n');
-    console.log('  → atris init        Set up your workspace');
-    console.log('  → atris help        See all commands\n');
-    return;
-  }
-
-  ensureLogDirectory();
-  const { logFile, dateFormatted } = getLogPath();
-  if (!fs.existsSync(logFile)) {
-    createLogFile(logFile, dateFormatted);
-  }
-
-  // Load context
-  const workspaceDir = process.cwd();
-  const state = detectWorkspaceState(workspaceDir);
-  const context = loadContext(workspaceDir);
-
-  // Detect existing features
-  const featuresDir = path.join(targetDir, 'features');
-  let existingFeatures = [];
-  if (fs.existsSync(featuresDir)) {
-    existingFeatures = fs.readdirSync(featuresDir)
-      .filter(name => {
-        const featurePath = path.join(featuresDir, name);
-        return fs.statSync(featurePath).isDirectory() && !name.startsWith('_');
-      });
-  }
-
-  console.log('');
-  console.log('┌─────────────────────────────────────────────────────────────┐');
-  console.log('│ Atris Mode                                                  │');
-  console.log('└─────────────────────────────────────────────────────────────┘');
-  console.log('');
-  console.log(`📅 ${dateFormatted}`);
-  console.log('');
-
-  // Show existing features
-  if (existingFeatures.length > 0) {
-    console.log('📦 Features: ' + existingFeatures.join(', '));
-    console.log('');
-  }
-
-  // Show active work
-  if (context.inProgressFeatures.length > 0) {
-    console.log('⚡ Active: ' + context.inProgressFeatures.join(', '));
-    console.log('');
-  }
-
-  // Show inbox
-  if (context.hasInbox && context.inboxItems.length > 0) {
-    console.log(`📥 Inbox (${context.inboxItems.length}):`);
-    context.inboxItems.slice(0, 3).forEach((item, i) => {
-      const preview = item.length > 50 ? item.substring(0, 47) + '...' : item;
-      console.log(`   ${i + 1}. ${preview}`);
-    });
-    if (context.inboxItems.length > 3) {
-      console.log(`   ... and ${context.inboxItems.length - 3} more`);
-    }
-    console.log('');
-  }
-
-  // Show recent completions
-  const logContent = fs.existsSync(logFile) ? fs.readFileSync(logFile, 'utf8') : '';
-  const completedMatch = logContent.match(/## Completed ✅\n([\s\S]*?)(?=\n##|$)/);
-  if (completedMatch && completedMatch[1].trim()) {
-    const completedItems = completedMatch[1].trim().split('\n')
-      .filter(line => line.match(/^- \*\*C\d+:/))
-      .slice(-2);
-    if (completedItems.length > 0) {
-      console.log('✅ Recent:');
-      completedItems.forEach(item => {
-        const match = item.match(/^- \*\*C\d+:\s*(.+)\*\*/);
-        if (match) {
-          const text = match[1].length > 50 ? match[1].substring(0, 47) + '...' : match[1];
-          console.log(`   • ${text}`);
-        }
-      });
-      console.log('');
-    }
-  }
-
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('atris — navigator agent');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('');
-
-  if (userInput) {
-    // Hot start - user provided task
-    console.log('User wants:');
-    console.log(`"${userInput}"`);
-    console.log('');
-  } else {
-    // Cold start - no specific task
-    console.log('Wait for user to describe what they want.');
-    console.log('');
-  }
-
-  console.log('⚠️  APPROVAL REQUIRED — Follow this workflow:');
-  console.log('');
-  console.log('STEP 1: Show ASCII visualization');
-  console.log('   Create diagrams showing architecture/flow/UI');
-  console.log('   SHOW diagrams to user and WAIT for approval.');
-  console.log('');
-  console.log('STEP 2: After approval, determine scope');
-  if (existingFeatures.length > 0) {
-    console.log('   Existing: ' + existingFeatures.join(', '));
-  }
-  console.log('   NEW feature → atris/features/[name]/idea.md + build.md + validate.md');
-  console.log('   EXISTING → Update that feature\'s docs');
-  console.log('   SIMPLE → TODO.md only');
-  console.log('');
-  console.log('STEP 3: Create/update docs');
-  console.log('   idea.md = intent (any format)');
-  console.log('   build.md = technical spec');
-  console.log('   validate.md = proof it works (from _templates/validate.md.template)');
-  console.log('   lessons.md = read past lessons before planning, write new ones after validating');
-  console.log('');
-  console.log('⛔ DO NOT execute — that\'s for "atris do"');
-  console.log('');
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  console.log('');
-}