atris 3.82.25 → 3.83.0

package/AGENTS.md

@@ -208,14 +208,14 @@ named none. These rules are the difference, in priority order:
 **Protocol:** See `atris/atris.md` for full spec.
 
 <!-- ATRIS_BRAIN_COMPILE:START -->
-## Atris Brain Compile
+## Atris start-up notes
 
-This workspace has a compiled agent brain.
+This folder keeps notes that give every agent the same starting context.
 
-On session start, activate it first:
-`atris brain activate --root . --verify`
+At the start of a session, run this and read what it prints:
+`atris brain activate --root .`
 
-Load these first:
+Then read these files in order:
 - `atris/now.md`
 - `atris/brain/STATUS.md`
 - `atris/brain/self_improvement_ledger.md`
@@ -227,12 +227,10 @@ Load these first:
 - `atris/TODO.md`
 - `atris/wiki/index.md`
 
-First-message rule: lead with the move before writing to the operator.
-Purpose: optimize for decision-speed; lead with the move, then use descriptions only when they help the operator act.
-Shape: `<operator>, today is about <move>` -> `I picked this because <why now>` -> `Ready: <draft/proof/context>` -> `Go deeper: <paths>`.
-Definitions: operator = current person or agent; move = one concrete high-leverage workflow; why now = business reason; ready = prepared action or proof; paths = 2-4 optional deeper views.
+First reply: open with the one thing most worth doing today. Then say why, what is already prepared and where to look for more.
+Shape: `<name>, today is about <the one thing>` -> `I picked this because <why now>` -> `Ready: <what is prepared>` -> `Go deeper: <2 to 4 paths>`.
 
-Keep this voice beside every reply:
+Keep this voice in every reply:
 <!-- ATRIS_VOICE_CARD:START -->
 ## Voice card
 
@@ -247,6 +245,6 @@ Landing example:
 Replies now get a plain-language check before they reach you. The checks passed, and the change is ready.
 <!-- ATRIS_VOICE_CARD:END -->
 
-Re-run after meaningful work:
-`atris brain compile --root .`
+After meaningful work, save fresh notes:
+`atris brain compile --root . --yes`
 <!-- ATRIS_BRAIN_COMPILE:END -->

package/README.md

@@ -137,6 +137,15 @@ atris host import people.jsonl       # bulk add people and who already knows who
 atris host room                      # the host's weekly read
 ```
 
+### Design screens with Designer-1
+
+Designer-1 is a team member that builds web screens from a fixed set of 19 parts (button, field, select, dialog, tabs, row list and the rest). It reuses a part before writing one, keeps one spacing scale, writes very few words, and checks its work by keyboard, by control name, and at phone and desktop widths before it reports. A project's own taste files in `atris/taste/` win over its defaults.
+
+```bash
+atris member install designer-1
+atris member install designer-1 --update   # pick up the latest skill; your edits to its other files stay
+```
+
 ### Put members to work
 
 Members are helpers that work in their own copy of the repo. Three words cover it.
@@ -393,6 +402,74 @@ atris business record atris/reports/2026-04-12-operator-recap.md --outcome mixed
 - `atris pull` and `atris push` sync cloud workspaces and journals
 - `atris live` keeps a business brain fresh by checking/fixing the workspace, pushing local state, pulling cloud state, and pushing again after local changes go quiet
 
+## Agent page (beta)
+
+Agent page is one small browser file, in beta. An AI agent reads the controls on a page by their names, and presses them, without screenshots. It works on the page a person already has when that page is built from normal form controls and ARIA roles. It has no dependencies. The limits are listed below.
+
+The marks are a guardrail for well-behaved agents, not security. A page must still enforce its real rules on its server. Do not put real secrets in a page and rely on a mark to hide them: any software running in that page can read them.
+
+Load it with a plain script tag, or `require` it in Node and bundlers:
+
+```html
+<script src="node_modules/atris/lib/agent-page.js"></script>
+```
+
+```js
+const agent = AgentPage.createAgent({
+  allow: (request) => window.confirm(`Let the agent ${request.action} "${request.label}"?`),
+  timeout: 5 * 60 * 1000,
+});
+agent.snapshot();
+await agent.act({ steps: [{ label: 'Project name', action: 'set', args: { value: 'Atlas' } }] });
+await agent.query({ text: 'Role', kind: 'select' });
+```
+
+Three calls do the work.
+
+`snapshot()` lists the controls. Each one has a ref, a kind, a label, its value or checked or open state, and the actions it accepts right now. The list is capped at 100. A disabled or read-only control says so and accepts no actions.
+
+`act({ steps })` runs steps in order and stops at the first failure. Each step names a control by `ref` (from a snapshot) or by `label`, and gives an `action`: `click`, `set`, `check`, or `uncheck`. Each result shows the changes, the current value, and any error.
+
+After a change, the file finds the control again in the live page (the same element, or else the one visible control with the same kind and name) and reads its value there. A typed value, a tick, or a choice that did not stick reads as a failure, and so does a press on something that should open or close but did not. A plain press on a button or link says ok once it is delivered; the changes list shows what the page did with it. A disabled choice is refused.
+
+A select or listbox that holds more than one choice shows every chosen value as a list. To change it, send `set` the full list of choices to keep, for example `args: { value: ['Email', 'Chat'] }`. A single value is refused when it would clear other choices, so nothing is cleared unless the agent names the whole list. Hidden choices in such a list are left as they are.
+
+`query({ text, within, kind })` finds controls and lists the choices of a select or listbox. The list is capped at 50. With `text`, only the matching choices are listed, so a choice past the cap can still be found.
+
+Three marks on the page set the rules, with the `allow` callback.
+
+The `allow` callback decides, and it may return a promise. If you pass one, it runs before every change the agent makes, so the person sees each click, change, or tick first. It gets the control's label, the action and its args, whether the step is marked for confirmation, and the page's own confirm sentences in `reasons`. If the callback throws, the step fails with a fixed sentence; the error's own message is never passed to the agent.
+
+Before asking, the file lists the elements the step involves and the confirm marks around them. It lists them again after the answer and refuses the step if anything differs: a mark added, removed or reworded, or the control moved under a different mark. It reads the marks again before each part of the change too (after focus, between events, and before each choice it clicks), and stops with the rest undone if a new mark appears.
+
+One approval at a time per page. While a step waits for the person, every other agent on the page is refused, so one agent cannot press another's confirm button. A host's own confirm dialog should still carry `data-agent-hidden`, so no agent can see it at all.
+
+`data-agent-confirm` marks a control that needs a person. A step involves the control, its labels (wrapping and `for`), the form it belongs to (also through the `form` attribute), every field of that form when the press submits or resets it, each choice the step picks, and each choice or radio the step clears, hidden ones included, with their labels. A mark on any of these, or around them, counts. Without an `allow` callback, that step fails and tells the agent to ask the person.
+
+`data-agent-hidden` leaves a region out entirely. On a single choice, it leaves out that choice. A choice hidden by the `hidden` attribute or by css is left out the same way.
+
+`data-agent-secret` hides the value and all state of the marked control and everything inside it: value, checked, selected, open, and its choices all read `[redacted]`, and its actions do not change with its state. Its name stays visible, and comes only from a label element, `aria-label`, or `aria-labelledby`; placeholder, title, alt and the control's own text are never used. To hide the name too, use `data-agent-hidden`. Other text inside a secret mark is not read. The agent can still type into a secret field or pick a secret choice it already knows. Password, card, and one-time-code fields count as secret without a mark.
+
+A mark covers the element and everything inside it. Labels, values, changes and error sentences are built when the result is returned, with the marks as they are then: a value that became secret reads `[redacted]` on both sides of a change, and a control that is gone or hidden is reported by its ref only.
+
+A page can tell when the agent is acting. While an act step runs, `document.documentElement` has `data-agent-acting="true"`. Every event the agent fires carries `event.agentAct = { ref, action }`.
+
+What it cannot do:
+
+It reads the main page only. Controls inside iframes and shadow roots are not listed, so the agent cannot reach them. Snapshot and query add an entry of kind `unread` that counts what was skipped, so the agent knows. A custom element may hold a closed shadow root, so each one is counted as possibly unread.
+
+These limits are accepted. A closed shadow root on an ordinary element, or one made before this file loads, cannot be detected at all. Frames from other sites cannot be read. The file trusts the page it runs in: page scripts can always change anything, including the marks.
+
+A page whose own scripts add, remove or move marks, or swap controls, in the middle of an event is handled only as far as the checks above go: marks read again before each part of a change, and the control found again after it. Beyond that it is out of scope.
+
+Editable text regions (`contenteditable`) are not typed into. Plain ones are counted as unread. One with a textbox role is listed with its text and no actions.
+
+The tests here drive real Chrome. The controlled-input test imitates React with a hand-built value tracker; a check against real React is planned and not done yet.
+
+For agents that speak tools, `agentTools` lists three tools (`page_snapshot`, `page_act`, `page_query`) with JSON schemas. `registerTools(agent, { allow })` registers them on `document.modelContext` when the page offers it, and does nothing otherwise.
+
+The mark names and the snapshot, act, and query shape come from Vercel's UI SDK agent bridge. The code here is our own.
+
 ## Engines
 
 An engine is the intelligence that builds a mission. Every installed headless coding CLI is a swappable worker behind one contract: a bounded prompt goes in, verified proof comes out, and engines never self-certify their own work. The house default is `atris-fast` (`ax`); `claude`, `codex`, `cursor`, `devin`, `grok`, and others join when their CLIs are installed.

package/bin/atris.js

@@ -529,25 +529,25 @@ function showStartHelp() {
 }
 
 function showHelpShort() {
-  console.log('atris: you say what you want. already won. one next step.');
+  console.log('atris: say what you want. see what is already done. get one next step.');
   console.log('');
   console.log('Start here:');
   console.log('  1. atris init                    set up this folder');
   console.log('  2. atris doctor                  check this computer is ready');
-  console.log('  3. atris "what you want"         say it, the work starts');
+  console.log('  3. atris "what you want"         save what you want in plain words');
   console.log('');
-  console.log('  atris "what do you want here?"   empty folder');
-  console.log('  atris later "..."                remember without a room');
-  console.log('  atris idea "..."                 drop an idea; atris builds it later');
-  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');
-  console.log('  atris gm                         play your team as a front office');
+  console.log('  atris                            see where things stand and the next step');
+  console.log('  atris later "..."                save a thought for later');
+  console.log('  atris idea "..."                 save an idea for later work');
+  console.log('  atris guide "..."                suggest a command from your words');
+  console.log('  atris do                         see the next step for work here');
+  console.log('  atris done                       finish and keep what your agent built');
+  console.log('  atris spaceship                  plan a few hours of work');
+  console.log('  atris autopilot                  plan work that runs until you stop it');
+  console.log('  atris mission                    see the current goal');
+  console.log('  atris gm                         run your team like a sports front office');
   console.log('');
-  console.log('More: atris help --all   ·   machine list: atris help --json');
+  console.log('More: atris help --all   ·   command list for scripts: atris help --json');
 }
 
 function helpCatalog() {
@@ -571,24 +571,24 @@ function helpCatalog() {
 }
 
 function showHelpAll() {
-  console.log('you say what you want. already won. one next step.');
+  console.log('atris: say what you want. see what is already done. get one next step.');
   console.log('');
-  console.log('  atris later "..."                remember without a room');
-  console.log('  atris idea "..."                 drop an idea; atris builds it later');
-  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');
+  console.log('  atris later "..."                save a thought for later');
+  console.log('  atris idea "..."                 save an idea for later work');
+  console.log('  atris guide "..."                suggest a command from your words');
+  console.log('  atris do                         see the next step for work here');
+  console.log('  atris done                       finish and keep what your agent built');
+  console.log('  atris spaceship                  plan a few hours of work');
+  console.log('  atris autopilot                  plan work that runs until you stop it');
+  console.log('  atris mission                    see the current goal');
   console.log('  atris recap                      what your ai agent did today');
   console.log('  atris review                     check the work');
   console.log('  atris stop                       stop the live goal');
   console.log('');
-  console.log('Atris Computers:');
-  console.log('  Owner = User | Business');
-  console.log('  Owners have Computers: workspace + files + tools + secrets + memory + agents + validation');
-  console.log('  Types: code, research, CRM, reporting, events, support, business ops');
+  console.log('How it fits together:');
+  console.log('  you or your business can own computers.');
+  console.log('  a computer brings a workspace, files, tools, saved logins, memory, agents and checks together.');
+  console.log('  computers can be for code, research, sales, reporting, events, support or operations.');
   console.log('');
   console.log('Setup:');
   console.log('  setup      - Guided first-time setup (login, pick business, pull)');
@@ -760,6 +760,9 @@ function showHelpAll() {
   console.log('');
   console.log('Cloud & agents:');
   console.log('  computer   - Open a scoped AI computer (cloud/local, personal/business)');
+  console.log('  night      - Give your agent a goal for tonight with a dollar cap (atris night "<goal>" --cap 1)');
+  console.log('  morning    - How last night went: score, what it learned (saved to your atris/ folder), spend');
+  console.log('  join       - Join a computer as a named agent (--name), or accept an invite (<code>)');
   console.log('  receipt    - Save evidence from an agent run');
   console.log('  console    - Start/attach always-on coding console (tmux daemon)');
   console.log('  soul       - Show, snapshot, or fork workspace identity');
@@ -767,6 +770,8 @@ function showHelpAll() {
   console.log('  loops      - Self-improving loop audit/scaffold (`init`, `audit`, `tick`, `board`)');
   console.log('  self-improve - Alias for `atris loops init`');
   console.log('  agent      - Select cloud agent, spawn worker requests, or run `agent doctor`');
+  console.log('               agent pull|push|snapshot: carry an agent\'s home folder; agent spawn --budget: make a child agent');
+  console.log('               agent signin <agent> --key-file <path>: sign in with the agent\'s own key, print a token');
   console.log('  chat       - Chat with Atris 2 Fast in this workspace (--agent for cloud agent; or: atris chat scan)');
   console.log('  fast       - Chat with Atris2 Fast');
   console.log('  login      - Sign in, add an account, or mint a scoped agent token (--agent)');
@@ -819,6 +824,7 @@ function showHelpAll() {
   console.log('Team:');
   console.log('  member create <name> - Scaffold a new team member (MEMBER.md)');
   console.log('  member list          - Show all team members');
+  console.log('  member install <n>   - Add a ready-made member: host, designer-1');
   console.log('  member activate <n>  - Activate a member (link skills, show context)');
   console.log('  member upgrade <n>   - Convert flat file to directory format');
   console.log('  member result <n>    - Newest run of a member: run record, receipt, artifacts, result number');
@@ -840,7 +846,7 @@ function showHelpAll() {
   console.log('  version    - Show Atris version');
   console.log('  help       - you say what you want (help --all for every command)');
   console.log('');
-  console.log('Tip: Just run "atris" to get started');
+  console.log('tip: run "atris" to get started');
   console.log('');
 }
 
@@ -1732,7 +1738,13 @@ function showWelcomeVisualization() {
   const projectName = path.basename(cwd);
   const row = (label, value) => `  ${label.padEnd(9)}${value}`;
   const sub = (text) => `  ${' '.repeat(9)}- ${text}`;
-  const trimTitle = (t) => (String(t).length > 64 ? `${String(t).slice(0, 61)}...` : String(t));
+  const trimTitle = (t) => {
+    const title = require('../lib/first-minute').plainTitle(t);
+    if (title.length <= 64) return title;
+    const cut = title.slice(0, 61);
+    const boundary = cut.lastIndexOf(' ');
+    return `${(boundary > 0 ? cut.slice(0, boundary) : cut).trimEnd()}...`;
+  };
 
   let glance = {
     backlog: 0, active: 0, review: 0, reviewCertified: 0,
@@ -1818,7 +1830,7 @@ function showWelcomeVisualization() {
   console.log('');
 
   if (!isInitialized) {
-    console.log('  no atris workspace here yet.');
+    console.log('  atris is not set up in this folder yet.');
     console.log('');
     console.log(row('next', 'atris init  (set up this folder)'));
     console.log('');
@@ -1866,11 +1878,14 @@ function showWelcomeVisualization() {
 
   try {
     const health = require('../commands/doc-health').computeDocHealth(cwd);
-    if (health.ok) {
-      const detail = health.lookup_hops.missing
-        ? 'add atris/doc-health/questions.jsonl'
-        : `${Math.round((health.lookup_hops.score || 0) * 100)}% one hop · boot ${(health.boot_load.approximate_tokens / 1000).toFixed(1)}k tokens`;
-      console.log(row('docs', `${health.overall.total}/100 · ${detail}`));
+    const map = fs.readFileSync(path.join(atrisDir, 'MAP.md'), 'utf8');
+    const starterMap = map.includes('Run your AI agent with atris.md to populate this file.');
+    if (health.ok && map.trim() && !starterMap) {
+      const score = health.lookup_hops.score;
+      const detail = score === null
+        ? 'add sample questions to test the map: atris/doc-health/questions.jsonl'
+        : `the map answers ${score >= 1 ? 'every sample question' : `${Math.min(99, Math.round(score * 100))}% of sample questions`} · ${(health.boot_load.approximate_tokens / 1000).toFixed(1)}k tokens to read at start`;
+      console.log(row('docs', `${Math.round(health.overall.total)}/100 · ${detail}`));
     }
   } catch {
     // Document health is advisory and must never prevent startup.
@@ -1881,7 +1896,10 @@ function showWelcomeVisualization() {
   // journal, plus agent branches parked for a person.
   try {
     const lately = require('../lib/cleanup-summary').latestCleanupLine(cwd);
-    if (lately) console.log(row('lately', lately));
+    if (lately) {
+      const plain = lately.replace(/^[a-z][a-z -]{0,30}:\s*/i, '').replace(/\blanded\b/gi, 'completed').replace(/\bland on their own\b/gi, 'finish on their own').replace(/\b([0-9]+) agent branch(es)? parked for you\b/g, (m, n, many) => `${n} ${many ? 'pieces' : 'piece'} of agent work set aside for you`);
+      console.log(row('lately', plain.charAt(0).toLowerCase() + plain.slice(1)));
+    }
   } catch {
     // Advisory only; never blocks boot.
   }
@@ -1940,7 +1958,7 @@ function showWelcomeVisualization() {
     if (landInfo.due > 0) landText += ` (${landInfo.due} overdue)`;
     tidyBits.push(landText);
   }
-  if (rotInfo && rotInfo.worktrees > 0) tidyBits.push(`${rotInfo.worktrees} old cop${rotInfo.worktrees === 1 ? 'y' : 'ies'} to toss`);
+  if (rotInfo && rotInfo.worktrees > 0) tidyBits.push(`${rotInfo.worktrees} old cop${rotInfo.worktrees === 1 ? 'y' : 'ies'} to clear out`);
   if (rotInfo && rotInfo.lessons > 0) tidyBits.push(`${rotInfo.lessons} open problem${rotInfo.lessons === 1 ? '' : 's'}`);
   if (tidyBits.length) {
     console.log(row('tidy', tidyBits.join(', ')));
@@ -1953,7 +1971,7 @@ function showWelcomeVisualization() {
     const rev = require('../commands/improve').collectRevisionSignals(cwd, { days: 7 });
     const fixed = Number.isFinite(rev.fixed) ? rev.fixed : rev.revised;
     if (fixed > 0) {
-      console.log(`  ${fixed} landing${fixed === 1 ? '' : 's'} this week needed a human fix; run atris improve revisions`);
+      console.log(`  ${fixed} finished change${fixed === 1 ? '' : 's'} needed a human fix this week; run atris improve revisions (see what needed fixing)`);
     }
   } catch {
     // Silent: the gauge never blocks boot.
@@ -1966,7 +1984,7 @@ function showWelcomeVisualization() {
     wikiNudge = '';
   }
   if (wikiNudge) {
-    console.log(`  ${wikiNudge}`);
+    console.log(`  ${wikiNudge.replace('the wiki has grown a lot since its last pruning; run: atris wiki consolidate', 'the project notes have grown; run atris wiki consolidate (review notes to combine)')}`);
   }
 
   console.log(row('logs', journalEntries > 0
@@ -1990,7 +2008,7 @@ function showWelcomeVisualization() {
     const teamLine = require('../lib/team-lineup').bootTeamLine(cwd, { width: 80 - 11, jobs });
     if (teamLine) console.log(row('team', teamLine));
     const endsLine = engineView.bootExpiringLine(engineView.expiringWorkers(jobs));
-    if (endsLine) console.log(row('roster', endsLine));
+    if (endsLine) console.log(row('tools', endsLine.replace('renew: atris engine roster confirm', 'run atris engine roster confirm (renew the assigned tools)')));
   } catch {
     // Silent: the lineup is a hint, not a gate.
   }
@@ -2012,7 +2030,7 @@ function showWelcomeVisualization() {
       .filter((intent) => intent.offer === 'boot_empty')
       .map((intent) => intent.say[0])
       .slice(0, 2);
-    console.log(row('say', `"${phrases[0]}" or "${phrases[1]}"  (your agent translates)`));
+    console.log(row('say', `"${phrases[0]}" or "${phrases[1]}"  (say it to your agent in your own words)`));
   }
 
   // The next command always carries a plain-english gloss: a newcomer should
@@ -2023,7 +2041,7 @@ function showWelcomeVisualization() {
   } else if (landInfo && landInfo.due > 0) {
     next = `atris land --reap  (put away the overdue work)`;
   } else if (endgameState.slug !== 'unset') {
-    next = 'atris autopilot  (do the next piece of work)';
+    next = 'atris autopilot  (keep working on the goal; it asks before it starts)';
   } else {
     next = 'atris plan  (plan the first tasks)';
   }
@@ -2287,10 +2305,21 @@ if (command === 'guide') {
       if (process.argv.slice(3).includes('--json')) {
         console.log(JSON.stringify({ ok: false, error: message }, null, 2));
       } else {
-        console.error(`\n✗ Error: ${message}`);
+        console.error(message);
       }
       process.exit(1);
     });
+} else if (command === 'agent' && process.argv[3] === 'signin') {
+  // An agent signs in with its own private key; no owner login, no --account gate.
+  Promise.resolve().then(() => require('../commands/agent-signin').agentSigninCommand(process.argv.slice(4)))
+    .then((code) => exitAfterStdoutDrain(code || 0))
+    .catch((err) => { console.error(`\nerror: ${err.message || err}`); process.exit(1); });
+} else if (command === 'agent' && require('../commands/agent-home').isHomeCommand(process.argv.slice(3))) {
+  // pull/push/snapshot/spawn --budget name one agent (by id, saved name, or the
+  // pulled folder), and the server checks ownership, so no --account gate.
+  Promise.resolve().then(() => require('../commands/agent-home').agentHomeCommand(process.argv.slice(3)))
+    .then((code) => exitAfterStdoutDrain(code || 0))
+    .catch((err) => { console.error(`\nerror: ${err.message || err}`); process.exit(1); });
 } else if (command === 'agent') {
   {
     const gate = requireAccountBound(process.argv.slice(3));
@@ -3598,8 +3627,24 @@ if (command === 'guide') {
       .catch((err) => { console.error(`✗ Error: ${err.message || err}`); process.exit(1); });
   }
 } else if (command === 'join') {
-  require('../commands/social').joinCommand()
-    .then(() => exitAfterStdoutDrain(0))
+  // `atris join --name <name>` joins as an agent; `atris join <code>` accepts an invite.
+  const joinArgs = process.argv.slice(3);
+  if (require('../commands/join').isAgentJoin(joinArgs)) {
+    Promise.resolve().then(() => require('../commands/join').joinAgentCommand(joinArgs))
+      .then((code) => exitAfterStdoutDrain(typeof code === 'number' ? code : 0))
+      .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+  } else {
+    require('../commands/social').joinCommand()
+      .then(() => exitAfterStdoutDrain(0))
+      .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+  }
+} else if (command === 'night') {
+  Promise.resolve().then(() => require('../commands/night').nightCommand(process.argv.slice(3)))
+    .then((code) => exitAfterStdoutDrain(typeof code === 'number' ? code : 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'morning') {
+  Promise.resolve().then(() => require('../commands/morning').morningCommand(process.argv.slice(3)))
+    .then((code) => exitAfterStdoutDrain(typeof code === 'number' ? code : 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'invite') {
   require('../commands/social').inviteCommand()
@@ -3780,8 +3825,14 @@ async function agentAtris() {
   const firstArg = process.argv[3];
   if (firstArg === '-h' || firstArg === '--help' || firstArg === 'help') {
     console.log('Usage: atris agent [doctor|spawn|spawns|spawn-status]');
+    console.log('       atris agent [pull|push|snapshot] and atris agent spawn <parent> --name <name> --budget <credits>');
+    console.log('       atris agent signin <agent> [--key-file <path>] [--json]');
     console.log('');
     console.log('  Pick which cloud agent to chat with from this workspace.');
+    console.log('  Run `atris agent pull <agent> --dir <folder>` to copy an agent\'s home here; any engine started there becomes it.');
+    console.log('  Run `atris agent push` inside that folder to send changes back, `atris agent snapshot` to save a version.');
+    console.log('  Run `atris agent spawn <parent> --name <name> --budget <credits>` to make a child agent; its key goes to ~/.atris/agents.');
+    console.log('  Run `atris agent signin <agent> [--key-file <path>]` to sign in with the agent\'s own key; prints only a token.');
     console.log('  Run `atris agent spawn <role> --task "..."` to create a worker request.');
     console.log('  Run `atris agent spawns` to list worker requests.');
     console.log('  Run `atris agent doctor` to verify local AI CLIs can see Atris context.');

package/commands/activate.js

@@ -5,6 +5,7 @@ const { getLogPath, ensureLogDirectory, createLogFile } = require('../lib/journa
 const { detectWorkspaceState, loadContext } = require('../lib/state-detection');
 const { readWikiStatus } = require('../lib/wiki');
 const { gateForHuman, numberWord } = require('../lib/voice-gate');
+const { plainTitle } = require('../lib/first-minute');
 
 const CLARITY_FIELDS = [
   { key: 'focus', label: 'Focus' },
@@ -120,7 +121,7 @@ function activeWorkSentence(state, context) {
   const tasks = Array.isArray(context?.inProgressTasks) ? context.inProgressTasks : [];
   if (tasks.length) {
     const count = tasks.length;
-    const focus = focusFragment(tasks[0]);
+    const focus = focusFragment(plainTitle(tasks[0]));
     const subject = count === 1 ? 'task is' : 'tasks are';
     return humanSentence(`right now: ${countWord(count)} ${subject} in progress; the focus is ${closeSentence(focus)}`);
   }
@@ -152,8 +153,7 @@ function activeWorkSentence(state, context) {
   return null;
 }
 
-function activateAtris() {
-  const workspaceDir = process.cwd();
+function buildActivationSummary(workspaceDir) {
   const targetDir = path.join(workspaceDir, 'atris');
 
   if (!fs.existsSync(targetDir)) {
@@ -166,12 +166,7 @@ function activateAtris() {
   const todoFile = path.join(targetDir, 'TODO.md');
   const legacyTaskContextsFile = path.join(targetDir, 'TASK_CONTEXTS.md');
 
-  // Journal (create today's file if missing so the system is always runnable)
-  ensureLogDirectory();
-  const { logFile, dateFormatted } = getLogPath();
-  if (!fs.existsSync(logFile)) {
-    createLogFile(logFile, dateFormatted);
-  }
+  const logFile = path.join(workspaceDir, 'atris', 'logs', path.relative(path.join(process.cwd(), 'atris', 'logs'), getLogPath().logFile));
 
   const state = detectWorkspaceState(workspaceDir);
   const context = loadContext(workspaceDir);
@@ -247,7 +242,7 @@ function activateAtris() {
   try {
     const { nextMoves } = require('../lib/next-moves');
     const { profilePaths } = require('../lib/clarity');
-    const root = process.cwd();
+    const root = workspaceDir;
     moves = nextMoves(root, 3);
     const { profile, mdPath } = readActivationClarityProfile(root, profilePaths);
     clarityLine = formatClarityLine(profile, rel(mdPath));
@@ -258,19 +253,6 @@ function activateAtris() {
     const { buildBriefData } = require('./brief');
     briefData = buildBriefData(workspaceDir);
   } catch { /* brief is best-effort */ }
-  try {
-    const { syncStatus } = require('../lib/sync-status');
-    syncStatus(workspaceDir);
-  } catch { /* sync status is best-effort */ }
-
-  void dateFormatted;
-  void learningCount;
-  fs.existsSync(personaFile);
-  fs.existsSync(mapFile);
-  void taskFilePath;
-
-  console.log(humanSentence('atris is up.'));
-
   const statusLines = [
     handoffSentence(handoffContent),
     completionSentence(recentCompletions),
@@ -286,20 +268,44 @@ function activateAtris() {
       statusLines.push(`waiting on you: ${countWord(approvalCount)} ${approvalLabel}. see them: atris task reviews`);
     }
   }
-  if (statusLines.length) {
+  const nextMove = moves[0] || briefData?.moves?.[0];
+  const nextMoveTitle = focusFragment(plainTitle(nextMove?.title), 100);
+  const today = nextMoveTitle ? humanSentence(`today's move: ${closeSentence(nextMoveTitle)}`) : null;
+  return {
+    lines: statusLines,
+    note: statusLines.find(line => line.startsWith('last session left a note:')) || null,
+    landed: statusLines.find(line => line.startsWith('since last time:')) || null,
+    right_now: statusLines.find(line => line.startsWith('right now:')) || null,
+    waiting: statusLines.find(line => line.startsWith('waiting on you:') || line === 'nothing is waiting on you.') || null,
+    today, clarityLine,
+  };
+}
+
+function activateAtris() {
+  const workspaceDir = process.cwd();
+  if (!fs.existsSync(path.join(workspaceDir, 'atris'))) {
+    console.log('✗ atris/ folder not found. Run "atris init" first.');
+    process.exit(1);
+  }
+  ensureLogDirectory();
+  const { logFile, dateFormatted } = getLogPath();
+  if (!fs.existsSync(logFile)) createLogFile(logFile, dateFormatted);
+  const summary = buildActivationSummary(workspaceDir);
+  try {
+    const { syncStatus } = require('../lib/sync-status');
+    syncStatus(workspaceDir);
+  } catch { /* sync status is best-effort */ }
+  console.log(humanSentence('atris is up.'));
+  if (summary.lines.length) {
     console.log('');
-    statusLines.forEach((line) => console.log(line));
+    summary.lines.forEach((line) => console.log(line));
   }
-
   console.log('');
-  console.log(clarityLine || 'Tip: run atris clarity once so agents learn how you work.');
-
-  const nextMove = moves[0] || briefData?.moves?.[0];
-  const nextMoveTitle = focusFragment(nextMove?.title, 100);
-  if (nextMoveTitle) {
+  console.log(summary.clarityLine || 'tip: run atris clarity once so agents learn how you work.');
+  if (summary.today) {
     console.log('');
-    console.log(humanSentence(`today's move: ${closeSentence(nextMoveTitle)}`));
+    console.log(summary.today);
   }
 }
 
-module.exports = { activateAtris, wikiHealthSentence };
+module.exports = { activateAtris, wikiHealthSentence, buildActivationSummary };