atris 3.16.1 → 3.17.0

package/commands/pulse.js

@@ -0,0 +1,504 @@
+'use strict';
+
+// `atris pulse` — the durable overnight self-improvement heartbeat for atris-cli.
+//
+//   atris pulse tick      run ONE self-improvement tick (what the cron calls)
+//   atris pulse status    liveness, reward sum, ghost-tick detection
+//   atris pulse install   write the OS-cron tick script + install the crontab line
+//   atris pulse uninstall remove the crontab line
+//   atris pulse run       run N ticks in the foreground (manual / testing)
+//
+// One tick: lock -> 'started' receipt -> run mission engine -> verify -> write
+// 'finished' receipt (pulse_agi_loop_receipts.jsonl) + reward scorecard
+// (scorecards.jsonl, gated) -> release lock. The whole point is that this fires
+// from an OS cron, so it self-improves overnight without Claude Code open.
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const pulse = require('../lib/pulse');
+
+function hasFlag(args, name) {
+  return args.includes(name);
+}
+function readFlag(args, name, fallback = null) {
+  const i = args.indexOf(name);
+  if (i === -1 || i === args.length - 1) return fallback;
+  return args[i + 1];
+}
+function wantsJson(args) {
+  return hasFlag(args, '--json');
+}
+
+function helpText() {
+  return `
+Usage: atris pulse <tick|status|install|uninstall|run> [options]
+
+Durable overnight self-improvement heartbeat.
+
+Commands:
+  tick        Run one heartbeat tick
+  status      Show liveness, reward, and ghost-tick detection
+  install     Install the OS cron heartbeat
+  uninstall   Remove the OS cron heartbeat
+  run         Run bounded ticks in the foreground
+
+Options:
+  --json                 Print machine-readable output
+  --no-claude            Do not spawn Claude-backed mission work
+  --no-verify            Skip verifier command
+  --verify "<cmd>"       Verifier for changed-work ticks (default: npm test)
+  --cadence "<cron>"     Cron cadence for install
+  --days <n>             Auto-expire installed heartbeat after n days
+  --model <id>           Runner model alias/id for installed heartbeat
+  --runner-profile <n>   Runner profile for installed heartbeat (e.g. atris-fast)
+  --runner-bin <path>    Runner binary for installed heartbeat
+  --runner-template <s>  Runner command template for installed heartbeat
+  --max-ticks <n>        Number of foreground ticks for run
+  --help, -h             Show this help
+`.trim();
+}
+
+function showHelp() {
+  process.stdout.write(`${helpText()}\n`);
+  return { ok: true, action: 'pulse_help' };
+}
+
+function emit(obj, asJson) {
+  if (asJson) {
+    process.stdout.write(`${JSON.stringify(obj, null, 2)}\n`);
+  }
+  return obj;
+}
+
+const STATE_HOME = path.join(os.homedir(), '.atris', 'overnight', 'atris-cli-self-improve');
+
+// --- engine: run one mission-run-due tick via the real CLI ---
+
+function runMissionEngine(root, { noClaude = false, timeoutMs = 600000 } = {}) {
+  const cliPath = path.join(__dirname, '..', 'bin', 'atris.js');
+  const args = ['mission', 'run', '--due', '--max-ticks', '1', '--complete-on-pass', '--json'];
+  if (noClaude) args.push('--no-claude');
+  const result = spawnSync(process.execPath, [cliPath, ...args], {
+    cwd: root,
+    encoding: 'utf8',
+    timeout: timeoutMs,
+    env: { ...process.env, ATRIS_SKIP_UPDATE_CHECK: '1' },
+  });
+  let payload = null;
+  try {
+    payload = JSON.parse(result.stdout || '{}');
+  } catch {}
+  // Map the mission-run result to a normalized actor outcome.
+  const reason = payload && payload.reason ? payload.reason
+    : (result.status === 0 ? 'completed' : 'error');
+  return {
+    actor: 'mission_run_due',
+    ok: result.status === 0,
+    reason, // 'completed' | 'no_due_mission' | 'error' | ...
+    status: result.status,
+    payload,
+    stdout: String(result.stdout || '').slice(-2000),
+    stderr: String(result.stderr || '').slice(-2000),
+  };
+}
+
+// Fallback worker: one headless autopilot tick. This is the path that reaches
+// proposeCandidateHorizons — i.e. where the member AUTHORS a new goal when no
+// mission is due, instead of idling.
+function runAutopilotTick(root, { timeoutMs = 600000 } = {}) {
+  const cliPath = path.join(__dirname, '..', 'bin', 'atris.js');
+  const args = ['autopilot', '--auto', '--iterations=1'];
+  const result = spawnSync(process.execPath, [cliPath, ...args], {
+    cwd: root,
+    encoding: 'utf8',
+    timeout: timeoutMs,
+    env: { ...process.env, ATRIS_SKIP_UPDATE_CHECK: '1' },
+  });
+  return {
+    actor: 'autopilot',
+    ok: result.status === 0,
+    reason: result.status === 0 ? 'completed' : 'error',
+    status: result.status,
+    stdout: String(result.stdout || '').slice(-2000),
+    stderr: String(result.stderr || '').slice(-2000),
+  };
+}
+
+// The full heartbeat composition: continue a due mission, else author+pursue a
+// new goal via autopilot. This is the /loop skill's logic, encoded for OS cron.
+function runEngine(root, { noClaude = false, autopilotFallback = true, timeoutMs = 600000 } = {}) {
+  const mission = runMissionEngine(root, { noClaude, timeoutMs });
+  if (pulse.shouldFallbackToAutopilot({ missionReason: mission.reason, autopilotFallback, noClaude })) {
+    const ap = runAutopilotTick(root, { timeoutMs });
+    return { ...ap, fell_back_from: 'no_due_mission' };
+  }
+  return mission;
+}
+
+function gitChangedFiles(root) {
+  try {
+    const r = spawnSync('git', ['-C', root, 'status', '--porcelain'], { encoding: 'utf8', timeout: 15000 });
+    if (r.status !== 0) return [];
+    return String(r.stdout || '')
+      .split('\n')
+      .map((l) => l.slice(3).trim())
+      .filter(Boolean);
+  } catch {
+    return [];
+  }
+}
+
+// A cheap snapshot of the working tree: current HEAD + the set of dirty files.
+// Comparing two snapshots gives a tick's ACTUAL contribution (a new commit, or
+// files it newly dirtied) — never the whole pre-existing dirty tree.
+function gitSnapshot(root) {
+  let head = null;
+  try {
+    const r = spawnSync('git', ['-C', root, 'rev-parse', 'HEAD'], { encoding: 'utf8', timeout: 15000 });
+    if (r.status === 0) head = String(r.stdout || '').trim();
+  } catch {}
+  return { head, dirty: new Set(gitChangedFiles(root)) };
+}
+
+function runVerify(root, verifyCmd, timeoutMs = 600000) {
+  if (!verifyCmd) return { passed: null, cmd: null };
+  const r = spawnSync(verifyCmd, {
+    cwd: root,
+    shell: true,
+    encoding: 'utf8',
+    timeout: timeoutMs,
+    env: { ...process.env, ATRIS_SKIP_UPDATE_CHECK: '1', ATRIS_AGENT_PROOF_ONLY: '0' },
+  });
+  return { passed: r.status === 0, cmd: verifyCmd, status: r.status };
+}
+
+// --- atris pulse tick ---
+
+function tickCommand(args, root = process.cwd()) {
+  const asJson = wantsJson(args);
+  const noClaude = hasFlag(args, '--no-claude');
+  const noVerify = hasFlag(args, '--no-verify');
+  const verifyCmd = noVerify ? null : readFlag(args, '--verify', 'npm test');
+  const startedAt = Date.now();
+
+  // Detect a previous tick that died mid-run before we take the lock.
+  const priorReceipts = pulse.readPulseReceipts(root);
+  const priorStale = pulse.detectStaleTick(priorReceipts);
+
+  const lock = pulse.acquireLock(root);
+  if (!lock.acquired) {
+    const out = { ok: false, action: 'pulse_tick', skipped: true, reason: 'locked', age_ms: lock.ageMs };
+    if (!asJson) process.stdout.write('pulse: previous tick still running; skipped.\n');
+    return emit(out, asJson);
+  }
+
+  const tickIndex = pulse.nextTickIndex(root);
+
+  // 'started' receipt — if the tick dies after this, the orphan surfaces as a ghost.
+  pulse.appendPulseReceipt(root, pulse.buildPulseReceipt({
+    tickIndex,
+    phase: 'started',
+    prevTickStale: priorStale.stale,
+  }));
+
+  let engine;
+  let verify = { passed: null, cmd: verifyCmd };
+  try {
+    const before = gitSnapshot(root);
+    engine = runEngine(root, { noClaude, autopilotFallback: !hasFlag(args, '--no-autopilot') });
+    const after = gitSnapshot(root);
+    // This tick's ACTUAL contribution: files it newly dirtied, or a new commit.
+    // Pre-existing dirt is excluded so reward isn't re-credited every tick.
+    const changedFiles = [...after.dirty].filter((f) => !before.dirty.has(f));
+    const committed = Boolean(before.head && after.head && before.head !== after.head);
+    const producedWork = committed || changedFiles.length > 0;
+
+    // Verify only matters when the tick produced work; a no-op tick skips it.
+    if (producedWork && verifyCmd) {
+      verify = runVerify(root, verifyCmd);
+    } else if (verifyCmd) {
+      verify = { passed: null, cmd: verifyCmd, skipped: true };
+    }
+
+    const elapsedMs = Date.now() - startedAt;
+    const reward = pulse.scoreTick({ verifyPassed: verify.passed, producedWork });
+    const changedTail = committed
+      ? ' — committed'
+      : (changedFiles.length ? ` — ${changedFiles.length} file(s) changed` : '');
+    const what = engine.actor === 'autopilot'
+      ? `autopilot authored/advanced a goal${changedTail}`
+      : engine.reason === 'no_due_mission'
+        ? 'no due mission; heartbeat alive (no-op)'
+        : `mission ${engine.reason}${changedTail}`;
+
+    const receipt = pulse.buildPulseReceipt({
+      tickIndex,
+      phase: 'finished',
+      actor: engine.actor,
+      actorOk: engine.ok,
+      actorReason: engine.reason,
+      verifyCmd: verify.cmd,
+      verifyPassed: verify.passed,
+      changedFiles,
+      what,
+      elapsedMs,
+      prevTickStale: priorStale.stale,
+      reward,
+    });
+    pulse.appendPulseReceipt(root, receipt);
+
+    // Revive the reward channel — but only when there is signal (gate noise).
+    let scorecardWritten = false;
+    if (pulse.shouldWriteScorecard({ reward })) {
+      pulse.appendScorecard(root, pulse.buildPulseScorecardRow({
+        reward,
+        verifyPassed: verify.passed,
+        what,
+        changedFiles,
+        elapsedMs,
+        model: process.env.ATRIS_RUNNER_MODEL || process.env.ATRIS_CLAUDE_MODEL || 'opus',
+      }));
+      scorecardWritten = true;
+    }
+
+    const out = {
+      ok: true,
+      action: 'pulse_tick',
+      tick_index: tickIndex,
+      actor: engine.actor,
+      actor_reason: engine.reason,
+      verify_passed: verify.passed,
+      reward,
+      scorecard_written: scorecardWritten,
+      changed_files: changedFiles,
+      prev_tick_stale: priorStale.stale,
+      elapsed_ms: elapsedMs,
+      receipts_path: pulse.pulseReceiptsPath(root),
+    };
+    if (!asJson) {
+      const ghost = priorStale.stale ? ` (recovered ghost tick #${priorStale.tick_index || '?'})` : '';
+      const r = reward > 0 ? `+${reward}` : String(reward);
+      process.stdout.write(`pulse tick #${tickIndex}: ${what} — verify ${verify.passed === null ? 'n/a' : verify.passed ? 'pass' : 'FAIL'} — reward ${r}${ghost}\n`);
+    }
+    return emit(out, asJson);
+  } catch (err) {
+    // Surface the death instead of leaving a silent orphan 'started' receipt.
+    pulse.appendPulseReceipt(root, pulse.buildPulseReceipt({
+      tickIndex,
+      phase: 'finished',
+      actor: 'mission_run_due',
+      actorOk: false,
+      actorReason: 'error',
+      what: `tick crashed: ${err && err.message ? err.message : String(err)}`,
+      elapsedMs: Date.now() - startedAt,
+      reward: -1,
+    }));
+    const out = { ok: false, action: 'pulse_tick', tick_index: tickIndex, error: err && err.message ? err.message : String(err) };
+    if (!asJson) process.stdout.write(`pulse tick #${tickIndex} crashed: ${out.error}\n`);
+    return emit(out, asJson);
+  } finally {
+    pulse.releaseLock(root);
+  }
+}
+
+// --- atris pulse status ---
+
+function cronInstalled(marker = pulse.PULSE_MARKER) {
+  try {
+    const r = spawnSync('crontab', ['-l'], { encoding: 'utf8', timeout: 10000 });
+    if (r.status !== 0) return false;
+    return String(r.stdout || '').includes(marker);
+  } catch {
+    return false;
+  }
+}
+
+function statusCommand(args, root = process.cwd()) {
+  const asJson = wantsJson(args);
+  const receipts = pulse.readPulseReceipts(root);
+  const summary = pulse.summarizePulse(receipts);
+  const installed = cronInstalled();
+  const out = {
+    ok: true,
+    action: 'pulse_status',
+    cron_installed: installed,
+    ...summary,
+  };
+  if (!asJson) {
+    process.stdout.write([
+      `pulse: ${installed ? 'cron INSTALLED' : 'cron NOT installed (run: atris pulse install)'}`,
+      `ticks: ${summary.total_ticks} | reward: ${summary.reward_sum} | verify pass/fail: ${summary.verify_pass}/${summary.verify_fail}`,
+      `last tick: ${summary.last_tick_ts || 'never'} (verify ${summary.last_verify_passed === null ? 'n/a' : summary.last_verify_passed ? 'pass' : 'FAIL'})`,
+      summary.stale.stale ? `⚠ STALE: ${summary.stale.reason}${summary.stale.tick_index ? ` (ghost tick #${summary.stale.tick_index})` : ''}` : 'liveness: fresh',
+      summary.orphan_ticks.length ? `⚠ orphan (crashed) ticks: ${summary.orphan_ticks.join(', ')}` : '',
+    ].filter(Boolean).join('\n') + '\n');
+  }
+  return emit(out, asJson);
+}
+
+// --- atris pulse install / uninstall ---
+
+function resolveAtrisBin() {
+  // Prefer a globally linked `atris`; fall back to this checkout's bin.
+  const which = spawnSync('which', ['atris'], { encoding: 'utf8', timeout: 8000 });
+  if (which.status === 0 && which.stdout.trim()) return which.stdout.trim();
+  return `${process.execPath} ${path.join(__dirname, '..', 'bin', 'atris.js')}`;
+}
+
+// The dirs holding the binaries the engine spawns by bare name (claude, node,
+// git, atris). Baked into the cron script's PATH so a minimal cron environment
+// can still find them. Missing tools just contribute nothing.
+function resolveEngineBinDirs(extraBins = []) {
+  const dirs = new Set([path.dirname(process.execPath)]); // node
+  for (const tool of ['ax', 'claude', 'git', 'atris']) {
+    const r = spawnSync('which', [tool], { encoding: 'utf8', timeout: 8000 });
+    if (r.status === 0 && r.stdout.trim()) dirs.add(path.dirname(r.stdout.trim()));
+  }
+  for (const bin of [process.env.ATRIS_RUNNER_BIN, process.env.ATRIS_CLAUDE_BIN, ...extraBins]) {
+    const configured = String(bin || '').trim();
+    if (configured && configured.includes(path.sep)) dirs.add(path.dirname(configured));
+    if (configured && !configured.includes(path.sep)) {
+      const r = spawnSync('which', [configured], { encoding: 'utf8', timeout: 8000 });
+      if (r.status === 0 && r.stdout.trim()) dirs.add(path.dirname(r.stdout.trim()));
+    }
+  }
+  dirs.add(path.join(os.homedir(), '.local', 'bin')); // common claude location
+  return Array.from(dirs);
+}
+
+function installCommand(args, root = process.cwd()) {
+  const asJson = wantsJson(args);
+  const cron = readFlag(args, '--cadence', pulse.DEFAULT_CADENCE_CRON);
+  const days = Math.max(1, Number(readFlag(args, '--days', '7')) || 7);
+  const verifyCmd = readFlag(args, '--verify', 'npm test');
+  const model = readFlag(args, '--model', process.env.ATRIS_RUNNER_MODEL || process.env.ATRIS_CLAUDE_MODEL || 'opus');
+  const runnerProfile = readFlag(args, '--runner-profile', process.env.ATRIS_RUNNER_PROFILE || '');
+  const runnerBin = readFlag(args, '--runner-bin', process.env.ATRIS_RUNNER_BIN || process.env.ATRIS_CLAUDE_BIN || '');
+  const runnerCommandTemplate = readFlag(args, '--runner-template', process.env.ATRIS_RUNNER_COMMAND_TEMPLATE || process.env.ATRIS_CLAUDE_COMMAND_TEMPLATE || '');
+  const deadlineEpoch = Math.floor(Date.now() / 1000) + days * 86400;
+
+  fs.mkdirSync(STATE_HOME, { recursive: true });
+  const scriptPath = path.join(STATE_HOME, 'tick.sh');
+  // Resolve the real bin dirs the engine spawns by bare name, so cron's minimal
+  // PATH doesn't silently break the worker spawn (claude lives in ~/.local/bin).
+  const pathDirs = resolveEngineBinDirs([runnerBin]);
+  const script = pulse.buildTickScript({
+    root,
+    atrisBin: resolveAtrisBin(),
+    stateHome: STATE_HOME,
+    deadlineEpoch,
+    model,
+    runnerProfile,
+    runnerBin,
+    runnerCommandTemplate,
+    verifyCmd,
+    pathDirs,
+  });
+  fs.writeFileSync(scriptPath, script, { mode: 0o755 });
+
+  const line = pulse.buildCrontabLine({ cron, scriptPath });
+  // Append our line to the existing crontab (idempotent: strip any prior marker first).
+  const existing = spawnSync('crontab', ['-l'], { encoding: 'utf8', timeout: 10000 });
+  const prior = existing.status === 0 ? String(existing.stdout || '') : '';
+  const cleaned = prior.split('\n').filter((l) => l && !l.includes(pulse.PULSE_MARKER)).join('\n');
+  const next = `${cleaned ? cleaned + '\n' : ''}${line}\n`;
+  const apply = spawnSync('crontab', ['-'], { input: next, encoding: 'utf8', timeout: 10000 });
+
+  const out = {
+    ok: apply.status === 0,
+    action: 'pulse_install',
+    script_path: scriptPath,
+    crontab_line: line,
+    cadence: cron,
+    expires_in_days: days,
+    deadline_epoch: deadlineEpoch,
+    runner_profile: runnerProfile || null,
+    runner_bin: runnerBin || null,
+    runner_template_configured: Boolean(runnerCommandTemplate),
+  };
+  if (!asJson) {
+    if (apply.status === 0) {
+      process.stdout.write([
+        `pulse installed. heartbeat fires '${cron}' against ${root}.`,
+        `script: ${scriptPath}`,
+        `auto-expires in ${days} days. stop early: atris pulse uninstall`,
+      ].join('\n') + '\n');
+    } else {
+      process.stdout.write(`pulse install failed to write crontab: ${apply.stderr || apply.status}\nscript written to ${scriptPath}; add this line to your crontab manually:\n${line}\n`);
+    }
+  }
+  return emit(out, asJson);
+}
+
+function uninstallCommand(args) {
+  const asJson = wantsJson(args);
+  const existing = spawnSync('crontab', ['-l'], { encoding: 'utf8', timeout: 10000 });
+  if (existing.status !== 0) {
+    const out = { ok: true, action: 'pulse_uninstall', removed: false, reason: 'no_crontab' };
+    if (!asJson) process.stdout.write('pulse: no crontab to clean.\n');
+    return emit(out, asJson);
+  }
+  const prior = String(existing.stdout || '');
+  const had = prior.includes(pulse.PULSE_MARKER);
+  const cleaned = prior.split('\n').filter((l) => l && !l.includes(pulse.PULSE_MARKER)).join('\n');
+  const apply = spawnSync('crontab', ['-'], { input: cleaned ? cleaned + '\n' : '', encoding: 'utf8', timeout: 10000 });
+  const out = { ok: apply.status === 0, action: 'pulse_uninstall', removed: had };
+  if (!asJson) process.stdout.write(had ? 'pulse uninstalled (crontab line removed).\n' : 'pulse: no heartbeat line found.\n');
+  return emit(out, asJson);
+}
+
+// --- atris pulse run (foreground N ticks) ---
+
+function runCommand(args, root = process.cwd()) {
+  const asJson = wantsJson(args);
+  const maxTicks = Math.max(1, Number(readFlag(args, '--max-ticks', '1')) || 1);
+  const passthrough = args.filter((a) => a !== '--max-ticks' && a !== String(maxTicks));
+  const results = [];
+  for (let i = 0; i < maxTicks; i++) {
+    results.push(tickCommand(passthrough.concat(['--json-silent']).filter((a) => a !== '--json'), root));
+  }
+  const out = { ok: true, action: 'pulse_run', ticks: results.length, results };
+  return emit(out, asJson);
+}
+
+function pulseCommand(argv = []) {
+  const sub = argv[0];
+  const rest = argv.slice(1);
+  if (sub === '--help' || sub === '-h' || sub === 'help') return showHelp();
+  switch (sub) {
+    case 'tick':
+      return tickCommand(rest);
+    case 'status':
+    case undefined:
+      return statusCommand(rest);
+    case 'install':
+      return installCommand(rest);
+    case 'uninstall':
+      return uninstallCommand(rest);
+    case 'run':
+      return runCommand(rest);
+    default: {
+      const asJson = wantsJson(rest);
+      const out = { ok: false, action: 'pulse', error: `unknown subcommand: ${sub}`, usage: 'atris pulse tick|status|install|uninstall|run' };
+      if (!asJson) process.stdout.write(`${out.error}\nUsage: ${out.usage}\n`);
+      return emit(out, asJson);
+    }
+  }
+}
+
+module.exports = {
+  pulseCommand,
+  tickCommand,
+  statusCommand,
+  installCommand,
+  uninstallCommand,
+  runCommand,
+  runMissionEngine,
+  runAutopilotTick,
+  runEngine,
+  gitChangedFiles,
+  runVerify,
+  STATE_HOME,
+};

package/commands/radar.js

@@ -54,6 +54,7 @@ function agentTypeForCommand(command) {
   if (/(^|\s|\/)claude(\s|$)/.test(cmd) && !/Claude\.app/.test(cmd)) return 'claude';
   if (/(^|\s|\/)opencode(\s|$)/.test(cmd)) return 'opencode';
   if (/(^|\s|\/)devin(\s|$)/.test(cmd)) return 'devin';
+  if (/(^|\s|\/)droid(\s|$)/.test(cmd)) return 'droid';
   return null;
 }
 

package/commands/recap.js

@@ -53,8 +53,35 @@ function shortProof(proof, width = 70) {
   return flat.length <= width ? flat : `${flat.slice(0, width - 1)}…`;
 }
 
+function plainCheck(proof, width = 70) {
+  if (!proof) return null;
+  const flat = proof.replace(/\s+/g, ' ').trim();
+  const checks = [];
+  const add = label => { if (!checks.includes(label)) checks.push(label); };
+
+  if (/\b(PR|pull request)\b.*\b(merged|MERGED)\b|\bmerged\b.*\b(PR|pull request)\b/i.test(flat)) add('merged');
+  if (/\b(node --test|npm test|npm run test|pytest|go test|cargo test|test\/|tests?)\b/i.test(flat)
+    && /\b(pass|passed|green|ok|0 failures?|9\/9|12\/12)\b/i.test(flat)) add('tests passed');
+  if (/\b(node --check|git diff --check|git diff --exit-code|git diff --quiet|rg\b|grep\b|diff --brief|cmp -s)\b/i.test(flat)) add('code check passed');
+  if (/\b(bench|benchmark|measured|latency|speed)\b/i.test(flat)) add('measured improvement');
+  if (/\brepeated agent review\b|\bagent review\b/i.test(flat)) add('reviewed repeatedly');
+  if (/\batris\/runs\/[^\s]+\.json\b|receipt\b/i.test(flat)) add('record saved');
+  if (/\b(human approved|accepted by|accepted_at|reward)\b/i.test(flat)) add('human accepted');
+
+  if (checks.length) return checks.join(', ');
+  return shortProof(proof, width);
+}
+
 function shortTitle(title, width = 64) {
-  const flat = String(title || '').replace(/\s+/g, ' ').trim();
+  const flat = String(title || '')
+    .replace(/\bproof\b/gi, 'checks')
+    .replace(/\breceipts?\b/gi, 'records')
+    .replace(/\bsign[- ]off\b/gi, 'approval')
+    .replace(/\bpolicy\b/gi, 'rules')
+    .replace(/\bAgentXP\b/g, 'reward')
+    .replace(/\bcertified\b/gi, 'checked')
+    .replace(/\s+/g, ' ')
+    .trim();
   return flat.length <= width ? flat : `${flat.slice(0, width - 1)}…`;
 }
 
@@ -103,85 +130,88 @@ function renderRecap(data) {
       `RECAP — ${data.workspace}`,
       '',
       'No task history yet.',
-      'Run "atris init", then let an agent work — every finished task lands here with proof.',
+      'Run "atris init", then let Atris do one small job. Finished work will show up here with the checks that passed.',
     ].join('\n');
   }
   const lines = [];
   lines.push(`RECAP — ${data.workspace} — last ${data.days} day${data.days === 1 ? '' : 's'}`);
   lines.push('');
+  lines.push('Plain English: what changed, how it was checked, and what still needs you.');
   const headline = [];
-  if (data.shipped.length) headline.push(`${data.shipped.length} change${data.shipped.length === 1 ? '' : 's'} shipped`);
-  if (data.waiting.length) headline.push(`${data.waiting.length} finished and waiting for your sign-off`);
-  if (data.inProgress.length) headline.push(`${data.inProgress.length} in progress`);
-  lines.push(headline.length ? `Your AI team: ${headline.join(' · ')}.` : 'Quiet window — no movement in this period.');
-  lines.push('Every finished line below carries proof: the commands run and their results.');
+  if (data.shipped.length) headline.push(`${data.shipped.length} done`);
+  if (data.waiting.length) headline.push(`${data.waiting.length} needs you`);
+  if (data.inProgress.length) headline.push(`${data.inProgress.length} still working`);
+  lines.push(headline.length ? headline.join(' · ') : 'Quiet window — no movement in this period.');
 
   if (data.shipped.length) {
     lines.push('');
-    lines.push(`SHIPPED (accepted by a human) — ${data.shipped.length}`);
+    lines.push(`DONE — ${data.shipped.length}`);
     for (const t of data.shipped.slice(0, 12)) {
       lines.push(`  ${t.id}  ${shortTitle(t.title)}`);
-      if (t.proof) lines.push(`          proof: ${shortProof(t.proof)}`);
+      const check = plainCheck(t.proof);
+      if (check) lines.push(`          checked: ${check}`);
     }
-    if (data.shipped.length > 12) lines.push(`  … and ${data.shipped.length - 12} more, all with proof on file`);
+    if (data.shipped.length > 12) lines.push(`  … and ${data.shipped.length - 12} more`);
   }
 
   if (data.waiting.length) {
     lines.push('');
-    lines.push(`FINISHED, WAITING FOR YOUR SIGN-OFF — ${data.waiting.length}`);
+    lines.push(`NEEDS YOU — ${data.waiting.length}`);
     for (const t of data.waiting.slice(0, 10)) {
       lines.push(`  ${t.id}  ${shortTitle(t.title)}`);
+      const check = plainCheck(t.proof);
+      if (check) lines.push(`          checked: ${check}`);
     }
     if (data.waiting.length > 10) lines.push(`  … and ${data.waiting.length - 10} more`);
-    lines.push('  approve or send back: atris task reviews');
+    lines.push('  next: run atris task reviews');
   }
 
   if (data.inProgress.length) {
     lines.push('');
-    lines.push(`IN PROGRESS — ${data.inProgress.length}`);
+    lines.push(`STILL WORKING — ${data.inProgress.length}`);
     for (const t of data.inProgress) {
       lines.push(`  ${t.id}  ${shortTitle(t.title)}${t.owner ? `  @${t.owner}` : ''}`);
     }
   }
 
   lines.push('');
-  lines.push(`Proof attached: ${data.proof_attached}/${data.proof_total} finished items.`);
-  lines.push('Paste-ready summary for Slack or email: atris recap --share');
+  lines.push(`Checked: ${data.proof_attached}/${data.proof_total} finished items.`);
+  lines.push('Share this: atris recap --share');
   return lines.join('\n');
 }
 
 function renderShare(data) {
   if (data.empty) return `Nothing to share yet on ${data.workspace} — no finished tasks on record.`;
   const lines = [];
-  lines.push(`What the AI team did on ${data.workspace} in the last ${data.days} day${data.days === 1 ? '' : 's'}:`);
+  lines.push(`What got done on ${data.workspace} in the last ${data.days} day${data.days === 1 ? '' : 's'}:`);
   lines.push('');
-  if (data.shipped.length) lines.push(`- ${data.shipped.length} change${data.shipped.length === 1 ? '' : 's'} shipped, each verified before a human accepted it`);
-  if (data.waiting.length) lines.push(`- ${data.waiting.length} more finished with proof attached, waiting for human sign-off`);
-  if (data.inProgress.length) lines.push(`- ${data.inProgress.length} task${data.inProgress.length === 1 ? '' : 's'} in progress`);
+  if (data.shipped.length) lines.push(`- ${data.shipped.length} done and accepted`);
+  if (data.waiting.length) lines.push(`- ${data.waiting.length} ready for you to approve or send back`);
+  if (data.inProgress.length) lines.push(`- ${data.inProgress.length} still being worked on`);
   const highlights = [...data.shipped, ...data.waiting].filter(t => t.proof).slice(0, 5);
   if (highlights.length) {
     lines.push('');
     lines.push('Highlights:');
     for (const t of highlights) {
-      lines.push(`- ${shortTitle(t.title, 80)} (proof: ${shortProof(t.proof, 60)})`);
+      lines.push(`- ${shortTitle(t.title, 80)} (${plainCheck(t.proof, 60)})`);
     }
   }
   lines.push('');
-  lines.push('Every item above is backed by a receipt — the exact commands run and their results — not a status update someone typed.');
+  lines.push('The finished items are backed by actual checks that ran, not a status update someone typed.');
   return lines.join('\n');
 }
 
 function printRecapHelp() {
   console.log(`
-atris recap - what your AI team actually did, in plain English
+atris recap - what got done, in plain English
 
-  atris recap              Last 7 days: shipped, waiting on you, in progress
+  atris recap              Last 7 days: done, needs you, still working
   atris recap --days 30    Widen the window
   atris recap --share      Paste-ready summary for Slack, email, or a customer
   atris recap --json       Structured output for agents and dashboards
 
-Reads the workspace task records and their proof. No jargon, no guesses:
-if it is listed as finished, the receipt is on file.
+Looks at Atris' saved work and explains it without internal jargon:
+what changed, how it was checked, and what still needs you.
 `);
 }