atris 3.63.0 → 3.64.0

package/commands/member.js

@@ -5443,7 +5443,12 @@ function isWikiMinerNoiseName(value) {
   const name = compactSentence(value || '', 120);
   if (!name) return true;
   if (/^[A-Z]{2,}$/.test(name)) return false;
-  return /^(?:i|me|my|mine|myself|we|us|our|ours|ourselves|you|your|yours|yourself|yourselves|he|him|his|himself|she|her|hers|herself|it|its|itself|they|them|their|theirs|themselves|this|that|these|those|the|wiki|mission)$/i.test(name);
+  return /^(?:i|me|my|mine|myself|we|us|our|ours|ourselves|you|your|yours|yourself|yourselves|he|him|his|himself|she|her|hers|herself|it|its|itself|they|them|their|theirs|themselves|this|that|these|those|here|there|where|when|what|who|whom|which|why|how|everything|nothing|something|anything|everyone|anyone|someone|nobody|everybody|anybody|somebody|none|the|wiki|mission)$/i.test(name);
+}
+
+function isWikiMinerSelfLoop(relationship) {
+  const from = lowerCompact(relationship?.from);
+  return from !== '' && from === lowerCompact(relationship?.to);
 }
 
 function normalizeWikiMinerExtraction(raw) {
@@ -5462,7 +5467,7 @@ function normalizeWikiMinerExtraction(raw) {
       to: compactSentence(relationship?.to || '', 120),
       type: allowedRelationTypes.has(String(relationship?.type || '').toLowerCase()) ? String(relationship.type).toLowerCase() : 'uses',
     }))
-    .filter((relationship) => !isWikiMinerNoiseName(relationship.from) && !isWikiMinerNoiseName(relationship.to));
+    .filter((relationship) => !isWikiMinerNoiseName(relationship.from) && !isWikiMinerNoiseName(relationship.to) && !isWikiMinerSelfLoop(relationship));
   return { entities, relationships };
 }
 
@@ -5484,7 +5489,9 @@ function heuristicWikiMinerExtraction(pagePath, pageContent) {
   }
   const entities = [{ type: 'concept', name: title }];
   for (const name of [...candidates].slice(0, 12)) entities.push({ type: /agent|api|sdk|cli|hub|system/i.test(name) ? 'system' : 'concept', name });
-  const relationships = [...candidates].slice(0, 12).map((name) => ({ from: title, to: name, type: 'uses' }));
+  const relationships = [...candidates].slice(0, 12)
+    .map((name) => ({ from: title, to: name, type: 'uses' }))
+    .filter((relationship) => !isWikiMinerSelfLoop(relationship));
   return { entities, relationships };
 }
 
@@ -5538,11 +5545,12 @@ function mergeWikiGraph(graph, extraction, sourcePath) {
 
   const relationshipMap = new Map();
   for (const relationship of graph.relationships || []) {
-    if (isWikiMinerNoiseName(relationship.from) || isWikiMinerNoiseName(relationship.to)) continue;
+    if (isWikiMinerNoiseName(relationship.from) || isWikiMinerNoiseName(relationship.to) || isWikiMinerSelfLoop(relationship)) continue;
     const key = `${lowerCompact(relationship.from)}|${String(relationship.type || 'uses').toLowerCase()}|${lowerCompact(relationship.to)}`;
     relationshipMap.set(key, { ...relationship, sources: Array.isArray(relationship.sources) ? relationship.sources : [] });
   }
   for (const relationship of extraction.relationships || []) {
+    if (isWikiMinerNoiseName(relationship.from) || isWikiMinerNoiseName(relationship.to) || isWikiMinerSelfLoop(relationship)) continue;
     const key = `${lowerCompact(relationship.from)}|${relationship.type}|${lowerCompact(relationship.to)}`;
     const existing = relationshipMap.get(key) || { from: relationship.from, to: relationship.to, type: relationship.type, sources: [] };
     if (sourcePath && !existing.sources.includes(sourcePath)) existing.sources.push(sourcePath);
@@ -5819,7 +5827,6 @@ async function callSupervisorLlm(receipts, logs) {
     const output = { isTTY: false, write() { return true; } };
     const result = await postTurn(supervisorPrompt(receipts, logs), {
       mode: process.env.ATRIS_SUPERVISOR_LLM_MODE || 'fast',
-      route: 'local',
       cwd: process.cwd(),
       output,
       color: false,
@@ -5905,11 +5912,21 @@ async function runSupervisorWake(name, paths, { execute = false } = {}) {
       analysis = normalizeSupervisorAnalysis(llm.analysis, { status: 'ok', llm_source: llm.source });
       if (!analysis) {
         reason = 'llm_json_parse_failed';
-        analysis = emptySupervisorRecommendations({ status: 'parse_error', llm_source: llm.source, llm_error: 'invalid_analysis_shape' });
+        analysis = {
+          ...fallbackSupervisorAnalysis(receipts),
+          status: 'parse_error',
+          llm_source: llm.source,
+          llm_error: 'invalid_analysis_shape',
+        };
       }
     } else if (llm?.error) {
       reason = llm.error === 'invalid_json' ? 'llm_json_parse_failed' : 'llm_analysis_failed';
-      analysis = emptySupervisorRecommendations({ status: llm.error === 'invalid_json' ? 'parse_error' : 'llm_error', llm_source: llm.source, llm_error: llm.error });
+      analysis = {
+        ...fallbackSupervisorAnalysis(receipts),
+        status: llm.error === 'invalid_json' ? 'parse_error' : 'llm_error',
+        llm_source: llm.source,
+        llm_error: llm.error,
+      };
     } else {
       reason = 'llm_not_configured';
       analysis = fallbackSupervisorAnalysis(receipts);
@@ -7351,7 +7368,7 @@ async function runGeneralistWake(name, paths, { execute = false, domainInput = {
     record: domain.ok && proof.status === 'ok',
     libraryBefore: crossDomainLibraryBefore,
     receiptPath,
-    proofPath,
+    proofPath: execute ? proofPath : null,
   });
   proof.learning = {
     library_path: path.relative(root, learning.library_path),
@@ -7782,6 +7799,24 @@ function wakeRuleDirtyMemberScope(ctx) {
   };
 }
 
+// Rule: a goal pinned to a terminal mission must not mint another doomed tick.
+// The goal stays active until a human retires it or revives the mission, so the
+// wake surfaces that decision instead of proposing `member tick --goal` on a
+// dead spine. Unknown mission ids pass through: they may live in a worktree.
+function wakeRuleTerminalMissionGoal(ctx) {
+  const mission = ctx.goalTerminalMission;
+  if (!ctx.goal || !mission) return null;
+  return {
+    decision: 'ask',
+    reason: `goal_mission_terminal:${mission.status}`,
+    needs_user: true,
+    ask: `Goal "${ctx.goal.title}" is pinned to mission ${mission.id} (${mission.status}). Retire the goal or revive the mission, then wake again.`,
+    next_command: `atris member goal-from-mission ${ctx.name}`,
+    goal: ctx.goal,
+    current_experiment: ctx.current || null,
+  };
+}
+
 // Rule: nothing blocks the member, so take the safe next bounded step.
 function wakeRuleSafeBoundedTick(ctx) {
   return {
@@ -7802,6 +7837,7 @@ const WAKE_DECISION_RULES = [
   wakeRuleOpenReviewableProposal,
   wakeRuleScoredNonTickCandidate,
   wakeRuleDirtyMemberScope,
+  wakeRuleTerminalMissionGoal,
   wakeRuleSafeBoundedTick,
 ];
 
@@ -7815,6 +7851,8 @@ function wakeDecision(name, paths, { force = false, runtimeKind = memberRuntimeK
   const steering = readSteeringMemory(paths, name);
   const state = loadMemberGoals(name, paths);
   const goal = activeGoal(state);
+  const pinnedMission = goal?.mission_id ? memberRunMissionMap().get(String(goal.mission_id).trim()) || null : null;
+  const goalTerminalMission = pinnedMission && MISSION_TERMINAL_STATUSES.has(lowerCompact(pinnedMission.status || '')) ? pinnedMission : null;
   const current = memberOpenExperiment(state);
   const generalistDecision = wakeRuleGeneralistDomainFile(name, { purpose, steering, state, goal, current });
   if (generalistDecision) return generalistDecision;
@@ -7860,7 +7898,7 @@ function wakeDecision(name, paths, { force = false, runtimeKind = memberRuntimeK
     next_command: wakeScores.selected.next_command,
   } : null;
 
-  const ctx = { name, force, purpose, nowFile, steering, state, goal, current, blocked, evidence, workspace, checks, wakeScores };
+  const ctx = { name, force, purpose, nowFile, steering, state, goal, goalTerminalMission, current, blocked, evidence, workspace, checks, wakeScores };
   for (const rule of WAKE_DECISION_RULES) {
     const verdict = rule(ctx);
     if (verdict) return composeWakeDecision(ctx, verdict);

package/commands/mission.js

@@ -570,7 +570,7 @@ function applyMissionRunnerProfile(runner) {
 // it only ever takes an explicit pin (the mission's model or the roster
 // line's); '' lets the engine ride its own default.
 // A mission often still carries the claude model it was created with; an
-// engine that runs only its own models (codex) drops it.
+// engine that runs only its own models (codex, grok) drops it.
 const CLAUDE_FAMILY_RUNNER_ENGINES = new Set(['claude', 'fable', 'haiku']);
 
 function resolveMissionTickRunnerModel(mission) {

package/commands/pack-craft.js

@@ -1,8 +1,8 @@
 'use strict';
 
 const fs = require('fs');
-const os = require('os');
 const path = require('path');
+const { stateHome } = require('../lib/state-home');
 
 function slugify(value, fallback = 'atris-pack') {
   return String(value || fallback)
@@ -69,7 +69,7 @@ function isNonEmptyTarget(targetDir) {
 function defaultAuthor() {
   try {
     const creds = JSON.parse(
-      fs.readFileSync(path.join(os.homedir(), '.atris', 'credentials.json'), 'utf8')
+      fs.readFileSync(path.join(stateHome(), '.atris', 'credentials.json'), 'utf8')
     );
     if (creds && typeof creds.email === 'string' && creds.email.trim()) return creds.email.trim();
   } catch {

package/commands/publish.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');
 
@@ -104,7 +104,7 @@ async function publishAtris() {
   }
 
   // Save local copy
-  const localDir = path.join(os.homedir(), '.atris', 'templates', name.toLowerCase().replace(/[^a-z0-9-]/g, '-'));
+  const localDir = path.join(stateHome(), '.atris', 'templates', name.toLowerCase().replace(/[^a-z0-9-]/g, '-'));
   fs.mkdirSync(localDir, { recursive: true });
 
   for (const f of files) {

package/commands/radar.js

@@ -3,6 +3,7 @@
 const fs = require('fs');
 const os = require('os');
 const path = require('path');
+const { stateHome } = require('../lib/state-home');
 const { execFileSync } = require('child_process');
 const { parseScopeFlag, pathUnderRoot } = require('../lib/cli-scope');
 
@@ -346,7 +347,7 @@ function loadBusinessCollaboration(root, deps, team = {}, scorecardCount = count
   const business = readJsonFile(path.join(root, '.atris', 'business.json'), deps, null);
   const runtime = readJsonFile(path.join(root, '.atris', 'state', 'runtime.json'), deps, null);
   const sync = readJsonFile(path.join(root, '.atris', 'state', '_sync.json'), deps, null);
-  const cache = readJsonFile(path.join(deps.homeDir || os.homedir(), '.atris', 'businesses.json'), deps, {}) || {};
+  const cache = readJsonFile(path.join(deps.homeDir || stateHome(), '.atris', 'businesses.json'), deps, {}) || {};
   const slug = business?.slug || sync?.workspace_slug || null;
   const cacheEntry = slug && cache ? cache[slug] : null;
   const hasAtris = deps.exists(path.join(root, 'atris'));
@@ -804,7 +805,7 @@ function collectRadar(options = {}) {
     readlink: options.readlinkSync || fs.readlinkSync,
     readdir: options.readdirSync || fs.readdirSync,
     platform: options.platform || os.platform(),
-    homeDir: options.homeDir || os.homedir(),
+    homeDir: options.homeDir || stateHome(),
   };
   const nowMs = options.nowMs || Date.now();
   const tasks = loadTasks(root, deps);

package/commands/router.js

@@ -2,8 +2,8 @@
 
 const crypto = require('node:crypto');
 const fs = require('node:fs');
-const os = require('node:os');
 const path = require('node:path');
+const { stateHome } = require('../lib/state-home');
 const { spawnSync } = require('node:child_process');
 const { loadOverrides, pickLane } = require('../lib/ax-auto-lane');
 
@@ -28,7 +28,7 @@ function readFirstNamedFlag(args, names) {
 }
 
 function resolveRouterPaths(args = [], env = process.env) {
-  const home = env.HOME || os.homedir();
+  const home = stateHome(env);
   return {
     picks: path.resolve(readFirstNamedFlag(args, ['--picks', '--picks-path'])
       || env.ATRIS_ROUTER_PICKS_PATH

package/commands/task.js

@@ -253,6 +253,8 @@ atris task - durable local task state (SQLite, gitignored)
                                            Sweep off-roadmap/duplicate work as archived (not failed);
                                            --from-failed opts in to relabel a fail-closed row (never done)
   atris task clear-done [--before <days>] [--dry-run] [--json]  Archive completed rows, oldest first
+  atris task prune-test-junk [--yes] [--vacuum] [--json]
+                                           Count rows test runs left from temp folders; --yes backs up the db, then removes them
   atris task keep [--json]                 Put away finished and untouched work, then refresh the list
   atris task reap-mission-blockers [--json] Close blocker rows whose missions are complete or stopped
   atris task relabel-archived [--dry-run|--apply]
@@ -1421,7 +1423,7 @@ function taskReviewSummary(task) {
   const reviewPassCount = Number(metadata.agent_review_pass_count || payload.review_pass_count || 0);
   const agentCertified = metadata.agent_certified === true
     || payload.agent_certified === true
-    || reviewPassCount >= AGENT_CERTIFICATION_REVIEW_PASSES;
+    || (reviewPassCount >= AGENT_CERTIFICATION_REVIEW_PASSES && reviewIntegrity.hasIndependentReview(task));
   const reviewedEventHas = (key) => reviewed && reviewed.event_type === 'reviewed'
     && Object.prototype.hasOwnProperty.call(payload, key);
   const clearedReviewFields = new Set(Array.isArray(payload.cleared_review_fields) ? payload.cleared_review_fields : []);
@@ -8841,7 +8843,7 @@ function taskAllowsReviewChat(task, { allowCertified = false } = {}) {
   if (allowCertified) return true;
   if (review.agent_certified === true || metadata.agent_certified === true) return false;
   const reviewPassCount = Number(review.agent_review_pass_count || metadata.agent_review_pass_count || 0);
-  if (reviewPassCount >= AGENT_CERTIFICATION_REVIEW_PASSES) return false;
+  if (reviewPassCount >= AGENT_CERTIFICATION_REVIEW_PASSES && reviewIntegrity.hasIndependentReview(task)) return false;
   const handoff = reviewHandoffForTask(task, { suppressExistingFollowUp: true });
   return !(handoff && (handoff.next_action === 'continue_work' || handoff.next_action === 'human_accept_waiting'));
 }
@@ -9814,6 +9816,78 @@ function cmdClearDone(args) {
   console.log(`cleared ${candidates.length} completed task(s).`);
 }
 
+function formatBytes(bytes) {
+  const mb = Number(bytes || 0) / (1024 * 1024);
+  return mb >= 1 ? `${mb.toFixed(1)} MB` : `${Math.round(Number(bytes || 0) / 1024)} KB`;
+}
+
+// Test runs that forgot ATRIS_TASKS_DB left rows in the shared database
+// under temp folders. Default is a read-only count; --yes backs up, then
+// removes those rows and their history. Real project rows are never touched.
+function cmdPruneTestJunk(args) {
+  const taskDb = getTaskDb();
+  const prune = require('../lib/task-prune');
+  const dbPath = taskDb.getDbPath();
+  const apply = hasFlag(args, '--yes') && !hasFlag(args, '--dry-run');
+  const vacuum = apply && hasFlag(args, '--vacuum');
+  if (!apply) {
+    const plan = prune.dryRun(dbPath);
+    const { rows, ...summary } = plan;
+    if (wantsJson(args)) {
+      printJson({ ok: true, action: 'prune-test-junk', dry_run: true, ...summary });
+      return;
+    }
+    if (plan.missing) {
+      console.log(`no task database at ${dbPath}. nothing to prune.`);
+      return;
+    }
+    const r = plan.remove;
+    console.log('prune-test-junk dry run: nothing was changed.');
+    console.log(`database: ${dbPath} (${formatBytes(plan.db_bytes)}, ${plan.total_tasks} tasks)`);
+    console.log(`would remove ${r.tasks} test task(s) from temp folders, ${r.history_rows} history row(s), `
+      + `${r.stray_history_rows} stray history row(s), ${r.part_uses} part use row(s).`);
+    for (const g of plan.groups) {
+      console.log(`  ${g.prefix.padEnd(22)} ${String(g.tasks).padStart(7)} tasks  ${String(g.history_rows + g.stray_history_rows).padStart(8)} history rows`);
+    }
+    const k = plan.kept;
+    console.log(`kept: ${k.folder_exists} temp task(s) whose folder still exists, ${k.recent} active in the last ${plan.grace_hours} hour(s), `
+      + `${k.held} with history from a real project, ${k.stray_held + k.stray_recent} leftover history set(s) that are recent or name a real project.`);
+    if (r.tasks || r.stray_history_rows) {
+      console.log('run with --yes to remove them. a backup copy is written next to the database first.');
+    }
+    return;
+  }
+
+  if (vacuum && !wantsJson(args)) {
+    console.log('note: --vacuum rewrites the whole file and needs every other atris process idle; it waits a few seconds, then gives up.');
+  }
+  let result;
+  try {
+    result = prune.applyPrune(dbPath, { vacuum });
+  } catch (err) {
+    failTask('atris task prune-test-junk', 'prune_failed', `prune-test-junk stopped: ${err && err.message || err}`, 1);
+  }
+  if (wantsJson(args)) {
+    printJson({ ok: true, action: 'prune-test-junk', dry_run: false, ...result });
+    return;
+  }
+  if (result.missing) {
+    console.log(`no task database at ${dbPath}. nothing to prune.`);
+    return;
+  }
+  const r = result.removed;
+  console.log(`backup: ${result.backup_path} (${result.backup_tasks} tasks)`);
+  console.log(`removed ${r.tasks} test task(s), ${r.history_rows} history row(s), `
+    + `${r.stray_history_rows} stray history row(s), ${r.part_uses} part use row(s).`);
+  const sk = result.skipped;
+  if (sk.held || sk.changed_since_backup || sk.recent || sk.folder_exists) {
+    console.log(`left ${sk.changed_since_backup} that changed after the backup, ${sk.recent} that became active, `
+      + `${sk.folder_exists} whose folder came back, and ${sk.held} with real-project history.`);
+  }
+  console.log(`database now has ${result.total_tasks} tasks, ${formatBytes(result.bytes_after)} on disk`
+    + (result.vacuumed ? ' after vacuum.' : '. run again with --yes --vacuum to shrink the file.'));
+}
+
 function cmdReapMissionBlockers(args) {
   const taskDb = getTaskDb();
   const db = taskDb.open();
@@ -10468,6 +10542,13 @@ function stampReadyVerifyMetadata(taskDb, db, taskId, verify) {
   if (!row) return;
   const metadata = row.metadata && typeof row.metadata === 'object' ? { ...row.metadata } : {};
   metadata.verify = verify;
+  // A real verify stamped at ready means the creation-time degraded flag is
+  // stale: clear it so `task show` stops warning about a missing check. A
+  // diff-only verify keeps the flag; it still cannot fail on real breakage.
+  if (verify.toLowerCase() !== 'git diff --check') {
+    delete metadata.verification_status;
+    delete metadata.verification_degraded_reason;
+  }
   db.prepare(`
     UPDATE tasks
        SET metadata = ?,
@@ -13374,6 +13455,7 @@ async function runTaskCommand(args) {
     case 'fail':   return cmdDone([...rest, '--failed']);
     case 'archive': return cmdArchive(rest);
     case 'clear-done': return cmdClearDone(rest);
+    case 'prune-test-junk': return cmdPruneTestJunk(rest);
     case 'keep': return cmdKeep(rest);
     case 'reap-mission-blockers':
     case 'reap-blockers':

package/commands/transactions.js

@@ -5,8 +5,8 @@
 
 const { apiRequestJson } = require('../utils/api');
 const { loadCredentials } = require('../utils/auth');
-const { NOT_LOGGED_IN, tokenFrom, oneLine, printResult } = require('../lib/developer-api');
-const { parseFlags, formatCents, errorFrom } = require('../lib/commerce');
+const { NOT_LOGGED_IN, oneLine, printResult } = require('../lib/developer-api');
+const { parseFlags, formatCents, errorFrom, commerceToken } = require('../lib/commerce');
 
 const TX_KINDS = ['ticket', 'shop', 'flight', 'test_purchase', 'fee', 'trade', 'wallet_send'];
 
@@ -98,7 +98,7 @@ async function transactionsCommand(args = [], deps = {}) {
 
   const load = deps.loadCredentials || loadCredentials;
   const request = deps.apiRequestJson || apiRequestJson;
-  const token = tokenFrom(load());
+  const token = commerceToken(load(), 'transactions:read', deps.now ? deps.now() : Date.now());
   if (!token) return fail(NOT_LOGGED_IN);
 
   try {

package/commands/truth.js

@@ -7,7 +7,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const os = require('os');
+const { stateHome } = require('../lib/state-home');
 const { execFileSync } = require('child_process');
 const taskDb = require('../lib/task-db');
 const { parseScopeFlag } = require('../lib/cli-scope');
@@ -172,7 +172,7 @@ function loadFeatures(cwd) {
 }
 
 function loadHeartbeats() {
-  const hbDir = path.join(os.homedir(), '.atris', 'heartbeat');
+  const hbDir = path.join(stateHome(), '.atris', 'heartbeat');
   const registry = readJson(path.join(hbDir, 'registry.json'));
   const state = readJson(path.join(hbDir, 'state.json')) || {};
   if (!registry || !Array.isArray(registry.jobs)) return [];

package/commands/x-search.js

@@ -4,7 +4,9 @@ const fs = require('fs');
 const path = require('path');
 const { apiRequestJson } = require('../utils/api');
 const { ensureBilledCommandAuth } = require('./auth');
+const { spawnSync } = require('child_process');
 const applyGate = require('../lib/apply-gate');
+const { checkXPosts, annotateContent, formatTally } = require('../lib/x-post-check');
 const {
   fileTeachExperiment,
   extractTeachNumbers,
@@ -23,9 +25,10 @@ const KEEP_RULE = 'keep only if measure.py moves 0→1. scores 1 only when the f
 
 function showXSearchHelp(output = console.log, commandName = 'atris x-search') {
   output('');
-  output(`Usage: ${commandName} "<query>" [--limit N] [--days N] [--save] [--json]`);
-  output(`       ${commandName} person --name <name> [--handle <h>] [--company <c>] [--context <text>] [--save] [--json]`);
+  output(`Usage: ${commandName} "<query>" [--limit N] [--days N] [--save] [--json] [--no-check]`);
+  output(`       ${commandName} person --name <name> [--handle <h>] [--company <c>] [--context <text>] [--save] [--json] [--no-check]`);
   output(`       ${commandName} unsave <query-or-source>`);
+  output(`       ${commandName} bench [--quick|--free]`);
   output('');
   output(`Search X/Twitter via Atris (${COST_HINT}).`);
   output('Requires login. Same auth path as atris youtube process.');
@@ -33,13 +36,15 @@ function showXSearchHelp(output = console.log, commandName = 'atris x-search') {
   output('--save files a brief only when the result is rich.');
   output('unsave deletes the filed brief, apply stub, and matching experiment pack (no paid calls).');
   output('Empty or failed search prints credits refunded only when the server marks a refund.');
+  output('Each quoted post is looked up on X for free and marked checked, unverified, or unknown.');
   output('');
   output('Options:');
   output('  --limit <n>         Max results hint (search only)');
   output('  --days <n>          Only tweets from the last N days (search only)');
   output('  --save              File brief, journal, apply; rich results mint a keep/revert experiment');
   output('  --unsave            Delete filed brief, apply stub, and matching experiment pack (no paid calls)');
-  output('  --json              Print the raw JSON response');
+  output('  --json              Print the raw JSON response (plus a checks list)');
+  output('  --no-check          Skip looking up the quoted posts on X');
   output('  -h, --help          This help');
   output('');
   output('Person options:');
@@ -55,6 +60,7 @@ function showXSearchHelp(output = console.log, commandName = 'atris x-search') {
   output(`  ${commandName} person --name "Leah Bonvissuto" --handle leahbon`);
   output(`  ${commandName} unsave "MCP agents"`);
   output(`  ${commandName} --unsave "MCP agents"`);
+  output(`  ${commandName} bench --free`);
   output('');
 }
 
@@ -81,6 +87,7 @@ function parseSearchArgs(argv = []) {
     json: false,
     save: false,
     unsave: false,
+    check: true,
     query: null,
     limit: null,
     daysBack: null,
@@ -100,6 +107,8 @@ function parseSearchArgs(argv = []) {
       options.json = true;
     } else if (arg === '--save') {
       options.save = true;
+    } else if (arg === '--no-check') {
+      options.check = false;
     } else if (arg === '--unsave') {
       options.unsave = true;
     } else if (arg === '--limit') {
@@ -153,6 +162,7 @@ function parsePersonArgs(argv = []) {
     help: false,
     json: false,
     save: false,
+    check: true,
     name: null,
     handle: null,
     company: null,
@@ -173,6 +183,8 @@ function parsePersonArgs(argv = []) {
       options.json = true;
     } else if (arg === '--save') {
       options.save = true;
+    } else if (arg === '--no-check') {
+      options.check = false;
     } else if (arg === '--name') {
       options.name = readValue(args, i, arg);
       i++;
@@ -592,23 +604,26 @@ function ensureXSearchApply({ cwd, source, packRel, now, output } = {}) {
   });
 }
 
-function formatXSearchResult(data) {
+// check is the result of checkXPosts. With it, each post carries its own
+// link or warning, and citations no post uses are listed as other sources.
+function formatXSearchResult(data, check = null) {
   const lines = [];
   const content = xSearchContent(data);
   const citations = xSearchCitations(data);
 
   if (content) {
-    lines.push(content);
+    lines.push(check ? annotateContent(content, check) : content);
   } else if (data?.message) {
     lines.push(String(data.message).trim());
   } else {
     lines.push('X search completed');
   }
 
-  if (citations.length) {
+  const listed = check ? check.otherSources : citations;
+  if (listed.length) {
     lines.push('');
-    lines.push('Citations:');
-    for (const cite of citations) {
+    lines.push(check ? 'Other sources:' : 'Citations:');
+    for (const cite of listed) {
       lines.push(`  ${cite}`);
     }
   }
@@ -619,9 +634,54 @@ function formatXSearchResult(data) {
     lines.push(...creditLines);
   }
 
+  if (check) {
+    lines.push('');
+    lines.push(formatTally(check.tally));
+  }
+
   return lines.join('\n');
 }
 
+// Look the quoted posts up on X. Free, and never fatal: any failure means no
+// check, and the original output prints unchanged.
+async function checkXSearchPosts(data, options, deps = {}) {
+  if (options.check === false) return null;
+  try {
+    return await (deps.checkXPosts || checkXPosts)({
+      content: xSearchContent(data),
+      citations: xSearchCitations(data),
+      fetchPost: deps.fetchPost,
+      fetch: deps.fetch,
+    });
+  } catch {
+    return null;
+  }
+}
+
+function renderXSearchResult(data, check) {
+  if (check) {
+    try {
+      return formatXSearchResult(data, check);
+    } catch {
+      // fall through to the original output
+    }
+  }
+  return formatXSearchResult(data);
+}
+
+function runXSearchBench(argv, deps = {}) {
+  const run = (deps.spawnSync || spawnSync)(
+    process.execPath,
+    [path.join(__dirname, '..', 'scripts', 'det', 'xsearch-bench.js'), ...argv],
+    { stdio: 'inherit' },
+  );
+  if (run.error) {
+    (deps.output || console.error)(`bench did not start: ${run.error.message}`);
+    return 1;
+  }
+  return typeof run.status === 'number' ? run.status : 1;
+}
+
 function formatEmptyXSearchResult(data) {
   const lines = ['no results'];
   const creditLines = formatCreditsLines(xSearchCredits(data));
@@ -634,6 +694,11 @@ function formatEmptyXSearchResult(data) {
 
 async function xSearchCommand(argv = process.argv.slice(3), deps = {}) {
   const output = deps.output || ((line = '') => console.log(line));
+  if (argv[0] === 'bench') {
+    const code = runXSearchBench(argv.slice(1), deps);
+    if (!deps.output && !deps.spawnSync) process.exit(code);
+    return code;
+  }
   let options;
   try {
     options = parseXSearchArgs(argv);
@@ -655,10 +720,14 @@ async function xSearchCommand(argv = process.argv.slice(3), deps = {}) {
   try {
     const data = await runXSearch(options, deps);
     const hasResults = xSearchHasResults(data);
+    const check = hasResults ? await checkXSearchPosts(data, options, deps) : null;
     if (options.json) {
-      output(JSON.stringify(data, null, 2));
+      const withChecks = check && data && typeof data === 'object' && !Array.isArray(data)
+        ? { ...data, checks: check.checks }
+        : data;
+      output(JSON.stringify(withChecks, null, 2));
     } else {
-      output(hasResults ? formatXSearchResult(data) : formatEmptyXSearchResult(data));
+      output(hasResults ? renderXSearchResult(data, check) : formatEmptyXSearchResult(data));
     }
     if (!hasResults) {
       if (
@@ -734,5 +803,7 @@ module.exports = {
   xSearchExperimentSlug,
   xSearchExperimentRel,
   unsaveXSearch,
+  formatXSearchResult,
+  runXSearchBench,
   xSearchCommand,
 };

package/commands/youtube.js

@@ -5,6 +5,7 @@ const { spawnSync } = require('child_process');
 const fs = require('fs');
 const os = require('os');
 const path = require('path');
+const { stateHome } = require('../lib/state-home');
 const https = require('https');
 
 const YTNOTES_USAGE = 'usage: ytnotes <youtube-url> [youtube-url-or-playlist...] [auto|gemini|haiku|atris-fast|grok|codex|cursor]';
@@ -2256,7 +2257,7 @@ function searchCacheTtlMs(deps = {}) {
 
 function resolveSearchCachePath(deps = {}) {
   if (deps.searchCachePath) return deps.searchCachePath;
-  const homeDir = deps.homeDir || os.homedir();
+  const homeDir = deps.homeDir || stateHome();
   return path.join(homeDir, '.atris', LOCAL_SEARCH_CACHE_FILE);
 }
 

package/lib/autoland.js

@@ -7,6 +7,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const { stateHome } = require('./state-home');
 const os = require('os');
 const { spawnSync } = require('child_process');
 const { computeTrustTier } = require('./trust-tiers');
@@ -189,7 +190,7 @@ function buildCronLine(root) {
   const node = process.execPath;
   const bin = path.join(root, 'bin', 'atris.js');
   const cliBin = fs.existsSync(bin) ? bin : 'atris';
-  const logDir = path.join(os.homedir(), '.atris', 'overnight');
+  const logDir = path.join(stateHome(), '.atris', 'overnight');
   const logFile = path.join(logDir, `autoland-${path.basename(root)}.log`);
   const invoke = cliBin.endsWith('.js') ? `${node} ${cliBin}` : cliBin;
   return `14 * * * * cd ${root} && ${invoke} autoland tick >> ${logFile} 2>&1 # ${cronMarker(root)}`;
@@ -210,7 +211,7 @@ function cronInstalled(root) {
 }
 
 function installCron(root) {
-  fs.mkdirSync(path.join(os.homedir(), '.atris', 'overnight'), { recursive: true });
+  fs.mkdirSync(path.join(stateHome(), '.atris', 'overnight'), { recursive: true });
   const marker = cronMarker(root);
   const kept = readCrontab().split(/\r?\n/).filter((line) => line.trim() && !line.includes(marker));
   const next = `${kept.join('\n')}${kept.length ? '\n' : ''}${buildCronLine(root)}\n`;

package/lib/ax-auto-lane.js

@@ -1,8 +1,8 @@
 'use strict';
 
 const fs = require('node:fs');
-const os = require('node:os');
 const path = require('node:path');
+const { stateHome } = require('./state-home');
 
 const SHORT_LOOKUP_MAX_CHARS = 140;
 const LONG_INPUT_MIN_CHARS = 1200;
@@ -75,7 +75,7 @@ function overrideMatches(text, override) {
 function loadOverrides(filePath) {
   const resolved = filePath
     || process.env.ATRIS_ROUTER_OVERRIDES_PATH
-    || path.join(os.homedir(), '.atris', 'router-overrides.json');
+    || path.join(stateHome(), '.atris', 'router-overrides.json');
   try {
     const parsed = JSON.parse(fs.readFileSync(resolved, 'utf8'));
     return Array.isArray(parsed) ? parsed : [];