atris 3.57.3 → 3.58.5

package/bin/atris.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// Catch-all for uncaught async errors — prevents silent crashes
+// Catch-all for uncaught async errors, prevents silent crashes
 process.on('unhandledRejection', (err) => {
   console.error(`\n✗ Unexpected error: ${err?.message || err}`);
   process.exit(1);
@@ -77,7 +77,7 @@ const {
 const { getLogPath, ensureLogDirectory, createLogFile } = require('../lib/file-ops');
 const { getConfigPath, loadConfig, saveConfig, loadLogSyncState, saveLogSyncState } = require('../utils/config');
 
-// Auth & API (canonical modules — eliminates duplicate inline code)
+// Auth & API (canonical modules, eliminates duplicate inline code)
 const {
   decodeJwtClaims, getTokenExpiryEpochSeconds, shouldRefreshToken,
   getCredentialsPath, saveCredentials, loadCredentials, deleteCredentials,
@@ -316,7 +316,7 @@ if (!helpRequested && !dryRunRequested && (
  *
  * Each mission: { id, owner, objective, status, verifier, verifier_passed, next_action, lane }.
  *
- * Returns [] if file missing or malformed — never throws.
+ * Returns [] if file missing or malformed, never throws.
  */
 function loadActiveMissions(workspaceDir) {
   try {
@@ -350,7 +350,7 @@ function loadActiveMissions(workspaceDir) {
         runner: m.runner || null,
       });
     }
-    // Most recently started first (rough — relies on insertion order from reversed walk)
+    // Most recently started first (rough, relies on insertion order from reversed walk)
     return live;
   } catch {
     return [];
@@ -499,6 +499,7 @@ function showHelpShort() {
   console.log('');
   console.log('  atris "what do you want here?"   empty folder');
   console.log('  atris later "..."                remember without a room');
+  console.log('  atris guide "..."                translate your words');
   console.log('  atris do                         work already here');
   console.log('  atris spaceship                  Keep working for a few hours');
   console.log('  atris autopilot                  Keep working until you stop');
@@ -510,6 +511,7 @@ function showHelpShort() {
 function helpCatalog() {
   return [
     { name: 'init', summary: 'scaffold atris/ in this project', json: false, interactive_risk: 'medium' },
+    { name: 'guide', summary: 'translate plain english into the right atris move', json: true, interactive_risk: 'none' },
     { name: 'task', summary: 'local task plane: new, claim, ready, accept', json: true, interactive_risk: 'low' },
     { name: 'review', summary: 'validate work and capture learnings', json: false, interactive_risk: 'low' },
     { name: 'recap', summary: 'spoken recap of what your team did', json: true, interactive_risk: 'low' },
@@ -528,6 +530,7 @@ function showHelpAll() {
   console.log('you say what you want. already won. one next step.');
   console.log('');
   console.log('  atris later "..."                remember without a room');
+  console.log('  atris guide "..."                translate your words');
   console.log('  atris do                         work already here');
   console.log('  atris spaceship                  Keep working for a few hours');
   console.log('  atris autopilot                  Keep working until you stop');
@@ -559,6 +562,7 @@ function showHelpAll() {
   console.log('  spaceship  - Bounded overnight runner that survives bad ticks and emails updates');
   console.log('');
   console.log('Context & tracking:');
+  console.log('  guide      - Translate plain english into the right Atris move');
   console.log('  log        - Add ideas to inbox (`atris log "note"`; `log --repl` for the editor; see also `wish`)');
   console.log('  wish       - Say one plain sentence, then Atris asks only for gaps or delegates it');
   console.log('  now        - Show atris/now.md, the current operating truth');
@@ -581,9 +585,10 @@ function showHelpAll() {
   console.log('  xp         - Show Career XP and contribution graph');
   console.log('  analytics  - Show recent productivity from journals');
   console.log('  revisions  - show possible human revisions after atris-assisted landings');
+  console.log('  tree hash  - hash the live agent text tree (--json for manifest)');
   console.log('  search     - Search workspace memory (atris search <keyword>)');
   console.log('  clean      - Housekeeping (stale tasks, archive journals, broken refs)');
-  console.log('  close      - track open loops with deadlines and daily escalation');
+  console.log('  close      - keep ten active loops and park the rest with their history');
   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('  slop       - Deterministic slop detector: frontend/prose tells, dead code (slop dead --exports)');
@@ -638,7 +643,7 @@ function showHelpAll() {
   console.log('  experiments keep <slug>     - Keep a pack only when measure.py moves 0 to 1');
   console.log('  experiments revert <slug>   - Run a pack reset.py after a refused keep');
   console.log('  experiments benchmark [m]   - Run validate/runtime experiment benchmarks');
-  console.log('  bench      - run core benchmark gates');
+  console.log('  bench      - run benchmark gates or compare trees with bench pair');
   console.log('');
   console.log('Compile loop (learn like AI, run like code):');
   console.log('  compile record <name>       - Append an execution record (--input/--output)');
@@ -1112,7 +1117,7 @@ if (command === 'help' || command === '--help' || command === '-h') {
   process.exit(0);
 }
 
-// Core command handlers — loaded eagerly (used by interactiveEntry default path)
+// Core command handlers, loaded eagerly (used by interactiveEntry default path)
 const { initAtris: initCmd } = require('../commands/init');
 const { syncAtris: syncCmd, syncAtrisAll: syncAllCmd } = require('../commands/sync');
 const { logAtris: logCmd } = require('../commands/log');
@@ -1154,7 +1159,7 @@ 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
+// Voice-friendly aliases, natural language → command mapping
 // Solves speech-to-text issues (inspired by gstack v0.14.6 voice-triggers)
 // One-word voice aliases like start/go/audit/deploy must not spawn runners.
 // Unmatched single verbs exit 2 with did-you-mean (see below). Keep phrases
@@ -1197,11 +1202,11 @@ if (!command || !knownCommands.includes(command)) {
   const triggered = voiceTriggers[fullInput] || voiceTriggers[fullInputWithoutFlags];
   if (triggered) {
     command = triggered;
-    // Re-check — if it's now a known command, fall through to dispatch
+    // Re-check, if it's now a known command, fall through to dispatch
     if (knownCommands.includes(command)) {
       // Rewrite argv so dispatch works
       process.argv[2] = command;
-      // Don't return — let it fall through to the command dispatch below
+      // Don't return, let it fall through to the command dispatch below
     }
   }
 }
@@ -1454,7 +1459,7 @@ async function interactiveEntry(userInput, options = {}) {
     ? context.inProgressFeaturesCount
     : (context.inProgressFeatures || []).length;
 
-  // Pull active missions (durable goals) — these outrank dev-pipeline state
+  // Pull active missions (durable goals), these outrank dev-pipeline state
   // because a mission with an unverified verifier is a Keshav-attributable
   // commitment that hasn't been closed yet.
   const activeMissions = loadActiveMissions(workspaceDir);
@@ -1554,7 +1559,7 @@ async function interactiveEntry(userInput, options = {}) {
       console.log('Got it. I saved your first direction.');
       console.log(`Focus: ${profile.first_answer}`);
       if (starter && starter.display_id) {
-        console.log(`First task: ${starter.display_id} — ${starter.title}`);
+        console.log(`First task: ${starter.display_id}, ${starter.title}`);
       } else if (starter && starter.title) {
         console.log(`First task: ${starter.title}`);
       }
@@ -1581,7 +1586,7 @@ async function interactiveEntry(userInput, options = {}) {
     console.log('Got it. I saved your first direction.');
     console.log(`Focus: ${profile.first_answer}`);
     if (starter && starter.display_id) {
-      console.log(`First task: ${starter.display_id} — ${starter.title}`);
+      console.log(`First task: ${starter.display_id}, ${starter.title}`);
     } else if (starter && starter.title) {
       console.log(`First task: ${starter.title}`);
     }
@@ -1609,6 +1614,7 @@ async function askContextGatherer(workspaceDir) {
 // this output it stays compact so it costs almost nothing in context.
 function showWelcomeVisualization() {
   const { getTaskGlance } = require('../lib/state-detection');
+  const { INTENTS } = require('../lib/intents');
   const { readEndgameState } = require('../commands/autopilot');
   const cwd = process.cwd();
   const atrisDir = path.join(cwd, 'atris');
@@ -1816,6 +1822,17 @@ function showWelcomeVisualization() {
     console.log(row('goal', endgameState.horizon || endgameState.slug));
   }
 
+  const hasNoTasks = glance.active === 0
+    && glance.review === 0
+    && glance.reviewCertified === 0;
+  if (hasNoTasks) {
+    const phrases = INTENTS
+      .filter((intent) => intent.offer === 'boot_empty')
+      .map((intent) => intent.say[0])
+      .slice(0, 2);
+    console.log(row('say', `"${phrases[0]}" or "${phrases[1]}"  (your agent translates)`));
+  }
+
   // The next command always carries a plain-english gloss: a newcomer should
   // know what typing it will do before they type it.
   let next;
@@ -1833,7 +1850,10 @@ function showWelcomeVisualization() {
   console.log('');
 }
 
-if (command === 'init') {
+if (command === 'guide') {
+  const code = require('../commands/guide').guideCommand(process.argv.slice(3));
+  process.exit(typeof code === 'number' ? code : 0);
+} else if (command === 'init') {
   // Help flag must short-circuit before initCmd() (which scaffolds files)
   // and before interactiveEntry (which loads workspace context).
   const initArg = process.argv[3];
@@ -1884,7 +1904,7 @@ if (command === 'init') {
 } else if (command === 'decide') {
   // process.exit() can outrun a piped stdout: writes beyond the 64KB pipe
   // buffer are async, so large --json payloads truncate at 64KB multiples.
-  // Queue an empty write and exit from its callback — it fires only after
+  // Queue an empty write and exit from its callback, it fires only after
   // every earlier buffered write has drained (BCK-1306).
   const exitAfterStdoutDrain = (code) => {
     if (process.stdout.writableLength === 0) process.exit(code);
@@ -1912,7 +1932,7 @@ if (command === 'init') {
 } else if (command === 'mission') {
   // process.exit() can outrun a piped stdout: writes beyond the 64KB pipe
   // buffer are async, so large --json payloads truncate at 64KB multiples.
-  // Queue an empty write and exit from its callback — it fires only after
+  // Queue an empty write and exit from its callback, it fires only after
   // every earlier buffered write has drained (BCK-1306).
   const exitAfterStdoutDrain = (code) => {
     if (process.stdout.writableLength === 0) process.exit(code);
@@ -1975,7 +1995,7 @@ if (command === 'init') {
     .then((code) => process.exit(typeof code === 'number' ? code : 0))
     .catch((err) => { console.error(`\nerror: ${err.message || err}`); process.exit(1); });
 } else if (command === 'drive') {
-  // Drive: one self-driving tick — mission doctor -> auto-fix safe findings -> count disengagements.
+  // Drive: one self-driving tick, mission doctor -> auto-fix safe findings -> count disengagements.
   Promise.resolve(require('../commands/drive').driveCommand(process.argv.slice(3)))
     .then((code) => process.exit(code || 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
@@ -2002,7 +2022,7 @@ if (command === 'init') {
     .then(() => process.exit(process.exitCode || 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'aeo') {
-  // AEO: AI Engine Optimization — credit-metered citation drafting against the customer workspace.
+  // AEO: AI Engine Optimization, credit-metered citation drafting against the customer workspace.
   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); });
@@ -2163,6 +2183,13 @@ if (command === 'init') {
     process.exit(0);
   }
   upgradeAtris().then(() => process.exit(0)).catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'chat' && (process.argv[3] === '--personal' || process.argv[3] === '-p')) {
+  require('../commands/ask').askAtris(process.argv.slice(4))
+    .then(() => process.exit(0))
+    .catch((error) => {
+      console.error(`✗ Ask failed: ${error.message || error}`);
+      process.exit(1);
+    });
 } else if (command === 'chat') {
   if (process.argv[3] === 'scan') {
     try {
@@ -2189,7 +2216,7 @@ if (command === 'init') {
 } else if (command === 'console') {
   consoleCmd();
 } else if (command === 'serve') {
-  // Start the local AI Computer bridge — make this directory addressable
+  // Start the local AI Computer bridge, make this directory addressable
   // by cloud agents via the Atris API
   const serveArgs = process.argv.slice(3);
   if (serveArgs.includes('--help') || serveArgs.includes('-h') || serveArgs[0] === 'help') {
@@ -2291,7 +2318,7 @@ if (command === 'init') {
   // Hidden: copy profile to credentials.json (global switch, legacy)
   require('../commands/auth').activateGlobal();
 } else if (command === '_switch-session') {
-  // Hidden: per-terminal switch — writes session file so each tab keeps its own account
+  // Hidden: per-terminal switch, writes session file so each tab keeps its own account
   require('../commands/auth').switchSession();
 } else if (command === 'shell-init') {
   require('../commands/auth').shellInit();
@@ -3062,7 +3089,7 @@ if (command === 'init') {
     .then((code) => process.exit(typeof code === 'number' ? code : 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'write') {
-  // Write: guided writing sessions — human types every word, atris structures + reviews (plan-do-review for prose).
+  // Write: guided writing sessions, human types every word, atris structures + reviews (plan-do-review for prose).
   Promise.resolve(require('../commands/write').writeCommand(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); });
@@ -3084,7 +3111,7 @@ if (command === 'init') {
     .then((code) => process.exit(typeof code === 'number' ? code : 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'moves') {
-  // Moves: your 3 next moves — approve one into the loop, kill, or skip.
+  // Moves: your 3 next moves, approve one into the loop, kill, or skip.
   Promise.resolve(require('../commands/moves').movesCommand(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); });
@@ -3094,7 +3121,7 @@ if (command === 'init') {
     .then((code) => process.exit(typeof code === 'number' ? code : 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'feed') {
-  // Feed: read and post the business group feed — receipts and state changes only.
+  // Feed: read and post the business group feed, receipts and state changes only.
   // Sets exitCode instead of process.exit() so large --json output flushes fully.
   Promise.resolve(require('../commands/feed').feedCommand(process.argv.slice(3)))
     .then((code) => { process.exitCode = typeof code === 'number' ? code : 0; })
@@ -3105,7 +3132,7 @@ if (command === 'init') {
     .then((code) => process.exit(typeof code === 'number' ? code : 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'interview') {
-  // Interview: the interlinked 1-on-1 — live interview that extracts judgment into a member file.
+  // Interview: the interlinked 1-on-1, live interview that extracts judgment into a member file.
   Promise.resolve(require('../commands/interview').interviewCommand(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); });
@@ -3115,7 +3142,7 @@ if (command === 'init') {
     .then((code) => process.exit(typeof code === 'number' ? code : 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'site') {
-  // Site: beautiful static site from a folder of markdown, in the anti-slop design system.
+  // Site: build markdown sites or publish static web folders.
   {
     const raw = process.argv.slice(3);
     const deployWrite = raw[0] === 'deploy'
@@ -3151,6 +3178,11 @@ if (command === 'init') {
   Promise.resolve(require('../commands/reel').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 === 'tree') {
+  const subcommand = process.argv[3];
+  const args = process.argv.slice(4);
+  const code = require('../commands/tree').treeCommand(subcommand, ...args);
+  process.exit(code || 0);
 } else if (command === 'receipt' || command === 'proof' || command === 'openclaw') {
   const subcommand = process.argv[3];
   const args = process.argv.slice(4);
@@ -3550,10 +3582,19 @@ async function chatAtris() {
   const fastLaneFlags = [];
   const messageArgs = [];
   let agentLane = false;
-  for (const arg of rawArgs) {
+  for (let index = 0; index < rawArgs.length; index += 1) {
+    const arg = rawArgs[index];
     if (arg === '--agent') {
       agentLane = true;
-    } else if (arg === '--print' || arg === '--headless' || arg === '--rapid' || arg === '--auto-approve') {
+    } else if (arg === '--effort') {
+      const next = rawArgs[index + 1];
+      if (next && !next.startsWith('-')) {
+        fastLaneFlags.push('--effort', next);
+        index += 1;
+      } else {
+        fastLaneFlags.push('--effort');
+      }
+    } else if (arg === '--print' || arg === '--headless' || arg === '--rapid' || arg === '--alpha' || arg === '--auto-approve') {
       fastLaneFlags.push(arg);
     } else {
       messageArgs.push(arg);
@@ -3567,10 +3608,13 @@ async function chatAtris() {
     console.log('');
     console.log('  Chat with Atris 2 Fast in this workspace: tools attached, same turn as `ax --fast`.');
     console.log('  Pass --rapid to use Atris Rapid instead.');
+    console.log('  Pass --alpha to use Atris Alpha (experimental preview lane).');
+    console.log('  Pass --effort medium|high|xhigh to override reasoning depth for the turn/session.');
     console.log('  Requires `atris login`.');
     console.log('');
     console.log('  atris chat                  Interactive chat (ax --fast --chat)');
     console.log('  atris chat --rapid          Interactive Rapid chat (ax --rapid --chat)');
+    console.log('  atris chat --alpha          Interactive Alpha chat (ax --alpha --chat)');
     console.log('  atris chat --rapid --auto-approve   Rapid chat that auto-approves safe git push');
     console.log('  atris chat "what now?"      One-shot message (ax --fast)');
     console.log('  atris chat --print "..."    Headless JSON result (ax --fast --print)');
@@ -3598,8 +3642,12 @@ async function chatAtris() {
   if (!agentLane) {
     try {
       const axPath = path.join(__dirname, '..', 'ax');
-      const lane = fastLaneFlags.includes('--rapid') ? '--rapid' : '--fast';
-      const extraFlags = fastLaneFlags.filter((flag) => flag !== '--rapid');
+      const lane = fastLaneFlags.includes('--alpha')
+        ? '--alpha'
+        : fastLaneFlags.includes('--rapid')
+          ? '--rapid'
+          : '--fast';
+      const extraFlags = fastLaneFlags.filter((flag) => flag !== '--rapid' && flag !== '--alpha');
       const axArgs = message
         ? [lane, ...extraFlags, message].filter(Boolean)
         : [lane, ...extraFlags, '--chat'];
@@ -3680,7 +3728,7 @@ async function chatInteractive(config, credentials) {
     const conversationId = `cli-${Date.now()}`;
 
     console.log('┌────────────────────────────────────────────────────────────┐');
-    console.log(`│ Atris Chat — ${agentName.padEnd(44)} │`);
+    console.log(`│ Atris Chat, ${agentName.padEnd(44)} │`);
     console.log('├────────────────────────────────────────────────────────────┤');
     console.log('│ Type your message and press Enter                          │');
     console.log('│ Type "exit" to quit                                        │');
@@ -3871,7 +3919,7 @@ async function atrisFastChat() {
   // One routing brain: `atris fast` defers to ax's AX Context Standard. A
   // workspace-shaped question asked from inside a workspace needs local tools
   // (this lane is a tool-less cloud one-shot and confabulates on repo
-  // questions — SwapBench 2026-07-02), so delegate the whole turn to ax.
+  // questions, SwapBench 2026-07-02), so delegate the whole turn to ax.
   try {
     const axModule = require('../ax');
     if (axModule.resolveRoute(message) === 'local') {

package/commands/aeo.js

@@ -1,5 +1,5 @@
 /**
- * atris aeo — AI Engine Optimization commands
+ * atris aeo, AI Engine Optimization commands
  *
  * Backend-routed (require EC2):
  *   atris aeo init                          # create entity-graph skeleton
@@ -213,7 +213,7 @@ async function aeoScan(args) {
   }
   if (asJson) { console.log(JSON.stringify(data, null, 2)); return; }
   console.log(`\n  ${data.name || target}`);
-  console.log(`  Score: ${data.score}/100 (${data.grade}) — ${data.status}`);
+  console.log(`  Score: ${data.score}/100 (${data.grade}), ${data.status}`);
   if (data.gap_statement) console.log(`\n  ${data.gap_statement}`);
   const gaps = data.gaps || [];
   if (gaps.length) {
@@ -226,7 +226,7 @@ async function aeoScan(args) {
     for (const c of comp) console.log(`   ${pad(String(c.score ?? '?'), 4)} ${c.url || c.name}`);
   }
   if (data.draft_llms_txt) {
-    console.log('\n  Draft llms.txt included — save it with:');
+    console.log('\n  Draft llms.txt included, save it with:');
     console.log(`   atris aeo scan ${url} --json | jq -r .draft_llms_txt > llms.txt`);
   }
   console.log('');
@@ -511,7 +511,7 @@ async function aeoPacket(args) {
   const onlyObjects = (v) => (Array.isArray(v) ? v.filter((x) => x && typeof x === 'object') : []);
   const friction = onlyObjects(u.baseline_friction_points);
   const fixes = onlyObjects(u.fix_backlog);
-  console.log(`AEO buyer packet — ${slug}`);
+  console.log(`AEO buyer packet, ${slug}`);
   console.log(`  surface:        ${data.surface || ''}`);
   console.log(`  target url:     ${data.target_url || ''}`);
   console.log(`  claim status:   ${data.claim_status || ''}`);

package/commands/agents.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// atris agents — one glanceable view of every member's state.
+// atris agents, one glanceable view of every member's state.
 // Reads .atris/state/missions.jsonl (schema atris.mission.v1) plus the
 // directories in atris/team/, and prints who is stuck, waiting on you,
 // working, or resting. Built from a dream card: "validator cannot plan

package/commands/align.js

@@ -100,7 +100,7 @@ function walkLocal(rootDir) {
  * Why this instead of recursive /files walk: the recursive walk is rate-limited
  * (60/min) and hangs on workspaces with many subdirs. The /snapshot endpoint
  * returns the full file tree in one call. Trade-off: snapshot can be incomplete
- * for very deep hierarchies (server-side bug we've seen) — but it's vastly faster
+ * for very deep hierarchies (server-side bug we've seen), but it's vastly faster
  * and we accept that risk in exchange for not hanging.
  */
 async function walkCloud(token, businessId, workspaceId) {
@@ -126,14 +126,14 @@ async function walkCloud(token, businessId, workspaceId) {
       out[p] = { hash: f.hash || null, size: f.size || 0 };
     }
     // CRITICAL: only return if snapshot actually had files. Empty snapshot is
-    // a known server-side bug — fall back to recursive walk in that case so
+    // a known server-side bug, fall back to recursive walk in that case so
     // we don't report every local file as "only on local" against a phantom empty cloud.
     if (Object.keys(out).length > 0) {
       return { files: out, errors };
     }
     errors.push({ path: '<snapshot>', status: 'empty', fallback: 'recursive walk' });
   } else {
-    // Snapshot failed entirely — fall back to recursive walk
+    // Snapshot failed entirely, fall back to recursive walk
     errors.push({ path: '<snapshot>', status: snapshotResult.status, fallback: 'recursive walk' });
   }
 
@@ -288,7 +288,7 @@ async function alignHardLocalToCloud(token, biz, localDir) {
   const { buildManifest, saveManifest, computeLocalHashes } = require('../lib/manifest');
 
   // 1. List top-level entries on cloud via /files (1 fast API call).
-  //    We deliberately AVOID /snapshot here — its hangs/timeouts on bloated
+  //    We deliberately AVOID /snapshot here, its hangs/timeouts on bloated
   //    workspaces are the whole reason --hard exists. /files at depth 0 is
   //    a single dir-listing call that returns reliably.
   //
@@ -319,12 +319,12 @@ async function alignHardLocalToCloud(token, biz, localDir) {
   const cloudTopEntries = (topResult.data && topResult.data.files) || [];
   console.log(`${cloudTopEntries.length} entries`);
 
-  // The `workspace` top-level entry is the workspace root itself — it's
+  // The `workspace` top-level entry is the workspace root itself, it's
   // protected server-side (DELETE returns 400) and is NEVER cruft. Don't
   // try to delete it; pretend it isn't there for the diff.
   const PROTECTED_TOP = new Set(['workspace']);
 
-  // 2. Top-level local entries — track names AND types so we can detect
+  // 2. Top-level local entries, track names AND types so we can detect
   //    type-mismatch (cloud has file `foo`, local has dir `foo/`).
   const localTopByName = new Map(); // name -> 'dir' | 'file'
   for (const e of fs.readdirSync(localDir, { withFileTypes: true })) {
@@ -341,7 +341,7 @@ async function alignHardLocalToCloud(token, biz, localDir) {
   //
   // NOTE: --hard intentionally does NOT respect SKIP_DIRS/SKIP_FILES here.
   // Those skip lists exist for the diff/walk path so we don't enumerate
-  // node_modules/venv/__pycache__ locally — they are NOT protections that
+  // node_modules/venv/__pycache__ locally, they are NOT protections that
   // mean "don't delete on cloud." A bloated cloud workspace might genuinely
   // contain stale `default/`, `venv/`, `__pycache__/` etc that the user
   // wants nuked. --hard means "make cloud match local"; if local doesn't
@@ -354,7 +354,7 @@ async function alignHardLocalToCloud(token, biz, localDir) {
     if (PROTECTED_TOP.has(name)) return false;
     const localType = localTopByName.get(name);
     if (!localType) return true; // not in local at all
-    if (localType !== entry.type) return true; // type mismatch — must clear
+    if (localType !== entry.type) return true; // type mismatch, must clear
     return false;
   });
 
@@ -413,7 +413,7 @@ async function alignHardLocalToCloud(token, biz, localDir) {
     const r = await pushFiles(token, businessId, workspaceId, batch, 180000);
     if (r.ok) {
       // The server returns SyncResponse{written, unchanged, errors, results}
-      // inside a 200. A successful HTTP doesn't mean every file landed —
+      // inside a 200. A successful HTTP doesn't mean every file landed,
       // results can include status="error" entries (path-traversal attempts,
       // permission errors, full disk, etc). Trust the server's count and
       // record any per-file errors against batchFailures so we don't write
@@ -446,7 +446,7 @@ async function alignHardLocalToCloud(token, biz, localDir) {
     if (failedPaths.length > 8) console.log(`      ... +${failedPaths.length - 8} more`);
   }
 
-  // 5. Save manifest so subsequent push/pull diffs work — but ONLY if every
+  // 5. Save manifest so subsequent push/pull diffs work, but ONLY if every
   //    batch, every per-file write, AND every cloud delete succeeded. If
   //    anything failed, leaving the manifest stale is safer than recording
   //    a mirror that doesn't actually exist on cloud (the manifest would
@@ -553,7 +553,7 @@ async function alignAtris() {
   // --hard: skip the slow file-by-file walk. Nuke top-level cloud entries
   // not present locally (1 DELETE per top-level dir, recursive on the server),
   // then bulk-push every local file via /sync. Designed for "cloud is bloated,
-  // local is canonical, just make them match" — the force-push escape hatch.
+  // local is canonical, just make them match", the force-push escape hatch.
   if (hard && fix) {
     console.log(`  Local:  ${localDir}`);
     console.log(`  Cloud:  ${endpoint}`);
@@ -635,7 +635,7 @@ async function alignAtris() {
   }
 
   // FIX MODE
-  console.log(`  Fixing — ${fromSide} is canonical:`);
+  console.log(`  Fixing, ${fromSide} is canonical:`);
 
   if (fromSide === 'local') {
     // Delete cloud-only files (they're cruft)

package/commands/analytics.js

@@ -68,8 +68,8 @@ function analyticsAtris() {
     }
 
     // Parse timestamps for productivity hours. Match the journal heading
-    // format `### Title — HH:MM` and the legacy `**HH:MM:SS**` form.
-    const timestampMatches = content.match(/(?:—|--)\s*(\d{2}):\d{2}(?::\d{2})?\b|\*\*(\d{2}):\d{2}(?::\d{2})?\*\*/g);
+    // format `### Title -- HH:MM` (the dashed form) and the legacy `**HH:MM:SS**` form.
+    const timestampMatches = content.match(/(?:\u2014|--)\s*(\d{2}):\d{2}(?::\d{2})?\b|\*\*(\d{2}):\d{2}(?::\d{2})?\*\*/g);
     if (timestampMatches) {
       timestampMatches.forEach(ts => {
         const m = ts.match(/(\d{2}):/);
@@ -110,7 +110,7 @@ function analyticsAtris() {
   const dateFormatted = `${year}-${month}-${day}`;
   console.log('');
   console.log('┌─────────────────────────────────────────────────────────────┐');
-  console.log(`│ Atris Analytics — ${dateFormatted}${' '.repeat(34 - dateFormatted.length)}│`);
+  console.log(`│ Atris Analytics, ${dateFormatted}${' '.repeat(35 - dateFormatted.length)}│`);
   console.log('└─────────────────────────────────────────────────────────────┘');
   console.log('');
 

package/commands/app.js

@@ -1,5 +1,5 @@
 /**
- * atris app — manage APP.md manifests in the current workspace.
+ * atris app, manage APP.md manifests in the current workspace.
  *
  * Subcommands:
  *   atris app init <slug> [--runtime ec2|local|webhook|external|web|ios|template]
@@ -181,9 +181,9 @@ function readmeFor(slug) {
     '',
     '## Files',
     '',
-    '- `APP.md` — app manifest (frontmatter + instructions). Source of truth.',
-    '- `data/` — per-run outputs.',
-    '- `logs/` — stdout/stderr per trigger.',
+    '- `APP.md`, app manifest (frontmatter + instructions). Source of truth.',
+    '- `data/`, per-run outputs.',
+    '- `logs/`, stdout/stderr per trigger.',
     '',
     '## Secrets',
     '',
@@ -271,7 +271,7 @@ async function show(slug) {
 }
 
 async function help() {
-  console.log('atris app — manage APP.md manifests');
+  console.log('atris app, manage APP.md manifests');
   console.log('');
   console.log('Subcommands:');
   console.log('  init <slug> [--runtime <kind>]  Scaffold a new app folder');