atris 3.13.0 → 3.15.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
@@ -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.
 
@@ -73,9 +86,9 @@ 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,10 +97,18 @@ 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 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`.
+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 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:
 
 ```bash
@@ -116,12 +137,14 @@ 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 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
 
@@ -131,8 +154,10 @@ atris business record atris/reports/2026-04-12-operator-recap.md --outcome mixed
 - `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 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
+- `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
 
 ## Verifiable Feedback Loop
 

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/');
@@ -262,6 +270,7 @@ function showHelp() {
   console.log('Sync:');
   console.log('  pull       - Pull journals + member data from cloud');
   console.log('  push       - Push workspace files to cloud');
+  console.log('  live       - Keep a business brain fresh (doctor, pull, watch, push)');
   console.log('  clean-workspace <slug> - Analyze & remove junk files from a workspace (alias: cw)');
   console.log('');
   console.log('GitHub for Context:');
@@ -272,7 +281,7 @@ function showHelp() {
   console.log('  wake [business]    - Resume workspace (agents restart)');
   console.log('');
   console.log('Business:');
-  console.log('  business init <name>   - RECOMMENDED: create business environment (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,6 +289,7 @@ 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 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)');
@@ -290,9 +300,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');
@@ -433,8 +445,8 @@ 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', 'receipt', 'proof', 'openclaw', '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', 'live', 'align', 'terminal', 'computer', 'diff', 'business', 'sync',
+                       'ingest', 'query', 'lint', 'loop', 'task', 'aeo',
                        'gmail', 'calendar', 'twitter', 'slack', 'integrations', 'setup', 'clean-workspace', 'cw',
                        'fork', 'browse', 'publish', 'sleep', 'wake', 'feedback', 'errors', 'wiki', 'code-review', 'cr', 'soul', 'fleet'];
 
@@ -780,6 +792,16 @@ 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 === 'aeo') {
+  // AEO: AI Engine Optimization — credit-metered citation drafting against the customer workspace.
+  Promise.resolve(require('../commands/aeo').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') {
@@ -1088,6 +1110,10 @@ if (command === 'init') {
   require('../commands/push').pushAtris()
     .then(() => process.exit(0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'live') {
+  require('../commands/live').liveCommand()
+    .then(() => process.exit(0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'align') {
   require('../commands/align').alignAtris()
     .then(() => process.exit(0))

package/commands/aeo.js

@@ -0,0 +1,197 @@
+/**
+ * atris aeo — AI Engine Optimization commands
+ *
+ *   atris aeo init                          # create entity-graph skeleton in workspace
+ *   atris aeo draft "<topic>" [opts]        # generate citation-optimized article (credit-metered)
+ *
+ * Hits the backend endpoints registered under:
+ *   POST /api/business/{id}/workspaces/{ws}/aeo/init
+ *   POST /api/business/{id}/workspaces/{ws}/aeo/draft
+ *
+ * Business resolution mirrors `atris terminal`: explicit --workspace slug,
+ * else cwd .atris/business.json. The endpoint itself takes care of running
+ * Claude Sonnet 4.6 with the 10 AEO rules and writing to /workspace/atris/aeo/drafts/.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { loadCredentials } = require('../utils/auth');
+const { apiRequestJson } = require('../utils/api');
+const { loadBusinesses, saveBusinesses } = require('./business');
+
+function sleep(ms) { return new Promise((r) => setTimeout(r, ms)); }
+
+async function ensureAwake(token, businessId, maxWaitSec = 90) {
+  const status = await apiRequestJson(`/business/${businessId}/ai-computer/status`, { method: 'GET', token });
+  if (status.ok && status.data && status.data.status === 'running' && status.data.endpoint) return true;
+  process.stdout.write('  Waking EC2 computer... ');
+  await apiRequestJson(`/business/${businessId}/ai-computer/wake`, { method: 'POST', token });
+  const start = Date.now();
+  while (Date.now() - start < maxWaitSec * 1000) {
+    await sleep(3000);
+    const s = await apiRequestJson(`/business/${businessId}/ai-computer/status`, { method: 'GET', token });
+    if (s.ok && s.data && s.data.status === 'running' && s.data.endpoint) {
+      console.log(`awake (${Math.floor((Date.now() - start) / 1000)}s)`);
+      return true;
+    }
+  }
+  console.log('timeout');
+  return false;
+}
+
+async function resolveBusiness(token, slug) {
+  const businesses = loadBusinesses();
+  const list = await apiRequestJson('/business/', { method: 'GET', token });
+  if (list.ok) {
+    const match = (list.data || []).find(
+      (b) => b.slug === slug || b.name.toLowerCase() === slug.toLowerCase()
+    );
+    if (!match) return null;
+    businesses[slug] = {
+      business_id: match.id,
+      workspace_id: match.workspace_id,
+      name: match.name,
+      slug: match.slug,
+      added_at: new Date().toISOString(),
+    };
+    saveBusinesses(businesses);
+    return { businessId: match.id, workspaceId: match.workspace_id, businessName: match.name };
+  }
+  if (businesses[slug]) {
+    return {
+      businessId: businesses[slug].business_id,
+      workspaceId: businesses[slug].workspace_id,
+      businessName: businesses[slug].name || slug,
+    };
+  }
+  return null;
+}
+
+function pickSlug(args) {
+  const wsIdx = args.findIndex((a) => a === '--workspace' || a === '-w');
+  if (wsIdx !== -1 && args[wsIdx + 1]) {
+    const slug = args[wsIdx + 1];
+    args.splice(wsIdx, 2);
+    return slug;
+  }
+  const bizFile = path.join(process.cwd(), '.atris', 'business.json');
+  if (fs.existsSync(bizFile)) {
+    try { return JSON.parse(fs.readFileSync(bizFile, 'utf8')).slug; } catch { /* ignore */ }
+  }
+  return null;
+}
+
+function printHelp() {
+  console.log('Usage:');
+  console.log('  atris aeo init [--workspace <slug>]');
+  console.log('  atris aeo draft "<topic>" [--workspace <slug>] [--queries q1,q2] [--slug X] [--url URL]');
+  console.log('');
+  console.log('Examples:');
+  console.log('  atris aeo init');
+  console.log('  atris aeo draft "what is pallet" --queries "what is pallet,best freight platform"');
+  console.log('  atris aeo draft "how does atris work" --workspace doordash --slug atris-overview');
+}
+
+async function aeoInit(args) {
+  const slug = pickSlug(args);
+  if (!slug) {
+    console.error('Cannot determine business. Pass --workspace <slug> or run from a workspace.');
+    process.exit(1);
+  }
+  const creds = loadCredentials();
+  if (!creds || !creds.token) { console.error('Not logged in. Run: atris login'); process.exit(1); }
+
+  const biz = await resolveBusiness(creds.token, slug);
+  if (!biz) { console.error(`Business "${slug}" not found.`); process.exit(1); }
+  if (!biz.workspaceId) { console.error(`Business "${slug}" has no workspace.`); process.exit(1); }
+
+  const awake = await ensureAwake(creds.token, biz.businessId);
+  if (!awake) { console.error('  EC2 computer did not become ready in time.'); process.exit(1); }
+
+  const result = await apiRequestJson(
+    `/business/${biz.businessId}/workspaces/${biz.workspaceId}/aeo/init`,
+    { method: 'POST', token: creds.token, body: {}, timeoutMs: 60000 }
+  );
+  if (!result.ok) {
+    console.error(`✗ aeo init failed: ${result.errorMessage || result.error || result.status}`);
+    process.exit(1);
+  }
+  const data = result.data || {};
+  const created = data.created || [];
+  const skipped = data.skipped || [];
+  console.log(`✓ AEO entity graph @ ${data.dir}`);
+  if (created.length) console.log(`  created: ${created.map((p) => p.split('/').pop()).join(', ')}`);
+  if (skipped.length) console.log(`  existed: ${skipped.map((p) => p.split('/').pop()).join(', ')}`);
+}
+
+async function aeoDraft(args) {
+  // Pull --slug, --url, --queries, --workspace; remainder is the topic.
+  const opts = {};
+  for (const k of ['slug', 'url', 'queries']) {
+    const i = args.findIndex((a) => a === `--${k}`);
+    if (i !== -1 && args[i + 1]) {
+      opts[k] = args[i + 1];
+      args.splice(i, 2);
+    }
+  }
+  const slug = pickSlug(args);
+  const topic = args.join(' ').trim();
+  if (!topic) {
+    console.error('Missing topic. Usage: atris aeo draft "<topic>"');
+    process.exit(1);
+  }
+  if (!slug) {
+    console.error('Cannot determine business. Pass --workspace <slug> or run from a workspace.');
+    process.exit(1);
+  }
+  const creds = loadCredentials();
+  if (!creds || !creds.token) { console.error('Not logged in. Run: atris login'); process.exit(1); }
+
+  const biz = await resolveBusiness(creds.token, slug);
+  if (!biz) { console.error(`Business "${slug}" not found.`); process.exit(1); }
+  if (!biz.workspaceId) { console.error(`Business "${slug}" has no workspace.`); process.exit(1); }
+
+  const awake = await ensureAwake(creds.token, biz.businessId);
+  if (!awake) { console.error('  EC2 computer did not become ready in time.'); process.exit(1); }
+
+  const body = { topic };
+  if (opts.slug) body.slug = opts.slug;
+  if (opts.url) body.target_url = opts.url;
+  if (opts.queries) body.target_queries = opts.queries.split(',').map((s) => s.trim()).filter(Boolean);
+
+  process.stdout.write(`Drafting "${topic}" for ${biz.businessName}... `);
+  const t0 = Date.now();
+  const result = await apiRequestJson(
+    `/business/${biz.businessId}/workspaces/${biz.workspaceId}/aeo/draft`,
+    { method: 'POST', token: creds.token, body, timeoutMs: 180000 }
+  );
+  const elapsed = ((Date.now() - t0) / 1000).toFixed(1);
+  if (!result.ok) {
+    console.log('failed');
+    console.error(`✗ aeo draft failed (${result.status}): ${result.errorMessage || result.error}`);
+    process.exit(1);
+  }
+  const data = result.data || {};
+  console.log(`done (${elapsed}s)`);
+  console.log('');
+  console.log(`  path:           ${data.path}`);
+  console.log(`  self-score:     ${data.self_score ?? '?'}/10`);
+  console.log(`  credits:        ${data.credits_charged ?? '?'}`);
+  console.log(`  tokens:         in=${data.tokens?.input ?? '?'} out=${data.tokens?.output ?? '?'}`);
+  console.log(`  entity graph:   entities=${data.entity_graph?.has_entities ? 'y' : 'n'} defs=${data.entity_graph?.has_definitions ? 'y' : 'n'} stats=${data.entity_graph?.has_stats ? 'y' : 'n'}`);
+  if (data.overlay_active) console.log(`  overlay:        active (${data.overlay_lines} lines)`);
+  if (data.hint) console.log(`  hint:           ${data.hint}`);
+}
+
+async function run(args = []) {
+  const sub = args[0];
+  if (!sub || sub === 'help' || sub === '--help' || sub === '-h') return printHelp();
+  const rest = args.slice(1);
+  if (sub === 'init') return aeoInit(rest);
+  if (sub === 'draft') return aeoDraft(rest);
+  console.error(`Unknown aeo subcommand: ${sub}`);
+  printHelp();
+  process.exit(1);
+}
+
+module.exports = { run };