atris 3.12.1 → 3.14.0

package/README.md

@@ -4,6 +4,16 @@
 
 It turns any repo into an AI workspace with shared context, a `plan -> do -> review` loop, daily logs, feature packs, and reusable skills.
 
+Atris gives every owner persistent AI computers.
+
+```text
+Owner = User | Business
+Owner has many Computers
+Computer = workspace + files + tools + secrets + memory + agents + validation loop
+```
+
+A computer can be personal or shared by a business. It can run a job like code, research, CRM, reporting, recruiting, event ops, support, or business ops.
+
 ## For Coding Agents
 
 If you're an agent, run:
@@ -19,6 +29,8 @@ Then read the workspace's `atris/atris.md` and follow it exactly. `atris.md` is
 ## What Atris Gives You
 
 - An AI workspace on top of any repo
+- Persistent AI computers for scoped jobs
+- A local computer card that makes each workspace inspectable
 - A strict `plan -> do -> review` loop
 - Daily logs, task tracking, feature packs, and project memory
 - Skills, team members, integrations, and cloud sync when you need them
@@ -27,7 +39,7 @@ Then read the workspace's `atris/atris.md` and follow it exactly. `atris.md` is
 
 | File | Purpose |
 |------|---------|
-| `atris/atris.md` | God file. Protocol and source of truth |
+| `atris/atris.md` | Main instructions for agents working in this repo |
 | `atris/MAP.md` | Navigation index with file:line refs |
 | `atris/TODO.md` | Shared task queue |
 | `atris/logs/YYYY/YYYY-MM-DD.md` | Daily log, inbox, notes, completions |
@@ -54,6 +66,7 @@ atris --version
 ```
 
 Requires Node.js 18+.
+`atris task` uses built-in SQLite and requires Node.js 22+.
 
 If you want Atris cloud workspaces, businesses, or integrations, run `atris setup` after install.
 
@@ -67,15 +80,15 @@ atris
 
 `atris init` scaffolds the workspace, including `atris/wiki/`. `atris` loads context and hands the workflow off to `atris/atris.md`.
 
-If you're still shaping the idea, use `atris brainstorm`. If you want Atris to keep cycling, use `atris run` or `atris autopilot`. If you want the repo brain kept honest, use `atris loop`. `atris activate` now surfaces wiki state from `atris/wiki/STATUS.md` when it exists.
+If you're still shaping the idea, use `atris brainstorm`. If you want Atris to keep cycling, use `atris run` or `atris autopilot`. If you want project memory checked for stale pages and missing context, use `atris loop`. `atris activate` surfaces wiki state from `atris/wiki/STATUS.md` when it exists.
 
 Core loop: `plan` -> `do` -> `review`
 
 Integrates with any agent.
 
-## Business Workspaces
+## Business Owners
 
-If you want a real business workspace, use the business command instead of raw `atris init`.
+If you want a shared owner for a company, lab, collective, community, artist, team, or project, use the business command instead of raw `atris init`.
 
 ```bash
 atris business init "BLOND:ISH" --owner-email joel@blondish.world
@@ -84,9 +97,17 @@ atris business onboard --website https://blondish.world --contact "Joel Zimmerma
 atris align --fix
 ```
 
-That creates the cloud business, writes `.atris/business.json`, initializes `.atris/state/` for events, episodes, and scorecards, and scaffolds the local `atris/` workspace under `~/arena/atris-business/<slug>/` with starter team lanes, a default recap artifact, and a first-loop starter queue in `atris/TODO.md`.
+That creates the shared owner, creates its first/default computer, writes `.atris/business.json`, initializes `.atris/state/` for events and run history, and scaffolds the local `atris/` workspace under `~/arena/atris-business/<slug>/` with starter roles, a default recap template, and an initial task queue in `atris/TODO.md`.
 
-If you do not have a neat source pack yet, `atris business onboard` is the low-friction intake step: give it a website, a named human, a few notes, or even just run it in a folder with loose files, and it seeds raw intake, a starter brief, a first loop, a safe next action, and an operator one-pager for you.
+If you do not have a neat source pack yet, `atris business onboard` is the easiest intake step: give it a website, a named human, a few notes, or run it in a folder with loose files. Atris turns that into raw intake, a starter brief, a first workflow, a safe next action, and a short operator brief.
+
+Use the owner's language when you talk about it:
+
+```text
+Your business runs on Atris.
+Your lab runs on Atris.
+Your collective runs on Atris.
+```
 
 You can also use bare input:
 
@@ -116,30 +137,34 @@ atris business record atris/reports/2026-04-12-operator-recap.md --outcome mixed
 | `atris autopilot` | Guided loop with approvals |
 | `atris log` | Add inbox items to today's journal |
 | `atris status` | Show active work and completions |
+| `atris task` | Local agent task plane with atomic claims and TODO import |
 | `atris learn` | Manage structured learnings |
 | `atris ingest` | Stage raw evidence into `atris/context/` and compile into `atris/wiki/` |
 | `atris loop` | Refresh wiki health, stale/orphan signals, and next ingest candidates |
 | `atris wiki` | Full wiki namespace: ingest, query, lint, search, log, and loop |
-| `atris experiments` | Run Karpathy-style keep/revert packs |
+| `atris receipt` | Save evidence from an agent run |
+| `atris experiments` | Run small experiments and compare results |
+| `atris computer card` | Show or write the local owner/computer card |
 
 ## Built-In Systems
 
 - `atris learn` stores structured project memory in `atris/learnings.jsonl`
 - `atris wiki` keeps repo memory in `atris/wiki/` by default, with `--cloud` when you want the remote workspace path
 - `atris ingest` now stages local source packs under `atris/context/_ingest/`, writes a manifest receipt, and refreshes `atris/wiki/STATUS.md` plus `log.md`
-- `atris wiki --private` uses `.atris/presidio/` for local-only sensitive notes and operating memory
+- `atris wiki --private` stores local-only sensitive notes under `.atris/presidio/`
 - `atris loop` refreshes `atris/wiki/STATUS.md` and `atris/wiki/log.md`, flags stale/orphan pages, and suggests the next ingest
 - `atris activate` loads the current wiki status so the next session starts with project memory, not just tasks
-- `atris experiments` runs Karpathy-style keep/revert loops in `atris/experiments/`
+- `atris task` keeps a local SQLite task plane for agents while `atris/TODO.md` remains the readable project board
+- `atris experiments` runs small test packs in `atris/experiments/`
 - `atris pull` and `atris push` sync cloud workspaces and journals
 
 ## Verifiable Feedback Loop
 
 Under the hood, Atris can keep score on real repo work.
 
-- Endgame tasks can carry a `Verify:` command, so work can end on a deterministic check instead of pure prose.
-- `atris autopilot` can run that check after review, record a reward in the journal, and append a local scorecard when a horizon closes.
-- Future horizon picks can weight against recent scorecards, so the loop learns from repo-local history without claiming model retraining.
+- Tasks can carry a `Verify:` command, so work can end on a deterministic check instead of pure prose.
+- `atris autopilot` can run that check after review and record the result in the journal.
+- Future task picks can use recent results, so Atris learns from repo-local history without claiming model retraining.
 
 ## Benchmark Harness
 
@@ -167,7 +192,7 @@ What to inspect:
 - receipts land in `atris/experiments/endstate-baseline/artifacts/` and
   `atris/experiments/endstate-stack/artifacts/`
 - scores append to each pack's `results.tsv`
-- `atris experiments compare endstate` prints the latest side-by-side scorecard
+- `atris experiments compare endstate` prints the latest side-by-side comparison
 - `atris experiments replay endstate` runs the full public dry-run rehearsal
 - the benchmark contract lives at `atris/features/endstate/contract.md`
 - the verification log lives at `atris/features/endstate/validate.md`
@@ -198,7 +223,7 @@ For Codex, copy any skill folder into `~/.codex/skills/`.
 ## v3.2.0
 
 - **Staleness gate** — tasks tagged `[unverified]` are skipped at the moment of use, not pruned eagerly. Three-state model: actionable / unverified / deleted.
-- **Lesson gate** — `isLessonResolved` checks whether a lesson already shipped before proposing new horizons from it. Prevents the loop from re-solving solved problems.
+- **Lesson gate** — `isLessonResolved` checks whether a lesson already shipped before proposing new work from it. Prevents the loop from re-solving solved problems.
 - **`atris release`** — new command: tags the version, bumps package.json, creates a GitHub release, and drafts a `/launch` post in one shot.
 - **Shell injection fix** — `checkStaleness` switched from `execSync` string interpolation to `execFileSync` with args arrays. Markdown-derived content (task titles, inbox items) no longer reaches a shell.
 - **Codex hardening** — `atris activate` and `atris` entry point detect Codex environments and write `AGENTS.md` so Codex sessions start with workspace context.

package/bin/atris.js

@@ -204,19 +204,26 @@ function showHelp() {
   console.log('');
   console.log('Quick Start:');
   console.log('');
-  console.log('  1. atris                  Load context, start building');
-  console.log('  2. Describe what you want (in your editor or terminal)');
-  console.log('  3. Agent shows visualization, you approve, it builds');
+  console.log('  1. atris                  Open a persistent AI computer for this workspace');
+  console.log('  2. Describe what you want run, built, researched, or validated');
+  console.log('  3. Atris acts with context, memory, tools, and a review loop');
   console.log('');
   console.log('Common invocations:');
   console.log('  atris init');
+  console.log('  atris computer');
+  console.log('  atris business init "My Company"');
   console.log('  atris run');
   console.log('  atris status');
   console.log('  atris soul');
-  console.log('  atris fleet');
+  console.log('  atris fleet status');
   console.log('');
   console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
   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, recruiting, events, support, business ops');
+  console.log('');
   console.log('Setup:');
   console.log('  setup      - Guided first-time setup (login, pick business, pull)');
   console.log('  init       - Initialize Atris in current project');
@@ -237,6 +244,7 @@ function showHelp() {
   console.log('  search     - Search journal history (atris search <keyword>)');
   console.log('  clean      - Housekeeping (stale tasks, archive journals, broken refs)');
   console.log('  verify     - Validate work is done (tests, MAP.md, changes)');
+  console.log('  task       - Local agent task plane (atomic claims, TODO import)');
   console.log('  release    - Tag release, bump version, create GitHub release, draft /launch');
   console.log('  learn      - Project learnings (patterns, pitfalls, preferences)');
   console.log('  ingest     - Local-first wiki ingest into atris/wiki/');
@@ -247,7 +255,7 @@ function showHelp() {
   console.log('Optional helpers:');
   console.log('  brainstorm - Explore ideas conversationally before planning');
   console.log('  autopilot  - Guided loop that can clarify TODOs and run plan → do → review');
-  console.log('  visualize  - Legacy visualization helper (prefer "atris plan")');
+  console.log('  visualize  - Generate a Slack/deck-ready visual from a prompt');
   console.log('');
   console.log('Experiments:');
   console.log('  experiments init [slug]     - Prepare atris/experiments/ or scaffold a pack');
@@ -272,7 +280,7 @@ function showHelp() {
   console.log('  wake [business]    - Resume workspace (agents restart)');
   console.log('');
   console.log('Business:');
-  console.log('  business init <name>   - Create canonical business workspace (cloud + local)');
+  console.log('  business init <name>   - Create shared owner + first/default computer');
   console.log('  business onboard       - Onboard from sparse input (--name, --website, --contact)');
   console.log('  business add <slug>    - Connect a business');
   console.log('  business list          - Show connected businesses');
@@ -280,7 +288,8 @@ function showHelp() {
   console.log('  business team [slug]   - Show members, roles, and admin access');
   console.log('  business health <slug> - Health report (members, workspace, issues)');
   console.log('  business audit         - One-line health summary of all businesses');
-  console.log('  business create <name> - Create new business; add --workspace for canonical local scaffold');
+  console.log('  business doctor        - Catch stale cache, alias, and folder bindings');
+  console.log('  business create <name> - Cloud-only business record; add --workspace to also scaffold local');
   console.log('  business connect <svc> - Wire a skill/integration');
   console.log('  business notify <mode> - Set notification mode (digest/silent/push)');
   console.log('  business deploy <slug> - Push local business to cloud');
@@ -290,8 +299,11 @@ function showHelp() {
   console.log('  cr --all               - Audit all backend services');
   console.log('');
   console.log('Cloud & agents:');
-  console.log('  computer   - Talk directly to the AI computer (bash or agent exec)');
+  console.log('  computer   - Open a scoped AI computer (cloud/local, personal/business)');
+  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');
+  console.log('  fleet      - Inspect local fleet status');
   console.log('  agent      - Select which Atris agent to use');
   console.log('  chat       - Chat with the selected Atris agent');
   console.log('  login      - Sign in or add another account');
@@ -432,10 +444,10 @@ const { planAtris: planCmd, doAtris: doCmd, reviewAtris: reviewCmd } = require('
 // Check if this is a known command or natural language input
 const knownCommands = ['init', 'log', 'status', 'analytics', 'visualize', 'brainstorm', 'autopilot', 'run', 'plan', 'do', 'review', 'release',
                        'activate', '_activate', 'agent', 'chat', 'console', 'login', 'logout', 'whoami', 'switch', 'use', 'accounts', '_resolve', '_profile-email', '_switch-session', 'shell-init', 'update', 'upgrade', 'version', 'help', 'next', 'atris',
-                       'clean', 'verify', 'search', 'skill', 'member', 'app', 'learn', 'plugin', 'experiments', 'pull', 'push', 'align', 'terminal', 'computer', 'diff', 'business', 'sync',
-                       'ingest', 'query', 'lint', 'loop',
+                       'clean', 'verify', 'search', 'skill', 'member', 'app', 'learn', 'plugin', 'experiments', 'receipt', 'proof', 'openclaw', 'pull', 'push', 'align', 'terminal', 'computer', 'diff', 'business', 'sync',
+                       'ingest', 'query', 'lint', 'loop', 'task',
                        'gmail', 'calendar', 'twitter', 'slack', 'integrations', 'setup', 'clean-workspace', 'cw',
-                       'fork', 'browse', 'publish', 'sleep', 'wake', 'feedback', 'wiki', 'code-review', 'cr', 'soul', 'fleet'];
+                       'fork', 'browse', 'publish', 'sleep', 'wake', 'feedback', 'errors', 'wiki', 'code-review', 'cr', 'soul', 'fleet'];
 
 // Check if command is an atris.md spec file - triggers welcome visualization
 function isSpecFile(cmd) {
@@ -779,6 +791,11 @@ if (command === 'init') {
       console.error(`✗ Error: ${error.message || error}`);
       process.exit(1);
     });
+} else if (command === 'task') {
+  // SQLite-backed task plane. ~/.atris/tasks.db, gitignored, per-workspace.
+  Promise.resolve(require('../commands/task').run(process.argv.slice(3)))
+    .then(() => process.exit(0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'agent') {
   agentAtris().then(() => process.exit(0)).catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'log') {
@@ -868,10 +885,9 @@ if (command === 'init') {
 } else if (command === 'shell-init') {
   require('../commands/auth').shellInit();
 } else if (command === 'visualize') {
-  console.log('ℹ️  "atris visualize" is a legacy helper. Visualization is now built into "atris plan".');
-  console.log('   Prefer: atris plan');
-  console.log('');
-  require('../commands/visualize').visualizeAtris();
+  require('../commands/visualize').visualizeAtris(process.argv.slice(3))
+    .then(() => process.exit(0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'run') {
   const args = process.argv.slice(3);
   if (args.includes('--help') || args.includes('-h')) {
@@ -1160,6 +1176,10 @@ if (command === 'init') {
   const subcommand = process.argv[3];
   const args = process.argv.slice(4);
   require('../commands/experiments').experimentsCommand(subcommand, ...args);
+} else if (command === 'receipt' || command === 'proof' || command === 'openclaw') {
+  const subcommand = process.argv[3];
+  const args = process.argv.slice(4);
+  require('../commands/proof').proofCommand(subcommand, ...args);
 } else if (command === 'setup') {
   require('../commands/setup').setupAtris()
     .then(() => process.exit(0))
@@ -1188,6 +1208,10 @@ if (command === 'init') {
   require('../commands/feedback').feedbackCommand()
     .then(() => process.exit(0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'errors') {
+  require('../commands/errors').errorsCommand()
+    .then(() => process.exit(0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else {
   console.log(`Unknown command: ${command}`);
   console.log('Run "atris help" to see available commands');