atris 3.53.0 → 3.55.0

package/commands/init.js

@@ -1,7 +1,7 @@
 const fs = require('fs');
 const path = require('path');
 const { ensureExperimentsFramework } = require('./experiments');
-const { ensureWikiScaffold } = require('../lib/wiki');
+const { ensureWorkspaceBrain } = require('../lib/workspace-scaffold');
 const { upsertAtrisClaudeBootBlock } = require('../lib/claude-boot-block');
 const {
   upsertAgentVoiceCard,
@@ -257,21 +257,55 @@ ${profile.hasCode ? `**Validation:** Run \`${profile.testCommand}\` to verify ch
   } catch {}
 }
 
+function mapStubFromTree(projectRoot = process.cwd()) {
+  let entries = [];
+  try {
+    entries = fs.readdirSync(projectRoot, { withFileTypes: true })
+      .filter((entry) => !entry.name.startsWith('.') && entry.name !== 'node_modules' && entry.name !== 'atris')
+      .slice(0, 40)
+      .map((entry) => `- \`${entry.name}${entry.isDirectory() ? '/' : ''}\``);
+  } catch {
+    entries = [];
+  }
+  const body = entries.length
+    ? entries.join('\n')
+    : '- (empty project — add file:line refs as you explore)';
+  // Keep the classic placeholder markers so post-init does not treat this as a
+  // finished MAP and auto-run `atris do` before team members exist.
+  return `# MAP.md
+
+> Generated by your AI agent after reading atris.md
+> Lean stub from \`atris init --minimal\`. Expand with file:line refs as you work.
+
+Run your AI agent with atris.md to populate this file.
+
+## Top level
+
+${body}
+`;
+}
+
 function initAtris() {
   // Print usage on -h / --help / help instead of running init (which scaffolds
   // many files, including atris/now.md and atris/team/). Asking for help
   // 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] [--verbose]');
+    console.log('Usage: atris init [--force] [--yes|-y] [--verbose] [--minimal] [--full] [--with-adapters] [--with-skills]');
     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.');
+    console.log('  Use --minimal for atris.md + MAP + TODO + today journal + .atris/state (no IDE farm).');
+    console.log('  Use --with-adapters / --with-skills with --minimal, or --full for the default full scaffold.');
     return;
   }
   const verbose = args.includes('--verbose');
+  const minimal = args.includes('--minimal') && !args.includes('--full');
+  const withAdapters = !minimal || args.includes('--with-adapters');
+  const withSkills = !minimal || args.includes('--with-skills');
+  const withTeam = !minimal;
   const ready = {
     workspace: new Set(),
     team: new Set(),
@@ -287,10 +321,19 @@ function initAtris() {
   };
   const printReadyCounts = () => {
     console.log(`workspace files ready (${ready.workspace.size})`);
-    console.log(`team members ready (${ready.team.size})`);
-    console.log('more members are available with atris member create <name>');
-    console.log(`agent adapters ready (${ready.adapters.size})`);
-    console.log(`skills installed (${ready.skills.size})`);
+    if (withTeam || ready.team.size > 0) {
+      console.log(`team members ready (${ready.team.size})`);
+      console.log('more members are available with atris member create <name>');
+    }
+    if (withAdapters || ready.adapters.size > 0) {
+      console.log(`agent adapters ready (${ready.adapters.size})`);
+    }
+    if (withSkills || ready.skills.size > 0) {
+      console.log(`skills installed (${ready.skills.size})`);
+    }
+    if (minimal) {
+      console.log('minimal scaffold (add --with-adapters / --with-skills or init --full for the rest)');
+    }
   };
   // GUARD: Refuse nested init.
   // Bug: running `atris init` inside an existing `atris/` folder creates
@@ -385,8 +428,6 @@ function initAtris() {
   const gettingStartedFile = path.join(targetDir, 'GETTING_STARTED.md');
   const forAgentsFile = path.join(targetDir, 'FOR_AGENTS.md');
   const personaFile = path.join(targetDir, 'PERSONA.md');
-  const mapFile = path.join(targetDir, 'MAP.md');
-  const todoFile = path.join(targetDir, 'TODO.md');
   const navigatorFile = path.join(teamDir, 'navigator.md');
   const executorFile = path.join(teamDir, 'executor.md');
   const validatorFile = path.join(teamDir, 'validator.md');
@@ -412,16 +453,19 @@ function initAtris() {
     markReady('workspace', 'PERSONA.md', '✓ Created PERSONA.md');
   }
 
-  const wikiDir = path.join(targetDir, 'wiki');
-  const wikiAlreadyExists = fs.existsSync(wikiDir);
-  ensureWikiScaffold(process.cwd());
-  if (!wikiAlreadyExists) {
-    markReady('workspace', 'wiki/', '✓ Created wiki/ scaffold');
+  const brain = ensureWorkspaceBrain(cwd);
+  for (const rel of brain.created) {
+    const name = rel.replace(/^atris\//, '').replace(/\/$/, '');
+    markReady('workspace', name, `✓ Created ${name}`);
   }
 
-  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');
-    markReady('workspace', 'MAP.md', '✓ Created MAP.md placeholder');
+  if (minimal) {
+    const mapFile = path.join(targetDir, 'MAP.md');
+    const currentMap = fs.existsSync(mapFile) ? fs.readFileSync(mapFile, 'utf8') : '';
+    if (!currentMap || /Generated by your AI agent after reading atris\.md/i.test(currentMap)) {
+      fs.writeFileSync(mapFile, mapStubFromTree(cwd));
+      markReady('workspace', 'MAP.md', '✓ Wrote lean MAP.md stub from the project tree');
+    }
   }
 
   // Create INTUITION.md - captures learnings, preferences, dead ends
@@ -460,42 +504,6 @@ function initAtris() {
     markReady('workspace', 'INTUITION.md', '✓ Created INTUITION.md');
   }
 
-  if (!fs.existsSync(todoFile)) {
-    fs.writeFileSync(todoFile, `# TODO.md
-
-> Working task queue for this project. Target state = 0.
-> Note: Daily tasks live in \`atris/logs/YYYY/YYYY-MM-DD.md\`
-
----
-
-## Backlog
-
-(See today's journal)
-
----
-
-## In Progress
-
-(See today's journal)
-
----
-
-## Completed
-
-(Validator deletes after verification)
-
----
-`);
-    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');
-    markReady('workspace', 'now.md', '✓ Created now.md');
-  }
-
   // Create lessons.md (feedback loop for learning across features)
   const lessonsFile = path.join(targetDir, 'lessons.md');
   if (!fs.existsSync(lessonsFile)) {
@@ -509,46 +517,6 @@ function initAtris() {
     markReady('workspace', 'lessons.md', '✓ Created lessons.md');
   }
 
-  // Create logs directory and today's journal with bootstrap tasks
-  const logsDir = path.join(targetDir, 'logs');
-  const yearDir = path.join(logsDir, new Date().getFullYear().toString());
-  const today = new Date().toISOString().split('T')[0];
-  const journalFile = path.join(yearDir, `${today}.md`);
-
-  if (!fs.existsSync(yearDir)) {
-    fs.mkdirSync(yearDir, { recursive: true });
-    detail(`✓ Created logs/${new Date().getFullYear()}/ folder`);
-  }
-
-  if (!fs.existsSync(journalFile)) {
-    fs.writeFileSync(journalFile, `# Log — ${today}
-
-## Completed ✅
-
----
-
-## In Progress 🔄
-
----
-
-## Backlog
-
-- **T1:** Generate MAP.md — scan codebase, create navigation index with file:line refs
-
----
-
-## Notes
-
-**Bootstrap:** Say "atris next" to start. After MAP.md is generated, system will brainstorm ideas for your first build.
-
----
-
-## Inbox
-
-`);
-    markReady('workspace', `logs/${today}.md`, `✓ Created today's journal with bootstrap tasks`);
-  }
-
   // Create features directory and README
   const featuresDir = path.join(targetDir, 'features');
   const templatesDir = path.join(featuresDir, '_templates');
@@ -608,6 +576,7 @@ function initAtris() {
 
 
   // Copy team members (MEMBER.md format — directory per member with skills/tools/context)
+  if (withTeam) {
   const starterMembers = ['navigator', 'executor', 'validator', 'mission-lead', 'improver', 'customer-lead'];
   const starterMemberFiles = ['MEMBER.md', 'SOUL.md', 'START_HERE.md'];
   const starterMemberDirs = ['skills', 'tools', 'context'];
@@ -662,6 +631,7 @@ tools: []
     fs.writeFileSync(path.join(templateTargetDir, 'MEMBER.md'), templateContent);
     markReady('workspace', 'team/_template/MEMBER.md', '✓ Created team/_template/MEMBER.md');
   }
+  }
 
   // Detect project context and generate profile
   const profile = detectProjectContext(process.cwd());
@@ -674,6 +644,7 @@ tools: []
   detail('✓ Injected project patterns into team specs');
 
   // Create agent instruction files for different tools
+  if (withAdapters) {
   const agentInstructions = `# AGENTS.md — Universal Agent Instructions
 
 > Works with: Claude Code, Cursor, Codex, OpenClaw, Windsurf, and any AI coding agent.
@@ -969,8 +940,10 @@ Read atris/MAP.md. Begin iteration 1.`;
     fs.writeFileSync(autopilotCommandFile, autopilotCommand);
     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/
+  if (withSkills) {
   const skillsSourceDir = path.join(__dirname, '..', 'atris', 'skills');
   const skillsTargetDir = path.join(targetDir, 'skills');
   const claudeSkillsDir = path.join(process.cwd(), '.claude', 'skills');
@@ -1051,8 +1024,10 @@ Read atris/MAP.md. Begin iteration 1.`;
       }
     }
   }
+  }
 
   // CLAUDE.md for Claude Code (copy from atris/)
+  if (withAdapters) {
   const claudeMdSource = path.join(__dirname, '..', 'atris', 'CLAUDE.md');
   const claudeMdFile = path.join(targetDir, 'CLAUDE.md');
   if (!fs.existsSync(claudeMdFile) && fs.existsSync(claudeMdSource)) {
@@ -1118,6 +1093,7 @@ Read atris/MAP.md. Begin iteration 1.`;
     fs.writeFileSync(rootClaudeMd, upsertAtrisClaudeBootBlock().content);
     markReady('adapters', 'CLAUDE.md', '✓ created CLAUDE.md with atris block');
   }
+  }
 
   if (fs.existsSync(sourceFile)) {
     fs.copyFileSync(sourceFile, targetFile);

package/commands/install.js

@@ -0,0 +1,40 @@
+const { ensureWorkspaceBrain, workspaceBrainPresent } = require('../lib/workspace-scaffold');
+
+function printInstallUsage(stream = console.log) {
+  stream('Usage: atris install');
+  stream('alias: atris workspace install');
+  stream('');
+  stream('installs the atris/ brain into the current directory if missing.');
+}
+
+function installCommand(args = [], { verb } = {}) {
+  const sub = args[0];
+  if (verb === 'workspace' && sub && sub !== 'install' && sub !== '-h' && sub !== '--help' && sub !== 'help') {
+    console.error('Usage: atris workspace install');
+    process.exit(1);
+  }
+
+  const flags = verb === 'workspace' && sub === 'install' ? args.slice(1) : args;
+  if (flags[0] === '-h' || flags[0] === '--help' || flags[0] === 'help') {
+    printInstallUsage();
+    return 0;
+  }
+
+  const root = process.cwd();
+  if (workspaceBrainPresent(root)) {
+    console.log('Atris already installed.');
+    return 0;
+  }
+
+  const { created } = ensureWorkspaceBrain(root);
+  if (created.length === 0) {
+    console.log('Atris already installed.');
+    return 0;
+  }
+  for (const rel of created) {
+    console.log(rel);
+  }
+  return 0;
+}
+
+module.exports = { installCommand };