atris 3.15.46 → 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/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.48",
   "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.