@anythingai/cli 0.1.0 → 0.1.2

package/dist/js/bin.mjs

@@ -3026,9 +3026,11 @@ const EXIT_CONFLICT = 5;
 const EXIT_TIMEOUT = 6;
 const EXIT_SERVER_ERROR = 7;
 const EXIT_RATE_LIMITED = 8;
+const EXIT_CREDIT_LIMIT = 9;
 function exitCodeFromHttpStatus(status) {
 	if (status === null) return EXIT_ERROR;
 	if (status === 401 || status === 403) return EXIT_AUTH_FAILURE;
+	if (status === 402) return EXIT_CREDIT_LIMIT;
 	if (status === 404) return EXIT_NOT_FOUND;
 	if (status === 409) return EXIT_CONFLICT;
 	if (status === 408 || status === 504) return EXIT_TIMEOUT;
@@ -3042,6 +3044,7 @@ function errorCodeFromExitCode(exitCode) {
 		case EXIT_INVALID_ARGS: return "INVALID_ARGUMENTS";
 		case EXIT_NOT_FOUND: return "NOT_FOUND";
 		case EXIT_AUTH_FAILURE: return "AUTH_FAILURE";
+		case EXIT_CREDIT_LIMIT: return "CREDIT_LIMIT_REACHED";
 		case EXIT_CONFLICT: return "CONFLICT";
 		case EXIT_TIMEOUT: return "TIMEOUT";
 		case EXIT_SERVER_ERROR: return "SERVER_ERROR";
@@ -3052,6 +3055,7 @@ function errorCodeFromExitCode(exitCode) {
 function errorCodeFromHttpStatus(status) {
 	if (status === null) return "NETWORK_ERROR";
 	if (status === 401) return "AUTH_FAILURE";
+	if (status === 402) return "CREDIT_LIMIT_REACHED";
 	if (status === 403) return "FORBIDDEN";
 	if (status === 404) return "NOT_FOUND";
 	if (status === 409) return "CONFLICT";
@@ -3065,7 +3069,7 @@ function errorCodeFromHttpStatus(status) {
 
 //#endregion
 //#region package.json
-var version = "0.1.0";
+var version = "0.1.2";
 
 //#endregion
 //#region generated/core/bodySerializer.gen.ts
@@ -4136,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.
@@ -4423,10 +4440,12 @@ var AnythingApiClient = class {
 		}
 		if (!response.ok) {
 			const retryAfter = parseRetryAfter(response);
+			const hint = error && typeof error === "object" && "hint" in error && typeof error.hint === "string" ? error.hint : void 0;
 			return err({
 				message: extractErrorMessage(response.status, error),
 				status: response.status,
 				details: error,
+				...hint ? { hint } : {},
 				...retryAfter !== null ? { retryAfter } : {}
 			});
 		}
@@ -4730,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,
@@ -4784,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 } : {}
 			}
 		}));
 	}
@@ -4870,12 +4900,13 @@ 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({
 			ok: false,
@@ -4883,8 +4914,9 @@ function outputError({ argv, command, error, hint, exitCode }) {
 			error: {
 				code,
 				message: error.message,
-				...hint ? { hint } : {},
-				...retryAfter !== null ? { retry_after_seconds: retryAfter } : {}
+				...resolvedHint ? { hint: resolvedHint } : {},
+				...retryAfter !== null ? { retry_after_seconds: retryAfter } : {},
+				...buildLogs ? { buildLogs } : {}
 			}
 		}, null, 2));
 		return;
@@ -4895,7 +4927,8 @@ function outputError({ argv, command, error, hint, exitCode }) {
 		details
 	});
 	if (retryAfter !== null) console.error(`  ${styleText("dim", `Retry after ${retryAfter}s`)}`);
-	if (hint) console.error(`  ${styleText("dim", hint)}`);
+	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({
@@ -5103,15 +5136,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.");
@@ -5207,7 +5240,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",
@@ -5227,7 +5260,7 @@ const devCommand = {
 		const apiUrl = resolveApiUrl({ apiUrl: argv.apiUrl });
 		if (outputSuccess({
 			argv,
-			command: COMMAND$26,
+			command: COMMAND$27,
 			data: {
 				devMode: enabled,
 				apiUrl
@@ -5767,7 +5800,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");
 }
@@ -5791,7 +5824,7 @@ const databaseConnectCommand = {
 		if (config.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$25,
+				command: COMMAND$26,
 				error: {
 					message: config.error.message,
 					status: null
@@ -5804,7 +5837,7 @@ const databaseConnectCommand = {
 		if (result.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$25,
+				command: COMMAND$26,
 				error: result.error
 			});
 			return;
@@ -5812,7 +5845,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
@@ -5869,7 +5902,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",
@@ -5888,7 +5921,7 @@ const databaseCreateCommand = {
 		if (!name) {
 			outputError({
 				argv,
-				command: COMMAND$24,
+				command: COMMAND$25,
 				error: {
 					message: "Database name is required. Pass --name <name>.",
 					status: null
@@ -5904,7 +5937,7 @@ const databaseCreateCommand = {
 		if (config.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$24,
+				command: COMMAND$25,
 				error: {
 					message: config.error.message,
 					status: null
@@ -5921,7 +5954,7 @@ const databaseCreateCommand = {
 		if (!orgResult.ok) {
 			outputError({
 				argv,
-				command: COMMAND$24,
+				command: COMMAND$25,
 				error: {
 					message: orgResult.error,
 					status: null
@@ -5933,7 +5966,7 @@ const databaseCreateCommand = {
 		if (argv["dry-run"]) {
 			outputDryRun({
 				argv,
-				command: COMMAND$24,
+				command: COMMAND$25,
 				plannedActions: [{
 					action: "create_database",
 					org: orgResult.orgId,
@@ -5951,14 +5984,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;
@@ -5971,7 +6004,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",
@@ -5988,7 +6021,7 @@ const databaseGetCommand = {
 		if (config.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$23,
+				command: COMMAND$24,
 				error: {
 					message: config.error.message,
 					status: null
@@ -6001,14 +6034,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;
@@ -6023,7 +6056,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",
@@ -6044,7 +6077,7 @@ const databaseQueryCommand = {
 		if (config.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$22,
+				command: COMMAND$23,
 				error: {
 					message: config.error.message,
 					status: null
@@ -6060,7 +6093,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"
 			});
@@ -6068,7 +6101,7 @@ const databaseQueryCommand = {
 		}
 		if (outputSuccess({
 			argv,
-			command: COMMAND$22,
+			command: COMMAND$23,
 			data: result.value
 		})) return;
 		if (result.value.rows.length === 0) {
@@ -6086,7 +6119,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)",
@@ -6107,7 +6140,7 @@ const databaseResetCommand = {
 		if (config.isErr()) {
 			outputError({
 				argv,
-				command: COMMAND$21,
+				command: COMMAND$22,
 				error: {
 					message: config.error.message,
 					status: null
@@ -6119,7 +6152,7 @@ const databaseResetCommand = {
 		if (argv["dry-run"]) {
 			outputDryRun({
 				argv,
-				command: COMMAND$21,
+				command: COMMAND$22,
 				plannedActions: [{
 					action: "reset_database",
 					databaseId: argv.databaseId
@@ -6130,12 +6163,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;
 		}
@@ -6143,14 +6177,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
@@ -6160,6 +6194,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";
@@ -6204,15 +6316,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;
@@ -6247,7 +6359,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: () => {}
 };
 
@@ -6295,15 +6407,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;
@@ -6435,20 +6547,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({
@@ -6473,8 +6582,7 @@ const deploymentsRollbackCommand = {
 				command,
 				plannedActions: [{
 					action: "rollback_deployment",
-					projectId: argv.projectId,
-					...argv.deploymentId ? { deploymentId: argv.deploymentId } : {}
+					projectId: argv.projectId
 				}]
 			});
 			return;
@@ -6487,14 +6595,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,
@@ -6523,9 +6629,29 @@ 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,}$/;
+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`;
+	return null;
+}
 const domainAddCommand = {
 	command: "add <domain>",
 	describe: "Add a custom domain to a project",
@@ -6541,6 +6667,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
@@ -6603,7 +6742,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}`);
@@ -6663,7 +6802,8 @@ const domainRemoveCommand = {
 					message: "Domain removal is destructive. Pass --yes to confirm.",
 					status: null
 				},
-				exitCode: 2
+				exitCode: 2,
+				code: "CONFIRMATION_REQUIRED"
 			});
 			return;
 		}
@@ -6783,15 +6923,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;
@@ -8121,6 +8262,7 @@ const linkCommand = {
 			orgId,
 			projectId: projectGroupId
 		}, null, 2) + "\n");
+		setStoredProjectGroupId(projResult.value.id);
 		if (outputSuccess({
 			argv,
 			command,
@@ -8156,7 +8298,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 {}
@@ -8359,6 +8503,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 = [
@@ -8422,7 +8582,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: [
@@ -8433,7 +8603,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) {
@@ -8622,7 +8792,8 @@ const membersRemoveCommand = {
 					message: "Member removal is destructive. Pass --yes to confirm.",
 					status: null
 				},
-				exitCode: 2
+				exitCode: 2,
+				code: "CONFIRMATION_REQUIRED"
 			});
 			return;
 		}
@@ -8755,16 +8926,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",
@@ -8803,7 +8964,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);
@@ -8849,7 +9020,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
@@ -8857,7 +9028,7 @@ async function loadOrganizations(argv) {
 	if (config.isErr()) {
 		outputError({
 			argv,
-			command: "orgs",
+			command,
 			error: {
 				message: config.error.message,
 				status: null
@@ -8870,7 +9041,7 @@ async function loadOrganizations(argv) {
 	if (result.isErr()) {
 		outputError({
 			argv,
-			command: "orgs",
+			command,
 			error: result.error
 		});
 		return null;
@@ -8890,7 +9061,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) {
@@ -8925,14 +9096,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: {
@@ -8940,6 +9107,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;
@@ -8968,7 +9139,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) {
@@ -9343,10 +9514,6 @@ const createCommand = {
 			message: "Project created"
 		});
 		if (!argv.wait) {
-			if (argv.quiet) {
-				console.log(result.value.projectGroupId);
-				return;
-			}
 			if (argv.json) {
 				printNdjson({
 					type: "result",
@@ -9355,6 +9522,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);
@@ -9373,27 +9544,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",
@@ -9403,12 +9558,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);
 	}
 };
 
@@ -9452,14 +9625,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;
@@ -9524,7 +9699,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;
 		}
@@ -9672,7 +9848,8 @@ const publishCommand = {
 					message: deployError.message,
 					status: null
 				},
-				exitCode: deployError.exitCode
+				exitCode: deployError.exitCode,
+				buildLogs: deployError.buildLogs ?? void 0
 			});
 			return;
 		}
@@ -9803,15 +9980,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;
@@ -9976,10 +10153,6 @@ const generateCommand = {
 			return;
 		}
 		if (!argv.wait) {
-			if (argv.quiet) {
-				console.log(result.value.revisionId);
-				return;
-			}
 			if (argv.json) {
 				printNdjson({
 					type: "result",
@@ -9988,6 +10161,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);
@@ -10000,32 +10177,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);
 	}
 };
 
@@ -10246,15 +10422,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;
@@ -10342,9 +10518,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,
@@ -10392,7 +10568,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);
@@ -10769,6 +10945,7 @@ const secretEnvironmentChoices = [
 	"preview",
 	"production"
 ];
+const DEFAULT_SECRET_ENVIRONMENT = "DEVELOPMENT";
 const add = {
 	command: "add <projectId>",
 	describe: "Add a secret to an app",
@@ -10785,8 +10962,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";
@@ -10836,11 +11018,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({
@@ -10901,7 +11102,8 @@ const remove = {
 					message: "Removing a secret is destructive. Pass --yes to confirm.",
 					status: null
 				},
-				exitCode: 2
+				exitCode: 2,
+				code: "CONFIRMATION_REQUIRED"
 			});
 			return;
 		}
@@ -10977,15 +11179,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;
@@ -11165,6 +11367,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"
@@ -11369,7 +11572,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,
@@ -11399,7 +11602,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;
 		}
@@ -11422,12 +11626,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;
 		}
@@ -11917,7 +12119,8 @@ const shipCommand = {
 						message: deployError.message,
 						status: null
 					},
-					exitCode: deployError.exitCode
+					exitCode: deployError.exitCode,
+					buildLogs: deployError.buildLogs ?? void 0
 				});
 				return;
 			}
@@ -11929,27 +12132,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);
 	}
 };
 
@@ -12212,7 +12416,8 @@ const switchCommand = {
 //#endregion
 //#region src/update-check.ts
 const PACKAGE_NAME = "@anythingai/cli";
-const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+const REGISTRY_BASE_URL = `https://registry.npmjs.org/${PACKAGE_NAME}`;
+const REGISTRY_URL = `${REGISTRY_BASE_URL}/latest`;
 const CHECK_INTERVAL_MS = 1440 * 60 * 1e3;
 const NOTICE_FETCH_TIMEOUT_MS = 1500;
 const latestManifestSchema = z.object({ version: z.string() });
@@ -12241,11 +12446,24 @@ 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"));
 }
@@ -12360,13 +12578,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.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) {
@@ -12382,25 +12603,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) {
@@ -12410,18 +12671,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"]) {
@@ -12431,14 +12694,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({
@@ -12477,13 +12740,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.`);
 	}
 };
 
@@ -12772,6 +13036,15 @@ const watchCommand = {
 
 //#endregion
 //#region src/cli.ts
+var HandledCliError = class extends Error {};
+function commandPathFromArgv(argv) {
+	const words = [];
+	for (const token of argv) {
+		if (token.startsWith("-")) break;
+		words.push(token);
+	}
+	return words.length > 0 ? words.join(" ") : null;
+}
 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",
@@ -12821,13 +13094,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;
@@ -12835,7 +13109,18 @@ function createCli(argv) {
 
 //#endregion
 //#region src/bin.ts
-createCli(hideBin(process.argv)).parse();
+function isHandled(err) {
+	return err instanceof HandledCliError;
+}
+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 {  };