atris 3.15.46 → 3.15.49

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/commands/task.js

@@ -79,6 +79,7 @@ atris task - durable local task state (SQLite, gitignored)
   atris task done <id> [--failed] [--proof "..."]  Mark complete (or failed), optionally reviewed
   atris task finish <id> [--proof "..."]   Legacy alias for done
   atris task review <id> --reward <n>      Write review event + RSI episode
+  atris task reviews [--limit <n>]         Show certified Review items for human accept/revise
   atris task status [--json] [--history]   Compact live status for web/Swarlo
   atris task setup [--import-todo]         Create/refresh task projection
   atris task serve [--port <n>]            Open local task factory board
@@ -878,6 +879,86 @@ function taskStatusSummary(projection, { history = false } = {}) {
   return status;
 }
 
+function reviewQueueLimit(args, total) {
+  if (hasFlag(args, '--all')) return total;
+  const raw = flag(args, '--limit');
+  const limit = raw && raw !== true ? Number(raw) : 12;
+  return Number.isFinite(limit) && limit > 0 ? Math.floor(limit) : 12;
+}
+
+function reviewQueueItem(task) {
+  const ref = taskRef(task);
+  return {
+    id: task.id,
+    display_id: task.display_id || null,
+    title: task.title,
+    tag: task.tag || null,
+    updated_at: task.updated_at || null,
+    review_pass_count: task.review?.agent_review_pass_count || null,
+    proof: task.review?.proof || null,
+    accept_command: `atris task accept ${ref}`,
+    revise_command: `atris task revise ${ref} --note "<what must change>"`,
+  };
+}
+
+function taskReviewQueue(projection, args = []) {
+  const reviewTasks = (projection.tasks || [])
+    .map(compactTaskForStatus)
+    .filter(task => task && task.status === 'review' && task.review && task.review.approval_status === 'pending')
+    .sort((a, b) => Number(b.updated_at || 0) - Number(a.updated_at || 0));
+  const blocking = reviewTasks.filter(task => task.review?.handoff?.next_action === 'agent_review_again');
+  const certified = reviewTasks.filter(task => task.review?.handoff?.next_action === 'continue_work' || task.review?.agent_certified === true);
+  const limit = reviewQueueLimit(args, certified.length);
+  const items = certified.slice(0, limit).map(reviewQueueItem);
+  return {
+    schema: 'atris.task_review_queue.v1',
+    generated_at: projection.generated_at,
+    workspace_root: projection.workspace_root,
+    counts: {
+      review: reviewTasks.length,
+      certified: certified.length,
+      blocking: blocking.length,
+      shown: items.length,
+    },
+    items,
+  };
+}
+
+function cmdReviews(args) {
+  const taskDb = getTaskDb();
+  const db = taskDb.open();
+  const { projection, outPath } = writeDefaultProjection(taskDb, db);
+  const queue = taskReviewQueue(projection, args);
+  if (wantsJson(args)) {
+    printJson({
+      ok: true,
+      action: 'review_queue',
+      projection_path: outPath,
+      queue,
+    });
+    return;
+  }
+  console.log('CERTIFIED REVIEW QUEUE');
+  console.log(`${queue.counts.certified} certified / ${queue.counts.blocking} need agent review / ${queue.counts.review} total review`);
+  if (!queue.items.length) {
+    console.log('No certified review items.');
+    return;
+  }
+  queue.items.forEach((item, index) => {
+    const tag = item.tag ? ` [${item.tag}]` : '';
+    const passes = item.review_pass_count ? ` (${item.review_pass_count} reviews)` : '';
+    console.log('');
+    console.log(`${index + 1}. ${item.display_id || taskRef(item.id)}${tag}${passes}: ${item.title}`);
+    if (item.proof) console.log(`   proof: ${item.proof}`);
+    console.log(`   accept: ${item.accept_command}`);
+    console.log(`   revise: ${item.revise_command}`);
+  });
+  if (queue.counts.shown < queue.counts.certified) {
+    console.log('');
+    console.log(`Showing ${queue.counts.shown}/${queue.counts.certified}; rerun with --all or --limit ${queue.counts.certified}.`);
+  }
+}
+
 function humanEventType(type) {
   return String(type || 'event').replace(/_/g, ' ');
 }
@@ -2743,6 +2824,9 @@ async function run(args) {
     case 'finish': return cmdFinish(rest);
     case 'fail':   return cmdDone([...rest, '--failed']);
     case 'review': return cmdReview(rest);
+    case 'reviews':
+    case 'review-queue':
+      return cmdReviews(rest);
     case 'status': return cmdStatus(rest);
     case 'setup':  return cmdSetup(rest);
     case 'serve':  return cmdServe(rest);

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.46",
+  "version": "3.15.49",
   "main": "bin/atris.js",
   "bin": {
     "atris": "bin/atris.js",
@@ -13,6 +13,7 @@
     "commands/",
     "utils/",
     "lib/",
+    "templates/",
     "README.md",
     "AGENTS.md",
     "atris.md",

package/templates/business-starter/MAP.md

@@ -56,6 +56,7 @@ Keep owner metadata in `.atris/business.json`; keep computer memory, files, tool
 | 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 |

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

@@ -5,6 +5,9 @@ Anything durable and structured belongs under `atris/`.
 
 ## Role Lenses
 
+Start with `atris/team/START_HERE.md`.
+It explains which lane to wake first and when proof needs validator review.
+
 Create lanes that match the real business workflow.
 Examples: intake, scheduling, reactivation, revops, content, partnerships, support.
 

package/templates/business-starter/team/START_HERE.md

@@ -0,0 +1,45 @@
+# Team Start Here — {{name}}
+
+Use this when a collaborator opens the shared business workspace for the first time.
+
+## Default Path
+
+1. Run `atris business start` from the workspace root.
+2. Run `atris radar` to see agents, tasks, missions, XP, team lanes, and proof state.
+3. Claim the seeded first task with `atris task next`.
+4. Wake `operator` with `atris member activate operator`.
+5. Resume an active mission, or start the first bounded loop if none exists.
+6. Execute the loop with `atris do`.
+7. Use `ops`, `research`, or `comms` only when the next loop needs that lens.
+8. Ask `validator` to check proof before reward, launch, external send, or spend.
+
+## Mission Loop
+
+```bash
+atris mission status --status active --json
+# If no active mission exists:
+atris mission start "Run the first useful loop for this business" --owner operator --runner codex_goal --lane business --verify "atris business check" --stop "first proof recap recorded"
+atris member goal-from-mission operator
+atris do
+```
+
+## Lanes
+
+| Lane | Use when |
+|------|----------|
+| `operator` | Someone needs to pick and drive the next concrete action |
+| `validator` | A result needs proof, cost-safety, or external-readiness review |
+| `ops` | The work is blocked on owner, date, status, or a crisp next step |
+| `research` | The workspace lacks sourced facts for the next decision |
+| `comms` | The next artifact is a message, update, reminder, or draft |
+
+## Proof Rule
+
+Record the first real run with:
+
+```bash
+atris business record atris/reports/<recap>.md --outcome mixed --metric "operator speed"
+atris business share --write
+```
+
+No XP or external action until a human approves the proof.