atris 3.35.0 → 3.37.0

package/commands/init.js

@@ -249,13 +249,34 @@ function initAtris() {
   // shouldn't have file-system side effects.
   const args = process.argv.slice(3);
   if (args[0] === '-h' || args[0] === '--help' || args[0] === 'help') {
-    console.log('Usage: atris init [--force] [--yes|-y]');
+    console.log('Usage: atris init [--force] [--yes|-y] [--verbose]');
     console.log('');
     console.log('  Scaffold the atris/ workspace in the current directory.');
     console.log('  Refuses to run inside an existing atris/ folder unless --force is passed.');
     console.log('  Use --yes or -y to skip the interactive context gatherer after scaffolding.');
+    console.log('  Use --verbose to list every file installed.');
     return;
   }
+  const verbose = args.includes('--verbose');
+  const ready = {
+    workspace: new Set(),
+    team: new Set(),
+    adapters: new Set(),
+    skills: new Set(),
+  };
+  const detail = (line) => {
+    if (verbose) console.log(line);
+  };
+  const markReady = (group, item, line) => {
+    ready[group].add(item);
+    detail(line);
+  };
+  const printReadyCounts = () => {
+    console.log(`workspace files ready (${ready.workspace.size})`);
+    console.log(`team members ready (${ready.team.size})`);
+    console.log(`agent adapters ready (${ready.adapters.size})`);
+    console.log(`skills installed (${ready.skills.size})`);
+  };
   // GUARD: Refuse nested init.
   // Bug: running `atris init` inside an existing `atris/` folder creates
   // `atris/atris/` nesting hell. A cloud business workspace had this exact problem.
@@ -305,9 +326,9 @@ function initAtris() {
 
   if (!fs.existsSync(targetDir)) {
     fs.mkdirSync(targetDir, { recursive: true });
-    console.log('✓ Created atris/ folder');
+    detail('✓ Created atris/ folder');
   } else {
-    console.log('✓ atris/ folder already exists');
+    detail('✓ atris/ folder already exists');
   }
 
   // MIGRATION: agent_team/ → team/ (v2.0.x → v2.1.0)
@@ -330,20 +351,20 @@ function initAtris() {
       if (!fs.existsSync(destPath)) {
         if (fs.statSync(srcPath).isFile()) {
           fs.copyFileSync(srcPath, destPath);
-          console.log(`  ✓ Migrated ${file}`);
+          markReady('workspace', `migration:${file}`, `  ✓ Migrated ${file}`);
         }
       }
     }
 
     // Remove old agent_team/ folder
     fs.rmSync(legacyAgentTeamDir, { recursive: true, force: true });
-    console.log('  ✓ Removed old agent_team/ folder');
+    detail('  ✓ Removed old agent_team/ folder');
     console.log('');
   }
 
   if (!fs.existsSync(teamDir)) {
     fs.mkdirSync(teamDir, { recursive: true });
-    console.log('✓ Created atris/team/ folder');
+    detail('✓ Created atris/team/ folder');
   }
 
   const gettingStartedFile = path.join(targetDir, 'GETTING_STARTED.md');
@@ -363,29 +384,29 @@ function initAtris() {
 
   if (!fs.existsSync(gettingStartedFile) && fs.existsSync(gettingStartedSource)) {
     fs.copyFileSync(gettingStartedSource, gettingStartedFile);
-    console.log('✓ Created GETTING_STARTED.md');
+    markReady('workspace', 'GETTING_STARTED.md', '✓ Created GETTING_STARTED.md');
   }
 
   if (!fs.existsSync(forAgentsFile) && fs.existsSync(forAgentsSource)) {
     fs.copyFileSync(forAgentsSource, forAgentsFile);
-    console.log('✓ Created FOR_AGENTS.md');
+    markReady('workspace', 'FOR_AGENTS.md', '✓ Created FOR_AGENTS.md');
   }
 
   if (!fs.existsSync(personaFile) && fs.existsSync(personaSource)) {
     fs.copyFileSync(personaSource, personaFile);
-    console.log('✓ Created PERSONA.md');
+    markReady('workspace', 'PERSONA.md', '✓ Created PERSONA.md');
   }
 
   const wikiDir = path.join(targetDir, 'wiki');
   const wikiAlreadyExists = fs.existsSync(wikiDir);
   ensureWikiScaffold(process.cwd());
   if (!wikiAlreadyExists) {
-    console.log('✓ Created wiki/ scaffold');
+    markReady('workspace', 'wiki/', '✓ Created wiki/ scaffold');
   }
 
   if (!fs.existsSync(mapFile)) {
     fs.writeFileSync(mapFile, '# MAP.md\n\n> Generated by your AI agent after reading atris.md\n\nRun your AI agent with atris.md to populate this file.\n');
-    console.log('✓ Created MAP.md placeholder');
+    markReady('workspace', 'MAP.md', '✓ Created MAP.md placeholder');
   }
 
   // Create INTUITION.md - captures learnings, preferences, dead ends
@@ -421,7 +442,7 @@ function initAtris() {
 
 ---
 `);
-    console.log('✓ Created INTUITION.md');
+    markReady('workspace', 'INTUITION.md', '✓ Created INTUITION.md');
   }
 
   if (!fs.existsSync(todoFile)) {
@@ -450,14 +471,14 @@ function initAtris() {
 
 ---
 `);
-    console.log('✓ Created TODO.md placeholder');
+    markReady('workspace', 'TODO.md', '✓ Created TODO.md placeholder');
   }
 
   const nowFile = path.join(targetDir, 'now.md');
   if (!fs.existsSync(nowFile)) {
     const { renderDefaultNow } = require('./now');
     fs.writeFileSync(nowFile, renderDefaultNow(cwd), 'utf8');
-    console.log('✓ Created now.md');
+    markReady('workspace', 'now.md', '✓ Created now.md');
   }
 
   // Create lessons.md (feedback loop for learning across features)
@@ -470,7 +491,7 @@ function initAtris() {
 ---
 
 `);
-    console.log('✓ Created lessons.md');
+    markReady('workspace', 'lessons.md', '✓ Created lessons.md');
   }
 
   // Create logs directory and today's journal with bootstrap tasks
@@ -481,7 +502,7 @@ function initAtris() {
 
   if (!fs.existsSync(yearDir)) {
     fs.mkdirSync(yearDir, { recursive: true });
-    console.log(`✓ Created logs/${new Date().getFullYear()}/ folder`);
+    detail(`✓ Created logs/${new Date().getFullYear()}/ folder`);
   }
 
   if (!fs.existsSync(journalFile)) {
@@ -510,7 +531,7 @@ function initAtris() {
 ## Inbox
 
 `);
-    console.log(`✓ Created today's journal with bootstrap tasks`);
+    markReady('workspace', `logs/${today}.md`, `✓ Created today's journal with bootstrap tasks`);
   }
 
   // Create features directory and README
@@ -521,7 +542,7 @@ function initAtris() {
     fs.mkdirSync(featuresDir, { recursive: true });
     const featuresReadme = path.join(featuresDir, 'README.md');
     fs.writeFileSync(featuresReadme, '# Features\n\nThis directory tracks all features built using the Atris protocol.\n\nEach feature has:\n- `[feature-name]/idea.md` - Problem, solution, diagrams, success criteria\n- `[feature-name]/build.md` - Implementation plan, files changed, testing\n- `[feature-name]/validate.md` - End-to-end simulation script\n\n---\n\n## Features Built\n\n*Features will appear here as you build them.*\n');
-    console.log('✓ Created features/ directory with README');
+    markReady('workspace', 'features/README.md', '✓ Created features/ directory with README');
   }
 
   // Create feature templates (idea/build/validate)
@@ -553,16 +574,22 @@ function initAtris() {
     const source = path.join(__dirname, '..', 'atris', 'features', '_templates', name);
     if (fs.existsSync(source)) {
       fs.copyFileSync(source, target);
-      console.log(`✓ Created features/_templates/${name}`);
+      markReady('workspace', `features/_templates/${name}`, `✓ Created features/_templates/${name}`);
       return;
     }
 
     fs.writeFileSync(target, fallback);
-    console.log(`✓ Created features/_templates/${name} (fallback)`);
+    markReady('workspace', `features/_templates/${name}`, `✓ Created features/_templates/${name} (fallback)`);
   });
 
   // Create experiments directory and packaged validation harness
-  ensureExperimentsFramework(process.cwd(), { silent: false });
+  const experimentSetup = ensureExperimentsFramework(process.cwd(), { silent: true });
+  experimentSetup.created.forEach((item) => ready.workspace.add(item));
+  if (experimentSetup.created.length > 0) {
+    detail(`✓ Prepared atris/experiments/ (${experimentSetup.created.length} item${experimentSetup.created.length === 1 ? '' : 's'})`);
+  } else {
+    detail('✓ atris/experiments/ already ready');
+  }
 
 
   // Copy team members (MEMBER.md format — directory per member with skills/tools/context)
@@ -582,7 +609,7 @@ function initAtris() {
       fs.mkdirSync(path.join(targetMemberDir, 'tools'), { recursive: true });
       fs.mkdirSync(path.join(targetMemberDir, 'context'), { recursive: true });
       fs.copyFileSync(sourceFile, targetFile);
-      console.log(`✓ Created team/${name}/ (MEMBER.md + skills/ + tools/ + context/)`);
+      markReady('team', name, `✓ Created team/${name}/ (MEMBER.md + skills/ + tools/ + context/)`);
     }
   });
 
@@ -609,18 +636,18 @@ tools: []
 # Insert persona, workflow, and rules below
 `;
     fs.writeFileSync(path.join(templateTargetDir, 'MEMBER.md'), templateContent);
-    console.log('✓ Created team/_template/MEMBER.md');
+    markReady('team', '_template', '✓ Created team/_template/MEMBER.md');
   }
 
   // Detect project context and generate profile
   const profile = detectProjectContext(process.cwd());
   const profileFile = path.join(targetDir, '.project-profile.json');
   fs.writeFileSync(profileFile, JSON.stringify(profile, null, 2));
-  console.log(`✓ Generated .project-profile.json (detected: ${profile.type}${profile.framework !== 'none' ? '/' + profile.framework : ''})`);
+  markReady('workspace', '.project-profile.json', `✓ Generated .project-profile.json (detected: ${profile.type}${profile.framework !== 'none' ? '/' + profile.framework : ''})`);
 
   // Inject project patterns into agent specs
   injectProjectPatterns(teamDir, profile);
-  console.log('✓ Injected project patterns into team specs');
+  detail('✓ Injected project patterns into team specs');
 
   // Create agent instruction files for different tools
   const agentInstructions = `# AGENTS.md — Universal Agent Instructions
@@ -665,7 +692,7 @@ Every agent should leave four artifacts another agent can trust:
 | Objective | \`atris task note <id> "Goal / files / done / check"\` |
 | Navigation | \`atris/MAP.md\` when a new route or file location is learned |
 | Change | Small git diff in declared files only |
-| Proof ready | \`atris task ready <id> --proof "<commands or receipt>"\` |
+| Proof ready | \`atris task ready <id> --proof "<commands or receipt>" --result "<day-one PM sentence>"\` |
 | Human accept | \`atris task accept <id>\` |
 
 Do not rely on chat context. Put the task, file pointers, and proof on disk.
@@ -748,7 +775,7 @@ member -> mission start --verify -> status --status active -> one bounded step -
 - [ ] Check MAP.md before touching code
 - [ ] Run \`atris task list\` or \`atris task next\` before picking work
 - [ ] Claim tasks with \`atris task claim <id> --as <functional-member>\`
-- [ ] Move agent-completed work to Review via \`atris task ready <id> --proof "..."\`
+- [ ] Move agent-completed work to Review via \`atris task ready <id> --proof "..." --result "<day-one PM sentence>"\`
 - [ ] Complete native Codex/Claude goals after proof is in Review, so always-on work can continue
 - [ ] Only use \`atris task accept <id>\` when the human has approved the proof
 - [ ] Keep durable learning in Atris-owned policy/skill/wiki/task state; keep \`AGENTS.md\` as a generated/pointer layer
@@ -771,7 +798,7 @@ member -> mission start --verify -> status --status active -> one bounded step -
   const cursorRulesFile = path.join(process.cwd(), '.cursorrules');
   if (!fs.existsSync(cursorRulesFile)) {
     fs.writeFileSync(cursorRulesFile, agentInstructions);
-    console.log('✓ Created .cursorrules (for Cursor)');
+    markReady('adapters', '.cursorrules', '✓ Created .cursorrules (for Cursor)');
   }
 
   // .cursor/rules/atris.mdc for Cursor (new format)
@@ -780,14 +807,14 @@ member -> mission start --verify -> status --status active -> one bounded step -
   if (!fs.existsSync(cursorMdcFile)) {
     fs.mkdirSync(cursorRulesDir, { recursive: true });
     fs.writeFileSync(cursorMdcFile, agentInstructions);
-    console.log('✓ Created .cursor/rules/atris.mdc (for Cursor)');
+    markReady('adapters', '.cursor/rules/atris.mdc', '✓ Created .cursor/rules/atris.mdc (for Cursor)');
   }
 
   // AGENTS.md for Codex
   const agentsMdFile = path.join(process.cwd(), 'AGENTS.md');
   if (!fs.existsSync(agentsMdFile)) {
     fs.writeFileSync(agentsMdFile, agentInstructions);
-    console.log('✓ Created AGENTS.md (for Codex)');
+    markReady('adapters', 'AGENTS.md', '✓ Created AGENTS.md (for Codex)');
   }
 
   // .devin/config.local.json for Devin for Terminal
@@ -803,7 +830,7 @@ member -> mission start --verify -> status --status active -> one bounded step -
       },
     };
     fs.writeFileSync(devinConfigFile, `${JSON.stringify(devinConfig, null, 2)}\n`);
-    console.log('✓ Created .devin/config.local.json (for Devin)');
+    markReady('adapters', '.devin/config.local.json', '✓ Created .devin/config.local.json (for Devin)');
   }
 
   // .claude/commands/atris.md for Claude Code
@@ -822,7 +849,7 @@ Follow the workflow: plan → do → review
 
 Rules: 3-4 sentences max, ASCII visuals, check MAP.md first.`;
     fs.writeFileSync(claudeCommandFile, claudeCommand);
-    console.log('✓ Created .claude/commands/atris.md (for Claude Code)');
+    markReady('adapters', '.claude/commands/atris.md', '✓ Created .claude/commands/atris.md (for Claude Code)');
   }
 
   // .claude/commands/atris-autopilot.md for autonomous loops
@@ -878,7 +905,7 @@ STATEEOF
 
 Read atris/MAP.md. Begin iteration 1.`;
     fs.writeFileSync(autopilotCommandFile, autopilotCommand);
-    console.log('✓ Created .claude/commands/atris-autopilot.md (autonomous loops)');
+    markReady('adapters', '.claude/commands/atris-autopilot.md', '✓ Created .claude/commands/atris-autopilot.md (autonomous loops)');
   }
 
   // Copy skills from package to atris/skills/ and symlink to .claude/skills/
@@ -918,7 +945,7 @@ Read atris/MAP.md. Begin iteration 1.`;
           }
         };
         copyRecursive(srcSkillDir, destSkillDir);
-        console.log(`✓ Copied skill: ${skill}`);
+        markReady('skills', skill, `✓ Copied skill: ${skill}`);
       }
     }
 
@@ -948,7 +975,7 @@ Read atris/MAP.md. Begin iteration 1.`;
       if (!fs.existsSync(symlinkPath)) {
         try {
           fs.symlinkSync(targetPath, symlinkPath);
-          console.log(`✓ Linked .claude/skills/${skill} → atris/skills/${skill}`);
+          markReady('skills', skill, `✓ Linked .claude/skills/${skill} → atris/skills/${skill}`);
         } catch (e) {
           // Fallback: copy instead of symlink (Windows compatibility)
           const srcDir = path.join(skillsTargetDir, skill);
@@ -957,7 +984,7 @@ Read atris/MAP.md. Begin iteration 1.`;
           for (const file of files) {
             fs.copyFileSync(path.join(srcDir, file), path.join(symlinkPath, file));
           }
-          console.log(`✓ Copied .claude/skills/${skill} (symlink failed)`);
+          markReady('skills', skill, `✓ Copied .claude/skills/${skill} (symlink failed)`);
         }
       }
     }
@@ -968,7 +995,7 @@ Read atris/MAP.md. Begin iteration 1.`;
   const claudeMdFile = path.join(targetDir, 'CLAUDE.md');
   if (!fs.existsSync(claudeMdFile) && fs.existsSync(claudeMdSource)) {
     fs.copyFileSync(claudeMdSource, claudeMdFile);
-    console.log('✓ Created atris/CLAUDE.md (for Claude Code)');
+    markReady('adapters', 'atris/CLAUDE.md', '✓ Created atris/CLAUDE.md (for Claude Code)');
   }
 
   // .claude/settings.json with SessionStart hook for auto-loading Atris
@@ -1003,14 +1030,14 @@ Read atris/MAP.md. Begin iteration 1.`;
       }
     };
     fs.writeFileSync(claudeSettingsFile, JSON.stringify(claudeSettings, null, 2));
-    console.log('✓ Created .claude/settings.json (auto-loads Atris on startup)');
+    markReady('adapters', '.claude/settings.json', '✓ Created .claude/settings.json (auto-loads Atris on startup)');
   }
 
   // Co-author trailer: commits in this workspace credit Atris, same as Claude/Cursor do
   try {
     const { installSignHook } = require('./sign');
     const { already } = installSignHook();
-    if (!already) console.log('✓ Installed co-author hook (commits credit Atris — remove with `atris sign off`)');
+    if (!already) markReady('adapters', 'co-author hook', '✓ Installed co-author hook (commits credit Atris, remove with `atris sign off`)');
   } catch {} // not a git repo — skip quietly
 
   // Update root CLAUDE.md with Atris block (prepend with markers)
@@ -1044,22 +1071,23 @@ After displaying the boot output, respond to the user naturally.
         content = atrisBlock + content.slice(0, startIdx) + content.slice(endIdx).replace(/^\n+/, '');
       }
       fs.writeFileSync(rootClaudeMd, content);
-      console.log('✓ Updated Atris block in CLAUDE.md');
+      markReady('adapters', 'CLAUDE.md', '✓ Updated Atris block in CLAUDE.md');
     } else {
       // Prepend Atris block
       fs.writeFileSync(rootClaudeMd, atrisBlock + content);
-      console.log('✓ Prepended Atris block to CLAUDE.md');
+      markReady('adapters', 'CLAUDE.md', '✓ Prepended Atris block to CLAUDE.md');
     }
   } else {
     // Create new CLAUDE.md with just Atris block
     fs.writeFileSync(rootClaudeMd, atrisBlock.trim() + '\n');
-    console.log('✓ Created CLAUDE.md with Atris block');
+    markReady('adapters', 'CLAUDE.md', '✓ Created CLAUDE.md with Atris block');
   }
 
   if (fs.existsSync(sourceFile)) {
     fs.copyFileSync(sourceFile, targetFile);
-    console.log('✓ Copied atris.md to atris/ folder');
-    console.log('\n✓ Atris initialized.');
+    markReady('workspace', 'atris.md', '✓ Copied atris.md to atris/ folder');
+    printReadyCounts();
+    console.log('\natris initialized.');
   } else {
     console.error('✗ Error: atris.md not found in package');
     process.exit(1);

package/commands/interview.js

@@ -16,6 +16,7 @@
 const fs = require('fs');
 const path = require('path');
 const { spawn } = require('child_process');
+const readline = require('readline');
 
 function findWorkspaceRoot(start) {
   let dir = start;
@@ -50,6 +51,71 @@ function showHelp() {
   console.log('');
 }
 
+function unquote(value) {
+  const text = String(value);
+  if ((text.startsWith('"') && text.endsWith('"')) || (text.startsWith("'") && text.endsWith("'"))) {
+    return text.slice(1, -1);
+  }
+  return text;
+}
+
+function parseSimpleFlags(args = [], valueFlagNames = []) {
+  const valueFlags = new Set(valueFlagNames);
+  const values = {};
+  const positionals = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = String(args[i] || '');
+    if (arg.startsWith('--')) {
+      const flagName = arg.split('=')[0];
+      if (valueFlags.has(flagName)) {
+        const prefix = `${flagName}=`;
+        if (arg.startsWith(prefix)) values[flagName] = unquote(arg.slice(prefix.length));
+        else if (args[i + 1] && !String(args[i + 1]).startsWith('--')) {
+          values[flagName] = unquote(args[i + 1]);
+          i += 1;
+        }
+      } else {
+        values[flagName] = true;
+      }
+      continue;
+    }
+    positionals.push(args[i]);
+  }
+  return { values, positionals };
+}
+
+function askPlain(rl, question) {
+  return new Promise((resolve) => rl.question(question, (answer) => resolve(answer)));
+}
+
+async function runPlainInterview({ args = [], fields = [], input = process.stdin, output = process.stdout } = {}) {
+  const parsed = parseSimpleFlags(args, fields.map((field) => field.flag));
+  const answers = {};
+  for (const field of fields) {
+    const value = String(parsed.values[field.flag] || '').trim();
+    if (value) answers[field.key] = value;
+  }
+
+  const missing = fields.filter((field) => !answers[field.key]);
+  if (!missing.length) return { ok: true, answers, positionals: parsed.positionals };
+  if (!input.isTTY) return { ok: false, missing: missing.map((field) => field.flag), answers, positionals: parsed.positionals };
+
+  const rl = readline.createInterface({ input, output });
+  try {
+    for (const field of missing) {
+      // eslint-disable-next-line no-await-in-loop
+      const answer = (await askPlain(rl, field.question)).trim();
+      if (answer) answers[field.key] = answer;
+    }
+  } finally {
+    rl.close();
+  }
+
+  const stillMissing = fields.filter((field) => !answers[field.key]);
+  if (stillMissing.length) return { ok: false, missing: stillMissing.map((field) => field.flag), answers, positionals: parsed.positionals };
+  return { ok: true, answers, positionals: parsed.positionals };
+}
+
 function composePrompt(mode, subject, contextPaths, root) {
   const ctx = contextPaths.length
     ? `Read these first (this is what the system already knows — open with an observation from them, never a blank question):\n${contextPaths.map((p) => `- ${p}`).join('\n')}`
@@ -140,4 +206,4 @@ async function interviewCommand(args = [], root = process.cwd()) {
   });
 }
 
-module.exports = { interviewCommand };
+module.exports = { interviewCommand, parseSimpleFlags, runPlainInterview };