atris 3.68.1 → 3.68.3

package/atris/skills/engines/SKILL.md

@@ -93,7 +93,7 @@ Smoke: `reply with the word OK`, run from `$HOME`, 120s cap, one at a time on a
 | Claude | `claude -p "<prompt>" --model claude-opus-5-5 --output-format json --no-session-persistence` | `claude-opus-5-5` | 2026-09-23 | 20.3 | `--model opus` also resolves to `claude-opus-5-5` today; pin the id for reproducibility. |
 | Codex | `codex exec --dangerously-bypass-approvals-and-sandbox --ephemeral -m gpt-6-sol -c model_reasoning_effort=high -o <result-file> "<prompt>" </dev/null` (run from the target repo/worktree; read-only: swap the bypass flag for `--sandbox read-only`) | `gpt-6-sol`, high | 2026-09-23 | 13.8 | Keep the `</dev/null`: with stdin open codex prints "Reading additional input from stdin..." and waits forever (observed 2026-09-23). Outside a git repo add `--skip-git-repo-check` or it exits 1 (re-checked 2026-09-23). Final answer lands in the `-o` file. Run as a tracked background Bash task; in one-shot `claude -p` workers run it in the FOREGROUND, a one-shot session never wakes again (2026-08-11). `codex-companion.mjs task --background` is deprecated: its job store never notifies the session (2026-08-10). |
 | Cursor | `cursor-agent --trust --model composer-2.5 -p "<prompt>"` (run from the target repo) | `composer-2.5` | 2026-09-23 | 37.5 | `--trust` required for non-interactive. |
-| Fable | `atris engine fable --timeout 120 --json "<question>"` | `claude-fable-5` | 2026-09-23 | 21.4 | Canonical read-only FABLE ask with receipt; scale `--timeout` to the work. |
+| Fable | `atris engine fable --timeout 120 --json "<question>"` | `claude-fable-5-1` | not re-run on 5.1 (2026-09-23 on `claude-fable-5`) | 21.4 | Canonical read-only FABLE ask with receipt; scale `--timeout` to the work. |
 | Composer | `cursor-agent --trust --model composer-2.5 -p "<prompt>"` | `composer-2.5` via Cursor | 2026-09-23 | 37.5 | Same binary as Cursor. |
 | Haiku | `claude -p "<prompt>" --model claude-haiku-5-5 --output-format json --no-session-persistence` | `claude-haiku-5-5` | 2026-10-07 | 9.5 | Fast validation and bounded read-only checks. |
 | Devin (build) | `devin -p --permission-mode dangerous --model swe-2-max --prompt-file <brief>` (run from an isolated worktree) | `swe-2-max` (Free tag in `devin models list`, 2026-09-23) | 2026-09-23 | 14.0 | In `-p` mode the default permission mode rejects shell commands too, so even a read-only audit dies after one step (2026-09-23). Keep the brief outside the worktree. Long runs (5+ min) can print nothing even on success: judge by the worktree diff. `devin cloud` outlives this machine. |

package/atris/team/customer-lead/MEMBER.md

@@ -2,7 +2,7 @@
 name: customer-lead
 role: Customer Lead
 description: Keeps customer commitments visible, spots retention risk, and turns evidence into the next useful follow-up.
-version: 1.0.0
+version: 2.0.0
 
 skills:
   - customer-commitments

package/atris/team/executor/MEMBER.md

@@ -2,9 +2,10 @@
 name: executor
 role: Builder
 description: Execute from build specs, one step at a time
-version: 1.0.0
+version: 2.0.0
 
 skills:
+  - isolated-slice-builder
   - code-writer
   - test-runner
 
@@ -40,16 +41,16 @@ tools: []
 
 ## Your Job
 
-When navigator hands you build.md:
+When navigator or the orchestrator hands you a build spec or idea:
 
-1. **Read build.md** — Exact files, steps, error cases
-2. **Execute one step at a time** — Never batch multiple steps
-3. **Show ASCII progress** — After each step, show what happened
-4. **Wait for confirmation** — Human approves before next step
-5. **Final summary** — When done, show ASCII completion status
-6. **Keep wiki memory honest** — If the task changes durable project knowledge, update the relevant `atris/wiki/` page or note the source for immediate ingest
+1. **Read the spec and MAP.md**: Exact files, steps, and edge cases
+2. **Execute one bounded slice per loop**: Stay in the declared file scope
+3. **Prove with bare checks**: Run the real test command (`node --test ...`) and `git diff --check` before finishing
+4. **Pass cross-model review**: Fix any referee feedback before marking work ready for human review
+5. **Final summary**: Report exact files changed, check command run, and plain-language outcome
+6. **Keep wiki and member memory honest**: Append the lesson to `logs/<today>.md` and update `atris/MAP.md` when routes change
 
-**DO NOT skip steps. DO NOT batch. One shot at a time.**
+**Never claim progress without a passing check. Stop for human approval only before destructive actions or out-of-scope refactors.**
 
 ---
 
@@ -114,15 +115,15 @@ If new evidence changes the task, stop and add a task note instead of forcing co
 
 ## Rules
 
-1. **Read build.md first** — Never guess, always follow the spec
-2. **One step at a time** — Show ASCII after each, wait for confirmation
-3. **Check MAP.md** — Verify file paths exist, update if structure changed
-4. **Run tests after changes** — Catch issues immediately
-5. **Check wiki context** — Read `atris/wiki/STATUS.md` if present before executing in a known area
-6. **No shortcuts** — Follow the build.md steps exactly
-7. **Anti-slop aware** — Read `atris/policies/ANTISLOP.md` before writing. No sparkles, no filler, no purple prose.
-8. **Stay in scope** — Only touch files listed in the task. If you need to change something outside scope, stop and flag it. That's a new task.
-9. **If no exit condition, stop** — A task without a clear "done" definition is not ready for execution. Send it back to navigator.
+1. **Read build.md first**: Never guess, always follow the spec
+2. **One step at a time**: Show ASCII after each, wait for confirmation
+3. **Check MAP.md**: Verify file paths exist, update if structure changed
+4. **Run tests after changes**: Catch issues immediately
+5. **Check wiki context**: Read `atris/wiki/STATUS.md` if present before executing in a known area
+6. **No shortcuts**: Follow the build.md steps exactly
+7. **Anti-slop aware**: Read `atris/policies/ANTISLOP.md` before writing. No sparkles, no filler, no purple prose.
+8. **Stay in scope**: Only touch files listed in the task. If you need to change something outside scope, stop and flag it. That's a new task.
+9. **If no exit condition, stop**: A task without a clear "done" definition is not ready for execution. Send it back to navigator.
 
 ---
 

package/atris/team/executor/skills/isolated-slice-builder/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: isolated-slice-builder
+description: Build one bounded code slice in an isolated checkout, prove it with a bare test command and git diff --check, and update MAP.md before review.
+version: 1.0.0
+tags:
+  - build
+  - verification
+  - worktree
+---
+
+# Isolated Slice Builder
+
+Use this skill when building a feature slice or dispatched task in an isolated checkout.
+
+## Workflow
+
+1. Read `atris/MAP.md` to jump directly to the target `file:line` locations.
+2. Edit only the files required for the current slice, using Node built-ins only.
+3. Add or update a regression test that exercises the real runtime behavior.
+4. Run the bare test command (`node --test <file>`) and `git diff --check`.
+5. Update `atris/MAP.md` if any exported function or command route changed.

package/atris/team/navigator/MEMBER.md

@@ -2,8 +2,10 @@
 name: navigator
 role: System Navigator
 description: Transform messy human intent into precise execution plans
-version: 1.0.0
+version: 2.0.0
 agent-id: navigator-3
+skills:
+  - loophole-proof-planner
 permissions:
   can-read: true
   can-plan: true

package/atris/team/navigator/skills/loophole-proof-planner/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: loophole-proof-planner
+description: Turn messy operator intent into single-slice tasks with exact file:line pointers, falsifiable bare test commands, and explicit rollback plans.
+version: 1.0.0
+tags:
+  - planning
+  - navigation
+  - confidence-gate
+---
+
+# Loophole Proof Planner
+
+Use this skill when turning a broad idea or goal into an executable roadmap.
+
+## Workflow
+
+1. Read `atris/MAP.md` first to locate exact `file:line` references without blind searching.
+2. Split work touching 4 or more files into ordered single-slice tasks.
+3. Attach a bare runnable check command (`node --test <file>`) and a rollback step to every task.
+4. Close every loophole (missing owner, vague exit condition, unrunnable check) before handing off to `executor`.

package/atris/team/researcher/MEMBER.md

@@ -2,9 +2,10 @@
 name: researcher
 role: Deep Researcher
 description: Find ground truth on any topic — competitors, standards, technologies, markets
-version: 1.0.0
+version: 2.0.0
 
 skills:
+  - grounded-evidence-brief
   - deep-search
   - source-verification
 

package/atris/team/researcher/skills/grounded-evidence-brief/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: grounded-evidence-brief
+description: Answer open technical or product questions using primary sources, exact file:line citations, and one actionable recommendation.
+version: 1.0.0
+tags:
+  - research
+  - evidence
+  - decision
+---
+
+# Grounded Evidence Brief
+
+Use this skill when investigating an unknown, comparing approaches, or benchmarking options before building.
+
+## Workflow
+
+1. Check local repo code and receipts first before external sources.
+2. Cite exact `file:line` paths or primary URLs for every factual claim.
+3. End with one concrete recommendation and the member that should execute it.

package/atris/team/validator/MEMBER.md

@@ -2,9 +2,10 @@
 name: validator
 role: Reviewer
 description: Validate execution, run tests, ensure quality before shipping
-version: 1.0.0
+version: 2.0.0
 
 skills:
+  - cross-model-referee
   - test-runner
   - doc-updater
 
@@ -30,12 +31,6 @@ tools: []
 
 **Validation:** Run `npm test` to verify changes work correctly.
 
-## Project Context
-
-**Project Type:** nodejs (nodejs)
-
-**Validation:** Run `npm test` to verify changes work correctly.
-
 ---
 
 ## MAPFIRST (Before ANY Validation)

package/atris/team/validator/skills/cross-model-referee/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: cross-model-referee
+description: Audit worker diffs from an independent model perspective, run bare test commands, block slop or unverified claims, and emit actionable fix instructions.
+version: 1.0.0
+tags:
+  - review
+  - verification
+  - referee
+---
+
+# Cross Model Referee
+
+Use this skill when validating a plan before execution or auditing a worker diff before merge.
+
+## Workflow
+
+1. Inspect `git status` and `git diff` directly rather than trusting the worker's summary.
+2. Run the declared test check bare (`node --test <file>`) and verify zero new dependencies in `package.json`.
+3. Check that `atris/MAP.md` was updated if any file or command route changed.
+4. Emit a concrete pass verdict or bounce with the exact line and failure that must be fixed.

package/bin/atris.js

@@ -6,6 +6,17 @@ process.on('unhandledRejection', (err) => {
   process.exit(1);
 });
 
+// node:sqlite (task state) ships unflagged in Node 22.13. On older Node the
+// first require crashes with ERR_UNKNOWN_BUILTIN_MODULE before any help prints.
+{
+  const [major, minor] = process.versions.node.split('.').map(Number);
+  if (major < 22 || (major === 22 && minor < 13)) {
+    console.error(`atris needs Node 22.13 or newer. this is Node ${process.versions.node}.`);
+    console.error('upgrade from https://nodejs.org, then run atris again.');
+    process.exit(1);
+  }
+}
+
 const fs = require('fs');
 const path = require('path');
 const { exec, spawnSync } = require('child_process');
@@ -67,9 +78,14 @@ const {
   isBareAtrisFlag,
   isFirstTalkLine,
   isLeftoverVerbLook,
+  isWhatsNextLine,
   listUserVisibleWork,
+  loadLocalTasks,
   personName,
   renderFirstTalk,
+  renderWhatsNextAsk,
+  firstTalkBuilder,
+  shippedHumanStarter,
   shouldAutoInitFresh,
 } = require('../lib/first-minute');
 
@@ -501,6 +517,7 @@ function showHelpShort() {
   console.log('  atris later "..."                remember without a room');
   console.log('  atris guide "..."                translate your words');
   console.log('  atris do                         work already here');
+  console.log('  atris done                       land what your agent built');
   console.log('  atris spaceship                  Keep working for a few hours');
   console.log('  atris autopilot                  Keep working until you stop');
   console.log('  atris mission                    the one goal');
@@ -512,6 +529,7 @@ function helpCatalog() {
   return [
     { name: 'init', summary: 'scaffold atris/ in this project', json: false, interactive_risk: 'medium' },
     { name: 'guide', summary: 'translate plain english into the right atris move', json: true, interactive_risk: 'none' },
+    { name: 'done', summary: 'land what your coding agent built: check, accept, sign', json: true, interactive_risk: 'low' },
     { name: 'task', summary: 'local task plane: new, claim, ready, accept', json: true, interactive_risk: 'low' },
     { name: 'review', summary: 'validate work and capture learnings', json: false, interactive_risk: 'low' },
     { name: 'recap', summary: 'spoken recap of what your team did', json: true, interactive_risk: 'low' },
@@ -532,6 +550,7 @@ function showHelpAll() {
   console.log('  atris later "..."                remember without a room');
   console.log('  atris guide "..."                translate your words');
   console.log('  atris do                         work already here');
+  console.log('  atris done                       land what your agent built');
   console.log('  atris spaceship                  Keep working for a few hours');
   console.log('  atris autopilot                  Keep working until you stop');
   console.log('  atris mission                    the one goal');
@@ -1430,7 +1449,7 @@ async function interactiveEntry(userInput, options = {}) {
       return 0;
     }
     console.log('');
-    console.log(renderFirstTalk({ person: who, folder: room, starter }));
+    console.log(renderFirstTalk({ person: who, folder: room, starter, builder: firstTalkBuilder() }));
     return 0;
   }
 
@@ -1519,6 +1538,23 @@ async function interactiveEntry(userInput, options = {}) {
   // Placeholder or missing MAP is already a first-minute job. Do not send the
   // operator to a rewrite lobby, and do not treat `test` as a new first task.
   if (mapStatus !== 'ready') {
+    // A person who already shipped their first want here can say the next one.
+    // It becomes their new task, the same way the first one did.
+    const nextWant = String(userInput || '').trim();
+    const shipped = nextWant && !options.asJson ? shippedHumanStarter(loadLocalTasks(workspaceDir)) : null;
+    if (shipped && !isLeftoverVerbLook(nextWant) && !isFlagLikeAnswer(nextWant) && !isAtrisMetaQuestion(nextWant)) {
+      const who = personName();
+      const room = folderName(workspaceDir);
+      console.log('');
+      if (isWhatsNextLine(nextWant) || isFirstTalkLine(nextWant)) {
+        console.log(renderWhatsNextAsk({ person: who, task: shipped, folder: room }));
+        return 0;
+      }
+      saveContextProfile(workspaceDir, nextWant, { source: 'next_talk' });
+      const starter = createStarterTask(workspaceDir, nextWant);
+      console.log(renderFirstTalk({ person: who, folder: room, starter, builder: firstTalkBuilder() }));
+      return 0;
+    }
     const screenOptions = {
       root: workspaceDir,
       context,
@@ -2229,6 +2265,9 @@ if (command === 'guide') {
 } else if (command === 'later') {
   const laterCode = require('../commands/later').laterAtris(process.argv.slice(3));
   process.exit(Number.isInteger(laterCode) ? laterCode : 0);
+} else if (command === 'done') {
+  const doneCode = require('../commands/done').doneAtris(process.argv.slice(3));
+  process.exit(Number.isInteger(doneCode) ? doneCode : 0);
 } else if (command === 'activate') {
   const args = process.argv.slice(3);
   if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {

package/commands/autoland.js

@@ -379,6 +379,7 @@ function sweepLanding(root, { ttlDays, staleHours, now = Date.now() } = {}) {
     remote: false,
     includeDetached: false,
     now,
+    by: 'atris autoland',
   });
   const afterBoard = collectBoard(root, { ttlDays, staleHours, now, light: true });
   const human = [];
@@ -926,7 +927,7 @@ async function runTickBody(root, { json, policy, receipt, engineValidationDeps =
     }
     try {
       const { cleanupWorktrees } = require('./worktree');
-      const cleaned = cleanupWorktrees({ root, apply: true });
+      const cleaned = cleanupWorktrees({ root, apply: true, by: 'atris autoland' });
       receipt.worktrees_reaped = cleaned.removed.length;
       if (cleaned.removed.length > 0) receipt.worktrees_reaped_paths = cleaned.removed.map((w) => w.path);
     } catch (err) {