atris 3.80.0 → 3.82.1

package/commands/doc-health.js

@@ -5,6 +5,7 @@ const path = require('path');
 const { resolveWorkspaceRoot } = require('../lib/mission-root');
 const { readText } = require('./brain');
 const { checkMapDocs, fixMapDocs } = require('../lib/map-refs');
+const { runRecallExam } = require('../lib/recall-exam');
 
 const BOOT_FILES = [
   'CLAUDE.md', 'AGENTS.md', 'atris/atris.md', 'atris/MAP.md',
@@ -357,12 +358,58 @@ function renderDocHealth(payload) {
   return lines.join('\n');
 }
 
+function flagValue(args, name) {
+  const index = args.indexOf(name);
+  if (index >= 0 && args[index + 1] && !args[index + 1].startsWith('--')) return args[index + 1];
+  return args.find(arg => arg.startsWith(`${name}=`))?.slice(name.length + 1);
+}
+
+function renderRecall(report, summaryOnly) {
+  const pct = value => (value === null ? 'n/a' : `${Math.round(value * 100)}%`);
+  const lines = [
+    `recall exam: ${report.found}/${report.questions} found (${pct(report.found_share)})`,
+    `boot read first: ${report.boot_tokens} tokens`,
+    `files opened after boot: median ${report.files_opened.median}, mean ${report.files_opened.mean === null ? 'n/a' : report.files_opened.mean.toFixed(2)}`,
+    `wrong opens (opened but not on the path to the answer): total ${report.wrong_opens.total}, mean ${report.wrong_opens.mean === null ? 'n/a' : report.wrong_opens.mean.toFixed(2)}`,
+    `tokens opened after boot: median ${report.tokens_opened.median}, mean ${report.tokens_opened.mean}, median when found ${report.tokens_opened_when_found.median}`,
+    ...table(['area', 'found', 'total'], Object.entries(report.by_area).sort().map(([area, row]) => [area, row.found, row.total])),
+  ];
+  if (report.invalid_lines.length) lines.push(`invalid question lines skipped: ${report.invalid_lines.join(', ')}`);
+  if (!summaryOnly) {
+    lines.push('', ...table(['id', 'found', 'opened', 'wrong', 'tokens', 'answer in'],
+      report.results.map(row => [row.id || '-', row.found ? 'yes' : 'no', row.files_opened, row.wrong_opens, row.tokens_opened, row.found_in || '-'])));
+  }
+  return lines.join('\n');
+}
+
+function recallCommand(args, options, file) {
+  const root = resolveWorkspaceRoot(options.cwd || process.cwd());
+  const questionsFile = path.resolve(options.cwd || process.cwd(), file);
+  if (!stat(questionsFile)?.isFile()) {
+    console.log(`no recall questions at ${file}. one object per line: {"q":"...","needle":"exact answer phrase"}`);
+    return 1;
+  }
+  const maxOpens = Number(flagValue(args, '--max-opens')) || undefined;
+  const report = runRecallExam(root, questionsFile, { bootFiles: BOOT_FILES, maxOpens });
+  // A held-out set is scored without echoing its questions back to the improver.
+  const summaryOnly = args.includes('--summary');
+  if (args.includes('--json')) {
+    const { results, ...totals } = report;
+    console.log(JSON.stringify({ ok: true, action: 'doc-health recall', ...totals, ...(summaryOnly ? {} : { results }) }, null, 2));
+  } else console.log(renderRecall(report, summaryOnly));
+  return 0;
+}
+
 function docHealthCommand(args = [], options = {}) {
   if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
-    console.log('usage: atris doc-health [--json] [--questions <path>] [--fix-refs]');
+    console.log('usage: atris doc-health [--json] [--questions <path>] [--fix-refs] [--recall <path> [--summary] [--max-opens N]]');
     console.log('  --fix-refs  rewrite map line refs whose code moved; list the ones a human must fix');
+    console.log('  --recall    follow links from the boot files to answer each question; report found, files opened, tokens read');
+    console.log('  --summary   with --recall, print totals only so a held-out set stays unseen');
     return 0;
   }
+  const recallFile = flagValue(args, '--recall');
+  if (recallFile) return recallCommand(args, options, recallFile);
   if (args.includes('--fix-refs')) {
     const root = resolveWorkspaceRoot(options.cwd || process.cwd());
     if (!stat(path.join(root, 'atris', 'MAP.md'))?.isFile()) {

package/commands/improve.js

@@ -96,6 +96,7 @@ function parseImproveArgs(argv = []) {
     timeoutMs: DEFAULT_TIMEOUT_MS,
     help: false,
     history: false,
+    unknownCommand: null,
   };
 
   for (let i = 0; i < args.length; i++) {
@@ -113,6 +114,7 @@ function parseImproveArgs(argv = []) {
     if (a.startsWith('--timeout=')) { const v = Number(a.split('=')[1]); if (v > 0) opts.timeoutMs = Math.round(v * 1000); continue; }
     // positional mode (plan|full|delegate)
     if (!a.startsWith('-') && VALID_MODES.has(a)) { opts.mode = a; continue; }
+    if (i === 0 && !a.startsWith('-')) { opts.unknownCommand = a; continue; }
   }
 
   if (!VALID_MODES.has(opts.mode)) opts.mode = 'full';
@@ -300,7 +302,7 @@ function formatTickHistory(summary = {}) {
   if (summary.rewardTrend && summary.rewardTrend.length) {
     lines.push(`  trend:    ${summary.rewardTrend.map((r) => (r == null ? '·' : r)).join(' → ')}`);
   }
-  if (!summary.ticks) lines.push('  (no ticks yet, run `atris improve`)');
+  if (!summary.ticks) lines.push('  (no ticks yet, run `atris improve tick`)');
   return lines.join('\n');
 }
 
@@ -1049,6 +1051,7 @@ const REVISION_WINDOW_HOURS = 72;
 const REVISION_IGNORED_FILES = [
   /^atris\/MAP\.md$/,
   /^atris\/refs\/MAP-NOTES\.md$/,
+  /^atris\/refs\/map\/[^/]+\.md$/,
   /^test\/fast-tests\.txt$/,
   /^atris\/logs\//,
   /^atris\/runs\//,
@@ -1507,7 +1510,7 @@ Modes (positional or --mode):
 
 Options:
   --member <name>  attribute the tick to a member (the loop's owner)
-  --model <id>     override the model (e.g. claude-sonnet-4-6)
+  --model <id>     override the model (e.g. sonnet)
   --dry-run        plan and run but do not commit
   --no-fallback    do not fall back to a local tick if the backend is down
   --workspace <p>  workspace path (default: cwd)
@@ -1523,7 +1526,11 @@ the backend is unreachable or you are not logged in.`);
 }
 
 function isBareVitalsArgs(argv = []) {
-  return argv.length === 0 || (argv.length === 1 && argv[0] === '--json');
+  if (argv.length === 0 || (argv.length === 1 && argv[0] === '--json')) return true;
+  if (argv[0] === 'status' || argv[0] === 'vitals') {
+    return argv.length === 1 || (argv.length === 2 && argv[1] === '--json');
+  }
+  return false;
 }
 
 const LOOP_DOCTOR_OPEN_STATUSES = new Set(['planning', 'ready', 'running', 'paused', 'blocked']);
@@ -1693,6 +1700,12 @@ async function run(argv = [], deps = {}) {
   const routedArgs = args[0] === 'tick' ? args.slice(1) : args;
   const opts = parseImproveArgs(routedArgs);
   if (opts.help) { showHelp(); return 0; }
+  if (opts.unknownCommand) {
+    const error = `unknown improve subcommand "${opts.unknownCommand}". try: atris improve, atris improve tick, atris improve history, atris improve doctor, or atris improve revisions.`;
+    if (opts.json) console.log(JSON.stringify({ ok: false, error, subcommand: opts.unknownCommand }));
+    else console.error(error);
+    return 1;
+  }
 
   if (opts.history) {
     const summary = summarizeTickHistory(readTickHistory(opts.workspace));

package/commands/init.js

@@ -1,4 +1,5 @@
 const fs = require('fs');
+const { ensureProjectTasteFile } = require('../lib/taste-notes');
 const path = require('path');
 const { ensureMemberBundle } = require('../lib/member-scaffold');
 const { ensureExperimentsFramework } = require('./experiments');
@@ -507,6 +508,9 @@ function initAtris() {
     markReady('workspace', 'lessons.md', '✓ Created lessons.md');
   }
 
+  // Project taste starts empty and is never overwritten; sync leaves it alone.
+  if (ensureProjectTasteFile(targetDir)) markReady('workspace', 'taste/TASTE.md', '✓ Created taste/TASTE.md');
+
   // Create features directory and README
   const featuresDir = path.join(targetDir, 'features');
   const templatesDir = path.join(featuresDir, '_templates');