seedcord 0.23.0-next.2 → 0.23.0-next.3

package/README.md

@@ -50,6 +50,7 @@ Run it through your project's scripts, like `pnpm dev`. A global `seedcord` thro
 | `seedcord codegen` | writes the typed augmentations for your commands and config |
 | `seedcord commands` | deploys, lists and cleans up your commands on Discord |
 | `seedcord make` | writes new files from one of your Handlebars templates, or one an installed plugin ships |
+| `seedcord ask` | searches the guide for a question, a pasted error, or an error code, and works outside a project |
 
 <!-- prettier-ignore-end -->
 

package/dist/cli.mjs

@@ -1,18 +1,18 @@
-import { n as SEEDCORD_CONFIG_FILENAMES, t as version } from "./version-Cmdvyxh7.mjs";
+import { n as SEEDCORD_CONFIG_FILENAMES, t as version } from "./version-Xg0cBcsP.mjs";
 import { createRequire } from "node:module";
 import { Command, Option } from "@commander-js/extra-typings";
 import { SeedcordErrorCode, isSeedcordError, paint } from "@seedcord/errors";
 import { formatBody, installNodeConsole, installNodeDefaults } from "@seedcord/logger/node";
+import uFuzzy from "@leeoniya/ufuzzy";
+import { BOT_FILES_KEY, BUILT_FILES_READY_KEY, BotLayout, asError, encodeFile, hasErrorCode, importFailed, importSpecifier, isInside, isInteractive, isPlainObject, isPortInUse, isStringArray, pluralize, posixRelative, recordThrownBy, routeLeavesOf, setCliFiles, setDevFiles, toPosixPath, unlessAborted, vitePluginThrew, withoutQuery, workerdPath } from "@seedcord/utils/internal";
 import wrapAnsi from "wrap-ansi";
 import { SeedcordError, SeedcordRangeError, SeedcordTypeError, WORDMARK, displayPath, throwSingleOrAggregate } from "@seedcord/errors/internal";
 import { Box, Text, render, useAnimation, useBoxMetrics, useInput, useWindowSize } from "ink";
 import React, { Fragment, useEffect, useEffectEvent, useMemo, useReducer, useRef, useState, useSyncExternalStore } from "react";
-import uFuzzy from "@leeoniya/ufuzzy";
 import cliSpinners from "cli-spinners";
 import { LEVEL_COLOR, Logger, LoggerChannelRegistry } from "@seedcord/logger";
 import chalk from "chalk";
 import { basename, delimiter, dirname, join, posix, relative, resolve, sep, win32 } from "node:path";
-import { BOT_FILES_KEY, BUILT_FILES_READY_KEY, BotLayout, asError, encodeFile, hasErrorCode, importFailed, importSpecifier, isInside, isInteractive, isPlainObject, isPortInUse, isStringArray, pluralize, posixRelative, recordThrownBy, routeLeavesOf, setCliFiles, setDevFiles, toPosixPath, unlessAborted, vitePluginThrew, withoutQuery, workerdPath } from "@seedcord/utils/internal";
 import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
 import { CONSOLE_LEVEL, CONSOLE_METHODS, consoleRecord, logsFolderIn, routeConsole, traceError } from "@seedcord/logger/internal";
 import { spawn } from "node:child_process";
@@ -42,6 +42,274 @@ import { Writable } from "node:stream";
 import { camelCase, debounce, kebabCase, pascalCase, snakeCase } from "es-toolkit";
 import Handlebars from "handlebars";
 
+//#region ../../tooling/brand/dist/index.mjs
+const BRAND_COLORS = {
+	pith: "#f8f6e8",
+	seedDark: "#2d3328",
+	flesh: "#f04e36",
+	fleshDeep: "#c8341f",
+	rind: "#6fab49",
+	rindDeep: "#4d7d33"
+};
+var SiteAddress$1 = class {
+	url;
+	constructor(url) {
+		this.url = url.replace(/\/+$/, "");
+	}
+	get label() {
+		return this.url.replace(/^[a-z]+:\/\//, "");
+	}
+	get path() {
+		return new URL(this.url).pathname.replace(/\/$/, "");
+	}
+	get exportDir() {
+		return `dist${this.path}`;
+	}
+	at(path) {
+		if (path === "") return this.url;
+		return `${this.url}/${path.replace(/^\/+/, "")}`;
+	}
+};
+const PRODUCTION_ORIGIN$1 = "https://seedcord.org";
+const PRODUCTION_SITES$1 = {
+	home: new SiteAddress$1(PRODUCTION_ORIGIN$1),
+	guide: new SiteAddress$1(`${PRODUCTION_ORIGIN$1}/guide`),
+	docs: new SiteAddress$1(`${PRODUCTION_ORIGIN$1}/docs`)
+};
+const NEXT_GUIDE = new SiteAddress$1(`https://next.seedcord.org${PRODUCTION_SITES$1.guide.path}`);
+
+//#endregion
+//#region ../../tooling/docs-search/dist/index.mjs
+const ASK_WAIT_STATUS = {
+	tooManySearches: 429,
+	outOfAllowance: 503
+};
+const WAIT_REASONS = {
+	[ASK_WAIT_STATUS.tooManySearches]: "Too many searches.",
+	[ASK_WAIT_STATUS.outOfAllowance]: "The guide search hit its daily limit."
+};
+const isAskWaitStatus = (status) => status in WAIT_REASONS;
+const UNITS = [{
+	unit: "hour",
+	seconds: 3600
+}, {
+	unit: "minute",
+	seconds: 60
+}];
+const relative$1 = new Intl.RelativeTimeFormat("en", { numeric: "always" });
+function tryAgainIn(seconds) {
+	const fits = UNITS.find((size) => seconds >= size.seconds);
+	return fits ? relative$1.format(Math.ceil(seconds / fits.seconds), fits.unit) : relative$1.format(seconds, "second");
+}
+const waitMessage = (status, seconds) => `${WAIT_REASONS[status]} Try again ${tryAgainIn(seconds)}.`;
+var SearchUnavailable = class extends Error {
+	constructor(status, retryAfterSeconds) {
+		super(waitMessage(status, retryAfterSeconds));
+	}
+};
+const DocKind = {
+	Project: 1,
+	Module: 2,
+	Namespace: 4,
+	Enum: 8,
+	EnumMember: 16,
+	Variable: 32,
+	Function: 64,
+	Class: 128,
+	Interface: 256,
+	Constructor: 512,
+	Property: 1024,
+	Method: 2048,
+	CallSignature: 4096,
+	IndexSignature: 8192,
+	ConstructorSignature: 16384,
+	Parameter: 32768,
+	TypeLiteral: 65536,
+	TypeParameter: 131072,
+	Accessor: 262144,
+	GetSignature: 524288,
+	SetSignature: 1048576,
+	TypeAlias: 2097152,
+	Reference: 4194304
+};
+const KIND_SCORE_TABLE = {
+	[DocKind.Class]: 18,
+	[DocKind.Interface]: 16,
+	[DocKind.TypeAlias]: 15,
+	[DocKind.Enum]: 14,
+	[DocKind.Function]: 13,
+	[DocKind.Constructor]: 12,
+	[DocKind.Method]: 11,
+	[DocKind.Accessor]: 10,
+	[DocKind.Property]: 9,
+	[DocKind.EnumMember]: 7,
+	[DocKind.Variable]: 7,
+	[DocKind.TypeParameter]: 6,
+	[DocKind.Project]: 1,
+	[DocKind.Module]: 6,
+	[DocKind.Namespace]: 6,
+	[DocKind.CallSignature]: 10,
+	[DocKind.ConstructorSignature]: 10,
+	[DocKind.IndexSignature]: 8,
+	[DocKind.GetSignature]: 10,
+	[DocKind.SetSignature]: 10
+};
+const nameOnly = (_digits, name) => name;
+const digitsAndName = (digits, name) => `${digits} ${name}`;
+const CERTAIN_CODES = [
+	{
+		pattern: /\[(\d{4})\]/g,
+		rewrite: nameOnly
+	},
+	{
+		pattern: /^(\d{4})$/g,
+		rewrite: nameOnly
+	},
+	{
+		pattern: /(?<=\berror(?: code)?\W{0,3})(\d{4})\b/gi,
+		rewrite: digitsAndName
+	}
+];
+const FOUR_DIGITS_ON_THEIR_OWN = /(?<![\w.:/#-])\d{4}(?![\w:/-]|\.\d)/g;
+var ErrorCodeReader = class {
+	codeNames;
+	constructor(codeNames) {
+		this.codeNames = codeNames;
+	}
+	read(question) {
+		const swapped = /* @__PURE__ */ new Map();
+		let withNames = question;
+		for (const { pattern, rewrite } of CERTAIN_CODES) withNames = withNames.replace(pattern, (written, digits) => {
+			const mention = this.mentionOf(digits);
+			if (mention === void 0) return written;
+			swapped.set(mention.code, mention);
+			return rewrite(digits, mention.name);
+		});
+		const hints = /* @__PURE__ */ new Map();
+		for (const [digits] of withNames.matchAll(FOUR_DIGITS_ON_THEIR_OWN)) {
+			const mention = this.mentionOf(digits);
+			if (mention !== void 0 && !swapped.has(mention.code)) hints.set(mention.code, mention);
+		}
+		return {
+			question: withNames,
+			swapped: [...swapped.values()],
+			hints: [...hints.values()]
+		};
+	}
+	mentionOf(digits) {
+		const code = Number(digits);
+		const name = this.codeNames[code];
+		return name === void 0 ? void 0 : {
+			code,
+			name
+		};
+	}
+};
+const errorCodeQuestion = (code) => `error ${code}`;
+var SiteAddress = class {
+	url;
+	constructor(url) {
+		this.url = url.replace(/\/+$/, "");
+	}
+	get label() {
+		return this.url.replace(/^[a-z]+:\/\//, "");
+	}
+	get path() {
+		return new URL(this.url).pathname.replace(/\/$/, "");
+	}
+	get exportDir() {
+		return `dist${this.path}`;
+	}
+	at(path) {
+		if (path === "") return this.url;
+		return `${this.url}/${path.replace(/^\/+/, "")}`;
+	}
+};
+const PRODUCTION_ORIGIN = "https://seedcord.org";
+const PRODUCTION_SITES = {
+	home: new SiteAddress(PRODUCTION_ORIGIN),
+	guide: new SiteAddress(`${PRODUCTION_ORIGIN}/guide`),
+	docs: new SiteAddress(`${PRODUCTION_ORIGIN}/docs`)
+};
+new SiteAddress(`https://next.seedcord.org${PRODUCTION_SITES.guide.path}`);
+const EXTENSION = ".json";
+const REFERENCE_SEARCH_URL = PRODUCTION_SITES.docs.at("/api/search");
+const GUIDE_ASK_PATH = "/api/ask";
+const searchFileName = (version) => `${version}${EXTENSION}`;
+const PACKAGES_FILE_NAME = searchFileName("packages");
+const guideResult = (hit, found, site) => ({
+	...hit,
+	url: site.at(hit.path),
+	...found
+});
+const fetchPath = (path) => fetch(path);
+const withoutQuery$1 = (path) => path.replace(/\?.*$/, "");
+var SiteUnreachable = class extends Error {
+	constructor(path, cause) {
+		super(`${withoutQuery$1(path)} failed to load because the request never reached the server`, { cause });
+	}
+};
+async function requestReachingServer(path, read) {
+	try {
+		return await read(path);
+	} catch (error) {
+		if (error instanceof TypeError) throw new SiteUnreachable(path, error);
+		throw error;
+	}
+}
+async function readAsset(path, read = fetchPath) {
+	const response = await requestReachingServer(path, read);
+	if (!response.ok) throw new Error(`${withoutQuery$1(path)} failed to load with status ${response.status}`);
+	return response;
+}
+async function readJson$1(path, read = fetchPath) {
+	return await (await readAsset(path, read)).json();
+}
+async function fetchAnswer(url, signal) {
+	const response = await fetch(url, { signal });
+	const retryAfter = Number(response.headers.get("retry-after"));
+	if (isAskWaitStatus(response.status) && Number.isSafeInteger(retryAfter) && retryAfter > 0) throw new SearchUnavailable(response.status, retryAfter);
+	return response;
+}
+var GuideSearch = class {
+	site;
+	constructor(site) {
+		this.site = site;
+	}
+	async search(question, signal) {
+		const url = new URL(this.site.at(GUIDE_ASK_PATH));
+		url.searchParams.set("q", question);
+		return (await readJson$1(url.href, (path) => fetchAnswer(path, signal))).map((hit) => guideResult(hit, { by: "meaning" }, this.site));
+	}
+};
+const QUESTION_LENGTH = {
+	min: 2,
+	max: 500
+};
+const QUESTION_RULE = `${QUESTION_LENGTH.min} to ${QUESTION_LENGTH.max} characters, with a letter or a number in them`;
+const LETTER_OR_NUMBER = /[\p{L}\p{N}]/u;
+const isQuestion = (text) => text.length >= QUESTION_LENGTH.min && text.length <= QUESTION_LENGTH.max && LETTER_OR_NUMBER.test(text);
+const collapseSpaces = (text) => text.replaceAll(/\s+/g, " ");
+function parseQuestion(input) {
+	const question = collapseSpaces(input.trim());
+	return isQuestion(question) ? question : void 0;
+}
+const STACK_FRAME$1 = /^\s*at .*(?::\d+:\d+\)?|<anonymous>\)?|\(index \d+\))\s*$/gm;
+function cutAtWord(text, max) {
+	if (text.length <= max) return text;
+	const lastSpace = text.lastIndexOf(" ", max);
+	return text.slice(0, lastSpace > 0 ? lastSpace : max);
+}
+function questionFromText(text) {
+	const withoutFrames = collapseSpaces(text.replaceAll(STACK_FRAME$1, "").trim());
+	const kept = cutAtWord(withoutFrames, QUESTION_LENGTH.max);
+	return {
+		question: parseQuestion(kept),
+		shortened: kept.length < withoutFrames.length
+	};
+}
+
+//#endregion
 //#region src/core/output/wrapLines.ts
 function wrapLines(text, width, prefix) {
 	return text.split("\n").flatMap((line) => {
@@ -817,12 +1085,14 @@ var StepPrinter = class {
 	command;
 	labelWidth;
 	verbose;
+	rows;
 	stdout;
 	stderr;
-	constructor({ command, labels, verbose, stdout = process.stdout, stderr = process.stderr }) {
+	constructor({ command, labels, verbose, rows = true, stdout = process.stdout, stderr = process.stderr }) {
 		this.command = command;
 		this.labelWidth = Math.max(...labels.map((label) => label.length));
 		this.verbose = verbose;
+		this.rows = rows;
 		this.stdout = stdout;
 		this.stderr = stderr;
 	}
@@ -830,6 +1100,7 @@ var StepPrinter = class {
 		this.stdout.write(`\n${WORDMARK} ${paint.mute(`v${version}`)}  ${this.command}\n\n`);
 	}
 	async step(label, task, note, lines) {
+		if (!this.rows) return task();
 		const write = this.stdout.write.bind(this.stdout);
 		const row = new StepRow({
 			write,
@@ -887,17 +1158,33 @@ function exitFor(error) {
 var BaseCommand = class {
 	name;
 	description;
-	constructor(name, description) {
+	needsProject;
+	constructor(name, description, { needsProject = true } = {}) {
 		this.name = name;
 		this.description = description;
+		this.needsProject = needsProject;
 	}
-	async runSteps(command, labels, run) {
+	define(program) {
+		return program.command(this.name).description(this.description);
+	}
+	runSteps(command, labels, run) {
 		const printer = new StepPrinter({
 			command: this.name,
 			labels,
 			verbose: isVerbose(command)
 		});
 		printer.header();
+		return this.runOn(printer, run);
+	}
+	runQuietSteps(command, labels, run) {
+		return this.runOn(new StepPrinter({
+			command: this.name,
+			labels,
+			verbose: isVerbose(command),
+			rows: false
+		}), run);
+	}
+	async runOn(printer, run) {
 		try {
 			await run(printer);
 		} catch (error) {
@@ -918,6 +1205,162 @@ var BaseCommand = class {
 	}
 };
 
+//#endregion
+//#region ../../tooling/ui/dist/PageAsset.mjs
+const ROOT = "index";
+const toSegments = (path) => path.split("/").filter(Boolean);
+var PageAsset = class {
+	extension;
+	directory;
+	constructor(extension, directory) {
+		this.extension = extension;
+		this.directory = directory;
+	}
+	static forPath(pathname) {
+		return PAGE_ASSETS.find((asset) => pathname.endsWith(asset.extension));
+	}
+	fileSegments(pageSegments) {
+		const last = pageSegments.at(-1) ?? ROOT;
+		return [...pageSegments.slice(0, -1), `${last}${this.extension}`];
+	}
+	pageSegments(fileSegments) {
+		const last = fileSegments.at(-1);
+		if (last?.endsWith(this.extension) !== true) return void 0;
+		const name = last.slice(0, -this.extension.length);
+		const folders = fileSegments.slice(0, -1);
+		return folders.length === 0 && name === ROOT ? [] : [...folders, name];
+	}
+	publicPath(pagePath) {
+		const page = pagePath.endsWith(this.extension) ? pagePath.slice(0, -this.extension.length) : pagePath;
+		return `/${this.fileSegments(toSegments(page)).join("/")}`;
+	}
+	exportPath(pagePath) {
+		return `/${this.directory}${this.publicPath(pagePath)}`;
+	}
+};
+const TWIN = new PageAsset(".md", "llms");
+const CARD = new PageAsset(".png", "og");
+const PAGE_ASSETS = [TWIN, CARD];
+
+//#endregion
+//#region src/commands/commands/StepsPresenter.ts
+var StepsPresenter = class {
+	output;
+	constructor(output) {
+		this.output = output;
+	}
+	step(label, task, note) {
+		return this.output.step(label, task, note);
+	}
+	detail(key, value) {
+		this.output.detail(key, value);
+	}
+};
+
+//#endregion
+//#region src/commands/ask/AskPresenter.ts
+const ASK_STEPS = ["search"];
+const SHORTENED = `Your text is over ${QUESTION_LENGTH.max} characters, so seedcord ask searched only the start of it.`;
+const FOR_PERSON = {
+	pageLines: ({ title, sections }) => [paint.bold(title), ...sections.flatMap(({ heading, url }) => [...heading === void 0 ? [] : [`  ${heading}`], `  ${paint.sky(url)}`])],
+	wholeGuide: (site) => site.url
+};
+const FOR_AGENT = {
+	pageLines: ({ title, path, sections }, site) => [`${paint.bold(title)}: ${paint.sky(site.at(TWIN.publicPath(path)))}`, ...sections.flatMap(({ heading }) => heading === void 0 ? [] : [`  - ${heading}`])],
+	wholeGuide: (site) => site.at("llms.txt")
+};
+function pagesOf(results) {
+	const pages = /* @__PURE__ */ new Map();
+	for (const result of results) {
+		const path = result.path.replace(/#.*$/, "");
+		const title = result.page === result.tab ? result.page : `${result.page} (${result.tab})`;
+		const page = pages.get(path) ?? {
+			title,
+			path,
+			sections: []
+		};
+		if (result.heading === void 0) page.sections.unshift(result);
+		else page.sections.push(result);
+		pages.set(path, page);
+	}
+	return [...pages.values()];
+}
+function codeNotes({ swapped, hints }) {
+	return [...swapped.map(({ code, name }) => paint.italic(`${code} is ${paint.bold(name)}`)), ...hints.map(({ code, name }) => paint.italic(`${code} is also the error code ${paint.bold(name)}. If you meant that, run: ${paint.bold(`seedcord ask "${errorCodeQuestion(code)}"`)}`))];
+}
+var AskPresenter = class extends StepsPresenter {
+	format;
+	site;
+	constructor(output, format, site) {
+		super(output);
+		this.format = format;
+		this.site = site;
+	}
+	answer({ codes, shortened, results }) {
+		const notes = [...codeNotes(codes), ...shortened ? [SHORTENED] : []];
+		const pages = pagesOf(results).map((page) => this.format.pageLines(page, this.site));
+		const answer = pages.length > 0 ? pages : [[this.noMatches()]];
+		this.output.line();
+		for (const block of [notes, ...answer]) {
+			if (block.length === 0) continue;
+			for (const line of block) this.output.line(line);
+			this.output.line();
+		}
+	}
+	noMatches() {
+		return `Nothing in the guide matches. Try a full sentence, or read ${paint.sky(this.format.wholeGuide(this.site))}`;
+	}
+};
+
+//#endregion
+//#region src/commands/ask/AskRunner.ts
+const SEARCH_TIMEOUT_MS = 1e4;
+const CODE_READER = new ErrorCodeReader(SeedcordErrorCode);
+var AskRunner = class {
+	site;
+	guide;
+	constructor(site, guide) {
+		this.site = site;
+		this.guide = guide;
+	}
+	async run(output, format, text) {
+		const { question, shortened } = questionFromText(text);
+		if (question === void 0) throw new SeedcordTypeError(SeedcordErrorCode.CliAskBadQuestion, [QUESTION_LENGTH.min]);
+		const presenter = new AskPresenter(output, format, this.site);
+		presenter.detail("site", this.site.url);
+		const results = await presenter.step("search", () => this.search(question));
+		presenter.answer({
+			codes: CODE_READER.read(question),
+			shortened,
+			results
+		});
+	}
+	async search(question) {
+		try {
+			return await this.guide.search(question, AbortSignal.timeout(SEARCH_TIMEOUT_MS));
+		} catch (error) {
+			if (error instanceof SearchUnavailable) throw new SeedcordError(SeedcordErrorCode.CliAskHasToWait, [error.message, this.site.url], { cause: error });
+			throw new SeedcordError(SeedcordErrorCode.CliAskFailed, [asError(error).message, this.site.url], { cause: error });
+		}
+	}
+};
+
+//#endregion
+//#region src/commands/ask/AskCommand.ts
+const GUIDE_SITE = "0.23.0-next.3".includes("-") ? NEXT_GUIDE : PRODUCTION_SITES$1.guide;
+var AskCommand = class extends BaseCommand {
+	runner = new AskRunner(GUIDE_SITE, new GuideSearch(GUIDE_SITE));
+	constructor() {
+		super("ask", "Search the guide", { needsProject: false });
+	}
+	register(program) {
+		return this.define(program).argument("<question...>", "What to search for, or an error code or message to look up").allowUnknownOption().action((words, _options, command) => {
+			const question = words.join(" ");
+			return isInteractive() ? this.runSteps(command, ASK_STEPS, (printer) => this.runner.run(printer, FOR_PERSON, question)) : this.runQuietSteps(command, ASK_STEPS, (printer) => this.runner.run(printer, FOR_AGENT, question));
+		});
+	}
+};
+
 //#endregion
 //#region src/core/config/openProjectWithSteps.ts
 async function openProjectWithSteps(steps, loader, { projectDir, check } = {}) {
@@ -3316,7 +3759,7 @@ var BuildCommand = class extends BaseCommand {
 		super("build", "Type check the bot and bundle it from the config file");
 	}
 	register(program) {
-		program.command(this.name).description(this.description).action((_options, command) => this.runSteps(command, BUILD_STEPS, async (printer) => {
+		return this.define(program).action((_options, command) => this.runSteps(command, BUILD_STEPS, async (printer) => {
 			printBuildSummary(printer, await BuildRunner.create(printer).run());
 		}));
 	}
@@ -3814,7 +4257,7 @@ var CodegenCommand = class extends BaseCommand {
 		super("codegen", "Generate typed augmentations from your commands and config");
 	}
 	register(program) {
-		program.command(this.name).description(this.description).option("--check", "Verify the committed augmentations are up to date instead of writing them").action((options, command) => this.runSteps(command, CODEGEN_STEPS, async (printer) => {
+		return this.define(program).option("--check", "Verify the committed augmentations are up to date instead of writing them").action((options, command) => this.runSteps(command, CODEGEN_STEPS, async (printer) => {
 			const check = options.check ?? false;
 			const { outputPath, changed } = await CodegenRunner.create(printer, cliLogger("Codegen")).run(check);
 			printer.line();
@@ -3945,21 +4388,6 @@ function printSections(output, sections) {
 	}
 }
 
-//#endregion
-//#region src/commands/commands/StepsPresenter.ts
-var StepsPresenter = class {
-	output;
-	constructor(output) {
-		this.output = output;
-	}
-	step(label, task, note) {
-		return this.output.step(label, task, note);
-	}
-	detail(key, value) {
-		this.output.detail(key, value);
-	}
-};
-
 //#endregion
 //#region src/commands/commands/deploy/DeployPresenter.ts
 function deployedNote(scopes) {
@@ -4664,7 +5092,7 @@ var CommandsCommand = class extends BaseCommand {
 		this.prompter = prompter;
 	}
 	register(program) {
-		const commands = program.command(this.name).description(this.description).action((_options, command) => this.openMenu(command));
+		const commands = this.define(program).action((_options, command) => this.openMenu(command));
 		commands.command("deploy").description("Deploy the commands in your code to Discord").option("--yes", "Deploy without asking first").option("--force", "Also deploy the scopes that match the last deploy").action((options, command) => this.runSteps(command, DEPLOY_STEPS, (printer) => this.deploy(printer, command, options)));
 		commands.command("list").description("List the commands Discord has for your bot").option("--guilds <ids...>", "Also list these guilds").addOption(allGuildsOption("Also list every guild the bot is in")).option("--json", "Print the listing as JSON for scripts").action((options, command) => {
 			const scope = {
@@ -4676,6 +5104,7 @@ var CommandsCommand = class extends BaseCommand {
 		});
 		commands.command("clean").description("Delete guild commands that duplicate a global command").option("--guilds <ids...>", "Guild ids to scan").addOption(allGuildsOption("Scan every guild the bot is in")).option("--yes", "Delete the duplicates without asking").action((flags, command) => this.remove(command, flags, new CleanMode(), askClean));
 		commands.command("purge").description("Delete every command globally or in guilds").option("--global", "Delete every global command").option("--guilds <ids...>", "Delete every command in these guilds").addOption(allGuildsOption("Delete every command in every guild the bot is in")).option("--yes", "Delete the commands without asking").action((flags, command) => this.remove(command, flags, new PurgeMode(flags.global ?? false), askPurge));
+		return commands;
 	}
 	async openMenu(command) {
 		if (!isInteractive()) {
@@ -5959,42 +6388,6 @@ function ScrollableLogView({ visible, layout, viewportHeight, measured }) {
 	})));
 }
 
-//#endregion
-//#region ../../tooling/brand/dist/index.mjs
-const BRAND_COLORS = {
-	pith: "#f8f6e8",
-	seedDark: "#2d3328",
-	flesh: "#f04e36",
-	fleshDeep: "#c8341f",
-	rind: "#6fab49",
-	rindDeep: "#4d7d33"
-};
-var SiteAddress = class {
-	url;
-	constructor(url) {
-		this.url = url.replace(/\/+$/, "");
-	}
-	get label() {
-		return this.url.replace(/^[a-z]+:\/\//, "");
-	}
-	get path() {
-		return new URL(this.url).pathname.replace(/\/$/, "");
-	}
-	get exportDir() {
-		return `dist${this.path}`;
-	}
-	at(path) {
-		if (path === "") return this.url;
-		return `${this.url}/${path.replace(/^\/+/, "")}`;
-	}
-};
-const PRODUCTION_ORIGIN = "https://seedcord.org";
-const PRODUCTION_SITES = {
-	home: new SiteAddress(PRODUCTION_ORIGIN),
-	guide: new SiteAddress(`${PRODUCTION_ORIGIN}/guide`),
-	docs: new SiteAddress(`${PRODUCTION_ORIGIN}/docs`)
-};
-
 //#endregion
 //#region src/ui/components/Banner.tsx
 function Banner({ version }) {
@@ -8036,7 +8429,7 @@ var TunnelCoordinator = class {
 //#region src/commands/dev/tunnel/createTunnelCoordinator.ts
 const PASTE_HINT = "The tunnel is still up, so try pasting that URL into the dashboard.";
 const RESTART_HINT = "Restart for a fresh hostname, or set `tunnel` to an https URL you already serve.";
-const NO_PORT_HINT = `seedcord didn't start a tunnel, since the bot runs with ${paint.bold("port: false")} and cloudflared doesn't have a port to forward to. Give the bot a port while you develop, or set ${paint.amber("tunnel")} to the URL of the server that serves your bot: ${paint.sky(PRODUCTION_SITES.guide.at("build/embed"))}`;
+const NO_PORT_HINT = `seedcord didn't start a tunnel, since the bot runs with ${paint.bold("port: false")} and cloudflared doesn't have a port to forward to. Give the bot a port while you develop, or set ${paint.amber("tunnel")} to the URL of the server that serves your bot: ${paint.sky(PRODUCTION_SITES$1.guide.at("build/embed"))}`;
 function missingCloudflaredHint(platform) {
 	const arrow = paint.mute("→");
 	return [
@@ -8357,7 +8750,7 @@ var DevCommand = class extends BaseCommand {
 		super("dev", "Run the bot from the config file");
 	}
 	register(program) {
-		program.command(this.name).description(this.description).action(async () => {
+		return this.define(program).action(async () => {
 			profileStdout();
 			const store = new DevStore();
 			const stateFolder = new StateFolder(process.cwd(), this.logger);
@@ -8966,7 +9359,7 @@ var MakeCommand = class extends BaseCommand {
 		super("make", "Write new files from one of your templates");
 	}
 	register(program) {
-		program.command(this.name).description(this.description).action((_options, command) => this.runSteps(command, MAKE_STEPS, (printer) => unlessCancelled(printer, () => MakeRunner.create(printer, new Prompter(), isInteractive()).run())));
+		return this.define(program).action((_options, command) => this.runSteps(command, MAKE_STEPS, (printer) => unlessCancelled(printer, () => MakeRunner.create(printer, new Prompter(), isInteractive()).run())));
 	}
 };
 
@@ -8988,14 +9381,20 @@ function assertProjectInstall(projectDir, cliDir) {
 async function main() {
 	installNodeConsole();
 	const program = addVerboseOption(new Command().name("seedcord").description("seedcord CLI").version(version));
-	program.hook("preAction", () => {
-		assertProjectInstall(process.cwd(), import.meta.dirname);
-	});
-	new DevCommand().register(program);
-	new BuildCommand().register(program);
-	new CodegenCommand().register(program);
-	new CommandsCommand().register(program);
-	new MakeCommand().register(program);
+	const commands = [
+		new AskCommand(),
+		new DevCommand(),
+		new BuildCommand(),
+		new CodegenCommand(),
+		new CommandsCommand(),
+		new MakeCommand()
+	];
+	for (const command of commands) {
+		const registered = command.register(program);
+		if (command.needsProject) registered.hook("preAction", () => {
+			assertProjectInstall(process.cwd(), import.meta.dirname);
+		});
+	}
 	try {
 		await program.parseAsync(process.argv);
 	} catch (error) {