atris 2.4.0 → 2.5.1

package/commands/workflow.js

@@ -167,8 +167,11 @@ async function planAtris(userInput = null) {
   }
   console.log('Workflow:');
   console.log('1) ASCII visualize + wait for approval');
-  console.log('2) Write plan artifacts: feature idea/build (+ validate) OR TODO Backlog');
-  console.log('3) Stop. Do NOT execute (run `atris do` to build).');
+  console.log('2) Write tasks to atris/TODO.md under ## Backlog');
+  console.log('   Format: - **T#:** Description [explore|execute]');
+  console.log('3) Log to atris/team/navigator/journal/YYYY-MM-DD.md');
+  console.log('   (Task, Delivered, User reaction, Pattern)');
+  console.log('4) Stop. Do NOT execute (run `atris do` to build).');
   console.log('');
   console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
   console.log('💡 After planning: Run "atris do" to execute the build');
@@ -231,14 +234,15 @@ async function planAtris(userInput = null) {
     userPrompt += `   - Include file:line references from MAP.md\n`;
     userPrompt += `   - List dependencies between tasks\n`;
     userPrompt += `   - Add acceptance criteria for each task\n\n`;
-    userPrompt += `STEP 3: Write tasks to TODO.md\n`;
-    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 += `STEP 3: Write tasks to atris/TODO.md\n`;
+    userPrompt += `   - Add to ## Backlog section\n`;
+    userPrompt += `   - Format: - **T#:** Description [explore|execute]\n`;
+    userPrompt += `   - Each task: one job, clear exit condition\n`;
+    userPrompt += `   - Include file:line references from MAP.md\n\n`;
+    userPrompt += `STEP 4: Log to your journal\n`;
+    userPrompt += `   - Write to atris/team/navigator/journal/YYYY-MM-DD.md\n`;
+    userPrompt += `   - Include: Task, Delivered, User reaction, Pattern\n`;
+    userPrompt += `   - Your journal is how you learn — record what worked\n\n`;
     userPrompt += `Start planning now. Read MAP.md for file references.`;
 
     console.log('');
@@ -478,9 +482,12 @@ async function doAtris() {
     console.log('');
   }
   console.log('Workflow:');
-  console.log('1) If a feature has `build.md`, execute it step-by-step (no redesign).');
-  console.log('2) Otherwise, pull the next item from TODO Backlog → In Progress → Completed.');
-  console.log('3) Run tests as you go; stop when tasks are done.');
+  console.log('1) Read atris/TODO.md — claim next unclaimed Backlog task');
+  console.log('   Move to ## In Progress: add "Claimed by: executor at YYYY-MM-DD HH:MM"');
+  console.log('2) Execute step-by-step. Run tests as you go.');
+  console.log('3) When done, move task to ## Completed');
+  console.log('4) Log to atris/team/executor/journal/YYYY-MM-DD.md');
+  console.log('   (Task, Delivered, Errors hit, Learned)');
   console.log('');
   console.log('⛔ Do NOT plan — just execute what\'s written.');
   console.log('');
@@ -510,12 +517,6 @@ async function doAtris() {
       console.log('');
     }
 
-    if (taskContexts && taskContexts.trim()) {
-      console.log('📝 TODO.md (full):');
-      console.log('─────────────────────────────────────────────────────────────');
-      console.log(taskContexts);
-      console.log('');
-    }
   }
 
   console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
@@ -562,16 +563,13 @@ async function doAtris() {
       userPrompt += `## TASKS TO EXECUTE:\n(No tasks found - check TODO.md)\n\n`;
     }
     
-    if (taskContexts) {
-      userPrompt += `## TODO.md (Additional Context):\n${taskContexts}\n\n`;
-    }
-    
     userPrompt += `Your process (EXECUTE these steps):\n`;
     userPrompt += `1. Read tasks from TODO.md (shown above)\n`;
     userPrompt += `2. For each task: Show ASCII visualization first (especially complex changes)\n`;
     userPrompt += `3. Execute task: Use file edit tools, terminal commands, etc.\n`;
-    userPrompt += `4. After completion: Move task to TODO.md <completed> section\n`;
-    userPrompt += `5. Follow PERSONA.md for communication style\n`;
+    userPrompt += `4. Move task to ## Completed in TODO.md\n`;
+    userPrompt += `5. Log to atris/team/executor/journal/YYYY-MM-DD.md\n`;
+    userPrompt += `   (Task, Delivered, Errors hit, Learned)\n`;
     userPrompt += `6. Use MAP.md to navigate codebase\n\n`;
     userPrompt += `DO NOT just describe what you would do - actually edit files and execute commands!\n`;
     userPrompt += `Context: ${context}\n`;
@@ -818,11 +816,13 @@ async function reviewAtris() {
   console.log('Workflow:');
   console.log('1) Run the project test suite (follow TESTING_GUIDE if present).');
   console.log('2) Execute any `atris/features/*/validate.md` scripts; if a step fails, fix + rerun.');
-  console.log('3) Update TODO.md + today\'s journal with results; propose tool upgrades if drift repeats.');
-  console.log('4) If anything surprised you (broke, worked unexpectedly), append to atris/lessons.md:');
-  console.log('   - **[YYYY-MM-DD] [feature-name]** — (pass|fail) — One-line lesson');
+  console.log('3) Clean TODO.md: delete completed tasks. Target state = 0.');
+  console.log('   If a task fails validation, move back to ## Backlog with note.');
+  console.log('4) Log to atris/team/validator/journal/YYYY-MM-DD.md');
+  console.log('   (Task, Result, Issues found, Learned)');
+  console.log('5) If anything surprised you, append to atris/lessons.md.');
   console.log('');
-  console.log('Done when: ✅ All good. Ready for human testing.');
+  console.log('Done when: ✅ All good. TODO.md clean. Ready for human testing.');
   console.log('');
 
   if (showFull) {
@@ -909,9 +909,10 @@ async function reviewAtris() {
     userPrompt += `Your job:\n`;
     userPrompt += `  • Verify everything works\n`;
     userPrompt += `  • Test thoroughly (unless user says no)\n`;
-    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 += `  • Clean TODO.md — DELETE completed tasks. Target state = 0.\n`;
+    userPrompt += `    If a task fails, move it back to ## Backlog with a note.\n`;
+    userPrompt += `  • Log to atris/team/validator/journal/YYYY-MM-DD.md\n`;
+    userPrompt += `    (Task, Result, Issues found, Learned)\n`;
     userPrompt += `  • If anything surprised you, append to atris/lessons.md\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`;
@@ -996,7 +997,9 @@ async function reviewAtris() {
     }
   }
 
-  // Prompt for learnings
+  // Prompt for learnings (skip if stdin is not a TTY)
+  if (!process.stdin.isTTY) return;
+
   console.log('');
   console.log('┌─────────────────────────────────────────────────────────────┐');
   console.log('│ 💡 Any learnings?                                           │');

package/lib/state-detection.js

@@ -42,10 +42,21 @@ function getBacklogTasks(atrisDir) {
     ? todoFile
     : (fs.existsSync(legacyTaskContextFile) ? legacyTaskContextFile : null);
 
-  if (!taskFilePath) return [];
+  if (taskFilePath) {
+    const content = fs.readFileSync(taskFilePath, 'utf8');
+    const tasks = getTasksFromTodoSection(content, 'Backlog');
+    if (tasks.length > 0) return tasks;
+  }
 
-  const content = fs.readFileSync(taskFilePath, 'utf8');
-  return getTasksFromTodoSection(content, 'Backlog');
+  // Fallback: check today's journal Backlog section
+  const todayLog = getTodayLogPath(path.join(atrisDir, 'logs'));
+  if (fs.existsSync(todayLog)) {
+    const journalContent = fs.readFileSync(todayLog, 'utf8');
+    const journalTasks = getTasksFromTodoSection(journalContent, 'Backlog');
+    if (journalTasks.length > 0) return journalTasks;
+  }
+
+  return [];
 }
 
 function getInProgressTasks(atrisDir) {
@@ -82,7 +93,7 @@ function getTasksFromTodoSection(content, sectionName) {
   if (!match) return [];
 
   const body = (match[1] || '').trim();
-  if (!body || /\(empty/i.test(body)) return [];
+  if (!body || /\(empty|\(see /i.test(body)) return [];
 
   const tasks = [];
   const titleRegex = /^Task:\s*(.+)$/gim;

package/lib/todo.js

@@ -0,0 +1,184 @@
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Parse TODO.md into structured task objects.
+ * Supports format: - **T1:** Description
+ *   with optional **Claimed by:** and **Stage:** lines
+ */
+function parseTodo(todoPath) {
+  if (!fs.existsSync(todoPath)) return { backlog: [], inProgress: [], completed: [] };
+
+  const content = fs.readFileSync(todoPath, 'utf8');
+  return {
+    backlog: parseSection(content, 'Backlog'),
+    inProgress: parseSection(content, 'In Progress'),
+    completed: parseSection(content, 'Completed'),
+  };
+}
+
+function parseSection(content, sectionName) {
+  const escaped = sectionName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const match = content.match(new RegExp(`##\\s+${escaped}\\n([\\s\\S]*?)(?=\\n##|$)`, 'i'));
+  if (!match) return [];
+
+  const body = (match[1] || '').trim();
+  if (!body || /^\(clean\)/i.test(body) || /^\(empty/i.test(body) || /^\(see /i.test(body)) return [];
+
+  const tasks = [];
+  const lines = body.split('\n');
+  let current = null;
+
+  for (const rawLine of lines) {
+    const line = rawLine.trimEnd();
+
+    // New task line: - **T1:** Description or - **T1:** Description [tag]
+    const taskMatch = line.match(/^- \*\*([A-Z]\d+):\*\*\s*(.+)$/);
+    if (taskMatch) {
+      if (current) tasks.push(current);
+      const tagMatch = taskMatch[2].match(/\[(\w+)\]\s*$/);
+      current = {
+        id: taskMatch[1],
+        title: tagMatch ? taskMatch[2].replace(/\s*\[\w+\]\s*$/, '').trim() : taskMatch[2].trim(),
+        tag: tagMatch ? tagMatch[1] : null,
+        claimed: null,
+        stage: null,
+      };
+      continue;
+    }
+
+    // Also support checkbox format: - [x] Description
+    const checkMatch = line.match(/^- \[[ x]\]\s+(.+)$/);
+    if (checkMatch && !current) {
+      tasks.push({
+        id: null,
+        title: checkMatch[1].trim(),
+        tag: null,
+        claimed: null,
+        stage: null,
+      });
+      continue;
+    }
+
+    // Plain bullet without ID: - Description
+    const plainMatch = line.match(/^- (.+)$/);
+    if (plainMatch && !current && !plainMatch[1].startsWith('**')) {
+      tasks.push({
+        id: null,
+        title: plainMatch[1].trim(),
+        tag: null,
+        claimed: null,
+        stage: null,
+      });
+      continue;
+    }
+
+    if (!current) continue;
+
+    // Claimed by line
+    const claimMatch = line.match(/\*\*Claimed by:\*\*\s*(.+)$/) || line.match(/Claimed by:\s*(.+)$/);
+    if (claimMatch) {
+      current.claimed = claimMatch[1].trim();
+      continue;
+    }
+
+    // Stage line
+    const stageMatch = line.match(/\*\*Stage:\*\*\s*(.+)$/) || line.match(/Stage:\s*(.+)$/);
+    if (stageMatch) {
+      current.stage = stageMatch[1].trim();
+      continue;
+    }
+  }
+
+  if (current) tasks.push(current);
+  return tasks;
+}
+
+/**
+ * Get latest journal entry for a team member.
+ * Reads the most recent file in atris/team/[member]/journal/
+ * Returns { date, entries[] } or null
+ */
+function getTeamMemberJournal(atrisDir, memberName) {
+  const journalDir = path.join(atrisDir, 'team', memberName, 'journal');
+  if (!fs.existsSync(journalDir)) return null;
+
+  let files;
+  try {
+    files = fs.readdirSync(journalDir)
+      .filter(f => f.endsWith('.md'))
+      .sort()
+      .reverse();
+  } catch {
+    return null;
+  }
+
+  if (files.length === 0) return null;
+
+  const latestFile = files[0];
+  let content;
+  try {
+    content = fs.readFileSync(path.join(journalDir, latestFile), 'utf8');
+  } catch {
+    return null;
+  }
+  const date = latestFile.replace('.md', '');
+
+  // Extract key fields from journal entry
+  const taskMatch = content.match(/\*\*Task:\*\*\s*(.+)/);
+  const deliveredMatch = content.match(/\*\*Delivered:\*\*\s*(.+)/);
+  const patternMatch = content.match(/\*\*Pattern:\*\*\s*(.+)/);
+  const learnedMatch = content.match(/\*\*Learned:\*\*\s*(.+)/);
+
+  return {
+    date,
+    file: path.join(journalDir, latestFile),
+    task: taskMatch ? taskMatch[1].trim() : null,
+    delivered: deliveredMatch ? deliveredMatch[1].trim() : null,
+    pattern: patternMatch ? patternMatch[1].trim() : null,
+    learned: learnedMatch ? learnedMatch[1].trim() : null,
+    raw: content,
+  };
+}
+
+/**
+ * Get all team members that have directories in atris/team/
+ */
+function listTeamMembers(atrisDir) {
+  const teamDir = path.join(atrisDir, 'team');
+  if (!fs.existsSync(teamDir)) return [];
+
+  return fs.readdirSync(teamDir)
+    .filter(name => {
+      if (name.startsWith('_') || name.startsWith('.')) return false;
+      const full = path.join(teamDir, name);
+      try { return fs.statSync(full).isDirectory(); } catch { return false; }
+    });
+}
+
+/**
+ * Get team activity: latest journal entry per member
+ */
+function getTeamActivity(atrisDir) {
+  const members = listTeamMembers(atrisDir);
+  const activity = [];
+
+  for (const member of members) {
+    const journal = getTeamMemberJournal(atrisDir, member);
+    if (journal) {
+      activity.push({ member, ...journal });
+    }
+  }
+
+  // Sort by date descending (most recent first)
+  activity.sort((a, b) => b.date.localeCompare(a.date));
+  return activity;
+}
+
+module.exports = {
+  parseTodo,
+  parseSection,
+  getTeamMemberJournal,
+  listTeamMembers,
+  getTeamActivity,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "2.4.0",
+  "version": "2.5.1",
   "description": "atrisDev (atris dev) - CLI for AI coding agents. Works with Claude Code, Cursor, Windsurf. Make any codebase AI-navigable.",
   "main": "bin/atris.js",
   "bin": {