atris 3.58.7 → 3.58.8

package/bin/atris.js

@@ -47,7 +47,7 @@ const {
   requireAccountBound,
   refuseAccountGlobal,
 } = require('../lib/account-bound');
-const { isHelpToken, argsWantHelp, hasYesFlag } = require('../lib/noninteractive');
+const { isHelpToken, argsWantHelp, hasYesFlag, envForcesNonInteractive } = require('../lib/noninteractive');
 
 // State detection for smart default
 const { detectWorkspaceState, loadContext } = require('../lib/state-detection');
@@ -577,7 +577,7 @@ function showHelpAll() {
   console.log('  watch      - Turn one sentence into an always-on background watcher');
   console.log('  ctop       - Show a process-first live agent CPU/memory view');
   console.log('  doctor     - Node/task/auth/workspace readiness (--json for agents)');
-  console.log('  doc-health - workspace document size, navigation, and freshness (--json)');
+  console.log('  doc-health - workspace document size, navigation, freshness, and map line refs (--json, --fix-refs)');
   console.log('  launchpad  - Show the next action from local brain, task, mission, and proof state');
   console.log('  brief      - Show the one-glance operator brief');
   console.log('  status     - See local work and completions (`atris status <business>` for remote)');
@@ -1299,8 +1299,7 @@ function useInteractiveAtrisUi() {
   return Boolean(
     process.stdin.isTTY
     && process.stdout.isTTY
-    && !process.env.ATRIS_NO_INTERACTIVE
-    && process.env.ATRIS_NONINTERACTIVE !== '1'
+    && !envForcesNonInteractive()
   );
 }
 
@@ -1464,7 +1463,7 @@ async function interactiveEntry(userInput, options = {}) {
     : (context.inProgressFeatures || []).length;
 
   // Pull active missions (durable goals), these outrank dev-pipeline state
-  // because a mission with an unverified verifier is a Keshav-attributable
+  // because a mission with an unverified verifier is an owner commitment
   // commitment that hasn't been closed yet.
   const activeMissions = loadActiveMissions(workspaceDir);
   const liveMissionsCount = activeMissions.length;
@@ -2959,7 +2958,7 @@ if (command === 'guide') {
   const subcommand = process.argv[3];
   const args = process.argv.slice(4);
   Promise.resolve(require('../commands/member').memberCommand(subcommand, ...args))
-    .then(() => process.exit(0))
+    .then(() => process.exit(subcommand === 'run' ? (process.exitCode || 0) : 0))
     .catch((err) => { console.error(`✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'app') {
   const subcommand = process.argv[3];

package/commands/aeo.js

@@ -15,32 +15,29 @@
  *   atris aeo discover <source> [...]       # discovery audit
  *   atris aeo audit <source> [...]          # agent-usability audit
  *
- * Local workspace resolution: $ATRIS_AEO_ROOT or legacy $ATRIS_BACKEND_ROOT.
+ * Local workspace resolution: $ATRIS_AEO_ROOT or the configured backend root.
  */
 
 const fs = require('fs');
 const os = require('os');
 const path = require('path');
 const { spawnSync } = require('child_process');
+const { BACKEND_ROOT_HINT, resolveBackendRoot: resolveConfiguredBackendRoot } = require('../utils/backend-root');
 const { loadCredentials, abortOnAuthFailure } = require('../utils/auth');
 const { apiRequestJson } = require('../utils/api');
 const { loadBusinesses, saveBusinesses } = require('./business');
 
-function resolveBackendRoot() {
-  const candidates = [
-    process.env.ATRIS_AEO_ROOT,
-    process.env.ATRIS_BACKEND_ROOT,
-  ].filter(Boolean);
-  for (const root of candidates) {
-    if (fs.existsSync(path.join(root, 'atris', 'features', 'aeo'))) return root;
-  }
-  return null;
+function resolveAeoRoot() {
+  const explicit = process.env.ATRIS_AEO_ROOT;
+  if (explicit && fs.existsSync(path.join(explicit, 'atris', 'features', 'aeo'))) return explicit;
+  const backend = resolveConfiguredBackendRoot();
+  return backend && fs.existsSync(path.join(backend, 'atris', 'features', 'aeo')) ? backend : null;
 }
 
 function requireBackendRoot() {
-  const root = resolveBackendRoot();
+  const root = resolveAeoRoot();
   if (!root) {
-    console.error('Cannot find local AEO workspace. Set ATRIS_AEO_ROOT to a workspace containing atris/features/aeo.');
+    console.error(`cannot find local aeo workspace; ${BACKEND_ROOT_HINT}`);
     process.exit(1);
   }
   return root;

package/commands/analytics.js

@@ -68,17 +68,14 @@ function analyticsAtris() {
     }
 
     // Parse timestamps for productivity hours. Match the journal heading
-    // 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}):/);
-        if (!m) return;
-        const hour = parseInt(m[1], 10);
-        if (Number.isFinite(hour) && hour >= 0 && hour < 24) {
-          hourCounts[hour] = (hourCounts[hour] || 0) + 1;
-        }
-      });
+    // formats `### Title -- HH:MM`, `### Title - HH:MM`, and legacy `**HH:MM:SS**`.
+    // Only heading lines count, so a prose range like "10:00 - 12:30" is not a timestamp.
+    const timestampPattern = /^#{2,4} .*(?:\u2014|--| - )\s*(\d{2}):\d{2}(?::\d{2})?\s*$|\*\*(\d{2}):\d{2}(?::\d{2})?\*\*/gm;
+    for (const match of content.matchAll(timestampPattern)) {
+      const hour = parseInt(match[1] || match[2], 10);
+      if (Number.isFinite(hour) && hour >= 0 && hour < 24) {
+        hourCounts[hour] = (hourCounts[hour] || 0) + 1;
+      }
     }
   });
 

package/commands/autopilot.js

@@ -25,14 +25,15 @@ const {
   detectEndgameCompletion
 } = require('../lib/scorecard');
 const { REWARD_CONFIG, REWARD_CHECKSUM } = require('../lib/reward-config');
+const { ownerIdentity } = require('../utils/owner-identity');
 
 const pkg = require('../package.json');
 
 const PHASE_TIMEOUT = 600000; // 10 min per phase
 
 function looksOwnerClaimed(claimed) {
-  const text = String(claimed || '').toLowerCase();
-  return /\bkeshav(?:rao)?\b/.test(text) || /\b(owner|human|operator)\b/.test(text);
+  const text = String(claimed || '').trim().toLowerCase();
+  return /\b(owner|human|operator)\b/.test(text) || ownerIdentity().names.includes(text.split(/\s+/)[0]);
 }
 
 function looksOwnerGatedTitle(title) {
@@ -640,7 +641,7 @@ function getContextFiles(phase, options = {}) {
 // checkout is forbidden (COORDINATION.md Rule 4). Interpolated into the
 // default and self-heal do prompts, never the benchmark prompt (it never
 // commits).
-const SHARED_CHECKOUT_GIT_CONTRACT = `- Shared-checkout git safety (COORDINATION.md Rule 4): edits to any repo OTHER than this tick's cwd (../atrisos-backend-style sibling repos) go through a per-tick worktree, start with \`atris worktree start --member <member> --task "<task>"\`, land with \`atris worktree ship --message "<msg>" --verify "<cmd>"\`. Never edit a sibling repo's shared checkout directly.
+const SHARED_CHECKOUT_GIT_CONTRACT = `- Shared-checkout git safety (COORDINATION.md Rule 4): edits to any repo OTHER than this tick's cwd (including sibling repos) go through a per-tick worktree, start with \`atris worktree start --member <member> --task "<task>"\`, land with \`atris worktree ship --message "<msg>" --verify "<cmd>"\`. Never edit a sibling repo's shared checkout directly.
 - On a shared checkout, \`git reset\`, \`git checkout --\`, \`git clean\`, and stashing other agents' work are FORBIDDEN, concurrent ticks' uncommitted work lives there.`;
 
 /**

package/commands/avail.js

@@ -308,7 +308,7 @@ async function slotsAvail(argv) {
   if (!username) {
     const identity = await apiRequestJson('/identity/me', { method: 'GET', token });
     if (!identity.ok || !identity.data?.username) {
-      console.error('Could not resolve username, pass --user keshav');
+      console.error('could not resolve username; pass --user <username>.');
       return 1;
     }
     username = identity.data.username;

package/commands/brain.js

@@ -3,6 +3,7 @@ const path = require('path');
 const crypto = require('crypto');
 const { spawnSync } = require('child_process');
 const { refreshNowFile } = require('./now');
+const { ownerIdentity } = require('../utils/owner-identity');
 const escapeRegExp = require('../lib/escape-regexp');
 const { hasRenderedSections, isOpenSection, isDoneSection } = require('../lib/todo-sections');
 const { isNonInteractive } = require('../lib/noninteractive');
@@ -794,7 +795,8 @@ function memberNextMove(member, state = null) {
   if (member.slug === 'justin' || /justin/i.test(member.name || '')) {
     return `${name}: run one customer-moving GTM rep, update the relevant workspace state within 10 minutes, and leave a scorecard.`;
   }
-  if (member.slug === 'keshav' || /keshav/i.test(member.name || '')) {
+  const ownerNames = ownerIdentity().names;
+  if (ownerNames.includes(String(member.slug || '').toLowerCase()) || ownerNames.includes(String(member.name || '').toLowerCase())) {
     return `${name}: act as Customer 0: choose one allocation, narrative, system, or talent leverage move; leave proof and route the next owner.`;
   }
   if (/opus|overnight/i.test(identity)) {

package/commands/business.js

@@ -13,6 +13,10 @@ const {
   renderDryRun,
 } = require('../lib/business-simulate');
 
+function businessWorkspaceBase() {
+  return process.env.ATRIS_BUSINESS_ROOT || path.join(os.homedir(), 'arena', 'atris-business');
+}
+
 function getBusinessConfigPath() {
   const home = require('os').homedir();
   const dir = path.join(home, '.atris');
@@ -179,7 +183,7 @@ function buildBusinessCacheEntry(business, localSlug, existing = {}) {
   return entry;
 }
 
-function readBusinessFolderBindings(rootDir = path.join(os.homedir(), 'arena', 'atris-business')) {
+function readBusinessFolderBindings(rootDir = businessWorkspaceBase()) {
   const skip = new Set([
     '.git', '.DS_Store', 'archive', 'archives', '_archive', 'bench', 'deals',
     'node_modules', 'shelf', '_shelf', 'templates',
@@ -510,7 +514,7 @@ function resolveWorkspaceRoot(slug, options = {}) {
   if (options.noLocal) return null;
   if (options.here) return options.cwd || process.cwd();
   if (options.root) return path.join(options.root, slug);
-  return path.join(os.homedir(), 'arena', 'atris-business', slug);
+  return path.join(businessWorkspaceBase(), slug);
 }
 
 function createCanonicalBusinessWorkspace(targetRoot, bizMeta, options = {}) {
@@ -1851,7 +1855,7 @@ async function addBusiness(slug) {
 }
 
 async function listBusinesses(opts = {}) {
-  // --local mode: walk ~/arena/atris-business/ and show fleet status table
+  // --local mode: walk the configured business workspace folder
   // (no API calls, rate-limit safe). Different from API-mode below which lists
   // businesses cached from the API.
   if (opts.local) {
@@ -1877,7 +1881,7 @@ async function listBusinesses(opts = {}) {
 }
 
 /**
- * Walk ~/arena/atris-business/ and print a fleet status table for every
+ * Walk the configured business folder and print a fleet status table for every
  * customer workspace. Pure local, no API calls, no rate-limit risk.
  *
  * Classifies each dir as: ready, flat, unbound, nested, bare, or superseded.
@@ -1891,7 +1895,7 @@ function listBusinessesLocal(opts = {}) {
   const SKIP_DIRS = new Set(['deals', 'archive', 'archives', '_archive', 'templates', 'node_modules', '.git']);
   const SKIP_FILES = new Set(['.DS_Store', 'Thumbs.db']);
 
-  const rootDir = opts.root || path.join(os.homedir(), 'arena', 'atris-business');
+  const rootDir = opts.root || businessWorkspaceBase();
   const jsonMode = opts.json === true;
 
   if (!fs.existsSync(rootDir)) {
@@ -2609,7 +2613,7 @@ function parseBusinessDoctorOptions(args = []) {
   const options = {
     fix: args.includes('--fix'),
     json: args.includes('--json'),
-    root: path.join(os.homedir(), 'arena', 'atris-business'),
+    root: businessWorkspaceBase(),
   };
   const rootIdx = args.indexOf('--root');
   if (rootIdx !== -1 && args[rootIdx + 1]) {
@@ -2623,7 +2627,7 @@ function printBusinessDoctorHelp() {
   console.log('');
   console.log('Checks cloud-active businesses against:');
   console.log('  - ~/.atris/businesses.json');
-  console.log('  - ~/arena/atris-business/*/.atris/business.json');
+  console.log(`  - ${businessWorkspaceBase()}/*/.atris/business.json`);
   console.log('  - canonical slug + alias bindings');
   console.log('');
   console.log('--fix rewrites only safe local cache entries. It does not rename folders or touch cloud data.');
@@ -3454,7 +3458,7 @@ async function quickstart() {
      atris business init "My Company" --template saas
 
   2. Open the local workspace:
-     cd ~/arena/atris-business/my-company
+     cd ${businessWorkspaceBase()}/my-company
 
   3. See what Atris knows:
      atris
@@ -3675,6 +3679,7 @@ async function businessCommand(subcommand, ...args) {
 
 module.exports = {
   businessCommand,
+  businessWorkspaceBase,
   loadBusinesses,
   saveBusinesses,
   businessMatchesSlug,

package/commands/close.js

@@ -5,6 +5,7 @@ const { spawnSync } = require('child_process');
 const { knownCommands } = require('../lib/known-commands');
 const { readUsage, usagePath } = require('../lib/usage');
 const pulse = require('../lib/pulse');
+const { isOwner } = require('../utils/owner-identity');
 const { parseLessons } = require('./autopilot');
 
 const DAY_MS = 24 * 60 * 60 * 1000;
@@ -240,7 +241,7 @@ function parkedFlags(cwd = process.cwd(), options = {}) {
 }
 
 function ownerWaitRank(flag) {
-  return /^(you|me|operator|human|keshav)$/.test(String(flag.owner || '').toLowerCase()) ? 0 : 1;
+  return isOwner(flag.owner) ? 0 : 1;
 }
 
 function compareOpenFlags(a, b) {

package/commands/computer.js

@@ -23,8 +23,9 @@ const path = require('path');
 const readline = require('readline');
 const { spawnSync } = require('child_process');
 const { loadCredentials, decodeJwtClaims, promptUser, abortOnAuthFailure } = require('../utils/auth');
+const { resolveBackendRoot } = require('../utils/backend-root');
 const { apiRequestJson, getApiBaseUrl, getAppBaseUrl } = require('../utils/api');
-const { loadBusinesses, saveBusinesses } = require('./business');
+const { businessWorkspaceBase, loadBusinesses, saveBusinesses } = require('./business');
 const {
   engineLoginSeatError,
   formatEngineSeats,
@@ -37,6 +38,7 @@ const {
 const { consoleCommand, gatherAtrisContext, buildSystemPrompt } = require('./console');
 const { streamSession } = require('./serve');
 const { buildRemoteAtrisBootstrapCommand } = require('../lib/runtime-bootstrap');
+const { envForcesNonInteractive } = require('../lib/noninteractive');
 
 function getToken() {
   const creds = loadCredentials();
@@ -270,11 +272,11 @@ const ui = {
 };
 
 function useInteractiveCloudUi() {
-  return Boolean(process.stdin.isTTY && process.stdout.isTTY && !process.env.ATRIS_NO_INTERACTIVE);
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY && !envForcesNonInteractive());
 }
 
 function useInteractiveTerminalUi() {
-  return Boolean(process.stdin.isTTY && process.stdout.isTTY && !process.env.ATRIS_NO_INTERACTIVE);
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY && !envForcesNonInteractive());
 }
 
 async function readPipedStdin() {
@@ -517,7 +519,7 @@ function displayHomeRelativePath(targetPath) {
 }
 
 function recruitingBusinessWorkspacePath(slug = RECRUITING_BUSINESS_SLUG) {
-  const root = process.env.ATRIS_BUSINESS_ROOT || path.join(os.homedir(), 'arena', 'atris-business');
+  const root = businessWorkspaceBase();
   return path.join(root, slug);
 }
 
@@ -1371,11 +1373,12 @@ function printModeBanner(mode, root, lines = []) {
 
 function findAtrisCodeTerminal() {
   const envPath = process.env.ATRIS_CODE_PY;
+  const backend = resolveBackendRoot();
   const candidates = [
     envPath,
     path.join(__dirname, '..', 'cli', 'atris_code.py'),
     path.join(process.cwd(), 'cli', 'atris_code.py'),
-    path.join(os.homedir(), 'arena', 'atrisos-backend', 'cli', 'atris_code.py'),
+    ...(backend ? [path.join(backend, 'cli', 'atris_code.py')] : []),
   ].filter(Boolean);
 
   let dir = process.cwd();
@@ -2534,7 +2537,7 @@ async function computerCreate(token, args = [], defaults = {}) {
   console.log(`  atris computer --business ${owner} --workspace ${workspaceId}`);
   console.log('');
   console.log('Org workspace:');
-  console.log(`  cd ~/arena/atris-business/${owner}`);
+  console.log(`  cd ${businessWorkspaceBase()}/${owner}`);
   console.log('  atris member activate operator');
   console.log('  atris member activate validator');
   console.log('');
@@ -3500,7 +3503,7 @@ async function sendBusinessChat(token, ctx, message, sessionId, resetContext = f
 async function computerChat(token, ctx, initialOptions = {}) {
   if (!ctx) {
     console.error('Cloud computer mode requires a bound business workspace.');
-    console.error('Run this inside ~/arena/atris-business/<slug>/, or use `atris computer --local` for local mode.');
+    console.error('run this inside a bound business workspace, or use `atris computer --local` for local mode.');
     return;
   }
 
@@ -3741,7 +3744,7 @@ async function computerChat(token, ctx, initialOptions = {}) {
 async function computerLocalAtris(token, ctx, initialOptions = {}) {
   if (!ctx) {
     console.error('Atris local mode needs a bound business workspace for the cloud brain.');
-    console.error('Run inside ~/arena/atris-business/<slug>/, or use `atris computer local-byo`.');
+    console.error('run inside a bound business workspace, or use `atris computer local-byo`.');
     return;
   }
 
@@ -3976,7 +3979,7 @@ async function computerLocalAtris(token, ctx, initialOptions = {}) {
 async function computerProof(token, ctx, initialOptions = {}) {
   if (!ctx) {
     console.error('Atris computer proof needs a bound business workspace.');
-    console.error('Run inside ~/arena/atris-business/<slug>/ first.');
+    console.error('run inside a bound business workspace first.');
     process.exitCode = 1;
     return;
   }
@@ -4290,7 +4293,7 @@ async function runComputer(argv = process.argv.slice(3), deps = {}) {
     console.log('A business can be a company, lab, collective, community, artist, team, or project.');
     console.log('');
     console.log('First use:');
-    console.log('  cd ~/arena/atris-business/<business>');
+    console.log(`  cd ${businessWorkspaceBase()}/<business>`);
     console.log('  atris computer');
     console.log('  Choose Cloud workspace or Local folder, then type the outcome in plain English.');
     console.log('');
@@ -4470,6 +4473,8 @@ module.exports = {
   extractAttachedWorkspaceMismatch,
   contextForAttachedWorkspaceMismatch,
   printRecruitingLocalSyncOutcome,
+  useInteractiveCloudUi,
+  useInteractiveTerminalUi,
   // Hermetic parsing/formatting layer, exported for test/computer.test.js.
   parseComputerOptions,
   parseComputerCreateArgs,

package/commands/context-sync.js

@@ -64,7 +64,7 @@ async function businessStatus(slug) {
   const timeSince = manifest ? _timeSince(manifest.last_sync) : null;
 
   console.log('');
-  console.log(`${biz.name}` + (timeSince ? ` \u2014 last synced ${timeSince}` : ' \u2014 never synced'));
+  console.log(`${biz.name}` + (timeSince ? `: last synced ${timeSince}` : ': never synced'));
 
   // Determine local directory
   let localDir = null;
@@ -254,11 +254,11 @@ async function businessLog(slug) {
 
   const commits = result.data.commits || [];
   if (commits.length === 0) {
-    console.log(`\n  ${biz.name} \u2014 no history yet.\n`);
+    console.log(`\n  ${biz.name}: no history yet.\n`);
     return;
   }
 
-  console.log(`\n  ${biz.name} \u2014 history\n`);
+  console.log(`\n  ${biz.name}: history\n`);
 
   for (const commit of commits) {
     const date = _timeSince(commit.date) || commit.date;

package/commands/doc-health.js

@@ -4,6 +4,7 @@ const fs = require('fs');
 const path = require('path');
 const { resolveWorkspaceRoot } = require('../lib/mission-root');
 const { readText } = require('./brain');
+const { checkMapRefs, fixMapRefs } = require('../lib/map-refs');
 
 const BOOT_FILES = [
   'CLAUDE.md', 'AGENTS.md', 'atris/atris.md', 'atris/MAP.md',
@@ -74,9 +75,17 @@ function collectMap(root, text, featureNames, memberNames) {
   }
   const files = [...paths].map(file => ({ path: file, exists: fs.existsSync(path.resolve(root, file)) }));
   const existing = files.filter(file => file.exists).length;
+  const pathScore = files.length ? existing / files.length : 0;
+  const { refs: all, ...refs } = checkMapRefs(root, text);
+  refs.flagged = all.filter(ref => ref.status !== 'ok').map(ref => ({
+    map_line: ref.map_line, ref: ref.raw, symbol: ref.symbol, status: ref.status,
+    ...(ref.line ? { line: ref.line } : {}), ...(ref.lines ? { lines: ref.lines } : {}),
+    ...(ref.reason ? { reason: ref.reason } : {}),
+  }));
   return {
     rows, paths: files.length, existing, files,
-    score: files.length ? existing / files.length : 0,
+    // A path that exists but a line ref that points at the wrong code is still a wrong map.
+    path_score: pathScore, refs, score: pathScore * refs.score,
     features: folderCoverage(text, 'atris/features', featureNames),
     members: folderCoverage(text, 'atris/team', memberNames),
   };
@@ -272,6 +281,34 @@ function table(headers, rows) {
   return cells.map(row => row.map((cell, i) => cell.padEnd(widths[i])).join('  ').trimEnd());
 }
 
+function refsLine(refs) {
+  const gone = refs.missing + refs.missing_file;
+  return `map refs: ${refs.ok} right, ${refs.moved} moved, ${refs.ambiguous} unclear, ${gone} gone`;
+}
+
+function describeLeft(ref) {
+  const where = `MAP line ${ref.map_line}: ${ref.raw}${ref.symbol ? ` (${ref.symbol})` : ''}`;
+  if (ref.status === 'ambiguous') return `${where} found on lines ${ref.lines.join(', ')}`;
+  if (ref.status === 'missing-file') return `${where} file is gone`;
+  return `${where} ${ref.reason}`;
+}
+
+function fixRefsCommand(root, asJson) {
+  const { changes, left } = fixMapRefs(root);
+  if (asJson) {
+    console.log(JSON.stringify({ ok: true, action: 'doc-health fix-refs', changes, left }, null, 2));
+    return 0;
+  }
+  const lines = [changes.length ? `map refs: moved ${changes.length}` : 'map refs: nothing to move.'];
+  for (const change of changes) lines.push(`  MAP line ${change.map_line}: ${change.from} -> ${change.to} (${change.symbol})`);
+  if (left.length) {
+    lines.push(`left for a human: ${left.length}`);
+    for (const ref of left) lines.push(`  ${describeLeft(ref)}`);
+  }
+  console.log(lines.join('\n'));
+  return 0;
+}
+
 function renderDocHealth(payload) {
   if (!payload.ok) return payload.message;
   const { boot_load: boot, map_coverage: map, lookup_hops: lookup, staleness, overall } = payload;
@@ -286,6 +323,8 @@ function renderDocHealth(payload) {
       ['routing rows', map.rows, map.rows], ['existing paths', map.existing, map.paths],
       ['features mentioned', map.features.mentioned, map.features.total], ['members mentioned', map.members.mentioned, map.members.total],
     ]),
+    refsLine(map.refs),
+    ...(map.refs.moved ? ['run atris doc-health --fix-refs to update the moved ones.'] : []),
     '', 'lookup hops',
   ];
   if (lookup.missing) {
@@ -315,9 +354,18 @@ function renderDocHealth(payload) {
 
 function docHealthCommand(args = [], options = {}) {
   if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
-    console.log('usage: atris doc-health [--json] [--questions <path>]');
+    console.log('usage: atris doc-health [--json] [--questions <path>] [--fix-refs]');
+    console.log('  --fix-refs  rewrite map line refs whose code moved; list the ones a human must fix');
     return 0;
   }
+  if (args.includes('--fix-refs')) {
+    const root = resolveWorkspaceRoot(options.cwd || process.cwd());
+    if (!stat(path.join(root, 'atris', 'MAP.md'))?.isFile()) {
+      console.log('no atris/MAP.md in this workspace.');
+      return 1;
+    }
+    return fixRefsCommand(root, args.includes('--json'));
+  }
   const index = args.indexOf('--questions');
   const questions = index >= 0 && args[index + 1] && !args[index + 1].startsWith('--') ? args[index + 1]
     : args.find(arg => arg.startsWith('--questions='))?.slice('--questions='.length);

package/commands/experiments.js

@@ -1,6 +1,7 @@
 const fs = require('fs');
 const path = require('path');
 const { spawnSync } = require('child_process');
+const { BACKEND_ROOT_HINT, resolveBackendRoot } = require('../utils/backend-root');
 const { runTaskOnce } = require('./autopilot');
 const {
   appendResultsRow,
@@ -391,7 +392,7 @@ function parseRunOptions(args) {
   const options = {
     dryRun: false,
     verbose: false,
-    backendPath: path.resolve(process.cwd(), '../atrisos-backend'),
+    backendPath: null,
     interventions: [],
   };
 
@@ -527,8 +528,10 @@ function buildBenchmarkArtifact(name, packDir, options) {
             'atris/features/endstate/contract.md',
             'atris/features/endstate/artifact-schema.json',
             path.relative(cwd, path.join(packDir, 'program.md')),
-            '../atrisos-backend/atris/MAP.md',
-            '../atrisos-backend/atris/TODO.md',
+            ...(backendPath ? [
+              path.relative(cwd, path.join(backendPath, 'atris', 'MAP.md')),
+              path.relative(cwd, path.join(backendPath, 'atris', 'TODO.md')),
+            ] : []),
           ],
           contextNote: [
             `Project Endstate track: ${track}`,
@@ -555,7 +558,7 @@ function buildBenchmarkArtifact(name, packDir, options) {
     ? []
     : [
         ...collectChangedFiles(cwd, beforeCli, afterCli),
-        ...collectChangedFiles(backendPath, beforeBackend, afterBackend, '../atrisos-backend/'),
+        ...(backendPath ? collectChangedFiles(backendPath, beforeBackend, afterBackend, `${path.relative(cwd, backendPath)}/`) : []),
       ];
   const wikiAfter = readTextIfExists(path.join(cwd, 'atris', 'wiki', 'STATUS.md'));
 
@@ -637,6 +640,12 @@ function experimentsRun(name, ...args) {
     return;
   }
 
+  if (!options.backendPath) options.backendPath = resolveBackendRoot();
+  if (!options.backendPath) {
+    console.error(BACKEND_ROOT_HINT);
+    process.exit(1);
+  }
+
   const schemaPath = path.join(process.cwd(), 'atris', 'features', 'endstate', 'artifact-schema.json');
   const contractPath = path.join(process.cwd(), 'atris', 'features', 'endstate', 'contract.md');
   if (!fs.existsSync(schemaPath) || !fs.existsSync(contractPath)) {

package/commands/improve.js

@@ -37,7 +37,7 @@ const rsi = require('../lib/rsi-record');
  * writes. The path sent to the backend is left untouched, a remote tick
  * may target a server-side `~/...` workspace the server expands itself, but
  * local scorecard/journal writes must never create a literal `~` directory.
- * (Surfaced by a live plan tick whose `~/arena/...` arg wrote junk locally.)
+ * (Surfaced by a live plan tick whose home-relative path wrote junk locally.)
  */
 function expandHome(p) {
   if (typeof p === 'string' && (p === '~' || p.startsWith('~/'))) {

package/commands/integrations.js

@@ -35,6 +35,7 @@ const os = require('os');
 const path = require('path');
 const readline = require('readline');
 const { spawnSync } = require('child_process');
+const { sleepSync } = require('../lib/sleep-sync');
 
 const CALENDAR_CACHE_PATH = path.join(os.homedir(), '.atris', 'calendar-events-cache.json');
 const GMAIL_CONNECT_POLL_MS = 3000;
@@ -1812,10 +1813,6 @@ function writeImessageLookupCache(cache) {
   return cachePath;
 }
 
-function sleepMs(ms) {
-  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-}
-
 function readLatestOutgoingImessage(handle, sinceMs) {
   const chatDb = path.join(os.homedir(), 'Library', 'Messages', 'chat.db');
   const sinceUnix = Math.max(0, Math.floor(Number(sinceMs || Date.now()) / 1000) - 5);
@@ -1873,7 +1870,7 @@ function imessageVerifyLatestOutgoing(handle, sinceMs, options = {}) {
     && !(latest.is_sent || latest.is_delivered || latest.is_finished)
     && Date.now() - startedAt < timeoutMs
   ) {
-    sleepMs(intervalMs);
+    sleepSync(intervalMs);
     latest = readLatestOutgoingImessage(handle, sinceMs);
   }
   return {

package/commands/learn.js

@@ -460,7 +460,7 @@ function harvestFromJournals(deps = {}) {
       const lines = notesMatch[1].trim().split('\n').filter(l => l.startsWith('- '));
       for (const line of lines) {
         // Strip bullet and optional timestamp prefix
-        const insight = line.replace(/^- (\d{2}:\d{2} \u2014 )?/, '').trim();
+        const insight = line.replace(/^- (\d{2}:\d{2} [-\u2014] )?/, '').trim();
         if (leftoverClaimableInsight(insight)) continue;
         if (insight.length > 10) {
           candidates.push({ insight, source: path.basename(logPath) });