atris 3.0.1 → 3.2.0

package/commands/business.js

@@ -1,7 +1,9 @@
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 const { loadCredentials } = require('../utils/auth');
 const { apiRequestJson } = require('../utils/api');
+const { syncBusinessCanonical } = require('./sync');
 
 function getBusinessConfigPath() {
   const home = require('os').homedir();
@@ -20,6 +22,88 @@ function saveBusinesses(data) {
   fs.writeFileSync(getBusinessConfigPath(), JSON.stringify(data, null, 2));
 }
 
+function parseCreateBusinessFlags(flags, cwd = process.cwd()) {
+  const options = {
+    description: '',
+    template: null,
+    ownerEmail: '',
+    noLocal: false,
+    workspace: false,
+    here: false,
+    root: null,
+    cwd,
+  };
+
+  for (let i = 0; i < flags.length; i++) {
+    const flag = flags[i];
+    const next = flags[i + 1];
+
+    if ((flag === '--description' || flag === '-d') && next) {
+      options.description = next;
+      i++;
+    } else if ((flag === '--template' || flag === '-t') && next) {
+      options.template = next;
+      i++;
+    } else if (flag === '--owner-email' && next) {
+      options.ownerEmail = next;
+      i++;
+    } else if ((flag === '--root' || flag === '--workspace-root') && next) {
+      options.root = path.resolve(cwd, next);
+      options.workspace = true;
+      i++;
+    } else if (flag === '--here') {
+      options.here = true;
+      options.workspace = true;
+    } else if (flag === '--workspace' || flag === '--local-workspace') {
+      options.workspace = true;
+    } else if (flag === '--no-local') {
+      options.noLocal = true;
+    }
+  }
+
+  return options;
+}
+
+function resolveWorkspaceRoot(slug, options = {}) {
+  if (options.noLocal) return null;
+  if (options.here) return options.cwd || process.cwd();
+  if (options.root) return path.join(options.root, slug);
+  return path.join(os.homedir(), 'arena', 'atris-business', slug);
+}
+
+function createCanonicalBusinessWorkspace(targetRoot, bizMeta, options = {}) {
+  if (!targetRoot) {
+    throw new Error('No target directory provided for business workspace.');
+  }
+
+  if (options.here !== true && fs.existsSync(targetRoot) && !fs.statSync(targetRoot).isDirectory()) {
+    throw new Error(`Target path is not a directory: ${targetRoot}`);
+  }
+
+  fs.mkdirSync(targetRoot, { recursive: true });
+
+  const atrisMetaDir = path.join(targetRoot, '.atris');
+  const businessJsonPath = path.join(atrisMetaDir, 'business.json');
+  if (fs.existsSync(businessJsonPath)) {
+    throw new Error(`Target already contains .atris/business.json: ${targetRoot}`);
+  }
+
+  const workspaceTemplate = options.templateName || bizMeta.workspace_template || 'business';
+  fs.mkdirSync(atrisMetaDir, { recursive: true });
+  fs.writeFileSync(businessJsonPath, JSON.stringify({
+    business_id: bizMeta.business_id,
+    workspace_id: bizMeta.workspace_id,
+    name: bizMeta.name,
+    slug: bizMeta.slug,
+    owner_email: bizMeta.owner_email || '',
+    workspace_template: workspaceTemplate,
+    created_at: new Date().toISOString(),
+  }, null, 2));
+
+  syncBusinessCanonical(targetRoot, bizMeta, { force: false, dryRun: false, templateName: workspaceTemplate });
+  return { targetRoot, businessJsonPath, workspaceTemplate };
+}
+
 function detectBusinessSlug(explicitSlug) {
   if (explicitSlug) return explicitSlug;
   const bizFile = path.join(process.cwd(), '.atris', 'business.json');
@@ -116,7 +200,7 @@ async function listBusinesses(opts = {}) {
  * Walk ~/arena/atris-business/ and print a fleet status table for every
  * customer workspace. Pure local — no API calls, no rate-limit risk.
  *
- * Classifies each dir as: canonical, flat, unbound, nested, bare, or superseded.
+ * Classifies each dir as: ready, flat, unbound, nested, bare, or superseded.
  *
  * Discovered the need for this during overnight loop tick #3 when we hand-wrote
  * /tmp/customer_fleet.md. Now any team member can run `atris business list --local`
@@ -171,7 +255,7 @@ function listBusinessesLocal(opts = {}) {
 
     let state, action, icon;
     if (hasBizJson && hasAtris) {
-      state = 'canonical'; action = 'none'; icon = '🟢';
+      state = 'ready'; action = 'none'; icon = '🟢';
     } else if (hasBizJson && !hasAtris) {
       state = 'flat'; action = 'migrate to atris/ wrapper'; icon = '🟡';
     } else if (!hasBizJson && hasAtris) {
@@ -181,7 +265,7 @@ function listBusinessesLocal(opts = {}) {
     } else if (total < 5) {
       state = 'bare'; action = 'not yet onboarded'; icon = '⚪';
     } else {
-      state = 'flat-unbound'; action = 'needs canonical init'; icon = '🟡';
+      state = 'flat-unbound'; action = 'needs business init'; icon = '🟡';
     }
 
     let bizName = name;
@@ -227,7 +311,7 @@ function listBusinessesLocal(opts = {}) {
   console.log('  CUSTOMER              STATE         FILES   BIZ.JSON  ATRIS/  ACTION');
   console.log('  ' + '─'.repeat(83));
 
-  const order = ['canonical', 'flat', 'unbound', 'flat-unbound', 'bare', 'nested', 'superseded'];
+  const order = ['ready', 'flat', 'unbound', 'flat-unbound', 'bare', 'nested', 'superseded'];
   const grouped = {};
   for (const c of customers) {
     if (!grouped[c.state]) grouped[c.state] = [];
@@ -519,9 +603,9 @@ async function businessAudit() {
   console.log('');
 }
 
-async function createBusiness(name, ...flags) {
+async function createBusinessInternal(name, flags = [], mode = 'auto') {
   if (!name) {
-    console.error('Usage: atris business create <name> [--description "..."]');
+    console.error('Usage: atris business create <name> [--description "..."] [--workspace] [--here|--root <dir>]');
     process.exit(1);
   }
 
@@ -531,14 +615,8 @@ async function createBusiness(name, ...flags) {
     process.exit(1);
   }
 
-  // Parse flags
-  let description = '';
-  for (let i = 0; i < flags.length; i++) {
-    if ((flags[i] === '--description' || flags[i] === '-d') && flags[i + 1]) {
-      description = flags[i + 1];
-      i++;
-    }
-  }
+  const options = parseCreateBusinessFlags(flags);
+  const description = options.description;
 
   console.log(`Creating business: ${name}...`);
 
@@ -567,8 +645,15 @@ async function createBusiness(name, ...flags) {
   };
   saveBusinesses(businesses);
 
-  // Scaffold local directory if in an atris project
-  const atrisDir = findAtrisDir();
+  const shouldCreateCanonicalWorkspace = !options.noLocal && (
+    mode === 'canonical' ||
+    options.workspace ||
+    options.here ||
+    Boolean(options.root)
+  );
+
+  // Scaffold legacy local directory if in an atris project
+  const atrisDir = !shouldCreateCanonicalWorkspace ? findAtrisDir() : null;
   if (atrisDir) {
     const bizDir = path.join(atrisDir, 'business', biz.slug);
     if (!fs.existsSync(bizDir)) {
@@ -584,16 +669,21 @@ async function createBusiness(name, ...flags) {
       ].join(''));
       console.log(`  Local scaffold: ${bizDir}/`);
     }
-  }
-
-  // Apply template if specified
-  let template = null;
-  for (let i = 0; i < flags.length; i++) {
-    if ((flags[i] === '--template' || flags[i] === '-t') && flags[i + 1]) {
-      template = flags[i + 1];
-      i++;
-    }
-  }
+  } else if (shouldCreateCanonicalWorkspace) {
+    const workspaceRoot = resolveWorkspaceRoot(biz.slug, options);
+    const scaffold = createCanonicalBusinessWorkspace(workspaceRoot, {
+      business_id: biz.id,
+      workspace_id: biz.workspace_id,
+      name: biz.name,
+      slug: biz.slug,
+      owner_email: options.ownerEmail,
+    }, { here: options.here });
+    console.log(`  Local workspace: ${scaffold.targetRoot}/`);
+  } else if (!options.noLocal) {
+    console.log('  Tip: run `atris business init "<name>"` or add `--workspace` for a local business environment.');
+  }
+
+  const template = options.template;
 
   if (template) {
     const templates = {
@@ -620,9 +710,22 @@ async function createBusiness(name, ...flags) {
   console.log(`  Slug:      ${biz.slug}`);
   console.log(`  Agent:     ${biz.agent_id || '(none)'}`);
   console.log(`  Dashboard: https://atris.ai/dashboard/gm/${biz.id}`);
+  if (shouldCreateCanonicalWorkspace) {
+    const workspaceRoot = resolveWorkspaceRoot(biz.slug, options);
+    console.log(`  Next:      cd ${workspaceRoot}`);
+    console.log('             atris align --fix');
+  }
   console.log('');
 }
 
+async function createBusiness(name, ...flags) {
+  return createBusinessInternal(name, flags, 'auto');
+}
+
+async function initBusinessWorkspace(name, ...flags) {
+  return createBusinessInternal(name, flags, 'canonical');
+}
+
 
 async function businessStatus(slug) {
   const creds = loadCredentials();
@@ -1046,18 +1149,21 @@ async function quickstart() {
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   1. Create:
-     atris business create "My Company" --template saas
+     atris business init "My Company" --template saas
 
-  2. Connect integrations:
-     atris business connect slack --business my-company
-     atris business connect github --business my-company
+  2. Open the local workspace:
+     cd ~/arena/atris-business/my-company
 
-  3. Deploy:
-     atris business deploy my-company
+  3. Push local state to cloud:
+     atris align --fix
 
-  That's it. Your agents are live.
+  Then open atris/TODO.md and work the starter queue:
+     define the first loop -> add named humans -> write the first recap
 
   Optional:
+     atris business connect slack --business my-company
+     atris business connect github --business my-company
+
      atris business notify digest --business my-company
      (get 1 email/day instead of every notification)
 
@@ -1076,6 +1182,10 @@ async function businessCommand(subcommand, ...args) {
     case 'new':
       await createBusiness(args[0], ...args.slice(1));
       break;
+    case 'init':
+    case 'workspace':
+      await initBusinessWorkspace(args[0], ...args.slice(1));
+      break;
     case 'list':
     case 'ls': {
       const opts = {};
@@ -1130,7 +1240,9 @@ async function businessCommand(subcommand, ...args) {
       console.log('');
       console.log('  quickstart           ← Start here! 3-command guide');
       console.log('');
-      console.log('  create <name>        Create a new business (cloud + local)');
+      console.log('  init <name>          Create a business environment (cloud + local)');
+      console.log('  workspace <name>     Alias for init');
+      console.log('  create <name>        Create the cloud business; add --workspace for a local business environment');
       console.log('  add <slug>           Register an existing cloud business');
       console.log('  list                 Show registered businesses');
       console.log('  team [slug]          Show members, roles, and admin access');
@@ -1144,4 +1256,14 @@ async function businessCommand(subcommand, ...args) {
   }
 }
 
-module.exports = { businessCommand, businessHealth, businessAudit, businessTeam, loadBusinesses, saveBusinesses, getBusinessConfigPath };
+module.exports = {
+  businessCommand,
+  businessHealth,
+  businessAudit,
+  businessTeam,
+  loadBusinesses,
+  saveBusinesses,
+  getBusinessConfigPath,
+  createCanonicalBusinessWorkspace,
+  initBusinessWorkspace,
+};

package/commands/experiments.js

@@ -351,7 +351,7 @@ function buildBenchmarkArtifact(name, packDir, options) {
         }
       );
 
-      reviewStatus = execution.success ? 'pass' : 'fail';
+      reviewStatus = execution.verifyPass ? 'pass' : 'fail';
       reviewSummary = summarizeReview(execution.reviewOutput);
       tests = inferTestResults(execution.reviewOutput);
     } catch (error) {

package/commands/release.js

@@ -0,0 +1,183 @@
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+/**
+ * atris release [--dry-run] - Tag a release, create GitHub release, draft /launch post
+ *
+ * - Reads git log since last tag
+ * - Determines bump type (minor if any scorecard has reward>=5, else patch)
+ * - Bumps package.json version
+ * - Commits, tags, pushes
+ * - Creates GitHub release via `gh`
+ * - Drafts a /launch post (3 emoji bullets)
+ */
+async function releaseAtris({ dryRun = false } = {}) {
+  const cwd = process.cwd();
+
+  // 1. Get last tag
+  let lastTag;
+  try {
+    lastTag = execFileSync('git', ['describe', '--tags', '--abbrev=0'], { cwd, encoding: 'utf8' }).trim();
+  } catch {
+    lastTag = null;
+  }
+
+  // 2. Get git log since last tag
+  let logArgs = ['log', '--oneline'];
+  if (lastTag) {
+    logArgs = ['log', `${lastTag}..HEAD`, '--oneline'];
+  }
+  let commits;
+  try {
+    commits = execFileSync('git', logArgs, { cwd, encoding: 'utf8' }).trim();
+  } catch {
+    commits = '';
+  }
+
+  if (!commits) {
+    console.log('no new commits since last tag' + (lastTag ? ` (${lastTag})` : '') + '. nothing to release.');
+    return;
+  }
+
+  const commitLines = commits.split('\n').filter(Boolean);
+  console.log('');
+  console.log(`commits since ${lastTag || 'beginning'}: ${commitLines.length}`);
+
+  // 3. Build changelog
+  const changelog = commitLines.map(l => `- ${l}`).join('\n');
+
+  // 4. Determine bump type — minor if any scorecard has reward >= 5, else patch
+  const bumpType = determineBumpType(cwd);
+  console.log(`bump type: ${bumpType}`);
+
+  // 5. Read current version and compute next
+  const pkgPath = path.join(cwd, 'package.json');
+  if (!fs.existsSync(pkgPath)) {
+    console.log('no package.json found. cannot bump version.');
+    return;
+  }
+  const pkgRaw = fs.readFileSync(pkgPath, 'utf8');
+  const pkg = JSON.parse(pkgRaw);
+  const currentVersion = pkg.version;
+  const nextVersion = bumpVersion(currentVersion, bumpType);
+
+  console.log(`version: ${currentVersion} → ${nextVersion}`);
+  console.log('');
+
+  // 6. Show changelog
+  console.log('changelog:');
+  console.log(changelog);
+  console.log('');
+
+  if (dryRun) {
+    console.log('--- dry-run: draft release ---');
+    console.log(`tag: v${nextVersion}`);
+    console.log(`title: v${nextVersion}`);
+    console.log('');
+    printLaunchPost(nextVersion, commitLines);
+    return;
+  }
+
+  // 7. Bump package.json
+  const updatedPkgRaw = pkgRaw.replace(
+    `"version": "${currentVersion}"`,
+    `"version": "${nextVersion}"`
+  );
+  fs.writeFileSync(pkgPath, updatedPkgRaw);
+  console.log(`bumped package.json to ${nextVersion}`);
+
+  // 8. Commit
+  execFileSync('git', ['add', 'package.json'], { cwd });
+  execFileSync('git', ['commit', '-m', `v${nextVersion}`], { cwd });
+  console.log('committed');
+
+  // 9. Tag
+  execFileSync('git', ['tag', `v${nextVersion}`], { cwd });
+  console.log(`tagged v${nextVersion}`);
+
+  // 10. Push + push tags
+  try {
+    execFileSync('git', ['push'], { cwd });
+    execFileSync('git', ['push', '--tags'], { cwd });
+    console.log('pushed');
+  } catch (err) {
+    console.log('push failed — you may need to push manually');
+  }
+
+  // 11. Create GitHub release via gh
+  try {
+    execFileSync('gh', ['release', 'create', `v${nextVersion}`,
+      '--title', `v${nextVersion}`,
+      '--notes', changelog
+    ], { cwd });
+    console.log(`github release created: v${nextVersion}`);
+  } catch (err) {
+    console.log('gh release create failed — install gh or create release manually');
+  }
+
+  // 12. Draft launch post
+  console.log('');
+  printLaunchPost(nextVersion, commitLines);
+}
+
+/**
+ * Check scorecards for reward >= 5 → minor bump. Otherwise patch.
+ */
+function determineBumpType(cwd) {
+  const scorecardsDir = path.join(cwd, 'atris', 'scorecards');
+  if (!fs.existsSync(scorecardsDir)) return 'patch';
+
+  try {
+    const files = fs.readdirSync(scorecardsDir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const content = fs.readFileSync(path.join(scorecardsDir, file), 'utf8');
+      const rewardMatch = content.match(/reward[:\s]+(\d+)/i);
+      if (rewardMatch && parseInt(rewardMatch[1], 10) >= 5) {
+        return 'minor';
+      }
+    }
+  } catch {
+    // ignore
+  }
+  return 'patch';
+}
+
+/**
+ * Bump a semver string: "1.2.3" + "patch" → "1.2.4", "minor" → "1.3.0"
+ */
+function bumpVersion(version, type) {
+  const parts = version.split('.').map(Number);
+  if (type === 'minor') {
+    parts[1]++;
+    parts[2] = 0;
+  } else {
+    parts[2]++;
+  }
+  return parts.join('.');
+}
+
+/**
+ * Print a 3-emoji-bullet launch post (Twitter + LinkedIn format)
+ */
+function printLaunchPost(version, commitLines) {
+  // Pick top 3 changes (dedupe, trim hashes)
+  const topChanges = commitLines
+    .slice(0, 3)
+    .map(l => l.replace(/^[a-f0-9]+\s+/, ''));
+
+  const emojis = ['🚀', '⚡', '🔧'];
+
+  console.log('--- launch post draft ---');
+  console.log('');
+  console.log(`Atris v${version} is out.`);
+  console.log('');
+  topChanges.forEach((change, i) => {
+    console.log(`${emojis[i] || '•'} ${change}`);
+  });
+  console.log('');
+  console.log('npm i -g atris');
+  console.log('--- end launch post ---');
+}
+
+module.exports = { releaseAtris };

package/commands/research.js

@@ -0,0 +1,52 @@
+const { initResearchWorkspace } = require('./business');
+
+async function researchQuickstart() {
+  console.log(`
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Start a Research Lab in 3 Commands
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  1. Create:
+     atris research init "Frontier Lab"
+
+  2. Open the local workspace:
+     cd ~/arena/atris-business/frontier-lab
+
+  3. Push local state to cloud:
+     atris align --fix
+
+  The research template starts with:
+     hypotheses + experiment lanes
+     eval-first reward policy
+     literature + findings workflow
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+`);
+}
+
+async function researchCommand(subcommand, ...args) {
+  switch (subcommand) {
+    case 'init':
+    case 'workspace':
+    case 'create':
+      await initResearchWorkspace(args[0], ...args.slice(1));
+      break;
+    case 'quickstart':
+    case 'start':
+    case 'guide':
+      await researchQuickstart();
+      break;
+    default:
+      console.log('Usage: atris research <command> [args]');
+      console.log('');
+      console.log('  quickstart           ← Start here! 3-command guide');
+      console.log('');
+      console.log('  init <name>          Create a research lab workspace (cloud + local)');
+      console.log('  workspace <name>     Alias for init');
+      console.log('  create <name>        Alias for init');
+  }
+}
+
+module.exports = {
+  researchCommand,
+  researchQuickstart,
+};