atris 3.15.57 → 3.16.1

package/bin/atris.js

@@ -67,8 +67,8 @@ const ensureValidCredentials = (opts) => _ensureValidCredentials(apiRequestJson,
 const fetchMyAgents = (token) => _fetchMyAgents(token, apiRequestJson);
 const displayAccountSummary = () => _displayAccountSummary(apiRequestJson);
 
-// Run update check in background (non-blocking)
-// Skip for 'version', 'update', and help commands to avoid redundant messages or help side effects.
+// Run update check in background (non-blocking).
+// Skip for machine-readable JSON and help commands to avoid corrupting stdout.
 let updateCheckPromise = null;
 const updateCommand = process.argv[2];
 const updateArgs = process.argv.slice(3);
@@ -78,7 +78,8 @@ const helpRequested = updateCommand === 'help'
   || updateArgs.includes('--help')
   || updateArgs.includes('-h')
   || updateArgs[0] === 'help';
-const skipUpdateCheck = Boolean(process.env.ATRIS_SKIP_UPDATE_CHECK || process.env.NO_UPDATE_NOTIFIER || helpRequested);
+const jsonRequested = updateArgs.includes('--json');
+const skipUpdateCheck = Boolean(process.env.ATRIS_SKIP_UPDATE_CHECK || process.env.NO_UPDATE_NOTIFIER || helpRequested || jsonRequested);
 if (!skipUpdateCheck && (!updateCommand || (updateCommand && !['version', 'update'].includes(updateCommand)))) {
   updateCheckPromise = checkForUpdates()
     .then((updateInfo) => {
@@ -117,15 +118,6 @@ const isBusinessSyncSafetyCommand = command === 'sync'
     || firstCommandArg === 'resolve'
   );
 
-// Keep APP.md app-pack operations independent from the heavier workspace boot
-// path so `atris apps --json` stays machine-readable for agents.
-if (command === 'apps') {
-  const subcommand = process.argv[3];
-  const args = process.argv.slice(4);
-  require('../commands/apps').appsCommand(subcommand, ...args);
-  process.exit(0);
-}
-
 // Auto-sync skills only for commands that modify workspace state
 if (['init', 'update', 'upgrade'].includes(command) || (command === 'sync' && !isBusinessSyncSafetyCommand)) {
   try {
@@ -336,6 +328,7 @@ function showHelp() {
   console.log('  radar      - Show live agents joined with tasks, missions, and worktrees');
   console.log('  ctop       - Show a process-first live agent CPU/memory view');
   console.log('  status     - See local work and completions (`atris status <business>` for remote)');
+  console.log('  recap      - What your AI team did, in plain English (--share for paste-ready)');
   console.log('  xp         - Show Career XP and contribution graph');
   console.log('  analytics  - Show recent productivity from journals');
   console.log('  search     - Search journal history (atris search <keyword>)');
@@ -346,7 +339,7 @@ function showHelp() {
   console.log('  release    - Tag release, bump version, create GitHub release, draft /launch');
   console.log('  learn      - Project learnings (patterns, pitfalls, preferences)');
   console.log('  brain      - Compile MAP/TODO/wiki/state into a loadable agent brain');
-  console.log('  lesson     - Append a one-line lesson to atris/lessons.md');
+  console.log('  lesson     - Append a one-line lesson to atris/lessons.md (mine: distill receipts/episodes/scorecards into policy lessons)');
   console.log('  ingest     - Local-first wiki ingest into atris/wiki/');
   console.log('  query      - Local-first wiki query against atris/wiki/');
   console.log('  lint       - Local-first wiki lint for atris/wiki/');
@@ -355,6 +348,7 @@ function showHelp() {
   console.log('Optional helpers:');
   console.log('  brainstorm - Explore ideas conversationally before planning');
   console.log('  autopilot  - Guided loop that can clarify TODOs and run plan → do → review');
+  console.log('  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('  visualize  - Generate a Slack/deck-ready visual from a prompt');
   console.log('');
@@ -364,6 +358,13 @@ function showHelp() {
   console.log('  experiments run <slug>      - Execute a pack or record an Endstate receipt');
   console.log('  experiments benchmark [m]   - Run validate/runtime experiment benchmarks');
   console.log('');
+  console.log('Compile loop (learn like AI, run like code):');
+  console.log('  compile record <name>       - Append an execution record (--input/--output)');
+  console.log('  compile build <name>        - Compile records into a deterministic run.js');
+  console.log('  compile backtest <name>     - Replay all records, score accuracy vs gate');
+  console.log('  compile promote <name>      - Activate (gate: accuracy >= threshold)');
+  console.log('  compile exec <name>         - Run the compiled process token-free');
+  console.log('');
   console.log('Quick commands:');
   console.log('  atris      - Load context and start (natural language)');
   console.log('  next       - Auto-advance to next step');
@@ -491,14 +492,18 @@ function showDoHelp() {
 
 function showReviewHelp() {
   console.log('');
-  console.log('Usage: atris review [--execute] [--full]');
+  console.log('Usage: atris review [--limit N|--all|--json] [--full|--execute]');
   console.log('');
   console.log('Description:');
-  console.log('  Activate the Validator agent to verify recent changes.');
-  console.log('  Reads TODO.md, MAP.md, and today\'s journal, then prints a validation');
-  console.log('  checklist (and, in agent mode, runs tests and updates docs).');
+  console.log('  Show the certified Review queue: proof-ready work waiting for');
+  console.log('  human accept or revise. Human accept is the AgentXP gate.');
+  console.log('  Use --full/--verbose for the legacy Validator prompt.');
   console.log('');
   console.log('Options:');
+  console.log('  --limit N   Show at most N certified review rows.');
+  console.log('  --all       Show all certified review rows.');
+  console.log('  --json      Emit the task-backed review queue as JSON.');
+  console.log('  --group-by  Group certified rows by tag, owner, or source.');
   console.log('  --execute   Run in agent mode via Atris cloud (requires login + agent).');
   console.log('  --full      Print full spec/context dumps (verbose copy/paste).');
   console.log('  --verbose   Alias for --full.');
@@ -769,9 +774,9 @@ if (command === '2' && ['fast', 'pro'].includes(String(firstCommandArg || '').to
 const knownCommands = ['init', 'log', 'now', 'radar', 'ctop', 'status', 'analytics', 'visualize', 'brain', 'brainstorm', 'autopilot', 'run', 'plan', 'do', 'review', 'release',
                        'activate', '_activate', 'agent', 'chat', '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',
-                       'ingest', 'query', 'lint', 'loop', 'task', 'mission', 'worktree', 'aeo', 'xp', 'play', 'gm', 'x',
+                       'ingest', 'query', 'lint', 'loop', 'task', 'mission', 'probe', 'worktree', 'aeo', 'improve', 'xp', 'play', 'gm', 'x', 'recap',
                        'gmail', 'calendar', 'twitter', 'slack', 'imessage', 'integrations', 'setup', 'clean-workspace', 'cw',
-                       'fork', 'browse', 'publish', 'sleep', 'wake', 'feedback', 'errors', 'wiki', 'code-review', 'cr', 'soul', 'fleet'];
+                       'fork', 'browse', 'publish', 'sleep', 'wake', 'feedback', 'errors', 'wiki', 'code-review', 'cr', 'soul', 'fleet', 'compile'];
 
 // Check if command is an atris.md spec file - triggers welcome visualization
 function isSpecFile(cmd) {
@@ -1044,8 +1049,7 @@ async function interactiveEntry(userInput) {
 
 // ASCII Welcome Visualization
 function showWelcomeVisualization() {
-  const { getBacklogTasks, getInProgressTasks } = require('../lib/state-detection');
-  const { getLogPath, ensureLogDirectory, createLogFile } = require('../lib/journal');
+  const { getTaskCounts } = require('../lib/state-detection');
   const cwd = process.cwd();
   const atrisDir = path.join(cwd, 'atris');
   const projectName = path.basename(cwd);
@@ -1054,21 +1058,13 @@ function showWelcomeVisualization() {
   let filesIndexed = 0;
   let tasksInBacklog = 0;
   let tasksInProgress = 0;
+  let tasksInReview = 0;
+  let tasksCertified = 0;
   let journalEntries = 0;
   let hasMap = false;
   let isInitialized = fs.existsSync(atrisDir);
 
   if (isInitialized) {
-    // Auto-create today's journal if missing
-    try {
-      ensureLogDirectory();
-      const { logFile, dateFormatted } = getLogPath();
-      if (!fs.existsSync(logFile)) {
-        createLogFile(logFile, dateFormatted);
-      }
-    } catch {
-      // Silently fail - don't block welcome display
-    }
     // Check MAP.md
     const mapPath = path.join(atrisDir, 'MAP.md');
     if (fs.existsSync(mapPath)) {
@@ -1079,15 +1075,15 @@ function showWelcomeVisualization() {
       filesIndexed = fileRefs ? fileRefs.length : 0;
     }
 
-    // Check TODO.md
-    const todoPath = path.join(atrisDir, 'TODO.md');
-    if (fs.existsSync(todoPath)) {
-      try {
-        tasksInBacklog = getBacklogTasks(atrisDir).length;
-        tasksInProgress = getInProgressTasks(atrisDir).length;
-      } catch {
-        // Silently fail - show 0 tasks if parsing fails
-      }
+    // Task lane counts — DB truth first, TODO.md parse as fallback
+    try {
+      const counts = getTaskCounts(atrisDir);
+      tasksInBacklog = counts.backlog;
+      tasksInProgress = counts.active;
+      tasksInReview = counts.review;
+      tasksCertified = counts.reviewCertified;
+    } catch {
+      // Silently fail - show 0 tasks if reading fails
     }
 
     // Count journal entries today
@@ -1136,13 +1132,19 @@ function showWelcomeVisualization() {
     console.log(`    │   📄 Spec:    atris.md v${CLI_VERSION.padEnd(18)}│`);
     console.log(`    │   🗺️  Map:    ${hasMap ? (filesIndexed + ' files indexed').padEnd(26) : 'not generated yet'.padEnd(26)}│`);
     console.log(`    │   📋 Tasks:   ${(tasksInBacklog + ' backlog, ' + tasksInProgress + ' active').padEnd(26)}│`);
+    if (tasksInReview > 0) {
+      const reviewText = tasksCertified > 0
+        ? `${tasksInReview} waiting (${tasksCertified} certified)`
+        : `${tasksInReview} waiting`;
+      console.log(`    │   ⏳ Review:  ${reviewText.padEnd(26)}│`);
+    }
     console.log(`    │   📝 Journal: ${(journalEntries + ' entries today').padEnd(26)}│`);
     console.log('    │                                          │');
     console.log('    │   ┌──────────────────────────────────┐   │');
     console.log('    │   │  MAP.md ←──── YOU ARE HERE       │   │');
     console.log('    │   │     ↓                            │   │');
-    const taskText = `${tasksInBacklog} tasks waiting`;
-    console.log(`    │   │  TODO.md ←── ${taskText.padEnd(17)}│   │`);
+    const taskText = `${tasksInBacklog} task${tasksInBacklog === 1 ? '' : 's'} waiting`;
+    console.log(`    │   │  TODO.md ←── ${taskText.padEnd(20)}│   │`);
     console.log('    │   │     ↓                            │   │');
     console.log('    │   │  navigator → executor → validator│   │');
     console.log('    │   └──────────────────────────────────┘   │');
@@ -1150,7 +1152,11 @@ function showWelcomeVisualization() {
     console.log('    └──────────────────────────────────────────┘');
   }
   console.log('');
-  console.log(`    Ready. Run 'atris plan' to start.`);
+  if (tasksCertified > 0) {
+    console.log(`    Ready. ${tasksCertified} certified await accept — run 'atris task reviews'.`);
+  } else {
+    console.log(`    Ready. Run 'atris plan' to start.`);
+  }
   console.log('');
 }
 
@@ -1179,6 +1185,11 @@ if (command === 'init') {
   Promise.resolve(require('../commands/mission').missionCommand(process.argv.slice(3)))
     .then(() => process.exit(0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'probe') {
+  // Chat-lane probe (TRR-22): one real /atris2/turn over the full tool relay.
+  Promise.resolve(require('../commands/probe').probeCommand(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 === 'worktree') {
   Promise.resolve(require('../commands/worktree').worktreeCommand(process.argv.slice(3)))
     .then((code) => process.exit(code || 0))
@@ -1197,6 +1208,11 @@ if (command === 'init') {
   Promise.resolve(require('../commands/aeo').run(process.argv.slice(3)))
     .then(() => process.exit(0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'improve') {
+  // Improve: one paid RL tick via POST /api/improve (deducts credits), local autopilot fallback.
+  Promise.resolve(require('../commands/improve').run(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 === 'brain') {
   Promise.resolve()
     .then(() => require('../commands/brain').brainCommand(process.argv.slice(3)))
@@ -1243,6 +1259,8 @@ if (command === 'init') {
     process.exit(0);
   }
   require('../commands/now').nowAtris(args);
+} else if (command === 'recap') {
+  require('../commands/recap').recapAtris(process.argv.slice(3));
 } else if (command === 'activate') {
   const args = process.argv.slice(3);
   if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
@@ -1622,6 +1640,14 @@ if (command === 'init') {
   integrationsStatus()
     .then(() => process.exit(0))
     .catch((err) => { console.error(`✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'apps') {
+  // Keep APP.md app-pack operations independent from the heavier workspace boot
+  // path so `atris apps --json` stays machine-readable for agents.
+  const subcommand = process.argv[3];
+  const args = process.argv.slice(4);
+  Promise.resolve(require('../commands/apps').appsCommand(subcommand, ...args))
+    .then(() => process.exit(0))
+    .catch((err) => { console.error(`✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'learn') {
   const subcommand = process.argv[3];
   const args = process.argv.slice(4);
@@ -1637,7 +1663,9 @@ if (command === 'init') {
 } else if (command === 'member') {
   const subcommand = process.argv[3];
   const args = process.argv.slice(4);
-  require('../commands/member').memberCommand(subcommand, ...args);
+  Promise.resolve(require('../commands/member').memberCommand(subcommand, ...args))
+    .then(() => process.exit(0))
+    .catch((err) => { console.error(`✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'app') {
   const subcommand = process.argv[3];
   const args = process.argv.slice(4);
@@ -1745,6 +1773,12 @@ if (command === 'init') {
   const subcommand = process.argv[3];
   const args = process.argv.slice(4);
   require('../commands/experiments').experimentsCommand(subcommand, ...args);
+} else if (command === 'compile') {
+  const subcommand = process.argv[3];
+  const args = process.argv.slice(4);
+  Promise.resolve(require('../commands/compile').compileCommand(subcommand, ...args))
+    .then(() => process.exit(process.exitCode || 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'receipt' || command === 'proof' || command === 'openclaw') {
   const subcommand = process.argv[3];
   const args = process.argv.slice(4);

package/commands/align.js

@@ -173,20 +173,6 @@ async function walkCloud(token, businessId, workspaceId) {
   return { files: out, errors };
 }
 
-/**
- * Get cloud file content (for hash computation when /files doesn't return hashes).
- */
-async function fetchCloudFileHash(token, businessId, workspaceId, filePath) {
-  const result = await apiRequestJson(
-    `/business/${businessId}/workspaces/${workspaceId}/file?path=${encodeURIComponent(filePath)}`,
-    { method: 'GET', token }
-  );
-  if (!result.ok) return null;
-  const content = result.data && result.data.content;
-  if (typeof content !== 'string') return null;
-  return hashContent(Buffer.from(content, 'utf-8'));
-}
-
 /**
  * Wake the EC2 computer and wait until it's running.
  * Returns the endpoint URL or null on timeout.

package/commands/apps.js

@@ -1,6 +1,10 @@
 const fs = require('fs');
 const path = require('path');
 const { spawnSync } = require('child_process');
+const { ensureValidCredentials } = require('../utils/auth');
+const { apiRequestJson } = require('../utils/api');
+
+const CLOUD_LOAD_COMMANDS = new Set(['load', 'cloud', 'mine']);
 
 function findAppsPackRoot(startDir = process.cwd()) {
   const explicit = process.env.ATRIS_APPS_PACK;
@@ -25,6 +29,7 @@ function appsUsageLines() {
     '',
     'Commands:',
     '  list [--json]                List available local apps',
+    '  load [--filter kind] [--json] Load owned cloud apps from Atris',
     '  run <slug> [--lines N]       Run an app and print data/latest.md or --json status',
     '  owner <slug> [--json]        Show owner view: launch, usage, learning, next actions',
     '  status [--json]              Show local app health',
@@ -156,7 +161,99 @@ function runPackScript(packRoot, script, args) {
   process.exit(result.status ?? 0);
 }
 
-function appsCommand(subcommand, ...rawArgs) {
+function normalizeCloudAppsPayload(data) {
+  if (Array.isArray(data)) return data;
+  if (Array.isArray(data?.apps)) return data.apps;
+  if (Array.isArray(data?.items)) return data.items;
+  if (Array.isArray(data?.data)) return data.data;
+  return [];
+}
+
+function compactCloudApp(app) {
+  const slug = app?.slug || app?.id || app?.name || 'unknown';
+  return {
+    id: app?.id || null,
+    name: app?.name || slug,
+    slug,
+    description: app?.description || null,
+    template: app?.template || app?.template_slug || null,
+    status: app?.status || app?.health || null,
+    last_run: app?.last_run || app?.lastRun || app?.last_run_at || null,
+    next_run: app?.next_run || app?.nextRun || app?.next_run_at || null,
+  };
+}
+
+function printCloudApps(apps, filter) {
+  const suffix = filter ? ` (${filter})` : '';
+  if (apps.length === 0) {
+    console.log(`No cloud apps found${suffix}.`);
+    return;
+  }
+  console.log(`Cloud apps${suffix}:`);
+  for (const app of apps) {
+    const name = String(app.name || app.slug || 'Untitled app');
+    const slug = String(app.slug || app.id || 'unknown');
+    const status = app.status ? ` status=${app.status}` : '';
+    const template = app.template ? ` template=${app.template}` : '';
+    console.log(`  ${slug.padEnd(24)} ${name}${status}${template}`);
+  }
+}
+
+function printAppsLoadHelp() {
+  console.log('');
+  console.log('Usage: atris apps load [--filter <template|paid|free>] [--json]');
+  console.log('');
+  console.log('Load owned cloud apps from Atris. Requires `atris login`.');
+  console.log('');
+}
+
+async function loadCloudApps(rawArgs) {
+  const args = [...rawArgs];
+  if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
+    printAppsLoadHelp();
+    return;
+  }
+  const json = args.includes('--json');
+  if (json) args.splice(args.indexOf('--json'), 1);
+  let filter = popOption(args, '--filter', null);
+  if (!filter && args[0] && !args[0].startsWith('-')) filter = args.shift();
+  if (args.length > 0) {
+    exitAppsError(`Unknown apps load option: ${args[0]}`, json, { usage: true, code: 2 });
+  }
+
+  const ensured = await ensureValidCredentials(apiRequestJson);
+  if (ensured.error || !ensured.credentials?.token) {
+    exitAppsError('Not logged in. Run: atris login', json, {
+      extra: { login: 'atris login' },
+    });
+  }
+
+  const query = filter ? `?filter=${encodeURIComponent(filter)}` : '';
+  const result = await apiRequestJson(`/apps${query}`, {
+    method: 'GET',
+    token: ensured.credentials.token,
+  });
+  if (!result.ok) {
+    exitAppsError(`Failed to load cloud apps: ${result.error || result.status || 'request failed'}`, json, {
+      extra: { status: result.status || null },
+    });
+  }
+
+  const apps = normalizeCloudAppsPayload(result.data).map(compactCloudApp);
+  if (json) {
+    console.log(JSON.stringify({
+      ok: true,
+      source: 'cloud',
+      filter: filter || null,
+      count: apps.length,
+      apps,
+    }, null, 2));
+    return;
+  }
+  printCloudApps(apps, filter || null);
+}
+
+async function appsCommand(subcommand, ...rawArgs) {
   const jsonRequested = wantsJson(subcommand, rawArgs);
   const normalized = normalizeInvocation(subcommand, rawArgs);
   subcommand = normalized.subcommand;
@@ -166,6 +263,10 @@ function appsCommand(subcommand, ...rawArgs) {
     printAppsHelp();
     return;
   }
+  if (CLOUD_LOAD_COMMANDS.has(subcommand)) {
+    await loadCloudApps(rawArgs);
+    return;
+  }
   const packRoot = findAppsPackRoot();
   if (!packRoot) {
     if (jsonRequested) {