atris 3.53.0 → 3.56.0

package/commands/interview.js

@@ -153,6 +153,14 @@ async function interviewCommand(args = [], root = process.cwd()) {
     return 0;
   }
 
+  const { refuseHeadlessUnless } = require('../lib/noninteractive');
+  if (refuseHeadlessUnless(args, {
+    allowYes: true,
+    usage: 'Usage: atris interview [subject] [--yes]\nHeadless interview needs --yes.',
+  })) {
+    return 2;
+  }
+
   const ws = findWorkspaceRoot(root);
   if (!ws) {
     console.error('✗ Not inside an Atris workspace (no atris/ directory found).');

package/commands/land.js

@@ -19,6 +19,10 @@ function repoRoot(cwd = process.cwd()) {
   return result.stdout.trim();
 }
 
+function hasCommits(root) {
+  return runGit(['rev-parse', '--verify', '--quiet', 'HEAD'], { cwd: root, check: false }).status === 0;
+}
+
 function refExists(root, ref) {
   return runGit(['rev-parse', '--verify', '--quiet', ref], { cwd: root, check: false }).status === 0;
 }
@@ -111,7 +115,11 @@ function cherryStats(root, base, ref) {
 //   due    — has unlanded commits, older than TTL; --reap collects it
 function collectBoard(root, { ttlDays = DEFAULT_TTL_DAYS, staleHours = DEFAULT_STALE_HOURS, base: baseOverride = '', now = Date.now(), light = false } = {}) {
   const base = baseBranch(root, baseOverride);
-  if (!base) throw new Error('no master/main branch found');
+  if (!base) {
+    const err = new Error('no master/main branch found. fix: git checkout -b main');
+    err.code = 'LAND_NO_BASE';
+    throw err;
+  }
 
   const branches = [];
   const lastCommitMsByBranch = new Map();
@@ -457,7 +465,11 @@ function reap(root, { ttlDays = DEFAULT_TTL_DAYS, staleHours = DEFAULT_STALE_HOU
 // into master some other way, and what would be lost if it were cleared.
 function collectStory(root, name, { base: baseOverride = '' } = {}) {
   const base = baseBranch(root, baseOverride);
-  if (!base) throw new Error('no master/main branch found');
+  if (!base) {
+    const err = new Error('no master/main branch found. fix: git checkout -b main');
+    err.code = 'LAND_NO_BASE';
+    throw err;
+  }
   if (!refExists(root, name)) return null;
 
   const logResult = runGit(
@@ -656,7 +668,11 @@ function landCommand(args = []) {
   }
   const root = repoRoot();
   if (!root) {
-    console.error('not a git repository');
+    console.error('not a git repository. fix: git init -b main');
+    return 1;
+  }
+  if (!hasCommits(root)) {
+    console.error('no commits yet. fix: git commit --allow-empty -m init');
     return 1;
   }
   const ttlRaw = readFollowingFlag(args, '--ttl', '');
@@ -666,29 +682,44 @@ function landCommand(args = []) {
   const json = args.includes('--json');
 
   if (args.includes('--reap')) {
-    const receipt = reap(root, { ttlDays, base, dryRun: args.includes('--dry-run'), remote: !args.includes('--no-remote'), force: args.includes('--force') });
-    if (json) console.log(JSON.stringify(receipt, null, 2));
-    else printReceipt(receipt);
-    return 0;
+    try {
+      const receipt = reap(root, { ttlDays, base, dryRun: args.includes('--dry-run'), remote: !args.includes('--no-remote'), force: args.includes('--force') });
+      if (json) console.log(JSON.stringify(receipt, null, 2));
+      else printReceipt(receipt);
+      return 0;
+    } catch (err) {
+      console.error(String(err && err.message || err));
+      return 1;
+    }
   }
 
   const lookupArgs = args[0] === 'status' ? args.slice(1) : args;
   const name = lookupArgs.find((a) => !a.startsWith('-') && a !== readFollowingFlag(lookupArgs, '--ttl') && a !== readFollowingFlag(lookupArgs, '--base'));
   if (name) {
-    const story = collectStory(root, name, { base });
-    if (!story) {
-      console.error(`nothing called '${name}' is in the air right now`);
+    try {
+      const story = collectStory(root, name, { base });
+      if (!story) {
+        console.error(`nothing called '${name}' is in the air right now`);
+        return 1;
+      }
+      if (json) console.log(JSON.stringify(story, null, 2));
+      else printStory(story);
+      return 0;
+    } catch (err) {
+      console.error(String(err && err.message || err));
       return 1;
     }
-    if (json) console.log(JSON.stringify(story, null, 2));
-    else printStory(story);
-    return 0;
   }
 
-  const board = collectBoard(root, { ttlDays, base });
-  if (json) console.log(JSON.stringify(board, null, 2));
-  else printBoard(board);
-  return 0;
+  try {
+    const board = collectBoard(root, { ttlDays, base });
+    if (json) console.log(JSON.stringify(board, null, 2));
+    else printBoard(board);
+    return 0;
+  } catch (err) {
+    console.error(String(err && err.message || err));
+    return 1;
+  }
 }
 
 module.exports = {

package/commands/learn.js

@@ -227,21 +227,42 @@ function interactiveAdd() {
   })();
 }
 
+function learnLogSchemaLines() {
+  return [
+    'Schema: {"type":"pattern|pitfall|preference|architecture|tool","key":"...","insight":"...","confidence":1-10,"source":"observed|user-stated|inferred|review"}',
+    'Required: type, key, insight. Aliases: title→key, detail→insight. Optional: confidence (default 5), source (default observed), files[].',
+    'Example: atris learn log \'{"type":"pattern","title":"map-first","detail":"check MAP.md before grep","confidence":8}\'',
+  ];
+}
+
+function printLearnLogSchema(stream = console.error) {
+  for (const line of learnLogSchemaLines()) stream(`  ${line}`);
+}
+
 /**
  * Non-interactive log: `atris learn log '{"type":"pattern","key":"...","insight":"...","confidence":8,"source":"observed"}'`
  * For agents and scripts — no prompts, no quality gate.
+ * Aliases: title→key, detail→insight.
  */
 function logDirect(jsonStr) {
   if (!jsonStr) {
-    console.error('  ✗ Usage: atris learn log \'{"type":"...","key":"...","insight":"...","confidence":N,"source":"..."}\'');
+    console.error('  ✗ Usage: atris learn log \'<json>\'');
+    printLearnLogSchema();
+    process.exit(1);
+  }
+  let data;
+  try {
+    data = JSON.parse(jsonStr);
+  } catch (err) {
+    console.error(`  ✗ Invalid JSON: ${err.message}`);
+    printLearnLogSchema();
     process.exit(1);
   }
   try {
-    const data = JSON.parse(jsonStr);
     const entry = addLearning({
       type: data.type,
-      key: data.key,
-      insight: data.insight,
+      key: data.key || data.title,
+      insight: data.insight || data.detail,
       confidence: data.confidence || 5,
       source: data.source || 'observed',
       files: data.files || [],
@@ -249,6 +270,7 @@ function logDirect(jsonStr) {
     console.log(`  ✓ [${entry.confidence}/10] ${entry.type}/${entry.key}`);
   } catch (err) {
     console.error(`  ✗ ${err.message}`);
+    printLearnLogSchema();
     process.exit(1);
   }
 }
@@ -362,6 +384,9 @@ function showLearnHelp() {
   console.log('    export     Export as markdown');
   console.log('    count      Print learning count (for integrations)');
   console.log('');
+  console.log('  learn log schema:');
+  for (const line of learnLogSchemaLines()) console.log(`    ${line}`);
+  console.log('');
 }
 
 function learnAtris(subcommand, ...args) {

package/commands/log.js

@@ -2,6 +2,15 @@ const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
 const { getLogPath, ensureLogDirectory, createLogFile, addInboxIdea } = require('../lib/file-ops');
+const { isForcedNonInteractive } = require('../lib/noninteractive');
+
+function readPipedStdin() {
+  try {
+    return fs.readFileSync(0, 'utf8');
+  } catch {
+    return '';
+  }
+}
 
 function logAtris() {
   const targetDir = path.join(process.cwd(), 'atris');
@@ -18,6 +27,48 @@ function logAtris() {
     createLogFile(logFile, dateFormatted);
   }
 
+  const args = process.argv.slice(3);
+  const rel = path.relative(process.cwd(), logFile) || logFile;
+  const forced = isForcedNonInteractive(args);
+  const wantsRepl = args.includes('--repl');
+  const positional = args.filter((arg) => !String(arg).startsWith('-'));
+  const note = positional.join(' ').trim();
+
+  // `atris log "sentence"` (or multi-word args) appends to today's Inbox.
+  if (note && !wantsRepl) {
+    const id = addInboxIdea(logFile, note);
+    console.log(`captured I${id}: ${note}`);
+    console.log(`journal: ${rel}`);
+    console.log('Next: atris logs');
+    return;
+  }
+
+  // Forced headless: never open a REPL.
+  if (forced) {
+    console.log(`Daily log REPL needs a terminal (${dateFormatted}).`);
+    console.log(`journal: ${rel}`);
+    console.log('Next: atris log --repl   # in a terminal, or atris log "note" / atris wish --json --no-mission');
+    return;
+  }
+
+  // Piped stdin (tests and scripts): consume lines once, never hang waiting.
+  if (!process.stdin.isTTY) {
+    const piped = readPipedStdin();
+    const lines = piped.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+    const notes = lines.filter((line) => line.toLowerCase() !== 'exit');
+    if (notes.length === 0) {
+      console.log(`Daily log REPL needs a terminal (${dateFormatted}).`);
+      console.log(`journal: ${rel}`);
+      console.log('Next: atris log --repl   # in a terminal, or atris log "note" / atris logs --json');
+      return;
+    }
+    for (const noteLine of notes) {
+      addInboxIdea(logFile, noteLine);
+    }
+    console.log(`captured ${notes.length} note${notes.length === 1 ? '' : 's'} in ${rel}`);
+    return;
+  }
+
   console.log(`┌─────────────────────────────────────────────────────────┐`);
   console.log(`│ Daily Log — ${dateFormatted}              [type "exit" to quit] │`);
   console.log(`└─────────────────────────────────────────────────────────┘`);

package/commands/member.js

@@ -9,6 +9,7 @@ const { runAliveTick } = require('../lib/member-alive');
 const { defaultObjectiveRunner } = require('../lib/default-runner');
 const { readJson, writeJson } = require('../lib/json-file');
 const { hasFlag, readFlag, readNumberFlag } = require('../lib/arg-parser');
+const { ensureMemberBundle, memberBundlePresent } = require('../lib/member-scaffold');
 
 function findWorkspaceBusinessId(startDir = process.cwd()) {
   let dir = path.resolve(startDir);
@@ -113,7 +114,7 @@ function readRepeatedFlag(args, name) {
 function stripKnownFlags(args, valueNames, booleanNames = []) {
   const out = [];
   const valueSet = new Set(valueNames);
-  const booleanSet = new Set(booleanNames);
+  const booleanSet = new Set(['--full', '--verbose', ...booleanNames]);
   for (let i = 0; i < args.length; i += 1) {
     const arg = String(args[i]);
     const key = arg.includes('=') ? arg.slice(0, arg.indexOf('=')) : arg;
@@ -3933,10 +3934,27 @@ function findAllMembers(teamDir) {
 
 // --- LIST subcommand ---
 
-function memberList() {
+function memberList(...flags) {
+  const asJson = flags.includes('--json') || process.argv.includes('--json');
   const teamDir = path.join(process.cwd(), 'atris', 'team');
   const members = findAllMembers(teamDir);
 
+  if (asJson) {
+    console.log(JSON.stringify({
+      ok: true,
+      count: members.length,
+      members: members.map((m) => ({
+        name: m.name,
+        role: m.role,
+        format: m.format,
+        skills: m.format === 'directory' ? m.skillCount : null,
+        context: m.format === 'directory' ? m.contextCount : null,
+        version: m.version || null,
+      })),
+    }, null, 2));
+    return;
+  }
+
   if (members.length === 0) {
     console.log('No team members found in atris/team/.');
     console.log('Run "atris member create <name>" to create one.');
@@ -3969,11 +3987,11 @@ function memberList() {
     const context = m.format === 'directory' ? String(m.contextCount) : '-';
     console.log(
       '  ' +
-      m.name.padEnd(nameW) +
-      m.role.substring(0, roleW - 1).padEnd(roleW) +
-      (m.format === 'directory' ? 'dir' : 'flat').padEnd(fmtW) +
-      skills.padEnd(skillW) +
-      context.padEnd(ctxW) +
+      clipCell(m.name, nameW) +
+      clipCell(m.role, roleW) +
+      clipCell(m.format === 'directory' ? 'dir' : 'flat', fmtW) +
+      clipCell(skills, skillW) +
+      clipCell(context, ctxW) +
       (m.version || '-')
     );
   }
@@ -4119,6 +4137,42 @@ tools: []
   }
 }
 
+function printMemberInstallUsage(stream = console.log) {
+  stream('Usage: atris member install <slug>');
+}
+
+function memberInstall(slug) {
+  if (slug === '--help' || slug === '-h') {
+    printMemberInstallUsage();
+    return;
+  }
+  if (!slug || String(slug).startsWith('-')) {
+    printMemberInstallUsage(console.error);
+    process.exit(1);
+  }
+  if (!/^[a-zA-Z0-9._-]+$/.test(slug)) {
+    console.error('Member name must be a local slug: letters, numbers, dots, underscores, or dashes.');
+    process.exit(1);
+  }
+
+  const memberDir = path.join(process.cwd(), 'atris', 'team', slug);
+  const already = memberBundlePresent(memberDir);
+  fs.mkdirSync(path.join(memberDir, 'logs'), { recursive: true });
+  if (already) {
+    console.log(`MEMBER already installed for ${slug}`);
+    return;
+  }
+
+  const { created } = ensureMemberBundle(memberDir, {
+    name: slug,
+    source: 'install',
+  });
+  for (const rel of created) {
+    console.log(`atris/team/${slug}/${rel.split(path.sep).join('/')}`);
+  }
+  console.log(`MEMBER installed for ${slug}.`);
+}
+
 // --- ACTIVATE subcommand ---
 
 function memberActivate(name) {
@@ -9010,17 +9064,19 @@ 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
   // help themselves (with subcommand-specific usage) — leave those alone.
-  const HELP_AWARE_SUBCOMMANDS = new Set(['create', 'new', 'run']);
+  const HELP_AWARE_SUBCOMMANDS = new Set(['create', 'new', 'run', 'install']);
   if (!HELP_AWARE_SUBCOMMANDS.has(subcommand) && (args[0] === '-h' || args[0] === '--help')) {
     subcommand = undefined;
   }
   switch (subcommand) {
     case 'list':
     case 'ls':
-      return memberList();
+      return memberList(...args);
     case 'create':
     case 'new':
       return memberCreate(args[0], ...args.slice(1));
+    case 'install':
+      return memberInstall(args[0]);
     case 'activate':
       return memberActivate(args[0]);
     case 'upgrade':
@@ -9082,8 +9138,9 @@ 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('  install <slug>      Install the full MEMBER bundle if missing; never overwrite');
       console.log('  chat <name> "..."   Send a message to this member\'s desk in Atris Desktop');
-      console.log('  list                Show all team members');
+      console.log('  list [--json]       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');
       console.log('  push <name>         Push a local team member to the cloud');
@@ -9116,6 +9173,7 @@ async function memberCommand(subcommand, ...args) {
       console.log('');
       console.log('Examples:');
       console.log('  atris member create sdr --role="Sales Development Rep"');
+      console.log('  atris member install orb');
       console.log('  atris member list');
       console.log('  atris member activate navigator');
       console.log('  atris member upgrade executor');