atris 3.47.0 → 3.48.1

package/atris/CLAUDE.md

@@ -100,6 +100,8 @@ The human approves work by reading, so how you report IS the product.
 
 ## Rules (Non‑Negotiable)
 
+- YouTube link in a message: run `atris youtube notes <url>` before saying anything about the video. The transcript is the source; notes from model memory are fabrication.
+
 - Plan = ASCII visualization + approval gate. Do not execute during planning.
 - Execute step-by-step, verify as you go, update artifacts (`TODO.md`, `MAP.md`) when reality changes.
 - Delete completed tasks (validator cleans to target state = 0).

package/atris/skills/youtube/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: youtube
-description: "Process YouTube videos — extract insights, answer questions, store as knowledge. 5 credits per video. Triggers on: youtube, video, process video, watch this, learn from video."
-version: 2.3.0
+description: "A YouTube link in any message routes here. Run atris youtube notes <url> FIRST: free, about 30 seconds, quotes verified against the transcript. Never summarize a video from model memory, that is fabrication. Use atris youtube process only to store it as queryable knowledge (5 credits). Triggers on: any youtube.com or youtu.be link, youtube, video, watch this, notes on this."
+version: 2.4.0
 tags:
   - youtube
   - research
@@ -15,9 +15,11 @@ Process any YouTube video through Atris transcript-first analysis. The CLI extra
 
 ## Route first: learning vs product
 
-Two rails process YouTube videos — pick before running anything:
+Two rails process YouTube videos: pick before running anything:
 
 - **Learning / work rail** → use the `alpha-learn` skill (ytnotes). Local yt-dlp + grok, zero credits, podcastnotes-style notes, tweet-feed output, `[claimable]` entries in today's journal for other agents. Use this when the goal is to LEARN from a video or mine it for Atris work.
+  Canonical ytnotes source is `scripts/det/ytnotes` (install: `ln -sf "$PWD/scripts/det/ytnotes" ~/.local/bin/ytnotes`).
+  Runs are scored by `node scripts/det/ytrail-eval.js`.
 - **Product rail** → this skill (`atris youtube process`). Credits-billed, stores knowledge in the Atris backend, customer-facing path. Use this when a customer/agent needs the video stored as Atris knowledge or answered via the API.
 
 If the user says "learn from", "notes on", "alpha", or "rabbit hole" → alpha-learn. If they say "process", "store", "add to knowledge" → this skill.
@@ -189,7 +191,7 @@ Every important insight should carry a timestamp when the transcript provides on
 | `401` | Token expired/invalid | `atris login --force` |
 | `402` | Not enough credits | Check balance, purchase at atris.ai |
 | `400` | Invalid YouTube URL | Check URL format |
-| `502` | Transcript or cloud processing failed | Retry — credits auto-refunded when backend fails |
+| `502` | Transcript or cloud processing failed | Retry; credits auto-refunded when backend fails |
 
 ---
 

package/bin/atris.js

@@ -38,6 +38,7 @@ try {
 const {
   checkForUpdates,
   showUpdateNotification,
+  autoUpdate,
   inspectInstallGitState,
   formatInstallGitWarning,
 } = require('../utils/update-check');
@@ -106,6 +107,7 @@ if (!skipUpdateCheck && (!updateCommand || (updateCommand && !['version', 'updat
         showUpdateNotification(updateInfo, {
           packageRoot: path.join(__dirname, '..'),
         });
+        autoUpdate(updateInfo, { packageRoot: path.join(__dirname, '..') });
       }
       return updateInfo;
     })
@@ -511,6 +513,7 @@ function showHelp() {
   console.log('  orb        - Pick next moves while engine jobs work in the background');
   console.log('  activate   - Load Atris context');
   console.log('  radar      - Show live agents joined with tasks, missions, and worktrees');
+  console.log('  who        - Show local engines and team members working, waiting, done, or stale');
   console.log('  stream     - Watch the whole team work live in one terminal');
   console.log('  team       - One team view: members, roles, engine assignments (presence for live)');
   console.log('  watch      - Turn one sentence into an always-on background watcher');
@@ -569,7 +572,7 @@ function showHelp() {
   console.log('  router     - inspect ax lane outcomes and promote gated reflex overrides');
   console.log('  sign       - Co-author trailer on every commit in an atris workspace (on/off/status)');
   console.log('  visualize  - Generate a Slack/deck-ready visual from a prompt');
-  console.log('  youtube    - Process YouTube videos with timestamped transcript-first analysis');
+  console.log('  youtube    - Free local notes or 5-credit cloud process for YouTube videos');
   console.log('');
   console.log('Experiments:');
   console.log('  experiments init [slug]     - Prepare atris/experiments/ or scaffold a pack');
@@ -1827,6 +1830,10 @@ if (command === 'init') {
   Promise.resolve(require('../commands/team').teamCommand(process.argv.slice(3)))
     .then((code) => process.exit(code || 0))
     .catch((err) => { console.error(`\nerror: ${err.message || err}`); process.exit(1); });
+} else if (command === 'who') {
+  Promise.resolve(require('../commands/who').whoCommand(process.argv.slice(3)))
+    .then((code) => process.exit(code || 0))
+    .catch((err) => { console.error(`\nerror: ${err.message || err}`); process.exit(1); });
 } else if (command === 'wish') {
   Promise.resolve(require('../commands/wish').wishCommand(process.argv.slice(3)))
     .then((code) => process.exit(code || 0))

package/commands/dream.js

@@ -10,7 +10,7 @@ const {
 
 const DREAMS_FILE = ['.atris', 'state', 'dreams.jsonl'];
 const DAY_MS = 24 * 60 * 60 * 1000;
-const DREAM_TIMEOUT_MS = 60 * 1000;
+const DREAM_TIMEOUT_MS = 5 * 60 * 1000;
 const MAX_CONTEXT_CHARS = 7000;
 const MAX_SECTION_CHARS = 2400;
 

package/commands/engine.js

@@ -37,10 +37,11 @@ const {
   resolveEngineForRoleRanked,
   requireEngineBin,
   engineDoctorReport,
+  engineFailureHealthStatus,
   setEngineOverrides,
   setEngineHealth,
 } = require('../lib/engine-registry');
-const { FLEET_CAPABLE, runDispatchFlight } = require('../lib/fleet');
+const { DISPATCH_CAPABLE, runDispatchFlight } = require('../lib/fleet');
 const {
   buildReadOnlyEngineInvocation,
   runEngineAskCommand,
@@ -1379,12 +1380,12 @@ function parseDispatchArgs(args) {
 function runDispatchCommand(args, root) {
   const { taskIds, engine, promptFile, base, json, yolo } = parseDispatchArgs(args);
   if (!taskIds.length || !engine) {
-    console.error('usage: atris engine dispatch <task-id> [<task-id> ...] --engine cursor|codex [--prompt-file <f>] [--yolo]');
+    console.error('usage: atris engine dispatch <task-id> [<task-id> ...] --engine <engine> [--prompt-file <f>] [--yolo]');
     return 2;
   }
   const canonical = canonicalEngineName(engine);
-  if (!canonical || !FLEET_CAPABLE.includes(canonical)) {
-    console.error(`engine dispatch: --engine must be one of ${FLEET_CAPABLE.join(', ')}`);
+  if (!canonical || !DISPATCH_CAPABLE.includes(canonical)) {
+    console.error(`engine dispatch: --engine must be one of ${DISPATCH_CAPABLE.join(', ')}`);
     return 2;
   }
   // Argument-shape errors surface before environment errors: --prompt-file
@@ -1407,7 +1408,13 @@ function runDispatchCommand(args, root) {
   try {
     requireEngineBin(canonical);
   } catch (err) {
-    console.error(`engine dispatch: ${err.message}`);
+    const status = engineFailureHealthStatus({ status: 'errored', reason: err.message });
+    if (status) {
+      try { setEngineHealth(canonical, status, root); } catch { /* best effort */ }
+    }
+    console.error(canonical === 'fable'
+      ? `fable handoff failed: ${err.message}`
+      : `engine dispatch: ${err.message}`);
     return 2;
   }
   return runDispatchFlight({ root, taskIds, engine: canonical, prompt: promptOverride, yolo, ...(base ? { checkoutBase: base } : {}) }).then((flight) => {

package/commands/member.js

@@ -7288,6 +7288,7 @@ function composeWakeDecision(ctx, verdict) {
     state: ctx.state,
     goal: verdict.goal,
     current_experiment: verdict.current_experiment,
+    now_file: ctx.nowFile,
   };
   if ('autonomous_problem' in verdict) result.autonomous_problem = verdict.autonomous_problem;
   result.checks = ctx.checks;
@@ -7471,6 +7472,11 @@ const WAKE_DECISION_RULES = [
 
 function wakeDecision(name, paths, { force = false, runtimeKind = memberRuntimeKind(name) } = {}) {
   const purpose = missionPurpose(paths);
+  const nowPath = path.join(paths.memberDir, 'now.md');
+  const nowFile = fs.existsSync(nowPath) ? {
+    path: path.relative(process.cwd(), nowPath),
+    excerpt: String(purpose.nowText || '').slice(0, 500),
+  } : null;
   const steering = readSteeringMemory(paths, name);
   const state = loadMemberGoals(name, paths);
   const goal = activeGoal(state);
@@ -7519,7 +7525,7 @@ function wakeDecision(name, paths, { force = false, runtimeKind = memberRuntimeK
     next_command: wakeScores.selected.next_command,
   } : null;
 
-  const ctx = { name, force, purpose, steering, state, goal, current, blocked, evidence, workspace, checks, wakeScores };
+  const ctx = { name, force, purpose, nowFile, steering, state, goal, current, blocked, evidence, workspace, checks, wakeScores };
   for (const rule of WAKE_DECISION_RULES) {
     const verdict = rule(ctx);
     if (verdict) return composeWakeDecision(ctx, verdict);
@@ -7624,6 +7630,11 @@ async function runMemberWake(name, { execute = false, confirmed = false, force =
     nextCommand = `atris member review ${name} ${experiment.id} --accept --proof "..." --value 4`;
   }
 
+  const goals = (state.goals || []).map((item) => ({
+    id: item.id || null,
+    title: item.title || null,
+    status: item.status || null,
+  }));
   const receiptPayload = {
     schema: 'atris.member_wake.v1',
     created_at: now,
@@ -7636,6 +7647,8 @@ async function runMemberWake(name, { execute = false, confirmed = false, force =
     ask: planned.ask || null,
     next_command: nextCommand,
     mission: planned.mission,
+    now_file: planned.now_file,
+    goals,
     steering: planned.steering,
     evidence: planned.evidence,
     checks: planned.checks,
@@ -7692,6 +7705,8 @@ async function runMemberWake(name, { execute = false, confirmed = false, force =
     ask: planned.ask || null,
     next_command: nextCommand,
     mission: planned.mission,
+    now_file: planned.now_file,
+    goals,
     steering: planned.steering,
     evidence: planned.evidence,
     checks: planned.checks,
@@ -8972,6 +8987,25 @@ async function memberImprovements(businessId, ...args) {
 
 // --- Command Dispatcher ---
 
+async function memberChat(name, ...rest) {
+  const paths = requireMemberDir(name);
+  const flags = rest.filter((a) => String(a).startsWith('--'));
+  const words = rest.filter((a) => !String(a).startsWith('--'));
+  const fromFlag = flags.find((f) => f.startsWith('--from='));
+  const from = fromFlag ? fromFlag.slice('--from='.length) : (process.env.USER || 'terminal');
+  const text = words.join(' ').trim();
+  if (!text) {
+    console.error('Usage: atris member chat <name> "your message" [--from=<sender>]');
+    process.exit(1);
+  }
+  // Append-only inbox the Atris desktop polls into the member's desk chat.
+  // Contract shared with obelisk src/lib/memberChatInbox.cjs: one JSON object per line.
+  const line = JSON.stringify({ at: new Date().toISOString(), from, text });
+  fs.appendFileSync(path.join(paths.memberDir, 'chat-inbox.jsonl'), `${line}\n`, 'utf8');
+  console.log(`Sent to ${paths.storageName || name}'s desk. It appears in Atris Desktop within about 15 seconds when the app is open.`);
+  return { ok: true };
+}
+
 async function memberCommand(subcommand, ...args) {
   // Subcommands that take a member name as args[0] otherwise treat `--help` as
   // a name and error with "Member '--help' not found". `create`/`new` handle
@@ -9003,6 +9037,8 @@ async function memberCommand(subcommand, ...args) {
     case 'goal-from-score':
     case 'score-goal':
       return memberGoalFromScore(args[0], ...args.slice(1));
+    case 'chat':
+      return memberChat(args[0], ...args.slice(1));
     case 'tick':
       return memberTick(args[0], ...args.slice(1));
     case 'wake':
@@ -9046,6 +9082,7 @@ async function memberCommand(subcommand, ...args) {
       console.log('');
       console.log('Subcommands:');
       console.log('  create <name>       Scaffold a new team member (MEMBER.md + dirs) [--push]');
+      console.log('  chat <name> "..."   Send a message to this member\'s desk in Atris Desktop');
       console.log('  list                Show all team members');
       console.log('  activate <name>     Symlink member skills, show context and permissions');
       console.log('  upgrade <name>      Convert flat file (name.md) to directory format');

package/commands/mission.js

@@ -23,6 +23,7 @@ const {
 } = require('../lib/runner-command');
 const {
   resolveEngineForRoleWithPreference,
+  engineFailureHealthStatus,
   setEngineHealth,
 } = require('../lib/engine-registry');
 const {
@@ -378,28 +379,6 @@ function resolveMissionTickRunner(mission, root = process.cwd()) {
   };
 }
 
-function engineFailureHealthStatus(result) {
-  if (!result || result.status !== 'errored') return null;
-  const signalText = [
-    result.reason,
-    result.model_unavailable,
-    result.claude && result.claude.summary,
-    result.claude && result.claude.receipt_text,
-    result.claude && result.claude.stderr,
-    result.rate_limit_info && JSON.stringify(result.rate_limit_info),
-  ].filter(Boolean).join('\n').toLowerCase();
-  if (/usage[ _-]?limit|purchase more credits|insufficient credits|credit(?:s)?[ _-]?(?:out|limit)|rate[ _-]?limit/.test(signalText)) {
-    return 'credit_out';
-  }
-  if (/timeout|model-unavailable/.test(signalText)) return 'not_installed';
-  // Any other errored tick (claude-error, no-ready-engine's sibling failures,
-  // etc.) is still a real failure signal for the engine that ran it. Falling
-  // through to null here left the registry showing "ready" for an engine
-  // that had just hard-failed (e.g. a 401), so auto routing kept sending
-  // ticks back to it. Mark it "error" instead of silently doing nothing.
-  return 'error';
-}
-
 function recordMissionEngineTickOutcome(engineId, result, root = process.cwd()) {
   if (!engineId) return null;
   const status = result && result.status === 'ran' ? 'ready' : engineFailureHealthStatus(result);

package/commands/task.js

@@ -6028,25 +6028,66 @@ function cmdStatus(args) {
   if (history) console.log(`history feed ${status.swarlo.feed.length} event${status.swarlo.feed.length === 1 ? '' : 's'}`);
 }
 
+function readProjectionFile(workspaceRoot) {
+  const candidatePaths = [
+    workspaceRoot ? path.join(workspaceRoot, '.atris', 'state', 'tasks.projection.json') : null,
+    path.resolve('.atris', 'state', 'tasks.projection.json'),
+  ].filter(Boolean);
+  for (const candidate of candidatePaths) {
+    try {
+      if (fs.existsSync(candidate)) {
+        const content = fs.readFileSync(candidate, 'utf8');
+        const parsed = JSON.parse(content);
+        if (parsed && Array.isArray(parsed.tasks)) return parsed;
+      }
+    } catch {}
+  }
+  return null;
+}
+
 function resolveTaskRef(taskDb, db, ref) {
   const token = String(ref || '').trim();
   if (!token) return { ok: false, reason: 'missing' };
-  const exact = taskDb.getTask(db, token);
+  const exact = db ? taskDb.getTask(db, token) : null;
   if (exact) return { ok: true, id: exact.id, row: exact };
   const normalized = taskDb.normalizeTaskRef ? taskDb.normalizeTaskRef(token) : token.replace(/[^a-zA-Z0-9]/g, '').toUpperCase();
-  const rows = taskDb.withTaskDisplayRefs(taskDb.listTasks(db, { workspaceRoot: taskDb.workspaceRoot() }));
-  const seen = new Set();
-  const matches = rows.filter(r => {
-    const id = String(r.id || '').toUpperCase();
-    const display = taskDb.normalizeTaskRef ? taskDb.normalizeTaskRef(r.display_id) : String(r.display_id || '').replace(/[^a-zA-Z0-9]/g, '').toUpperCase();
-    const legacy = taskDb.normalizeTaskRef ? taskDb.normalizeTaskRef(r.legacy_ref) : String(r.legacy_ref || '').replace(/[^a-zA-Z0-9]/g, '').toUpperCase();
-    const matched = id.startsWith(normalized) || display === normalized || legacy === normalized;
-    if (!matched || seen.has(r.id)) return false;
-    seen.add(r.id);
-    return true;
-  });
-  if (matches.length === 1) return { ok: true, id: matches[0].id, row: matches[0] };
-  if (matches.length > 1) return { ok: false, reason: 'ambiguous', matches };
+  const wsRoot = taskDb.workspaceRoot ? taskDb.workspaceRoot() : process.cwd();
+
+  const proj = readProjectionFile(wsRoot);
+  if (proj && Array.isArray(proj.tasks)) {
+    const seen = new Set();
+    const matches = proj.tasks.filter(r => {
+      const id = String(r.id || '').toUpperCase();
+      const display = taskDb.normalizeTaskRef ? taskDb.normalizeTaskRef(r.display_id) : String(r.display_id || '').replace(/[^a-zA-Z0-9]/g, '').toUpperCase();
+      const legacy = taskDb.normalizeTaskRef ? taskDb.normalizeTaskRef(r.legacy_ref) : String(r.legacy_ref || '').replace(/[^a-zA-Z0-9]/g, '').toUpperCase();
+      const matched = id.startsWith(normalized) || (display && display === normalized) || (legacy && legacy === normalized);
+      if (!matched || seen.has(r.id)) return false;
+      seen.add(r.id);
+      return true;
+    });
+    if (matches.length === 1) {
+      const match = matches[0];
+      const row = db ? (taskDb.getTask(db, match.id) || match) : match;
+      return { ok: true, id: match.id, row };
+    }
+    if (matches.length > 1) return { ok: false, reason: 'ambiguous', matches };
+  }
+
+  if (db) {
+    const rows = taskDb.withTaskDisplayRefs(taskDb.listTasks(db, { workspaceRoot: wsRoot }));
+    const seen = new Set();
+    const matches = rows.filter(r => {
+      const id = String(r.id || '').toUpperCase();
+      const display = taskDb.normalizeTaskRef ? taskDb.normalizeTaskRef(r.display_id) : String(r.display_id || '').replace(/[^a-zA-Z0-9]/g, '').toUpperCase();
+      const legacy = taskDb.normalizeTaskRef ? taskDb.normalizeTaskRef(r.legacy_ref) : String(r.legacy_ref || '').replace(/[^a-zA-Z0-9]/g, '').toUpperCase();
+      const matched = id.startsWith(normalized) || (display && display === normalized) || (legacy && legacy === normalized);
+      if (!matched || seen.has(r.id)) return false;
+      seen.add(r.id);
+      return true;
+    });
+    if (matches.length === 1) return { ok: true, id: matches[0].id, row: matches[0] };
+    if (matches.length > 1) return { ok: false, reason: 'ambiguous', matches };
+  }
   return { ok: false, reason: 'not_found' };
 }
 
@@ -6067,7 +6108,7 @@ function workspaceRefRows(taskDb, db, options = {}) {
 }
 
 function renderTaskDesk(rows, refRows = rows) {
-  const displayRows = getTaskDb().withTaskDisplayRefs(rows, refRows);
+  const displayRows = (rows && rows.length && rows[0].display_id) ? rows : getTaskDb().withTaskDisplayRefs(rows, refRows);
   const active = displayRows.filter(r => r.status !== 'done' && r.status !== 'archived');
   const done = displayRows.filter(r => r.status === 'done');
   if (rows.length === 0) {
@@ -6078,7 +6119,7 @@ function renderTaskDesk(rows, refRows = rows) {
   console.log('TASK DESK');
   console.log('');
   for (const r of active.slice(0, 12)) {
-    const explanation = taskExplanation(r);
+    const explanation = r.explanation || taskExplanation(r);
     const owner = r.claimed_by ? ` @${r.claimed_by}` : '';
     const assigned = !r.claimed_by && taskAssignee(r) ? ` -> ${taskAssignee(r)}` : '';
     const tag = r.tag ? ` #${r.tag}` : '';
@@ -6415,7 +6456,17 @@ function cmdHome(args) {
     workspaceRoot,
     limit: all ? null : 200,
   });
-  const { projection, outPath } = writeDefaultProjection(taskDb, db, { all, everywhere });
+  let projection;
+  let outPath;
+  const existingProj = readProjectionFile(workspaceRoot);
+  if (rows.length === 0 && existingProj && Array.isArray(existingProj.tasks) && existingProj.tasks.length > 0) {
+    projection = existingProj;
+    outPath = path.resolve(path.join(workspaceRoot || '.', '.atris', 'state', 'tasks.projection.json'));
+  } else {
+    const written = writeDefaultProjection(taskDb, db, { all, everywhere });
+    projection = written.projection;
+    outPath = written.outPath;
+  }
   if (wantsJson(args)) {
     printJson({
       ok: true,
@@ -6427,7 +6478,7 @@ function cmdHome(args) {
     });
     return;
   }
-  renderTaskDesk(rows, rows);
+  renderTaskDesk(projection.tasks);
 }
 
 function cmdList(args) {
@@ -7382,7 +7433,14 @@ function cmdInspect(args) {
   const db = taskDb.open();
   const taskId = requireTaskId(taskDb, db, ref, 'atris task inspect');
   const projection = enrichTaskProjection(taskDb.taskProjection(db, { taskId }));
-  const task = projection.tasks[0];
+  let task = projection.tasks[0];
+  if (!task) {
+    const wsRoot = scopedWorkspaceRoot(taskDb, args) || process.cwd();
+    const proj = readProjectionFile(wsRoot);
+    if (proj && Array.isArray(proj.tasks)) {
+      task = proj.tasks.find(t => t.id === taskId) || null;
+    }
+  }
   if (!task) {
     failTask('atris task inspect', 'not_found', `task not found: ${ref}`, 1);
   }
@@ -7411,7 +7469,14 @@ function cmdShow(args) {
   const db = taskDb.open();
   const taskId = requireTaskId(taskDb, db, id, 'atris task show');
   const projection = enrichTaskProjection(taskDb.taskProjection(db, { taskId }));
-  const task = projection.tasks[0];
+  let task = projection.tasks[0];
+  if (!task) {
+    const wsRoot = scopedWorkspaceRoot(taskDb, args) || process.cwd();
+    const proj = readProjectionFile(wsRoot);
+    if (proj && Array.isArray(proj.tasks)) {
+      task = proj.tasks.find(t => t.id === taskId) || null;
+    }
+  }
   if (!task) {
     console.error(`task not found: ${id}`);
     process.exit(1);
@@ -7550,7 +7615,14 @@ function cmdReviewChat(args) {
 
 function taskDetail(taskDb, db, taskId) {
   const detailedProjection = taskDb.taskProjection(db, { taskId });
-  const detailedTask = detailedProjection.tasks[0] || null;
+  let detailedTask = detailedProjection.tasks[0] || null;
+  if (!detailedTask) {
+    const wsRoot = taskDb.workspaceRoot ? taskDb.workspaceRoot() : process.cwd();
+    const proj = readProjectionFile(wsRoot);
+    if (proj && Array.isArray(proj.tasks)) {
+      detailedTask = proj.tasks.find(t => t.id === taskId) || null;
+    }
+  }
   if (!detailedTask) return null;
   const workspaceRoot = detailedTask.workspace_root || taskDb.workspaceRoot();
   const contextProjection = enrichTaskProjection(taskDb.taskProjection(db, {
@@ -7558,7 +7630,7 @@ function taskDetail(taskDb, db, taskId) {
     limit: 5000,
   }));
   const enrichedTask = contextProjection.tasks.find(task => task.id === detailedTask.id) || null;
-  if (!enrichedTask) return enrichTaskProjection(detailedProjection).tasks[0] || null;
+  if (!enrichedTask) return enrichTaskProjection(detailedProjection).tasks[0] || detailedTask;
   return {
     ...enrichedTask,
     current_version: detailedTask.current_version,

package/commands/who.js

@@ -0,0 +1,176 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { execFileSync } = require('node:child_process');
+
+const { repoRoot } = require('./stream');
+const {
+  buildWorkforcePresence,
+  isFinishedReceipt,
+  parsePsOutput,
+  receiptEngine,
+  renderWorkforcePresence,
+} = require('../lib/workforce-presence');
+
+function readJson(file, fsModule = fs, fallback = null) {
+  try {
+    return JSON.parse(fsModule.readFileSync(file, 'utf8'));
+  } catch {
+    return fallback;
+  }
+}
+
+function readJsonLines(file, fsModule = fs) {
+  let text;
+  try {
+    text = fsModule.readFileSync(file, 'utf8');
+  } catch {
+    return [];
+  }
+  return String(text)
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .map((line) => {
+      try { return JSON.parse(line); } catch { return null; }
+    })
+    .filter(Boolean);
+}
+
+function collectTasks(root, fsModule = fs) {
+  const payload = readJson(path.join(root, '.atris', 'state', 'tasks.projection.json'), fsModule, {});
+  return Array.isArray(payload?.tasks) ? payload.tasks : [];
+}
+
+function collectMissions(root, fsModule = fs) {
+  const rows = readJsonLines(path.join(root, '.atris', 'state', 'missions.jsonl'), fsModule);
+  const latestById = new Map();
+  for (const row of rows) {
+    const id = String(row?.id || '').trim();
+    if (id) latestById.set(id, row);
+  }
+  return [...latestById.values()];
+}
+
+function collectReceipts(root, fsModule = fs) {
+  const runsDir = path.join(root, 'atris', 'runs');
+  let names;
+  try {
+    names = fsModule.readdirSync(runsDir).filter((name) => name.endsWith('.json')).sort();
+  } catch {
+    return [];
+  }
+  const receipts = [];
+  for (const name of names) {
+    const receiptPath = path.join(runsDir, name);
+    const receipt = readJson(receiptPath, fsModule);
+    if (!receipt || !receiptEngine(receipt)) continue;
+    let mtimeMs = 0;
+    try { mtimeMs = fsModule.statSync(receiptPath).mtimeMs; } catch {}
+    receipts.push({ name, path: receiptPath, mtimeMs, receipt });
+  }
+  return receipts;
+}
+
+function collectProcesses(deps = {}) {
+  if (Array.isArray(deps.processes)) return deps.processes;
+  const execFile = deps.execFile || execFileSync;
+  try {
+    const output = execFile('ps', ['-eo', 'pid=,ppid=,lstart=,command='], {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    return parsePsOutput(output);
+  } catch {
+    return [];
+  }
+}
+
+function collectWorkforcePresence(deps = {}) {
+  const fsModule = deps.fs || fs;
+  const root = deps.root || repoRoot(deps.cwd || process.cwd());
+  const receipts = Array.isArray(deps.receipts) ? deps.receipts : collectReceipts(root, fsModule);
+  return buildWorkforcePresence({
+    nowMs: typeof deps.now === 'function' ? deps.now() : Date.now(),
+    staleAfterMs: deps.staleAfterMs,
+    processes: collectProcesses(deps),
+    tasks: Array.isArray(deps.tasks) ? deps.tasks : collectTasks(root, fsModule),
+    missions: Array.isArray(deps.missions) ? deps.missions : collectMissions(root, fsModule),
+    receipts,
+  });
+}
+
+function archiveFinishedRuns(root, receipts, fsModule = fs) {
+  const archiveDir = path.join(root, 'atris', 'runs', 'archive');
+  const finished = receipts.filter((entry) => isFinishedReceipt(entry.receipt));
+  const summary = {
+    schema: 'atris.workforce_clear.v1',
+    archive_dir: path.relative(root, archiveDir),
+    archived: 0,
+    failed: [],
+  };
+  if (!finished.length) return summary;
+  fsModule.mkdirSync(archiveDir, { recursive: true });
+  for (const entry of finished) {
+    const destination = path.join(archiveDir, entry.name);
+    if (fsModule.existsSync(destination)) {
+      summary.failed.push({ receipt: entry.name, reason: 'archive destination already exists' });
+      continue;
+    }
+    try {
+      fsModule.renameSync(entry.path, destination);
+      summary.archived += 1;
+    } catch (error) {
+      summary.failed.push({ receipt: entry.name, reason: error.message || String(error) });
+    }
+  }
+  return summary;
+}
+
+function helpText() {
+  return [
+    'atris who - show local engines and team members from live process and final run state',
+    '',
+    'usage: atris who [--json]',
+    'usage: atris who --clear [--json]',
+    '',
+    '--clear archives finished run receipts under atris/runs/archive/.',
+  ].join('\n');
+}
+
+function whoCommand(args = [], deps = {}) {
+  const write = deps.write || process.stdout.write.bind(process.stdout);
+  const error = deps.error || process.stderr.write.bind(process.stderr);
+  if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
+    write(`${helpText()}\n`);
+    return 0;
+  }
+  if (args.some((arg) => !['--json', '--clear'].includes(arg))) {
+    error('usage: atris who [--json] [--clear]\n');
+    return 2;
+  }
+
+  const fsModule = deps.fs || fs;
+  const root = deps.root || repoRoot(deps.cwd || process.cwd());
+  const receipts = Array.isArray(deps.receipts) ? deps.receipts : collectReceipts(root, fsModule);
+  if (args.includes('--clear')) {
+    const summary = archiveFinishedRuns(root, receipts, fsModule);
+    if (args.includes('--json')) write(`${JSON.stringify(summary, null, 2)}\n`);
+    else if (summary.failed.length) write(`archived ${summary.archived} finished runs; ${summary.failed.length} could not be archived.\n`);
+    else if (summary.archived) write(`archived ${summary.archived} finished run${summary.archived === 1 ? '' : 's'} in ${summary.archive_dir}.\n`);
+    else write('no finished runs to clear.\n');
+    return summary.failed.length ? 1 : 0;
+  }
+
+  const presence = collectWorkforcePresence({ ...deps, root, receipts });
+  const output = args.includes('--json')
+    ? JSON.stringify(presence, null, 2)
+    : renderWorkforcePresence(presence);
+  write(`${output}\n`);
+  return 0;
+}
+
+module.exports = {
+  whoCommand,
+};