atris 3.1.0 → 3.2.0

package/commands/business.js

@@ -88,6 +88,7 @@ function createCanonicalBusinessWorkspace(targetRoot, bizMeta, options = {}) {
     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,
@@ -95,11 +96,12 @@ function createCanonicalBusinessWorkspace(targetRoot, bizMeta, options = {}) {
     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 });
-  return { targetRoot, businessJsonPath };
+  syncBusinessCanonical(targetRoot, bizMeta, { force: false, dryRun: false, templateName: workspaceTemplate });
+  return { targetRoot, businessJsonPath, workspaceTemplate };
 }
 
 function detectBusinessSlug(explicitSlug) {
@@ -198,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`
@@ -253,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) {
@@ -263,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;
@@ -309,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] = [];
@@ -678,7 +680,7 @@ async function createBusinessInternal(name, flags = [], mode = 'auto') {
     }, { 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 canonical workspace.');
+    console.log('  Tip: run `atris business init "<name>"` or add `--workspace` for a local business environment.');
   }
 
   const template = options.template;
@@ -1155,6 +1157,9 @@ async function quickstart() {
   3. Push local state to cloud:
      atris align --fix
 
+  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
@@ -1235,9 +1240,9 @@ async function businessCommand(subcommand, ...args) {
       console.log('');
       console.log('  quickstart           ← Start here! 3-command guide');
       console.log('');
-      console.log('  init <name>          Create a canonical business workspace (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 local canonical scaffold');
+      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');

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,
+};

package/commands/sync.js

@@ -3,7 +3,17 @@ const path = require('path');
 const os = require('os');
 const { ensureWikiScaffold } = require('../lib/wiki');
 
-const BUSINESS_TEMPLATE_DIR = path.join(__dirname, '..', 'templates', 'business-canonical');
+const TEMPLATE_ROOT_DIR = path.join(__dirname, '..', 'templates');
+const WORKSPACE_TEMPLATES = {
+  business: {
+    dir: path.join(TEMPLATE_ROOT_DIR, 'business-starter'),
+    label: 'business environment',
+  },
+  research: {
+    dir: path.join(TEMPLATE_ROOT_DIR, 'research-canonical'),
+    label: 'research lab environment',
+  },
+};
 
 /**
  * Walk a directory and return relative file paths.
@@ -25,7 +35,7 @@ function _walkTemplateDir(dir, base = dir) {
 }
 
 /**
- * Substitute {{name}}, {{slug}}, {{owner_email}} in template content.
+ * Substitute workspace metadata in template content.
  */
 function _substituteParams(content, params) {
   return content
@@ -33,7 +43,56 @@ function _substituteParams(content, params) {
     .replace(/\{\{slug\}\}/g, params.slug || 'business')
     .replace(/\{\{owner_email\}\}/g, params.owner_email || '')
     .replace(/\{\{business_id\}\}/g, params.business_id || '')
-    .replace(/\{\{workspace_id\}\}/g, params.workspace_id || '');
+    .replace(/\{\{workspace_id\}\}/g, params.workspace_id || '')
+    .replace(/\{\{today\}\}/g, params.today || new Date().toISOString().slice(0, 10))
+    .replace(/\{\{workspace_template\}\}/g, params.workspace_template || 'business');
+}
+
+function resolveWorkspaceTemplate(templateName = 'business') {
+  const normalized = String(templateName || 'business').toLowerCase();
+  if (normalized === 'research-lab' || normalized === 'researchlab' || normalized === 'lab') {
+    return { key: 'research', ...WORKSPACE_TEMPLATES.research };
+  }
+  const template = WORKSPACE_TEMPLATES[normalized];
+  if (!template) return null;
+  return { key: normalized, ...template };
+}
+
+function _ensureWorkspaceState(targetRoot, params, options = {}) {
+  const dryRun = options.dryRun === true;
+  const metaDir = path.join(targetRoot, '.atris');
+  const stateDir = path.join(metaDir, 'state');
+  const created = [];
+
+  const files = [
+    {
+      relPath: '_sync.json',
+      content: `${JSON.stringify({
+        workspace_slug: params.slug || 'business',
+        business_id: params.business_id || '',
+        workspace_id: params.workspace_id || '',
+        workspace_template: params.workspace_template || 'business',
+        status: 'initialized-local',
+        updated_at: new Date().toISOString(),
+        source: 'workspace template bootstrap',
+      }, null, 2)}\n`,
+    },
+    { relPath: 'events.jsonl', content: '' },
+    { relPath: 'episodes.jsonl', content: '' },
+    { relPath: 'scorecards.jsonl', content: '' },
+  ];
+
+  for (const file of files) {
+    const fullPath = path.join(stateDir, file.relPath);
+    if (fs.existsSync(fullPath)) continue;
+    created.push(path.join('.atris', 'state', file.relPath));
+    if (!dryRun) {
+      fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+      fs.writeFileSync(fullPath, file.content);
+    }
+  }
+
+  return created;
 }
 
 /**
@@ -43,36 +102,44 @@ function _substituteParams(content, params) {
  * Default: NEVER overwrites existing files (preserves customizations).
  * --force: overwrites existing canonical files (bumps to latest).
  */
-function syncBusinessCanonical(targetRoot, bizMeta, options = {}) {
+function syncWorkspaceTemplate(targetRoot, bizMeta, options = {}) {
+  const template = resolveWorkspaceTemplate(options.templateName || bizMeta.workspace_template || 'business');
+  if (!template) {
+    console.error(`✗ Unknown workspace template: ${options.templateName || bizMeta.workspace_template}`);
+    process.exit(1);
+  }
+
   const params = {
     slug: bizMeta.slug || 'business',
     name: bizMeta.name || bizMeta.slug || 'this business',
     owner_email: bizMeta.owner_email || '',
     business_id: bizMeta.business_id || '',
     workspace_id: bizMeta.workspace_id || '',
+    today: new Date().toISOString().slice(0, 10),
+    workspace_template: template.key,
   };
   const force = options.force != null ? options.force : process.argv.includes('--force');
   const dryRun = options.dryRun != null ? options.dryRun : process.argv.includes('--dry-run');
   const targetAtrisDir = path.join(targetRoot, 'atris');
 
-  if (!fs.existsSync(BUSINESS_TEMPLATE_DIR)) {
-    console.error(`✗ Canonical template directory not found: ${BUSINESS_TEMPLATE_DIR}`);
+  if (!fs.existsSync(template.dir)) {
+    console.error(`✗ Workspace template directory not found: ${template.dir}`);
     console.error('  Your atris-cli installation may be incomplete.');
     process.exit(1);
   }
 
   console.log('');
-  console.log(`Updating ${params.name} (${params.slug}) from canonical templates...`);
+  console.log(`Updating ${params.name} (${params.slug}) from ${template.label} templates...`);
   console.log(`  Target: ${targetAtrisDir}/`);
-  console.log(`  Source: ${BUSINESS_TEMPLATE_DIR}`);
+  console.log(`  Source: ${template.dir}`);
   console.log('');
 
-  const templateFiles = _walkTemplateDir(BUSINESS_TEMPLATE_DIR).sort();
+  const templateFiles = _walkTemplateDir(template.dir).sort();
   let added = 0, updated = 0, skipped = 0, preserved = 0;
   const addedList = [], updatedList = [], preservedList = [];
 
   for (const relPath of templateFiles) {
-    const templatePath = path.join(BUSINESS_TEMPLATE_DIR, relPath);
+    const templatePath = path.join(template.dir, relPath);
     const targetPath = path.join(targetAtrisDir, relPath);
     let templateContent;
     try { templateContent = fs.readFileSync(templatePath, 'utf-8'); } catch { continue; }
@@ -97,6 +164,8 @@ function syncBusinessCanonical(targetRoot, bizMeta, options = {}) {
     }
   }
 
+  const stateAddedList = _ensureWorkspaceState(targetRoot, params, { dryRun });
+
   console.log(`  Added:     ${added}`);
   console.log(`  Updated:   ${updated} ${force ? '' : '(--force to enable)'}`);
   console.log(`  Preserved: ${preserved} (existing customizations kept)`);
@@ -115,10 +184,15 @@ function syncBusinessCanonical(targetRoot, bizMeta, options = {}) {
     if (updatedList.length > 15) console.log(`    ... +${updatedList.length - 15} more`);
     console.log('');
   }
+  if (stateAddedList.length > 0) {
+    console.log('  State files:');
+    stateAddedList.forEach(p => console.log(`    + ${p}`));
+    console.log('');
+  }
 
   if (dryRun) {
     console.log('  (--dry-run, no changes made)');
-  } else if (added === 0 && updated === 0) {
+  } else if (added === 0 && updated === 0 && stateAddedList.length === 0) {
     ensureWikiScaffold(targetRoot);
     console.log('  ✓ Already up to date');
   } else {
@@ -127,13 +201,22 @@ function syncBusinessCanonical(targetRoot, bizMeta, options = {}) {
   }
 }
 
+function syncBusinessCanonical(targetRoot, bizMeta, options = {}) {
+  return syncWorkspaceTemplate(targetRoot, bizMeta, {
+    ...options,
+    templateName: options.templateName || bizMeta.workspace_template || 'business',
+  });
+}
+
 function syncAtris() {
   // Business mode detection: if .atris/business.json exists, use canonical templates
   const bizFile = path.join(process.cwd(), '.atris', 'business.json');
   if (fs.existsSync(bizFile)) {
     try {
       const bizMeta = JSON.parse(fs.readFileSync(bizFile, 'utf8'));
-      return syncBusinessCanonical(process.cwd(), bizMeta);
+      return syncWorkspaceTemplate(process.cwd(), bizMeta, {
+        templateName: bizMeta.workspace_template || 'business',
+      });
     } catch (e) {
       console.error(`✗ Failed to read .atris/business.json: ${e.message}`);
       process.exit(1);
@@ -571,4 +654,10 @@ function syncSkills({ silent = false } = {}) {
   return updated;
 }
 
-module.exports = { syncAtris, syncSkills, syncBusinessCanonical };
+module.exports = {
+  syncAtris,
+  syncSkills,
+  syncBusinessCanonical,
+  syncWorkspaceTemplate,
+  resolveWorkspaceTemplate,
+};

package/commands/verify.js

@@ -444,11 +444,11 @@ function verifyChange(cwd, change) {
     };
   }
 
-  // Generic check - always pass (can't verify without specifics)
+  // No specific check possible — refuse to auto-pass
   return {
-    pass: true,
+    pass: false,
     description: change.description,
-    details: 'Manual verification recommended'
+    details: 'No verifiable check for this change type. Add an explicit verify command.'
   };
 }