atris 2.0.0 → 2.0.2

package/PERSONA.md

@@ -60,7 +60,7 @@ Delete when done. Clean workspace = clear mind.
 
 ## Collaboration
 
-**Trust the system.** MAP.md is truth. TODO.md is current work (formerly `TASK_CONTEXTS.md`).
+**Trust the system.** MAP.md is truth. TODO.md is current work (formerly `TODO.md`).
 
 Navigator finds, executor builds, validator verifies. Stay in your lane.
 

package/atris/PERSONA.md

@@ -60,7 +60,7 @@ Delete when done. Clean workspace = clear mind.
 
 ## Collaboration
 
-**Trust the system.** MAP.md is truth. TODO.md is current work (formerly `TASK_CONTEXTS.md`).
+**Trust the system.** MAP.md is truth. TODO.md is current work (formerly `TODO.md`).
 
 Navigator finds, executor builds, validator verifies. Stay in your lane.
 

package/atris/atris.md

@@ -146,7 +146,7 @@ ATRIS ships with pre-built agent templates in `/atris/agent_team/` (copied durin
 
 ---
 
-## Phase 3: Task Context System (TODO.md in `/atris/`, formerly `TASK_CONTEXTS.md`)
+## Phase 3: Task Context System (TODO.md in `/atris/`, formerly `TODO.md`)
 
 **Goal:** Automatic task extraction with exact file/component context, so agents never guess.
 
@@ -218,7 +218,7 @@ ATRIS ships with pre-built agent templates in `/atris/agent_team/` (copied durin
 
 3. Output: `/atris/TODO.md` (maintains and evolves as system changes)
 
-4. On each MAP.md update, regenerate TASK_CONTEXTS.md to reflect new state
+4. On each MAP.md update, regenerate TODO.md to reflect new state
 
 ---
 
@@ -592,6 +592,65 @@ Contents:
 
 ---
 
+## Phase 5.3: Claude Code Integration
+
+Auto-inject ATRIS context into Claude Code sessions via skills and commands.
+
+### Slash Command Setup
+
+Create `.claude/commands/atris.md`:
+
+```markdown
+---
+description: Activate ATRIS context - loads TODO.md, journal, and persona
+allowed-tools: Read, Bash, Glob, Grep
+---
+
+# ATRIS Activate
+
+Load these files:
+1. @atris/PERSONA.md (communication style)
+2. @atris/TODO.md (current tasks)
+3. @atris/MAP.md (navigation)
+
+Workflow: plan → do → review
+Rules: 3-4 sentences max, ASCII visuals, check MAP.md first
+```
+
+### Skill Setup
+
+Create `.claude/skills/atris/SKILL.md`:
+
+```markdown
+---
+name: atris
+description: ATRIS workspace navigation. Use when user mentions atris, TODO, tasks, MAP.md, or asks "where is X?"
+allowed-tools: Read, Bash, Glob, Grep, Write, Edit
+---
+
+# ATRIS Skill
+
+Detect: Project has `atris/` folder with MAP.md, TODO.md, PERSONA.md
+
+Workflow: Navigator (plan) → Executor (build) → Validator (verify)
+
+Key behaviors:
+- Read PERSONA.md first (3-4 sentences, ASCII visuals)
+- Check MAP.md for file:line refs
+- Update TODO.md (claim tasks, delete when done)
+```
+
+### Checklist
+
+- [ ] Create `.claude/commands/` directory
+- [ ] Create `.claude/skills/atris/` directory
+- [ ] Add `atris.md` command file
+- [ ] Add `SKILL.md` skill file
+- [ ] Test with `/atris` in Claude Code
+- [ ] Verify skill triggers on "atris" or "tasks" mentions
+
+---
+
 ## Phase 6: Future Roadmap (Vision)
 
 **See [`ATRIS_NOTES.md`](./ATRIS_NOTES.md) for full roadmap. Preview:**

package/atris.md

@@ -146,7 +146,7 @@ ATRIS ships with pre-built agent templates in `/atris/agent_team/` (copied durin
 
 ---
 
-## Phase 3: Task Context System (TODO.md in `/atris/`, formerly `TASK_CONTEXTS.md`)
+## Phase 3: Task Context System (TODO.md in `/atris/`, formerly `TODO.md`)
 
 **Goal:** Automatic task extraction with exact file/component context, so agents never guess.
 
@@ -218,7 +218,7 @@ ATRIS ships with pre-built agent templates in `/atris/agent_team/` (copied durin
 
 3. Output: `/atris/TODO.md` (maintains and evolves as system changes)
 
-4. On each MAP.md update, regenerate TASK_CONTEXTS.md to reflect new state
+4. On each MAP.md update, regenerate TODO.md to reflect new state
 
 ---
 
@@ -592,6 +592,65 @@ Contents:
 
 ---
 
+## Phase 5.3: Claude Code Integration
+
+Auto-inject ATRIS context into Claude Code sessions via skills and commands.
+
+### Slash Command Setup
+
+Create `.claude/commands/atris.md`:
+
+```markdown
+---
+description: Activate ATRIS context - loads TODO.md, journal, and persona
+allowed-tools: Read, Bash, Glob, Grep
+---
+
+# ATRIS Activate
+
+Load these files:
+1. @atris/PERSONA.md (communication style)
+2. @atris/TODO.md (current tasks)
+3. @atris/MAP.md (navigation)
+
+Workflow: plan → do → review
+Rules: 3-4 sentences max, ASCII visuals, check MAP.md first
+```
+
+### Skill Setup
+
+Create `.claude/skills/atris/SKILL.md`:
+
+```markdown
+---
+name: atris
+description: ATRIS workspace navigation. Use when user mentions atris, TODO, tasks, MAP.md, or asks "where is X?"
+allowed-tools: Read, Bash, Glob, Grep, Write, Edit
+---
+
+# ATRIS Skill
+
+Detect: Project has `atris/` folder with MAP.md, TODO.md, PERSONA.md
+
+Workflow: Navigator (plan) → Executor (build) → Validator (verify)
+
+Key behaviors:
+- Read PERSONA.md first (3-4 sentences, ASCII visuals)
+- Check MAP.md for file:line refs
+- Update TODO.md (claim tasks, delete when done)
+```
+
+### Checklist
+
+- [ ] Create `.claude/commands/` directory
+- [ ] Create `.claude/skills/atris/` directory
+- [ ] Add `atris.md` command file
+- [ ] Add `SKILL.md` skill file
+- [ ] Test with `/atris` in Claude Code
+- [ ] Verify skill triggers on "atris" or "tasks" mentions
+
+---
+
 ## Phase 6: Future Roadmap (Vision)
 
 **See [`ATRIS_NOTES.md`](./ATRIS_NOTES.md) for full roadmap. Preview:**

package/bin/atris.js

@@ -198,6 +198,19 @@ function showAutopilotHelp() {
   console.log('');
 }
 
+// Command handlers - must load BEFORE interactiveEntry() is called (TDZ issue)
+const { initAtris: initCmd } = require('../commands/init');
+const { syncAtris: syncCmd } = require('../commands/sync');
+const { logAtris: logCmd } = require('../commands/log');
+const { logSyncAtris: logSyncCmd } = require('../commands/log-sync');
+const { loginAtris: loginCmd, logoutAtris: logoutCmd, whoamiAtris: whoamiCmd } = require('../commands/auth');
+const { showVersion: versionCmd } = require('../commands/version');
+const { planAtris: planCmd, doAtris: doCmd, reviewAtris: reviewCmd } = require('../commands/workflow');
+const { visualizeAtris: visualizeCmd } = require('../commands/visualize');
+const { brainstormAtris: brainstormCmd, autopilotAtris: autopilotCmd } = require('../commands/brainstorm');
+const { statusAtris: statusCmd } = require('../commands/status');
+const { analyticsAtris: analyticsCmd } = require('../commands/analytics');
+
 // Check if this is a known command or natural language input
 const knownCommands = ['init', 'log', 'status', 'analytics', 'visualize', 'brainstorm', 'autopilot', 'plan', 'do', 'review',
                        'agent', 'chat', 'login', 'logout', 'whoami', 'update', 'version', 'help'];
@@ -206,23 +219,13 @@ const knownCommands = ['init', 'log', 'status', 'analytics', 'visualize', 'brain
 if (!command || !knownCommands.includes(command)) {
   const userInput = process.argv.slice(2).join(' ');
 
-  if (!userInput) {
-    // Cold start - no input, show context
-    atrisDevEntry()
-      .then(() => process.exit(0))
-      .catch((error) => {
-        console.error(`✗ Error: ${error.message || error}`);
-        process.exit(1);
-      });
-  } else {
-    // Hot start - user provided task description
-    atrisDevEntry(userInput)
-      .then(() => process.exit(0))
-      .catch((error) => {
-        console.error(`✗ Error: ${error.message || error}`);
-        process.exit(1);
-      });
-  }
+  // Launch interactive entry (the "Performance")
+  interactiveEntry(userInput)
+    .then(() => process.exit(0))
+    .catch((error) => {
+      console.error(`✗ Error: ${error.message || error}`);
+      process.exit(1);
+    });
   return;
 }
 
@@ -231,18 +234,98 @@ if (command === 'help' || command === '--help' || command === '-h') {
   process.exit(0);
 }
 
-// Command handlers - using modular commands where available
-const { initAtris: initCmd } = require('../commands/init');
-const { syncAtris: syncCmd } = require('../commands/sync');
-const { logAtris: logCmd } = require('../commands/log');
-const { logSyncAtris: logSyncCmd } = require('../commands/log-sync');
-const { loginAtris: loginCmd, logoutAtris: logoutCmd, whoamiAtris: whoamiCmd } = require('../commands/auth');
-const { showVersion: versionCmd } = require('../commands/version');
-const { planAtris: planCmd, doAtris: doCmd, reviewAtris: reviewCmd } = require('../commands/workflow');
-const { visualizeAtris: visualizeCmd } = require('../commands/visualize');
-const { brainstormAtris: brainstormCmd, autopilotAtris: autopilotCmd } = require('../commands/brainstorm');
-const { statusAtris: statusCmd } = require('../commands/status');
-const { analyticsAtris: analyticsCmd } = require('../commands/analytics');
+async function interactiveEntry(userInput) {
+  const workspaceDir = process.cwd();
+  const state = detectWorkspaceState(workspaceDir);
+  const context = loadContext(workspaceDir);
+
+  // Case 1: Hot Start (User provided input: "atris fix bug")
+  if (userInput) {
+    console.log('');
+    console.log(`✨ Request: "${userInput}"`);
+    console.log('   Initializing Navigator...');
+    await planCmd(userInput);
+    return;
+  }
+
+  // Case 2: Cold Start (User typed "atris")
+  // We present a "Warm Up" interface based on state
+  
+  console.log('');
+  console.log('┌─────────────────────────────────────────────────────────────┐');
+  console.log('│ ATRIS                                                       │');
+  console.log('└─────────────────────────────────────────────────────────────┘');
+  
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  const ask = (q) => new Promise(r => rl.question(q, r));
+
+  // Logic: Detect State -> Offer "Path of Least Resistance"
+
+  // State: Fresh Install
+  if (state.state === 'fresh') {
+    console.log('\n👋 Welcome to ATRIS.');
+    console.log('   This folder is not initialized yet.');
+    const answer = await ask('\n   Initialize project structure? [Y/n] ');
+    rl.close();
+    if (answer.toLowerCase() === '' || answer.toLowerCase() === 'y') {
+      initCmd();
+    } else {
+      console.log('Cancelled.');
+    }
+    return;
+  }
+
+  // State: In-Progress Work
+  if (context.inProgressFeatures.length > 0) {
+    const active = context.inProgressFeatures[0].replace('.md', '');
+    console.log(`\n🔥 Active Feature: ${active}`);
+    const answer = await ask(`   Resume building this? [Y/n] `);
+    if (answer.toLowerCase() === '' || answer.toLowerCase() === 'y') {
+      console.log('\n🚀 Starting Executor...');
+      rl.close();
+      await doCmd();
+      return;
+    }
+  }
+
+  // State: Inbox Items
+  if (context.hasInbox && context.inboxItems.length > 0) {
+    console.log(`\n📥 Inbox: You have ${context.inboxItems.length} unprocessed items.`);
+    const answer = await ask(`   Process into a plan? [Y/n] `);
+    if (answer.toLowerCase() === '' || answer.toLowerCase() === 'y') {
+      console.log('\n🚀 Starting Navigator...');
+      rl.close();
+      await planCmd();
+      return;
+    }
+  }
+
+  // State: Idle / Default
+  console.log('\n✨ Canvas is clean. What are we building?');
+  console.log('   (Type a request, "brainstorm", "status", or press Enter to exit)');
+  
+  const request = await ask('\n> ');
+  rl.close();
+
+  if (!request.trim()) {
+    console.log('See you later! 👋');
+    return;
+  }
+
+  if (request.toLowerCase() === 'brainstorm') {
+    await brainstormCmd();
+  } else if (request.toLowerCase() === 'status') {
+    await statusCmd();
+  } else {
+    // Treat as new plan request
+    console.log('\n🚀 Starting Navigator...');
+    await planCmd(request);
+  }
+}
 
 if (command === 'init') {
   initCmd();

package/commands/init.js

@@ -287,13 +287,33 @@ function initAtris() {
 
   // Create features directory and README
   const featuresDir = path.join(targetDir, 'features');
+  const templatesDir = path.join(featuresDir, '_templates');
+  
   if (!fs.existsSync(featuresDir)) {
     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 atrisDev 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\n---\n\n## Features Built\n\n*Features will appear here as you build them.*\n');
+    fs.writeFileSync(featuresReadme, '# Features\n\nThis directory tracks all features built using the atrisDev 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');
   }
 
+  // Create _templates/validate.md.template if not exists
+  if (!fs.existsSync(templatesDir)) {
+    fs.mkdirSync(templatesDir, { recursive: true });
+  }
+  const validateTemplateSource = path.join(__dirname, '..', 'atris', 'features', '_templates', 'validate.md.template');
+  const validateTemplateTarget = path.join(templatesDir, 'validate.md.template');
+  
+  if (fs.existsSync(validateTemplateSource)) {
+    fs.copyFileSync(validateTemplateSource, validateTemplateTarget);
+    console.log('✓ Created features/_templates/validate.md.template');
+  } else {
+    // Fallback if source not found (for safety)
+    const fallbackContent = `# Validation — [Feature Name]\n\n> **Role:** System Validation Script\n> **Executor:** Validator Agent\n> **Instructions:** Run these steps sequentially. If ANY step fails, the feature is broken.\n\n---\n\n## 1. Environment Check\n- [ ] **Pre-flight:**\n  - Command: \`npm run type-check\` (or relevant)\n  - Expect: No errors\n\n## 2. Simulation Steps (The "Real" Test)\n\n### Step 1: [Name]\n- **Action:** [Exact command]\n- **Expect:** [Exact output regex]\n\n---\n\n**Status:** [Pending | Verified]\n`;
+    fs.writeFileSync(validateTemplateTarget, fallbackContent);
+    console.log('✓ Created features/_templates/validate.md.template (fallback)');
+  }
+
+
   const navigatorSource = path.join(__dirname, '..', 'atris', 'agent_team', 'navigator.md');
   const executorSource = path.join(__dirname, '..', 'atris', 'agent_team', 'executor.md');
   const validatorSource = path.join(__dirname, '..', 'atris', 'agent_team', 'validator.md');

package/commands/workflow.js

@@ -197,6 +197,10 @@ async function planAtris() {
     userPrompt += `   - Add tasks to Backlog section\n`;
     userPrompt += `   - Format: Task number, description, file refs, acceptance criteria\n`;
     userPrompt += `   - Quality over speed - tasks must be perfect for systems player execution\n\n`;
+    userPrompt += `STEP 4: Create Validation Artifact (validate.md)\n`;
+    userPrompt += `   - You MUST create a validate.md file for the feature.\n`;
+    userPrompt += `   - This file acts as the executable simulation script for the Validator.\n`;
+    userPrompt += `   - Include verifiable steps (e.g., 'Run curl...', 'Check DB...').\n\n`;
     userPrompt += `Start planning now. Read MAP.md for file references.`;
 
     console.log('');
@@ -608,11 +612,40 @@ async function reviewAtris() {
     taskContexts = fs.readFileSync(taskFilePath, 'utf8');
   }
 
-  // Read journal for timestamp context
+  // Read journal for timestamp context (History)
   const { logFile, dateFormatted } = getLogPath();
-  let journalPath = '';
+  let journalHistory = '';
+  
+  // Load today's log
   if (fs.existsSync(logFile)) {
-    journalPath = path.relative(process.cwd(), logFile);
+    journalHistory += `## TODAY (${dateFormatted}):\n` + fs.readFileSync(logFile, 'utf8') + '\n\n';
+  }
+
+  // Load previous 3 days of logs for Drift Detection
+  // (We need to find them in the logs directory)
+  const targetLogsDir = path.join(targetDir, 'logs');
+  if (fs.existsSync(targetLogsDir)) {
+    // Simple recursive search for last 3 .md files
+    const allLogs = [];
+    const yearDirs = fs.readdirSync(targetLogsDir).filter(d => /^\d{4}$/.test(d));
+    for (const year of yearDirs) {
+      const yearPath = path.join(targetLogsDir, year);
+      if (fs.statSync(yearPath).isDirectory()) {
+        const files = fs.readdirSync(yearPath).filter(f => f.endsWith('.md') && f !== path.basename(logFile));
+        files.forEach(f => allLogs.push(path.join(yearPath, f)));
+      }
+    }
+    // Sort desc, take top 3
+    allLogs.sort().reverse();
+    const recentLogs = allLogs.slice(0, 3);
+    
+    if (recentLogs.length > 0) {
+      journalHistory += `## RECENT HISTORY (Drift Check):\n`;
+      for (const log of recentLogs) {
+        journalHistory += `--- ${path.basename(log)} ---\n`;
+        journalHistory += fs.readFileSync(log, 'utf8').substring(0, 1000) + '\n... (truncated)\n\n'; // Read first 1kb
+      }
+    }
   }
 
   const mapFile = path.join(targetDir, 'MAP.md');
@@ -648,7 +681,9 @@ async function reviewAtris() {
   console.log('');
   console.log('─────────────────────────────────────────────────────────────');
   console.log('');
-  console.log('📅 JOURNAL: ' + (journalPath || 'Not found'));
+  console.log('📅 JOURNAL HISTORY (Drift Detection):');
+  console.log('   Reading past logs to check for recurring friction...');
+  // We don't print the full history to console to avoid noise, but it's in the prompt
   console.log('');
   console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
   console.log('📋 INSTRUCTION PROMPT FOR YOUR CODING AGENT:');
@@ -660,8 +695,9 @@ async function reviewAtris() {
   console.log('  1. Ultrathink (say "ultrathink", think 3 times)');
   console.log('  2. Check requirements → build → edge cases → errors → integration');
   console.log('  3. Run tests (unit, integration, linting, type checking)');
-  console.log('  4. If issues found: report → "atris do" fixes → "atris review" again');
-  console.log('  5. Repeat until: "✅ All good. Ready for human testing."');
+  console.log('  4. Detect Drift (check recent logs for repeated struggle)');
+  console.log('  5. If issues found: report → "atris do" fixes → "atris review" again');
+  console.log('  6. Repeat until: "✅ All good. Ready for human testing."');
   console.log('');
   console.log('Your job:');
   console.log('  • Verify everything works');
@@ -669,7 +705,7 @@ async function reviewAtris() {
   console.log('  • Update docs if needed');
   console.log('  • Clean TODO.md (move completed tasks)');
   console.log('  • Extract learnings for journal');
-  console.log('  • Only approve when truly ready for human testing');
+  console.log('  • PROPOSE TOOLS if you see repetition (Evolution)');
   console.log('');
   console.log('The cycle: do → review → [issues] → do → review → ✅ Ready');
   console.log('');
@@ -711,12 +747,17 @@ async function reviewAtris() {
     userPrompt += `  1. Ultrathink (say "ultrathink", think 3 times)\n`;
     userPrompt += `  2. Check requirements → build → edge cases → errors → integration\n`;
     userPrompt += `  3. Run tests (unit, integration, linting, type checking)\n`;
-    userPrompt += `  4. If issues found: report → "atris do" fixes → "atris review" again\n`;
-    userPrompt += `  5. Repeat until: "✅ All good. Ready for human testing."\n\n`;
+    userPrompt += `  4. Detect Drift: Scan the Journal History below. Do you see the same friction 2x?\n`;
+    userPrompt += `  5. If issues found: report → "atris do" fixes → "atris review" again\n`;
+    userPrompt += `  6. Repeat until: "✅ All good. Ready for human testing."\n\n`;
     
     if (taskContexts) {
       userPrompt += `## TODO.md:\n${taskContexts}\n\n`;
     }
+
+    if (journalHistory) {
+      userPrompt += `## JOURNAL HISTORY (For Evolution/Drift Check):\n${journalHistory}\n\n`;
+    }
     
     userPrompt += `Your job:\n`;
     userPrompt += `  • Verify everything works\n`;
@@ -724,7 +765,7 @@ async function reviewAtris() {
     userPrompt += `  • Update docs if needed (MAP.md, TODO.md)\n`;
     userPrompt += `  • Clean TODO.md (move completed tasks to Completed section, then delete)\n`;
     userPrompt += `  • Extract learnings for journal\n`;
-    userPrompt += `  • Only approve when truly ready for human testing\n\n`;
+    userPrompt += `  • EVOLUTION: If you see drift in the logs, propose a tool upgrade.\n\n`;
     userPrompt += `The cycle: do → review → [issues] → do → review → ✅ Ready\n`;
     userPrompt += `Start validating now. Read files, run tests, verify implementation.`;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "atrisDev - A new way to build and manage agents",
   "main": "bin/atris.js",
   "bin": {