atris 3.25.1 → 3.26.0

package/bin/atris.js

@@ -826,7 +826,7 @@ if (command === '2' && ['fast', 'pro'].includes(String(firstCommandArg || '').to
 const knownCommands = ['init', 'log', 'now', 'radar', 'ctop', 'status', 'analytics', 'visualize', 'brain', 'brainstorm', 'autopilot', 'run', 'plan', 'do', 'review', 'release',
                        'activate', '_activate', 'agent', 'chat', 'fast', 'ax', 'console', 'serve', 'login', 'logout', 'whoami', 'switch', 'use', 'accounts', '_resolve', '_profile-email', '_switch-session', 'shell-init', 'update', 'upgrade', 'version', 'help', 'next', 'atris',
                        'clean', 'verify', 'search', 'skill', 'member', 'codex-goal', 'app', 'apps', 'learn', 'lesson', 'plugin', 'experiments', 'receipt', 'proof', 'openclaw', 'pull', 'push', 'live', 'align', 'terminal', 'computer', 'diff', 'business', 'sync', 'youtube',
-                       'ingest', 'query', 'lint', 'loop', 'pulse', 'task', 'mission', 'probe', 'worktree', 'aeo', 'improve', 'xp', 'play', 'gm', 'x', 'recap',
+                       'ingest', 'query', 'lint', 'loop', 'pulse', 'task', 'mission', 'probe', 'worktree', 'aeo', 'slop', 'deck', 'site', 'theme', 'card', 'reel', 'improve', 'xp', 'play', 'gm', 'x', 'recap',
                        'gmail', 'calendar', 'twitter', 'slack', 'imessage', 'integrations', 'setup', 'clean-workspace', 'cw',
                        'fork', 'browse', 'publish', 'sleep', 'wake', 'feedback', 'errors', 'wiki', 'code-review', 'cr', 'soul', 'fleet', 'compile', 'spaceship'];
 
@@ -1455,7 +1455,7 @@ if (command === 'init') {
       console.error(`✗ Chat failed: ${error.message || error}`);
       process.exit(1);
     });
-} else if (command === 'fast' || (command === 'ax' && process.argv[3] === 'fast')) {
+} else if (command === 'fast' || command === 'ax') {
   atrisFastChat()
     .then(() => process.exit(0))
     .catch((error) => {
@@ -2059,6 +2059,36 @@ if (command === 'init') {
   Promise.resolve(require('../commands/compile').compileCommand(subcommand, ...args))
     .then(() => process.exit(process.exitCode || 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'slop') {
+  // Slop: deterministic frontend-slop detector (no LLM). Exit 1 = slop found, for CI + the autopilot gate.
+  Promise.resolve(require('../commands/slop').slopCommand(process.argv.slice(3)))
+    .then((code) => process.exit(typeof code === 'number' ? code : 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'deck') {
+  // Deck: premium Google Slides from a plain content spec, via the Atris deck engine (anti-slop design system).
+  Promise.resolve(require('../commands/deck').run(process.argv.slice(3)))
+    .then((code) => process.exit(typeof code === 'number' ? code : 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'site') {
+  // Site: beautiful static site from a folder of markdown, in the anti-slop design system.
+  Promise.resolve(require('../commands/site').run(process.argv.slice(3)))
+    .then((code) => process.exit(typeof code === 'number' ? code : 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'theme') {
+  // Theme: brand themes (.atris/theme.json) for the whole design system (deck/html/site).
+  Promise.resolve(require('../commands/theme').run(process.argv.slice(3)))
+    .then((code) => process.exit(typeof code === 'number' ? code : 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'card') {
+  // Card: one line of text into an on-brand image (uses your theme + the design system).
+  Promise.resolve(require('../commands/card').run(process.argv.slice(3)))
+    .then((code) => process.exit(typeof code === 'number' ? code : 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'reel') {
+  // Reel: one line of text into a short on-brand video (an animated card; frames via Chrome + ffmpeg).
+  Promise.resolve(require('../commands/reel').run(process.argv.slice(3)))
+    .then((code) => process.exit(typeof code === 'number' ? code : 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'receipt' || command === 'proof' || command === 'openclaw') {
   const subcommand = process.argv[3];
   const args = process.argv.slice(4);

package/commands/align.js

@@ -466,6 +466,26 @@ async function alignHardLocalToCloud(token, biz, localDir) {
 
 async function alignAtris() {
   // Parse args
+  const printUsage = () => {
+    console.log('Usage: atris align [business] [--fix] [--hard] [--from cloud|local] [--dry-run]');
+    console.log('');
+    console.log('  atris align                   Diff current workspace against cloud (auto-detect)');
+    console.log('  atris align example-co            Diff example-co workspace');
+    console.log('  atris align example-co --fix      Fix drift (local is canonical by default)');
+    console.log('  atris align example-co --fix --hard  Force-push: nuke cloud cruft, upload local. Skips diff. Fast.');
+    console.log('  atris align example-co --fix --from cloud  Cloud is canonical: pull EC2-only, delete local extras');
+    console.log('  atris align example-co --dry-run  Show what would change, do nothing');
+  };
+
+  // Explicit help must win before we try to auto-detect a business slug,
+  // otherwise `--help` gets overwritten by the .atris/business.json fallback
+  // and the command attempts a real align instead of printing usage.
+  const firstArg = process.argv[3];
+  if (firstArg === '--help' || firstArg === '-h' || firstArg === 'help') {
+    printUsage();
+    process.exit(0);
+  }
+
   let slug = process.argv[3];
   if (!slug || slug.startsWith('-')) {
     const bizFile = path.join(process.cwd(), '.atris', 'business.json');
@@ -475,15 +495,8 @@ async function alignAtris() {
     if (!slug || slug.startsWith('-')) slug = null;
   }
 
-  if (!slug || slug === '--help' || slug === '-h' || slug === 'help') {
-    console.log('Usage: atris align [business] [--fix] [--hard] [--from cloud|local] [--dry-run]');
-    console.log('');
-    console.log('  atris align                   Diff current workspace against cloud (auto-detect)');
-    console.log('  atris align example-co            Diff example-co workspace');
-    console.log('  atris align example-co --fix      Fix drift (local is canonical by default)');
-    console.log('  atris align example-co --fix --hard  Force-push: nuke cloud cruft, upload local. Skips diff. Fast.');
-    console.log('  atris align example-co --fix --from cloud  Cloud is canonical: pull EC2-only, delete local extras');
-    console.log('  atris align example-co --dry-run  Show what would change, do nothing');
+  if (!slug) {
+    printUsage();
     process.exit(0);
   }
 

package/commands/brain.js

@@ -32,13 +32,15 @@ const CORE_STATE_FILES = [
   'agents.jsonl',
   'approvals.jsonl',
 ];
+// Loop health measures loops that actually emit receipts. Channels with no writer
+// anywhere in the codebase were dropped so the dashboard reports real failures, not
+// never-built aspirations: "Overnight RL" duplicated the active Pulse AGI loop, and
+// "Company YC" had no data source. "Master loop" is now emitted by `atris run`.
 const LOOP_HEALTH_CHANNELS = [
   { label: 'Task plane', files: ['task_events.jsonl', 'tasks.projection.json'] },
-  { label: 'Overnight RL', files: ['overnight_rl_self_heal.jsonl'] },
   { label: 'Career XP', files: ['career_xp_receipts.jsonl', 'career_xp.projection.json', 'gm_xp.projection.json'] },
   { label: 'Master loop', files: ['master_loop_events.jsonl'] },
   { label: 'Missions', files: ['mission_events.jsonl', 'missions.jsonl'] },
-  { label: 'Company YC', files: ['company_yc_wow_events.jsonl', 'company_yc_wow_latest.json'] },
   { label: 'Codex goal', files: ['codex_goal.json'] },
   { label: 'Pulse AGI', files: ['pulse_agi_loop_receipts.jsonl'] },
 ];

package/commands/card.js

@@ -0,0 +1,121 @@
+// atris card — one line of text -> a beautiful, on-brand image (your theme).
+//
+//   atris card "Ship faster" --kind statement --theme brand --size og
+//   atris card "It just works" --kind quote --by "a happy user"
+//   atris card --kind stat --number "10x" --label "faster reviews"
+//
+// Writes an .html (always) and a .png (when headless Chrome is available).
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execFileSync, spawnSync } = require('child_process');
+const { buildCard, SIZES, KINDS } = require('../lib/card');
+
+function parseFlags(argv) {
+  const flags = {}; const pos = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--html-only') { flags.htmlOnly = true; continue; }
+    if (a.startsWith('--')) {
+      const key = a.slice(2);
+      const next = argv[i + 1];
+      if (next != null && !next.startsWith('--')) { flags[key] = next; i++; } else flags[key] = true;
+      continue;
+    }
+    pos.push(a);
+  }
+  return { flags, pos };
+}
+
+// find an installed Chrome/Chromium without adding a dependency
+function findChrome() {
+  if (process.env.CHROME_PATH && fs.existsSync(process.env.CHROME_PATH)) return process.env.CHROME_PATH;
+  const macApps = [
+    '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+    '/Applications/Chromium.app/Contents/MacOS/Chromium',
+    '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+  ];
+  for (const p of macApps) if (fs.existsSync(p)) return p;
+  for (const name of ['google-chrome', 'google-chrome-stable', 'chromium', 'chromium-browser', 'chrome']) {
+    const r = spawnSync('command', ['-v', name], { shell: true, encoding: 'utf8' });
+    if (r.status === 0 && r.stdout.trim()) return r.stdout.trim();
+  }
+  return null;
+}
+
+function renderPng(chrome, html, width, height, outPng) {
+  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'atris-card-'));
+  const htmlFile = path.join(tmp, 'card.html');
+  fs.writeFileSync(htmlFile, html);
+  const args = [
+    '--headless=new', '--disable-gpu', '--hide-scrollbars',
+    '--force-device-scale-factor=2',
+    `--window-size=${width},${height}`,
+    '--virtual-time-budget=4000',
+    `--screenshot=${outPng}`,
+    `file://${htmlFile}`,
+  ];
+  execFileSync(chrome, args, { stdio: 'ignore', timeout: 60000 });
+  return fs.existsSync(outPng);
+}
+
+function run(argv) {
+  const { flags, pos } = parseFlags(argv);
+
+  if (pos[0] === 'help' || flags.help) {
+    console.log(`\n  atris card — one line of text into an on-brand image\n
+  atris card "Your headline" [--kind statement|quote|stat] [--theme <name>] [--size og|wide|square|story]
+  flags: --sub --kicker --by --number --label --brand --version --out <file.png> --html-only\n
+  examples:
+    atris card "Design that builds itself" --kicker "Atris v3.23.0" --theme brand
+    atris card "It just works." --kind quote --by "a founder" --size square
+    atris card --kind stat --number "1260" --label "tests, all green"\n`);
+    return 0;
+  }
+
+  const text = pos.join(' ').trim();
+  const kind = flags.kind || 'statement';
+  if (!KINDS.includes(kind)) { console.error(`  unknown kind "${kind}". try: ${KINDS.join(', ')}`); return 2; }
+  if (flags.size && !SIZES[flags.size]) { console.error(`  unknown size "${flags.size}". try: ${Object.keys(SIZES).join(', ')}`); return 2; }
+  if (kind === 'stat' && !flags.number && !text) { console.error('  stat cards need --number (e.g. --number "10x")'); return 2; }
+  if (kind !== 'stat' && !text) { console.error('  give the card some text: atris card "Your headline"'); return 2; }
+
+  const spec = {
+    kind, text, headline: text,
+    theme: flags.theme, size: flags.size,
+    sub: flags.sub, kicker: flags.kicker, by: flags.by,
+    number: flags.number, label: flags.label,
+    brand: flags.brand, version: flags.version,
+  };
+
+  let card;
+  try { card = buildCard(spec); }
+  catch (e) { console.error(`  could not build card: ${e.message}`); return 1; }
+
+  const base = (flags.out ? String(flags.out).replace(/\.png$/i, '') : `card-${kind}-${card.theme}-${card.size}`);
+  const outPng = path.resolve(`${base}.png`);
+  const outHtml = path.resolve(`${base}.html`);
+  fs.writeFileSync(outHtml, card.html);
+
+  if (flags.htmlOnly) {
+    console.log(`\n  ✓ ${card.kind} card (${card.width}x${card.height}, theme ${card.theme})\n    html: ${outHtml}\n    open it, or render a png with Chrome installed.\n`);
+    return 0;
+  }
+
+  const chrome = findChrome();
+  if (!chrome) {
+    console.log(`\n  ✓ wrote html: ${outHtml}\n    no Chrome found for png. open the html, or set CHROME_PATH and re-run.\n`);
+    return 0;
+  }
+  try {
+    renderPng(chrome, card.html, card.width, card.height, outPng);
+    console.log(`\n  ✓ ${card.kind} card, ${card.width}x${card.height}, theme ${card.theme}\n    ${outPng}\n`);
+    return 0;
+  } catch (e) {
+    console.log(`\n  ! png render failed (${e.message.split('\n')[0]})\n    html is ready: ${outHtml}\n`);
+    return 0;
+  }
+}
+
+module.exports = { run };

package/commands/deck.js

@@ -0,0 +1,184 @@
+// atris deck — generate a premium, on-brand Google Slides deck from a plain
+// content spec, using the Atris deck engine (lib/slides-deck.js). The pitch:
+// describe the deck, get the design system for free. No Arial-on-white slop.
+//
+// Usage:
+//   atris deck themes                         list design themes
+//   atris deck build <spec.json> [--title T] [--theme terminal|paper] [--update ID]
+//   atris deck sample [--theme paper]         print a starter spec to stdout
+//
+// A spec is JSON: { theme, brand:{name,accent}, slides:[ {type,...} ] }.
+// Slide types: title, statement, columns, panel, chips, bignumber, close.
+
+const fs = require('fs');
+const https = require('https');
+const os = require('os');
+const { buildDeck, THEMES } = require('../lib/slides-deck');
+const { parseMarkdownToSpec } = require('../lib/deck-from-md');
+const { mergedThemes } = require('../lib/theme');
+
+const BASE = 'api.atris.ai';
+const PFX = '/api/integrations/google-slides';
+
+function token() {
+  try { return require(os.homedir() + '/.atris/credentials.json').token; }
+  catch { return null; }
+}
+function api(method, path, body, tok) {
+  return new Promise((resolve, reject) => {
+    const data = body ? JSON.stringify(body) : null;
+    const req = https.request({ host: BASE, path: PFX + path, method,
+      headers: { Authorization: 'Bearer ' + tok, 'Content-Type': 'application/json',
+        ...(data ? { 'Content-Length': Buffer.byteLength(data) } : {}) } },
+      (res) => { let b = ''; res.on('data', (c) => (b += c)); res.on('end', () => {
+        let j; try { j = JSON.parse(b); } catch { j = b; }
+        if (res.statusCode >= 300) reject(new Error('HTTP ' + res.statusCode + ': ' + (typeof j === 'string' ? j : JSON.stringify(j)).slice(0, 600)));
+        else resolve(j); }); });
+    req.on('error', reject); if (data) req.write(data); req.end();
+  });
+}
+
+const SAMPLE = {
+  theme: 'terminal',
+  brand: { name: 'Sentinel', accent: '.' },
+  slides: [
+    { type: 'title', headline: 'Read your incidents in the **dark.**',
+      sub: "On-call shouldn't mean panic. Every alert ranked by blast radius, in one calm view.",
+      panel: { header: { title: 'Active incidents', meta: 'updated 12s ago' },
+        rows: [
+          { title: 'Checkout latency spike', sub: 'api-gateway · us-east-1', value: '42%', valueSub: 'of traffic', sev: 0, active: true },
+          { title: 'Stale read replica', sub: 'orders-db · eu-west-2', value: '8%', valueSub: 'of traffic', sev: 1 },
+          { title: 'Elevated 4xx on search', sub: 'search-svc · global', value: '1.2%', valueSub: 'of traffic', sev: 2 },
+        ], footer: { left: '3 active, 1 worth a page', right: 'View all' } } },
+    { type: 'statement', text: "On-call shouldn't mean **panic.**",
+      sub: 'So the console is calm by default. One screen, ranked by real impact.' },
+    { type: 'columns', heading: 'What makes it calm', columns: [
+      { h: 'Ranked by impact', b: 'Severity comes from real blast radius, so the top of the list is the thing to fix.' },
+      { h: 'Quiet by default', b: 'One page-worthy signal per incident. The rest stays in the log until you ask.' },
+      { h: 'Built for 3am', b: 'High contrast, keyboard-first, and readable before you are fully awake.' } ] },
+    { type: 'bignumber', number: '11 min', label: 'median time to first action', sub: 'down from 47 minutes before Sentinel.' },
+    { type: 'close', tagline: 'Read your incidents in the dark.',
+      buttons: [{ label: 'Open the console', primary: true }, { label: 'Read the docs' }], footer: 'sentinel.sh · 2026' },
+  ],
+};
+
+// shared: spec -> live deck. Returns the URL.
+async function publishDeck(spec, { title, updateId, tok }) {
+  const { requests } = buildDeck(spec, { themes: mergedThemes(THEMES) });
+  let id, firstSlide;
+  if (updateId) {
+    id = updateId;
+    const got = await api('GET', `/presentations/${id}`, null, tok);
+    const slides = got.slides || (got.presentation && got.presentation.slides) || [];
+    firstSlide = slides[0] && slides[0].objectId;
+  } else {
+    const pres = await api('POST', '/presentations', { title }, tok);
+    id = pres.presentationId || pres.id || (pres.presentation && pres.presentation.presentationId);
+    const slides = pres.slides || (pres.presentation && pres.presentation.slides) || [];
+    firstSlide = slides[0] && slides[0].objectId;
+  }
+  const reqs = firstSlide ? [...requests, { deleteObject: { objectId: firstSlide } }] : requests;
+  console.log(`  building ${spec.slides.length} slides (${spec.theme}) · ${reqs.length} ops...`);
+  await api('POST', `/presentations/${id}/batch-update`, { requests: reqs }, tok);
+  return `https://docs.google.com/presentation/d/${id}/edit`;
+}
+
+// beautiful HTML output (page or AppBlock JSON) from a content spec
+function outputHtml(spec, argv, srcLabel) {
+  const { renderHtml, renderBlock, THEMES: HTML_THEMES } = require('../lib/html-render');
+  const themes = mergedThemes(HTML_THEMES);
+  if (!themes[spec.theme]) spec.theme = 'atris';
+  const title = flag(argv, '--title');
+  if (hasFlag(argv, '--block')) {
+    console.log(JSON.stringify(renderBlock(spec, { title, themes }), null, 2));
+    return 0;
+  }
+  const html = renderHtml(spec, { title, themes });
+  const out = flag(argv, '--out');
+  if (out) { fs.writeFileSync(out, html); console.log(`\n  ✓ html written: ${out}${srcLabel ? ` (from ${srcLabel})` : ''}\n`); }
+  else process.stdout.write(html + '\n');
+  return 0;
+}
+
+async function run(argv) {
+  const sub = argv[0];
+
+  if (sub === 'from') {
+    const docPath = argv.slice(1).find((a) => !a.startsWith('-'));
+    if (!docPath) { console.error('  usage: atris deck from <doc.md> [--theme x] [--brand Name] [--build] [--title T]'); return 2; }
+    let md;
+    try { md = fs.readFileSync(docPath, 'utf8'); }
+    catch (e) { console.error(`  cannot read doc: ${e.message}`); return 2; }
+    const spec = parseMarkdownToSpec(md, { theme: flag(argv, '--theme'), brandName: flag(argv, '--brand') });
+    if (hasFlag(argv, '--html') || hasFlag(argv, '--block')) return outputHtml(spec, argv, docPath);
+    { const dt = mergedThemes(THEMES); if (!dt[spec.theme]) { console.error(`  unknown theme "${spec.theme}". try: ${Object.keys(dt).join(', ')}`); return 2; } }
+    if (!hasFlag(argv, '--build')) {
+      // default: print the spec so the PM can tweak before building
+      console.log(JSON.stringify(spec, null, 2));
+      return 0;
+    }
+    const tok = token();
+    if (!tok) { console.error('  no credentials at ~/.atris/credentials.json — run `atris login` and connect Google Drive.'); return 1; }
+    const title = flag(argv, '--title') || `${(spec.brand && spec.brand.name) || 'Atris'} deck`;
+    const url = await publishDeck(spec, { title, updateId: flag(argv, '--update'), tok });
+    console.log(`\n  ✓ deck from ${docPath} ready: ${url}\n`);
+    return 0;
+  }
+
+  if (sub === 'themes') {
+    console.log('\n  atris deck themes:\n');
+    for (const [name, t] of Object.entries(THEMES)) {
+      console.log(`  ${name.padEnd(10)} ${t.fonts.display} + ${t.fonts.body}  ·  accent ${t.color.accent}  bg ${t.color.bg}`);
+    }
+    console.log('\n  slide types: title, statement, columns, panel, chips, bignumber, close\n');
+    return 0;
+  }
+
+  if (sub === 'sample') {
+    const theme = flag(argv, '--theme') || 'terminal';
+    console.log(JSON.stringify({ ...SAMPLE, theme }, null, 2));
+    return 0;
+  }
+
+  if (sub === 'build') {
+    const specPath = argv.slice(1).find((a) => !a.startsWith('-'));
+    if (!specPath) { console.error('  usage: atris deck build <spec.json> [--title T] [--theme x] [--update ID]'); return 2; }
+    let spec;
+    try { spec = JSON.parse(fs.readFileSync(specPath, 'utf8')); }
+    catch (e) { console.error(`  cannot read spec: ${e.message}`); return 2; }
+    const themeOverride = flag(argv, '--theme'); if (themeOverride) spec.theme = themeOverride;
+    if (hasFlag(argv, '--html') || hasFlag(argv, '--block')) return outputHtml(spec, argv, specPath);
+    { const dt = mergedThemes(THEMES); if (!dt[spec.theme]) { console.error(`  unknown theme "${spec.theme}". try: ${Object.keys(dt).join(', ')}`); return 2; } }
+    const title = flag(argv, '--title') || `${(spec.brand && spec.brand.name) || 'Atris'} deck`;
+
+    const tok = token();
+    if (!tok) { console.error('  no credentials at ~/.atris/credentials.json — run `atris login` and connect Google Drive.'); return 1; }
+
+    const url = await publishDeck(spec, { title, updateId: flag(argv, '--update'), tok });
+    console.log(`\n  ✓ deck ready: ${url}\n`);
+    return 0;
+  }
+
+  console.log(`
+  atris deck — premium Google Slides from a plain content spec or a markdown doc
+
+    atris deck from doc.md [--build] [--title T]   turn a markdown doc into a deck
+    atris deck from doc.md --html --out page.html  beautiful HTML page (theme: atris|terminal|paper)
+    atris deck from doc.md --block                 emit the AppBlock JSON for a web app
+    atris deck sample [--theme paper] > my.json    start from a sample spec
+    atris deck build my.json [--title "Q3 review"] create the deck, print the URL
+    atris deck build my.json --html --out p.html   render the spec as HTML instead of slides
+    atris deck themes                              list design themes
+
+  'from' maps headings to slides (## with bullets -> columns, "**X** label" -> a
+  big number, Close -> a closing slide). Without --build it prints the spec to tweak.
+  Design system is baked in: distinctive fonts, one accent, real data panels, and
+  no AI tells (em dashes sanitized, sentence-case labels, no gradient text).
+`);
+  return 0;
+}
+
+function flag(argv, name) { const i = argv.indexOf(name); return i !== -1 ? argv[i + 1] : null; }
+function hasFlag(argv, name) { return argv.includes(name); }
+
+module.exports = { run, SAMPLE, publishDeck };

package/commands/reel.js

@@ -0,0 +1,128 @@
+// atris reel — one line of text into a short, on-brand video (an animated card).
+//
+//   atris reel "Ship faster" --theme brand --size square
+//   atris reel "It just works." --kind quote --by "a founder" --seconds 3
+//
+// Renders frames with headless Chrome (the same one `atris card` uses) and encodes
+// with ffmpeg. No new dependency. Falls back to a card image if either is missing.
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execFile, spawnSync } = require('child_process');
+const { promisify } = require('util');
+const pexec = promisify(execFile);
+const { buildReelFrame, reelFrames } = require('../lib/reel');
+const { SIZES, KINDS } = require('../lib/card');
+
+function parseFlags(argv) {
+  const flags = {}; const pos = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith('--')) {
+      const key = a.slice(2); const next = argv[i + 1];
+      if (next != null && !next.startsWith('--')) { flags[key] = next; i++; } else flags[key] = true;
+      continue;
+    }
+    pos.push(a);
+  }
+  return { flags, pos };
+}
+
+function findBin(macApps, names) {
+  for (const p of macApps) if (fs.existsSync(p)) return p;
+  for (const name of names) {
+    const r = spawnSync('command', ['-v', name], { shell: true, encoding: 'utf8' });
+    if (r.status === 0 && r.stdout.trim()) return r.stdout.trim();
+  }
+  return null;
+}
+const findChrome = () => (process.env.CHROME_PATH && fs.existsSync(process.env.CHROME_PATH))
+  ? process.env.CHROME_PATH
+  : findBin([
+      '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+      '/Applications/Chromium.app/Contents/MacOS/Chromium',
+      '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+    ], ['google-chrome', 'google-chrome-stable', 'chromium', 'chromium-browser', 'chrome']);
+const findFfmpeg = () => findBin(['/opt/homebrew/bin/ffmpeg', '/usr/local/bin/ffmpeg', '/usr/bin/ffmpeg'], ['ffmpeg']);
+
+async function renderFrames(chrome, ts, spec, dir, w, h, onDone) {
+  const pad = (i) => String(i).padStart(4, '0');
+  let idx = 0; let done = 0;
+  async function worker() {
+    while (idx < ts.length) {
+      const i = idx++;
+      const { html } = buildReelFrame(spec, ts[i]);
+      const hf = path.join(dir, `f-${pad(i)}.html`);
+      const pf = path.join(dir, `f-${pad(i)}.png`);
+      fs.writeFileSync(hf, html);
+      await pexec(chrome, [
+        '--headless=new', '--disable-gpu', '--hide-scrollbars', '--force-device-scale-factor=1',
+        `--window-size=${w},${h}`, '--virtual-time-budget=2200',
+        `--user-data-dir=${path.join(dir, 'ud-' + i)}`,
+        `--screenshot=${pf}`, `file://${hf}`,
+      ], { timeout: 60000 });
+      onDone && onDone(++done, ts.length);
+    }
+  }
+  const conc = Math.min(5, ts.length);
+  await Promise.all(Array.from({ length: conc }, worker));
+}
+
+async function run(argv) {
+  const { flags, pos } = parseFlags(argv);
+  if (pos[0] === 'help' || flags.help) {
+    console.log(`\n  atris reel — one line of text into a short on-brand video\n
+  atris reel "Your headline" [--kind statement|quote|stat] [--theme <name>] [--size square|og|wide|story] [--seconds 2.6]
+  flags: --sub --kicker --by --number --label --brand --version --out <file.mp4>\n`);
+    return 0;
+  }
+
+  const text = pos.join(' ').trim();
+  const kind = flags.kind || 'statement';
+  if (!KINDS.includes(kind)) { console.error(`  unknown kind "${kind}". try: ${KINDS.join(', ')}`); return 2; }
+  const size = flags.size || 'square';
+  if (!SIZES[size]) { console.error(`  unknown size "${size}". try: ${Object.keys(SIZES).join(', ')}`); return 2; }
+  if (kind === 'stat' && !flags.number && !text) { console.error('  stat reels need --number'); return 2; }
+  if (kind !== 'stat' && !text) { console.error('  give the reel some text: atris reel "Your headline"'); return 2; }
+
+  const seconds = Math.max(1, Math.min(8, parseFloat(flags.seconds) || 2.6));
+  const fps = 20;
+  const spec = {
+    kind, text, headline: text, theme: flags.theme, size,
+    sub: flags.sub, kicker: flags.kicker, by: flags.by,
+    number: flags.number, label: flags.label, brand: flags.brand, version: flags.version,
+  };
+  const { w, h } = SIZES[size];
+  const base = flags.out ? String(flags.out).replace(/\.mp4$/i, '') : `reel-${kind}-${flags.theme || 'atris'}-${size}`;
+  const outMp4 = path.resolve(`${base}.mp4`);
+
+  const chrome = findChrome();
+  if (!chrome) { console.error('\n  no Chrome found to render frames. install Chrome or set CHROME_PATH.\n'); return 1; }
+  const ffmpeg = findFfmpeg();
+  if (!ffmpeg) { console.error('\n  no ffmpeg found to encode the video. install ffmpeg (brew install ffmpeg).\n'); return 1; }
+
+  const ts = reelFrames(seconds, fps);
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'atris-reel-'));
+  console.log(`\n  rendering ${ts.length} frames (${seconds}s, ${size})...`);
+  try {
+    await renderFrames(chrome, ts, spec, dir, w, h, (d, n) => {
+      if (d === n || d % 10 === 0) process.stdout.write(`\r  frames ${d}/${n}   `);
+    });
+    process.stdout.write('\n  encoding...\n');
+    await pexec(ffmpeg, [
+      '-y', '-framerate', String(fps), '-i', path.join(dir, 'f-%04d.png'),
+      '-c:v', 'libx264', '-pix_fmt', 'yuv420p', '-movflags', '+faststart', outMp4,
+    ]);
+  } catch (e) {
+    console.error(`\n  render failed: ${String(e.message).split('\n')[0]}`); return 1;
+  } finally {
+    try { fs.rmSync(dir, { recursive: true, force: true }); } catch {}
+  }
+
+  if (!fs.existsSync(outMp4)) { console.error('  no video produced'); return 1; }
+  console.log(`\n  ✓ ${kind} reel, ${w}x${h}, ${seconds}s, theme ${flags.theme || 'atris'}\n    ${outMp4}\n`);
+  return 0;
+}
+
+module.exports = { run, findChrome, findFfmpeg };

package/commands/run.js

@@ -280,6 +280,35 @@ function hasWork(atrisDir) {
   return false;
 }
 
+/**
+ * Append a durable Master-loop receipt for one cycle's review verdict.
+ *
+ * Closes the loop: until now the validator's pass/fail lived only in RAM
+ * (carried to the next cycle's plan), so a crash lost it and `atris brain`
+ * could never see that the review step ran. This persists the verdict to
+ * .atris/state/master_loop_events.jsonl, the channel the brain reads for
+ * loop health. Best-effort: telemetry must never fail the run.
+ */
+function appendMasterLoopReceipt(receipt, stateDir = path.join(process.cwd(), '.atris', 'state')) {
+  try {
+    fs.mkdirSync(stateDir, { recursive: true });
+    const row = {
+      ts: new Date().toISOString(),
+      run_stamp: receipt.runStamp || null,
+      cycle: receipt.cycle,
+      verdict: receipt.verdict,
+      plan_ms: receipt.timing ? receipt.timing.plan : null,
+      do_ms: receipt.timing ? receipt.timing.do : null,
+      review_ms: receipt.timing ? receipt.timing.review : null,
+      review_summary: String(receipt.reviewOutput || '').replace(/\s+/g, ' ').trim().slice(0, 280),
+    };
+    fs.appendFileSync(path.join(stateDir, 'master_loop_events.jsonl'), JSON.stringify(row) + '\n');
+    return row;
+  } catch (_) {
+    return null;
+  }
+}
+
 /**
  * Log completion to journal
  */
@@ -453,6 +482,10 @@ async function runAtris(options = {}) {
       // Carry the review output into the next cycle's plan — closes the loop
       lastReviewOutput = reviewOutput;
 
+      // Persist the verdict durably so the brain can see the review actually ran.
+      const verdict = reviewOutput.includes('[REVIEW_FAILED]') ? 'fail' : 'pass';
+      appendMasterLoopReceipt({ runStamp, cycle, verdict, timing, reviewOutput });
+
       if (reviewOutput.includes('[REVIEW_FAILED]')) {
         console.log(verbose
           ? '⚠ Review found issues. Stopping for manual check.'
@@ -989,4 +1022,4 @@ function diffRunLogs(args = []) {
   }
 }
 
-module.exports = { runAtris, getRunLogDir, getRunLogPath, writePhaseToRunLog, listRunLogs, pruneRunLogs, searchRunLogs, statsRunLogs, exportRunLogs, diffRunLogs, buildRunPrompt };
+module.exports = { runAtris, getRunLogDir, getRunLogPath, writePhaseToRunLog, appendMasterLoopReceipt, listRunLogs, pruneRunLogs, searchRunLogs, statsRunLogs, exportRunLogs, diffRunLogs, buildRunPrompt };

package/commands/site.js

@@ -0,0 +1,48 @@
+// atris site — turn a folder of markdown (docs, your wiki, memory) into a
+// beautiful, navigable static site in the design system. Built on lib/site.js.
+//
+//   atris site <dir|doc.md> [--out dist] [--theme atris|terminal|paper] [--title T] [--serve]
+
+const { buildSite, serveSite } = require('../lib/site');
+
+function flag(argv, name) { const i = argv.indexOf(name); return i !== -1 ? argv[i + 1] : null; }
+function hasFlag(argv, name) { return argv.includes(name); }
+
+async function run(argv) {
+  const input = argv.find((a) => !a.startsWith('-'));
+  if (!input || input === 'help' || hasFlag(argv, '--help')) {
+    console.log(`
+  atris site — a beautiful static site from a folder of markdown
+
+    atris site <dir|doc.md> [--out dist] [--theme atris|terminal|paper] [--title T]
+    atris site atris/wiki --title "Atris Wiki" --serve
+
+  Each .md becomes a page; an index links them all. Same anti-slop design system,
+  semantic data-atris-block sections, ready for the web app. --serve previews it.
+`);
+    return input === 'help' || hasFlag(argv, '--help') ? 0 : 2;
+  }
+
+  let res;
+  try {
+    res = buildSite(input, {
+      out: flag(argv, '--out') || 'dist',
+      theme: flag(argv, '--theme'),
+      title: flag(argv, '--title'),
+      brand: flag(argv, '--brand'),
+    });
+  } catch (e) { console.error(`  ${e.message}`); return 2; }
+
+  console.log(`\n  ✓ site built: ${res.pages.length} page${res.pages.length === 1 ? '' : 's'} + index -> ${res.outDir}/`);
+  console.log(`    open ${res.indexPath}`);
+
+  if (hasFlag(argv, '--serve')) {
+    const port = Number(flag(argv, '--port')) || 4321;
+    const { url } = await serveSite(res.outDir, port);
+    console.log(`\n  serving at ${url} (ctrl-c to stop)\n`);
+    await new Promise(() => {}); // keep alive until killed
+  }
+  return 0;
+}
+
+module.exports = { run };