atris 3.58.7 → 3.59.0

package/commands/member.js

@@ -4,10 +4,12 @@ const crypto = require('crypto');
 const os = require('os');
 const { execFileSync, spawnSync } = require('child_process');
 const { loadCredentials } = require('../utils/auth');
+const { resolveBackendRoot } = require('../utils/backend-root');
 const { apiRequestJson } = require('../utils/api');
 const { runAliveTick } = require('../lib/member-alive');
 const { defaultObjectiveRunner } = require('../lib/default-runner');
 const { readJson, writeJson } = require('../lib/json-file');
+const { sleepSync } = require('../lib/sleep-sync');
 const { hasFlag, readFlag, readNumberFlag } = require('../lib/arg-parser');
 const { ensureMemberBundle, memberBundlePresent } = require('../lib/member-scaffold');
 const { memberProcessPrompt, MEMBER_PROCESS_PATH } = require('../lib/member-context');
@@ -686,6 +688,15 @@ const MEMBER_RUN_START_VALUE_FLAGS = [
   '--mission-id',
   '--owner',
   '--runner',
+  '--engine',
+  '--budget',
+  '--repo',
+  '--native-goal-status',
+  '--native-goal-objective',
+  '--visible-goal-status',
+  '--visible-goal-objective',
+  '--max-idle-ticks',
+  '--slots',
   '--lane',
   '--cadence',
   '--verify',
@@ -717,10 +728,49 @@ const MEMBER_RUN_START_BOOLEAN_FLAGS = [
   '--stop-when-done',
   '--choose-work',
   '--auto',
+  '--headless',
+  '--self-drive',
+  '--no-claude',
+  '--complete-on-pass',
+  '--no-drain',
+  '--create-next',
+  '--preflight',
+  '--no-preflight',
+  '--room-preflight',
+  '--no-room-preflight',
+  '--room-auto-run',
+  '--no-room-auto-run',
+  '--manual-ack',
+  '--allow-native-goal-supersede',
+  '--supersede-paused-native-goal',
+  '--take-goal-slot',
+  '--due',
+  '--detach',
+  '--fleet',
+  '--dry-run',
+  '--land',
+  '--cloud',
 ];
 
+function memberRunMissionWordIndices(args = []) {
+  const values = new Set(MEMBER_RUN_START_VALUE_FLAGS);
+  const booleans = new Set(['--full', '--verbose', ...MEMBER_RUN_START_BOOLEAN_FLAGS]);
+  const indices = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = String(args[i]);
+    const key = arg.includes('=') ? arg.slice(0, arg.indexOf('=')) : arg;
+    if (booleans.has(key)) continue;
+    if (values.has(key)) {
+      if (!arg.includes('=') && args[i + 1] && !String(args[i + 1]).startsWith('--')) i += 1;
+      continue;
+    }
+    indices.push(i);
+  }
+  return indices;
+}
+
 function memberRunMissionText(args = []) {
-  return stripKnownFlags(args, MEMBER_RUN_START_VALUE_FLAGS, MEMBER_RUN_START_BOOLEAN_FLAGS).join(' ').trim();
+  return memberRunMissionWordIndices(args).map((index) => args[index]).join(' ').trim();
 }
 
 function cleanMemberRunPhrase(value) {
@@ -811,6 +861,22 @@ function pushFlagWhenPresent(out, args, name) {
   if (hasFlag(args, name)) out.push(name);
 }
 
+// The runner a new member mission starts with. An explicit --runner or
+// --engine wins. With neither, a member the roster names runs on "auto", so
+// every tick picks the member's engine from ROSTER.md (edits apply on the next
+// tick). Otherwise the old default holds.
+function memberRunRunner(owner, args = [], cwd = process.cwd()) {
+  const explicit = readFlag(args, '--runner', '');
+  if (explicit) return explicit;
+  // codex_goal stalls unattended (no live codex session drives its native goal
+  // slot). Default to claude unless a live codex session is signalled; explicit
+  // --runner still wins. Proven footgun 2026-07-16. See lib/default-runner.js.
+  const fallback = defaultObjectiveRunner(args);
+  if (fallback !== 'claude' || readFlag(args, '--engine', '')) return fallback;
+  const { memberRosterEngine } = require('../lib/member-engine');
+  return memberRosterEngine(owner, cwd) ? 'auto' : fallback;
+}
+
 function buildMemberRunStartArgs(owner, missionText, args = [], cwd = process.cwd()) {
   const startArgs = [
     'mission',
@@ -818,11 +884,8 @@ function buildMemberRunStartArgs(owner, missionText, args = [], cwd = process.cw
     missionText,
     '--owner',
     owner,
-    // codex_goal stalls unattended (no live codex session drives its native goal
-    // slot). Default to claude unless a live codex session is signalled; explicit
-    // --runner still wins. Proven footgun 2026-07-16. See lib/default-runner.js.
     '--runner',
-    readFlag(args, '--runner', defaultObjectiveRunner(args)),
+    memberRunRunner(owner, args, cwd),
     '--lane',
     readFlag(args, '--lane', 'workspace'),
   ];
@@ -834,10 +897,8 @@ function buildMemberRunStartArgs(owner, missionText, args = [], cwd = process.cw
   pushFlagValue(startArgs, args, '--minutes');
   pushFlagValue(startArgs, args, '--hours');
   pushFlagValue(startArgs, args, '--base');
-  // A member-run mission is driven immediately by its runner, not parked on
-  // the queue, so the mission-start verifier gate (built for parked planning
-  // wishes) would only kill autonomous legs like autopilot's "member chooses
-  // useful work". When the caller named no verifier, opt out explicitly.
+  // Member runs choose and drive work immediately, so an absent check must not
+  // leave autonomous callers with a mission that never ran.
   if (hasFlag(args, '--no-verify') || !readFlag(args, '--verify', '')) {
     startArgs.push('--no-verify');
   }
@@ -853,7 +914,7 @@ function buildMemberRunStartArgs(owner, missionText, args = [], cwd = process.cw
   if (!hasFlag(args, '--shared-checkout') && !hasFlag(args, '--no-worktree') && insideGitRepo(cwd)) {
     startArgs.push('--worktree');
   }
-  if (hasFlag(args, '--json')) startArgs.push('--json');
+  startArgs.push('--json');
   return startArgs;
 }
 
@@ -871,15 +932,52 @@ function startMemberRunMission(name, missionText, args = []) {
   const paths = requireMemberDir(name);
   const owner = paths.storageName || name;
   const startArgs = buildMemberRunStartArgs(owner, missionText, args);
+  return memberRunCli(startArgs, process.cwd());
+}
 
+function memberRunCli(args, cwd, { live = false, missionId = '' } = {}) {
   const cliPath = path.join(__dirname, '..', 'bin', 'atris.js');
+  const runsDir = path.join(cwd, 'atris', 'runs');
+  const previousReceipts = live && fs.existsSync(runsDir) ? new Set(fs.readdirSync(runsDir)) : new Set();
+  const result = spawnSync(process.execPath, [cliPath, ...args], {
+    cwd,
+    encoding: 'utf8',
+    maxBuffer: 64 * 1024 * 1024,
+    stdio: live ? 'inherit' : ['ignore', 'pipe', 'pipe'],
+  });
+  if (result.error) throw result.error;
+  if (live) {
+    const receiptName = fs.existsSync(runsDir)
+      ? fs.readdirSync(runsDir).filter((name) => !previousReceipts.has(name) && name.startsWith(`mission-${missionId}-`) && name.endsWith('.json')).sort().at(-1)
+      : null;
+    const receipt = receiptName ? readJson(path.join(runsDir, receiptName), null) : null;
+    return { status: result.status, payload: receipt?.result?.kind === 'mission_run_summary'
+      ? { ran_ticks: receipt.result.ran_ticks } : null, stderr: '', errorReported: result.status !== 0 };
+  }
+  let payload = null;
   try {
-    execFileSync(process.execPath, [cliPath, ...startArgs], {
-      cwd: process.cwd(),
-      stdio: 'inherit',
-    });
+    payload = JSON.parse(result.stdout);
   } catch (error) {
-    process.exitCode = Number(error?.status) || 1;
+    if (result.status === 0) throw new Error(`member run: mission command returned invalid json: ${error.message}`);
+  }
+  return { status: result.status, payload, stderr: String(result.stderr || '').trim() };
+}
+
+function memberRunConfiguredVerifier(paths) {
+  const frontmatter = parseFrontmatter(fs.readFileSync(paths.memberFile, 'utf8')) || {};
+  const check = frontmatter.verify || frontmatter.verifier;
+  return typeof check === 'string' ? check.trim() : '';
+}
+
+function printMemberRunResult(result, asJson) {
+  if (asJson) {
+    console.log(JSON.stringify(result));
+  } else if (result.started) {
+    console.log(`started ${result.mission_id} (${result.state})`);
+  }
+  if (result.ok === false || (!result.started && result.ok !== true)) {
+    if (!result.errorReported) console.error(result.error);
+    process.exitCode = 1;
   }
 }
 
@@ -967,48 +1065,96 @@ function memberPing(name, ...args) {
 
 function memberRun(name, ...args) {
   if (!name || name === '--help' || name === '-h' || hasFlag(args, '--help') || hasFlag(args, '-h')) {
-    console.log('Usage: atris member run <name> ["mission text"] [--minutes N|--hours N] [--json]');
-    console.log('New mission: atris member run growth "Improve onboarding proof" --minutes 30 --json');
-    console.log('Choose work: atris member run growth --industry logistics --value "reduce support time" --minutes 30 --json');
-    console.log('Existing mission: atris member run growth --mission <mission-id> --max-ticks 1 --json');
-    console.log('Meaning: if mission text is omitted, the member chooses one useful bounded task from Atris state.');
-    console.log('Truth: useful work must improve revenue, reliability, speed, security, clarity, or trust, then show plain proof.');
-    console.log('Isolation: new missions use --worktree by default; add --shared-checkout to stay here.');
+    console.log('usage: atris member run <name> ["mission text"] [--verify "<cmd>"] [--minutes N|--hours N] [--json]');
+    console.log('new mission: atris member run growth "improve onboarding proof" --verify "npm test" --minutes 30 --json');
+    console.log('choose work: atris member run growth --verify "npm test" --industry logistics --minutes 30 --json');
+    console.log('existing mission: atris member run growth --mission <mission-id> --max-ticks 1 --json');
+    console.log('meaning: if mission text is omitted, the member chooses one useful bounded task from atris state.');
+    console.log('truth: useful work must improve revenue, reliability, speed, security, clarity, or trust, then show plain proof.');
+    console.log('isolation: new missions use --worktree by default; add --shared-checkout to stay here.');
+    console.log('check: --verify or a verify field in the member file adds a mission check.');
     return;
   }
 
+  const asJson = hasFlag(args, '--json');
+  const paths = requireMemberDir(name);
+  const requestedVerifier = readFlag(args, '--verify', '') || memberRunConfiguredVerifier(paths);
   const missionText = memberRunMissionText(args);
   const hasMissionOverride = Boolean(readFlag(args, '--mission', '') || readFlag(args, '--mission-id', ''));
+  let mission = null;
+  let startedNewMission = false;
+  let nodeModulesLinked = false;
+  let nodeModulesSource = null;
   if (missionText && !hasMissionOverride) {
-    startMemberRunMission(name, missionText, args);
-    return;
+    const start = startMemberRunMission(name, missionText, requestedVerifier ? [...args, '--verify', requestedVerifier] : args);
+    if (start.status !== 0 || !start.payload?.mission) {
+      printMemberRunResult({ started: false, state: null, mission_id: start.payload?.mission?.id || null,
+        error: start.payload?.detail || start.payload?.error || start.stderr || 'mission creation failed' }, asJson);
+      return;
+    }
+    mission = start.payload.mission;
+    startedNewMission = true;
+    nodeModulesLinked = Boolean(start.payload.node_modules_linked);
+    nodeModulesSource = start.payload.node_modules_source || null;
+  } else {
+    const missionId = resolveMemberRunMissionId(name, args);
+    if (!missionId) {
+      const start = startMemberRunMission(name, memberRunAutoMissionText(name, args), requestedVerifier ? [...args, '--verify', requestedVerifier] : args);
+      if (start.status !== 0 || !start.payload?.mission) {
+        printMemberRunResult({ started: false, state: null, mission_id: start.payload?.mission?.id || null,
+          error: start.payload?.detail || start.payload?.error || start.stderr || 'mission creation failed' }, asJson);
+        return;
+      }
+      mission = start.payload.mission;
+      startedNewMission = true;
+      nodeModulesLinked = Boolean(start.payload.node_modules_linked);
+      nodeModulesSource = start.payload.node_modules_source || null;
+    } else {
+      mission = require('./mission').resolveMission(missionId);
+      if (!mission) {
+        printMemberRunResult({ started: false, state: null, mission_id: missionId, error: `mission ${missionId} was not found` }, asJson);
+        return;
+      }
+    }
   }
 
-  const missionId = resolveMemberRunMissionId(name, args);
-  if (!missionId) {
-    startMemberRunMission(name, memberRunAutoMissionText(name, args), args);
-    return;
+  if (startedNewMission && !asJson) {
+    if (mission.worktree?.path) console.log(`worktree: ${mission.worktree.path}`);
+    if (nodeModulesLinked) console.log(`linked node_modules from ${nodeModulesSource}`);
+  }
+
+  const cwd = mission.worktree?.path || process.cwd();
+  const verifier = readFlag(args, '--verify', '') || mission.verifier || requestedVerifier;
+  if (verifier && verifier !== mission.verifier) {
+    const changed = memberRunCli(['mission', 'set-verifier', mission.id, verifier, '--json'], cwd);
+    if (changed.status !== 0) {
+      printMemberRunResult({ started: false, state: mission.status, mission_id: mission.id, mission,
+        error: changed.payload?.detail || changed.payload?.error || changed.stderr || 'could not set mission check' }, asJson);
+      return;
+    }
+    mission.verifier = verifier;
   }
 
-  const runArgs = stripKnownFlags(args, ['--mission', '--mission-id', '--minutes', '--hours'], ['--worktree', '--shared-checkout', '--no-worktree']);
+  const missionWordIndices = missionText && !hasMissionOverride ? new Set(memberRunMissionWordIndices(args)) : new Set();
+  const executionArgs = args.filter((_, index) => !missionWordIndices.has(index));
+  const runArgs = stripKnownFlags(executionArgs,
+    ['--mission', '--mission-id', '--minutes', '--hours', '--industry', '--domain', '--value', '--outcome', '--truth', '--proof', '--base'],
+    ['--worktree', '--shared-checkout', '--no-worktree', '--choose-work', '--auto']);
   const budgetSeconds = memberRunBudgetSeconds(args);
-  // A timed run is a loop contract, not one tick: keep picking the next useful
-  // move until the wall clock (--max-wall) spends the budget. Only untimed runs
-  // default to a single tick.
   if (!readFlag(runArgs, '--max-ticks', '')) {
     runArgs.push('--max-ticks', budgetSeconds ? String(Math.max(4, Math.ceil(budgetSeconds / 300))) : '1');
   }
   if (!readFlag(runArgs, '--max-wall', '')) runArgs.push('--max-wall', String(budgetSeconds || 900));
-
-  const cliPath = path.join(__dirname, '..', 'bin', 'atris.js');
-  try {
-    execFileSync(process.execPath, [cliPath, 'mission', 'run', missionId, ...runArgs], {
-      cwd: process.cwd(),
-      stdio: 'inherit',
-    });
-  } catch (error) {
-    process.exitCode = Number(error?.status) || 1;
-  }
+  const run = memberRunCli(['mission', 'run', mission.id, ...runArgs], cwd, { live: !asJson, missionId: mission.id });
+  const payload = run.payload || {};
+  const finalMission = payload.mission || require('./mission').resolveMission(mission.id, cwd) || mission;
+  const started = run.status === 0 && payload.ok !== false && Number(payload.ran_ticks) > 0;
+  const noWorkStepExpected = hasFlag(runArgs, '--detach') || hasFlag(runArgs, '--dry-run');
+  const ok = run.status === 0 && payload.ok !== false && (started || noWorkStepExpected);
+  printMemberRunResult({ ...payload, ok, started, state: finalMission.status, mission_id: mission.id,
+    mission: finalMission, node_modules_linked: nodeModulesLinked, node_modules_source: nodeModulesSource,
+    errorReported: run.errorReported,
+    ...(!ok ? { error: payload.detail || payload.error || payload.reason || run.stderr || 'mission did not run a work step' } : {}) }, asJson);
 }
 
 function loadTeamScoreEvidence(scoreJsonPath) {
@@ -1831,8 +1977,8 @@ function problemSignalSources(root = process.cwd()) {
     sources.push(source);
   }
   for (const source of problemSignalFilesForStateDir(path.join(root, '.atris', 'state'))) push(source);
-  const siblingBackend = path.resolve(root, '..', 'atrisos-backend');
-  if (fs.existsSync(siblingBackend)) {
+  const siblingBackend = resolveBackendRoot(root);
+  if (siblingBackend) {
     for (const source of problemSignalFilesForStateDir(path.join(siblingBackend, '.atris', 'state'), 'backend')) push(source);
   }
   for (const source of configuredProblemSignalSources(root)) push(source);
@@ -4170,7 +4316,25 @@ function memberInstall(slug) {
   const memberDir = path.join(process.cwd(), 'atris', 'team', slug);
   const already = memberBundlePresent(memberDir);
   fs.mkdirSync(path.join(memberDir, 'logs'), { recursive: true });
-  if (already) {
+  const templateDir = path.join(__dirname, '..', 'templates', 'members', slug);
+  const copied = [];
+  if (fs.existsSync(templateDir)) {
+    const copyMissing = (source, relative = '') => {
+      for (const entry of fs.readdirSync(source, { withFileTypes: true })) {
+        const rel = path.join(relative, entry.name);
+        const target = path.join(memberDir, rel);
+        if (entry.isDirectory()) {
+          fs.mkdirSync(target, { recursive: true });
+          copyMissing(path.join(source, entry.name), rel);
+        } else if (entry.isFile() && !fs.existsSync(target)) {
+          fs.writeFileSync(target, fs.readFileSync(path.join(source, entry.name)), { flag: 'wx' });
+          copied.push(rel);
+        }
+      }
+    };
+    copyMissing(templateDir);
+  }
+  if (already && copied.length === 0) {
     console.log(`MEMBER already installed for ${slug}`);
     return;
   }
@@ -4179,7 +4343,7 @@ function memberInstall(slug) {
     name: slug,
     source: 'install',
   });
-  for (const rel of created) {
+  for (const rel of [...copied, ...created]) {
     console.log(`atris/team/${slug}/${rel.split(path.sep).join('/')}`);
   }
   console.log(`MEMBER installed for ${slug}.`);
@@ -4594,12 +4758,6 @@ function printJsonOrText(payload, lines, asJson) {
   for (const line of lines) console.log(line);
 }
 
-function sleepSync(ms) {
-  const duration = Math.max(0, Number(ms) || 0);
-  if (duration <= 0) return;
-  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, duration);
-}
-
 function memberGoal(name, ...args) {
   const paths = requireMemberDir(name);
   const asJson = hasFlag(args, '--json');
@@ -7660,6 +7818,24 @@ function wakeDecision(name, paths, { force = false, runtimeKind = memberRuntimeK
   return null;
 }
 
+// The engine this member's work runs on, from the roster: its own team line,
+// else its job's pick, else the router. Never throws.
+function wakeMemberEngine(name, root = process.cwd()) {
+  try {
+    const { resolveEngineForMember } = require('../lib/member-engine');
+    const picked = resolveEngineForMember(name, root);
+    return {
+      id: picked.engine ? picked.engine.id : null,
+      model: picked.model || null,
+      job: picked.job,
+      source: picked.source,
+      reason: picked.reason,
+    };
+  } catch {
+    return null;
+  }
+}
+
 async function runMemberWake(name, { execute = false, confirmed = false, force = false, domainInput = {} } = {}) {
   const paths = requireMemberDir(name);
   const runtimeKind = paths.runtimeKind || memberRuntimeKind(name);
@@ -7824,6 +8000,7 @@ async function runMemberWake(name, { execute = false, confirmed = false, force =
     ok: true,
     action: 'wake',
     member: name,
+    engine: wakeMemberEngine(name),
     mode,
     decision,
     reason,
@@ -7946,6 +8123,7 @@ function wakeBootLines(name, result) {
     `  goal      ${goal ? clipText(goal, 70) : s.dim('none yet')}`,
     ...(experiment ? [`  working   ${clipText(experiment, 70)}`] : []),
     ...(laneCandidates !== null ? [`  lane      ${laneCandidates} task${laneCandidates === 1 ? '' : 's'} waiting in ${name}'s lane`] : []),
+    ...(result.engine && result.engine.id ? [`  engine    ${clipText(String(result.engine.reason || '').replace(`${name} does `, ''), 70)}`] : []),
     '',
     `  ${s.bold(name)} looked around and ${s.bold(decisionText)}.`,
     `  ${s.dim(`Why: ${wakeReasonText(result.reason)}.`)}`,
@@ -9261,7 +9439,7 @@ async function memberCommand(subcommand, ...args) {
       console.log('  atris member goal-from-mission growth --json');
       console.log('  atris member goal-from-score growth --score-json team-score.json --json');
       console.log('  atris member wake growth --json');
-      console.log('  atris member run growth "Improve onboarding proof" --minutes 30 --json');
+      console.log('  atris member run growth "improve onboarding proof" --verify "npm test" --minutes 30 --json');
       console.log('  atris member run growth --mission <mission-id> --max-ticks 1 --json');
       console.log('  atris member wake growth --execute --confirm-autonomy-policy');
       console.log('  atris member supervisor recommendations --json');