atris 3.57.3 → 3.58.5

package/commands/workflow.js

@@ -612,7 +612,7 @@ async function planAtris(userInput = null) {
 
   if (showFactory) {
   console.log('┌─────────────────────────────────────────────────────────────┐');
-  console.log('│ Atris Plan — Navigator Agent Activated                      │');
+  console.log('│ Atris Plan - Navigator Agent Activated                     │');
   console.log('└─────────────────────────────────────────────────────────────┘');
   console.log('');
 
@@ -641,7 +641,7 @@ async function planAtris(userInput = null) {
   console.log(`- Navigator spec: ${navigatorPath || 'atris/team/navigator/MEMBER.md (missing)'}`);
   console.log(`- Persona: ${personaFileRef || 'atris/PERSONA.md (missing)'}`);
   const mapDisplay = mapFileRef
-    ? `${mapFileRef}${mapIsPlaceholder ? ' (placeholder — generate first)' : ''}`
+    ? `${mapFileRef}${mapIsPlaceholder ? ' (placeholder, generate first)' : ''}`
     : 'atris/MAP.md (missing)';
   console.log(`- MAP: ${mapDisplay}`);
   console.log(`- TODO: ${taskSourcePath || 'atris/TODO.md (missing)'}`);
@@ -710,11 +710,12 @@ async function planAtris(userInput = null) {
     console.log('');
   }
   console.log('Workflow:');
-  console.log('1) ASCII visualize + wait for approval');
+  console.log('1) ASCII visualize; use existing approval for this scope, otherwise wait for approval');
   console.log('2) Run the Confidence Gate before writing tasks');
   printConfidenceGate('   ');
-  console.log('3) Write tasks to atris/TODO.md under ## Backlog');
-  console.log('   Format: - **T#:** Description [explore|execute]');
+  console.log('3) Create each task in the live task plane: `atris task add "<title>" --tag <tag>`, then `atris task plan <id> --goal ... --exit ... --proof-needed ...`');
+  console.log('   Keep a delegated owner: `atris task delegate "<title>" --to <member>`; plan keeps that owner unless you pass --owner');
+  console.log('   atris/TODO.md is a generated view: never hand-edit it, regenerate with `atris task render --out atris/TODO.md`');
   console.log('4) Log to atris/team/navigator/logs/YYYY-MM-DD.md');
   console.log('   (Task, Delivered, User reaction, Pattern)');
   if (atris2Mode) {
@@ -783,7 +784,7 @@ async function planAtris(userInput = null) {
     userPrompt += `Your job (execute these steps):\n\n`;
     userPrompt += `STEP 1: Generate ASCII visualizations for user approval\n`;
     userPrompt += `   Create diagrams showing architecture, flows, schemas, UI/UX.\n`;
-    userPrompt += `   SHOW these diagrams and wait for approval before proceeding.\n\n`;
+    userPrompt += `   SHOW these diagrams; use existing approval for this scope, otherwise wait for approval before proceeding.\n\n`;
     userPrompt += `STEP 2: Run the Confidence Gate before writing tasks\n`;
     userPrompt += confidenceGatePrompt('plan') + `\n\n`;
     userPrompt += `STEP 3: Break approved ideas into concrete tasks\n`;
@@ -799,7 +800,7 @@ async function planAtris(userInput = null) {
     userPrompt += `STEP 5: Log to your journal\n`;
     userPrompt += `   - Write to atris/team/navigator/logs/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 += `   - Your journal is how you learn, so record what worked\n\n`;
     userPrompt += `Start planning now. Read MAP.md for file references.`;
 
     console.log('');
@@ -866,6 +867,73 @@ async function planAtris(userInput = null) {
   // Prompt mode continues with existing output (already logged above)
 }
 
+// Both executor surfaces require the exact live record before any work.
+// The rendered list omits raw instructions and cannot select the mission.
+function executorDispatchForTask(task) {
+  const metadata = task && task.metadata || {};
+  return {
+    taskId: task && task.id || '',
+    owner: metadata.assigned_to || task && task.claimed_by || metadata.stage_owner || '',
+    goalId: metadata.goal_id || '',
+    missionId: metadata.mission_id || '',
+    objective: metadata.task_goal || metadata.goal_objective || metadata.stage_goal || '',
+    workspaceRoot: task && task.workspace_root || '',
+  };
+}
+
+function validateExecutorDispatch(expected = {}, task) {
+  if (!expected.taskId || !expected.owner || (!expected.goalId && !expected.missionId && !expected.objective)) {
+    return { ok: false, reason: 'missing task, owner, or mission in dispatch' };
+  }
+  const actual = executorDispatchForTask(task);
+  if (!task || ['taskId', 'owner', 'goalId', 'missionId', 'objective', 'workspaceRoot']
+    .some(key => (expected[key] || '') !== (actual[key] || ''))) {
+    return { ok: false, reason: 'task, owner, or mission changed since dispatch' };
+  }
+  if (!['open', 'claimed'].includes(task.status)
+    || (task.status === 'claimed' && task.claimed_by !== expected.owner)) {
+    return { ok: false, reason: 'task is inactive or claimed by another owner' };
+  }
+  return { ok: true };
+}
+
+function executorTaskHandoff({ taskId = '', owner = '', goalId = '', missionId = '', objective = '' } = {}) {
+  const ref = taskId || '<task-id>';
+  const expected = JSON.stringify({ taskId: taskId || null, owner: owner || null, goalId: goalId || null, missionId: missionId || null, objective: objective || null });
+  return `Expected dispatch: ${expected}. Before claiming or editing, run \`atris task show ${ref} --json\` for the exact current dispatched task. If the expected task ID, owner, or mission is missing, stop; no edits are allowed. Do not select another displayed row. Check the ID, current mission, active status (open or claimed by the same owner), and functional owner against these expected values. Refuse a stale or mismatched task. Read the raw metadata, requirements, events, and verify command for exact paths, flags, and engine/model instructions; the explanation and rendered TODO are summaries only. Then claim that same task with \`atris task claim ${ref} --as <task-owner>\`, using its recorded functional owner and keeping the engine separate.`;
+}
+
+// The executor prompt sent to a backend agent in --execute mode. Kept as a
+// pure function so the emitted instructions can be tested without a network:
+// the agent claims and finishes work through the live task plane, and treats
+// atris/TODO.md as a generated view it never hand-edits.
+function executorAgentPrompt({ filteredTasks = '', taskSource = 'atris/TODO.md', context = 'UNKNOWN', taskId = '', owner = '', goalId = '', missionId = '', objective = '' } = {}) {
+  let userPrompt = `⚠️ CRITICAL: Execute tasks NOW. Use file tools to edit code, terminal to run commands.\n\n`;
+  userPrompt += `You are the Executor. Get it done, precisely, following instructions perfectly.\n\n`;
+
+  if (filteredTasks) {
+    userPrompt += `## REFERENCE TASK SUMMARIES (generated view from ${taskSource}; live truth is \`atris task list\`):\n${filteredTasks}\n\n`;
+  } else {
+    userPrompt += `## TASKS TO EXECUTE:\n(No tasks found - run \`atris task list\` for the live task plane)\n\n`;
+  }
+
+  userPrompt += `Your process (EXECUTE these steps):\n`;
+  userPrompt += `1. ${executorTaskHandoff({ taskId, owner, goalId, missionId, objective })}\n`;
+  userPrompt += `2. For this task: Show ASCII visualization first (especially complex changes)\n`;
+  userPrompt += `3. Run the Confidence Gate before editing\n`;
+  userPrompt += confidenceGatePrompt('do') + `\n`;
+  userPrompt += `4. Execute task: Use file edit tools, terminal commands, etc.\n`;
+  userPrompt += `5. Before completion, rerun the gate against proof and residual risk\n`;
+  userPrompt += `6. Send it to review: \`atris task ready <id> --proof "<commands run>"\`; a human accepts. Never hand-edit TODO.md; \`atris task render --out atris/TODO.md\` regenerates it\n`;
+  userPrompt += `7. Log to atris/team/executor/logs/YYYY-MM-DD.md\n`;
+  userPrompt += `   (Task, Delivered, Errors hit, Learned)\n`;
+  userPrompt += `8. 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`;
+  userPrompt += `Start only the dispatched task after the raw-record check.`;
+  return userPrompt;
+}
+
 async function doAtris() {
   const { loadConfig } = require('../utils/config');
   const { loadCredentials, ensureValidCredentials } = require('../utils/auth');
@@ -1044,7 +1112,7 @@ async function doAtris() {
     console.log(`- Executor spec: ${executorPath || 'atris/team/executor/MEMBER.md (missing)'}`);
     console.log(`- Persona: ${personaFileRef || 'atris/PERSONA.md (missing)'}`);
     const mapDisplay = mapPath
-      ? `${mapPath}${mapIsPlaceholder ? ' (placeholder — generate first)' : ''}`
+      ? `${mapPath}${mapIsPlaceholder ? ' (placeholder, generate first)' : ''}`
       : 'atris/MAP.md (missing)';
     console.log(`- MAP: ${mapDisplay}`);
     console.log(`- TODO: ${taskSourcePath || 'atris/TODO.md (missing)'}`);
@@ -1097,17 +1165,17 @@ async function doAtris() {
       console.log('');
     }
     console.log('Workflow:');
-    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(`1) ${executorTaskHandoff(executorDispatchForTask(firstMinute && firstMinute.task))}`);
+    console.log('   The live task plane is truth; never hand-edit TODO.md to claim or move work');
     console.log('2) Run the Confidence Gate against the task before editing');
     printConfidenceGate('   ');
     console.log('3) Execute step-by-step. Run tests as you go.');
     console.log('4) Before completion, rerun the gate against proof and residual risk');
-    console.log('5) When done, move task to ## Completed');
+    console.log('5) When done, send it to review: `atris task ready <id> --proof "<commands run>"`; a human accepts, then `atris task render --out atris/TODO.md` refreshes the view');
     console.log('6) Log to atris/team/executor/logs/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('⛔ Do NOT plan, just execute what\'s written.');
     console.log('');
 
     console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
@@ -1146,6 +1214,10 @@ async function doAtris() {
 
   // Check execution mode
   if (executionMode === 'agent') {
+    // Bind edit permission to the selected live task, not its rendered summary.
+    const dispatch = executorDispatchForTask(firstMinute && firstMinute.task);
+    const dispatchCheck = validateExecutorDispatch(dispatch, firstMinute && firstMinute.task);
+    if (!dispatchCheck.ok) throw new Error(`executor dispatch refused: ${dispatchCheck.reason}`);
     // Agent mode: execute via backend API
     if (!config.agent_id) {
       throw new Error('No agent selected. Run "atris agent" first.');
@@ -1175,29 +1247,11 @@ async function doAtris() {
     }
 
     // Build user prompt with context
-    let userPrompt = `⚠️ CRITICAL: Execute tasks NOW. Use file tools to edit code, terminal to run commands.\n\n`;
-    userPrompt += `You are the Executor. Get it done, precisely, following instructions perfectly.\n\n`;
-
-    if (filteredTasks) {
-      userPrompt += `## TASKS TO EXECUTE (from ${taskSource}):\n${filteredTasks}\n\n`;
-    } else {
-      userPrompt += `## TASKS TO EXECUTE:\n(No tasks found - check TODO.md)\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. Run the Confidence Gate before editing\n`;
-    userPrompt += confidenceGatePrompt('do') + `\n`;
-    userPrompt += `4. Execute task: Use file edit tools, terminal commands, etc.\n`;
-    userPrompt += `5. Before completion, rerun the gate against proof and residual risk\n`;
-    userPrompt += `6. Move task to ## Completed in TODO.md\n`;
-    userPrompt += `7. Log to atris/team/executor/logs/YYYY-MM-DD.md\n`;
-    userPrompt += `   (Task, Delivered, Errors hit, Learned)\n`;
-    userPrompt += `8. 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`;
-    userPrompt += `Start executing tasks now.`;
+    const taskDb = require('../lib/task-db');
+    const liveTask = taskDb.getTask(taskDb.open(), dispatch.taskId);
+    const currentDispatchCheck = validateExecutorDispatch(dispatch, liveTask);
+    if (!currentDispatchCheck.ok) throw new Error(`executor dispatch refused: ${currentDispatchCheck.reason}`);
+    const userPrompt = executorAgentPrompt({ filteredTasks, taskSource, context, ...dispatch });
 
     console.log('');
     console.log('🤖 AGENT MODE: Executing via backend API...');
@@ -1417,13 +1471,13 @@ async function reviewAtris() {
   }
 
   const mapDisplay = mapPath
-    ? `${mapPath}${mapIsPlaceholder ? ' (placeholder — generate first)' : ''}`
+    ? `${mapPath}${mapIsPlaceholder ? ' (placeholder, generate first)' : ''}`
     : 'atris/MAP.md (missing)';
 
   if (showFull) {
     console.log('');
     console.log('┌─────────────────────────────────────────────────────────────┐');
-    console.log('│ Atris Review — Validator Agent Activated                    │');
+    console.log('│ Atris Review - Validator Agent Activated                   │');
     console.log('└─────────────────────────────────────────────────────────────┘');
     console.log('');
 
@@ -1594,7 +1648,7 @@ async function reviewAtris() {
     userPrompt += `  • Verify everything works\n`;
     userPrompt += `  • Find all plausible loopholes; patch them or name residual risk\n`;
     userPrompt += `  • Test thoroughly (unless user says no)\n`;
-    userPrompt += `  • Confirm active task state is clean — no unresolved Backlog/In Progress/Blocked rows for reviewed work.\n`;
+    userPrompt += `  • Confirm active task state is clean, with no unresolved Backlog/In Progress/Blocked rows for reviewed work.\n`;
     userPrompt += `    If durable task state changed, regenerate the readable view with \`atris task render --out atris/TODO.md\`.\n`;
     userPrompt += `    Do not hand-delete rendered completed history; if a task fails, move or mark it blocked with a note.\n`;
     userPrompt += `  • Log to atris/team/validator/logs/YYYY-MM-DD.md\n`;
@@ -1718,7 +1772,7 @@ async function reviewAtris() {
         if (fs.existsSync(logFile)) {
           let journalContent = fs.readFileSync(logFile, 'utf8');
           const timestamp = new Date().toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', hour12: false });
-          const learning = `- ${timestamp} — ${answer.trim()}`;
+          const learning = `- ${timestamp} \u2014 ${answer.trim()}`;
 
           // Find or create ## Notes section
           if (journalContent.includes('## Notes')) {
@@ -1742,7 +1796,7 @@ async function reviewAtris() {
           addLearning({ type, key, insight, confidence: 7, source: 'review', files: [] });
           console.log(`✓ Saved to learnings: [7/10] ${type}/${key}`);
         } catch {
-          // learnings module not available — skip silently
+          // learnings module not available, so skip silently
         }
       }
 
@@ -1844,6 +1898,9 @@ module.exports = {
   doAtris,
   reviewAtris,
   renderReviewMinute,
+  executorAgentPrompt,
+  executorDispatchForTask,
+  validateExecutorDispatch,
   executeAgentSDKFast,
   makeCloudExecutor,
   postToolResult

package/commands/worktree.js

@@ -6,11 +6,14 @@ const { spawnSync } = require('child_process');
 const { hasFlag, readFlag } = require('../lib/arg-parser');
 const { stampLatestOpenBriefForWorktree } = require('../lib/brief-ledger');
 const { isConductorArtifact } = require('../lib/conductor-artifacts');
+const close = require('./close');
 
 const REGEN_ADAPTER_FILES = ['AGENTS.md', 'CLAUDE.md', 'GEMINI.md'];
 const COMMAND_MAX_BUFFER_BYTES = 64 * 1024 * 1024;
 const GIT_OID_PATTERN = /^[0-9a-f]{40,64}$/;
 const ONE_LAP_PROOF_REF_PATTERN = /^refs\/atris\/one-lap\/([0-9a-f]{40,64})$/;
+const DAY_MS = 24 * 60 * 60 * 1000;
+const SHIP_HEALTH_SOURCE = 'ship-health:experiments-daily';
 
 function runGit(args, { cwd = process.cwd(), check = true, timeout } = {}) {
   const result = spawnSync('git', args, { cwd, encoding: 'utf8', timeout });
@@ -672,6 +675,56 @@ function findPrimaryRoot(root) {
   return worktrees[0]?.path || root;
 }
 
+function shellQuote(value) {
+  const text = String(value || '');
+  if (/^[A-Za-z0-9_./:@+-]+$/.test(text)) return text;
+  return `'${text.replace(/'/g, `'"'"'`)}'`;
+}
+
+function experimentHealthProbe(statePath) {
+  const script = [
+    "const fs=require('fs')",
+    'const state=JSON.parse(fs.readFileSync(process.argv[1],\'utf8\'))',
+    'const last=Date.parse(state.last_run_date)',
+    `process.exit(Number.isFinite(last)&&Date.now()-last<=${DAY_MS}?0:1)`,
+  ].join(';');
+  return `${shellQuote(process.execPath)} -e ${shellQuote(script)} ${shellQuote(statePath)}`;
+}
+
+function runShipHealthCheck(workspaceRoot, options = {}) {
+  try {
+    const now = options.now ? new Date(options.now) : new Date();
+    const statePath = path.join(workspaceRoot, '.atris', 'state', 'experiments-daily.json');
+    const state = fs.existsSync(statePath)
+      ? JSON.parse(fs.readFileSync(statePath, 'utf8'))
+      : {};
+    const rawLastRunDate = state && state.last_run_date;
+    const lastRunMs = rawLastRunDate ? Date.parse(rawLastRunDate) : null;
+    if (rawLastRunDate && !Number.isFinite(lastRunMs)) {
+      throw new Error('experiment state date is unreadable');
+    }
+
+    const ageMs = Number.isFinite(lastRunMs) ? now.getTime() - lastRunMs : null;
+    if (ageMs !== null && ageMs <= DAY_MS) return { healthy: true, filed: false };
+
+    const days = ageMs === null ? 1 : Math.max(1, Math.floor(ageMs / DAY_MS));
+    console.log(`health check failed: no verified experiment in ${days} days. shipping still works, the metabolism does not.`);
+    const filed = close.upsertSourceFlag({
+      what: 'no verified experiment has run in over a day',
+      owner: 'operator',
+      lane: 'code',
+      ttlDays: 1,
+      source: SHIP_HEALTH_SOURCE,
+      closeCondition: 'a verified experiment ran within 24 hours',
+      probe: experimentHealthProbe(statePath),
+    }, workspaceRoot, { now });
+    return { healthy: false, ...filed };
+  } catch (error) {
+    console.log(`health check skipped: ${String(error && error.message || error).toLowerCase()}. shipping still works.`);
+    return { healthy: null, filed: false, error };
+  }
+}
+
 function shipWorktree(args) {
   if (hasFlag(args, '--help') || hasFlag(args, '-h') || args[0] === 'help') {
     shipHelp();
@@ -825,6 +878,7 @@ function shipWorktree(args) {
       }
     }
     console.log('pr: skipped (local mode)');
+    if (merge && !dryRun) runShipHealthCheck(primary || root);
     console.log('done: worktree shipped');
     return 0;
   }
@@ -870,6 +924,7 @@ function shipWorktree(args) {
       note: `worktree ship completed into ${targetRef}`,
     }, { worktree: root });
   } catch {}
+  if (merge && !dryRun) runShipHealthCheck(primary || root);
   console.log('done: worktree shipped');
   return 0;
 }
@@ -884,7 +939,7 @@ function guard(args) {
     return 2;
   }
   // Conductor plumbing (worktree metadata, the fleet prompt written for this very
-  // engine, runtime scratch, the brief ledger) must not count as dirt — otherwise the
+  // engine, runtime scratch, the brief ledger) must not count as dirt, otherwise the
   // harness blocks the engine with the harness's own files.
   const counts = statusCounts(root, { ignoreUntracked: isConductorArtifact });
   if (counts && (counts.staged || counts.unstaged || counts.untracked) && !hasFlag(args, '--allow-dirty')) {
@@ -1219,5 +1274,6 @@ module.exports = {
   taskTokens,
   statusCounts,
   swarloClaim,
+  runShipHealthCheck,
   worktreeCommand,
 };

package/commands/write.js

@@ -1,14 +1,14 @@
-// atris write — guided writing sessions (plan-do-review for prose).
+// atris write: guided writing sessions (plan-do-review for prose).
 //
 // The contract: the human types every word of the draft. Atris structures the
 // session (outline beats with states), tracks progress against the plan, and
 // reviews against the taste gate (writing policy + slop detector). It NEVER
-// writes or rewrites prose — review output is suggestions, not edits.
+// writes or rewrites prose. Review output is suggestions, not edits.
 //
 // Session = a folder of plain markdown, so the same files open in the web and
 // desktop editors with no extra format:
 //   atris/writing/<slug>/plan.md    outline beats: [ ] empty, [~] drafted, [x] passed
-//   atris/writing/<slug>/draft.md   the piece — human-only territory
+//   atris/writing/<slug>/draft.md   the piece, human-only territory
 //
 // Usage:
 //   atris write start "<topic>" [--dump "raw ideas"] [--beats "a | b | c"]
@@ -17,7 +17,7 @@
 //   atris write pass <n> [slug]   mark beat n passed (human calls it, not the AI)
 //   atris write list              list sessions
 //
-// Zero external deps (Node built-ins only) — repo contract.
+// Zero external deps (Node built-ins only). Repo contract.
 
 const fs = require('fs');
 const path = require('path');
@@ -212,7 +212,7 @@ function review(argv, root = process.cwd()) {
     console.log(`  ⚠ ${empty.length} beat${empty.length === 1 ? '' : 's'} still empty: ${empty.map((b) => b.title).join(', ')}`);
   }
   if (findings.length) {
-    console.log(`\n  slop tells (fix them yourself — atris never edits your draft):`);
+    console.log(`\n  slop tells (fix them yourself, atris never edits your draft):`);
     for (const f of findings) console.log(`  ✗ draft.md:${f.line}  ${f.rule.padEnd(16)} ${f.why}`);
   } else {
     console.log(`  ✓ slop scan clean`);
@@ -235,7 +235,7 @@ function pass(argv, root = process.cwd()) {
   const beat = plan.beats.find((b) => b.n === n);
   if (!beat) { console.error(`  no beat ${n} in ${slug}`); return 2; }
   const counts = draftWordCounts(slug, plan.beats, root);
-  if ((counts.get(n) || 0) === 0) { console.error(`  beat ${n} "${beat.title}" has no words yet — write it first`); return 2; }
+  if ((counts.get(n) || 0) === 0) { console.error(`  beat ${n} "${beat.title}" has no words yet, write it first`); return 2; }
   beat.state = 'x';
   writePlanStates(slug, plan.beats, root);
   console.log(`  ● passed: ${n}. ${beat.title}`);
@@ -370,17 +370,17 @@ function coach(argv, root = process.cwd()) {
 
 function help() {
   console.log(`
-  atris write — guided writing sessions (you write every word; atris structures + reviews)
+  atris write: guided writing sessions (you write every word; atris structures + reviews)
 
     atris write                   the coach: knows where you are, gets you going
     atris write start "<topic>" [--dump "..."] [--beats "a | b | c"]
     atris write coach [slug]      the coach: cheers your best line, asks the next question (--offline for no-LLM)
     atris write status [slug]     progress against the outline (beats landed)
     atris write review [slug]     taste gate: slop scan + writing-policy passes (read-only)
-    atris write pass <n> [slug]   mark beat n passed — the human calls it
+    atris write pass <n> [slug]   mark beat n passed, the human calls it
     atris write list              all sessions
 
-  sessions are plain markdown in atris/writing/<slug>/ — the same files open
+  sessions are plain markdown in atris/writing/<slug>/, the same files open
   in the web and desktop editors. atris never writes or edits your draft.
 `);
   return 0;