atris 3.82.11 → 3.82.14

package/atris/skills/README.md

@@ -55,6 +55,7 @@ Each line says what the skill does and when to open it. A skill with a review po
 - Backend rules that keep code simple. Open [backend](backend/SKILL.md) when you build an API or service. Policy: `policies/atris-backend.md`.
 - Essay process with gates. Open [writing](writing/SKILL.md) when you draft an essay or long post. Policy: `policies/writing.md`.
 - Find and fix generated-sounding writing. Open [copy-editor](copy-editor/SKILL.md) when you edit a draft before it ships.
+- Cut interface text that should not be on the screen. Open [clean-copy](clean-copy/SKILL.md) when you write or review labels, hints, empty states or button text.
 - Content written to get cited by AI answer engines. Open [aeo](aeo/SKILL.md) when a page should show up in AI answers.
 - Write a release post. Open [launch](launch/SKILL.md) after a release ships.
 - Author Atris block documents: docs, decks and reports. Open [blocks](blocks/SKILL.md) when you write a doc for the Atris editor.

package/atris/skills/clean-copy/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: clean-copy
+description: Cut interface copy that should not exist. Captions that restate a label, hints that answer a worry the user never had, lines that defend a choice or give permission for a button already on screen. Use when writing or reviewing any user-facing string (labels, hints, empty states, toasts, confirmations, button text) or when asked to clean up or tighten copy. Triggers on clean copy, tighten copy, cut copy, review strings, too much text, ui copy.
+version: 1.1.0
+tags:
+  - copy
+  - interface
+  - writing
+  - quality
+---
+
+# Cleaning copy
+
+Most bad copy is not badly written. It is copy that should not be on the screen. Editing it for tone just makes the wrong thing read better. The first question is never "how should this be phrased". It is **should this exist**.
+
+Every example below is a real line from an Atris screen and what happened to it.
+
+## The ladder
+
+Walk a string down these in order. Stop at the first one that fires. Cut the string or cut the part that fired.
+
+1. **Does this need to surface at all?**
+   Would the user ever have wondered about this, unprompted? If not, you are not answering a question. You are planting one. Under the theme picker sat "Theme changes apply instantly across the entire app". Nobody picks a theme wondering whether it will reach the whole app. The line went and the picker lost nothing.
+
+2. **Does the caption need to exist?**
+   A caption earns its place only when the thing beside it is meaningless without it. A checkbox labelled "Require sign-in" had "Users must sign in before accessing this app." beneath it. A heading "Recent payments" had "The latest payments received by this business." Both went. A bare "30" does need "minutes" beside it. That one stays.
+
+3. **Is it answering something the user would never have had to consider?**
+   The tell: copy that rules out a failure, defends a choice or hedges about something that simply works.
+
+   > Bring the existing site into blocks.
+   > *Your current index.html will become one custom HTML block, so every byte stays intact.*
+
+   The first half says what will happen. The second half denies a loss the user had not imagined until we named it. A list of job postings said "Every link is a real posting." An error said "Could not regenerate the scoreboard. Your current one is unchanged." Each one hands the reader a worry they arrived without. The same goes for a line that remembers an old bug. **The fix for a fixed bug is the fix. Not a caption about the fix.**
+
+4. **Rewrite to remove the part that fired. If nothing is left, delete the element.**
+   Do not preserve a hint just because there was a hint there. An empty `hint` prop comes off the component. An explanatory `<p>` gets deleted, not shortened to a stub.
+
+## What survives
+
+Copy stays when the user cannot act without it. These lines went through the same review and stayed word for word:
+
+- A real consequence at the moment of choosing. *"Remove Dana from the team? Their notes are kept."* They need it before they click and they cannot infer it.
+- A fact about scope they cannot see. *"Visitor chat history from the last 90 days."* Nothing else on the page says where the history stops.
+- What a blank or stuck state means and what to do next. *"This computer is asleep. Send it one message to wake it, then come back."*
+- Units, scale or format on a bare value.
+
+A line can be half of each. *"Only work you start uses it. Your teammates never do, and you can disconnect any time."* The first part is scope the user cannot see. The last part tells them they may press a Disconnect button that is already on the screen. Keep the scope. Cut the permission slip.
+
+## Working style
+
+- Read the string next to what is on screen around it: the label, the value, the button. Redundancy is invisible when you read the string alone.
+- Cut whole clauses, not words. Noticing which half of a two-sentence hint does no work beats trimming three words from both halves.
+- When reviewing a batch, report as `file:line` with the current string and either the rewrite or `cut`. Say in a few words which rung it failed. Do not rewrite copy that passes.
+- If a string matters only in a rare state, consider whether it belongs in that state instead of sitting on the page all the time.
+
+## Get a second reader before you cut
+
+Cutting is easy to overdo. On the first real run the first reader marked 40 lines and a second reader kept 15 of them, mostly lines about billing and failed states that told the user something they could not see.
+
+- Hand the batch to a second reader on a different model. Give it the strings and this skill, not your verdicts or your reasons.
+- Mix in lines you are sure should stay. A reader that cuts those is cutting too much and its other verdicts are not worth much.
+- Change a line only where both readers agree. When they disagree the line stays.
+
+## After the cut
+
+- A removed line takes its spacing with it. Look at the gap it leaves between the heading and the button.
+- Tests often quote the old string. Search for it before you run them.
+
+## Go deeper
+
+- [../copy-editor/SKILL.md](../copy-editor/SKILL.md): fixes how a sentence reads. Run this skill first, since a deleted string needs no editing.
+- [../taste/SKILL.md](../taste/SKILL.md): where the taste of the people you work for lives.
+- [../design/SKILL.md](../design/SKILL.md): the visual rules for the screen the copy sits on.

package/bin/atris.js

@@ -17,6 +17,14 @@ process.on('unhandledRejection', (err) => {
   }
 }
 
+// Agents call atris memory show, search, remember and the rest many times a
+// session. Answer them before the rest of the CLI loads: half the start time.
+if (process.argv[2] === 'memory'
+  && require('../lib/memory-live').isLiveCommand(process.argv.slice(3).find((arg) => !arg.startsWith('-')))) {
+  require('../commands/memory-live').runFromCli(process.argv.slice(3));
+  return;
+}
+
 const fs = require('fs');
 const path = require('path');
 const { exec, spawnSync } = require('child_process');
@@ -658,6 +666,7 @@ function showHelpAll() {
   console.log('  meet       - onboard a stranger in one sitting and print their /book link');
   console.log('  avail      - Booking availability (/book/{username} weekly windows)');
   console.log('  scoreboard - Today\'s github contributions vs your best day, streak, repo commits (--watch, --json)');
+  console.log('  growth     - Signups, paying, revenue, cli installs and countries, same as the growth page (--open, --json, note "...")');
   console.log('  scorecard  - Which AI can do your team\'s work: past changes graded by their own tests, run on your Claude plan (find, run, show)');
   console.log('  rating     - The Atris Rating, 25 to 99: how much real work each engine and member finishes (atris rating opus)');
   console.log('  brain      - Compile MAP/TODO/wiki/state into a loadable agent brain');
@@ -712,6 +721,7 @@ function showHelpAll() {
   console.log('Sync:');
   console.log('  pull       - Pull journals + member data from cloud');
   console.log('  push       - Push workspace files to cloud');
+  console.log('  memory     - Your Atris memory for any agent: show, search, remember, notebook; pull/push a laptop copy');
   console.log('  sync-checkout - fetch and fast-forward a clean current branch');
   console.log('  zen        - make this repo calm and current, keeping everything (--check to only look)');
   console.log('  cloud      - Delete cloud files not present locally (cloud clean --dry-run|--yes)');
@@ -2244,6 +2254,10 @@ if (command === 'guide') {
   Promise.resolve().then(() => require('../commands/scoreboard').scoreboardCommand(process.argv.slice(3)))
     .then((code) => exitAfterStdoutDrain(typeof code === 'number' ? code : 0))
     .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
+} else if (command === 'growth') {
+  Promise.resolve().then(() => require('../commands/growth').growthCommand(process.argv.slice(3)))
+    .then((code) => exitAfterStdoutDrain(typeof code === 'number' ? code : 0))
+    .catch((err) => { console.error(`\n✗ Error: ${err.message || err}`); process.exit(1); });
 } else if (command === 'scorecard') {
   Promise.resolve().then(() => require('../commands/scorecard').scorecardCommand(process.argv.slice(3)))
     .then((code) => exitAfterStdoutDrain(typeof code === 'number' ? code : 0))
@@ -2509,6 +2523,10 @@ if (command === 'guide') {
     process.exit(0);
   }
   require('../commands/auth').accountsCmd(args);
+} else if (command === 'memory') {
+  Promise.resolve().then(() => require('../commands/memory').memoryCommand(process.argv.slice(3)))
+    .then((code) => exitAfterStdoutDrain(typeof code === 'number' ? code : 0))
+    .catch((err) => { console.error(String(err.message || err).replace(/\s+/g, ' ')); process.exit(1); });
 } else if (command === 'balance') {
   Promise.resolve().then(() => require('../commands/balance').balanceCommand(process.argv.slice(3)))
     .then((code) => exitAfterStdoutDrain(typeof code === 'number' ? code : 0))

package/commands/autoland.js

@@ -830,6 +830,25 @@ function acceptedNotLandedNote(receipt) {
   return `, ${rows.length} accepted but not proven landed (${rows.map((r) => `${r.ref} ${r.status}`).join(', ')})`;
 }
 
+// Every job a run leaves waiting keeps its reason. Counts alone hid one cause
+// holding every finished job for five days: the record said "8 skipped" and
+// nothing on disk said why.
+function waitingReasonRows(results) {
+  return (Array.isArray(results) ? results : [])
+    .filter((row) => row && row.action === 'skipped' && row.ref)
+    .map((row) => ({ ref: String(row.ref), reason: String(row.reason || 'unknown') }));
+}
+
+function waitingReasonSummary(receipt) {
+  const rows = Array.isArray(receipt.waiting_reasons) ? receipt.waiting_reasons : [];
+  const counts = new Map();
+  for (const row of rows) counts.set(row.reason, (counts.get(row.reason) || 0) + 1);
+  return [...counts.entries()]
+    .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+    .map(([reason, count]) => `${count} ${reason}`)
+    .join(', ');
+}
+
 function stuckBacklogNote(receipt) {
   const parts = [];
   const scanned = Number(receipt.scanned || 0);
@@ -838,7 +857,8 @@ function stuckBacklogNote(receipt) {
   // separately (accepted_not_landed), not misread as a wedged queue.
   const accepted = Array.isArray(receipt.accepted) ? receipt.accepted.length : receipt.landed.length;
   if (scanned > 0 && accepted === 0) {
-    parts.push(`${certified}/${scanned} certified in review, none landed`);
+    const why = waitingReasonSummary(receipt);
+    parts.push(`${certified}/${scanned} certified in review, none landed${why ? ` (${why})` : ''}`);
   }
   const unrunnable = Array.isArray(receipt.unrunnable_verifiers) ? receipt.unrunnable_verifiers.length : 0;
   if (unrunnable > 0) {
@@ -1118,6 +1138,8 @@ async function runTickBody(root, { json, policy, receipt, engineValidationDeps =
     receipt.scanned = parsed.scanned ?? null;
     receipt.revised = parsed.revised ?? null;
     receipt.skipped = parsed.skipped ?? null;
+    const waiting = waitingReasonRows(results);
+    if (waiting.length) receipt.waiting_reasons = waiting;
     receipt.undercounted = Boolean(parsed.undercounted);
   } catch (err) {
     receipt.accept_error = describeAcceptKillCause(accept) || accept.stderr.slice(0, 200) || 'auto-accept output unreadable';
@@ -1513,6 +1535,8 @@ module.exports = {
   hasAgentJargon,
   runEngineAnswerValidation,
   runTickBody,
+  stuckBacklogNote,
+  waitingReasonRows,
   acceptCommandArgs,
   runSshAgentSweep,
   sshAgentSweepNote,

package/commands/business-connect.js

@@ -0,0 +1,148 @@
+'use strict';
+
+/**
+ * atris business connect [service] [--business slug]
+ *
+ * Connects a service to a business on the server, the same thing the
+ * Integrations tab on the web does. With no service it shows what is
+ * connected. Bot services take a token here; OAuth services open the
+ * approval page in the browser.
+ */
+
+const { apiRequestJson } = require('../utils/api');
+const { loadCredentials, openBrowser } = require('../utils/auth');
+const { detectBusinessSlug } = require('../lib/business-core');
+const { NOT_LOGGED_IN, wantsHelp, wantsJson, tokenFrom, oneLine, printResult } = require('../lib/developer-api');
+
+/** Each business service: how to connect it, and the words to show for it. */
+const SERVICES = {
+  slack: { kind: 'oauth', label: 'Slack', fields: ['team_name'] },
+  'google-drive': { kind: 'oauth', label: 'Google Drive', key: 'google_drive' },
+  hubspot: { kind: 'oauth', label: 'HubSpot' },
+  telegram: { kind: 'token', label: 'Telegram', body: (f) => ({ bot_token: f.token }), need: '--token <bot token from @BotFather>', fields: ['bot_username'] },
+  discord: { kind: 'token', label: 'Discord', body: (f) => ({ bot_token: f.token, guild_id: f.guild || null }), need: '--token <bot token> [--guild <server id>]', fields: ['guild_name'] },
+  whatsapp: { kind: 'token', label: 'WhatsApp', body: (f) => ({ access_token: f['access-token'], phone_number_id: f['phone-id'] }), need: '--access-token <token> --phone-id <id>', fields: ['phone_number_id'] },
+};
+const PERSONAL_ONLY = ['linear', 'notion', 'github', 'jira', 'salesforce', 'microsoft', 'gmail', 'calendar', 'mercury', 'brex', 'robinhood', 'x', 'twitter', 'linkedin'];
+
+function showConnectHelp(log = console.log) {
+  log('usage: atris business connect [business]                       what is connected');
+  log('       atris business connect [business] slack                 opens the approval page');
+  log('       atris business connect [business] google-drive | hubspot');
+  log('       atris business connect [business] telegram --token <bot token>');
+  log('       atris business connect [business] discord --token <bot token> [--guild <server id>]');
+  log('       atris business connect [business] whatsapp --access-token <token> --phone-id <id>');
+  log('       atris business connect [business] <service> --off      disconnect it');
+  log('the business comes from the folder you are in when you leave it out. --no-open prints the url instead of opening it.');
+  log('linear, notion, github and the rest connect to your own account, not a business: atris.ai/dashboard/integrations');
+}
+
+function readFlags(args, names) {
+  const flags = {};
+  const rest = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (names.includes(arg)) {
+      flags[arg.slice(2)] = args[i + 1];
+      i += 1;
+    } else if (!['--json', '--off', '--no-open'].includes(arg)) {
+      rest.push(arg);
+    }
+  }
+  return { flags, rest };
+}
+
+function failure(result) {
+  const status = Number(result && result.status);
+  if (status === 401) return NOT_LOGGED_IN;
+  if (status === 403) return 'only the owner or an admin of this business can change its connections';
+  if (status === 404) return 'no business with that name that you can see. try: atris business list';
+  return oneLine(result && (result.errorMessage || result.error)) || `HTTP ${status || '?'}`;
+}
+
+/** The status as short lines: one per service, connected ones first with their detail. */
+function statusText(business, status = {}) {
+  const lines = [`${business}:`];
+  for (const [name, svc] of Object.entries(SERVICES)) {
+    const entry = status[svc.key || name] || {};
+    if (entry.connected) {
+      const detail = (svc.fields || []).map((f) => entry[f]).filter(Boolean).join(', ');
+      lines.push(`  ${svc.label.padEnd(13)} connected${detail ? `, ${detail}` : ''}`);
+    } else {
+      lines.push(`  ${svc.label.padEnd(13)} not connected   atris business connect ${business} ${name}${svc.need ? ` ${svc.need}` : ''}`);
+    }
+  }
+  const google = status.google || {};
+  if (google.connected || google.account_email) lines.push(`  ${'Google'.padEnd(13)} ${google.account_email || 'connected'}`);
+  return lines.join('\n');
+}
+
+async function connectCommand(args = [], deps = {}) {
+  const io = { log: deps.log || console.log, err: deps.err || console.error };
+  if (wantsHelp(args)) {
+    showConnectHelp(io.log);
+    return 0;
+  }
+  const json = wantsJson(args);
+  const fail = (error, extra = {}) => {
+    printResult({ json, ok: false, error, payload: { ok: false, error, ...extra } }, io);
+    return 1;
+  };
+  const { flags, rest } = readFlags(args, ['--business', '--token', '--guild', '--access-token', '--phone-id']);
+  // The service is whichever word is a known service; the other word, if any, is the business.
+  let service = null;
+  let business = flags.business || null;
+  for (const word of rest) {
+    if (!service && (SERVICES[word] || PERSONAL_ONLY.includes(word))) service = word;
+    else if (!business) business = word;
+  }
+  business = (deps.detectBusinessSlug || detectBusinessSlug)(business);
+  if (!business) return fail('say which business: atris business connect sunset-ink');
+  if (service && PERSONAL_ONLY.includes(service)) {
+    return fail(`${service} connects to your own account, not to a business. open atris.ai/dashboard/integrations`);
+  }
+  const token = tokenFrom((deps.loadCredentials || loadCredentials)());
+  if (!token) return fail(NOT_LOGGED_IN);
+  const request = deps.apiRequestJson || apiRequestJson;
+  const base = `/business/${encodeURIComponent(business)}/integrations`;
+
+  try {
+    if (!service) {
+      const result = await request(base, { method: 'GET', token });
+      if (!result || !result.ok) return fail(failure(result), { status: result && result.status });
+      printResult({ json, ok: true, text: statusText(business, result.data || {}), payload: { ok: true, business, integrations: result.data } }, io);
+      return 0;
+    }
+    const svc = SERVICES[service];
+    if (args.includes('--off')) {
+      const result = await request(`${base}/${service}`, { method: 'DELETE', token });
+      if (!result || !result.ok) return fail(failure(result), { status: result && result.status });
+      printResult({ json, ok: true, text: `${svc.label} is off for ${business}`, payload: { ok: true, business, service, connected: false } }, io);
+      return 0;
+    }
+    if (svc.kind === 'token') {
+      const body = svc.body(flags);
+      if (Object.values(body).some((v) => v === undefined || v === '')) return fail(`${svc.label} needs ${svc.need}`);
+      const result = await request(`${base}/${service}`, { method: 'POST', token, retries: 0, body });
+      if (!result || !result.ok) return fail(failure(result), { status: result && result.status });
+      const data = result.data || {};
+      const detail = (svc.fields || []).map((f) => data[f]).filter(Boolean).join(', ');
+      printResult({ json, ok: true, text: `${svc.label} is connected to ${business}${detail ? ` as ${detail}` : ''}`, payload: { ok: true, business, service, ...data } }, io);
+      return 0;
+    }
+    const result = await request(`${base}/${service}/start`, { method: 'POST', token, retries: 0, body: {} });
+    if (!result || !result.ok) return fail(failure(result), { status: result && result.status });
+    const url = (result.data || {}).auth_url || (result.data || {}).url;
+    if (!url) return fail(`the server gave no approval page for ${svc.label}`);
+    const opened = !args.includes('--no-open') && Boolean((deps.openBrowser || openBrowser)(url));
+    const text = opened
+      ? `opening ${svc.label}'s approval page. finish there, then check: atris business connect ${business}\n${url}`
+      : `open this to approve ${svc.label} for ${business}:\n${url}`;
+    printResult({ json, ok: true, text, payload: { ok: true, business, service, auth_url: url, opened } }, io);
+    return 0;
+  } catch (error) {
+    return fail(oneLine(error && error.message) || 'request failed');
+  }
+}
+
+module.exports = { connectCommand, statusText, showConnectHelp, SERVICES };

package/commands/business-scoreboard.js

@@ -0,0 +1,216 @@
+'use strict';
+
+/**
+ * atris business scoreboard <business>
+ *
+ * One board of normalized units for any business: revenue, payments, orders,
+ * visitors, credits, plus custom numbers the owner records by hand. The same
+ * numbers render as text here, as JSON, or as an Atris doc with live blocks.
+ */
+
+const fs = require('node:fs');
+const { apiRequestJson } = require('../utils/api');
+const { loadCredentials } = require('../utils/auth');
+const { detectBusinessSlug } = require('../lib/business-core');
+const { NOT_LOGGED_IN, wantsHelp, wantsJson, tokenFrom, oneLine, printResult } = require('../lib/developer-api');
+
+function showScoreboardHelp(log = console.log) {
+  log('usage: atris business scoreboard [business] [--days N] [--json]');
+  log('       atris business scoreboard [business] --doc [--out FILE]');
+  log('       atris business scoreboard [business] add "Label" [--kind money|count|percent] [--id slug] [--target N]');
+  log('       atris business scoreboard [business] add "Label" --event signup [--people]');
+  log('       atris business scoreboard [business] add "Label" --formula "revenue / customers"');
+  log('       atris business scoreboard [business] set <unit> <value> [--day YYYY-MM-DD]');
+  log('       atris business scoreboard [business] target <unit> <N|none>');
+  log('       atris business scoreboard [business] layout <unit,unit,...>');
+  log('       atris business scoreboard [business] remove <unit>');
+  log('revenue, payments, orders, visitors and credits for one business, plus your own numbers.');
+  log('  --event    count an event your site sends (atris business track); --people counts distinct visitors');
+  log('  --formula  a number made from other units with + - * / and parentheses');
+  log('  --days   window for the time-boxed units (default 30)');
+  log('  --doc    print the board as an Atris doc with metric, gauge and chart blocks');
+  log('  --out    write the doc to a file instead of printing it');
+  log('  --json   print the full board once as one json object');
+  log('the business comes from the folder you are in when you leave it out.');
+}
+
+const money = (value) => (Number(value) >= 100
+  ? `$${Math.round(Number(value)).toLocaleString('en-US')}`
+  : `$${Number(value).toFixed(2)}`);
+
+function formatValue(unit = {}) {
+  if (unit.value === null || unit.value === undefined) return 'no data';
+  if (unit.kind === 'money') return money(unit.value);
+  if (unit.kind === 'percent') return `${Number(unit.value)}%`;
+  return Number(unit.value).toLocaleString('en-US');
+}
+
+function periodText(unit = {}) {
+  const period = String(unit.period || '');
+  return period === 'now' ? 'now' : `last ${period.replace(/d$/, '')} days`;
+}
+
+/** The board as aligned lines: label, value, period, and a target when one is set. */
+function scoreboardText(board = {}) {
+  const units = Array.isArray(board.units) ? board.units : [];
+  const name = (board.business && (board.business.name || board.business.slug)) || 'business';
+  if (!units.length) return `${name}: no units on the board yet. add one: atris business scoreboard add "Leads"`;
+  const width = Math.max(...units.map((u) => String(u.label || u.id).length));
+  const lines = [`${name}, ${board.days || 30} day window`];
+  for (const unit of units) {
+    let line = `${String(unit.label || unit.id).padEnd(width)}  ${formatValue(unit).padStart(10)}  ${periodText(unit)}`;
+    if (unit.target !== null && unit.target !== undefined && unit.value !== null && unit.value !== undefined) {
+      line += `, target ${formatValue({ ...unit, value: unit.target })}`;
+    }
+    if (unit.note) line += `  (${unit.note})`;
+    lines.push(line);
+  }
+  const custom = units.filter((u) => u.builtin === false).map((u) => u.id);
+  if (custom.length) lines.push(`record one: atris business scoreboard set ${custom[0]} <value>`);
+  return lines.join('\n');
+}
+
+/** Pull `--flag value` pairs out of args; returns {flags, rest}. */
+function readFlags(args, names) {
+  const flags = {};
+  const rest = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (names.includes(arg)) {
+      flags[arg.slice(2)] = args[i + 1];
+      i += 1;
+    } else if (arg !== '--json' && arg !== '--doc') {
+      rest.push(arg);
+    }
+  }
+  return { flags, rest };
+}
+
+const ACTIONS = new Set(['add', 'set', 'layout', 'remove', 'target']);
+
+function failure(result) {
+  const status = Number(result && result.status);
+  if (status === 401) return NOT_LOGGED_IN;
+  if (status === 403) return 'only the owner or an admin of this business can change its scoreboard';
+  if (status === 404) return 'no business with that name that you can see. try: atris business list';
+  return oneLine(result && (result.errorMessage || result.error)) || `HTTP ${status || '?'}`;
+}
+
+async function scoreboardCommand(args = [], deps = {}) {
+  const io = { log: deps.log || console.log, err: deps.err || console.error };
+  if (wantsHelp(args)) {
+    showScoreboardHelp(io.log);
+    return 0;
+  }
+  const json = wantsJson(args);
+  const fail = (error, extra = {}) => {
+    printResult({ json, ok: false, error, payload: { ok: false, error, ...extra } }, io);
+    return 1;
+  };
+
+  const { flags, rest } = readFlags(args, ['--days', '--out', '--kind', '--id', '--target', '--day', '--event', '--formula']);
+  // The business is the first word unless that word is an action, then it comes from the folder.
+  let business = null;
+  if (rest.length && !ACTIONS.has(rest[0])) business = rest.shift();
+  business = (deps.detectBusinessSlug || detectBusinessSlug)(business);
+  if (!business) return fail('say which business: atris business scoreboard sunset-ink');
+
+  const token = tokenFrom((deps.loadCredentials || loadCredentials)());
+  if (!token) return fail(NOT_LOGGED_IN);
+  const request = deps.apiRequestJson || apiRequestJson;
+  const base = `/business/${encodeURIComponent(business)}/scoreboard`;
+  const days = flags.days ? Number(flags.days) : 30;
+  if (!Number.isInteger(days) || days < 1 || days > 365) return fail('--days takes a whole number from 1 to 365');
+
+  try {
+    const action = rest[0];
+    if (action === 'add') {
+      const label = rest.slice(1).join(' ').trim();
+      if (!label) return fail('name the unit: atris business scoreboard add "Shirts printed"');
+      const body = { label, kind: flags.kind || 'count' };
+      if (flags.id) body.id = flags.id;
+      if (flags.target !== undefined) {
+        body.target = Number(flags.target);
+        if (!Number.isFinite(body.target)) return fail('--target takes a number');
+      }
+      if (flags.event && flags.formula) return fail('a unit reads an event or a formula, not both');
+      if (flags.event) {
+        body.event = String(flags.event).trim();
+        body.measure = args.includes('--people') ? 'people' : 'count';
+      }
+      if (flags.formula) body.formula = String(flags.formula).trim();
+      const result = await request(`${base}/units`, { method: 'POST', token, retries: 0, body });
+      if (!result || !result.ok) return fail(failure(result), { status: result && result.status });
+      const unit = result.data || {};
+      const next = unit.event
+        ? `it counts ${unit.measure === 'people' ? 'people who send' : 'every'} ${unit.event}`
+        : unit.formula ? `it is ${unit.formula}` : `record one: atris business scoreboard set ${unit.id} <value>`;
+      printResult({ json, ok: true, text: `added ${unit.label} (${unit.id}). ${next}`, payload: { ok: true, unit } }, io);
+      return 0;
+    }
+    if (action === 'target') {
+      const [unit, raw] = rest.slice(1);
+      if (!unit || raw === undefined) return fail('say the unit and the goal: atris business scoreboard target revenue 5000 (or none)');
+      const target = raw === 'none' ? null : Number(raw);
+      if (target !== null && !(Number.isFinite(target) && target > 0)) return fail('the target has to be a number above zero, or none');
+      const result = await request(`${base}/units/${encodeURIComponent(unit)}/target`, { method: 'PUT', token, retries: 0, body: { target } });
+      if (!result || !result.ok) return fail(failure(result), { status: result && result.status });
+      printResult({ json, ok: true, text: target === null ? `${unit} has no target now` : `${unit} aims for ${target}`, payload: { ok: true, unit, target } }, io);
+      return 0;
+    }
+    if (action === 'set') {
+      const [unit, raw] = rest.slice(1);
+      const value = Number(raw);
+      if (!unit || raw === undefined) return fail('say the unit and the number: atris business scoreboard set shirts_printed 12');
+      if (!Number.isFinite(value)) return fail('the value has to be a number');
+      if (flags.day !== undefined && !/^\d{4}-\d{2}-\d{2}$/.test(String(flags.day))) return fail('write the day as YYYY-MM-DD');
+      const body = flags.day ? { value, day: flags.day } : { value };
+      const result = await request(`${base}/units/${encodeURIComponent(unit)}/values`, { method: 'POST', token, retries: 0, body });
+      if (!result || !result.ok) return fail(failure(result), { status: result && result.status });
+      const saved = result.data || {};
+      printResult({ json, ok: true, text: `${unit} is ${saved.value} for ${saved.day}`, payload: { ok: true, value: saved } }, io);
+      return 0;
+    }
+    if (action === 'layout') {
+      const units = rest.slice(1).join(',').split(',').map((s) => s.trim()).filter(Boolean);
+      if (!units.length) return fail('list the units in order: atris business scoreboard layout revenue,orders,leads');
+      const result = await request(`${base}/layout`, { method: 'PUT', token, body: { units } });
+      if (!result || !result.ok) return fail(failure(result), { status: result && result.status });
+      const layout = (result.data || {}).layout || units;
+      printResult({ json, ok: true, text: `board shows ${layout.join(', ')}`, payload: { ok: true, layout } }, io);
+      return 0;
+    }
+    if (action === 'remove') {
+      const unit = rest[1];
+      if (!unit) return fail('say which unit: atris business scoreboard remove leads');
+      const result = await request(`${base}/units/${encodeURIComponent(unit)}`, { method: 'DELETE', token });
+      if (!result || !result.ok) return fail(failure(result), { status: result && result.status });
+      printResult({ json, ok: true, text: `removed ${unit}`, payload: { ok: true, removed: unit } }, io);
+      return 0;
+    }
+    if (rest.length) return fail(`unknown action ${rest[0]}. try: atris business scoreboard --help`);
+
+    if (args.includes('--doc')) {
+      const result = await request(`${base}/doc?days=${days}`, { method: 'GET', token });
+      if (!result || !result.ok) return fail(failure(result), { status: result && result.status });
+      const doc = result.text || (typeof result.data === 'string' ? result.data : '');
+      if (flags.out) {
+        (deps.writeFile || fs.writeFileSync)(flags.out, doc);
+        printResult({ json, ok: true, text: `wrote ${flags.out}`, payload: { ok: true, path: flags.out } }, io);
+      } else {
+        io.log(doc);
+      }
+      return 0;
+    }
+
+    const result = await request(`${base}?days=${days}`, { method: 'GET', token });
+    if (!result || !result.ok) return fail(failure(result), { status: result && result.status });
+    const board = result.data || {};
+    printResult({ json, ok: true, text: scoreboardText(board), payload: { ok: true, ...board } }, io);
+    return 0;
+  } catch (error) {
+    return fail(oneLine(error && error.message));
+  }
+}
+
+module.exports = { scoreboardCommand, scoreboardText, formatValue, showScoreboardHelp };