atris 3.15.45 → 3.15.48

package/commands/sync.js

@@ -172,6 +172,85 @@ function ensureWorkspaceStateFiles(targetRoot, params, options = {}) {
   return created;
 }
 
+function renderBusinessAgentAdapter(bizMeta = {}, targetRoot = '.') {
+  const name = bizMeta.name || bizMeta.slug || 'this business';
+  const slug = bizMeta.slug || 'business';
+  const rootHint = targetRoot || '.';
+  return [
+    `# AGENTS.md - ${name} Atris Workspace`,
+    '',
+    `You are operating inside the shared Atris workspace for ${name} (${slug}).`,
+    '',
+    '## Start Here',
+    '',
+    'Run these first from the workspace root:',
+    '',
+    '```bash',
+    'atris',
+    'atris business start',
+    'atris radar',
+    'atris task next',
+    'atris member activate operator',
+    '```',
+    '',
+    'If no active mission exists, start the first bounded business loop:',
+    '',
+    '```bash',
+    'atris mission status --status active --json',
+    `atris mission start "Run the first useful loop for ${name}" --owner operator --runner codex_goal --lane business --verify "atris business check" --stop "first proof recap recorded"`,
+    'atris member goal-from-mission operator',
+    'atris do',
+    '```',
+    '',
+    '## Core Files',
+    '',
+    '| File | Purpose |',
+    '|------|---------|',
+    '| `atris/atris.md` | Workspace boot protocol |',
+    '| `atris/MAP.md` | Navigation and where-is-X index |',
+    '| `.atris/state/tasks.projection.json` | Current task projection |',
+    '| `atris/TODO.md` | Rendered task fallback only |',
+    '| `atris/team/START_HERE.md` | Team lanes and first-run flow |',
+    '| `atris/wiki/` | Business context and source-backed briefs |',
+    '| `atris/reports/` | Proof recaps and share handoffs |',
+    '',
+    '## Rules',
+    '',
+    '- Check `atris/MAP.md` before broad code or file search.',
+    '- Use `atris task` for ownership, notes, proof, and review state.',
+    '- Use `atris mission` when work should survive the current chat.',
+    '- Put completed agent work in Review with `atris task ready <id> --proof "<receipt>".`',
+    '- Do not run `atris task accept` or claim XP unless a human approved the proof.',
+    '- Do not mix another business into this workspace.',
+    '- No external sends, spend, or launches without operator approval.',
+    '',
+    '## Proof Loop',
+    '',
+    '```bash',
+    'atris business check',
+    'atris business record atris/reports/<recap>.md --outcome mixed --metric "operator speed"',
+    'atris business share --write',
+    '```',
+    '',
+    `Workspace root at creation: ${rootHint}`,
+    '',
+  ].join('\n');
+}
+
+function ensureBusinessRootAgentAdapters(targetRoot, bizMeta = {}, options = {}) {
+  const dryRun = options.dryRun === true;
+  const written = [];
+  const adapter = renderBusinessAgentAdapter(bizMeta, targetRoot);
+  const files = ['AGENTS.md', 'CLAUDE.md', 'GEMINI.md'];
+  for (const file of files) {
+    const fullPath = path.join(targetRoot, file);
+    if (fs.existsSync(fullPath)) continue;
+    written.push(file);
+    if (!dryRun) fs.writeFileSync(fullPath, adapter, 'utf8');
+  }
+  return written;
+}
+
 /**
  * Sync canonical business template files into a business workspace.
  * Used when .atris/business.json is present (business mode).
@@ -243,6 +322,7 @@ function syncWorkspaceTemplate(targetRoot, bizMeta, options = {}) {
   }
 
   const stateAddedList = ensureWorkspaceStateFiles(targetRoot, params, { dryRun });
+  const agentAdapterList = ensureBusinessRootAgentAdapters(targetRoot, params, { dryRun });
 
   // Skills: sync the canonical skill set from atris-cli package into the
   // customer workspace. Business-starter template ships skill infra (README,
@@ -277,16 +357,34 @@ function syncWorkspaceTemplate(targetRoot, bizMeta, options = {}) {
     stateAddedList.forEach(p => console.log(`    + ${p}`));
     console.log('');
   }
+  if (agentAdapterList.length > 0) {
+    console.log('  Root agent adapters:');
+    agentAdapterList.forEach(p => console.log(`    + ${p}`));
+    console.log('');
+  }
 
   if (dryRun) {
     console.log('  (--dry-run, no changes made)');
-  } else if (added === 0 && updated === 0 && stateAddedList.length === 0) {
+  } else if (added === 0 && updated === 0 && stateAddedList.length === 0 && agentAdapterList.length === 0) {
     ensureWikiScaffold(targetRoot);
     console.log('  ✓ Already up to date');
   } else {
     ensureWikiScaffold(targetRoot);
     console.log(`  ✓ Local workspace updated. Run \`atris align ${params.slug} --fix\` to push to EC2.`);
   }
+
+  return {
+    added,
+    updated,
+    preserved,
+    skipped,
+    skillsUpdated,
+    addedList,
+    updatedList,
+    preservedList,
+    stateAddedList,
+    agentAdapterList,
+  };
 }
 
 function syncBusinessCanonical(targetRoot, bizMeta, options = {}) {
@@ -862,4 +960,6 @@ module.exports = {
   syncWorkspaceTemplate,
   resolveWorkspaceTemplate,
   ensureWorkspaceStateFiles,
+  renderBusinessAgentAdapter,
+  ensureBusinessRootAgentAdapters,
 };

package/lib/runtime-bootstrap.js

@@ -45,7 +45,10 @@ function buildRemoteAtrisBootstrapCommand(options = {}) {
     'mkdir -p "$STATE_DIR"',
     'RUNTIME_FILE="$STATE_DIR/runtime.json"',
     'sanitize() { printf "%s" "$1" | tr "\\n\\r" "  " | sed "s/[\\\\\\\"]/ /g" | cut -c1-160; }',
-    'version_text() { if command -v atris >/dev/null 2>&1; then atris version 2>/dev/null || atris --version 2>/dev/null || true; fi; }',
+    'LOCAL_NPM_PREFIX="$WORKSPACE/.atris-npm"',
+    'LOCAL_ATRIS_BIN="$LOCAL_NPM_PREFIX/node_modules/.bin/atris"',
+    'export PATH="$LOCAL_NPM_PREFIX/node_modules/.bin:/home/atris/bin:$PATH"',
+    'version_text() { if [ -x "$LOCAL_ATRIS_BIN" ]; then "$LOCAL_ATRIS_BIN" version 2>/dev/null || "$LOCAL_ATRIS_BIN" --version 2>/dev/null || true; elif command -v atris >/dev/null 2>&1; then atris version 2>/dev/null || atris --version 2>/dev/null || true; fi; }',
     'BEFORE="$(sanitize "$(version_text)")"',
     '[ -n "$BEFORE" ] || BEFORE="missing"',
     'INSTALL_STATUS="skipped"',
@@ -54,19 +57,28 @@ function buildRemoteAtrisBootstrapCommand(options = {}) {
     'if [ "${ATRIS_SKIP_RUNTIME_BOOTSTRAP:-}" = "1" ]; then',
     '  INSTALL_STATUS="skipped_env"',
     'elif command -v npm >/dev/null 2>&1; then',
-    '  if npm install -g atris@latest >/tmp/atris-runtime-bootstrap-npm.log 2>&1; then',
+    '  mkdir -p "$LOCAL_NPM_PREFIX"',
+    '  if npm install --prefix "$LOCAL_NPM_PREFIX" atris@latest >/tmp/atris-runtime-bootstrap-npm.log 2>&1; then',
     '    INSTALL_STATUS="installed_latest"',
+    '    mkdir -p /home/atris/bin 2>/dev/null || true',
+    '    ln -sf "$LOCAL_ATRIS_BIN" /home/atris/bin/atris 2>/dev/null || true',
     '  else',
     '    INSTALL_STATUS="failed"',
-    '    RECOVERY_COMMAND="npm install -g atris@latest"',
+    '    RECOVERY_COMMAND="npm install --prefix /workspace/.atris-npm atris@latest && /workspace/.atris-npm/node_modules/.bin/atris update"',
     '  fi',
     'else',
     '  INSTALL_STATUS="failed_no_npm"',
-    '  RECOVERY_COMMAND="install node/npm, then npm install -g atris@latest"',
+    '  RECOVERY_COMMAND="install node/npm, then npm install --prefix /workspace/.atris-npm atris@latest"',
     'fi',
     'AFTER="$(sanitize "$(version_text)")"',
     '[ -n "$AFTER" ] || AFTER="missing"',
-    'if command -v atris >/dev/null 2>&1 && [ -d "$WORKSPACE/atris" ]; then',
+    'if [ -x "$LOCAL_ATRIS_BIN" ] && [ -d "$WORKSPACE/atris" ]; then',
+    '  if (cd "$WORKSPACE" && ATRIS_SKIP_UPDATE_CHECK=1 "$LOCAL_ATRIS_BIN" update >/tmp/atris-runtime-bootstrap-sync.log 2>&1); then',
+    '    SYNC_STATUS="synced"',
+    '  else',
+    '    SYNC_STATUS="failed"',
+    '  fi',
+    'elif command -v atris >/dev/null 2>&1 && [ -d "$WORKSPACE/atris" ]; then',
     '  if (cd "$WORKSPACE" && ATRIS_SKIP_UPDATE_CHECK=1 atris update >/tmp/atris-runtime-bootstrap-sync.log 2>&1); then',
     '    SYNC_STATUS="synced"',
     '  else',

package/lib/task-db.js

@@ -567,17 +567,38 @@ function reviewTask(db, { id, actor, reward, lesson, nextTask, proof, careerXpEl
   const row = getTask(db, id);
   if (!row) return { reviewed: false, reason: 'not_found' };
   const numericReward = Number.isFinite(Number(reward)) ? Number(reward) : 0;
+  const now = Date.now();
+  const reviewer = actor || process.env.ATRIS_AGENT_ID || process.env.USER || null;
   const metadata = row.metadata && typeof row.metadata === 'object' ? { ...row.metadata } : {};
+  const reviewingPendingProof = row.status === 'review'
+    && metadata.approval_status === 'pending'
+    && numericReward <= 0
+    && metadata.agent_certified !== true;
+  let reviewPassCount = Number(metadata.agent_review_pass_count || 0);
+  if (reviewingPendingProof) {
+    reviewPassCount += 1;
+    metadata.agent_review_pass_count = reviewPassCount;
+    metadata.agent_reviewed_at = new Date(now).toISOString();
+    metadata.agent_reviewed_by = reviewer;
+    if (reviewPassCount >= AGENT_CERTIFICATION_REVIEW_PASSES) {
+      metadata.agent_certified = true;
+      metadata.agent_certified_at = new Date(now).toISOString();
+      metadata.agent_certified_by = reviewer;
+      metadata.agent_certification_policy = `${AGENT_CERTIFICATION_REVIEW_PASSES}_agent_review_passes`;
+    }
+  }
   if (numericReward > 0 && row.status === 'done') {
     metadata.approval_status = 'accepted';
     metadata.accepted_at = new Date().toISOString();
-    metadata.accepted_by = actor || process.env.ATRIS_AGENT_ID || process.env.USER || null;
+    metadata.accepted_by = reviewer;
+  }
+  if (reviewingPendingProof || (numericReward > 0 && row.status === 'done')) {
     withBusyRetry(() => db.prepare(`
       UPDATE tasks
          SET metadata = ?,
              updated_at = ?
        WHERE id = ?
-    `).run(JSON.stringify(metadata), Date.now(), id));
+    `).run(JSON.stringify(metadata), now, id));
   }
   const payload = {
     reward: numericReward,
@@ -586,6 +607,11 @@ function reviewTask(db, { id, actor, reward, lesson, nextTask, proof, careerXpEl
     proof: String(proof || '').trim() || null,
     career_xp_eligible: Boolean(careerXpEligible),
   };
+  if (reviewingPendingProof) {
+    payload.review_pass_count = reviewPassCount;
+    payload.agent_certified = metadata.agent_certified === true;
+    payload.agent_certification_policy = metadata.agent_certification_policy || null;
+  }
   const clearedReviewFields = Array.isArray(clearedFields)
     ? Array.from(new Set(clearedFields.filter(field => field === 'lesson' || field === 'next_task')))
     : [];
@@ -593,7 +619,7 @@ function reviewTask(db, { id, actor, reward, lesson, nextTask, proof, careerXpEl
   const event = appendTaskEvent(db, {
     taskId: id,
     workspaceRoot: row.workspace_root,
-    actor: actor || null,
+    actor: reviewer,
     eventType: 'reviewed',
     payload,
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "3.15.45",
+  "version": "3.15.48",
   "main": "bin/atris.js",
   "bin": {
     "atris": "bin/atris.js",
@@ -13,6 +13,7 @@
     "commands/",
     "utils/",
     "lib/",
+    "templates/",
     "README.md",
     "AGENTS.md",
     "atris.md",
@@ -46,6 +47,7 @@
     "atris/team/_template/MEMBER.md",
     "atris/features/_templates/",
     "atris/features/company-brain-sync/",
+    "templates/",
     "atris/wiki/index.md",
     "atris/wiki/concepts/agent-activation-contract.md",
     "atris/wiki/concepts/workspace-initialization-contract.md",

package/templates/business-starter/CLAUDE.md

@@ -0,0 +1,62 @@
+# {{name}} — Atris Workspace
+
+You are the AI operating partner for **{{name}}**.
+
+## FIRST MESSAGE — MANDATORY
+
+Before responding to the user's first message:
+1. Read `atris/atris.md` (boot protocol)
+2. Read `atris/MAP.md` (navigation)
+3. Read `.atris/state/tasks.projection.json` if present; otherwise read `atris/TODO.md`
+4. Read today's journal at `atris/logs/YYYY/YYYY-MM-DD.md`
+5. Acknowledge what you've loaded in 1–2 lines, then respond
+
+## MAPFIRST (Enforced)
+
+Before ANY file search:
+1. Read `atris/MAP.md`
+2. Search for your keyword in MAP
+3. If found → go directly to file:line
+4. If not found → grep ONCE, then UPDATE MAP.md
+
+**Never grep without checking MAP first.**
+
+## Persona
+
+See `atris/PERSONA.md` for voice, tone, and style.
+
+## Core Loop
+
+`atris plan` → `atris do` → `atris review`
+
+## Mission Autonomy
+
+Use `atris mission` when work should survive this chat or run as an autonomous loop.
+
+```
+member -> mission start --verify -> status --status active -> one bounded step -> mission tick --verify -> receipt -> complete|run|stop
+```
+
+- Start current-agent work: `atris mission start "<objective>" --owner <member> --runner codex_goal --lane business --verify "<cmd>" --stop "<condition>"`
+- Start headless Claude work: add `--runner claude --cadence "15m" --always-on`, then use `atris mission run <id> --max-ticks 4 --complete-on-pass`.
+- Resume: `atris mission status --status active --json`, then pick the mission matching your owner/member.
+- Prove: after one bounded step, run `atris mission tick <id> --verify --summary "<what changed>"`.
+- Close: if the verifier passes, run `atris mission complete <id> --proof "<receipt_path>"`; if current-agent work should keep going, repeat status -> step -> tick.
+
+## Wiki Reads — REQUIRED for domain questions
+
+You have a compiled wiki at `atris/wiki/`:
+- `atris/wiki/people/` — humans (employees, contacts, stakeholders)
+- `atris/wiki/systems/` — tools, tables, dashboards, services, products
+- `atris/wiki/concepts/` — patterns, frameworks, recurring ideas
+- `atris/wiki/briefs/` — multi-page briefs and cross-cutting analyses
+
+When asked anything domain-specific, **READ THE RELEVANT WIKI PAGE FIRST**. Cite the page in your answer. Do not answer from generic knowledge.
+
+## Rules (Non-Negotiable)
+
+- Plan = ASCII visualization + approval gate. Do not execute during planning.
+- Execute step-by-step. Verify as you go.
+- Update artifacts (`atris task`, MAP.md) when reality changes.
+- Finish/review completed tasks (target state: task projection/TODO fallback = 0 active).
+- Append to `atris/policies/LESSONS.md` after every significant discovery.

package/templates/business-starter/MAP.md

@@ -0,0 +1,81 @@
+# {{name}} — Workspace Map
+
+> Navigation index. Source of truth for where things live.
+> Update this file when you discover or move things.
+
+## Atris System
+
+This folder is the default computer for the `{{name}}` business owner.
+Keep owner metadata in `.atris/business.json`; keep computer memory, files, tools, and validation state in this workspace.
+
+| Path | What |
+|------|------|
+| `atris/atris.md` | Boot protocol |
+| `atris/MAP.md` | This file |
+| `atris/TODO.md` | Active task queue |
+| `atris/CLAUDE.md` | Claude Code persona |
+| `atris/MEMBER.md` | Agent role definition |
+| `atris/PERSONA.md` | Canonical voice and tone entrypoint |
+| `atris/persona.md` | Compatibility mirror |
+| `atris/instructions.md` | Workflows |
+| `atris/goals.md` | Strategic direction |
+| `atris/memory.md` | Learned context |
+| `atris/logs/YYYY/` | Daily journals |
+| `atris/policies/REWARD.md` | Local reward rubric for the first measurable loop |
+| `atris/policies/LESSONS.md` | Append-only lessons |
+
+## Wiki (Compiled Knowledge)
+
+| Path | What |
+|------|------|
+| `atris/wiki/wiki.md` | Wiki protocol |
+| `atris/wiki/index.md` | Catalog by page type |
+| `atris/wiki/STATUS.md` | Wiki health snapshot |
+| `atris/wiki/log.md` | Ingest history |
+| `atris/wiki/people/` | Human profiles |
+| `atris/wiki/systems/` | Tools, tables, services |
+| `atris/wiki/concepts/` | Patterns and frameworks |
+| `atris/wiki/concepts/first-loop-template.md` | Starter template for the first measurable loop |
+| `atris/wiki/briefs/` | Cross-cutting briefs |
+
+## Context (Raw Sources)
+
+| Path | What |
+|------|------|
+| `atris/context/live-workspace.md` | Live ids, owner/computer model, and workspace separation rule |
+| `atris/context/README.md` | Raw-source rules |
+
+## Skills
+
+| Path | What |
+|------|------|
+| `atris/skills/` | Custom callable skills |
+
+## Team
+
+| Path | What |
+|------|------|
+| `atris/team/` | Role lenses inside the shared business environment |
+| `atris/team/START_HERE.md` | Collaborator guide for which member lane to wake first |
+| `atris/team/_template/MEMBER.md` | Starter member template for real humans or new lanes |
+| `atris/team/ops/MEMBER.md` | Default operating lane |
+| `atris/team/operator/MEMBER.md` | Default owner for the business computer |
+| `atris/team/validator/MEMBER.md` | Proof and cost-safety checker |
+| `atris/team/comms/MEMBER.md` | Default communication lane |
+| `atris/team/research/MEMBER.md` | Default research lane |
+| `atris/team/README.md` | Team folder rules |
+
+## Reports
+
+| Path | What |
+|------|------|
+| `atris/reports/operating-recap-template.md` | Default artifact for the first real loop |
+| `atris/reports/` | Past artifacts |
+| `.atris/state/_sync.json` | Workspace sync receipt |
+| `.atris/state/events.jsonl` | Raw event stream |
+| `.atris/state/episodes.jsonl` | Episode log |
+| `.atris/state/scorecards.jsonl` | Run summaries |
+
+---
+
+*This is a starter map. Add file:line references as you discover them.*

package/templates/business-starter/MEMBER.md

@@ -0,0 +1,46 @@
+---
+name: {{slug}}-agent
+role: {{name}} Operating Partner
+description: AI agent for the {{name}} business computer
+version: 1.0.0
+
+permissions:
+  can-read: true
+  can-execute: true
+  can-plan: true
+  can-delete: false
+
+skills: []
+tools: []
+---
+
+# {{name}} Agent
+
+You are the AI operating partner for **{{name}}**.
+Treat this as the default computer for the **{{name}}** business owner.
+The computer is the persistent environment: workspace + files + tools + secrets + memory + agents + validation loop.
+Use the files under `atris/team/` as role lenses, not as separate fictional workers, unless the human explicitly asks for that framing.
+
+## Activation
+
+On activation:
+1. Load `atris/MAP.md`, `atris/goals.md`, today's journal
+2. Display the boot acknowledgment (see `atris/atris.md`)
+3. Read the wiki index at `atris/wiki/index.md`
+4. Ask: "What would you like to work on?"
+
+## Workflow
+
+Follow `atris plan → atris do → atris review`. Always:
+1. **SCOUT:** Read relevant files first. Report findings.
+2. **PLAN:** ASCII visualization, get approval, NO code yet.
+3. **DO:** Execute step-by-step. Update journal.
+4. **REVIEW:** Test, validate, clean up active task state. Completed rows are history.
+
+## Persona
+
+See `atris/PERSONA.md` for voice, tone, and style.
+
+## Domain Knowledge
+
+Always read the relevant `atris/wiki/` page before answering domain questions about {{name}}.

package/templates/business-starter/TODO.md

@@ -0,0 +1,28 @@
+# {{name}} — Active Tasks
+
+> Working task queue. Target state = 0.
+> Daily tasks live in `atris/logs/YYYY/YYYY-MM-DD.md`.
+
+## Endgame
+
+**Slug:** first-business-loop
+**Picked:** {{today}}
+**Horizon:** Turn the starter into one real business loop with a measurable concept page, one named human, and one recap that writes structured state.
+**Source:** workspace bootstrap
+
+## Backlog
+
+- **B1:** Create the first measurable loop page in `atris/wiki/concepts/` using `first-loop-template.md` [endgame]
+  **Verify:** test -n "$(find atris/wiki/concepts -maxdepth 1 -type f -name '*.md' ! -name 'first-loop-template.md' -print -quit)"
+- **B2:** Add the first named human to both `atris/team/` and `atris/wiki/people/` [endgame]
+  **Verify:** test -n "$(find atris/team -mindepth 1 -maxdepth 1 -type d ! -name '_template' ! -name 'ops' ! -name 'comms' ! -name 'research' -print -quit)" && test -n "$(find atris/wiki/people -mindepth 1 -maxdepth 1 -type f -name '*.md' -print -quit)"
+- **B3:** Write the first dated recap, then run `atris business record <report-path>` to append structured state entries [endgame]
+  **Verify:** test -n "$(find atris/reports -maxdepth 1 -type f -name '*.md' ! -name 'README.md' ! -name 'operating-recap-template.md' -print -quit)" && test -s .atris/state/events.jsonl && test -s .atris/state/episodes.jsonl && test -s .atris/state/scorecards.jsonl
+
+## In Progress
+
+(none)
+
+## Completed
+
+(clear)

package/templates/business-starter/atris.md

@@ -0,0 +1,61 @@
+# Atris Boot Protocol — {{name}}
+
+You are operating in the **{{name}}** Atris workspace.
+
+## ON SESSION START
+
+1. Read `atris/MAP.md` for navigation
+2. Read `.atris/state/tasks.projection.json` if present; otherwise read `atris/TODO.md`
+3. Read today's journal at `atris/logs/YYYY/YYYY-MM-DD.md`
+4. Acknowledge what you have loaded, ask what to work on
+
+## WORKFLOW
+
+```
+PLAN → DO → REVIEW
+```
+
+- **PLAN:** Read context, propose approach as ASCII visualization. Stop. Wait for approval.
+- **DO:** Execute step-by-step. Update artifacts (`atris task`, MAP.md) as reality changes.
+- **REVIEW:** Verify, test, clean up. Finish/review the task. Append lessons to `atris/policies/LESSONS.md`.
+
+## TASK SOURCE OF TRUTH
+
+Use `atris task` when available. It stores durable local SQLite task state,
+append-only task events, and refreshes `.atris/state/tasks.projection.json` for
+desktop/web/agent views.
+
+`atris/TODO.md` is the readable fallback/projection. It can be rebuilt with
+`atris task render --out atris/TODO.md`; do not rely on manual TODO.md edits for
+ownership. In cloud business workspaces, Supabase `tasks` is the source of truth
+and Swarlo is the live claim/report layer.
+
+## RULES
+
+- **MAPFIRST.** Read `atris/MAP.md` before grepping. It's the index.
+- **Plan before code.** No code during planning.
+- **One step at a time.** Verify before continuing.
+- **Finish completed tasks.** Target state: task projection/TODO fallback = 0 active items.
+- **Append lessons, don't rewrite.** History is sacred.
+- **Read atris/wiki/ pages before answering domain questions.** Cite the page in your answer.
+
+## CORE FILES
+
+| File | Purpose |
+|------|---------|
+| `atris/atris.md` | This file — boot protocol |
+| `atris/MAP.md` | Navigation index |
+| `.atris/state/tasks.projection.json` | Current task projection |
+| `atris/TODO.md` | Rendered/legacy task fallback |
+| `atris/MEMBER.md` | Agent role + permissions |
+| `atris/persona.md` | Voice, tone, style |
+| `atris/goals.md` | Strategic direction |
+| `atris/memory.md` | Persistent learned context |
+| `atris/instructions.md` | Workflows and processes |
+| `atris/wiki/` | Compiled knowledge base |
+| `atris/context/` | Raw source materials |
+| `atris/skills/` | Custom callable skills |
+| `atris/team/` | Team member profiles |
+| `atris/reports/` | Past artifacts |
+| `atris/policies/LESSONS.md` | Append-only lessons |
+| `atris/logs/YYYY/YYYY-MM-DD.md` | Daily journal |

package/templates/business-starter/context/README.md

@@ -0,0 +1,19 @@
+# Context — {{name}}
+
+Raw source material for {{name}}.
+`atris/` is the context graph, so structured source material belongs here, not in the workspace root.
+
+## How to use
+
+- Drop new sources here as files (`.md`, `.sql`, `.json`, etc.)
+- Run `atris ingest <path>` to compile into the wiki
+- Sources are **immutable** — never edit them after ingest. If a source changes, create a new dated copy.
+- Files outside `atris/` should stay as boot shims, exports, or random scratch output only
+
+## Suggested layout
+
+- `company-overview.md` — mission, team, stage
+- `people/` — one file per key stakeholder
+- `sql/` — database queries (if applicable)
+- `briefs/` — meeting notes, deal briefs
+- Anything else relevant

package/templates/business-starter/context/live-workspace.md

@@ -0,0 +1,36 @@
+# {{name}} — Live Workspace
+
+## Business
+
+- ID: `{{business_id}}`
+- Slug: `{{slug}}`
+
+## Product Model
+
+- Owner type: `Business`
+- Entity type: `business`
+- Computer type: `business_ops` by default
+- Computer shape: workspace + files + tools + secrets + memory + agents + validation loop
+- Group role: people, chat, membership, approvals, and visibility live in groups, not in the computer memory
+
+## Workspace
+
+- ID: `{{workspace_id}}`
+
+## Separation Rule
+
+This workspace should know {{name}}, not any other business.
+Do not mix context across workspaces.
+
+## Current Loop
+
+- primary workflow: define the first measurable loop here
+- primary operator: add the human approval surface here
+- next artifact: add the first report, note, or recap artifact here
+
+## Structured State
+
+- `.atris/state/_sync.json` - workspace sync receipt
+- `.atris/state/events.jsonl` - raw events
+- `.atris/state/episodes.jsonl` - episodes
+- `.atris/state/scorecards.jsonl` - scorecards

package/templates/business-starter/goals.md

@@ -0,0 +1,33 @@
+# {{name}} — Goals
+
+Strategic direction. Weeks-to-months scale (TODO.md is days, this is weeks).
+
+## Active Goals
+
+### Define the first measurable loop
+- **Status:** Active
+- **Why:** a business workspace gets useful when one workflow has clear state, action, and reward
+- **Next step:** pick the first operator workflow and the artifact it should produce
+- **Started:** YYYY-MM-DD
+
+### Make the next operator decision faster
+- **Status:** Active
+- **Why:** the first win is decision quality, not folder size
+- **Next step:** compile the shortest brief that supports the next real action
+- **Started:** YYYY-MM-DD
+
+<!-- Example:
+### Increase advertiser retention to 95%
+- **Status:** In progress (current: 87%)
+- **Why:** Retention = revenue predictability
+- **Next step:** Analyze churn patterns in Q1 data
+- **Started:** 2026-04-08
+-->
+
+## Completed Goals
+
+*(None yet)*
+
+---
+
+*Autonomous mode reads this file every cycle. Goals here drive prioritization.*