atris 3.62.0 → 3.64.0

package/commands/buy.js

@@ -0,0 +1,242 @@
+'use strict';
+
+// atris buy: quote a purchase or trade, start the person's approval, check status.
+//
+//   atris buy quote --kind ticket --event-url <vividseats url> --quantity 2
+//   atris buy approve ord_<id> --pick 1 --delivery-email sam@example.com
+//   atris buy status ord_<id>
+//
+// Nothing is ever charged by this command. Approve only starts the human step:
+// a tap in their Link app, a payment page, or a reply to the confirm code Atris
+// texts to their own phone. The code never comes back to this command.
+
+const { apiRequestJson } = require('../utils/api');
+const { loadCredentials } = require('../utils/auth');
+const { NOT_LOGGED_IN, oneLine, printResult } = require('../lib/developer-api');
+const { parseFlags, formatCents, untilText, errorFrom, commerceToken } = require('../lib/commerce');
+
+const KINDS = ['ticket', 'shop', 'trade', 'flight'];
+const NOTHING_CHARGED = 'Nothing is charged until the person approves it themselves.';
+const CONTROL_FLAGS = new Set(['json', 'help', 'intent', 'details']);
+const TRADE_CONFIRM = 'We texted you a confirm code. Reply to that text to place the trade.';
+
+function showBuyHelp(log = console.log) {
+  log(`usage: atris buy <quote|approve|status> [flags] [--json]
+
+get a real quote, then hand the person the approval step. nothing is charged
+until the person approves it themselves (Link app, payment page, or a text
+from their own phone).
+
+  atris buy quote --kind ticket|shop|trade|flight [fields] [--intent '<json>']
+  atris buy approve <id> [fields] [--details '<json>']
+  atris buy status <id>
+
+quote fields (flags, kebab-case is fine):
+  ticket  --event-url <vividseats.com url> --quantity N [--min-each-usd N] [--max-each-usd N]
+  shop    --query "<item>" | --url <product url>  [--quantity N]
+  trade   --side buy|sell --symbol VTI (--quantity N | --dollars N) [--order-type market|limit --limit-price N]
+  flight  not wired yet, quotes are refused
+
+approve fields:
+  ticket  --pick 1 --delivery-email you@example.com
+  shop    --delivery-email you@example.com [--options '<json>'] [--address '<json>'] [--accept-extras]
+  trade   none. Atris texts the person a confirm code; they reply to that text.
+
+examples:
+  atris buy quote --kind trade --side buy --symbol VTI --dollars 25
+  atris buy quote --intent '{"kind":"shop","query":"uniqlo supima crew tee navy"}'
+  atris buy approve ord_1234 --pick 1 --delivery-email sam@example.com
+  atris buy status ord_1234 --json`);
+}
+
+function fieldsFrom(flags) {
+  const out = {};
+  for (const [key, value] of Object.entries(flags)) {
+    if (!CONTROL_FLAGS.has(key)) out[key] = value;
+  }
+  return out;
+}
+
+function jsonFlag(flags, name) {
+  if (flags[name] == null) return { ok: true, value: {} };
+  const value = flags[name];
+  if (value && typeof value === 'object' && !Array.isArray(value)) return { ok: true, value };
+  return { ok: false, error: `--${name} must be a JSON object, like --${name} '{"kind":"shop","query":"navy tee"}'` };
+}
+
+function approvalLines(approval) {
+  if (!approval || typeof approval !== 'object') return [];
+  const lines = [];
+  // The backend sends trade confirm codes only to the person's own texts.
+  if (approval.how === 'text_confirm') return [TRADE_CONFIRM];
+  if (approval.url) {
+    const label = approval.how === 'connect_link' ? 'Connect Link first'
+      : approval.how === 'payment_page' ? 'Pay on this page'
+        : 'Approve in Link';
+    lines.push(`${label}: ${approval.url}`);
+  }
+  if (approval.text) lines.push(approval.text);
+  return lines;
+}
+
+function moneyLines(data) {
+  const lines = [];
+  if (data.total_cents != null) lines.push(`Total: ${formatCents(data.total_cents, data.currency)}`);
+  if (data.fee_cents != null) lines.push(`Atris fee: ${formatCents(data.fee_cents, data.currency)}`);
+  return lines;
+}
+
+function renderQuote(data = {}, now = Date.now()) {
+  const lines = [];
+  if (data.status !== 'quoted') return renderOutcome(data, now);
+  lines.push(data.summary || 'Quote ready.');
+  lines.push('');
+  lines.push(...moneyLines(data));
+  if (data.expires_at) lines.push(`Expires: ${data.expires_at} (${untilText(data.expires_at, now)})`);
+  if (data.id) lines.push(`Quote id: ${data.id}`);
+  if (data.product_url) lines.push(`Product: ${data.product_url}`);
+  const choices = data.options && typeof data.options === 'object' && !Array.isArray(data.options)
+    ? Object.entries(data.options) : [];
+  if (choices.length) {
+    lines.push('Choices:');
+    for (const [name, values] of choices) {
+      lines.push(`  ${name}: ${Array.isArray(values) ? values.join(', ') : oneLine(values)}`);
+    }
+  }
+  if (data.note) lines.push('', String(data.note));
+  lines.push('');
+  lines.push(NOTHING_CHARGED);
+  const approval = data.approval && data.approval.text ? data.approval.text : '';
+  if (approval) lines.push(approval);
+  if (data.id) {
+    const hints = data.approve_with && typeof data.approve_with === 'object'
+      ? Object.keys(data.approve_with).map((key) => `--${key.replace(/_/g, '-')} <${key}>`).join(' ')
+      : '';
+    lines.push(`Once they say yes: atris buy approve ${data.id}${hints ? ` ${hints}` : ''}`);
+  }
+  return lines.join('\n');
+}
+
+function renderOutcome(data = {}, now = Date.now()) {
+  const lines = [];
+  const status = String(data.status || '');
+  if (status === 'pending_approval') {
+    lines.push(data.message || 'Waiting for the person to approve.');
+    lines.push('');
+    lines.push(...moneyLines(data));
+    if (data.expires_at) lines.push(`Expires: ${data.expires_at} (${untilText(data.expires_at, now)})`);
+    if (data.id) lines.push(`Id: ${data.id}`);
+    lines.push('');
+    lines.push('Next, the person does this themselves:');
+    for (const line of approvalLines(data.approval)) lines.push(`  ${line}`);
+    if (data.fee_card && data.fee_card.url) lines.push(`  Fee card: ${data.fee_card.url}`);
+    lines.push('');
+    lines.push('Nothing has been charged yet. Money moves only after the person acts themselves.');
+    if (data.id) lines.push(`Check it: atris buy status ${data.id}`);
+    return lines.join('\n');
+  }
+  if (status === 'needs_setup') {
+    lines.push(data.message || 'Setup needed first.');
+    for (const line of approvalLines(data.approval)) lines.push(`  ${line}`);
+    lines.push('Nothing was charged.');
+    return lines.join('\n');
+  }
+  if (status === 'needs_input') {
+    lines.push(data.message || 'More details needed.');
+    if (Array.isArray(data.fields) && data.fields.length) lines.push(`Needed: ${data.fields.join(', ')}`);
+    if (data.extra_usd != null) lines.push(`Extra: $${data.extra_usd}`);
+    if (data.total_usd != null) lines.push(`New total: $${data.total_usd}`);
+    lines.push('Nothing was charged.');
+    return lines.join('\n');
+  }
+  if (status === 'refused') {
+    lines.push(data.message || 'That did not go through.');
+    if (!/nothing was/i.test(String(data.message || ''))) lines.push('Nothing was charged.');
+    return lines.join('\n');
+  }
+  return data.message || oneLine(data);
+}
+
+function renderStatus(data = {}) {
+  const lines = [];
+  lines.push(`${data.id || ''}  ${data.kind || ''}  ${String(data.state || 'unknown').toUpperCase()}`.trim());
+  if (data.what) lines.push(`What: ${data.what}`);
+  if (data.amount_cents != null) lines.push(`Amount: ${formatCents(data.amount_cents, data.currency)}`);
+  if (data.when) lines.push(`When: ${data.when}`);
+  if (data.detail) lines.push(`Detail: ${data.detail}`);
+  if (data.counterparty) lines.push(`With: ${data.counterparty}`);
+  if (data.receipt_url) lines.push(`Receipt: ${data.receipt_url}`);
+  if (data.fee_payment_url) lines.push(`Pay the Atris fee: ${data.fee_payment_url}`);
+  const approval = approvalLines(data.approval);
+  if (approval.length) {
+    lines.push('Waiting on the person:');
+    for (const line of approval) lines.push(`  ${line}`);
+  }
+  if (data.state === 'unknown') lines.push('Money may have moved. Check the store or Robinhood app. Do not buy again to fix it.');
+  return lines.join('\n');
+}
+
+function buildRequest(sub, pos, flags) {
+  if (sub === 'quote') {
+    const base = jsonFlag(flags, 'intent');
+    if (!base.ok) return base;
+    const body = { ...base.value, ...fieldsFrom(flags) };
+    const kind = String(body.kind || '').toLowerCase();
+    if (!KINDS.includes(kind)) return { ok: false, error: `--kind must be one of ${KINDS.join(', ')}` };
+    body.kind = kind;
+    return { ok: true, path: '/commerce/quote', method: 'POST', body };
+  }
+  if (sub === 'approve' || sub === 'status') {
+    const id = String(pos[1] || '').trim();
+    if (!id) return { ok: false, error: `usage: atris buy ${sub} <id>` };
+    const path = `/commerce/${encodeURIComponent(id)}`;
+    if (sub === 'status') return { ok: true, path, method: 'GET' };
+    const base = jsonFlag(flags, 'details');
+    if (!base.ok) return base;
+    return { ok: true, path: `${path}/approve`, method: 'POST', body: { ...base.value, ...fieldsFrom(flags) } };
+  }
+  return { ok: false, error: 'usage: atris buy <quote|approve|status>. run: atris buy --help' };
+}
+
+async function buyCommand(args = [], deps = {}) {
+  const io = { log: deps.log || console.log, err: deps.err || console.error };
+  const { flags, pos } = parseFlags(args);
+  const sub = String(pos[0] || '').toLowerCase();
+  if (!sub || sub === 'help' || flags.help) {
+    showBuyHelp(io.log);
+    return 0;
+  }
+
+  const json = flags.json === true;
+  const fail = (error, status) => {
+    printResult({ json, ok: false, error, payload: { ok: false, error, ...(status ? { status } : {}) } }, io);
+    return 1;
+  };
+
+  const req = buildRequest(sub, pos, flags);
+  if (!req.ok) return fail(req.error);
+
+  const load = deps.loadCredentials || loadCredentials;
+  const request = deps.apiRequestJson || apiRequestJson;
+  const token = commerceToken(load(), 'commerce:quote', deps.now ? deps.now() : Date.now());
+  if (!token) return fail(NOT_LOGGED_IN);
+
+  try {
+    // No retries: a quote or approval must never be sent twice by accident.
+    const options = { method: req.method, token, retries: 0 };
+    if (req.body) options.body = req.body;
+    const result = await request(req.path, options);
+    if (!result || !result.ok) return fail(errorFrom(result), result && result.status);
+    const data = result.data || {};
+    const now = deps.now ? deps.now() : Date.now();
+    const text = sub === 'quote' ? renderQuote(data, now)
+      : sub === 'approve' ? renderOutcome(data, now)
+        : renderStatus(data);
+    printResult({ json, ok: true, text, payload: { ok: true, ...data } }, io);
+    return 0;
+  } catch (error) {
+    return fail(oneLine(error && error.message));
+  }
+}
+
+module.exports = { buyCommand };

package/commands/deck.js

@@ -15,8 +15,8 @@
 
 const fs = require('fs');
 const https = require('https');
-const os = require('os');
 const path = require('path');
+const { stateHome } = require('../lib/state-home');
 const { hasFlag } = require('../lib/arg-parser');
 const { buildDeck, THEMES, notesRequests } = require('../lib/slides-deck');
 const {
@@ -34,7 +34,7 @@ const BASE = 'api.atris.ai';
 const PFX = '/api/integrations/google-slides';
 
 function token() {
-  try { return require(path.join(os.homedir(), '.atris/credentials.json')).token; }
+  try { return require(path.join(stateHome(), '.atris/credentials.json')).token; }
   catch { return null; }
 }
 

package/commands/engine.js

@@ -69,6 +69,8 @@ const {
   readEngineRegistry,
   resolveEngineForRole,
   resolveEngineForRoleRanked,
+  resolveNotesJob,
+  jobTakesAnyEngine,
   requireEngineBin,
   engineDoctorReport,
   engineFailureHealthStatus,
@@ -1000,10 +1002,41 @@ function rosterPickEntry(value) {
 
 const WORKER_SKIP_WORDS = Object.freeze({ 'not ready': 'down', expired: 'expired', 'bad model': 'names a model it cannot run' });
 
+// A worker whose end date is this many days away or fewer gets a heads-up.
+const ENDS_SOON_DAYS = 7;
+const RENEW_COMMAND = 'atris engine roster confirm';
+
+// Whole local days from today to a worker's end date: 0 on its last day,
+// negative once it has ended, null when it has no valid end date.
+function endsInDays(until, now = new Date()) {
+  const end = parseRosterUntil(until);
+  if (!end) return null;
+  const date = new Date(now);
+  if (Number.isNaN(date.getTime())) return null;
+  const today = new Date(date.getFullYear(), date.getMonth(), date.getDate());
+  return Math.round((end.getTime() - today.getTime()) / 86400000);
+}
+
+function endsSoon(days) {
+  return days !== null && days >= 0 && days <= ENDS_SOON_DAYS;
+}
+
+function endsInText(days) {
+  if (days === 0) return 'ends today';
+  if (days === 1) return 'ends tomorrow';
+  return `ends in ${days} days`;
+}
+
+function shortDay(until) {
+  const date = parseRosterUntil(until);
+  return date ? date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' }).toLowerCase() : '';
+}
+
 // One worker of a job's team as the view shows it: what it runs, and whether
 // it leads now, backs up, or is skipped and why.
-function workerRow(step, index, leadIndex) {
+function workerRow(step, index, leadIndex, now = new Date()) {
   const { worker } = step;
+  const endsIn = endsInDays(worker.until, now);
   const runs = worker.error ? null : engineRunsView(worker.engine, { model: worker.model || '', effort: worker.effort || '' });
   const status = index === leadIndex ? 'leads' : step.skip ? 'skipped' : 'backup';
   const why = step.skip === 'bad line' ? `bad line: ${worker.error}`
@@ -1016,6 +1049,8 @@ function workerRow(step, index, leadIndex) {
     max_seconds: Number(worker.max_seconds) > 0 ? Number(worker.max_seconds) : null,
     prep: worker.prep ? rosterJobLabel(worker.prep) : null,
     until: worker.until || null,
+    ends_in_days: endsIn,
+    expiring_soon: endsSoon(endsIn),
     line: worker.line || null,
     ...(worker.error ? { text: worker.text || '' } : {}),
     status,
@@ -1041,7 +1076,7 @@ function jobRosterRow(job, role, root, state, registry, now, key = role) {
   const decided = rosterDecided(resolved.source) && (!custom || resolved.job === job);
   const source = decided ? resolved.source : ROSTER_LAYERS.find((scope) => picks[scope]) || null;
   const pick = source ? picks[source] : null;
-  const walk = pick ? rosterWorkerWalk(pick, role, registry, now) : [];
+  const walk = pick ? rosterWorkerWalk(pick, role, registry, now, { anyEngine: jobTakesAnyEngine(key) }) : [];
   const leadIndex = decided && resolved.source === source ? walk.findIndex((step) => !step.skip) : -1;
   const good = walk.map((step, index) => ({ step, index })).filter(({ step }) => !step.worker.error);
   const first = good[0] || null;
@@ -1055,6 +1090,7 @@ function jobRosterRow(job, role, root, state, registry, now, key = role) {
       : good[1] && leadIndex === good[1].index ? 'backup'
         : 'later';
   const kind = Object.keys(ENGINE_JOBS).find((name) => ENGINE_JOBS[name] === role);
+  const pickEndsIn = pick ? endsInDays(pick.until, now) : null;
   // What the job really runs: its first two good workers, each with its own
   // model and effort, or the router's engine when no line decides.
   const runsOf = (entry) => (entry ? engineRunsView(entry.step.worker.engine, { model: entry.step.worker.model || '', effort: entry.step.worker.effort || '' }) : null);
@@ -1076,12 +1112,14 @@ function jobRosterRow(job, role, root, state, registry, now, key = role) {
     model: resolved.engine && resolved.engine.roster_model ? resolved.engine.roster_model : null,
     effort: resolved.engine && resolved.engine.roster_effort ? resolved.engine.roster_effort : null,
     max_seconds: pick && Number(pick.max_seconds) > 0 ? Number(pick.max_seconds) : null,
+    ends_in_days: pickEndsIn,
+    expiring_soon: endsSoon(pickEndsIn),
     prep: first && first.step.worker.prep ? rosterJobLabel(first.step.worker.prep) : null,
     backup_prep: good[1] && good[1].step.worker.prep ? rosterJobLabel(good[1].step.worker.prep) : null,
     runs: runs || nowRuns,
     backup_runs: runsOf(good[1]),
     now_runs: nowRuns,
-    workers: walk.map((step, index) => workerRow(step, index, leadIndex)),
+    workers: walk.map((step, index) => workerRow(step, index, leadIndex, now)),
     lead,
     status,
     ...(status === 'cooling' ? { cooling: first.step.cooling.text } : {}),
@@ -1114,8 +1152,11 @@ function rosterReport(root = process.cwd(), now = new Date()) {
   const state = readRosterState(root, { now });
   const jobs = jobRosterView(root, now, state);
   const team = teamRosterView(root, { now, rosterState: state });
+  const expiring = expiringWorkers(jobs);
   return {
     jobs,
+    expiring,
+    renew_command: expiring.length ? RENEW_COMMAND : null,
     team: team.rows,
     warnings: [...state.session.warnings, ...state.project.warnings, ...state.machine.warnings, ...team.warnings],
     files: {
@@ -1127,12 +1168,52 @@ function rosterReport(root = process.cwd(), now = new Date()) {
   };
 }
 
-function untilText(worker) {
+// Every worker, in any job, whose end date is today or within the next
+// seven days. Workers already past their date show on their own lines. A
+// job set for this shell only is skipped: roster confirm does not renew it.
+function expiringWorkers(jobs) {
+  const list = [];
+  for (const row of jobs || []) {
+    if (row.session_pick) continue;
+    for (const worker of row.workers || []) {
+      if (!worker.expiring_soon) continue;
+      list.push({
+        job: row.job,
+        engine: worker.engine,
+        model: worker.model,
+        tool: worker.runs ? worker.runs.text : worker.engine,
+        until: worker.until,
+        ends_in_days: worker.ends_in_days,
+        from: row.from,
+      });
+    }
+  }
+  return list;
+}
+
+function untilText(worker, days = null) {
   const until = parseRosterUntil(worker.until);
-  if (until) return `until ${until.toLocaleDateString('en-US', { month: 'short', day: 'numeric' }).toLowerCase()}`;
+  if (until) return `until ${shortDay(worker.until)}${endsSoon(days) ? `, ${endsInText(days)}` : ''}`;
   return worker.never_expires ? 'no end date' : 'until no valid date';
 }
 
+// One line under the jobs when any worker ends within seven days, naming
+// each one and the command that keeps it going.
+function renderExpiringLine(expiring) {
+  if (!expiring || !expiring.length) return '';
+  const names = expiring.map((item) => `${item.tool} on ${item.job} ${endsInText(item.ends_in_days)}`);
+  const them = expiring.length === 1 ? 'it' : 'them';
+  return `heads up: ${names.join(', ')}. to keep ${them} 30 more days, run: ${RENEW_COMMAND}`;
+}
+
+// The same heads-up, short enough for one boot line.
+function bootExpiringLine(expiring) {
+  if (!expiring || !expiring.length) return '';
+  const [first] = expiring;
+  const more = expiring.length > 1 ? ` and ${expiring.length - 1} more` : '';
+  return `${first.tool} on ${first.job} ${endsInText(first.ends_in_days)}${more}. renew: ${RENEW_COMMAND}`;
+}
+
 // Every worker under its job, numbered in order, when the job has more than
 // the lead and one backup (the job's own line already shows those two).
 function renderWorkerLines(row) {
@@ -1140,8 +1221,11 @@ function renderWorkerLines(row) {
   const width = Math.max(...row.workers.map((worker) => (worker.runs ? worker.runs.text : worker.text || '').length));
   return row.workers.map((worker, index) => {
     const what = (worker.runs ? worker.runs.text : worker.text || '').padEnd(width);
-    const extras = [worker.max_seconds ? rosterMaxText(worker.max_seconds) : '', worker.prep ? `prepped by ${worker.prep}` : '', worker.until ? `until ${worker.until}` : ''].filter(Boolean);
-    const state = worker.status === 'leads' ? 'leads now' : worker.status === 'backup' ? 'backup' : `skipped, ${worker.why}`;
+    const ended = worker.status === 'skipped' && worker.why === 'expired' && worker.ends_in_days !== null;
+    const until = !worker.until || ended ? '' : `until ${worker.until}${worker.expiring_soon ? `, ${endsInText(worker.ends_in_days)}` : ''}`;
+    const extras = [worker.max_seconds ? rosterMaxText(worker.max_seconds) : '', worker.prep ? `prepped by ${worker.prep}` : '', until].filter(Boolean);
+    const state = worker.status === 'leads' ? 'leads now' : worker.status === 'backup' ? 'backup'
+      : ended ? `ended ${shortDay(worker.until)}, skipped` : `skipped, ${worker.why}`;
     return `  ${index + 1}. ${what} ${[state, ...extras].join(', ')}`.trimEnd();
   });
 }
@@ -1165,9 +1249,10 @@ function renderJobRoster(rows) {
     const owner = row.runs.text.padEnd(ownerWidth);
     const backup = row.backup_runs ? `backup ${row.backup_runs.text}${row.backup_prep ? ` prepped by ${row.backup_prep}` : ''}` : 'no backup';
     const cap = `${row.max_seconds ? `${rosterMaxText(row.max_seconds)}, ` : ''}${row.prep ? `prepped by ${row.prep}, ` : ''}`;
-    const date = untilText(row.pick);
+    const date = untilText(row.pick, row.ends_in_days);
     const fallback = row.lead === 'backup' ? 'using backup' : row.lead === 'later' ? `using ${nowText}` : fallsTo;
-    const status = row.status === 'expired' ? `expired, ${fallback}`
+    const ended = row.ends_in_days !== null && row.ends_in_days !== undefined ? `ended ${shortDay(row.pick.until)}, skipped` : 'expired';
+    const status = row.status === 'expired' ? `${ended}, ${fallback}`
       : row.status === 'cooling' ? `${row.cooling}, ${fallback}`
         : row.status === 'not ready' ? `not ready, ${fallback}`
           : date;
@@ -1195,7 +1280,8 @@ function renderRosterWarnings(warnings) {
 }
 
 function renderRosterReport(report) {
-  return [renderJobRoster(report.jobs), renderTeamRoster(report.team), renderRosterWarnings(report.warnings)]
+  const jobs = [renderJobRoster(report.jobs), renderExpiringLine(report.expiring)].filter(Boolean).join('\n');
+  return [jobs, renderTeamRoster(report.team), renderRosterWarnings(report.warnings)]
     .filter(Boolean)
     .join('\n\n');
 }
@@ -1530,9 +1616,30 @@ function parseSetFlag(args) {
   return '';
 }
 
-function runResolveCommand(args, root) {
+// One worker as a person reads it: the tool, then its model and effort.
+function notesWorkerText(worker) {
+  const details = [worker.model, worker.effort ? `effort ${worker.effort}` : '', worker.installed ? '' : 'not installed'].filter(Boolean);
+  return details.length ? `${worker.engine} (${details.join(', ')})` : worker.engine;
+}
+
+// The notes job: the roster's pick when one is set, else the built-in
+// default. Always answers, so scripts can call it with a short timeout.
+function runNotesResolve(json, root, now) {
+  const answer = resolveNotesJob(root, { now });
+  if (json) {
+    console.log(JSON.stringify(answer));
+    return 0;
+  }
+  const backup = answer.backup.length ? `backup ${answer.backup.map(notesWorkerText).join(', then ')}` : 'no backup';
+  const where = answer.source === 'roster' ? `from ${answer.from}` : `built-in default${answer.skipped ? ` (${answer.skipped})` : ''}`;
+  console.log(`notes: ${notesWorkerText(answer)}, ${backup}, ${where}`);
+  return 0;
+}
+
+function runResolveCommand(args, root, now) {
   const json = args.includes('--json');
   const role = args.filter((a) => !String(a).startsWith('--'))[0] || '';
+  if (role && rosterJobKey(role) === 'notes') return runNotesResolve(json, root, now);
   if (!role) {
     const message = `usage: atris engine resolve <role> or <job>; roles: ${ENGINE_ROLES.join(', ')}; jobs: search, build, review, or your own`;
     if (json) console.log(JSON.stringify({ ok: false, error: message }, null, 2));
@@ -2133,7 +2240,7 @@ function engineCommand(args = [], deps = {}) {
   }
 
   if (sub === 'resolve') {
-    return runResolveCommand(scope.args.slice(scope.args.indexOf('resolve') + 1), root);
+    return runResolveCommand(scope.args.slice(scope.args.indexOf('resolve') + 1), root, deps.now);
   }
 
   if (sub === 'health') {
@@ -2160,7 +2267,7 @@ function engineCommand(args = [], deps = {}) {
     if (sub === 'help' || args.includes('--help') || args.includes('-h')) {
       console.log('\n  atris engine watch [<id>|latest] [--no-follow]\n                           follow one live transcript or list running engine work');
       console.log('\n  long read-only asks: atris engine ask "..." --engine agy --timeout <seconds>\n                           quick asks default to 120 seconds; explicit jobs allow up to 3600\n                           follow live work with atris engine watch latest');
-      console.log('\n  atris engine            roster + current default\n  atris engine roster [--json] show every job and its workers in order: search, build, review, and your own\n  atris engine roster confirm renew every dated worker for 30 days\n  atris engine roster session [clear]\n                           show or drop the roster changes for this shell only\n  atris engine roster --available\n                           tools on this machine and the models each one offers\n  atris engine roster --runs [job]\n                           the last 20 runs, newest first, with tool, model, time, and outcome\n  atris engine assign <job> <tool> [--like <kind>] [--model <m>] [--effort <level>] [--max "20 min"] [--prep <job>] [--backup "<tool> [model]"] [--days <n>] [--add] [--session | --everywhere]\n  atris engine assign <job> --promote "<tool> [model]" | --remove <tool> | --clear [--session | --everywhere]\n                           sets the lead worker of the job; --promote moves one of its workers to the top as written;\n                           --add puts one more at the end; jobs: search, build, review,\n                           or your own like "small build" (--like search|build|review when the name does not say);\n                           --prep search has that job read the task first and hand this worker a short brief;\n                           --everywhere is for all projects; --session is this shell only (set ATRIS_ROSTER_SESSION=<name>)\n  atris engines --chart   show the fleet as an org chart\n  atris engine list --json [--all] full registry: default + engines with tier, roles, fallback, health (--all includes hidden engines)\n  atris engine set <name> --duty leader|errands|learning [--models "a, b"]\n                           arrange the fleet and save its model policy\n  atris engine resolve <role> or <job> [--json]\n                           choose the best ready engine for navigator|executor|validator or a roster job\n  atris engine health <name> --set ready|not_installed|credit_out\n                           flip runtime health, for example when credits run out\n  atris engine doctor [--json]\n                           probe which engine CLIs are installed here and sync that into health policy\n  atris engine <name>     make that engine the default here\n  atris engine test [name] preflight: run the engine CLI headless, report pass/fail\n  atris engine bench [names...] [--runs N]\n                           ranked latency scoreboard of engine passes\n  atris engine ask "<question>" --engine <name> [--engine <name> ...]\n                           ask several engines in parallel without allowing edits\n  atris engine ask --jobs <jobs.json>\n                           ask different read-only questions in parallel\n  atris engine validate <receipt-path|latest> [--engine <name>]\n                           check ask answers with a different read-only referee\n  atris engine validate scoreboard\n                           show pass rates by worker engine\n  atris engine dispatch <task-id> [<task-id> ...] --engine cursor|codex [--prompt-file <f>] [--yolo]\n                           one-command claim, worktree, build, verify, ship, ready\n  atris engine login <provider> --yes\n                           upload a local provider CLI login to the backend vault\n  atris engine login <provider> --computer [--seat <name>]\n  atris engine login <provider> --business <id> [--seat <name>]\n                           sign in on an Atris computer by device flow\n  atris engine login --list | --remove <provider>\n                           list or remove vaulted provider logins\n  atris engine seats       show which named accounts are ready to work\n  atris engine seed <provider> --business <id>|--user\n                           push a vaulted login onto an Atris computer\n  atris engine reset      back to the house default\n  --engine <name>         one run on that engine (mission run / autopilot / run)\n');
+      console.log('\n  atris engine            roster + current default\n  atris engine roster [--json] show every job and its workers in order: search, build, review, and your own\n  atris engine roster confirm renew every dated worker for 30 days\n  atris engine roster session [clear]\n                           show or drop the roster changes for this shell only\n  atris engine roster --available\n                           tools on this machine and the models each one offers\n  atris engine roster --runs [job]\n                           the last 20 runs, newest first, with tool, model, time, and outcome\n  atris engine assign <job> <tool> [--like <kind>] [--model <m>] [--effort <level>] [--max "20 min"] [--prep <job>] [--backup "<tool> [model]"] [--days <n>] [--add] [--session | --everywhere]\n  atris engine assign <job> --promote "<tool> [model]" | --remove <tool> | --clear [--session | --everywhere]\n                           sets the lead worker of the job; --promote moves one of its workers to the top as written;\n                           --add puts one more at the end; jobs: search, build, review,\n                           or your own like "small build" (--like search|build|review when the name does not say);\n                           --prep search has that job read the task first and hand this worker a short brief;\n                           --everywhere is for all projects; --session is this shell only (set ATRIS_ROSTER_SESSION=<name>)\n  atris engines --chart   show the fleet as an org chart\n  atris engine list --json [--all] full registry: default + engines with tier, roles, fallback, health (--all includes hidden engines)\n  atris engine set <name> --duty leader|errands|learning [--models "a, b"]\n                           arrange the fleet and save its model policy\n  atris engine resolve <role> or <job> [--json]\n                           choose the best ready engine for navigator|executor|validator or a roster job;\n                           notes always answers: its roster pick, else agy then haiku\n  atris engine health <name> --set ready|not_installed|credit_out\n                           flip runtime health, for example when credits run out\n  atris engine doctor [--json]\n                           probe which engine CLIs are installed here and sync that into health policy\n  atris engine <name>     make that engine the default here\n  atris engine test [name] preflight: run the engine CLI headless, report pass/fail\n  atris engine bench [names...] [--runs N]\n                           ranked latency scoreboard of engine passes\n  atris engine ask "<question>" --engine <name> [--engine <name> ...]\n                           ask several engines in parallel without allowing edits\n  atris engine ask --jobs <jobs.json>\n                           ask different read-only questions in parallel\n  atris engine validate <receipt-path|latest> [--engine <name>]\n                           check ask answers with a different read-only referee\n  atris engine validate scoreboard\n                           show pass rates by worker engine\n  atris engine dispatch <task-id> [<task-id> ...] --engine cursor|codex [--prompt-file <f>] [--yolo]\n                           one-command claim, worktree, build, verify, ship, ready\n  atris engine login <provider> --yes\n                           upload a local provider CLI login to the backend vault\n  atris engine login <provider> --computer [--seat <name>]\n  atris engine login <provider> --business <id> [--seat <name>]\n                           sign in on an Atris computer by device flow\n  atris engine login --list | --remove <provider>\n                           list or remove vaulted provider logins\n  atris engine seats       show which named accounts are ready to work\n  atris engine seed <provider> --business <id>|--user\n                           push a vaulted login onto an Atris computer\n  atris engine reset      back to the house default\n  --engine <name>         one run on that engine (mission run / autopilot / run)\n');
       return 0;
     }
     if (isFreshWorkspace(root)) {
@@ -2210,6 +2317,8 @@ module.exports = {
   roster,
   rosterReport,
   jobRosterView,
+  expiringWorkers,
+  bootExpiringLine,
   engineRegistryFile,
   readEngineRegistry,
   resolveEngineForRole,

package/commands/feedback.js

@@ -17,6 +17,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const { stateHome } = require('../lib/state-home');
 const { loadCredentials } = require('../utils/auth');
 const { apiRequestJson } = require('../utils/api');
 const {
@@ -297,8 +298,7 @@ function resolveBusinessArg(value) {
   // Full UUID, trust it
   if (/^[0-9a-f-]{32,}$/i.test(value)) return value;
   // Otherwise treat as slug and look up in ~/.atris/businesses.json
-  const home = require('os').homedir();
-  const file = path.join(home, '.atris', 'businesses.json');
+  const file = path.join(stateHome(), '.atris', 'businesses.json');
   if (!fs.existsSync(file)) return null;
   try {
     const map = JSON.parse(fs.readFileSync(file, 'utf8'));

package/commands/fork.js

@@ -1,6 +1,6 @@
 const fs = require('fs');
 const path = require('path');
-const os = require('os');
+const { stateHome } = require('../lib/state-home');
 const { loadCredentials } = require('../utils/auth');
 const { apiRequestJson } = require('../utils/api');
 
@@ -48,7 +48,7 @@ async function forkAtris() {
     files = downloadResult.data.files;
   } else {
     // Fall back to local template at ~/.atris/templates/{template}/
-    const localTemplatePath = path.join(os.homedir(), '.atris', 'templates', template);
+    const localTemplatePath = path.join(stateHome(), '.atris', 'templates', template);
     if (fs.existsSync(localTemplatePath)) {
       console.log('  API unavailable, using local template...');
       files = readLocalTemplate(localTemplatePath, localTemplatePath);

package/commands/gm.js

@@ -3,6 +3,7 @@
 const fs = require('fs');
 const os = require('os');
 const path = require('path');
+const { stateHome } = require('../lib/state-home');
 const { hasFlag: hasExactFlag } = require('../lib/arg-parser');
 
 const AGENTXP_LEADERBOARD_URL = 'https://api.atris.ai/api/agentxp/leaderboard';
@@ -452,7 +453,7 @@ function feedPostId(post) {
 }
 
 function credentialsFileExists() {
-  return fs.existsSync(path.join(os.homedir(), '.atris', 'credentials.json'));
+  return fs.existsSync(path.join(stateHome(), '.atris', 'credentials.json'));
 }
 
 async function fetchFeedEvents(workspaceRoot) {