@keystrokehq/cli 0.0.31 → 0.0.37

package/dist/{listen-C_7Rgwkb.mjs → listen-CVY-_F29.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
-import { n as JsonOptionSchema, t as JSON_OPTION_CONFIG } from "./output-BWcVRt-T.mjs";
-import { t as createTypedCommand } from "./commander-BlrSdFcu.mjs";
+import { n as JsonOptionSchema, t as JSON_OPTION_CONFIG } from "./output-DnIFEmi5.mjs";
+import { t as createTypedCommand } from "./commander-C6SSTQJ2.mjs";
 import { z } from "zod";
 //#region src/commands/listen/listen.command.ts
 const ListenOptionsSchema = JsonOptionSchema.extend({ timeout: z.coerce.number().int().min(1).default(300) });
@@ -18,7 +18,7 @@ function createListenCommand() {
 		description: "Listen for one incoming request and print its body",
 		schema: ListenOptionsSchema,
 		optionsConfig: LISTEN_OPTIONS_CONFIG,
-		loadHandler: async () => (await import("./listen.handler-dJgorIzr.mjs")).handleListen
+		loadHandler: async () => (await import("./listen.handler-D_nEvXRn.mjs")).handleListen
 	});
 }
 //#endregion

package/dist/{listen.handler-dJgorIzr.mjs → listen.handler-D_nEvXRn.mjs}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
-import { D as CliExitError, a as ui, j as throwReportedCliExit, n as style, t as ANSI, y as toErrorMessage } from "./keystroke.mjs";
-import { a as writeJsonError, i as writeJson } from "./output-BWcVRt-T.mjs";
-import { i as requireClient } from "./context-sgKhRc5v.mjs";
-import { n as sleep } from "./run-polling-fBouPjJ2.mjs";
+import { N as throwReportedCliExit, k as CliExitError, n as style, p as ui, t as ANSI, x as toErrorMessage } from "./keystroke.mjs";
+import { a as writeJsonError, i as writeJson } from "./output-DnIFEmi5.mjs";
+import { i as requireClient } from "./context-ebZssGCY.mjs";
+import { n as sleep } from "./run-polling-1c0ckC1A.mjs";
 import { spawn } from "node:child_process";
 //#region src/lib/clipboard.ts
 function getClipboardCommands() {

package/dist/{logs-B9YMhUGt.mjs → logs-CZ2qnsSH.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { t as createTypedCommand } from "./commander-BlrSdFcu.mjs";
+import { t as createTypedCommand } from "./commander-C6SSTQJ2.mjs";
 import { z } from "zod";
 //#region src/commands/logs/logs.command.ts
 const LogsOptionsSchema = z.object({
@@ -44,13 +44,13 @@ function createLogsCommand() {
 		description: "Display recent CLI log entries",
 		schema: LogsOptionsSchema,
 		optionsConfig: LOGS_OPTIONS_CONFIG,
-		loadHandler: async () => (await import("./logs.handler-DGGVPMOX.mjs")).handleLogs,
+		loadHandler: async () => (await import("./logs.handler-Wk6mYyAZ.mjs")).handleLogs,
 		subcommands: [createTypedCommand({
 			name: "clear",
 			description: "Clear the CLI log file",
 			schema: z.object({}),
 			optionsConfig: {},
-			loadHandler: async () => (await import("./clear.handler-T27GpgSu.mjs")).handleLogsClear
+			loadHandler: async () => (await import("./clear.handler-CDyG6-dk.mjs")).handleLogsClear
 		})]
 	});
 }

package/dist/{logs.handler-BfjCsAyq.mjs → logs.handler-BRUzZC9Z.mjs}

@@ -1,29 +1,19 @@
 #!/usr/bin/env node
 
-import { a as ui, j as throwReportedCliExit, n as style, t as ANSI, y as toErrorMessage } from "./keystroke.mjs";
-import { i as writeJson } from "./output-BWcVRt-T.mjs";
-import { i as requireClient } from "./context-sgKhRc5v.mjs";
-import { n as sleep, t as TERMINAL_STATUSES } from "./run-polling-fBouPjJ2.mjs";
+import { N as throwReportedCliExit, k as CliExitError, n as style, p as ui, t as ANSI, x as toErrorMessage } from "./keystroke.mjs";
+import { i as writeJson } from "./output-DnIFEmi5.mjs";
+import { i as requireClient } from "./context-ebZssGCY.mjs";
+import { n as resolveWorkflowsDir } from "./resolve-project-DLKlAy0z.mjs";
+import { n as sleep, t as TERMINAL_STATUSES } from "./run-polling-1c0ckC1A.mjs";
+import { n as assertAuthoredWorkflowId, t as WORKFLOW_ID_COMMANDS } from "./authored-workflow-ref-fkHEEVnd.mjs";
 import Table from "cli-table3";
 //#region src/commands/workflows/_shared/run-query.ts
-async function listRunsByWorkflowRef(client, options) {
-	const byAuthoredId = await client.runs.listRuns({
-		authoredWorkflowId: options.workflowRef,
+async function listRunsByAuthoredWorkflowId(client, options) {
+	return (await client.runs.listRuns({
+		authoredWorkflowId: options.authoredWorkflowId,
 		status: options.status,
 		limit: options.limit
-	});
-	if (byAuthoredId.runs.length > 0) return {
-		kind: "authoredId",
-		runs: byAuthoredId.runs
-	};
-	return {
-		kind: "name",
-		runs: (await client.runs.listRuns({
-			workflowName: options.workflowRef,
-			status: options.status,
-			limit: options.limit
-		})).runs
-	};
+	})).runs;
 }
 //#endregion
 //#region src/commands/workflows/logs/run-log-display.ts
@@ -88,12 +78,12 @@ async function handleWorkflowsLogs(options, ctx) {
 }
 async function listRecentRuns(client, options, jsonMode) {
 	try {
-		const result = await listRunsByWorkflowRef(client, {
-			workflowRef: options.workflow,
+		await assertWorkflowIdWhenLocal(options.workflow);
+		const runs = await listRunsByAuthoredWorkflowId(client, {
+			authoredWorkflowId: options.workflow,
 			status: options.status,
 			limit: options.limit
 		});
-		const { runs } = result;
 		if (jsonMode) {
 			writeJson(runs.map((run) => ({
 				id: run.id,
@@ -130,8 +120,9 @@ async function listRecentRuns(client, options, jsonMode) {
 			formatDuration(run.createdAt, run.completedAt)
 		]);
 		ui.text(table.toString());
-		ui.hint(result.kind === "authoredId" ? `${runs.length} run(s) matched workflow id "${options.workflow}". Use --latest to view the newest run's logs, or --run-id <id> to pin a specific run.` : `${runs.length} run(s) matched workflow name "${options.workflow}". Use --latest to view the newest run's logs, or --run-id <id> to pin a specific run.`);
+		ui.hint(`${runs.length} run(s) matched workflow id "${options.workflow}". Use --latest to view the newest run's logs, or --run-id <id> to pin a specific run.`);
 	} catch (error) {
+		if (error instanceof CliExitError && error.reported) throw error;
 		const message = toErrorMessage(error);
 		ui.error(`Failed to list runs: ${message}`);
 		throwReportedCliExit(`Failed to list runs: ${message}`, { cause: error });
@@ -139,18 +130,19 @@ async function listRecentRuns(client, options, jsonMode) {
 }
 async function showLatestRunLogs(client, options, jsonMode) {
 	try {
-		const result = await listRunsByWorkflowRef(client, {
-			workflowRef: options.workflow,
+		await assertWorkflowIdWhenLocal(options.workflow);
+		const latestRun = (await listRunsByAuthoredWorkflowId(client, {
+			authoredWorkflowId: options.workflow,
 			limit: 1
-		});
-		const latestRun = result.runs[0];
+		}))[0];
 		if (!latestRun) {
 			ui.hint(`No runs found for workflow "${options.workflow}".`);
 			return;
 		}
-		if (!jsonMode) ui.hint(result.kind === "authoredId" ? `Showing logs for the latest run of workflow id "${options.workflow}". Use --run-id ${latestRun.id} to pin this run.` : `Showing logs for the latest run of workflow name "${options.workflow}". Use --run-id ${latestRun.id} to pin this run.`);
+		if (!jsonMode) ui.hint(`Showing logs for the latest run of workflow id "${options.workflow}". Use --run-id ${latestRun.id} to pin this run.`);
 		await showRunLogs(client, latestRun.id, options, jsonMode);
 	} catch (error) {
+		if (error instanceof CliExitError && error.reported) throw error;
 		const message = toErrorMessage(error);
 		ui.error(`Failed to resolve latest run: ${message}`);
 		throwReportedCliExit(`Failed to resolve latest run: ${message}`, { cause: error });
@@ -227,5 +219,10 @@ async function showRunLogs(client, runId, options, jsonMode) {
 		throwReportedCliExit(`Failed to get run logs: ${message}`, { cause: error });
 	}
 }
+async function assertWorkflowIdWhenLocal(authoredWorkflowId) {
+	const workflowsDir = await resolveWorkflowsDir(void 0);
+	if (!workflowsDir) return;
+	await assertAuthoredWorkflowId(authoredWorkflowId, workflowsDir, WORKFLOW_ID_COMMANDS.logs);
+}
 //#endregion
 export { handleWorkflowsLogs };

package/dist/{logs.handler-DGGVPMOX.mjs → logs.handler-Wk6mYyAZ.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { F as originalConsole, I as readLogEntries, O as InputValidationError, a as ui, n as style, t as ANSI } from "./keystroke.mjs";
+import { A as InputValidationError, L as originalConsole, R as readLogEntries, n as style, p as ui, t as ANSI } from "./keystroke.mjs";
 //#region src/commands/logs/logs.handler.ts
 const LEVEL_STYLES = {
 	debug: ANSI.dim,

package/dist/{members.add.handler-DSRCRxsI.mjs → members.add.handler-BJ0wr6rP.mjs}

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 
-import { a as ui } from "./keystroke.mjs";
-import { i as writeJson } from "./output-BWcVRt-T.mjs";
-import { i as requireClient } from "./context-sgKhRc5v.mjs";
-import { i as requireOrganizationId, n as isIamJsonMode, r as requireConfirmation, t as handleIamError } from "./iam-command-utils-CSZj4XlH.mjs";
+import { p as ui } from "./keystroke.mjs";
+import { i as writeJson } from "./output-DnIFEmi5.mjs";
+import { i as requireClient } from "./context-ebZssGCY.mjs";
+import { n as isIamJsonMode, r as requireConfirmation, t as handleIamError } from "./iam-command-utils-DNDN0wT6.mjs";
+import { s as requireOrganizationId } from "./org-context-BI9OSpbb.mjs";
 //#region src/commands/org/members.add.handler.ts
 async function handleMembersAdd(options, ctx) {
 	const client = requireClient(ctx);
-	const organizationId = requireOrganizationId(ctx);
+	const organizationId = await requireOrganizationId(ctx);
 	if (options.role === "owner") requireConfirmation({
 		confirmed: options.confirm,
 		message: "Adding an owner grants full organization control.",

package/dist/{members.invite.handler-BNpHn1dY.mjs → members.invite.handler-DyveDMuq.mjs}

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 
-import { a as ui } from "./keystroke.mjs";
-import { i as writeJson } from "./output-BWcVRt-T.mjs";
-import { i as requireClient } from "./context-sgKhRc5v.mjs";
-import { i as requireOrganizationId, n as isIamJsonMode, r as requireConfirmation, t as handleIamError } from "./iam-command-utils-CSZj4XlH.mjs";
+import { p as ui } from "./keystroke.mjs";
+import { i as writeJson } from "./output-DnIFEmi5.mjs";
+import { i as requireClient } from "./context-ebZssGCY.mjs";
+import { n as isIamJsonMode, r as requireConfirmation, t as handleIamError } from "./iam-command-utils-DNDN0wT6.mjs";
+import { s as requireOrganizationId } from "./org-context-BI9OSpbb.mjs";
 //#region src/commands/org/members.invite.handler.ts
 async function handleMembersInvite(options, ctx) {
 	const client = requireClient(ctx);
-	const organizationId = requireOrganizationId(ctx);
+	const organizationId = await requireOrganizationId(ctx);
 	if (options.role === "owner") requireConfirmation({
 		confirmed: options.confirm,
 		message: "Inviting an owner grants full organization control.",

package/dist/{members.list.handler-Bn9LJEPG.mjs → members.list.handler-CyQxH_zS.mjs}

@@ -1,14 +1,15 @@
 #!/usr/bin/env node
 
-import { a as ui } from "./keystroke.mjs";
-import { i as writeJson } from "./output-BWcVRt-T.mjs";
-import { i as requireClient } from "./context-sgKhRc5v.mjs";
-import { i as requireOrganizationId, n as isIamJsonMode, t as handleIamError } from "./iam-command-utils-CSZj4XlH.mjs";
+import { p as ui } from "./keystroke.mjs";
+import { i as writeJson } from "./output-DnIFEmi5.mjs";
+import { i as requireClient } from "./context-ebZssGCY.mjs";
+import { n as isIamJsonMode, t as handleIamError } from "./iam-command-utils-DNDN0wT6.mjs";
+import { s as requireOrganizationId } from "./org-context-BI9OSpbb.mjs";
 import Table from "cli-table3";
 //#region src/commands/org/members.list.handler.ts
 async function handleMembersList(_options, ctx) {
 	const client = requireClient(ctx);
-	const organizationId = requireOrganizationId(ctx);
+	const organizationId = await requireOrganizationId(ctx);
 	try {
 		const result = await client.organizations.members.list(organizationId);
 		if (isIamJsonMode(_options, ctx)) {

package/dist/{members.remove.handler-Dkr2t_tX.mjs → members.remove.handler-Dtv9PooY.mjs}

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 
-import { a as ui } from "./keystroke.mjs";
-import { i as writeJson } from "./output-BWcVRt-T.mjs";
-import { i as requireClient } from "./context-sgKhRc5v.mjs";
-import { i as requireOrganizationId, n as isIamJsonMode, r as requireConfirmation, t as handleIamError } from "./iam-command-utils-CSZj4XlH.mjs";
+import { p as ui } from "./keystroke.mjs";
+import { i as writeJson } from "./output-DnIFEmi5.mjs";
+import { i as requireClient } from "./context-ebZssGCY.mjs";
+import { n as isIamJsonMode, r as requireConfirmation, t as handleIamError } from "./iam-command-utils-DNDN0wT6.mjs";
+import { s as requireOrganizationId } from "./org-context-BI9OSpbb.mjs";
 //#region src/commands/org/members.remove.handler.ts
 async function handleMembersRemove(options, ctx) {
 	const client = requireClient(ctx);
-	const organizationId = requireOrganizationId(ctx);
+	const organizationId = await requireOrganizationId(ctx);
 	requireConfirmation({
 		confirmed: options.confirm,
 		message: "Removing a member revokes organization access.",

package/dist/{members.update.handler-DBtUYuAY.mjs → members.update.handler-CeK-tCjT.mjs}

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 
-import { a as ui } from "./keystroke.mjs";
-import { i as writeJson } from "./output-BWcVRt-T.mjs";
-import { i as requireClient } from "./context-sgKhRc5v.mjs";
-import { i as requireOrganizationId, n as isIamJsonMode, r as requireConfirmation, t as handleIamError } from "./iam-command-utils-CSZj4XlH.mjs";
+import { p as ui } from "./keystroke.mjs";
+import { i as writeJson } from "./output-DnIFEmi5.mjs";
+import { i as requireClient } from "./context-ebZssGCY.mjs";
+import { n as isIamJsonMode, r as requireConfirmation, t as handleIamError } from "./iam-command-utils-DNDN0wT6.mjs";
+import { s as requireOrganizationId } from "./org-context-BI9OSpbb.mjs";
 //#region src/commands/org/members.update.handler.ts
 async function handleMembersUpdate(options, ctx) {
 	const client = requireClient(ctx);
-	const organizationId = requireOrganizationId(ctx);
+	const organizationId = await requireOrganizationId(ctx);
 	if (options.role === "owner") requireConfirmation({
 		confirmed: options.confirm,
 		message: "Promoting a member to owner grants full organization control.",

package/dist/{operations-AWMLs6mE.mjs → operations-CxQlt0S0.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
-import { n as JsonOptionSchema, t as JSON_OPTION_CONFIG } from "./output-BWcVRt-T.mjs";
-import { t as createTypedCommand } from "./commander-BlrSdFcu.mjs";
+import { n as JsonOptionSchema, t as JSON_OPTION_CONFIG } from "./output-DnIFEmi5.mjs";
+import { t as createTypedCommand } from "./commander-C6SSTQJ2.mjs";
 import { z } from "zod";
 //#region src/commands/operations/operations.command.ts
 const OperationsListOptionsSchema = JsonOptionSchema.extend({
@@ -56,13 +56,13 @@ function createOperationsCommand() {
 		description: "Browse and inspect operations across all integrations",
 		schema: OperationsListOptionsSchema,
 		optionsConfig: OPERATIONS_LIST_OPTIONS_CONFIG,
-		loadHandler: async () => (await import("./list.handler-BKfGLkFu.mjs")).handleOperationsList,
+		loadHandler: async () => (await import("./list.handler-7MkJfkak.mjs")).handleOperationsList,
 		subcommands: [createTypedCommand({
 			name: "list",
 			description: "List operations, optionally scoped to one integration",
 			schema: OperationsListOptionsSchema,
 			optionsConfig: OPERATIONS_LIST_OPTIONS_CONFIG,
-			loadHandler: async () => (await import("./list.handler-BKfGLkFu.mjs")).handleOperationsList
+			loadHandler: async () => (await import("./list.handler-7MkJfkak.mjs")).handleOperationsList
 		}), createTypedCommand({
 			name: "show",
 			description: "Show full details for one operation, including input/output schemas",
@@ -73,7 +73,7 @@ function createOperationsCommand() {
 				description: "Operation id, e.g. aws-s3.put-object",
 				key: "id"
 			},
-			loadHandler: async () => (await import("./show.handler-Wmv0tkxx.mjs")).handleOperationShow
+			loadHandler: async () => (await import("./show.handler-DB8xl5FU.mjs")).handleOperationShow
 		})]
 	});
 }

package/dist/{org-DOH7YHk2.mjs → org-B8MPHJJu.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
-import { n as JsonOptionSchema, t as JSON_OPTION_CONFIG } from "./output-BWcVRt-T.mjs";
-import { t as createTypedCommand } from "./commander-BlrSdFcu.mjs";
+import { n as JsonOptionSchema, t as JSON_OPTION_CONFIG } from "./output-DnIFEmi5.mjs";
+import { t as createTypedCommand } from "./commander-C6SSTQJ2.mjs";
 import { t as OrgRoleSchema } from "./schema-Lbp5lGJu.mjs";
 import { z } from "zod";
 //#region src/commands/org/invites.command.ts
@@ -36,14 +36,14 @@ function createOrgInvitesCommand() {
 		description: "Manage organization invitations",
 		schema: OrgInvitesListOptionsSchema,
 		optionsConfig: { ...JSON_OPTION_CONFIG },
-		loadHandler: async () => (await import("./invites.list.handler-CK6mL10z.mjs")).handleOrgInvitesList,
+		loadHandler: async () => (await import("./invites.list.handler-Dj4a6XOg.mjs")).handleOrgInvitesList,
 		subcommands: [
 			createTypedCommand({
 				name: "list",
 				description: "List organization invites",
 				schema: OrgInvitesListOptionsSchema,
 				optionsConfig: { ...JSON_OPTION_CONFIG },
-				loadHandler: async () => (await import("./invites.list.handler-CK6mL10z.mjs")).handleOrgInvitesList
+				loadHandler: async () => (await import("./invites.list.handler-Dj4a6XOg.mjs")).handleOrgInvitesList
 			}),
 			createTypedCommand({
 				name: "resend",
@@ -55,7 +55,7 @@ function createOrgInvitesCommand() {
 					description: "Invite ID to resend",
 					key: "inviteId"
 				},
-				loadHandler: async () => (await import("./invites.resend.handler-CKZouK1Z.mjs")).handleOrgInvitesResend
+				loadHandler: async () => (await import("./invites.resend.handler-DEGF4vlB.mjs")).handleOrgInvitesResend
 			}),
 			createTypedCommand({
 				name: "revoke",
@@ -67,7 +67,7 @@ function createOrgInvitesCommand() {
 					description: "Invite ID to revoke",
 					key: "inviteId"
 				},
-				loadHandler: async () => (await import("./invites.revoke.handler-H0VI-3sp.mjs")).handleOrgInvitesRevoke
+				loadHandler: async () => (await import("./invites.revoke.handler-Dg4ZvlFS.mjs")).handleOrgInvitesRevoke
 			})
 		]
 	});
@@ -142,28 +142,28 @@ function createOrgMembersCommand() {
 		description: "Manage organization members",
 		schema: MembersListOptionsSchema,
 		optionsConfig: { ...JSON_OPTION_CONFIG },
-		loadHandler: async () => (await import("./members.list.handler-Bn9LJEPG.mjs")).handleMembersList,
+		loadHandler: async () => (await import("./members.list.handler-CyQxH_zS.mjs")).handleMembersList,
 		subcommands: [
 			createTypedCommand({
 				name: "list",
 				description: "List organization members",
 				schema: MembersListOptionsSchema,
 				optionsConfig: { ...JSON_OPTION_CONFIG },
-				loadHandler: async () => (await import("./members.list.handler-Bn9LJEPG.mjs")).handleMembersList
+				loadHandler: async () => (await import("./members.list.handler-CyQxH_zS.mjs")).handleMembersList
 			}),
 			createTypedCommand({
 				name: "invite",
 				description: "Invite a user to the current organization",
 				schema: MembersInviteOptionsSchema,
 				optionsConfig: INVITE_OPTIONS_CONFIG,
-				loadHandler: async () => (await import("./members.invite.handler-BNpHn1dY.mjs")).handleMembersInvite
+				loadHandler: async () => (await import("./members.invite.handler-DyveDMuq.mjs")).handleMembersInvite
 			}),
 			createTypedCommand({
 				name: "add",
 				description: "Add an existing user to the current organization",
 				schema: MembersAddOptionsSchema,
 				optionsConfig: ADD_OPTIONS_CONFIG,
-				loadHandler: async () => (await import("./members.add.handler-DSRCRxsI.mjs")).handleMembersAdd
+				loadHandler: async () => (await import("./members.add.handler-BJ0wr6rP.mjs")).handleMembersAdd
 			}),
 			createTypedCommand({
 				name: "update",
@@ -175,7 +175,7 @@ function createOrgMembersCommand() {
 					description: "User ID to update",
 					key: "userId"
 				},
-				loadHandler: async () => (await import("./members.update.handler-DBtUYuAY.mjs")).handleMembersUpdate
+				loadHandler: async () => (await import("./members.update.handler-CeK-tCjT.mjs")).handleMembersUpdate
 			}),
 			createTypedCommand({
 				name: "remove",
@@ -187,43 +187,50 @@ function createOrgMembersCommand() {
 					description: "User ID to remove",
 					key: "userId"
 				},
-				loadHandler: async () => (await import("./members.remove.handler-Dkr2t_tX.mjs")).handleMembersRemove
+				loadHandler: async () => (await import("./members.remove.handler-Dtv9PooY.mjs")).handleMembersRemove
 			})
 		]
 	});
 }
 //#endregion
+//#region src/commands/org/org-options.ts
+/** Shared schema for read-only org commands (`list`, `current`, and default `org`). */
+const OrgReadOptionsSchema = JsonOptionSchema;
+const ORG_READ_OPTIONS_CONFIG = { ...JSON_OPTION_CONFIG };
+const OrgSwitchOptionsSchema = z.object({});
+const ORG_SWITCH_OPTIONS_CONFIG = {};
+/** Long description for the `org` command tree (includes global org override flags). */
+const ORG_COMMAND_DESCRIPTION = "Manage organization context (global --org <id> or KEYSTROKE_ORG_ID override active org)";
+//#endregion
 //#region src/commands/org/org.command.ts
-const OrgOptionsSchema = z.object({});
-const ORG_OPTIONS_CONFIG = {};
 function createOrgCommand() {
 	return createTypedCommand({
 		name: "org",
-		description: "Manage organization context",
-		schema: OrgOptionsSchema,
-		optionsConfig: ORG_OPTIONS_CONFIG,
-		loadHandler: async () => (await import("./list.handler-htR9TeiS.mjs")).handleOrgList,
+		description: ORG_COMMAND_DESCRIPTION,
+		schema: OrgReadOptionsSchema,
+		optionsConfig: ORG_READ_OPTIONS_CONFIG,
+		loadHandler: async () => (await import("./list.handler-BTYVIn6z.mjs")).handleOrgList,
 		subcommands: [
 			createTypedCommand({
 				name: "list",
 				description: "List your organizations",
-				schema: OrgOptionsSchema,
-				optionsConfig: ORG_OPTIONS_CONFIG,
-				loadHandler: async () => (await import("./list.handler-htR9TeiS.mjs")).handleOrgList
+				schema: OrgReadOptionsSchema,
+				optionsConfig: ORG_READ_OPTIONS_CONFIG,
+				loadHandler: async () => (await import("./list.handler-BTYVIn6z.mjs")).handleOrgList
 			}),
 			createTypedCommand({
 				name: "current",
 				description: "Show the current organization",
-				schema: OrgOptionsSchema,
-				optionsConfig: ORG_OPTIONS_CONFIG,
-				loadHandler: async () => (await import("./current.handler-BaGaCLzB.mjs")).handleOrgCurrent
+				schema: OrgReadOptionsSchema,
+				optionsConfig: ORG_READ_OPTIONS_CONFIG,
+				loadHandler: async () => (await import("./current.handler-DP1L_hm3.mjs")).handleOrgCurrent
 			}),
 			createTypedCommand({
 				name: "switch",
-				description: "Switch to a different organization",
-				schema: OrgOptionsSchema,
-				optionsConfig: ORG_OPTIONS_CONFIG,
-				loadHandler: async () => (await import("./switch.handler-BwYndsP-.mjs")).handleOrgSwitch
+				description: "Switch to a different organization (interactive)",
+				schema: OrgSwitchOptionsSchema,
+				optionsConfig: ORG_SWITCH_OPTIONS_CONFIG,
+				loadHandler: async () => (await import("./switch.handler-Cd4Yg2n8.mjs")).handleOrgSwitch
 			}),
 			createOrgMembersCommand(),
 			createOrgInvitesCommand()

package/dist/org-context-BI9OSpbb.mjs

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+
+import { N as throwReportedCliExit, b as isNetworkError, p as ui, x as toErrorMessage, y as isAuthError } from "./keystroke.mjs";
+import { a as writeJsonError } from "./output-DnIFEmi5.mjs";
+import { i as requireClient } from "./context-ebZssGCY.mjs";
+//#region src/commands/org/org-context.ts
+/** Shown when org context is missing or IAM commands need an org. */
+const ORG_CONTEXT_HINT = "Pass --org <organization-id>, set KEYSTROKE_ORG_ID, or run `keystroke org switch`.";
+/** Shown when switch cannot persist because no stored API keys exist. */
+const ORG_STORED_KEYS_HINT = "Run `keystroke auth` for each organization, then `keystroke org switch`.";
+async function getApiKeyValidationStatus(ctx) {
+	if (!ctx.client) return { kind: "not_authenticated" };
+	try {
+		const result = await ctx.client.public.auth.validate();
+		return {
+			kind: "valid",
+			apiKeyId: result.apiKeyId,
+			organizationId: result.organizationId
+		};
+	} catch (error) {
+		const message = toErrorMessage(error);
+		if (isAuthError(error)) return {
+			kind: "invalid",
+			message
+		};
+		return {
+			kind: "unavailable",
+			message,
+			reason: isNetworkError(error) ? "network" : "other"
+		};
+	}
+}
+function findMembershipOrganization(memberships, organizationId) {
+	return memberships.find((org) => org.id === organizationId);
+}
+async function resolveEffectiveOrganization(ctx, memberships) {
+	const explicitOrganizationId = ctx.organizationId;
+	if (explicitOrganizationId) {
+		const membership = findMembershipOrganization(memberships, explicitOrganizationId);
+		const storedOrg = ctx.storedOrgs.find((org) => org.organizationId === explicitOrganizationId);
+		const name = membership?.name ?? storedOrg?.organizationName;
+		return {
+			organizationId: explicitOrganizationId,
+			...name ? { name } : {},
+			source: ctx.orgSource ?? "credentials",
+			isMembershipKnown: membership !== void 0
+		};
+	}
+	if (!ctx.client) return;
+	const validation = await getApiKeyValidationStatus(ctx);
+	if (validation.kind !== "valid") return;
+	const membership = findMembershipOrganization(memberships, validation.organizationId);
+	const storedOrg = ctx.storedOrgs.find((org) => org.organizationId === validation.organizationId);
+	const name = membership?.name ?? storedOrg?.organizationName;
+	return {
+		organizationId: validation.organizationId,
+		...name ? { name } : {},
+		source: "api-key",
+		isMembershipKnown: membership !== void 0
+	};
+}
+/** Active org id for list output; omits unknown explicit overrides. */
+function resolveListActiveOrganizationId(effective) {
+	if (!effective?.isMembershipKnown) return;
+	return effective.organizationId;
+}
+function buildOrgListRows(params) {
+	return params.memberships.map((org) => ({
+		id: org.id,
+		name: org.name,
+		current: org.id === params.activeOrganizationId,
+		keyStored: params.storedOrgIds.has(org.id)
+	}));
+}
+function warnUnknownOrganizationOverride(params) {
+	if (findMembershipOrganization(params.memberships, params.organizationId)) return;
+	ui.warn(`Organization ID "${params.organizationId}" is not one of your memberships (from ${params.orgSource}).`);
+	ui.hint("Check the ID with `keystroke org list` or clear --org / KEYSTROKE_ORG_ID.");
+}
+function requireEffectiveOrganization(effective, ctx) {
+	if (effective) {
+		if (!effective.isMembershipKnown && (ctx.orgSource === "flag" || ctx.orgSource === "env")) {
+			const message = `Organization ID "${effective.organizationId}" is not one of your memberships.`;
+			if (ctx.jsonMode) writeJsonError(message, {
+				code: "UNKNOWN_ORGANIZATION",
+				hint: "Check the ID with `keystroke org list` or clear --org / KEYSTROKE_ORG_ID."
+			});
+			ui.error(message);
+			ui.hint("Check the ID with `keystroke org list` or clear --org / KEYSTROKE_ORG_ID.");
+			throwReportedCliExit(message);
+		}
+		return effective;
+	}
+	const message = `No organization set. ${ORG_CONTEXT_HINT}`;
+	if (ctx.jsonMode) writeJsonError(message, {
+		code: "ORG_REQUIRED",
+		hint: ORG_CONTEXT_HINT
+	});
+	ui.error(message);
+	if (ctx.storedOrgs.length === 0) ui.hint(ORG_STORED_KEYS_HINT);
+	throwReportedCliExit(message);
+}
+async function requireOrganizationId(ctx) {
+	const { user } = await requireClient(ctx).users.getMe();
+	return requireEffectiveOrganization(await resolveEffectiveOrganization(ctx, user.organizations ?? []), ctx).organizationId;
+}
+function formatOrgSourceLabel(source) {
+	if (source === "api-key") return "api key";
+	return source;
+}
+//#endregion
+export { getApiKeyValidationStatus as a, resolveEffectiveOrganization as c, formatOrgSourceLabel as i, resolveListActiveOrganizationId as l, ORG_STORED_KEYS_HINT as n, requireEffectiveOrganization as o, buildOrgListRows as r, requireOrganizationId as s, ORG_CONTEXT_HINT as t, warnUnknownOrganizationOverride as u };

package/dist/org-output-DffU7DKn.mjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+
+import { p as ui } from "./keystroke.mjs";
+import { i as writeJson } from "./output-DnIFEmi5.mjs";
+import { i as formatOrgSourceLabel } from "./org-context-BI9OSpbb.mjs";
+import Table from "cli-table3";
+//#region src/commands/org/org-output.ts
+function formatOrgStatus(row) {
+	const parts = [];
+	if (row.current) parts.push("current");
+	if (row.keyStored) parts.push("key stored");
+	return parts.length > 0 ? parts.join(", ") : "—";
+}
+function renderOrgListHuman(rows) {
+	ui.header("Organizations");
+	if (rows.length === 0) {
+		ui.hint("You do not belong to any organization.");
+		return;
+	}
+	const table = new Table({
+		head: [
+			"Name",
+			"ID",
+			"Status"
+		],
+		style: { head: [] }
+	});
+	for (const row of rows) table.push([
+		row.name,
+		row.id,
+		formatOrgStatus(row)
+	]);
+	ui.text(table.toString());
+	ui.hint(`${rows.length} organization(s)`);
+}
+function renderOrgListJson(params) {
+	writeJson({
+		organizations: params.rows.map((row) => ({
+			id: row.id,
+			name: row.name,
+			current: row.current,
+			keyStored: row.keyStored
+		})),
+		activeOrganizationId: params.activeOrganizationId
+	});
+}
+function renderOrgCurrentHuman(effective) {
+	ui.header("Current organization");
+	const label = effective.name ?? effective.organizationId;
+	ui.text(label);
+	ui.hint(`ID: ${effective.organizationId}`);
+	ui.hint(`Source: ${formatOrgSourceLabel(effective.source)}`);
+}
+function renderOrgCurrentJson(effective) {
+	writeJson({
+		organization: {
+			id: effective.organizationId,
+			name: effective.name ?? null
+		},
+		source: effective.source
+	});
+}
+//#endregion
+export { renderOrgListJson as i, renderOrgCurrentJson as n, renderOrgListHuman as r, renderOrgCurrentHuman as t };