@vercel/board 0.21.0 → 0.22.0

package/dist/{main-BZ7nOIhV.mjs → main-CI5fjlpN.mjs}

@@ -1,13 +1,14 @@
 import { i as fileSize, n as DIRECT_UPLOAD_BYTES_MAX } from "./files-SniSmeEr.mjs";
 import { a as AttachmentId } from "./schemas-Be08nyfW.mjs";
-import { a as withMentions, f as VERSION, i as FILTER_FLAGS } from "./watchers-hash-9sxfL1Gd.mjs";
+import { d as VERSION, i as withMentions } from "./watchers-hash-D_VYDwvu.mjs";
 import { n as displayEmoji, r as normalizeEmoji } from "./emoji-CTLpvH-A.mjs";
 import { t as BoardError } from "./client-ClznIBMg.mjs";
+import { i as groups, n as filters$1, o as options, r as globalOptions, s as usage, t as commands } from "./commands-D_ODblQY.mjs";
 import { n as configDir, o as projectDir, r as connect, t as boardUrl } from "./node-BeKPcokJ.mjs";
-import { t as http } from "./backend-http-Dzb4lpMG.mjs";
-import { t as board } from "./server-Du0rSpcW.mjs";
+import { t as http } from "./backend-http-DM1T_CP6.mjs";
+import { t as board } from "./server-B8nEnlMa.mjs";
 import { t as conformance } from "./conformance-DQ9qVzWP.mjs";
-import { n as vercel, t as credentialSource } from "./backend-vercel-BjUpoLR9.mjs";
+import { n as vercel, t as credentialSource } from "./backend-vercel-IEtvtvuH.mjs";
 import { t as displayText } from "./bots-CGkO76qH.mjs";
 import { spawn } from "node:child_process";
 import { appendFile, mkdir, readFile, stat, writeFile } from "node:fs/promises";
@@ -137,9 +138,11 @@ function formatThreadSummaries(threads, options = {}) {
 		const where = options.channel ? `${message.channel}  ` : "";
 		const head = `#${message.id}  ${where}${authorName(message)} · ${ago(message.createdAt, now)}${labels(message)}`;
 		const activity = last ? `${replies} ${replies === 1 ? "reply" : "replies"} · last #${last.id} ${authorName(last)} · ${ago(last.createdAt, now)}` : "no replies";
+		const counted = Object.entries(message.reactions).filter(([, actors]) => actors.length > 0).map(([emoji, actors]) => `${displayEmoji(emoji)} ${actors.length}`).join("   ");
 		return [
 			head,
 			`      ${firstLine(message)}`,
+			...counted ? [`      ${counted}`] : [],
 			`      ${activity}`
 		].join("\n");
 	}).join("\n\n");
@@ -409,119 +412,121 @@ function disallow(file, rules) {
 	return true;
 }
 //#endregion
+//#region src/cli/help.ts
+/** The widest a row's subject pads to before its value moves to the next line. */
+const SUBJECT_MAX = 34;
+/** Help fits 80 columns: a value wraps under its column. */
+const COLUMNS = 80;
+/** The padding `entries`' subjects line up at: the widest, up to `SUBJECT_MAX`. */
+const padOf = (entries) => Math.min(SUBJECT_MAX, Math.max(0, ...entries.map(([subject]) => subject.length)));
+/**
+* `text` in lines of at most `width`, split where `gap` separates its words (two spaces, for a
+* list of flags); a word longer than that keeps its own line.
+*/
+function wrap(text, width, gap = " ") {
+	const lines = [];
+	let line = "";
+	for (const word of text.split(gap)) if (line && line.length + gap.length + word.length > width) {
+		lines.push(line);
+		line = word;
+	} else line = line ? `${line}${gap}${word}` : word;
+	return line ? [...lines, line] : lines;
+}
+/** A line headed `label` (`filters:`), its value wrapped at 80 columns under where it starts. */
+const labeled = (label, value, gap = " ") => {
+	const indent = " ".repeat(10);
+	return wrap(value, COLUMNS - indent.length, gap).map((line, index) => `${index === 0 ? label.padEnd(indent.length) : indent}${line}`);
+};
+/** Rows as columns: each subject padded to `pad`, then two spaces and its value, wrapped under it. */
+function rows(entries, pad = padOf(entries)) {
+	const indent = " ".repeat(2 + pad + 2);
+	return entries.map(([subject, value]) => {
+		const [first = "", ...rest] = wrap(value, Math.max(20, COLUMNS - indent.length));
+		return [subject.length > pad ? `  ${subject}\n${indent}${first}` : `  ${subject.padEnd(pad)}  ${first}`.trimEnd(), ...rest.map((line) => `${indent}${line}`)].join("\n");
+	});
+}
+/** An option as help writes it: `--limit <N>`, `-h, --help`, `--label <k[=v|w]>...`. */
+const flag = (option) => `${option.short ? `-${option.short}, ` : ""}--${option.name}${option.value ? option.optionalValue ? ` [${option.value}]` : ` <${option.value}>` : ""}${option.multiple ? "..." : ""}`;
+const shown = (list) => list.filter((option) => !option.hidden);
+/** A command's rows in the list: itself, when it runs alone, and each of its subcommands. */
+function listed(command) {
+	return [...!command.subcommands || command.runsWithoutSubcommand ? [[usage([command]), command.description]] : [], ...(command.subcommands ?? []).filter((sub) => !sub.hidden).map((sub) => [usage([command, sub]), sub.description])];
+}
+/** Every command, by group, then what the app adds (`serve`, `inspect`), and the options they share. */
+function rootHelp(app, version) {
+	const sections = [...groups.map((group) => commands.filter((command) => command.group === group)), app.commands].map((list) => list.filter((command) => !command.hidden));
+	const lines = [
+		`${app.name} ${version}: a message board you mount in one route`,
+		"",
+		`usage: ${app.name} <command> [options]${app.name === "board" ? "      (also installed as `vb`)" : ""}`
+	];
+	const listedSections = sections.filter((list) => list.length > 0).map((list) => list.flatMap(listed));
+	const pad = padOf(listedSections.flat());
+	for (const section of listedSections) lines.push("", ...rows(section, pad));
+	const everywhere = shown(globalOptions).filter((option) => option.name !== "help" && option.name !== "version");
+	lines.push("", ...labeled("filters:", shown(filters$1).map(flag).join("  "), "  "), ...labeled("", "labels match a message or its thread's root; repeated flags all must match"), ...labeled("global:", everywhere.map(flag).join("  "), "  "), ...labeled("json:", "one object per line (JSONL): { message, replies, last } for read <channel>, a message for read <id>"), ...labeled("text:", "pass \"-\" to read it from stdin; it may be left out when you --attach"), ...labeled("env:", "BOARD_URL  BOARD_TOKEN  BOARD_AS  BOARD_AVATAR  BOARD_HANDLE", "  "), "", `a command's own help: ${app.name} <command> --help`);
+	return lines.join("\n");
+}
+/** One command's page: its usage, what it does, and its arguments, subcommands, options, and examples. */
+function commandHelp(name, path) {
+	const command = path.at(-1);
+	const options = shown(command.options);
+	const subcommands = (command.subcommands ?? []).filter((sub) => !sub.hidden);
+	const lines = [
+		`usage: ${name} ${usage(path)}${options.length || command.filters ? " [options]" : ""}`,
+		"",
+		...wrap(command.description, COLUMNS)
+	];
+	if (command.aliases?.length) lines.push("", `also: ${command.aliases.map((alias) => `${name} ${alias}`).join(", ")}`);
+	const section = (title, entries) => {
+		if (entries.length) lines.push("", `${title}:`, ...rows(entries));
+	};
+	section("arguments", command.arguments.filter((argument) => argument.description).map((argument) => [argument.name, argument.description]));
+	section("commands", subcommands.map((sub) => [usage([...path, sub]), sub.description]));
+	section("options", options.map((option) => [flag(option), option.description]));
+	if (command.filters) {
+		section("filters", shown(filters$1).map((option) => [flag(option), option.description]));
+		lines.push("  labels match a message or its thread's root; repeated flags all must match");
+	}
+	if (command.examples.length) lines.push("", "examples:", ...command.examples.flatMap((example, index) => [
+		...index ? [""] : [],
+		`  ${example.name}`,
+		`    ${name} ${example.value}`
+	]));
+	lines.push("", `options every command takes: ${name} help`);
+	return lines.join("\n");
+}
+/**
+* The command `words` name, and its subcommand when they name one (`identity link`, `sources slack
+* read`): what `--help` shows the page of. Null when the first word names no command.
+*/
+function commandPath(words, all) {
+	const command = all.find((candidate) => candidate.name === words[0] || candidate.aliases?.includes(words[0]));
+	if (!command) return null;
+	const at = command.argumentsBeforeSubcommand ? command.arguments.length + 1 : 1;
+	const sub = command.subcommands?.find((candidate) => candidate.name === words[at]);
+	return sub ? [command, sub] : [command];
+}
+//#endregion
 //#region src/cli/main.ts
-const help = () => `${app.name} ${VERSION}: a message board you mount in one route
-
-usage: ${app.name} <command> [options]${app.name === "board" ? "      (also installed as `vb`)" : ""}
-
-  whoami                                   who am I, on which board, with which token, and what I can do
-  link <url>                               link this project to a board (.board/config.json)
-  use <url>                                save the default board
-
-  channels                                 channels, grouped by path prefix
-  actors                                   actors and their handles
-  identity                                 your linked Slack and GitHub accounts
-  identity link <key> [--code] [--no-wait] link your account on sync entry <key> (e.g. slack): sign in, or post a code from it
-  identity unlink <account>                unlink one, by handle or actor ID
-
-  read [channel] [filters] [--limit N]     the latest threads, one each: root, replies, latest reply
-                                           (no channel: every channel)
-  read <id>                                one thread, every message (filters: the root and the replies that match)
-  read <link>                              the thread a Slack or GitHub link names, if the board synced it
-
-  post <channel|id> ["<text>"] [--label k=v]... [--attach <file>]... [--sync <target>]... [--no-sync] [--id <key>]
-                                           a new thread in a channel, or with an id, a reply in its thread
-  reply <id> ["<text>"] [--attach <file>]... [--id <key>] [--no-sync]
-  schedule <channel|id> ["<text>"] (--in 1d | --at <time> | --every 30m) [--until <time> | --for 24h | --times N]
-           [--label k=v]... [--attach <file>]... [--no-sync]
-                                           post later, as you: once, or repeating until a stop or until canceled
-  schedules [id] [--by <handle>] [--channel <c>] [--all]
-                                           pending schedules (a thread's, with an id); --all adds done and canceled
-  schedule cancel <schedule>               stop one, e.g. schedule cancel s12 (yours, or with manage)
-  edit <id> "<text>"
-  delete <id>
-  react <id> <emoji> [--remove]
-  label <id> k=v... [--unset k]...
-  typing <id> [status]                     show typing in the thread's synced platform threads (marks WhatsApp read);
-                                           Slack shows the status, if given, instead of "Typing…"
-  sync <id>                                where the thread is synced, with this message's link on each
-  sync <id> <target>                       attach the thread to e.g. slack:#incidents, backfilling it
-  inbox <key> [channel] [--limit N]        raw platform events, for debugging sync
-  sources                                  the board's sources (its sync entries: slack, github, …)
-  sources <key> read <channel|thread|link> [--limit N]
-                                           read a source's channel, thread, or message link without syncing it,
-                                           e.g. sources slack read '#general', or a Slack permalink (full access only)
-  sources <key> join <channel|link>        add the app to a public channel so it can be read, where the board
-                                           opted in (slack({ join: true })); full access only
-  download <attachment> [path]             save an attachment (its name, here, by default; - for stdout)
-  conformance [--channel <c>]              check that the board speaks the protocol: posts to conformance,
-                                           kept on the board, and deletes what it posted (1 if a check fails)
-
-  hooks uninstall [claude|codex|cursor|pi]...
-                                           remove the turn-end hooks an earlier board installed
-
-  tail [channel] [filters] [--all]         live, until Ctrl-C
-  wait [channel] [filters] [--timeout 30m] block for the next match, print it, then exit (124 on timeout)${Object.keys(app.commands).length > 0 ? `\n\n${Object.values(app.commands).map((command) => command.help).join("\n")}` : ""}
-
-filters:  --re <id>  --by <handle>  --from <source>  --label k[=v|w]  --text <words>  --mentions [@handle]  --after <id>
-          labels match a message or its thread's root; repeated flags all must match
-global:   --url <url>  --scope <team>  --as <profile>  --avatar <url>  --human  --handle <h>  --json
-json:     one object per line (JSONL): { message, replies, last } for read <channel>, a message for read <id>
-text:     pass "-" to read it from stdin; it may be left out when you --attach
-env:      BOARD_URL  BOARD_TOKEN  BOARD_AS  BOARD_AVATAR  BOARD_HANDLE`;
 var UsageError = class extends Error {};
-const OPTIONS = {
-	...FILTER_FLAGS,
-	url: { type: "string" },
-	as: { type: "string" },
-	avatar: { type: "string" },
-	human: { type: "boolean" },
-	handle: { type: "string" },
-	json: { type: "boolean" },
-	scope: { type: "string" },
-	team: { type: "string" },
-	help: {
-		type: "boolean",
-		short: "h"
-	},
-	version: {
-		type: "boolean",
-		short: "v"
-	},
-	unset: {
-		type: "string",
-		multiple: true
-	},
-	id: { type: "string" },
-	"no-sync": { type: "boolean" },
-	sync: {
-		type: "string",
-		multiple: true
-	},
-	attach: {
-		type: "string",
-		multiple: true
-	},
-	channel: { type: "string" },
-	agent: { type: "string" },
-	remove: { type: "boolean" },
-	after: { type: "string" },
-	limit: { type: "string" },
-	all: { type: "boolean" },
-	timeout: { type: "string" },
-	port: { type: "string" },
-	"no-open": { type: "boolean" },
-	"no-inspect": { type: "boolean" },
-	dir: { type: "string" },
-	code: { type: "boolean" },
-	"no-wait": { type: "boolean" },
-	in: { type: "string" },
-	at: { type: "string" },
-	every: { type: "string" },
-	until: { type: "string" },
-	for: { type: "string" },
-	times: { type: "string" }
-};
+/** What the parser accepts: every option, by name (`commands.ts`). */
+const OPTIONS = options;
+/** Options by their short letter: `n` is `limit`. */
+const SHORT = Object.fromEntries(Object.entries(OPTIONS).flatMap(([name, option]) => "short" in option ? [[option.short, name]] : []));
+/**
+* Whether `arg` is a string option written apart from its value, whose value is the next argument:
+* `--limit 5`, `-n 5`, or the last of a group of short ones, `-an 5`.
+*/
+function takesValue(arg) {
+	if (arg.includes("=")) return false;
+	const string = (name) => name !== void 0 && OPTIONS[name]?.type === "string";
+	if (arg.startsWith("--")) return string(arg.slice(2));
+	const letters = arg.slice(1);
+	return [...letters].findIndex((letter) => string(SHORT[letter])) === letters.length - 1;
+}
+/** A command's own name for `word`, which may be one of its aliases (`rm` is `delete`). */
+const canonical = (word) => word === void 0 ? word : commands.find((command) => command.aliases?.includes(word))?.name ?? word;
 const MARK = "\0";
 /**
 * Attachment IDs are base64url, so boards minted some that start with `-`,
@@ -539,7 +544,7 @@ function markAttachmentId(args) {
 			`${MARK}${arg}`,
 			...args.slice(i + 1)
 		];
-		else if (!arg.includes("=") && OPTIONS[arg.slice(2)]?.type === "string") i++;
+		else if (takesValue(arg)) i++;
 	}
 	return args;
 }
@@ -552,15 +557,19 @@ function removedCommand(word) {
 	};
 	return Object.hasOwn(removed, word) ? removed[word] : void 0;
 }
-/** The command word: the first argument that isn't a flag or a string flag's value (a bare `--mentions` takes none). */
+/**
+* The command `argv` runs, by its own name (`delete` for `rm`), as the parser reads it: the
+* first positional, past every flag and value however they're written (`-an 1`, `--limit=1`). A
+* bare `--mentions` takes none.
+*/
 function commandWord(argv) {
-	const args = withMentions(argv);
-	for (let i = 0; i < args.length; i++) {
-		const arg = args[i];
-		if (arg === "--") return args[i + 1];
-		if (!arg.startsWith("-") || arg === "-") return arg;
-		if (!arg.includes("=") && OPTIONS[arg.slice(2)]?.type === "string") i++;
-	}
+	const { positionals } = parseArgs({
+		args: markAttachmentId(withMentions(argv)),
+		allowPositionals: true,
+		options: OPTIONS,
+		strict: false
+	});
+	return canonical(positionals[0]);
 }
 const parseAll = (args) => parseArgs({
 	args,
@@ -573,6 +582,15 @@ let app = {
 };
 let flags = {};
 let positionals = [];
+/** The help `words` ask for: a command's page when they name one (`read`, `identity link`), or else every command. */
+function help(words = []) {
+	const own = Object.values(app.commands).map((command) => command.spec);
+	const path = commandPath(words, [...commands, ...own]);
+	return path ? commandHelp(app.name, path) : rootHelp({
+		name: app.name,
+		commands: own
+	}, VERSION);
+}
 /** How messages name this CLI: `vb` for the standalone one, as they always have, or the app's own name. */
 const named = () => app.name === "board" ? "vb" : app.name;
 /** Parses `argv` for this run: false, once the error line is out, when it doesn't. */
@@ -684,6 +702,7 @@ function configuredUrl() {
 		if (!(error instanceof BoardError) || error.code !== "no_board") throw error;
 		if (app.teamBoard) return null;
 		const ways = [
+			"pass --scope <team> for a team's board in Vercel's API",
 			`run \`${app.name} link <url>\``,
 			"set BOARD_URL",
 			`run \`${app.name} use <url>\``,
@@ -692,6 +711,25 @@ function configuredUrl() {
 		throw new BoardError("no_board", `no board URL: ${ways.slice(0, -1).join(", ")}, or ${ways.at(-1)}`, 0);
 	}
 }
+/**
+* A team's board in Vercel's API, by the URL its discovery names it with
+* (`https://api.vercel.com/v1/messageboard/boards/<board>?teamId=<team>`): its board and team.
+*/
+function vercelBoard(url) {
+	let parsed;
+	try {
+		parsed = new URL(url);
+	} catch {
+		return null;
+	}
+	const found = /^\/v1\/messageboard\/boards\/([^/]+)\/?$/.exec(parsed.pathname);
+	if (parsed.origin !== "https://api.vercel.com" || !found) return null;
+	const team = parsed.searchParams.get("teamId");
+	return {
+		board: decodeURIComponent(found[1]),
+		...team ? { team } : {}
+	};
+}
 /** Who the handle writes as: `--as`'s profile (with `--avatar`), yourself with `--human`, or what the environment says. */
 function profileFlag() {
 	if (flags.human) return null;
@@ -720,6 +758,15 @@ function connection(url = flags.url, options = {}) {
 		};
 	}
 	const at = configured.replace(/\/+$/, "");
+	const onVercel = vercelBoard(at);
+	if (onVercel) {
+		const board$3 = board({ backend: vercel(onVercel) });
+		return {
+			url: at,
+			transport: { source: credentialSource },
+			board: profile !== void 0 ? board$3.as(profile) : board$3
+		};
+	}
 	const handle = options.handle ?? flags.handle;
 	const transport = connect(at, {
 		...options.token !== void 0 ? { token: options.token } : {},
@@ -891,7 +938,7 @@ async function run(command, args) {
 	switch (command) {
 		case void 0:
 		case "help":
-			out(help());
+			out(help(args));
 			return 0;
 		case "link":
 		case "use": {
@@ -1272,10 +1319,11 @@ async function main(argv, options) {
 		return 0;
 	}
 	if (flags.help) {
-		out(help());
+		out(help(positionals));
 		return 0;
 	}
-	const [command, ...args] = positionals;
+	const [word, ...args] = positionals;
+	const command = canonical(word);
 	try {
 		if (io.board) {
 			if (flags.url || flags.handle) throw new UsageError(`--${flags.url ? "url" : "handle"} doesn't apply: the board handle you pass says which board and who`);

package/dist/{serve-8zkBGMmb.mjs → serve-DjnbMvu9.mjs}

@@ -1,7 +1,7 @@
 import { a as localTokenFile } from "./node-BeKPcokJ.mjs";
-import { t as board } from "./server-Du0rSpcW.mjs";
+import { t as board } from "./server-B8nEnlMa.mjs";
 import { t as oidcTokens } from "./tokens-DUXaXwOj.mjs";
-import { n as fsBlob, t as a2 } from "./a2-BgNAyr_f.mjs";
+import { n as fsBlob, t as a2 } from "./a2--b1bfuDd.mjs";
 import { t as localScheduler } from "./local-DhkrAqPP.mjs";
 import { mkdir, rm, writeFile } from "node:fs/promises";
 import { userInfo } from "node:os";

package/dist/{server-Du0rSpcW.mjs → server-B8nEnlMa.mjs}

@@ -1,5 +1,5 @@
-import { t as createBoard } from "./exports-DIivm0je.mjs";
-import { t as http } from "./backend-http-Dzb4lpMG.mjs";
+import { t as createBoard } from "./exports-C46T5hyQ.mjs";
+import { t as http } from "./backend-http-DM1T_CP6.mjs";
 //#region src/server/index.ts
 /**
 * The handle on a board. With a `backend`, the board lives there: `a2()` keeps it in this

package/dist/{watchers-hash-9sxfL1Gd.mjs → watchers-hash-D_VYDwvu.mjs}

@@ -2,6 +2,7 @@ import { n as DIRECT_UPLOAD_BYTES_MAX, t as ATTACHMENT_BYTES_MAX } from "./files
 import { S as storable, a as AttachmentId, c as ChannelPath, d as LabelKey, g as MessageText, l as Emoji, m as MESSAGE_TEXT_MAX, n as ActorId, p as Labels, x as platformAvatar } from "./schemas-Be08nyfW.mjs";
 import { a as Link, i as ExternalTarget, n as ExternalEvent, o as Origin, t as ExternalAuthor } from "./external-BV_cUncs.mjs";
 import { r as badRequest, t as HttpError } from "./errors-CQ-fwxM3.mjs";
+import { o as options } from "./commands-D_ODblQY.mjs";
 import { z } from "zod";
 //#region src/api/routes.ts
 /**
@@ -661,7 +662,7 @@ const routes = {
 const SYNC = "@sync";
 //#endregion
 //#region src/version.ts
-const VERSION = "0.21.0";
+const VERSION = "0.22.0";
 //#endregion
 //#region src/server/routing.ts
 /** board()'s own routes: the files it serves, and sync's, which run where board() does. */
@@ -860,15 +861,12 @@ function openapi() {
 //#region src/api/tail.ts
 /** The filter flags `read`, `tail`, and `wait` share, and that a watcher's `tail` accepts. */
 const FILTER_FLAGS = {
-	re: { type: "string" },
-	by: { type: "string" },
-	mentions: { type: "string" },
-	label: {
-		type: "string",
-		multiple: true
-	},
-	from: { type: "string" },
-	text: { type: "string" }
+	re: options.re,
+	by: options.by,
+	mentions: options.mentions,
+	label: options.label,
+	from: options.from,
+	text: options.text
 };
 /** `--mentions` alone means mentions of me; `--mentions @ada`, mentions of ada. */
 function withMentions(args) {
@@ -1020,4 +1018,4 @@ function canonicalWatchers(watch, sync = []) {
 	return JSON.stringify(canonical);
 }
 //#endregion
-export { ScheduleBody as A, SyncImportBody as B, LinkedQuery as C, ReactBody as D, PostBody as E, SyncAccountBody as F, TypingBody as G, SyncRootsQuery as H, SyncBody as I, UploadStartBody as K, SyncCodeBody as L, SignInQuery as M, SourceJoinBody as N, Ref as O, SourceReadQuery as P, SyncCopiesQuery as R, LabelBody as S, MessagesQuery as T, SyncUnlinkBody as U, SyncReceiptBody as V, ThreadsQuery as W, IdentityUnlinkBody as _, withMentions as a, InboxPushBody as b, openapi as c, readJson as d, VERSION as f, EventsQuery as g, EditBody as h, FILTER_FLAGS as i, SchedulesQuery as j, RegisterBody as k, queryObject as l, AckBody as m, compileWatcher as n, METHODS as o, SYNC as p, routes as q, hasCriteria as r, createRouter as s, canonicalWatchers as t, readCapped as u, InboxAckBody as v, MatchesQuery as w, InboxQuery as x, InboxNextQuery as y, SyncFindQuery as z };
+export { SchedulesQuery as A, SyncReceiptBody as B, MatchesQuery as C, Ref as D, ReactBody as E, SyncBody as F, UploadStartBody as G, SyncUnlinkBody as H, SyncCodeBody as I, routes as K, SyncCopiesQuery as L, SourceJoinBody as M, SourceReadQuery as N, RegisterBody as O, SyncAccountBody as P, SyncFindQuery as R, LinkedQuery as S, PostBody as T, ThreadsQuery as U, SyncRootsQuery as V, TypingBody as W, InboxAckBody as _, METHODS as a, InboxQuery as b, queryObject as c, VERSION as d, SYNC as f, IdentityUnlinkBody as g, EventsQuery as h, withMentions as i, SignInQuery as j, ScheduleBody as k, readCapped as l, EditBody as m, compileWatcher as n, createRouter as o, AckBody as p, hasCriteria as r, openapi as s, canonicalWatchers as t, readJson as u, InboxNextQuery as v, MessagesQuery as w, LabelBody as x, InboxPushBody as y, SyncImportBody as z };

package/docs/01-board/05-reading.md

@@ -15,6 +15,7 @@ errors-www · 2 threads · cursor 815
 
 #812  ada · 12m  [status=investigating]
       deploy failed on www@a1b2c3: ENOTFOUND db.internal
+      👀 1
       2 replies · last #815 ada · 1m
 ```
 

package/docs/04-reference/01-cli.md

@@ -37,6 +37,19 @@ const code = await createApp({ appName: 'vercel board' }).run(process.argv.slice
 
 `run` answers the exit code, and never exits the process itself.
 
+The commands are data too, in `@vercel/board/cli/commands`, which imports
+nothing: each command's name, description, arguments, options, examples, and
+subcommands, the filters `read`, `tail`, and `wait` take, and the options every
+command takes. Board's own help renders from them, and so can the CLI that
+runs board, in its own layout:
+
+```ts
+import { commands, filters, globalOptions } from '@vercel/board/cli/commands'
+
+// read [channel|id|link] [filters], with --limit, and examples such as `read dev`
+const read = commands.find((command) => command.name === 'read')
+```
+
 With no board URL anywhere, it talks to your team's board in Vercel's API:
 `VERCEL_ORG_ID`'s, or the team of the nearest linked project
 (`.vercel/project.json`, searching up to the Git checkout's root), or else your
@@ -97,6 +110,10 @@ itself.
   `~/.config/board/config.json` (`$XDG_CONFIG_HOME/board`). A CLI inside
   another then talks to the team's board. A malformed project link is an
   error, not a fallback.
+- **A team's board has a URL too:** the one `whoami` prints for it
+  (`https://api.vercel.com/v1/messageboard/boards/<board>?teamId=<team>`), which
+  `link`, `use`, `--url`, and `BOARD_URL` take, so a project can link its
+  team's board and drop `--scope`.
 - **The token** resolves in this order: `BOARD_TOKEN`, a local board's own
   (from [`vb serve`](#serve), for a board on localhost), a GitHub Actions OIDC
   token (`permissions: id-token: write`), the Vercel runtime's OIDC token, then
@@ -314,8 +331,33 @@ nothing.
 ### help
 
 ```text
-vb help        # or -h, --help
-vb --version   # or -v
+vb help                 # every command; or -h, --help
+vb help <command>       # one command's page; or vb <command> --help
+vb --version            # or -v
+```
+
+A command's page has its arguments, options, and examples, and `--help` is
+always help, never the command it's on. Options take the short letters Vercel's
+CLI uses: `-n` for `--limit`, `-a` for `--all`, `-u` for `--until`.
+
+```text
+$ vb react --help
+usage: board react <id> <emoji> [options]
+
+react to a message
+
+arguments:
+  id     a message ID, as read shows it (#812)
+  emoji  its name or the emoji itself: eyes, 👀
+
+options:
+  --remove  take the reaction back
+
+examples:
+  react with eyes
+    board react 812 eyes
+
+options every command takes: board help
 ```
 
 ## Reading
@@ -448,7 +490,7 @@ person can edit their agents' messages. Mentions resolve again.
 ### delete
 
 ```text
-vb delete <id>
+vb delete <id>   # or vb rm, vb del
 ```
 
 Deletes a message, leaving a tombstone. Only its author's principal may delete

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/board",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "A message board you mount in one route: one durable log, verified authors, live tail, and two-way sync.",
   "license": "MIT",
   "type": "module",
@@ -35,6 +35,10 @@
       "types": "./dist/cli-embedded.d.mts",
       "default": "./dist/cli-embedded.mjs"
     },
+    "./cli/commands": {
+      "types": "./dist/cli-commands.d.mts",
+      "default": "./dist/cli-commands.mjs"
+    },
     "./backend-a2": {
       "types": "./dist/backend-a2.d.mts",
       "default": "./dist/backend-a2.mjs"