@anythingai/cli 0.1.1 → 0.1.3

package/dist/js/bin.mjs

@@ -3069,7 +3069,7 @@ function errorCodeFromHttpStatus(status) {
 
 //#endregion
 //#region package.json
-var version = "0.1.1";
+var version = "0.1.3";
 
 //#endregion
 //#region generated/core/bodySerializer.gen.ts
@@ -4140,6 +4140,19 @@ const deleteV0ApiProjectsByProjectGroupIdAssetsByAssetId = (options) => (options
 	...options
 });
 /**
+* Delete a database
+*
+* Soft-deletes a user database and schedules permanent removal of the underlying infrastructure after a 30-day grace period.
+*/
+const deleteV0ApiDatabasesByDatabaseId = (options) => (options.client ?? client).delete({
+	security: [{
+		scheme: "basic",
+		type: "http"
+	}],
+	url: "/v0/api/databases/{databaseId}",
+	...options
+});
+/**
 * Get a single database
 *
 * Returns details for a specific user database.
@@ -4736,6 +4749,12 @@ var AnythingApiClient = class {
 			path: { databaseId }
 		}));
 	}
+	async deleteDatabase({ databaseId }) {
+		return this.toResult(await deleteV0ApiDatabasesByDatabaseId({
+			client: this.client,
+			path: { databaseId }
+		}));
+	}
 	async addDomain({ organizationId, domain, projectGroupId }) {
 		return this.toResult(await postV0ApiDomains({
 			client: this.client,
@@ -4790,12 +4809,17 @@ var AnythingApiClient = class {
 		});
 	}
 	async inviteMember({ organizationId, email, role }) {
+		const normalizedRole = role !== null ? toMemberRole(role) : null;
+		if (role !== null && normalizedRole === null) return err({
+			message: `Invalid role: ${role}. Expected one of owner, admin, editor, viewer.`,
+			status: 400
+		});
 		return this.toResult(await postV0ApiOrganizationsByOrganizationIdInvites({
 			client: this.client,
 			path: { organizationId },
 			body: {
 				email,
-				...role !== null ? { role } : {}
+				...normalizedRole !== null ? { role: normalizedRole } : {}
 			}
 		}));
 	}
@@ -4828,6 +4852,11 @@ var AnythingApiClient = class {
 function printJson(data) {
 	console.log(JSON.stringify(data, null, 2));
 }
+function buildLogsToLines(buildLogs) {
+	const lines = buildLogs.split("\n");
+	if (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
+	return lines;
+}
 function printSuccess(message) {
 	console.log(styleText("green", message));
 }
@@ -4876,22 +4905,23 @@ function extractErrorCode(details) {
 	const parsed = DetailsWithCodeSchema.safeParse(details);
 	return parsed.success ? parsed.data.code : null;
 }
-function outputError({ argv, command, error, hint, exitCode }) {
+function outputError({ argv, command, error, hint, exitCode, buildLogs, code: codeOverride }) {
 	const status = "status" in error ? error.status ?? null : null;
 	const details = "details" in error ? error.details : void 0;
 	const retryAfter = "retryAfter" in error && typeof error.retryAfter === "number" ? error.retryAfter : null;
 	const resolvedHint = hint ?? ("hint" in error && typeof error.hint === "string" ? error.hint : void 0);
 	process.exitCode = exitCode ?? exitCodeFromHttpStatus(status);
-	const code = extractErrorCode(details) ?? (status === null && exitCode !== void 0 ? errorCodeFromExitCode(exitCode) : errorCodeFromHttpStatus(status));
+	const code = codeOverride ?? extractErrorCode(details) ?? (status === null && exitCode !== void 0 ? errorCodeFromExitCode(exitCode) : errorCodeFromHttpStatus(status));
 	if (argv.json || argv.quiet) {
-		console.error(JSON.stringify({
+		console.log(JSON.stringify({
 			ok: false,
 			command,
 			error: {
 				code,
 				message: error.message,
 				...resolvedHint ? { hint: resolvedHint } : {},
-				...retryAfter !== null ? { retry_after_seconds: retryAfter } : {}
+				...retryAfter !== null ? { retry_after_seconds: retryAfter } : {},
+				...buildLogs ? { buildLogs: buildLogsToLines(buildLogs) } : {}
 			}
 		}, null, 2));
 		return;
@@ -4903,6 +4933,7 @@ function outputError({ argv, command, error, hint, exitCode }) {
 	});
 	if (retryAfter !== null) console.error(`  ${styleText("dim", `Retry after ${retryAfter}s`)}`);
 	if (resolvedHint) console.error(`  ${styleText("dim", resolvedHint)}`);
+	if (buildLogs) console.error(`\n${styleText("dim", "Build logs:")}\n${buildLogs}`);
 }
 function outputValidationError({ argv, command, message, hint }) {
 	outputError({
@@ -5110,15 +5141,15 @@ const list$2 = {
 			});
 			return;
 		}
-		if (argv.quiet) {
-			for (const asset of result.value.assets) console.log(asset.id);
-			return;
-		}
-		if (outputSuccess({
+		if (argv.json && outputSuccess({
 			argv,
 			command,
 			data: result.value
 		})) return;
+		if (argv.quiet) {
+			for (const asset of result.value.assets) console.log(asset.id);
+			return;
+		}
 		const { assets } = result.value;
 		if (assets.length === 0) {
 			console.log("No assets found.");
@@ -5214,7 +5245,7 @@ const assetsCommand = {
 
 //#endregion
 //#region src/commands/dev.ts
-const COMMAND$26 = "dev";
+const COMMAND$27 = "dev";
 const devCommand = {
 	command: "dev [state]",
 	describe: "Toggle local dev mode so commands target your local dev stack",
@@ -5234,7 +5265,7 @@ const devCommand = {
 		const apiUrl = resolveApiUrl({ apiUrl: argv.apiUrl });
 		if (outputSuccess({
 			argv,
-			command: COMMAND$26,
+			command: COMMAND$27,
 			data: {
 				devMode: enabled,
 				apiUrl
@@ -5774,7 +5805,7 @@ const authCommand = {
 
 //#endregion
 //#region src/commands/database-connect.ts
-const COMMAND$25 = "databases connect";
+const COMMAND$26 = "databases connect";
 function maskConnectionString(connectionString) {
 	return connectionString.replace(/(\/\/[^:/?#@]+:)[^@/?#]*(@)/, "$1****$2");
 }
@@ -5798,7 +5829,7 @@ const databaseConnectCommand = {
 		if (config.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$25,
+				command: COMMAND$26,
 				error: {
 					message: config.error.message,
 					status: null
@@ -5811,7 +5842,7 @@ const databaseConnectCommand = {
 		if (result.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$25,
+				command: COMMAND$26,
 				error: result.error
 			});
 			return;
@@ -5819,7 +5850,7 @@ const databaseConnectCommand = {
 		const connectionString = argv.mask ? maskConnectionString(result.value.connectionString) : result.value.connectionString;
 		if (outputSuccess({
 			argv,
-			command: COMMAND$25,
+			command: COMMAND$26,
 			data: {
 				...result.value,
 				connectionString
@@ -5876,7 +5907,7 @@ async function resolveOrgId({ flagOrg, config, nonInteractive }) {
 
 //#endregion
 //#region src/commands/database-create.ts
-const COMMAND$24 = "databases create";
+const COMMAND$25 = "databases create";
 const databaseCreateCommand = {
 	command: "create",
 	describe: "Create a new database for a project",
@@ -5895,7 +5926,7 @@ const databaseCreateCommand = {
 		if (!name) {
 			outputError({
 				argv,
-				command: COMMAND$24,
+				command: COMMAND$25,
 				error: {
 					message: "Database name is required. Pass --name <name>.",
 					status: null
@@ -5911,7 +5942,7 @@ const databaseCreateCommand = {
 		if (config.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$24,
+				command: COMMAND$25,
 				error: {
 					message: config.error.message,
 					status: null
@@ -5928,7 +5959,7 @@ const databaseCreateCommand = {
 		if (!orgResult.ok) {
 			outputError({
 				argv,
-				command: COMMAND$24,
+				command: COMMAND$25,
 				error: {
 					message: orgResult.error,
 					status: null
@@ -5940,7 +5971,7 @@ const databaseCreateCommand = {
 		if (argv["dry-run"]) {
 			outputDryRun({
 				argv,
-				command: COMMAND$24,
+				command: COMMAND$25,
 				plannedActions: [{
 					action: "create_database",
 					org: orgResult.orgId,
@@ -5958,14 +5989,14 @@ const databaseCreateCommand = {
 		if (result.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$24,
+				command: COMMAND$25,
 				error: result.error
 			});
 			return;
 		}
 		if (outputSuccess({
 			argv,
-			command: COMMAND$24,
+			command: COMMAND$25,
 			data: result.value.database,
 			primaryId: result.value.database.id
 		})) return;
@@ -5978,7 +6009,7 @@ const databaseCreateCommand = {
 
 //#endregion
 //#region src/commands/database-get.ts
-const COMMAND$23 = "databases get";
+const COMMAND$24 = "databases get";
 const databaseGetCommand = {
 	command: "get <databaseId>",
 	describe: "Inspect a database",
@@ -5995,7 +6026,7 @@ const databaseGetCommand = {
 		if (config.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$23,
+				command: COMMAND$24,
 				error: {
 					message: config.error.message,
 					status: null
@@ -6008,14 +6039,14 @@ const databaseGetCommand = {
 		if (result.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$23,
+				command: COMMAND$24,
 				error: result.error
 			});
 			return;
 		}
 		if (outputSuccess({
 			argv,
-			command: COMMAND$23,
+			command: COMMAND$24,
 			data: result.value.database,
 			primaryId: result.value.database.id
 		})) return;
@@ -6030,7 +6061,7 @@ const databaseGetCommand = {
 
 //#endregion
 //#region src/commands/database-query.ts
-const COMMAND$22 = "databases query";
+const COMMAND$23 = "databases query";
 const databaseQueryCommand = {
 	command: "query <databaseId> <sql>",
 	describe: "Run a read-only SQL query against a database",
@@ -6051,7 +6082,7 @@ const databaseQueryCommand = {
 		if (config.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$22,
+				command: COMMAND$23,
 				error: {
 					message: config.error.message,
 					status: null
@@ -6067,7 +6098,7 @@ const databaseQueryCommand = {
 		if (result.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$22,
+				command: COMMAND$23,
 				error: result.error,
 				hint: "Check the database ID and SQL syntax"
 			});
@@ -6075,7 +6106,7 @@ const databaseQueryCommand = {
 		}
 		if (outputSuccess({
 			argv,
-			command: COMMAND$22,
+			command: COMMAND$23,
 			data: result.value
 		})) return;
 		if (result.value.rows.length === 0) {
@@ -6093,7 +6124,7 @@ const databaseQueryCommand = {
 
 //#endregion
 //#region src/commands/database-reset.ts
-const COMMAND$21 = "databases reset";
+const COMMAND$22 = "databases reset";
 const databaseResetCommand = {
 	command: "reset <databaseId>",
 	describe: "Reset a database (destructive)",
@@ -6114,7 +6145,7 @@ const databaseResetCommand = {
 		if (config.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$21,
+				command: COMMAND$22,
 				error: {
 					message: config.error.message,
 					status: null
@@ -6126,7 +6157,7 @@ const databaseResetCommand = {
 		if (argv["dry-run"]) {
 			outputDryRun({
 				argv,
-				command: COMMAND$21,
+				command: COMMAND$22,
 				plannedActions: [{
 					action: "reset_database",
 					databaseId: argv.databaseId
@@ -6137,12 +6168,13 @@ const databaseResetCommand = {
 		if (!argv.yes) {
 			outputError({
 				argv,
-				command: COMMAND$21,
+				command: COMMAND$22,
 				error: {
 					message: "Database reset is destructive. Pass --yes to confirm.",
 					status: null
 				},
-				exitCode: 2
+				exitCode: 2,
+				code: "CONFIRMATION_REQUIRED"
 			});
 			return;
 		}
@@ -6150,14 +6182,14 @@ const databaseResetCommand = {
 		if (result.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$21,
+				command: COMMAND$22,
 				error: result.error
 			});
 			return;
 		}
 		if (outputSuccess({
 			argv,
-			command: COMMAND$21,
+			command: COMMAND$22,
 			data: {
 				reset: true,
 				databaseId: argv.databaseId
@@ -6167,6 +6199,84 @@ const databaseResetCommand = {
 	}
 };
 
+//#endregion
+//#region src/commands/database-delete.ts
+const COMMAND$21 = "databases delete";
+const databaseDeleteCommand = {
+	command: "delete <databaseId>",
+	aliases: ["remove"],
+	describe: "Delete a database (destructive)",
+	builder: (yargs) => yargs.positional("databaseId", {
+		type: "string",
+		demandOption: true,
+		describe: "The database ID"
+	}).option("yes", {
+		type: "boolean",
+		default: false,
+		describe: "Skip confirmation"
+	}).example("anything databases delete db_123 --yes", "Delete a database without confirmation"),
+	handler: async (argv) => {
+		const config = resolveConfig({
+			dev: argv.dev,
+			apiUrl: argv.apiUrl
+		});
+		if (config.isErr()) {
+			outputError({
+				argv,
+				command: COMMAND$21,
+				error: {
+					message: config.error.message,
+					status: null
+				},
+				exitCode: 4
+			});
+			return;
+		}
+		if (argv["dry-run"]) {
+			outputDryRun({
+				argv,
+				command: COMMAND$21,
+				plannedActions: [{
+					action: "delete_database",
+					databaseId: argv.databaseId
+				}]
+			});
+			return;
+		}
+		if (!argv.yes) {
+			outputError({
+				argv,
+				command: COMMAND$21,
+				error: {
+					message: "Database deletion is destructive. Pass --yes to confirm.",
+					status: null
+				},
+				exitCode: 2,
+				code: "CONFIRMATION_REQUIRED"
+			});
+			return;
+		}
+		const result = await new AnythingApiClient(config.value).deleteDatabase({ databaseId: argv.databaseId });
+		if (result.isErr()) {
+			outputError({
+				argv,
+				command: COMMAND$21,
+				error: result.error
+			});
+			return;
+		}
+		if (outputSuccess({
+			argv,
+			command: COMMAND$21,
+			data: {
+				deleted: true,
+				databaseId: argv.databaseId
+			}
+		})) return;
+		printSuccess(`Database ${argv.databaseId} deleted. It can be restored within 30 days.`);
+	}
+};
+
 //#endregion
 //#region src/commands/list-databases.ts
 const COMMAND$20 = "databases list";
@@ -6211,15 +6321,15 @@ const listDatabasesCommand = {
 			});
 			return;
 		}
-		if (argv.quiet) {
-			for (const db of result.value.databases) console.log(db.id);
-			return;
-		}
-		if (outputSuccess({
+		if (argv.json && outputSuccess({
 			argv,
 			command: COMMAND$20,
 			data: result.value
 		})) return;
+		if (argv.quiet) {
+			for (const db of result.value.databases) console.log(db.id);
+			return;
+		}
 		if (result.value.databases.length === 0) {
 			console.log("No databases found.");
 			return;
@@ -6254,7 +6364,7 @@ const databasesListCommand = {
 const databasesCommand = {
 	command: "databases",
 	describe: "Manage databases",
-	builder: (yargs) => yargs.command(databasesListCommand).command(databaseGetCommand).command(databaseCreateCommand).command(databaseQueryCommand).command(databaseConnectCommand).command(databaseResetCommand).demandCommand(1, "Specify a databases subcommand. Run `anything databases --help` for usage."),
+	builder: (yargs) => yargs.command(databasesListCommand).command(databaseGetCommand).command(databaseCreateCommand).command(databaseQueryCommand).command(databaseConnectCommand).command(databaseResetCommand).command(databaseDeleteCommand).demandCommand(1, "Specify a databases subcommand. Run `anything databases --help` for usage."),
 	handler: () => {}
 };
 
@@ -6302,15 +6412,15 @@ const deploymentsListCommand = {
 			});
 			return;
 		}
-		if (argv.quiet) {
-			for (const deployment of result.value.deployments) console.log(deployment.id);
-			return;
-		}
-		if (outputSuccess({
+		if (argv.json && outputSuccess({
 			argv,
 			command,
 			data: result.value
 		})) return;
+		if (argv.quiet) {
+			for (const deployment of result.value.deployments) console.log(deployment.id);
+			return;
+		}
 		if (result.value.deployments.length === 0) {
 			console.log("No deployments found.");
 			return;
@@ -6442,20 +6552,17 @@ const deploymentsLogsCommand = {
 	}
 };
 const deploymentsRollbackCommand = {
-	command: "rollback <projectId> [deploymentId]",
-	describe: "Rollback to a previous deployment",
+	command: "rollback <projectId>",
+	describe: "Roll a project back to its previous deployment",
 	builder: (yargs) => yargs.positional("projectId", {
 		type: "string",
 		demandOption: true,
-		describe: "The project ID"
-	}).positional("deploymentId", {
-		type: "string",
-		describe: "Specific deployment ID to rollback to (defaults to previous)"
+		describe: "The project ID to roll back"
 	}).option("yes", {
 		type: "boolean",
 		default: false,
 		describe: "Skip confirmation"
-	}).example("anything deployments rollback pg_123 --yes", "Rollback to previous deployment").example("anything deployments rollback pg_123 dep_456 --yes", "Rollback to specific deployment"),
+	}).example("anything deployments rollback pg_123 --yes", "Roll the project back to its previous deployment"),
 	handler: async (argv) => {
 		const command = "deployments rollback";
 		const config = resolveConfig({
@@ -6480,8 +6587,7 @@ const deploymentsRollbackCommand = {
 				command,
 				plannedActions: [{
 					action: "rollback_deployment",
-					projectId: argv.projectId,
-					...argv.deploymentId ? { deploymentId: argv.deploymentId } : {}
+					projectId: argv.projectId
 				}]
 			});
 			return;
@@ -6494,14 +6600,12 @@ const deploymentsRollbackCommand = {
 					message: "Rollback is destructive. Pass --yes to confirm.",
 					status: null
 				},
-				exitCode: 2
+				exitCode: 2,
+				code: "CONFIRMATION_REQUIRED"
 			});
 			return;
 		}
-		const result = await new AnythingApiClient(config.value).rollbackDeployment({
-			projectGroupId: argv.projectId,
-			deploymentId: argv.deploymentId ?? null
-		});
+		const result = await new AnythingApiClient(config.value).rollbackDeployment({ projectGroupId: argv.projectId });
 		if (result.isErr()) {
 			outputError({
 				argv,
@@ -6530,9 +6634,37 @@ const deploymentsCommand = {
 	handler: () => {}
 };
 
+//#endregion
+//#region src/domains-format.ts
+function toPublicDomain(domain) {
+	return {
+		id: domain.id,
+		domain: domain.domain,
+		verified: domain.vercelVerified,
+		verificationChallenges: domain.vercelVerification ?? null,
+		projectGroup: domain.projectGroup
+	};
+}
+
 //#endregion
 //#region src/commands/domain-add.ts
 const COMMAND$19 = "domains add";
+const HOSTNAME_PATTERN = /^(?=.{1,253}$)([a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}$/;
+const RESERVED_TLDS = new Set([
+	"invalid",
+	"example",
+	"test",
+	"localhost"
+]);
+function domainValidationError(domain) {
+	if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(domain)) return `Enter a bare hostname without a scheme (got "${domain}"). Example: app.example.com`;
+	if (domain.includes("/") || /\s/.test(domain)) return `Invalid domain "${domain}". Enter a bare hostname like app.example.com`;
+	if (!domain.includes(".")) return `Invalid domain "${domain}". A domain must include a dot, e.g. app.example.com`;
+	if (!HOSTNAME_PATTERN.test(domain)) return `Invalid domain "${domain}". Enter a valid hostname like app.example.com`;
+	const tld = domain.split(".").pop()?.toLowerCase() ?? "";
+	if (RESERVED_TLDS.has(tld)) return `Invalid domain "${domain}". ".${tld}" is a reserved TLD that cannot be used for a real domain. Use a registered domain like app.example.com`;
+	return null;
+}
 const domainAddCommand = {
 	command: "add <domain>",
 	describe: "Add a custom domain to a project",
@@ -6548,6 +6680,19 @@ const domainAddCommand = {
 		describe: "Project ID to link the domain to"
 	}).example("anything domains add app.example.com --project pg_123", "Add a custom domain to a project"),
 	handler: async (argv) => {
+		const validationMessage = domainValidationError(argv.domain);
+		if (validationMessage) {
+			outputError({
+				argv,
+				command: COMMAND$19,
+				error: {
+					message: validationMessage,
+					status: null
+				},
+				exitCode: 2
+			});
+			return;
+		}
 		const config = resolveConfig({
 			dev: argv.dev,
 			apiUrl: argv.apiUrl
@@ -6610,7 +6755,7 @@ const domainAddCommand = {
 		if (outputSuccess({
 			argv,
 			command: COMMAND$19,
-			data: result.value.domain,
+			data: toPublicDomain(result.value.domain),
 			primaryId: result.value.domain.domain
 		})) return;
 		printSuccess(`Domain added: ${result.value.domain.domain}`);
@@ -6670,7 +6815,8 @@ const domainRemoveCommand = {
 					message: "Domain removal is destructive. Pass --yes to confirm.",
 					status: null
 				},
-				exitCode: 2
+				exitCode: 2,
+				code: "CONFIRMATION_REQUIRED"
 			});
 			return;
 		}
@@ -6790,15 +6936,16 @@ const domainsListCommand = {
 			});
 			return;
 		}
+		const jsonData = { domains: result.value.domains.map(toPublicDomain) };
+		if (argv.json && outputSuccess({
+			argv,
+			command,
+			data: jsonData
+		})) return;
 		if (argv.quiet) {
 			for (const domain of result.value.domains) console.log(domain.domain);
 			return;
 		}
-		if (outputSuccess({
-			argv,
-			command,
-			data: result.value
-		})) return;
 		if (result.value.domains.length === 0) {
 			console.log("No domains found.");
 			return;
@@ -8128,6 +8275,7 @@ const linkCommand = {
 			orgId,
 			projectId: projectGroupId
 		}, null, 2) + "\n");
+		setStoredProjectGroupId(projResult.value.id);
 		if (outputSuccess({
 			argv,
 			command,
@@ -8163,7 +8311,9 @@ const unlinkCommand = {
 			});
 			return;
 		}
+		const linked = readLinkedProject();
 		rmSync(projectFile);
+		if (linked && getStoredProjectGroupId() === linked.projectId) clearStoredProjectGroupId();
 		try {
 			if (existsSync(dir) && readdirSync(dir).length === 0) rmSync(dir, { recursive: true });
 		} catch {}
@@ -8366,6 +8516,22 @@ const llmContextCommand = {
 	}
 };
 
+//#endregion
+//#region src/member-roles.ts
+function formatRole(role) {
+	if (role === null) return null;
+	switch (role.toUpperCase()) {
+		case "OWNER": return "Owner";
+		case "ADMIN": return "Admin";
+		case "EDITOR": return "Editor";
+		case "VIEWER": return "Viewer";
+		default: return role;
+	}
+}
+function normalizeRole(role) {
+	return role === null ? null : role.toLowerCase();
+}
+
 //#endregion
 //#region src/commands/members.ts
 const MEMBER_ROLE_CHOICES = [
@@ -8429,7 +8595,17 @@ const membersListCommand = {
 		if (outputSuccess({
 			argv,
 			command,
-			data: result.value
+			data: {
+				organization: {
+					...result.value.organization,
+					role: normalizeRole(result.value.organization.role)
+				},
+				members: result.value.collaborators.map((collaborator) => ({
+					...collaborator,
+					role: normalizeRole(collaborator.role)
+				})),
+				pendingInvites: result.value.pendingInvites
+			}
 		})) return;
 		if (result.value.collaborators.length > 0) printTable({
 			headers: [
@@ -8440,7 +8616,7 @@ const membersListCommand = {
 			rows: result.value.collaborators.map((c) => [
 				c.displayName,
 				c.email ?? "-",
-				c.role
+				formatRole(c.role) ?? c.role
 			])
 		});
 		if (result.value.pendingInvites.length > 0) {
@@ -8629,7 +8805,8 @@ const membersRemoveCommand = {
 					message: "Member removal is destructive. Pass --yes to confirm.",
 					status: null
 				},
-				exitCode: 2
+				exitCode: 2,
+				code: "CONFIRMATION_REQUIRED"
 			});
 			return;
 		}
@@ -8762,16 +8939,6 @@ const humanizeCredits = (credits) => {
 
 //#endregion
 //#region src/commands/org-members.ts
-function formatRole(role) {
-	if (role === null) return null;
-	switch (role.toUpperCase()) {
-		case "OWNER": return "Owner";
-		case "ADMIN": return "Admin";
-		case "EDITOR": return "Editor";
-		case "VIEWER": return "Viewer";
-		default: return role;
-	}
-}
 const orgMembersCommand = {
 	command: "members <organizationId>",
 	describe: "Inspect collaborators and pending invites for an organization",
@@ -8810,7 +8977,17 @@ const orgMembersCommand = {
 		if (outputSuccess({
 			argv,
 			command,
-			data: result.value
+			data: {
+				organization: {
+					...result.value.organization,
+					role: normalizeRole(result.value.organization.role)
+				},
+				members: result.value.collaborators.map((collaborator) => ({
+					...collaborator,
+					role: normalizeRole(collaborator.role)
+				})),
+				pendingInvites: result.value.pendingInvites
+			}
 		})) return;
 		console.log();
 		printLabel("Organization", result.value.organization.name);
@@ -8856,7 +9033,7 @@ const orgMembersCommand = {
 
 //#endregion
 //#region src/commands/orgs.ts
-async function loadOrganizations(argv) {
+async function loadOrganizations(argv, command) {
 	const config = resolveConfig({
 		dev: argv.dev,
 		apiUrl: argv.apiUrl
@@ -8864,7 +9041,7 @@ async function loadOrganizations(argv) {
 	if (config.isErr()) {
 		outputError({
 			argv,
-			command: "orgs",
+			command,
 			error: {
 				message: config.error.message,
 				status: null
@@ -8877,7 +9054,7 @@ async function loadOrganizations(argv) {
 	if (result.isErr()) {
 		outputError({
 			argv,
-			command: "orgs",
+			command,
 			error: result.error
 		});
 		return null;
@@ -8897,7 +9074,7 @@ const getCommand = {
 	}).example("anything orgs get org_123", "Inspect one organization in more detail").example("anything orgs get org_123 --json", "Return one organization as JSON"),
 	handler: async (argv) => {
 		const command = "orgs get";
-		const organizations = await loadOrganizations(argv);
+		const organizations = await loadOrganizations(argv, command);
 		if (!organizations) return;
 		const organization = organizations.find((org) => org.id === argv.organizationId);
 		if (!organization) {
@@ -8932,14 +9109,10 @@ const listOrgs = {
 	builder: (yargs) => yargs.example("anything orgs list", "List orgs available to the current user"),
 	handler: async (argv) => {
 		const command = "orgs list";
-		const organizations = await loadOrganizations(argv);
+		const organizations = await loadOrganizations(argv, command);
 		if (!organizations) return;
 		const activeOrgId = getStoredOrgId();
-		if (argv.quiet) {
-			for (const org of organizations) console.log(org.id);
-			return;
-		}
-		if (outputSuccess({
+		if (argv.json && outputSuccess({
 			argv,
 			command,
 			data: {
@@ -8947,6 +9120,10 @@ const listOrgs = {
 				activeOrgId: activeOrgId ?? null
 			}
 		})) return;
+		if (argv.quiet) {
+			for (const org of organizations) console.log(org.id);
+			return;
+		}
 		if (organizations.length === 0) {
 			console.log("No organizations found.");
 			return;
@@ -8975,7 +9152,7 @@ const setOrg = {
 	}).example("anything orgs set org_abc123", "Set the active organization"),
 	handler: async (argv) => {
 		const command = "orgs set";
-		const organizations = await loadOrganizations(argv);
+		const organizations = await loadOrganizations(argv, command);
 		if (!organizations) return;
 		const org = organizations.find((o) => o.id === argv["org-id"]);
 		if (!org) {
@@ -9350,10 +9527,6 @@ const createCommand = {
 			message: "Project created"
 		});
 		if (!argv.wait) {
-			if (argv.quiet) {
-				console.log(result.value.projectGroupId);
-				return;
-			}
 			if (argv.json) {
 				printNdjson({
 					type: "result",
@@ -9362,6 +9535,10 @@ const createCommand = {
 				});
 				return;
 			}
+			if (argv.quiet) {
+				console.log(result.value.projectGroupId);
+				return;
+			}
 			printStreamMarker("done", `project ${result.value.projectGroupId} created`);
 			printSuccess("App created! Generation enqueued.");
 			printLabel("Project Group ID", result.value.projectGroupId);
@@ -9380,27 +9557,11 @@ const createCommand = {
 			projectGroupId: result.value.projectGroupId,
 			emit
 		});
-		if (argv.quiet) {
-			console.log(result.value.projectGroupId);
-			if (succeeded === false) process.exitCode = 1;
-			return;
-		}
-		if (succeeded === false) {
-			if (!argv.json) {
-				outputError({
-					argv,
-					command: COMMAND$16,
-					error: {
-						message: "Generation failed.",
-						status: null
-					}
-				});
-				printLabel("Project Group ID", result.value.projectGroupId);
-			}
-			process.exitCode = 1;
-			return;
-		}
 		if (argv.json) {
+			if (succeeded === false) {
+				process.exitCode = 1;
+				return;
+			}
 			const { projectGroupId: projectId, ...rest } = result.value;
 			printNdjson({
 				type: "result",
@@ -9410,12 +9571,30 @@ const createCommand = {
 					...rest
 				}
 			});
-		} else {
-			printStreamMarker("done", `project ${result.value.projectGroupId} ready`);
-			printSuccess("App created! Generation complete.");
-			printLabel("Project ID", result.value.projectGroupId);
-			printLabel("Revision ID", result.value.revisionId);
+			return;
 		}
+		if (argv.quiet) {
+			console.log(result.value.projectGroupId);
+			if (succeeded === false) process.exitCode = 1;
+			return;
+		}
+		if (succeeded === false) {
+			outputError({
+				argv,
+				command: COMMAND$16,
+				error: {
+					message: "Generation failed.",
+					status: null
+				}
+			});
+			printLabel("Project Group ID", result.value.projectGroupId);
+			process.exitCode = 1;
+			return;
+		}
+		printStreamMarker("done", `project ${result.value.projectGroupId} ready`);
+		printSuccess("App created! Generation complete.");
+		printLabel("Project ID", result.value.projectGroupId);
+		printLabel("Revision ID", result.value.revisionId);
 	}
 };
 
@@ -9459,14 +9638,16 @@ async function waitForDeployment({ client, deploymentId, emit }) {
 function getDeploymentError({ result, statusCommand }) {
 	if (result.outcome === "timeout") return {
 		message: `Deployment timed out. Check status with: ${statusCommand}`,
-		exitCode: 6
+		exitCode: 6,
+		buildLogs: null
 	};
 	if (result.deployment.status === "FAILED") {
 		const reason = result.deployment.failureReason ?? null;
 		const logs = result.deployment.buildLogs ?? null;
 		return {
-			message: reason ? logs ? `${reason}\n\n${logs}` : reason : logs ?? "Deployment failed (no logs available).",
-			exitCode: 1
+			message: reason ?? (logs ? "Deployment failed. See build logs for details." : "Deployment failed (no logs available)."),
+			exitCode: 1,
+			buildLogs: logs
 		};
 	}
 	return null;
@@ -9531,7 +9712,8 @@ const publishStatusCommand = {
 					status: null
 				},
 				hint: `Inspect the full build logs with: anything deployments logs ${argv.deploymentId}`,
-				exitCode: failure?.exitCode ?? 1
+				exitCode: failure?.exitCode ?? 1,
+				buildLogs: failure?.buildLogs ?? void 0
 			});
 			return;
 		}
@@ -9679,7 +9861,8 @@ const publishCommand = {
 					message: deployError.message,
 					status: null
 				},
-				exitCode: deployError.exitCode
+				exitCode: deployError.exitCode,
+				buildLogs: deployError.buildLogs ?? void 0
 			});
 			return;
 		}
@@ -9810,15 +9993,15 @@ const list$1 = {
 			});
 			return;
 		}
-		if (argv.quiet) {
-			for (const file of result.value.files) console.log(file.path);
-			return;
-		}
-		if (outputSuccess({
+		if (argv.json && outputSuccess({
 			argv,
 			command,
 			data: result.value
 		})) return;
+		if (argv.quiet) {
+			for (const file of result.value.files) console.log(file.path);
+			return;
+		}
 		if (result.value.files.length === 0) {
 			console.log("No files found.");
 			return;
@@ -9983,10 +10166,6 @@ const generateCommand = {
 			return;
 		}
 		if (!argv.wait) {
-			if (argv.quiet) {
-				console.log(result.value.revisionId);
-				return;
-			}
 			if (argv.json) {
 				printNdjson({
 					type: "result",
@@ -9995,6 +10174,10 @@ const generateCommand = {
 				});
 				return;
 			}
+			if (argv.quiet) {
+				console.log(result.value.revisionId);
+				return;
+			}
 			printStreamMarker("done", `revision ${result.value.revisionId} enqueued`);
 			printSuccess("Generation enqueued.");
 			printLabel("Revision ID", result.value.revisionId);
@@ -10007,32 +10190,31 @@ const generateCommand = {
 			status: "running",
 			message: "Generation in progress..."
 		});
-		const succeeded = await watchGeneration({
+		if (await watchGeneration({
 			config: config.value,
 			client,
 			projectGroupId: argv.projectId,
 			emit
-		});
-		if (argv.quiet) {
-			console.log(result.value.revisionId);
-			if (succeeded === false) process.exitCode = 1;
+		}) === false) {
+			process.exitCode = 1;
 			return;
 		}
-		if (succeeded === false) {
-			process.exitCode = 1;
+		if (argv.json) {
+			printNdjson({
+				type: "result",
+				ok: true,
+				data: result.value
+			});
 			return;
 		}
-		if (argv.json) printNdjson({
-			type: "result",
-			ok: true,
-			data: result.value
-		});
-		else {
-			printStreamMarker("done", `revision ${result.value.revisionId} ready`);
-			printSuccess("Generation complete.");
-			printLabel("Revision ID", result.value.revisionId);
-			printLabel("Thread ID", result.value.threadId);
+		if (argv.quiet) {
+			console.log(result.value.revisionId);
+			return;
 		}
+		printStreamMarker("done", `revision ${result.value.revisionId} ready`);
+		printSuccess("Generation complete.");
+		printLabel("Revision ID", result.value.revisionId);
+		printLabel("Thread ID", result.value.threadId);
 	}
 };
 
@@ -10253,15 +10435,15 @@ const listProjectsCommand = {
 			});
 			return;
 		}
-		if (argv.quiet) {
-			for (const project of result.value.projects) console.log(project.id);
-			return;
-		}
-		if (outputSuccess({
+		if (argv.json && outputSuccess({
 			argv,
 			command: COMMAND$11,
 			data: result.value
 		})) return;
+		if (argv.quiet) {
+			for (const project of result.value.projects) console.log(project.id);
+			return;
+		}
 		if (result.value.projects.length === 0) {
 			console.log("No projects found.");
 			return;
@@ -10349,9 +10531,9 @@ const logsCommand = {
 		describe: "Show logs since a duration ago (e.g. 1h, 30m, 2d). Only applies to initial fetch."
 	}).option("follow", {
 		type: "boolean",
-		alias: "f",
+		alias: ["f", "tail"],
 		default: false,
-		describe: "Tail logs in real-time (stream)"
+		describe: "Tail logs in real-time (stream). Alias: --tail"
 	}).option("interval", {
 		type: "number",
 		default: DEFAULT_POLL_INTERVAL_MS$1,
@@ -10399,7 +10581,7 @@ const logsCommand = {
 				data: { logs }
 			})) return;
 			if (logs.length === 0) {
-				console.log("No logs found.");
+				console.log("No development logs found. This command reads dev-server logs, not production deployment logs (use `anything deployments logs <deploymentId>` for those).");
 				return;
 			}
 			for (const log of logs) formatLog(log);
@@ -10776,6 +10958,7 @@ const secretEnvironmentChoices = [
 	"preview",
 	"production"
 ];
+const DEFAULT_SECRET_ENVIRONMENT = "DEVELOPMENT";
 const add = {
 	command: "add <projectId>",
 	describe: "Add a secret to an app",
@@ -10792,8 +10975,13 @@ const add = {
 		describe: "Secret value. If omitted, reads stdin when piped."
 	}).option("env", {
 		type: "string",
+		coerce: (value) => value.toLowerCase(),
 		choices: secretEnvironmentChoices,
 		describe: "Target environment for the secret"
+	}).option("force", {
+		type: "boolean",
+		default: false,
+		describe: "Allow adding a secret whose name already exists in the target environment (creates a suffixed sibling)"
 	}).example("anything projects secrets add <id> --name KEY --value \"secret\"", "Add a secret from an inline value").example("cat secret.txt | anything projects secrets add <id> --name KEY", "Read a secret value from stdin"),
 	handler: async (argv) => {
 		const command = "projects secrets add";
@@ -10843,11 +11031,30 @@ const add = {
 			});
 			return;
 		}
-		const result = await new AnythingApiClient(config.value).addSecret({
+		const client = new AnythingApiClient(config.value);
+		const targetEnvironment = argv.env ? argv.env.toUpperCase() : DEFAULT_SECRET_ENVIRONMENT;
+		if (!argv.force) {
+			const existing = await client.listSecrets({ projectGroupId: argv.projectId });
+			if (existing.isOk()) {
+				if (existing.value.secrets.find((secret) => secret.displayName === argv.name && secret.environment === targetEnvironment)) {
+					outputError({
+						argv,
+						command,
+						error: {
+							message: `A secret named "${argv.name}" already exists in ${targetEnvironment}.`,
+							status: 409
+						},
+						hint: "Remove the existing secret first, or pass --force to create a suffixed sibling."
+					});
+					return;
+				}
+			}
+		}
+		const result = await client.addSecret({
 			projectGroupId: argv.projectId,
 			displayName: argv.name,
 			value: valueResult.value,
-			environment: argv.env ? argv.env.toUpperCase() : null
+			environment: targetEnvironment
 		});
 		if (result.isErr()) {
 			outputError({
@@ -10908,7 +11115,8 @@ const remove = {
 					message: "Removing a secret is destructive. Pass --yes to confirm.",
 					status: null
 				},
-				exitCode: 2
+				exitCode: 2,
+				code: "CONFIRMATION_REQUIRED"
 			});
 			return;
 		}
@@ -10984,15 +11192,15 @@ const list = {
 			});
 			return;
 		}
-		if (argv.quiet) {
-			for (const secret of result.value.secrets) console.log(secret.id);
-			return;
-		}
-		if (outputSuccess({
+		if (argv.json && outputSuccess({
 			argv,
 			command,
 			data: result.value
 		})) return;
+		if (argv.quiet) {
+			for (const secret of result.value.secrets) console.log(secret.id);
+			return;
+		}
 		if (result.value.secrets.length === 0) {
 			console.log("No secrets found.");
 			return;
@@ -11172,6 +11380,7 @@ const set = {
 		array: true,
 		describe: "Provider secret in ENV_KEY=VALUE format. Repeat for multiple secrets."
 	}).option("env", {
+		coerce: (value) => value.toLowerCase(),
 		choices: authEnvironmentChoices,
 		default: "production",
 		describe: "Environment for secrets passed via --secret"
@@ -11376,7 +11585,7 @@ const unpublishCommand = {
 const COMMAND$5 = "projects delete";
 const deleteProjectCommand = {
 	command: "delete <projectId>",
-	describe: "Delete a project permanently (gated behind the project-delete-enabled flag; returns 404 when disabled)",
+	describe: "Delete a project permanently (gated behind the project-delete-enabled flag; returns 403 when disabled)",
 	builder: (yargs) => yargs.positional("projectId", {
 		type: "string",
 		demandOption: true,
@@ -11406,7 +11615,8 @@ const deleteProjectCommand = {
 					message: "Project deletion is destructive and cannot be undone. Pass --yes to confirm.",
 					status: null
 				},
-				exitCode: 2
+				exitCode: 2,
+				code: "CONFIRMATION_REQUIRED"
 			});
 			return;
 		}
@@ -11429,12 +11639,10 @@ const deleteProjectCommand = {
 		const startTime = performance.now();
 		const result = await new AnythingApiClient(config.value).deleteProject({ projectGroupId: argv.projectId });
 		if (result.isErr()) {
-			const hint = result.error.status === 404 ? "If the project ID is correct, project deletion may not be enabled for your account." : void 0;
 			outputError({
 				argv,
 				command: COMMAND$5,
-				error: result.error,
-				hint
+				error: result.error
 			});
 			return;
 		}
@@ -11924,7 +12132,8 @@ const shipCommand = {
 						message: deployError.message,
 						status: null
 					},
-					exitCode: deployError.exitCode
+					exitCode: deployError.exitCode,
+					buildLogs: deployError.buildLogs ?? void 0
 				});
 				return;
 			}
@@ -11936,27 +12145,28 @@ const shipCommand = {
 			message: "Published"
 		});
 		const url = publishResult.value.slug ? `https://${publishResult.value.slug}.created.app` : null;
+		if (argv.json) {
+			printNdjson({
+				type: "result",
+				ok: true,
+				data: {
+					projectId: projectGroupId,
+					published: true,
+					deploymentId,
+					slug: publishResult.value.slug,
+					url
+				}
+			});
+			return;
+		}
 		if (argv.quiet) {
 			console.log(url ?? projectGroupId);
 			return;
 		}
-		if (argv.json) printNdjson({
-			type: "result",
-			ok: true,
-			data: {
-				projectId: projectGroupId,
-				published: true,
-				deploymentId,
-				slug: publishResult.value.slug,
-				url
-			}
-		});
-		else {
-			printStreamMarker("done", url ?? projectGroupId);
-			printSuccess("Shipped!");
-			printLabel("Project ID", projectGroupId);
-			if (url) printLabel("URL", url);
-		}
+		printStreamMarker("done", url ?? projectGroupId);
+		printSuccess("Shipped!");
+		printLabel("Project ID", projectGroupId);
+		if (url) printLabel("URL", url);
 	}
 };
 
@@ -12219,9 +12429,11 @@ const switchCommand = {
 //#endregion
 //#region src/update-check.ts
 const PACKAGE_NAME = "@anythingai/cli";
-const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
-const CHECK_INTERVAL_MS = 1440 * 60 * 1e3;
-const NOTICE_FETCH_TIMEOUT_MS = 1500;
+const REGISTRY_BASE_URL = `https://registry.npmjs.org/${PACKAGE_NAME}`;
+const REGISTRY_URL = `${REGISTRY_BASE_URL}/latest`;
+const INTERNAL_UPDATE_CHECK_ARG = "__update-check";
+const CHECK_INTERVAL_MS = 10800 * 1e3;
+const REFRESH_FETCH_TIMEOUT_MS = 1e4;
 const latestManifestSchema = z.object({ version: z.string() });
 function isNewerVersion(candidate, current) {
 	const core = (v) => (v.split("-")[0] ?? "").split(".").map((part) => Number.parseInt(part, 10));
@@ -12248,38 +12460,83 @@ async function fetchLatestVersion({ timeoutMs }) {
 		return null;
 	}
 }
+async function lookupVersion({ version, timeoutMs }) {
+	try {
+		const response = await fetch(`${REGISTRY_BASE_URL}/${encodeURIComponent(version)}`, {
+			signal: AbortSignal.timeout(timeoutMs),
+			headers: { accept: "application/json" }
+		});
+		if (response.status === 404) return { status: "not-found" };
+		if (!response.ok) return { status: "unreachable" };
+		return latestManifestSchema.safeParse(await response.json()).success ? { status: "exists" } : { status: "not-found" };
+	} catch {
+		return { status: "unreachable" };
+	}
+}
 function printUpdateNotice({ current, latest }) {
 	console.error([
 		"",
 		styleText("yellow", `Update available for ${PACKAGE_NAME}: ${current} → ${latest}`),
-		styleText("dim", `Run \`npm install -g ${PACKAGE_NAME}@latest\` to update.`),
+		styleText("dim", "Run `anything update` to update."),
 		""
 	].join("\n"));
 }
-async function notifyIfUpdateAvailable(now) {
+function spawnBackgroundRefresh() {
+	const entry = process.argv[1];
+	if (!entry) return;
+	try {
+		spawn(process.execPath, [entry, INTERNAL_UPDATE_CHECK_ARG], {
+			detached: true,
+			stdio: "ignore",
+			windowsHide: true,
+			env: backgroundRefreshEnv()
+		}).unref();
+	} catch {}
+}
+function backgroundRefreshEnv() {
+	const allowed = [
+		"PATH",
+		"HOME",
+		"XDG_CONFIG_HOME",
+		"APPDATA",
+		"LOCALAPPDATA",
+		"SystemRoot"
+	];
+	const env = {};
+	for (const key of allowed) {
+		const value = process.env[key];
+		if (value !== void 0) env[key] = value;
+	}
+	return env;
+}
+async function refreshUpdateCheckCache(now) {
+	recordUpdateCheck({
+		checkedAt: now,
+		latestVersion: await fetchLatestVersion({ timeoutMs: REFRESH_FETCH_TIMEOUT_MS })
+	});
+}
+function notifyIfUpdateAvailable(now) {
 	const state = getUpdateCheckState();
-	let latest = state.latestKnownVersion;
-	if (state.checkedAt === null || now - state.checkedAt >= CHECK_INTERVAL_MS) {
-		const fetched = await fetchLatestVersion({ timeoutMs: NOTICE_FETCH_TIMEOUT_MS });
-		recordUpdateCheck({
-			checkedAt: now,
-			latestVersion: fetched
-		});
-		if (fetched) latest = fetched;
-	}
-	if (!latest || !isNewerVersion(latest, CLI_VERSION)) return;
-	if (state.notifiedVersion === latest) return;
-	printUpdateNotice({
-		current: CLI_VERSION,
-		latest
+	const latest = state.latestKnownVersion;
+	if (latest && isNewerVersion(latest, CLI_VERSION) && state.notifiedVersion !== latest) {
+		printUpdateNotice({
+			current: CLI_VERSION,
+			latest
+		});
+		recordUpdateNotified(latest);
+	}
+	if (!(state.checkedAt === null || now - state.checkedAt >= CHECK_INTERVAL_MS)) return;
+	recordUpdateCheck({
+		checkedAt: now,
+		latestVersion: null
 	});
-	recordUpdateNotified(latest);
+	spawnBackgroundRefresh();
 }
-async function maybeNotifyUpdate(argv, now) {
+function maybeNotifyUpdate(argv, now) {
 	if (argv.json || argv.quiet) return;
 	if (isNonInteractive(argv)) return;
 	if (!process.stderr.isTTY) return;
-	await notifyIfUpdateAvailable(now);
+	notifyIfUpdateAvailable(now);
 }
 
 //#endregion
@@ -12367,13 +12624,16 @@ function runInstall({ command, args, capture }) {
 	});
 }
 const updateCommand = {
-	command: "update",
-	describe: "Update the CLI to the latest published version",
-	builder: (yargs) => yargs.option("check", {
+	command: "update [version]",
+	describe: "Update the CLI to the latest (or a specific) published version",
+	builder: (yargs) => yargs.version(false).positional("version", {
+		type: "string",
+		describe: "A specific published version to install (defaults to the latest)"
+	}).option("check", {
 		type: "boolean",
 		default: false,
 		describe: "Report whether an update is available without installing it"
-	}).example("anything update", "Update to the latest version if one exists").example("anything update --check", "Check for a newer version without installing").example("anything update --dry-run", "Print the install command without running it"),
+	}).example("anything update", "Update to the latest version if one exists").example("anything update 0.0.3", "Install a specific published version (may be a downgrade)").example("anything update --check", "Check for a newer version without installing").example("anything update --dry-run", "Print the install command without running it"),
 	handler: async (argv) => {
 		const latest = await fetchLatestVersion({ timeoutMs: FETCH_TIMEOUT_MS });
 		if (latest === null) {
@@ -12389,25 +12649,65 @@ const updateCommand = {
 			});
 			return;
 		}
+		const requestedVersion = argv.version ?? null;
+		if (requestedVersion !== null) {
+			const lookup = await lookupVersion({
+				version: requestedVersion,
+				timeoutMs: FETCH_TIMEOUT_MS
+			});
+			switch (lookup.status) {
+				case "exists": break;
+				case "not-found":
+					outputError({
+						argv,
+						command: COMMAND$1,
+						error: {
+							message: `Version ${requestedVersion} of ${PACKAGE_NAME} does not exist. The latest version is ${latest}.`,
+							status: null
+						},
+						hint: `Run \`anything update\` to install the latest version (${latest}).`
+					});
+					return;
+				case "unreachable":
+					outputError({
+						argv,
+						command: COMMAND$1,
+						error: {
+							message: `Could not reach the npm registry to verify version ${requestedVersion}.`,
+							status: null
+						},
+						hint: `Check available versions with \`npm view ${PACKAGE_NAME} versions\`.`,
+						exitCode: EXIT_TIMEOUT
+					});
+					return;
+				default: {
+					const exhaustive = lookup.status;
+					throw new Error(`Unhandled lookup status: ${String(exhaustive)}`);
+				}
+			}
+		}
+		const targetVersion = requestedVersion ?? latest;
 		const packageManager = detectPackageManager(resolveSelfPath());
 		const { command, args } = buildInstallCommand({
 			packageManager,
-			target: `${PACKAGE_NAME}@${latest}`
+			target: `${PACKAGE_NAME}@${targetVersion}`
 		});
 		const installCommand = [command, ...args].join(" ");
-		if (!isNewerVersion(latest, CLI_VERSION)) {
+		const updateAvailable = isNewerVersion(latest, CLI_VERSION);
+		if (requestedVersion === null ? !updateAvailable : targetVersion === CLI_VERSION) {
 			if (outputSuccess({
 				argv,
 				command: COMMAND$1,
 				data: {
 					currentVersion: CLI_VERSION,
 					latestVersion: latest,
-					updateAvailable: false,
+					targetVersion,
+					updateAvailable,
 					updated: false
 				},
 				primaryId: CLI_VERSION
 			})) return;
-			printSuccess(`Already on the latest version (${CLI_VERSION}).`);
+			printSuccess(requestedVersion === null ? `Already on the latest version (${CLI_VERSION}).` : `Already on version ${CLI_VERSION}.`);
 			return;
 		}
 		if (argv.check) {
@@ -12417,18 +12717,20 @@ const updateCommand = {
 				data: {
 					currentVersion: CLI_VERSION,
 					latestVersion: latest,
-					updateAvailable: true,
+					targetVersion,
+					updateAvailable,
 					updated: false,
 					packageManager,
 					installCommand
 				},
-				primaryId: latest
+				primaryId: targetVersion
 			})) return;
 			console.log();
 			printLabel("Current", CLI_VERSION);
 			printLabel("Latest", latest);
+			if (requestedVersion !== null) printLabel("Target", targetVersion);
 			console.log();
-			console.log(`Run \`anything update\` or \`${installCommand}\` to update.`);
+			console.log(requestedVersion === null ? `Run \`anything update\` or \`${installCommand}\` to update.` : `Run \`anything update ${targetVersion}\` or \`${installCommand}\` to install it.`);
 			return;
 		}
 		if (argv["dry-run"]) {
@@ -12438,14 +12740,14 @@ const updateCommand = {
 				plannedActions: [{
 					action: "update",
 					from: CLI_VERSION,
-					to: latest,
+					to: targetVersion,
 					packageManager,
 					command: installCommand
 				}]
 			});
 			return;
 		}
-		if (!argv.json && !argv.quiet) console.log(`Updating ${PACKAGE_NAME} ${CLI_VERSION} → ${latest} via ${packageManager}...`);
+		if (!argv.json && !argv.quiet) console.log(`Updating ${PACKAGE_NAME} ${CLI_VERSION} → ${targetVersion} via ${packageManager}...`);
 		let result;
 		try {
 			result = await runInstall({
@@ -12484,13 +12786,14 @@ const updateCommand = {
 			data: {
 				previousVersion: CLI_VERSION,
 				latestVersion: latest,
+				targetVersion,
 				updated: true,
 				packageManager,
 				installCommand
 			},
-			primaryId: latest
+			primaryId: targetVersion
 		})) return;
-		printSuccess(`Updated to ${latest}. Run \`anything --version\` to confirm.`);
+		printSuccess(`Updated to ${targetVersion}. Run \`anything --version\` to confirm.`);
 	}
 };
 
@@ -12779,6 +13082,33 @@ const watchCommand = {
 
 //#endregion
 //#region src/cli.ts
+const REGISTERED_COMMAND_PATHS = (() => {
+	const paths = /* @__PURE__ */ new Set();
+	for (const { name } of commandTree) {
+		const words = name.split(" ");
+		for (let i = 1; i <= words.length; i++) paths.add(words.slice(0, i).join(" "));
+	}
+	paths.add("dev");
+	paths.add("update");
+	return paths;
+})();
+var HandledCliError = class extends Error {};
+function commandPathFromArgv(argv) {
+	const words = [];
+	for (const token of argv) {
+		if (token.startsWith("-")) break;
+		words.push(token);
+	}
+	const [firstWord] = words;
+	if (firstWord === void 0) return null;
+	let matched = "";
+	for (let i = 0; i < words.length; i++) {
+		const candidate = words.slice(0, i + 1).join(" ");
+		if (!REGISTERED_COMMAND_PATHS.has(candidate)) break;
+		matched = candidate;
+	}
+	return matched === "" ? firstWord : matched;
+}
 function createCli(argv) {
 	const cli = yargs(argv).scriptName("anything").usage("$0 <command> [options]").example("anything auth login", "Log in via browser").example("anything ship --prompt \"Build a todo app\"", "Create + publish in one shot").example("anything domains list org_123", "List domains for one organization").example("anything orgs", "List your organizations").example("anything orgs get <org-id>", "Inspect one organization").example("anything orgs set <org-id>", "Set the active organization").example("anything orgs members <org-id>", "Inspect collaborators and pending invites").example("anything projects create --prompt todo-app", "Create a new app").example("anything projects generate <project-id> --prompt add-auth", "Iterate on an existing app").example("anything projects publish <project-id> --slug my-app", "Publish an app").example("anything projects get <project-id> --json", "Inspect an app in JSON").example("anything projects rename <project-id> --name \"My App\"", "Rename a project").example("anything databases list --org <org-id>", "List databases for an organization").example("anything deployments list <project-id>", "List deployments for a project").example("anything members invite user@example.com --org org_123", "Invite a member").example("anything update", "Update the CLI to the latest version").example("anything status", "Show current context").example("anything switch", "Interactive org/project picker").example("anything introspect", "Output command tree as JSON").option("json", {
 		type: "boolean",
@@ -12809,9 +13139,9 @@ function createCli(argv) {
 		type: "string",
 		description: "Override the API base URL",
 		global: true
-	}).middleware(async (args) => {
+	}).middleware((args) => {
 		setDevFlagOverride(args.dev === true);
-		await maybeNotifyUpdate({
+		maybeNotifyUpdate({
 			json: args.json === true,
 			quiet: args.quiet === true,
 			"non-interactive": args["non-interactive"] === true,
@@ -12828,13 +13158,14 @@ function createCli(argv) {
 		}
 		if (isJson) console.error(JSON.stringify({
 			ok: false,
-			command: null,
+			command: commandPathFromArgv(argv),
 			error: {
 				code: "INVALID_ARGUMENTS",
 				message
 			}
 		}, null, 2));
 		process.exitCode = EXIT_INVALID_ARGS;
+		throw new HandledCliError(message);
 	}).exitProcess(false);
 	if (isDevEnvironment()) cli.command(devCommand);
 	return cli;
@@ -12842,7 +13173,19 @@ function createCli(argv) {
 
 //#endregion
 //#region src/bin.ts
-createCli(hideBin(process.argv)).parse();
+function isHandled(err) {
+	return err instanceof HandledCliError;
+}
+if (process.argv[2] === INTERNAL_UPDATE_CHECK_ARG) refreshUpdateCheckCache(Date.now()).catch(() => {}).finally(() => process.exit(0));
+else try {
+	const result = createCli(hideBin(process.argv)).parse();
+	if (result instanceof Promise) result.catch((err) => {
+		if (isHandled(err)) return;
+		throw err;
+	});
+} catch (err) {
+	if (!isHandled(err)) throw err;
+}
 
 //#endregion
 export {  };