atris 3.58.7 → 3.59.0

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/clean.js

@@ -358,9 +358,26 @@ function findStaleTasks(atrisDir) {
  * Detects both out-of-bounds AND drift (symbol moved to different line)
  * Returns { healed: number, unhealable: array }
  */
+// The boot map routes; atris/refs/MAP-NOTES.md holds the deep file:line refs.
+// Heal both. Entries from the notes file carry `map` so reports can say where.
+const MAP_NOTES_FILE = path.join('refs', 'MAP-NOTES.md');
+
 function healBrokenMapRefs(cwd, atrisDir, dryRun = false, homeDir = os.homedir()) {
   const mapFile = path.join(atrisDir, 'MAP.md');
   if (!fs.existsSync(mapFile)) return { healed: 0, unhealable: [] };
+  const result = healMapFileRefs(cwd, mapFile, dryRun, homeDir);
+  const notesFile = path.join(atrisDir, MAP_NOTES_FILE);
+  if (!fs.existsSync(notesFile)) return result;
+  const notes = healMapFileRefs(cwd, notesFile, dryRun, homeDir);
+  const map = path.relative(cwd, notesFile).split(path.sep).join('/');
+  return {
+    healed: result.healed + notes.healed,
+    unhealable: [...result.unhealable, ...notes.unhealable.map((entry) => ({ ...entry, map }))],
+    replacements: [...result.replacements, ...notes.replacements.map((entry) => ({ ...entry, map }))],
+  };
+}
+
+function healMapFileRefs(cwd, mapFile, dryRun, homeDir) {
 
   let mapContent = fs.readFileSync(mapFile, 'utf8');
   const unhealable = [];

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 { checkMapDocs, fixMapDocs } = require('../lib/map-refs');
 
 const BOOT_FILES = [
   'CLAUDE.md', 'AGENTS.md', 'atris/atris.md', 'atris/MAP.md',
@@ -74,9 +75,18 @@ 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;
+  // Line refs are checked in the boot map and in the notes file it points to.
+  const { refs: all, ...refs } = checkMapDocs(root, text);
+  refs.flagged = all.filter(ref => ref.status !== 'ok').map(ref => ({
+    doc: ref.doc, 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 +282,38 @@ 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 docLine(ref) {
+  return `${ref.doc === 'atris/MAP.md' ? 'MAP' : ref.doc} line ${ref.map_line}`;
+}
+
+function describeLeft(ref) {
+  const where = `${docLine(ref)}: ${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 } = fixMapDocs(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(`  ${docLine(change)}: ${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 +328,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 +359,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);