@ait-co/console-cli 0.1.11 → 0.1.14

package/dist/cli.mjs

@@ -161,10 +161,10 @@ async function executeAndUnwrap(url, init, fetchImpl) {
 }
 //#endregion
 //#region src/api/mini-apps.ts
-const BASE$3 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
+const BASE$4 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
 async function fetchMiniApps(workspaceId, cookies, opts = {}) {
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${workspaceId}/mini-app`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -187,7 +187,7 @@ function normalizeMiniApp(item, workspaceId, index) {
 }
 async function fetchReviewStatus(workspaceId, cookies, opts = {}) {
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${workspaceId}/mini-apps/review-status`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-apps/review-status`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -206,7 +206,7 @@ async function fetchReviewStatus(workspaceId, cookies, opts = {}) {
 }
 async function fetchMiniAppWithDraft(workspaceId, miniAppId, cookies, opts = {}) {
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${workspaceId}/mini-app/${miniAppId}/with-draft`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/${miniAppId}/with-draft`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -228,7 +228,7 @@ async function fetchMiniAppRatings(params, cookies, opts = {}) {
 	const sortField = params.sortField ?? "CREATED_AT";
 	const sortDirection = params.sortDirection ?? "DESC";
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/app-ratings?page=${page}&size=${size}&sortField=${sortField}&sortDirection=${sortDirection}`,
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/app-ratings?page=${page}&size=${size}&sortField=${sortField}&sortDirection=${sortDirection}`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -261,7 +261,7 @@ async function fetchUserReports(params, cookies, opts = {}) {
 	qs.set("pageSize", String(pageSize));
 	if (params.cursor !== void 0) qs.set("cursor", params.cursor);
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${params.workspaceId}/mini-apps/${params.miniAppId}/user-reports?` + qs.toString(),
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-apps/${params.miniAppId}/user-reports?` + qs.toString(),
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -285,7 +285,7 @@ async function fetchBundles(params, cookies, opts = {}) {
 	if (params.deployStatus !== void 0) qs.set("deployStatus", params.deployStatus);
 	const query = qs.toString();
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/bundles` + (query ? `?${query}` : ""),
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/bundles` + (query ? `?${query}` : ""),
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -309,7 +309,7 @@ async function fetchConversionMetrics(params, cookies, opts = {}) {
 	qs.set("startDate", params.startDate);
 	qs.set("endDate", params.endDate);
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/conversion-metrics?${qs.toString()}`,
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/conversion-metrics?${qs.toString()}`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -327,7 +327,7 @@ async function fetchConversionMetrics(params, cookies, opts = {}) {
 }
 async function fetchCerts(workspaceId, miniAppId, cookies, opts = {}) {
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${workspaceId}/mini-app/${miniAppId}/certs`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/${miniAppId}/certs`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -341,7 +341,7 @@ async function fetchShareRewards(params, cookies, opts = {}) {
 	const qs = new URLSearchParams();
 	qs.set("search", params.search ?? "");
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/share-rewards?${qs.toString()}`,
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/share-rewards?${qs.toString()}`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -351,9 +351,164 @@ async function fetchShareRewards(params, cookies, opts = {}) {
 		return r;
 	});
 }
+async function fetchSmartMessageCampaigns(params, cookies, opts = {}) {
+	const page = params.page ?? 0;
+	const size = params.size ?? 20;
+	const qs = new URLSearchParams();
+	qs.set("page", String(page));
+	qs.set("size", String(size));
+	const raw = await requestConsoleApi({
+		method: "POST",
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/smart-message/campaigns?${qs.toString()}`,
+		body: {
+			sort: params.sort ?? [{
+				field: "regTs",
+				direction: "DESC"
+			}],
+			search: params.search ?? "",
+			filters: params.filters ?? {}
+		},
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Unexpected smart-message campaigns shape for app=${params.miniAppId}`);
+	const data = raw;
+	const items = Array.isArray(data.items) ? data.items : [];
+	const rawPaging = data.paging;
+	const paging = {
+		pageNumber: typeof rawPaging?.pageNumber === "number" ? rawPaging.pageNumber : page,
+		pageSize: typeof rawPaging?.pageSize === "number" ? rawPaging.pageSize : size,
+		hasNext: Boolean(rawPaging?.hasNext),
+		totalCount: typeof rawPaging?.totalCount === "number" ? rawPaging.totalCount : items.length
+	};
+	return {
+		items: items.map((r) => r && typeof r === "object" ? r : {}),
+		paging
+	};
+}
+async function fetchAppEventCatalogs(params, cookies, opts = {}) {
+	const pageNumber = params.pageNumber ?? 0;
+	const pageSize = params.pageSize ?? 20;
+	const raw = await requestConsoleApi({
+		method: "POST",
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/log/catalogs/search`,
+		body: {
+			isRefresh: params.refresh ?? false,
+			pageNumber,
+			pageSize,
+			search: params.search ?? ""
+		},
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Unexpected event-catalogs shape for app=${params.miniAppId}`);
+	const data = raw;
+	const results = Array.isArray(data.results) ? data.results : [];
+	const rawPaging = data.paging;
+	const paging = {
+		pageNumber: typeof rawPaging?.pageNumber === "number" ? rawPaging.pageNumber : pageNumber,
+		pageSize: typeof rawPaging?.pageSize === "number" ? rawPaging.pageSize : pageSize,
+		hasNext: Boolean(rawPaging?.hasNext),
+		totalCount: typeof rawPaging?.totalCount === "number" ? rawPaging.totalCount : results.length,
+		totalPages: typeof rawPaging?.totalPages === "number" ? rawPaging.totalPages : 0
+	};
+	return {
+		results: results.map((r) => r && typeof r === "object" ? r : {}),
+		cacheTime: typeof data.cacheTime === "string" ? data.cacheTime : void 0,
+		paging
+	};
+}
+const TEMPLATE_CONTENT_REACH_TYPES = ["FUNCTIONAL", "MARKETING"];
+async function fetchAppTemplates(params, cookies, opts = {}) {
+	const page = params.page ?? 0;
+	const size = params.size ?? 20;
+	const qs = new URLSearchParams();
+	qs.set("page", String(page));
+	qs.set("size", String(size));
+	if (params.contentReachType) qs.set("contentReachType", params.contentReachType);
+	if (params.isSmartMessage !== void 0) qs.set("isSmartMessage", String(params.isSmartMessage));
+	const raw = await requestConsoleApi({
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/templates/search?${qs.toString()}`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Unexpected templates shape for app=${params.miniAppId}`);
+	const data = raw;
+	const list = Array.isArray(data.groupSendContextSimpleView) ? data.groupSendContextSimpleView : [];
+	const pageMeta = data.page;
+	return {
+		templates: list.map((r) => r && typeof r === "object" ? r : {}),
+		totalPageCount: typeof pageMeta?.totalPageCount === "number" ? pageMeta.totalPageCount : 0
+	};
+}
+async function fetchImpressionCategoryList(cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${BASE$4}/impression/category-list`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (!Array.isArray(raw)) throw new Error("Unexpected impression/category-list shape: not an array");
+	return raw.map((entry, i) => {
+		if (!entry || typeof entry !== "object") throw new Error(`Unexpected category-list entry at index ${i}`);
+		const e = entry;
+		const group = e.categoryGroup;
+		const list = Array.isArray(e.categoryList) ? e.categoryList : [];
+		return {
+			categoryGroup: {
+				id: typeof group?.id === "number" ? group.id : 0,
+				name: typeof group?.name === "string" ? group.name : "",
+				isSelectable: Boolean(group?.isSelectable)
+			},
+			categoryList: list.map((c) => {
+				if (!c || typeof c !== "object") return {
+					id: 0,
+					name: "",
+					isSelectable: false,
+					subCategoryList: []
+				};
+				const cr = c;
+				const subs = Array.isArray(cr.subCategoryList) ? cr.subCategoryList : [];
+				return {
+					id: typeof cr.id === "number" ? cr.id : 0,
+					name: typeof cr.name === "string" ? cr.name : "",
+					isSelectable: Boolean(cr.isSelectable),
+					subCategoryList: subs.map((s) => {
+						if (!s || typeof s !== "object") return {
+							id: 0,
+							name: "",
+							isSelectable: false
+						};
+						const sr = s;
+						return {
+							id: typeof sr.id === "number" ? sr.id : 0,
+							name: typeof sr.name === "string" ? sr.name : "",
+							isSelectable: Boolean(sr.isSelectable)
+						};
+					})
+				};
+			})
+		};
+	});
+}
+async function fetchAppServiceStatus(workspaceId, miniAppId, cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/${miniAppId}/review-status`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Unexpected app service-status shape for app=${miniAppId}`);
+	const data = raw;
+	const serviceStatus = data.serviceStatus;
+	if (typeof serviceStatus !== "string") throw new Error(`Unexpected app service-status shape for app=${miniAppId}: missing serviceStatus`);
+	return {
+		shutdownCandidateStatus: typeof data.shutdownCandidateStatus === "string" ? data.shutdownCandidateStatus : null,
+		scheduledShutdownAt: typeof data.scheduledShutdownAt === "string" ? data.scheduledShutdownAt : null,
+		serviceStatus
+	};
+}
 async function fetchDeployedBundle(workspaceId, miniAppId, cookies, opts = {}) {
 	const raw = await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${workspaceId}/mini-app/${miniAppId}/bundles/deployed`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/${miniAppId}/bundles/deployed`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -363,7 +518,7 @@ async function fetchDeployedBundle(workspaceId, miniAppId, cookies, opts = {}) {
 }
 async function createMiniApp(workspaceId, payload, cookies, opts = {}) {
 	return normalizeCreateResult(await requestConsoleApi({
-		url: `${BASE$3}/workspaces/${workspaceId}/mini-app/review`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/review`,
 		method: "POST",
 		cookies,
 		body: payload,
@@ -396,7 +551,7 @@ function normalizeCreateResult(raw) {
 * the field name is actually `file` — if so, swap it in one place here.
 */
 async function uploadMiniAppResource(params, opts = {}) {
-	const url = new URL(`${BASE$3}/resource/${params.workspaceId}/upload`);
+	const url = new URL(`${BASE$4}/resource/${params.workspaceId}/upload`);
 	url.searchParams.set("validWidth", String(params.validWidth));
 	url.searchParams.set("validHeight", String(params.validHeight));
 	const form = new FormData();
@@ -1120,6 +1275,10 @@ async function uploadOne(uploadImpl, input) {
 		}
 	});
 }
+function categoryHintFor(err) {
+	if ((err.field ?? "") === "categoryIds" || /categoryIds/.test(err.message)) return "Tip: run `aitcc app categories --selectable` to list valid category ids.";
+	return null;
+}
 function emitManifestError(json, err) {
 	if (json) if (err.kind === "missing-required-field") emitJson({
 		ok: false,
@@ -1132,7 +1291,11 @@ function emitManifestError(json, err) {
 		reason: "invalid-config",
 		message: err.message
 	});
-	else process.stderr.write(`${err.message}\n`);
+	else {
+		process.stderr.write(`${err.message}\n`);
+		const hint = categoryHintFor(err);
+		if (hint) process.stderr.write(`${hint}\n`);
+	}
 }
 function emitImageDimensionError(json, err) {
 	if (json) if (err.reason === "mismatch") emitJson({
@@ -1334,6 +1497,7 @@ const showCommand$2 = defineCommand({
 		try {
 			const envelope = await fetchMiniAppWithDraft(workspaceId, appId, session.cookies);
 			const miniApp = pickMiniAppView(envelope, view);
+			if (miniApp === null && view === "current" && envelope.draft !== null) process.stderr.write(`App ${appId} has no \`current\` view yet (not reviewed). Re-run with \`--view draft\` to see the pending record.\n`);
 			if (args.json) {
 				emitJson({
 					ok: true,
@@ -1345,7 +1509,7 @@ const showCommand$2 = defineCommand({
 				return exitAfterFlush(ExitCode.Ok);
 			}
 			if (miniApp === null) {
-				if (view === "current" && envelope.draft !== null) process.stdout.write(`App ${appId} has no \`current\` view yet (not reviewed). Try --view draft.\n`);
+				if (view === "current" && envelope.draft !== null) process.stdout.write(`App ${appId} has no \`current\` view yet.\n`);
 				else process.stdout.write(`App ${appId} has no data for view=${view}.\n`);
 				return exitAfterFlush(ExitCode.Ok);
 			}
@@ -1472,29 +1636,40 @@ const statusCommand = defineCommand({
 		const ctx = await resolveWorkspaceContext(args);
 		if (!ctx) return;
 		const { session, workspaceId } = ctx;
-		const emit = (status) => {
+		const emit = (status, service) => {
 			if (args.json) emitJson({
 				ok: true,
 				workspaceId,
 				appId,
-				...status
+				...status,
+				serviceStatus: service?.serviceStatus ?? null,
+				shutdownCandidateStatus: service?.shutdownCandidateStatus ?? null,
+				scheduledShutdownAt: service?.scheduledShutdownAt ?? null
 			});
-			else process.stdout.write(`App ${appId} (ws ${workspaceId}): ${status.state}` + (status.rejectedMessage ? `\n  reason: ${status.rejectedMessage}` : "") + "\n");
+			else {
+				const svc = service ? ` [${service.serviceStatus}]` : "";
+				process.stdout.write(`App ${appId} (ws ${workspaceId}): ${status.state}${svc}` + (status.rejectedMessage ? `\n  reason: ${status.rejectedMessage}` : "") + (service?.scheduledShutdownAt ? `\n  scheduled shutdown: ${service.scheduledShutdownAt}` : "") + "\n");
+			}
 		};
 		try {
 			const once = async () => {
-				return deriveReviewState(await fetchMiniAppWithDraft(workspaceId, appId, session.cookies));
+				const [env, service] = await Promise.all([fetchMiniAppWithDraft(workspaceId, appId, session.cookies), fetchAppServiceStatus(workspaceId, appId, session.cookies).catch(() => null)]);
+				return [deriveReviewState(env), service];
 			};
 			if (!args.watch) {
-				emit(await once());
+				const [status, service] = await once();
+				emit(status, service);
 				return exitAfterFlush(ExitCode.Ok);
 			}
 			let lastState = null;
+			let lastServiceStatus = null;
 			while (true) {
-				const status = await once();
-				if (args.json) emit(status);
-				else if (status.state !== lastState) emit(status);
+				const [status, service] = await once();
+				const svc = service?.serviceStatus ?? null;
+				if (args.json) emit(status, service);
+				else if (status.state !== lastState || svc !== lastServiceStatus) emit(status, service);
 				lastState = status.state;
+				lastServiceStatus = svc;
 				if (status.state !== "under-review") return exitAfterFlush(ExitCode.Ok);
 				await new Promise((resolve) => setTimeout(resolve, intervalSec * 1e3));
 			}
@@ -2265,140 +2440,821 @@ const appCommand = defineCommand({
 				}
 			}) }
 		}),
-		register: defineCommand({
+		messages: defineCommand({
 			meta: {
-				name: "register",
-				description: "Register a mini-app in the selected workspace from a YAML/JSON manifest. Uploads logo/thumbnail/screenshots, then submits the create payload."
+				name: "messages",
+				description: "Inspect smart-message (formerly push) campaigns for a mini-app."
 			},
-			args: {
-				workspace: {
-					type: "string",
-					description: "Workspace ID. Defaults to the selected workspace (`aitcc workspace use`)."
+			subCommands: { ls: defineCommand({
+				meta: {
+					name: "ls",
+					description: "List smart-message campaigns (formerly \"push\" — the 스마트 발송 menu)."
 				},
-				config: {
-					type: "string",
-					description: "Path to the app manifest. Defaults to `./aitcc.app.yaml`, then `./aitcc.app.json`."
+				args: {
+					id: {
+						type: "positional",
+						description: "Mini-app ID.",
+						required: true
+					},
+					workspace: {
+						type: "string",
+						description: "Workspace ID. Defaults to the selected workspace."
+					},
+					page: {
+						type: "string",
+						description: "Page number (0-indexed).",
+						default: "0"
+					},
+					size: {
+						type: "string",
+						description: "Page size.",
+						default: "20"
+					},
+					search: {
+						type: "string",
+						description: "Title-contains filter. Empty matches everything."
+					},
+					json: {
+						type: "boolean",
+						description: "Emit machine-readable JSON.",
+						default: false
+					}
 				},
-				"dry-run": {
-					type: "boolean",
-					description: "Validate manifest + images and print the inferred submit payload; no uploads.",
-					default: false
+				async run({ args }) {
+					const appId = parseAppId(args.id);
+					if (appId === null) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-id",
+							message: `app id must be a positive integer (got ${JSON.stringify(args.id)})`
+						});
+						else process.stderr.write(`app messages ls: invalid id ${JSON.stringify(args.id)}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const pageResult = parseNonNegativeInt(String(args.page), "page");
+					if ("error" in pageResult) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-page",
+							message: pageResult.error
+						});
+						else process.stderr.write(`${pageResult.error}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const sizeResult = parseNonNegativeInt(String(args.size), "size");
+					if ("error" in sizeResult) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-size",
+							message: sizeResult.error
+						});
+						else process.stderr.write(`${sizeResult.error}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const ctx = await resolveWorkspaceContext(args);
+					if (!ctx) return;
+					const { session, workspaceId } = ctx;
+					try {
+						const result = await fetchSmartMessageCampaigns({
+							workspaceId,
+							miniAppId: appId,
+							page: pageResult.value,
+							size: sizeResult.value,
+							...args.search !== void 0 ? { search: String(args.search) } : {}
+						}, session.cookies);
+						if (args.json) {
+							emitJson({
+								ok: true,
+								workspaceId,
+								appId,
+								campaigns: result.items,
+								paging: result.paging
+							});
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						if (result.items.length === 0) {
+							process.stdout.write(`App ${appId} (ws ${workspaceId}): no smart-message campaigns\n`);
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						process.stdout.write(`App ${appId} (ws ${workspaceId}): ${result.items.length} campaign(s) on page ${result.paging.pageNumber} of ${result.paging.totalCount}\n`);
+						for (const c of result.items) {
+							const id = typeof c.id === "string" || typeof c.id === "number" ? c.id : typeof c.campaignId === "string" || typeof c.campaignId === "number" ? c.campaignId : "-";
+							const title = typeof c.title === "string" ? c.title : typeof c.name === "string" ? c.name : "-";
+							const status = typeof c.status === "string" ? c.status : "-";
+							process.stdout.write(`${id}\t${title}\t${status}\n`);
+						}
+						return exitAfterFlush(ExitCode.Ok);
+					} catch (err) {
+						return emitFailureFromError(args.json, err);
+					}
+				}
+			}) }
+		}),
+		events: defineCommand({
+			meta: {
+				name: "events",
+				description: "Inspect custom event catalogs (log search) for a mini-app."
+			},
+			subCommands: { ls: defineCommand({
+				meta: {
+					name: "ls",
+					description: "List custom event catalogs recorded for a mini-app (the 이벤트 menu)."
 				},
-				"accept-terms": {
-					type: "boolean",
-					description: "Attest to the required console legal-agreement checkboxes (see VALIDATION-RULES.md). Required for real submits.",
-					default: false
+				args: {
+					id: {
+						type: "positional",
+						description: "Mini-app ID.",
+						required: true
+					},
+					workspace: {
+						type: "string",
+						description: "Workspace ID. Defaults to the selected workspace."
+					},
+					page: {
+						type: "string",
+						description: "Page number (0-indexed).",
+						default: "0"
+					},
+					size: {
+						type: "string",
+						description: "Page size.",
+						default: "20"
+					},
+					search: {
+						type: "string",
+						description: "Event-name filter. Empty matches everything."
+					},
+					refresh: {
+						type: "boolean",
+						description: "Bypass the server cache and rebuild the catalog list.",
+						default: false
+					},
+					json: {
+						type: "boolean",
+						description: "Emit machine-readable JSON.",
+						default: false
+					}
 				},
-				json: {
-					type: "boolean",
-					description: "Emit machine-readable JSON to stdout.",
-					default: false
+				async run({ args }) {
+					const appId = parseAppId(args.id);
+					if (appId === null) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-id",
+							message: `app id must be a positive integer (got ${JSON.stringify(args.id)})`
+						});
+						else process.stderr.write(`app events ls: invalid id ${JSON.stringify(args.id)}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const pageResult = parseNonNegativeInt(String(args.page), "page");
+					if ("error" in pageResult) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-page",
+							message: pageResult.error
+						});
+						else process.stderr.write(`${pageResult.error}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const sizeResult = parseNonNegativeInt(String(args.size), "size");
+					if ("error" in sizeResult) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-size",
+							message: sizeResult.error
+						});
+						else process.stderr.write(`${sizeResult.error}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const ctx = await resolveWorkspaceContext(args);
+					if (!ctx) return;
+					const { session, workspaceId } = ctx;
+					try {
+						const result = await fetchAppEventCatalogs({
+							workspaceId,
+							miniAppId: appId,
+							pageNumber: pageResult.value,
+							pageSize: sizeResult.value,
+							...args.search !== void 0 ? { search: String(args.search) } : {},
+							...args.refresh ? { refresh: true } : {}
+						}, session.cookies);
+						if (args.json) {
+							emitJson({
+								ok: true,
+								workspaceId,
+								appId,
+								events: result.results,
+								cacheTime: result.cacheTime ?? null,
+								paging: result.paging
+							});
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						if (result.results.length === 0) {
+							const ct = result.cacheTime ? ` (cached ${result.cacheTime})` : "";
+							process.stdout.write(`App ${appId} (ws ${workspaceId}): no event catalogs${ct}\n`);
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						process.stdout.write(`App ${appId} (ws ${workspaceId}): ${result.results.length} event(s) on page ${result.paging.pageNumber} of ${result.paging.totalPages}\n`);
+						for (const e of result.results) {
+							const name = typeof e.name === "string" ? e.name : typeof e.eventName === "string" ? e.eventName : "-";
+							const count = typeof e.count === "number" ? String(e.count) : typeof e.totalCount === "number" ? String(e.totalCount) : "-";
+							process.stdout.write(`${name}\t${count}\n`);
+						}
+						return exitAfterFlush(ExitCode.Ok);
+					} catch (err) {
+						return emitFailureFromError(args.json, err);
+					}
 				}
+			}) }
+		}),
+		templates: defineCommand({
+			meta: {
+				name: "templates",
+				description: "Inspect smart-message composer templates available for a mini-app."
 			},
-			async run({ args }) {
-				await runRegister({
-					json: args.json,
-					dryRun: args["dry-run"],
-					acceptTerms: args["accept-terms"],
-					...args.workspace !== void 0 ? { workspace: args.workspace } : {},
-					...args.config !== void 0 ? { config: args.config } : {}
-				});
-			}
-		})
-	}
-});
-//#endregion
-//#region src/api/api-keys.ts
-const BASE$2 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
-async function fetchApiKeys(workspaceId, cookies, opts = {}) {
-	const raw = await requestConsoleApi({
-		url: `${BASE$2}/workspaces/${workspaceId}/api-keys`,
-		cookies,
-		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
-	});
-	if (!Array.isArray(raw)) throw new Error(`Unexpected api-keys shape for workspace=${workspaceId}: not an array`);
-	return raw.map((entry, index) => normalizeKey(entry, workspaceId, index));
-}
-function normalizeKey(raw, workspaceId, index) {
-	if (raw === null || typeof raw !== "object") throw new Error(`Unexpected api-key entry at index ${index} for workspace=${workspaceId}: not an object`);
-	const rec = raw;
-	const rawId = rec.id ?? rec.apiKeyId ?? rec.keyId;
-	if (typeof rawId !== "string" && typeof rawId !== "number") throw new Error(`Unexpected api-key entry at index ${index} for workspace=${workspaceId}: missing id`);
-	const rawName = rec.name ?? rec.apiKeyName ?? rec.keyName ?? rec.description;
-	const name = typeof rawName === "string" ? rawName : void 0;
-	const { id: _id, apiKeyId: _aid, keyId: _kid, name: _n, apiKeyName: _an, keyName: _kn, description: _d, ...extra } = rec;
-	return {
-		id: rawId,
-		name,
-		extra
-	};
-}
-const keysCommand = defineCommand({
-	meta: {
-		name: "keys",
-		description: "Inspect console API keys used for deploy automation."
-	},
-	subCommands: { ls: defineCommand({
-		meta: {
-			name: "ls",
-			description: "List console API keys in the selected workspace."
-		},
-		args: {
-			workspace: {
-				type: "string",
-				description: "Workspace ID. Defaults to the selected workspace (`aitcc workspace use`)."
+			subCommands: { ls: defineCommand({
+				meta: {
+					name: "ls",
+					description: "List the smart-message composer templates available for a mini-app (the 템플릿 picker in 스마트 발송)."
+				},
+				args: {
+					id: {
+						type: "positional",
+						description: "Mini-app ID.",
+						required: true
+					},
+					workspace: {
+						type: "string",
+						description: "Workspace ID. Defaults to the selected workspace."
+					},
+					page: {
+						type: "string",
+						description: "Page number (0-indexed).",
+						default: "0"
+					},
+					size: {
+						type: "string",
+						description: "Page size.",
+						default: "20"
+					},
+					"content-reach-type": {
+						type: "string",
+						description: `Template reach bucket: ${TEMPLATE_CONTENT_REACH_TYPES.join(" | ")}. Omit for all.`
+					},
+					"smart-message": {
+						type: "string",
+						description: "Filter to templates compatible with smart-message (\"true\") or legacy push (\"false\"). Omit for all."
+					},
+					json: {
+						type: "boolean",
+						description: "Emit machine-readable JSON.",
+						default: false
+					}
+				},
+				async run({ args }) {
+					const appId = parseAppId(args.id);
+					if (appId === null) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-id",
+							message: `app id must be a positive integer (got ${JSON.stringify(args.id)})`
+						});
+						else process.stderr.write(`app templates ls: invalid id ${JSON.stringify(args.id)}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const pageResult = parseNonNegativeInt(String(args.page), "page");
+					if ("error" in pageResult) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-page",
+							message: pageResult.error
+						});
+						else process.stderr.write(`${pageResult.error}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const sizeResult = parseNonNegativeInt(String(args.size), "size");
+					if ("error" in sizeResult) {
+						if (args.json) emitJson({
+							ok: false,
+							reason: "invalid-size",
+							message: sizeResult.error
+						});
+						else process.stderr.write(`${sizeResult.error}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					let contentReachType;
+					if (args["content-reach-type"] !== void 0) {
+						const upper = String(args["content-reach-type"]).toUpperCase();
+						if (TEMPLATE_CONTENT_REACH_TYPES.includes(upper)) contentReachType = upper;
+						else {
+							const message = `--content-reach-type must be one of: ${TEMPLATE_CONTENT_REACH_TYPES.join(", ")}`;
+							if (args.json) emitJson({
+								ok: false,
+								reason: "invalid-content-reach-type",
+								allowed: [...TEMPLATE_CONTENT_REACH_TYPES]
+							});
+							else process.stderr.write(`${message}\n`);
+							return exitAfterFlush(ExitCode.Usage);
+						}
+					}
+					let isSmartMessage;
+					if (args["smart-message"] !== void 0) {
+						const raw = String(args["smart-message"]).toLowerCase();
+						if (raw === "true") isSmartMessage = true;
+						else if (raw === "false") isSmartMessage = false;
+						else {
+							const message = "--smart-message must be \"true\" or \"false\"";
+							if (args.json) emitJson({
+								ok: false,
+								reason: "invalid-smart-message",
+								message
+							});
+							else process.stderr.write(`${message}\n`);
+							return exitAfterFlush(ExitCode.Usage);
+						}
+					}
+					const ctx = await resolveWorkspaceContext(args);
+					if (!ctx) return;
+					const { session, workspaceId } = ctx;
+					try {
+						const result = await fetchAppTemplates({
+							workspaceId,
+							miniAppId: appId,
+							page: pageResult.value,
+							size: sizeResult.value,
+							...contentReachType !== void 0 ? { contentReachType } : {},
+							...isSmartMessage !== void 0 ? { isSmartMessage } : {}
+						}, session.cookies);
+						if (args.json) {
+							emitJson({
+								ok: true,
+								workspaceId,
+								appId,
+								templates: result.templates,
+								totalPageCount: result.totalPageCount
+							});
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						if (result.templates.length === 0) {
+							process.stdout.write(`App ${appId} (ws ${workspaceId}): no templates\n`);
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						process.stdout.write(`App ${appId} (ws ${workspaceId}): ${result.templates.length} template(s) of ${result.totalPageCount} page(s)\n`);
+						for (const t of result.templates) {
+							const id = typeof t.id === "string" || typeof t.id === "number" ? t.id : typeof t.templateId === "string" || typeof t.templateId === "number" ? t.templateId : "-";
+							const title = typeof t.title === "string" ? t.title : typeof t.name === "string" ? t.name : "-";
+							const type = typeof t.templateType === "string" ? t.templateType : "-";
+							process.stdout.write(`${id}\t${title}\t${type}\n`);
+						}
+						return exitAfterFlush(ExitCode.Ok);
+					} catch (err) {
+						return emitFailureFromError(args.json, err);
+					}
+				}
+			}) }
+		}),
+		categories: defineCommand({
+			meta: {
+				name: "categories",
+				description: "List the impression category tree used by `app register`'s `categoryIds` field."
 			},
-			json: {
-				type: "boolean",
-				description: "Emit machine-readable JSON to stdout.",
-				default: false
+			args: {
+				selectable: {
+					type: "boolean",
+					description: "Only show categories flagged `isSelectable: true` — the ones you can pick.",
+					default: false
+				},
+				json: {
+					type: "boolean",
+					description: "Emit machine-readable JSON to stdout.",
+					default: false
+				}
+			},
+			async run({ args }) {
+				const session = await readSession();
+				if (!session) {
+					emitNotAuthenticated(args.json);
+					return exitAfterFlush(ExitCode.NotAuthenticated);
+				}
+				try {
+					const tree = await fetchImpressionCategoryList(session.cookies);
+					const filtered = args.selectable ? tree.filter((g) => g.categoryGroup.isSelectable).map((g) => ({
+						...g,
+						categoryList: g.categoryList.filter((c) => c.isSelectable).map((c) => ({
+							...c,
+							subCategoryList: c.subCategoryList.filter((s) => s.isSelectable)
+						}))
+					})) : tree;
+					if (args.json) {
+						emitJson({
+							ok: true,
+							categories: filtered
+						});
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					for (const g of filtered) {
+						const mark = g.categoryGroup.isSelectable ? "" : " (not selectable)";
+						process.stdout.write(`[${g.categoryGroup.id}] ${g.categoryGroup.name}${mark}\n`);
+						for (const c of g.categoryList) {
+							const cmark = c.isSelectable ? "" : " (not selectable)";
+							process.stdout.write(`  ${c.id}\t${c.name}${cmark}\n`);
+							for (const s of c.subCategoryList) {
+								const smark = s.isSelectable ? "" : " (not selectable)";
+								process.stdout.write(`    ${s.id}\t${s.name}${smark}\n`);
+							}
+						}
+					}
+					return exitAfterFlush(ExitCode.Ok);
+				} catch (err) {
+					return emitFailureFromError(args.json, err);
+				}
 			}
-		},
-		async run({ args }) {
-			const ctx = await resolveWorkspaceContext(args);
-			if (!ctx) return;
-			const { session, workspaceId } = ctx;
-			try {
-				const keys = await fetchApiKeys(workspaceId, session.cookies);
-				if (args.json) {
-					emitJson({
-						ok: true,
-						workspaceId,
-						keys: keys.map((k) => ({
-							id: k.id,
-							name: k.name ?? null,
-							extra: k.extra
-						})),
-						...keys.length === 0 ? { needsKey: true } : {}
+		}),
+		"service-status": defineCommand({
+			meta: {
+				name: "service-status",
+				description: "Show the server-authoritative runtime status of a mini-app (serviceStatus, shutdown schedule)."
+			},
+			args: {
+				id: {
+					type: "positional",
+					description: "Mini-app ID.",
+					required: true
+				},
+				workspace: {
+					type: "string",
+					description: "Workspace ID. Defaults to the selected workspace."
+				},
+				json: {
+					type: "boolean",
+					description: "Emit machine-readable JSON.",
+					default: false
+				}
+			},
+			async run({ args }) {
+				const appId = parseAppId(args.id);
+				if (appId === null) {
+					if (args.json) emitJson({
+						ok: false,
+						reason: "invalid-id",
+						message: `app id must be a positive integer (got ${JSON.stringify(args.id)})`
 					});
-					return exitAfterFlush(ExitCode.Ok);
+					else process.stderr.write(`app service-status: invalid id ${JSON.stringify(args.id)}\n`);
+					return exitAfterFlush(ExitCode.Usage);
 				}
-				if (keys.length === 0) {
-					process.stdout.write(`No API keys in workspace ${workspaceId}.\n`);
-					process.stderr.write("Hint: issue a key from the console UI (API 키 → 발급받기) to enable deploy automation.\n");
+				const ctx = await resolveWorkspaceContext(args);
+				if (!ctx) return;
+				const { session, workspaceId } = ctx;
+				try {
+					const st = await fetchAppServiceStatus(workspaceId, appId, session.cookies);
+					if (args.json) {
+						emitJson({
+							ok: true,
+							workspaceId,
+							appId,
+							...st
+						});
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					process.stdout.write(`App ${appId} (ws ${workspaceId}):\n`);
+					process.stdout.write(`  serviceStatus: ${st.serviceStatus}\n`);
+					process.stdout.write(`  shutdownCandidateStatus: ${st.shutdownCandidateStatus ?? "null"}\n`);
+					process.stdout.write(`  scheduledShutdownAt: ${st.scheduledShutdownAt ?? "null"}\n`);
 					return exitAfterFlush(ExitCode.Ok);
+				} catch (err) {
+					return emitFailureFromError(args.json, err);
 				}
-				process.stdout.write(`${keys.length} API key(s) in workspace ${workspaceId}:\n`);
-				for (const k of keys) {
-					const name = k.name ?? "(unnamed)";
-					process.stdout.write(`${k.id}\t${name}\n`);
+			}
+		}),
+		register: defineCommand({
+			meta: {
+				name: "register",
+				description: "Register a mini-app in the selected workspace from a YAML/JSON manifest. Uploads logo/thumbnail/screenshots, then submits the create payload."
+			},
+			args: {
+				workspace: {
+					type: "string",
+					description: "Workspace ID. Defaults to the selected workspace (`aitcc workspace use`)."
+				},
+				config: {
+					type: "string",
+					description: "Path to the app manifest. Defaults to `./aitcc.app.yaml`, then `./aitcc.app.json`."
+				},
+				"dry-run": {
+					type: "boolean",
+					description: "Validate manifest + images and print the inferred submit payload; no uploads.",
+					default: false
+				},
+				"accept-terms": {
+					type: "boolean",
+					description: "Attest to the required console legal-agreement checkboxes (see VALIDATION-RULES.md). Required for real submits.",
+					default: false
+				},
+				json: {
+					type: "boolean",
+					description: "Emit machine-readable JSON to stdout.",
+					default: false
 				}
-				return exitAfterFlush(ExitCode.Ok);
-			} catch (err) {
-				return emitFailureFromError(args.json, err);
+			},
+			async run({ args }) {
+				await runRegister({
+					json: args.json,
+					dryRun: args["dry-run"],
+					acceptTerms: args["accept-terms"],
+					...args.workspace !== void 0 ? { workspace: args.workspace } : {},
+					...args.config !== void 0 ? { config: args.config } : {}
+				});
 			}
-		}
-	}) }
+		})
+	}
 });
 //#endregion
-//#region src/api/me.ts
-const MEMBER_USER_INFO_URL = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole/members/me/user-info";
-async function fetchConsoleMemberUserInfo(cookies, opts = {}) {
-	return requestConsoleApi({
-		url: MEMBER_USER_INFO_URL,
-		cookies,
+//#region src/commands/completion.ts
+const TOP_LEVEL = [
+	"whoami",
+	"login",
+	"logout",
+	"upgrade",
+	"workspace",
+	"app",
+	"members",
+	"keys",
+	"notices",
+	"me",
+	"completion"
+];
+const SUB_COMMANDS = {
+	workspace: [
+		"ls",
+		"partner",
+		"segments",
+		"show",
+		"terms",
+		"use"
+	],
+	app: [
+		"bundles",
+		"categories",
+		"certs",
+		"events",
+		"ls",
+		"messages",
+		"metrics",
+		"ratings",
+		"register",
+		"reports",
+		"service-status",
+		"share-rewards",
+		"show",
+		"status",
+		"templates"
+	],
+	notices: [
+		"categories",
+		"ls",
+		"show"
+	],
+	me: ["terms"],
+	completion: [
+		"bash",
+		"zsh",
+		"fish"
+	]
+};
+function emitBash() {
+	const top = TOP_LEVEL.join(" ");
+	const cases = [];
+	for (const [ns, subs] of Object.entries(SUB_COMMANDS)) {
+		cases.push(`    ${ns})`);
+		cases.push(`      COMPREPLY=( $(compgen -W "${subs.join(" ")}" -- "$cur") )`);
+		cases.push("      return 0 ;;");
+	}
+	return `# bash completion for aitcc. Generated by \`aitcc completion bash\`.
+# Install:
+#   aitcc completion bash > /etc/bash_completion.d/aitcc
+#   # or add to ~/.bashrc:
+#   source <(aitcc completion bash)
+
+_aitcc_completion() {
+  local cur prev
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+
+  if [[ $COMP_CWORD -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "${top}" -- "$cur") )
+    return 0
+  fi
+
+  case "\${COMP_WORDS[1]}" in
+${cases.join("\n")}
+  esac
+
+  return 0
+}
+
+complete -F _aitcc_completion aitcc
+`;
+}
+function emitZsh() {
+	const top = TOP_LEVEL.join(" ");
+	const nsClauses = [];
+	for (const [ns, subs] of Object.entries(SUB_COMMANDS)) nsClauses.push(`      ${ns}) _values 'subcommand' ${subs.map((s) => `'${s}'`).join(" ")} ;;`);
+	return `#compdef aitcc
+# zsh completion for aitcc. Generated by \`aitcc completion zsh\`.
+# Install:
+#   aitcc completion zsh > "\${fpath[1]}/_aitcc"
+#   # then in a fresh shell (or run \`autoload -U compinit && compinit\`)
+
+_aitcc() {
+  local -a commands
+  commands=(${TOP_LEVEL.map((c) => `'${c}'`).join(" ")})
+
+  if (( CURRENT == 2 )); then
+    _values 'command' ${TOP_LEVEL.map((c) => `'${c}'`).join(" ")}
+    return
+  fi
+
+  case "\${words[2]}" in
+${nsClauses.join("\n")}
+  esac
+}
+
+_aitcc "$@"
+# ${top}
+`;
+}
+function emitFish() {
+	const lines = [
+		"# fish completion for aitcc. Generated by `aitcc completion fish`.",
+		"# Install:",
+		"#   aitcc completion fish > ~/.config/fish/completions/aitcc.fish",
+		""
+	];
+	for (const c of TOP_LEVEL) lines.push(`complete -c aitcc -n "__fish_use_subcommand" -a "${c}" -f`);
+	for (const [ns, subs] of Object.entries(SUB_COMMANDS)) for (const s of subs) lines.push(`complete -c aitcc -n "__fish_seen_subcommand_from ${ns}" -a "${s}" -f`);
+	return `${lines.join("\n")}\n`;
+}
+const completionCommand = defineCommand({
+	meta: {
+		name: "completion",
+		description: "Emit a shell completion script for bash, zsh, or fish."
+	},
+	args: {
+		shell: {
+			type: "positional",
+			description: "Target shell: bash, zsh, or fish.",
+			required: false
+		},
+		json: {
+			type: "boolean",
+			description: "Emit { ok: false, reason: 'invalid-shell' } on bad input.",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const raw = args.shell === void 0 ? "" : String(args.shell).toLowerCase();
+		if (raw === "bash") {
+			process.stdout.write(emitBash());
+			return exitAfterFlush(ExitCode.Ok);
+		}
+		if (raw === "zsh") {
+			process.stdout.write(emitZsh());
+			return exitAfterFlush(ExitCode.Ok);
+		}
+		if (raw === "fish") {
+			process.stdout.write(emitFish());
+			return exitAfterFlush(ExitCode.Ok);
+		}
+		if (args.json) emitJson({
+			ok: false,
+			reason: "invalid-shell",
+			allowed: [
+				"bash",
+				"zsh",
+				"fish"
+			],
+			message: `completion shell must be one of: bash, zsh, fish (got ${JSON.stringify(raw)})`
+		});
+		else process.stderr.write("Usage: aitcc completion <bash|zsh|fish>\n\nExamples:\n  aitcc completion bash > /etc/bash_completion.d/aitcc\n  aitcc completion zsh  > \"${fpath[1]}/_aitcc\"\n  aitcc completion fish > ~/.config/fish/completions/aitcc.fish\n");
+		return exitAfterFlush(ExitCode.Usage);
+	}
+});
+//#endregion
+//#region src/api/api-keys.ts
+const BASE$3 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
+async function fetchApiKeys(workspaceId, cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${BASE$3}/workspaces/${workspaceId}/api-keys`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (!Array.isArray(raw)) throw new Error(`Unexpected api-keys shape for workspace=${workspaceId}: not an array`);
+	return raw.map((entry, index) => normalizeKey(entry, workspaceId, index));
+}
+function normalizeKey(raw, workspaceId, index) {
+	if (raw === null || typeof raw !== "object") throw new Error(`Unexpected api-key entry at index ${index} for workspace=${workspaceId}: not an object`);
+	const rec = raw;
+	const rawId = rec.id ?? rec.apiKeyId ?? rec.keyId;
+	if (typeof rawId !== "string" && typeof rawId !== "number") throw new Error(`Unexpected api-key entry at index ${index} for workspace=${workspaceId}: missing id`);
+	const rawName = rec.name ?? rec.apiKeyName ?? rec.keyName ?? rec.description;
+	const name = typeof rawName === "string" ? rawName : void 0;
+	const { id: _id, apiKeyId: _aid, keyId: _kid, name: _n, apiKeyName: _an, keyName: _kn, description: _d, ...extra } = rec;
+	return {
+		id: rawId,
+		name,
+		extra
+	};
+}
+const keysCommand = defineCommand({
+	meta: {
+		name: "keys",
+		description: "Inspect console API keys used for deploy automation."
+	},
+	subCommands: { ls: defineCommand({
+		meta: {
+			name: "ls",
+			description: "List console API keys in the selected workspace."
+		},
+		args: {
+			workspace: {
+				type: "string",
+				description: "Workspace ID. Defaults to the selected workspace (`aitcc workspace use`)."
+			},
+			json: {
+				type: "boolean",
+				description: "Emit machine-readable JSON to stdout.",
+				default: false
+			}
+		},
+		async run({ args }) {
+			const ctx = await resolveWorkspaceContext(args);
+			if (!ctx) return;
+			const { session, workspaceId } = ctx;
+			try {
+				const keys = await fetchApiKeys(workspaceId, session.cookies);
+				if (args.json) {
+					emitJson({
+						ok: true,
+						workspaceId,
+						keys: keys.map((k) => ({
+							id: k.id,
+							name: k.name ?? null,
+							extra: k.extra
+						})),
+						...keys.length === 0 ? { needsKey: true } : {}
+					});
+					return exitAfterFlush(ExitCode.Ok);
+				}
+				if (keys.length === 0) {
+					process.stdout.write(`No API keys in workspace ${workspaceId}.\n`);
+					process.stderr.write("Hint: issue a key from the console UI (API 키 → 발급받기) to enable deploy automation.\n");
+					return exitAfterFlush(ExitCode.Ok);
+				}
+				process.stdout.write(`${keys.length} API key(s) in workspace ${workspaceId}:\n`);
+				for (const k of keys) {
+					const name = k.name ?? "(unnamed)";
+					process.stdout.write(`${k.id}\t${name}\n`);
+				}
+				return exitAfterFlush(ExitCode.Ok);
+			} catch (err) {
+				return emitFailureFromError(args.json, err);
+			}
+		}
+	}) }
+});
+//#endregion
+//#region src/api/me.ts
+const BASE$2 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
+const MEMBER_USER_INFO_URL = `${BASE$2}/members/me/user-info`;
+async function fetchConsoleMemberUserInfo(cookies, opts = {}) {
+	return requestConsoleApi({
+		url: MEMBER_USER_INFO_URL,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+}
+async function fetchUserTerms(cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${BASE$2}/console-user-terms/me`,
+		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
+	if (!Array.isArray(raw)) throw new Error("Unexpected user-terms shape: not an array");
+	return raw.map((entry, i) => {
+		if (!entry || typeof entry !== "object") throw new Error(`Unexpected user-terms entry at index ${i}`);
+		const e = entry;
+		return {
+			required: Boolean(e.required),
+			termsId: typeof e.termsId === "number" ? e.termsId : 0,
+			revisionId: typeof e.revisionId === "number" ? e.revisionId : 0,
+			title: typeof e.title === "string" ? e.title : "",
+			contentsUrl: typeof e.contentsUrl === "string" ? e.contentsUrl : "",
+			actionType: typeof e.actionType === "string" ? e.actionType : "",
+			isAgreed: Boolean(e.isAgreed),
+			isOneTimeConsent: Boolean(e.isOneTimeConsent)
+		};
+	});
 }
 //#endregion
 //#region src/cdp.ts
@@ -3054,6 +3910,54 @@ const logoutCommand = defineCommand({
 	}
 });
 //#endregion
+//#region src/commands/me.ts
+function formatTermLine(t) {
+	return `  ${t.isAgreed ? "[agreed]" : "[pending]"}${t.required ? " required" : ""}  ${t.title}\n    ${t.contentsUrl}\n`;
+}
+const meCommand = defineCommand({
+	meta: {
+		name: "me",
+		description: "Inspect account-level settings for the signed-in user."
+	},
+	subCommands: { terms: defineCommand({
+		meta: {
+			name: "terms",
+			description: "Show the console-level terms of agreement for the signed-in account."
+		},
+		args: { json: {
+			type: "boolean",
+			description: "Emit machine-readable JSON to stdout.",
+			default: false
+		} },
+		async run({ args }) {
+			const session = await readSession();
+			if (!session) {
+				emitNotAuthenticated(args.json);
+				return exitAfterFlush(ExitCode.NotAuthenticated);
+			}
+			try {
+				const terms = await fetchUserTerms(session.cookies);
+				if (args.json) {
+					emitJson({
+						ok: true,
+						terms
+					});
+					return exitAfterFlush(ExitCode.Ok);
+				}
+				if (terms.length === 0) {
+					process.stdout.write("No console-level terms required.\n");
+					return exitAfterFlush(ExitCode.Ok);
+				}
+				process.stdout.write("Console account terms:\n");
+				for (const t of terms) process.stdout.write(formatTermLine(t));
+				return exitAfterFlush(ExitCode.Ok);
+			} catch (err) {
+				return emitFailureFromError(args.json, err);
+			}
+		}
+	}) }
+});
+//#endregion
 //#region src/api/members.ts
 const BASE$1 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
 async function fetchWorkspaceMembers(workspaceId, cookies, opts = {}) {
@@ -3391,507 +4295,824 @@ const noticesCommand = defineCommand({
 					return emitFailureFromError(args.json, err);
 				}
 			}
-		})
+		})
+	}
+});
+//#endregion
+//#region src/github.ts
+const REPO_OWNER = "apps-in-toss-community";
+const REPO_NAME = "console-cli";
+function defaultHeaders() {
+	const headers = {
+		Accept: "application/vnd.github+json",
+		"User-Agent": "aitcc",
+		"X-GitHub-Api-Version": "2022-11-28"
+	};
+	const token = process.env.GITHUB_TOKEN;
+	if (token && token.length > 0) headers.Authorization = `Bearer ${token}`;
+	return headers;
+}
+async function fetchLatestRelease() {
+	const url = `https://api.github.com/repos/${REPO_OWNER}/${REPO_NAME}/releases/latest`;
+	const res = await fetch(url, { headers: defaultHeaders() });
+	if (!res.ok) throw new Error(`GitHub releases/latest returned ${res.status} ${res.statusText}`);
+	return await res.json();
+}
+/**
+* Conditional GET against `releases/latest`. If the server returns 304 we
+* learn "no change" without consuming a core rate-limit slot. Intended for
+* the background update check, which re-runs often; `fetchLatestRelease()`
+* remains the right call when the upgrade command actually needs the body.
+*/
+async function fetchLatestReleaseConditional(previousEtag) {
+	const url = `https://api.github.com/repos/${REPO_OWNER}/${REPO_NAME}/releases/latest`;
+	const headers = defaultHeaders();
+	if (previousEtag && previousEtag.length > 0) headers["If-None-Match"] = previousEtag;
+	const res = await fetch(url, { headers });
+	const etag = res.headers.get("etag") ?? void 0;
+	if (res.status === 304) return {
+		status: "not-modified",
+		etag
+	};
+	if (!res.ok) throw new Error(`GitHub releases/latest returned ${res.status} ${res.statusText}`);
+	return {
+		status: "updated",
+		release: await res.json(),
+		etag
+	};
+}
+function versionFromTag(tag) {
+	const at = tag.lastIndexOf("@");
+	const candidate = at >= 0 ? tag.slice(at + 1) : tag;
+	return candidate.startsWith("v") ? candidate.slice(1) : candidate;
+}
+//#endregion
+//#region src/platform.ts
+function detectPlatform() {
+	let os;
+	switch (process.platform) {
+		case "linux":
+			os = "linux";
+			break;
+		case "darwin":
+			os = "darwin";
+			break;
+		case "win32":
+			os = "windows";
+			break;
+		default: return null;
+	}
+	let arch;
+	switch (process.arch) {
+		case "x64":
+			arch = "x64";
+			break;
+		case "arm64":
+			arch = "arm64";
+			break;
+		default: return null;
+	}
+	if (os === "windows" && arch === "arm64") return null;
+	return {
+		os,
+		arch,
+		assetName: `aitcc-${os}-${arch}${os === "windows" ? ".exe" : ""}`
+	};
+}
+//#endregion
+//#region src/semver.ts
+function parseSemver(v) {
+	const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?/.exec(v);
+	if (!m) return null;
+	return {
+		major: +m[1],
+		minor: +m[2],
+		patch: +m[3],
+		pre: m[4] ?? ""
+	};
+}
+function compareSemver(a, b) {
+	const pa = parseSemver(a);
+	const pb = parseSemver(b);
+	if (!pa || !pb) return 0;
+	if (pa.major !== pb.major) return pa.major > pb.major ? 1 : -1;
+	if (pa.minor !== pb.minor) return pa.minor > pb.minor ? 1 : -1;
+	if (pa.patch !== pb.patch) return pa.patch > pb.patch ? 1 : -1;
+	if (pa.pre === pb.pre) return 0;
+	if (pa.pre === "") return 1;
+	if (pb.pre === "") return -1;
+	return pa.pre > pb.pre ? 1 : -1;
+}
+//#endregion
+//#region src/version.ts
+function resolveVersion() {
+	try {
+		const injected = globalThis.AITCC_VERSION;
+		if (typeof injected === "string" && injected.length > 0) return injected;
+	} catch {}
+	try {
+		return "0.1.14";
+	} catch {}
+	return "0.0.0-dev";
+}
+const VERSION = resolveVersion();
+//#endregion
+//#region src/commands/upgrade.ts
+function isStandaloneBinary() {
+	return basename(process.execPath).toLowerCase().startsWith("aitcc");
+}
+const upgradeCommand = defineCommand({
+	meta: {
+		name: "upgrade",
+		description: "Download the latest release binary from GitHub and replace the current one."
+	},
+	args: {
+		json: {
+			type: "boolean",
+			description: "Emit machine-readable JSON to stdout.",
+			default: false
+		},
+		force: {
+			type: "boolean",
+			description: "Re-install even if already on the latest version.",
+			default: false
+		},
+		"dry-run": {
+			type: "boolean",
+			description: "Check for updates without downloading or replacing.",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const emit = (payload, human) => {
+			if (args.json) process.stdout.write(`${JSON.stringify(payload)}\n`);
+			else process.stdout.write(`${human}\n`);
+		};
+		const emitError = (payload, human) => {
+			if (args.json) process.stdout.write(`${JSON.stringify({
+				ok: false,
+				...payload
+			})}\n`);
+			else process.stderr.write(`${human}\n`);
+		};
+		let release;
+		try {
+			release = await fetchLatestRelease();
+		} catch (err) {
+			emitError({
+				reason: "network-error",
+				message: err.message
+			}, `Failed to query GitHub releases: ${err.message}`);
+			process.exit(ExitCode.NetworkError);
+		}
+		const latest = versionFromTag(release.tag_name);
+		const current = VERSION;
+		if (!(compareSemver(latest, current) > 0 || args.force)) {
+			emit({
+				ok: true,
+				status: "already-latest",
+				current,
+				latest
+			}, `Already on the latest version (${current}).`);
+			process.exit(ExitCode.UpgradeAlreadyLatest);
+		}
+		if (args["dry-run"]) {
+			emit({
+				ok: true,
+				status: "update-available",
+				current,
+				latest,
+				url: release.html_url
+			}, `Update available: ${current} → ${latest}\n${release.html_url}`);
+			return;
+		}
+		if (!isStandaloneBinary()) {
+			emitError({
+				reason: "not-standalone",
+				current,
+				latest,
+				hint: "npm i -g @ait-co/console-cli@latest"
+			}, [
+				"This install was launched via Node, not the standalone binary.",
+				"Self-upgrade is only supported for the compiled binary.",
+				`Run: npm i -g @ait-co/console-cli@latest  (currently ${current}, latest ${latest})`
+			].join("\n"));
+			process.exit(ExitCode.UpgradeUnavailable);
+		}
+		const platform = detectPlatform();
+		if (!platform) {
+			emitError({
+				reason: "unsupported-platform",
+				platform: process.platform,
+				arch: process.arch
+			}, `No prebuilt binary for ${process.platform}/${process.arch}.`);
+			process.exit(ExitCode.UpgradeUnavailable);
+		}
+		const asset = release.assets.find((a) => a.name === platform.assetName);
+		if (!asset) {
+			emitError({
+				reason: "asset-missing",
+				assetName: platform.assetName,
+				tag: release.tag_name
+			}, `Release ${release.tag_name} has no asset named ${platform.assetName}. It may still be uploading.`);
+			process.exit(ExitCode.UpgradeUnavailable);
+		}
+		const exePath = process.execPath;
+		const stagingPath = `${exePath}.new.${Date.now()}`;
+		if (!args.json) process.stdout.write(`Downloading ${asset.name} (${latest})...\n`);
+		try {
+			const res = await fetch(asset.browser_download_url);
+			if (!res.ok || !res.body) throw new Error(`Download failed: ${res.status} ${res.statusText}`);
+			await writeFile(stagingPath, new Uint8Array(await res.arrayBuffer()), { mode: 493 });
+			await chmod(stagingPath, 493);
+		} catch (err) {
+			emitError({
+				reason: "download-failed",
+				message: err.message
+			}, `Failed to download new binary: ${err.message}`);
+			process.exit(ExitCode.NetworkError);
+		}
+		try {
+			if (process.platform === "win32") {
+				await rename(exePath, `${exePath}.old`);
+				await rename(stagingPath, exePath);
+			} else await rename(stagingPath, exePath);
+		} catch (err) {
+			emitError({
+				reason: "replace-failed",
+				message: err.message,
+				exePath,
+				stagingPath
+			}, `Failed to replace binary at ${exePath}: ${err.message}`);
+			process.exit(ExitCode.Generic);
+		}
+		emit({
+			ok: true,
+			status: "upgraded",
+			from: current,
+			to: latest,
+			installedAt: exePath,
+			installedIn: dirname(exePath)
+		}, `Upgraded aitcc: ${current} → ${latest}`);
+	}
+});
+//#endregion
+//#region src/update-check.ts
+const UPDATE_CHECK_INTERVAL_MS = 1440 * 60 * 1e3;
+async function readCache() {
+	let raw;
+	try {
+		raw = await readFile(upgradeCheckPath(), "utf8");
+	} catch {
+		return null;
+	}
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		return null;
+	}
+	if (!parsed || typeof parsed !== "object") return null;
+	const obj = parsed;
+	if (typeof obj.lastCheckedAt !== "string") return null;
+	if (obj.latestTag !== void 0 && typeof obj.latestTag !== "string") return null;
+	if (obj.etag !== void 0 && typeof obj.etag !== "string") return null;
+	return {
+		lastCheckedAt: obj.lastCheckedAt,
+		...obj.latestTag !== void 0 ? { latestTag: obj.latestTag } : {},
+		...obj.etag !== void 0 ? { etag: obj.etag } : {}
+	};
+}
+async function writeCache(entry) {
+	const path = upgradeCheckPath();
+	await mkdir(dirname(path), { recursive: true });
+	const tmp = `${path}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2, 10)}.tmp`;
+	try {
+		await writeFile(tmp, JSON.stringify(entry, null, 2), { mode: 384 });
+		await rename(tmp, path);
+	} catch (err) {
+		await unlink(tmp).catch(() => {});
+		throw err;
+	}
+}
+/** Has the throttle window elapsed since the last recorded check? */
+function isDueForCheck(cache, now = Date.now(), intervalMs = UPDATE_CHECK_INTERVAL_MS) {
+	if (!cache) return true;
+	const last = Date.parse(cache.lastCheckedAt);
+	if (!Number.isFinite(last)) return true;
+	if (now < last) return true;
+	return now - last >= intervalMs;
+}
+/**
+* Perform the throttled update check. Returns the final cache entry (for
+* testing) or null when skipped. Never throws — network errors are
+* intentionally swallowed so they never interrupt the foreground command.
+*/
+async function maybeCheckForUpdate(opts = {}) {
+	const env = opts.env ?? process.env;
+	const isTTY = opts.isTTY ?? Boolean(process.stderr.isTTY);
+	const now = opts.now ?? Date.now();
+	const intervalMs = opts.intervalMs ?? 864e5;
+	const optOut = env.AITCC_NO_UPDATE_CHECK;
+	if (optOut && optOut !== "0" && optOut.toLowerCase() !== "false") return null;
+	if (!isTTY) return null;
+	const cache = await readCache();
+	if (!isDueForCheck(cache, now, intervalMs)) return null;
+	const nowIso = new Date(now).toISOString();
+	const placeholder = {
+		lastCheckedAt: nowIso,
+		...cache?.latestTag !== void 0 ? { latestTag: cache.latestTag } : {},
+		...cache?.etag !== void 0 ? { etag: cache.etag } : {}
+	};
+	await writeCache(placeholder).catch(() => {});
+	const previousEtag = cache?.etag;
+	let entry = placeholder;
+	try {
+		const result = await fetchLatestReleaseConditional(previousEtag);
+		if (result.status === "not-modified") entry = {
+			lastCheckedAt: nowIso,
+			...cache?.latestTag !== void 0 ? { latestTag: cache.latestTag } : {},
+			...result.etag !== void 0 ? { etag: result.etag } : cache?.etag !== void 0 ? { etag: cache.etag } : {}
+		};
+		else entry = {
+			lastCheckedAt: nowIso,
+			latestTag: result.release.tag_name,
+			...result.etag !== void 0 ? { etag: result.etag } : {}
+		};
+		await writeCache(entry).catch(() => {});
+	} catch {}
+	maybeEmitNotice(entry, env);
+	return entry;
+}
+function maybeEmitNotice(entry, env) {
+	if (!entry.latestTag) return;
+	if (VERSION.startsWith("0.0.0-dev")) return;
+	const latest = versionFromTag(entry.latestTag);
+	if (!latest) return;
+	if (compareSemver(latest, VERSION) <= 0) return;
+	const dim = env.NO_COLOR ? "" : "\x1B[2m";
+	const reset = env.NO_COLOR ? "" : "\x1B[0m";
+	process.stderr.write(`\n${dim}(aitcc ${latest} is available — run \`aitcc upgrade\` to install)${reset}\n`);
+}
+//#endregion
+//#region src/commands/whoami.ts
+async function runBackgroundUpdateCheck(json) {
+	if (json) return;
+	const timeoutMs = 500;
+	await Promise.race([maybeCheckForUpdate().catch(() => null), new Promise((resolve) => {
+		const t = setTimeout(() => resolve(null), timeoutMs);
+		if (typeof t.unref === "function") t.unref();
+	})]);
+}
+const whoamiCommand = defineCommand({
+	meta: {
+		name: "whoami",
+		description: "Show the currently authenticated user (live from the console API by default)."
+	},
+	args: {
+		json: {
+			type: "boolean",
+			description: "Emit machine-readable JSON to stdout.",
+			default: false
+		},
+		offline: {
+			type: "boolean",
+			description: "Skip the live API call and read only the cached session summary.",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const session = await readSession();
+		if (!session) {
+			if (args.json) process.stdout.write(`${JSON.stringify({
+				ok: true,
+				authenticated: false
+			})}\n`);
+			else {
+				process.stderr.write("Not logged in. Run `aitcc login` to start a session.\n");
+				process.stderr.write(`Session file checked: ${sessionPathForDiagnostics()}\n`);
+			}
+			return exitAfterFlush(ExitCode.NotAuthenticated);
+		}
+		if (args.offline) {
+			if (args.json) {
+				process.stdout.write(`${JSON.stringify({
+					ok: true,
+					authenticated: true,
+					source: "cache",
+					user: session.user,
+					capturedAt: session.capturedAt
+				})}\n`);
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			const label = session.user.displayName ? `${session.user.displayName} <${session.user.email}>` : session.user.email;
+			process.stdout.write(`Logged in as ${label} (cached)\n`);
+			process.stdout.write(`Session captured: ${session.capturedAt}\n`);
+			await runBackgroundUpdateCheck(args.json);
+			return exitAfterFlush(ExitCode.Ok);
+		}
+		try {
+			const info = await fetchConsoleMemberUserInfo(session.cookies);
+			if (args.json) {
+				process.stdout.write(`${JSON.stringify({
+					ok: true,
+					authenticated: true,
+					source: "live",
+					user: {
+						id: String(info.id),
+						bizUserNo: info.bizUserNo,
+						name: info.name,
+						email: info.email,
+						role: info.role
+					},
+					workspaces: info.workspaces.map((w) => ({
+						workspaceId: w.workspaceId,
+						workspaceName: w.workspaceName,
+						role: w.role
+					})),
+					capturedAt: session.capturedAt
+				})}\n`);
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			process.stdout.write(`Logged in as ${info.name} <${info.email}> (${info.role})\n`);
+			if (info.workspaces.length > 0) {
+				process.stdout.write("Workspaces:\n");
+				for (const w of info.workspaces) process.stdout.write(`  - ${w.workspaceName} (id ${w.workspaceId}, ${w.role})\n`);
+			}
+			await runBackgroundUpdateCheck(args.json);
+			return exitAfterFlush(ExitCode.Ok);
+		} catch (err) {
+			if (err instanceof TossApiError && err.isAuthError) {
+				if (args.json) process.stdout.write(`${JSON.stringify({
+					ok: true,
+					authenticated: false,
+					reason: "session-expired",
+					errorCode: err.errorCode
+				})}\n`);
+				else process.stderr.write("Session is no longer valid. Run `aitcc login` again.\n");
+				return exitAfterFlush(ExitCode.NotAuthenticated);
+			}
+			if (err instanceof NetworkError) {
+				if (args.json) process.stdout.write(`${JSON.stringify({
+					ok: false,
+					reason: "network-error",
+					message: err.message
+				})}\n`);
+				else process.stderr.write(`Network error reaching the console API: ${err.message}. Use \`aitcc whoami --offline\` for the cached identity.\n`);
+				return exitAfterFlush(ExitCode.NetworkError);
+			}
+			if (args.json) process.stdout.write(`${JSON.stringify({
+				ok: false,
+				reason: "api-error",
+				message: err.message
+			})}\n`);
+			else process.stderr.write(`Unexpected error: ${err.message}\n`);
+			return exitAfterFlush(ExitCode.ApiError);
+		}
 	}
 });
 //#endregion
-//#region src/github.ts
-const REPO_OWNER = "apps-in-toss-community";
-const REPO_NAME = "console-cli";
-function defaultHeaders() {
-	const headers = {
-		Accept: "application/vnd.github+json",
-		"User-Agent": "aitcc",
-		"X-GitHub-Api-Version": "2022-11-28"
-	};
-	const token = process.env.GITHUB_TOKEN;
-	if (token && token.length > 0) headers.Authorization = `Bearer ${token}`;
-	return headers;
-}
-async function fetchLatestRelease() {
-	const url = `https://api.github.com/repos/${REPO_OWNER}/${REPO_NAME}/releases/latest`;
-	const res = await fetch(url, { headers: defaultHeaders() });
-	if (!res.ok) throw new Error(`GitHub releases/latest returned ${res.status} ${res.statusText}`);
-	return await res.json();
-}
-/**
-* Conditional GET against `releases/latest`. If the server returns 304 we
-* learn "no change" without consuming a core rate-limit slot. Intended for
-* the background update check, which re-runs often; `fetchLatestRelease()`
-* remains the right call when the upgrade command actually needs the body.
-*/
-async function fetchLatestReleaseConditional(previousEtag) {
-	const url = `https://api.github.com/repos/${REPO_OWNER}/${REPO_NAME}/releases/latest`;
-	const headers = defaultHeaders();
-	if (previousEtag && previousEtag.length > 0) headers["If-None-Match"] = previousEtag;
-	const res = await fetch(url, { headers });
-	const etag = res.headers.get("etag") ?? void 0;
-	if (res.status === 304) return {
-		status: "not-modified",
-		etag
-	};
-	if (!res.ok) throw new Error(`GitHub releases/latest returned ${res.status} ${res.statusText}`);
+//#region src/api/workspaces.ts
+const WORKSPACES_BASE = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
+async function fetchWorkspaceDetail(workspaceId, cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${WORKSPACES_BASE}/workspaces/${workspaceId}`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	const id = raw.id;
+	const name = raw.name;
+	if (typeof id !== "number" || !Number.isInteger(id) || id <= 0 || typeof name !== "string") throw new Error(`Unexpected workspace detail shape for id=${workspaceId}`);
+	const { id: _id, name: _name, ...extra } = raw;
 	return {
-		status: "updated",
-		release: await res.json(),
-		etag
+		workspaceId: id,
+		workspaceName: name,
+		extra
 	};
 }
-function versionFromTag(tag) {
-	const at = tag.lastIndexOf("@");
-	const candidate = at >= 0 ? tag.slice(at + 1) : tag;
-	return candidate.startsWith("v") ? candidate.slice(1) : candidate;
-}
-//#endregion
-//#region src/platform.ts
-function detectPlatform() {
-	let os;
-	switch (process.platform) {
-		case "linux":
-			os = "linux";
-			break;
-		case "darwin":
-			os = "darwin";
-			break;
-		case "win32":
-			os = "windows";
-			break;
-		default: return null;
-	}
-	let arch;
-	switch (process.arch) {
-		case "x64":
-			arch = "x64";
-			break;
-		case "arm64":
-			arch = "arm64";
-			break;
-		default: return null;
-	}
-	if (os === "windows" && arch === "arm64") return null;
+async function fetchWorkspacePartner(workspaceId, cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${WORKSPACES_BASE}/workspaces/${workspaceId}/partner`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	const registered = raw.registered;
+	if (typeof registered !== "boolean") throw new Error(`Unexpected workspace partner shape for id=${workspaceId}`);
 	return {
-		os,
-		arch,
-		assetName: `aitcc-${os}-${arch}${os === "windows" ? ".exe" : ""}`
+		registered,
+		approvalType: typeof raw.approvalType === "string" ? raw.approvalType : null,
+		rejectMessage: typeof raw.rejectMessage === "string" ? raw.rejectMessage : null,
+		partner: raw.partner && typeof raw.partner === "object" ? raw.partner : null
 	};
 }
-//#endregion
-//#region src/semver.ts
-function parseSemver(v) {
-	const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?/.exec(v);
-	if (!m) return null;
+const WORKSPACE_TERM_TYPES = [
+	"TOSS_LOGIN",
+	"BIZ_WORKSPACE",
+	"TOSS_PROMOTION_MONEY",
+	"IAA",
+	"IAP"
+];
+const DEFAULT_SEGMENT_CATEGORY = "생성된 세그먼트";
+async function fetchWorkspaceSegments(params, cookies, opts = {}) {
+	const page = params.page ?? 0;
+	const qs = new URLSearchParams();
+	qs.set("category", params.category ?? DEFAULT_SEGMENT_CATEGORY);
+	qs.set("search", params.search ?? "");
+	qs.set("page", String(page));
+	const raw = await requestConsoleApi({
+		url: `${WORKSPACES_BASE}/workspaces/${params.workspaceId}/segments/list?${qs.toString()}`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Unexpected segments shape for workspace=${params.workspaceId}`);
+	const data = raw;
 	return {
-		major: +m[1],
-		minor: +m[2],
-		patch: +m[3],
-		pre: m[4] ?? ""
+		contents: (Array.isArray(data.contents) ? data.contents : []).map((c) => c && typeof c === "object" ? c : {}),
+		totalPage: typeof data.totalPage === "number" ? data.totalPage : 0,
+		currentPage: typeof data.currentPage === "number" ? data.currentPage : page
 	};
 }
-function compareSemver(a, b) {
-	const pa = parseSemver(a);
-	const pb = parseSemver(b);
-	if (!pa || !pb) return 0;
-	if (pa.major !== pb.major) return pa.major > pb.major ? 1 : -1;
-	if (pa.minor !== pb.minor) return pa.minor > pb.minor ? 1 : -1;
-	if (pa.patch !== pb.patch) return pa.patch > pb.patch ? 1 : -1;
-	if (pa.pre === pb.pre) return 0;
-	if (pa.pre === "") return 1;
-	if (pb.pre === "") return -1;
-	return pa.pre > pb.pre ? 1 : -1;
-}
-//#endregion
-//#region src/version.ts
-function resolveVersion() {
-	try {
-		const injected = globalThis.AITCC_VERSION;
-		if (typeof injected === "string" && injected.length > 0) return injected;
-	} catch {}
-	try {
-		return "0.1.11";
-	} catch {}
-	return "0.0.0-dev";
+async function fetchWorkspaceTerms(workspaceId, type, cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${WORKSPACES_BASE}/workspaces/${workspaceId}/console-workspace-terms/${type}/skip-permission`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (!Array.isArray(raw)) throw new Error(`Unexpected workspace terms shape for type=${type}`);
+	return raw.map((entry, i) => {
+		if (!entry || typeof entry !== "object") throw new Error(`Unexpected workspace terms entry at index ${i} for type=${type}`);
+		const e = entry;
+		return {
+			required: Boolean(e.required),
+			termsId: typeof e.termsId === "number" ? e.termsId : 0,
+			revisionId: typeof e.revisionId === "number" ? e.revisionId : 0,
+			title: typeof e.title === "string" ? e.title : "",
+			contentsUrl: typeof e.contentsUrl === "string" ? e.contentsUrl : "",
+			actionType: typeof e.actionType === "string" ? e.actionType : "",
+			isAgreed: Boolean(e.isAgreed),
+			isOneTimeConsent: Boolean(e.isOneTimeConsent)
+		};
+	});
 }
-const VERSION = resolveVersion();
 //#endregion
-//#region src/commands/upgrade.ts
-function isStandaloneBinary() {
-	return basename(process.execPath).toLowerCase().startsWith("aitcc");
+//#region src/commands/workspace.ts
+function formatScalar(v) {
+	if (v === null) return "null";
+	if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") return String(v);
+	return JSON.stringify(v);
 }
-const upgradeCommand = defineCommand({
+const lsCommand = defineCommand({
 	meta: {
-		name: "upgrade",
-		description: "Download the latest release binary from GitHub and replace the current one."
+		name: "ls",
+		description: "List workspaces the current user has access to."
+	},
+	args: { json: {
+		type: "boolean",
+		description: "Emit machine-readable JSON to stdout.",
+		default: false
+	} },
+	async run({ args }) {
+		const session = await readSession();
+		if (!session) {
+			emitNotAuthenticated(args.json);
+			return exitAfterFlush(ExitCode.NotAuthenticated);
+		}
+		try {
+			const info = await fetchConsoleMemberUserInfo(session.cookies);
+			const current = session.currentWorkspaceId;
+			if (args.json) {
+				emitJson({
+					ok: true,
+					workspaces: info.workspaces.map((w) => ({
+						workspaceId: w.workspaceId,
+						workspaceName: w.workspaceName,
+						role: w.role,
+						current: w.workspaceId === current
+					}))
+				});
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			if (info.workspaces.length === 0) {
+				process.stdout.write("No workspaces.\n");
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			for (const w of info.workspaces) {
+				const marker = w.workspaceId === current ? "* " : "  ";
+				process.stdout.write(`${marker}${w.workspaceId}  ${w.workspaceName}  (${w.role})\n`);
+			}
+			if (current === void 0) process.stderr.write("No workspace selected. Run `aitcc workspace use <id>`.\n");
+			return exitAfterFlush(ExitCode.Ok);
+		} catch (err) {
+			return emitFailureFromError(args.json, err);
+		}
+	}
+});
+const useCommand = defineCommand({
+	meta: {
+		name: "use",
+		description: "Select the current workspace by ID. Subsequent commands use this."
 	},
 	args: {
+		id: {
+			type: "positional",
+			description: "Workspace ID",
+			required: true
+		},
 		json: {
 			type: "boolean",
 			description: "Emit machine-readable JSON to stdout.",
 			default: false
+		}
+	},
+	async run({ args }) {
+		const raw = String(args.id);
+		const parsed = parsePositiveInt$1(raw);
+		if (parsed === null) {
+			const message = `workspace id must be a positive integer (got ${raw})`;
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-id",
+				message
+			});
+			else process.stderr.write(`${message}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const session = await readSession();
+		if (!session) {
+			emitNotAuthenticated(args.json);
+			return exitAfterFlush(ExitCode.NotAuthenticated);
+		}
+		try {
+			const match = (await fetchConsoleMemberUserInfo(session.cookies)).workspaces.find((w) => w.workspaceId === parsed);
+			if (!match) {
+				if (args.json) emitJson({
+					ok: false,
+					reason: "not-found",
+					workspaceId: parsed
+				});
+				else process.stderr.write(`Workspace ${parsed} is not accessible from this account. Run \`aitcc workspace ls\` to see available workspaces.\n`);
+				return exitAfterFlush(ExitCode.Usage);
+			}
+			if (await setCurrentWorkspaceId(parsed) === null) {
+				emitNotAuthenticated(args.json);
+				return exitAfterFlush(ExitCode.NotAuthenticated);
+			}
+			if (args.json) emitJson({
+				ok: true,
+				workspaceId: match.workspaceId,
+				workspaceName: match.workspaceName
+			});
+			else process.stdout.write(`Using workspace ${match.workspaceId} (${match.workspaceName}).\n`);
+			return exitAfterFlush(ExitCode.Ok);
+		} catch (err) {
+			return emitFailureFromError(args.json, err);
+		}
+	}
+});
+const showCommand = defineCommand({
+	meta: {
+		name: "show",
+		description: "Show details of the selected workspace (or the one passed with --workspace)."
+	},
+	args: {
+		workspace: {
+			type: "string",
+			description: "Workspace ID to inspect. Defaults to the selected workspace."
 		},
-		force: {
-			type: "boolean",
-			description: "Re-install even if already on the latest version.",
-			default: false
-		},
-		"dry-run": {
+		json: {
 			type: "boolean",
-			description: "Check for updates without downloading or replacing.",
+			description: "Emit machine-readable JSON to stdout.",
 			default: false
 		}
 	},
 	async run({ args }) {
-		const emit = (payload, human) => {
-			if (args.json) process.stdout.write(`${JSON.stringify(payload)}\n`);
-			else process.stdout.write(`${human}\n`);
-		};
-		const emitError = (payload, human) => {
-			if (args.json) process.stdout.write(`${JSON.stringify({
-				ok: false,
-				...payload
-			})}\n`);
-			else process.stderr.write(`${human}\n`);
-		};
-		let release;
-		try {
-			release = await fetchLatestRelease();
-		} catch (err) {
-			emitError({
-				reason: "network-error",
-				message: err.message
-			}, `Failed to query GitHub releases: ${err.message}`);
-			process.exit(ExitCode.NetworkError);
-		}
-		const latest = versionFromTag(release.tag_name);
-		const current = VERSION;
-		if (!(compareSemver(latest, current) > 0 || args.force)) {
-			emit({
-				ok: true,
-				status: "already-latest",
-				current,
-				latest
-			}, `Already on the latest version (${current}).`);
-			process.exit(ExitCode.UpgradeAlreadyLatest);
-		}
-		if (args["dry-run"]) {
-			emit({
-				ok: true,
-				status: "update-available",
-				current,
-				latest,
-				url: release.html_url
-			}, `Update available: ${current} → ${latest}\n${release.html_url}`);
-			return;
-		}
-		if (!isStandaloneBinary()) {
-			emitError({
-				reason: "not-standalone",
-				current,
-				latest,
-				hint: "npm i -g @ait-co/console-cli@latest"
-			}, [
-				"This install was launched via Node, not the standalone binary.",
-				"Self-upgrade is only supported for the compiled binary.",
-				`Run: npm i -g @ait-co/console-cli@latest  (currently ${current}, latest ${latest})`
-			].join("\n"));
-			process.exit(ExitCode.UpgradeUnavailable);
-		}
-		const platform = detectPlatform();
-		if (!platform) {
-			emitError({
-				reason: "unsupported-platform",
-				platform: process.platform,
-				arch: process.arch
-			}, `No prebuilt binary for ${process.platform}/${process.arch}.`);
-			process.exit(ExitCode.UpgradeUnavailable);
-		}
-		const asset = release.assets.find((a) => a.name === platform.assetName);
-		if (!asset) {
-			emitError({
-				reason: "asset-missing",
-				assetName: platform.assetName,
-				tag: release.tag_name
-			}, `Release ${release.tag_name} has no asset named ${platform.assetName}. It may still be uploading.`);
-			process.exit(ExitCode.UpgradeUnavailable);
+		const session = await readSession();
+		if (!session) {
+			emitNotAuthenticated(args.json);
+			return exitAfterFlush(ExitCode.NotAuthenticated);
 		}
-		const exePath = process.execPath;
-		const stagingPath = `${exePath}.new.${Date.now()}`;
-		if (!args.json) process.stdout.write(`Downloading ${asset.name} (${latest})...\n`);
-		try {
-			const res = await fetch(asset.browser_download_url);
-			if (!res.ok || !res.body) throw new Error(`Download failed: ${res.status} ${res.statusText}`);
-			await writeFile(stagingPath, new Uint8Array(await res.arrayBuffer()), { mode: 493 });
-			await chmod(stagingPath, 493);
-		} catch (err) {
-			emitError({
-				reason: "download-failed",
-				message: err.message
-			}, `Failed to download new binary: ${err.message}`);
-			process.exit(ExitCode.NetworkError);
+		let workspaceId;
+		if (args.workspace) {
+			const raw = String(args.workspace);
+			const parsed = parsePositiveInt$1(raw);
+			if (parsed === null) {
+				const message = `--workspace must be a positive integer (got ${raw})`;
+				if (args.json) emitJson({
+					ok: false,
+					reason: "invalid-id",
+					message
+				});
+				else process.stderr.write(`${message}\n`);
+				return exitAfterFlush(ExitCode.Usage);
+			}
+			workspaceId = parsed;
+		} else workspaceId = session.currentWorkspaceId;
+		if (workspaceId === void 0) {
+			if (args.json) emitJson({
+				ok: false,
+				reason: "no-workspace-selected"
+			});
+			else process.stderr.write("No workspace selected. Pass `--workspace <id>` or run `aitcc workspace use <id>`.\n");
+			return exitAfterFlush(ExitCode.Usage);
 		}
 		try {
-			if (process.platform === "win32") {
-				await rename(exePath, `${exePath}.old`);
-				await rename(stagingPath, exePath);
-			} else await rename(stagingPath, exePath);
+			const detail = await fetchWorkspaceDetail(workspaceId, session.cookies);
+			if (args.json) {
+				emitJson({
+					ok: true,
+					workspaceId: detail.workspaceId,
+					workspaceName: detail.workspaceName,
+					extra: detail.extra ?? {}
+				});
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			process.stdout.write(`Workspace ${detail.workspaceId}: ${detail.workspaceName}\n`);
+			if (detail.extra) for (const [k, v] of Object.entries(detail.extra)) process.stdout.write(`  ${k}: ${formatScalar(v)}\n`);
+			return exitAfterFlush(ExitCode.Ok);
 		} catch (err) {
-			emitError({
-				reason: "replace-failed",
-				message: err.message,
-				exePath,
-				stagingPath
-			}, `Failed to replace binary at ${exePath}: ${err.message}`);
-			process.exit(ExitCode.Generic);
+			return emitFailureFromError(args.json, err);
 		}
-		emit({
-			ok: true,
-			status: "upgraded",
-			from: current,
-			to: latest,
-			installedAt: exePath,
-			installedIn: dirname(exePath)
-		}, `Upgraded aitcc: ${current} → ${latest}`);
 	}
 });
-//#endregion
-//#region src/update-check.ts
-const UPDATE_CHECK_INTERVAL_MS = 1440 * 60 * 1e3;
-async function readCache() {
-	let raw;
-	try {
-		raw = await readFile(upgradeCheckPath(), "utf8");
-	} catch {
-		return null;
+async function resolveWorkspaceArg(args, selected) {
+	if (args.workspace) {
+		const raw = String(args.workspace);
+		const parsed = parsePositiveInt$1(raw);
+		if (parsed === null) {
+			const message = `--workspace must be a positive integer (got ${raw})`;
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-id",
+				message
+			});
+			else process.stderr.write(`${message}\n`);
+			return null;
+		}
+		return parsed;
 	}
-	let parsed;
-	try {
-		parsed = JSON.parse(raw);
-	} catch {
+	if (selected === void 0) {
+		if (args.json) emitJson({
+			ok: false,
+			reason: "no-workspace-selected"
+		});
+		else process.stderr.write("No workspace selected. Pass `--workspace <id>` or run `aitcc workspace use <id>`.\n");
 		return null;
 	}
-	if (!parsed || typeof parsed !== "object") return null;
-	const obj = parsed;
-	if (typeof obj.lastCheckedAt !== "string") return null;
-	if (obj.latestTag !== void 0 && typeof obj.latestTag !== "string") return null;
-	if (obj.etag !== void 0 && typeof obj.etag !== "string") return null;
-	return {
-		lastCheckedAt: obj.lastCheckedAt,
-		...obj.latestTag !== void 0 ? { latestTag: obj.latestTag } : {},
-		...obj.etag !== void 0 ? { etag: obj.etag } : {}
-	};
-}
-async function writeCache(entry) {
-	const path = upgradeCheckPath();
-	await mkdir(dirname(path), { recursive: true });
-	const tmp = `${path}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2, 10)}.tmp`;
-	try {
-		await writeFile(tmp, JSON.stringify(entry, null, 2), { mode: 384 });
-		await rename(tmp, path);
-	} catch (err) {
-		await unlink(tmp).catch(() => {});
-		throw err;
-	}
-}
-/** Has the throttle window elapsed since the last recorded check? */
-function isDueForCheck(cache, now = Date.now(), intervalMs = UPDATE_CHECK_INTERVAL_MS) {
-	if (!cache) return true;
-	const last = Date.parse(cache.lastCheckedAt);
-	if (!Number.isFinite(last)) return true;
-	if (now < last) return true;
-	return now - last >= intervalMs;
-}
-/**
-* Perform the throttled update check. Returns the final cache entry (for
-* testing) or null when skipped. Never throws — network errors are
-* intentionally swallowed so they never interrupt the foreground command.
-*/
-async function maybeCheckForUpdate(opts = {}) {
-	const env = opts.env ?? process.env;
-	const isTTY = opts.isTTY ?? Boolean(process.stderr.isTTY);
-	const now = opts.now ?? Date.now();
-	const intervalMs = opts.intervalMs ?? 864e5;
-	const optOut = env.AITCC_NO_UPDATE_CHECK;
-	if (optOut && optOut !== "0" && optOut.toLowerCase() !== "false") return null;
-	if (!isTTY) return null;
-	const cache = await readCache();
-	if (!isDueForCheck(cache, now, intervalMs)) return null;
-	const nowIso = new Date(now).toISOString();
-	const placeholder = {
-		lastCheckedAt: nowIso,
-		...cache?.latestTag !== void 0 ? { latestTag: cache.latestTag } : {},
-		...cache?.etag !== void 0 ? { etag: cache.etag } : {}
-	};
-	await writeCache(placeholder).catch(() => {});
-	const previousEtag = cache?.etag;
-	let entry = placeholder;
-	try {
-		const result = await fetchLatestReleaseConditional(previousEtag);
-		if (result.status === "not-modified") entry = {
-			lastCheckedAt: nowIso,
-			...cache?.latestTag !== void 0 ? { latestTag: cache.latestTag } : {},
-			...result.etag !== void 0 ? { etag: result.etag } : cache?.etag !== void 0 ? { etag: cache.etag } : {}
-		};
-		else entry = {
-			lastCheckedAt: nowIso,
-			latestTag: result.release.tag_name,
-			...result.etag !== void 0 ? { etag: result.etag } : {}
-		};
-		await writeCache(entry).catch(() => {});
-	} catch {}
-	maybeEmitNotice(entry, env);
-	return entry;
-}
-function maybeEmitNotice(entry, env) {
-	if (!entry.latestTag) return;
-	if (VERSION.startsWith("0.0.0-dev")) return;
-	const latest = versionFromTag(entry.latestTag);
-	if (!latest) return;
-	if (compareSemver(latest, VERSION) <= 0) return;
-	const dim = env.NO_COLOR ? "" : "\x1B[2m";
-	const reset = env.NO_COLOR ? "" : "\x1B[0m";
-	process.stderr.write(`\n${dim}(aitcc ${latest} is available — run \`aitcc upgrade\` to install)${reset}\n`);
-}
-//#endregion
-//#region src/commands/whoami.ts
-async function runBackgroundUpdateCheck(json) {
-	if (json) return;
-	const timeoutMs = 500;
-	await Promise.race([maybeCheckForUpdate().catch(() => null), new Promise((resolve) => {
-		const t = setTimeout(() => resolve(null), timeoutMs);
-		if (typeof t.unref === "function") t.unref();
-	})]);
+	return selected;
 }
-const whoamiCommand = defineCommand({
+const partnerCommand = defineCommand({
 	meta: {
-		name: "whoami",
-		description: "Show the currently authenticated user (live from the console API by default)."
+		name: "partner",
+		description: "Show the partner (billing/payout) registration state for the selected workspace."
 	},
 	args: {
+		workspace: {
+			type: "string",
+			description: "Workspace ID to inspect. Defaults to the selected workspace."
+		},
 		json: {
 			type: "boolean",
 			description: "Emit machine-readable JSON to stdout.",
 			default: false
-		},
-		offline: {
-			type: "boolean",
-			description: "Skip the live API call and read only the cached session summary.",
-			default: false
 		}
 	},
 	async run({ args }) {
 		const session = await readSession();
 		if (!session) {
-			if (args.json) process.stdout.write(`${JSON.stringify({
-				ok: true,
-				authenticated: false
-			})}\n`);
-			else {
-				process.stderr.write("Not logged in. Run `aitcc login` to start a session.\n");
-				process.stderr.write(`Session file checked: ${sessionPathForDiagnostics()}\n`);
-			}
+			emitNotAuthenticated(args.json);
 			return exitAfterFlush(ExitCode.NotAuthenticated);
 		}
-		if (args.offline) {
-			if (args.json) {
-				process.stdout.write(`${JSON.stringify({
-					ok: true,
-					authenticated: true,
-					source: "cache",
-					user: session.user,
-					capturedAt: session.capturedAt
-				})}\n`);
-				return exitAfterFlush(ExitCode.Ok);
-			}
-			const label = session.user.displayName ? `${session.user.displayName} <${session.user.email}>` : session.user.email;
-			process.stdout.write(`Logged in as ${label} (cached)\n`);
-			process.stdout.write(`Session captured: ${session.capturedAt}\n`);
-			await runBackgroundUpdateCheck(args.json);
-			return exitAfterFlush(ExitCode.Ok);
-		}
+		const workspaceId = await resolveWorkspaceArg(args, session.currentWorkspaceId);
+		if (workspaceId === null) return exitAfterFlush(ExitCode.Usage);
 		try {
-			const info = await fetchConsoleMemberUserInfo(session.cookies);
+			const state = await fetchWorkspacePartner(workspaceId, session.cookies);
 			if (args.json) {
-				process.stdout.write(`${JSON.stringify({
+				emitJson({
 					ok: true,
-					authenticated: true,
-					source: "live",
-					user: {
-						id: String(info.id),
-						bizUserNo: info.bizUserNo,
-						name: info.name,
-						email: info.email,
-						role: info.role
-					},
-					workspaces: info.workspaces.map((w) => ({
-						workspaceId: w.workspaceId,
-						workspaceName: w.workspaceName,
-						role: w.role
-					})),
-					capturedAt: session.capturedAt
-				})}\n`);
+					workspaceId,
+					registered: state.registered,
+					approvalType: state.approvalType,
+					rejectMessage: state.rejectMessage,
+					partner: state.partner
+				});
 				return exitAfterFlush(ExitCode.Ok);
 			}
-			process.stdout.write(`Logged in as ${info.name} <${info.email}> (${info.role})\n`);
-			if (info.workspaces.length > 0) {
-				process.stdout.write("Workspaces:\n");
-				for (const w of info.workspaces) process.stdout.write(`  - ${w.workspaceName} (id ${w.workspaceId}, ${w.role})\n`);
+			process.stdout.write(`Workspace ${workspaceId} partner:\n`);
+			process.stdout.write(`  registered: ${state.registered}\n`);
+			process.stdout.write(`  approvalType: ${state.approvalType ?? "null"}\n`);
+			if (state.rejectMessage) process.stdout.write(`  rejectMessage: ${state.rejectMessage}\n`);
+			if (state.partner) {
+				process.stdout.write("  partner:\n");
+				for (const [k, v] of Object.entries(state.partner)) process.stdout.write(`    ${k}: ${formatScalar(v)}\n`);
 			}
-			await runBackgroundUpdateCheck(args.json);
 			return exitAfterFlush(ExitCode.Ok);
 		} catch (err) {
-			if (err instanceof TossApiError && err.isAuthError) {
-				if (args.json) process.stdout.write(`${JSON.stringify({
-					ok: true,
-					authenticated: false,
-					reason: "session-expired",
-					errorCode: err.errorCode
-				})}\n`);
-				else process.stderr.write("Session is no longer valid. Run `aitcc login` again.\n");
-				return exitAfterFlush(ExitCode.NotAuthenticated);
-			}
-			if (err instanceof NetworkError) {
-				if (args.json) process.stdout.write(`${JSON.stringify({
-					ok: false,
-					reason: "network-error",
-					message: err.message
-				})}\n`);
-				else process.stderr.write(`Network error reaching the console API: ${err.message}. Use \`aitcc whoami --offline\` for the cached identity.\n`);
-				return exitAfterFlush(ExitCode.NetworkError);
-			}
-			if (args.json) process.stdout.write(`${JSON.stringify({
-				ok: false,
-				reason: "api-error",
-				message: err.message
-			})}\n`);
-			else process.stderr.write(`Unexpected error: ${err.message}\n`);
-			return exitAfterFlush(ExitCode.ApiError);
+			return emitFailureFromError(args.json, err);
 		}
 	}
 });
-//#endregion
-//#region src/api/workspaces.ts
-const WORKSPACES_BASE = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
-async function fetchWorkspaceDetail(workspaceId, cookies, opts = {}) {
-	const raw = await requestConsoleApi({
-		url: `${WORKSPACES_BASE}/workspaces/${workspaceId}`,
-		cookies,
-		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
-	});
-	const id = raw.id;
-	const name = raw.name;
-	if (typeof id !== "number" || !Number.isInteger(id) || id <= 0 || typeof name !== "string") throw new Error(`Unexpected workspace detail shape for id=${workspaceId}`);
-	const { id: _id, name: _name, ...extra } = raw;
-	return {
-		workspaceId: id,
-		workspaceName: name,
-		extra
-	};
-}
-//#endregion
-//#region src/commands/workspace.ts
-function formatScalar(v) {
-	if (v === null) return "null";
-	if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") return String(v);
-	return JSON.stringify(v);
+function formatTermLines(term) {
+	return `  ${term.isAgreed ? "[agreed]" : "[pending]"}${term.required ? " required" : ""}  ${term.title}\n    ${term.contentsUrl}\n`;
 }
 const workspaceCommand = defineCommand({
 	meta: {
@@ -3899,62 +5120,23 @@ const workspaceCommand = defineCommand({
 		description: "Inspect and switch between the workspaces this account can access."
 	},
 	subCommands: {
-		ls: defineCommand({
-			meta: {
-				name: "ls",
-				description: "List workspaces the current user has access to."
-			},
-			args: { json: {
-				type: "boolean",
-				description: "Emit machine-readable JSON to stdout.",
-				default: false
-			} },
-			async run({ args }) {
-				const session = await readSession();
-				if (!session) {
-					emitNotAuthenticated(args.json);
-					return exitAfterFlush(ExitCode.NotAuthenticated);
-				}
-				try {
-					const info = await fetchConsoleMemberUserInfo(session.cookies);
-					const current = session.currentWorkspaceId;
-					if (args.json) {
-						emitJson({
-							ok: true,
-							workspaces: info.workspaces.map((w) => ({
-								workspaceId: w.workspaceId,
-								workspaceName: w.workspaceName,
-								role: w.role,
-								current: w.workspaceId === current
-							}))
-						});
-						return exitAfterFlush(ExitCode.Ok);
-					}
-					if (info.workspaces.length === 0) {
-						process.stdout.write("No workspaces.\n");
-						return exitAfterFlush(ExitCode.Ok);
-					}
-					for (const w of info.workspaces) {
-						const marker = w.workspaceId === current ? "* " : "  ";
-						process.stdout.write(`${marker}${w.workspaceId}  ${w.workspaceName}  (${w.role})\n`);
-					}
-					if (current === void 0) process.stderr.write("No workspace selected. Run `aitcc workspace use <id>`.\n");
-					return exitAfterFlush(ExitCode.Ok);
-				} catch (err) {
-					return emitFailureFromError(args.json, err);
-				}
-			}
-		}),
-		use: defineCommand({
+		ls: lsCommand,
+		use: useCommand,
+		show: showCommand,
+		partner: partnerCommand,
+		terms: defineCommand({
 			meta: {
-				name: "use",
-				description: "Select the current workspace by ID. Subsequent commands use this."
+				name: "terms",
+				description: "Show the console terms-of-agreement state that gate workspace-level features (Toss login, IAP, IAA, biz workspace, promotion money)."
 			},
 			args: {
-				id: {
-					type: "positional",
-					description: "Workspace ID",
-					required: true
+				type: {
+					type: "string",
+					description: `Term bucket to inspect: ${WORKSPACE_TERM_TYPES.join(" | ")}. Omit to query every bucket.`
+				},
+				workspace: {
+					type: "string",
+					description: "Workspace ID to inspect. Defaults to the selected workspace."
 				},
 				json: {
 					type: "boolean",
@@ -3963,114 +5145,158 @@ const workspaceCommand = defineCommand({
 				}
 			},
 			async run({ args }) {
-				const raw = String(args.id);
-				const parsed = parsePositiveInt$1(raw);
-				if (parsed === null) {
-					const message = `workspace id must be a positive integer (got ${raw})`;
+				const session = await readSession();
+				if (!session) {
+					emitNotAuthenticated(args.json);
+					return exitAfterFlush(ExitCode.NotAuthenticated);
+				}
+				const workspaceId = await resolveWorkspaceArg(args, session.currentWorkspaceId);
+				if (workspaceId === null) return exitAfterFlush(ExitCode.Usage);
+				const typesToQuery = (() => {
+					if (!args.type) return WORKSPACE_TERM_TYPES;
+					const raw = String(args.type).toUpperCase();
+					if (WORKSPACE_TERM_TYPES.includes(raw)) return [raw];
+					return [];
+				})();
+				if (typesToQuery.length === 0) {
+					const message = `--type must be one of: ${WORKSPACE_TERM_TYPES.join(", ")}`;
 					if (args.json) emitJson({
 						ok: false,
-						reason: "invalid-id",
-						message
+						reason: "invalid-type",
+						allowed: [...WORKSPACE_TERM_TYPES]
 					});
 					else process.stderr.write(`${message}\n`);
 					return exitAfterFlush(ExitCode.Usage);
 				}
-				const session = await readSession();
-				if (!session) {
-					emitNotAuthenticated(args.json);
-					return exitAfterFlush(ExitCode.NotAuthenticated);
-				}
 				try {
-					const match = (await fetchConsoleMemberUserInfo(session.cookies)).workspaces.find((w) => w.workspaceId === parsed);
-					if (!match) {
-						if (args.json) emitJson({
-							ok: false,
-							reason: "not-found",
-							workspaceId: parsed
+					const results = await Promise.all(typesToQuery.map(async (t) => [t, await fetchWorkspaceTerms(workspaceId, t, session.cookies)]));
+					if (typesToQuery.length === 1) {
+						const [type, terms] = results[0];
+						if (args.json) {
+							emitJson({
+								ok: true,
+								workspaceId,
+								type,
+								terms
+							});
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						process.stdout.write(`Workspace ${workspaceId} terms (${type}):\n`);
+						if (terms.length === 0) process.stdout.write("  (no terms required)\n");
+						else for (const t of terms) process.stdout.write(formatTermLines(t));
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					const byType = {};
+					for (const [t, terms] of results) byType[t] = terms;
+					if (args.json) {
+						emitJson({
+							ok: true,
+							workspaceId,
+							byType
 						});
-						else process.stderr.write(`Workspace ${parsed} is not accessible from this account. Run \`aitcc workspace ls\` to see available workspaces.\n`);
-						return exitAfterFlush(ExitCode.Usage);
+						return exitAfterFlush(ExitCode.Ok);
 					}
-					if (await setCurrentWorkspaceId(parsed) === null) {
-						emitNotAuthenticated(args.json);
-						return exitAfterFlush(ExitCode.NotAuthenticated);
+					for (const [type, terms] of results) {
+						process.stdout.write(`\n[${type}]\n`);
+						if (terms.length === 0) process.stdout.write("  (no terms required)\n");
+						else for (const t of terms) process.stdout.write(formatTermLines(t));
 					}
-					if (args.json) emitJson({
-						ok: true,
-						workspaceId: match.workspaceId,
-						workspaceName: match.workspaceName
-					});
-					else process.stdout.write(`Using workspace ${match.workspaceId} (${match.workspaceName}).\n`);
 					return exitAfterFlush(ExitCode.Ok);
 				} catch (err) {
 					return emitFailureFromError(args.json, err);
 				}
 			}
 		}),
-		show: defineCommand({
+		segments: defineCommand({
 			meta: {
-				name: "show",
-				description: "Show details of the selected workspace (or the one passed with --workspace)."
+				name: "segments",
+				description: "Inspect user segments defined in a workspace."
 			},
-			args: {
-				workspace: {
-					type: "string",
-					description: "Workspace ID to inspect. Defaults to the selected workspace."
+			subCommands: { ls: defineCommand({
+				meta: {
+					name: "ls",
+					description: "List user segments in the selected workspace (the 세그먼트 menu)."
 				},
-				json: {
-					type: "boolean",
-					description: "Emit machine-readable JSON to stdout.",
-					default: false
-				}
-			},
-			async run({ args }) {
-				const session = await readSession();
-				if (!session) {
-					emitNotAuthenticated(args.json);
-					return exitAfterFlush(ExitCode.NotAuthenticated);
-				}
-				let workspaceId;
-				if (args.workspace) {
-					const raw = String(args.workspace);
-					const parsed = parsePositiveInt$1(raw);
-					if (parsed === null) {
-						const message = `--workspace must be a positive integer (got ${raw})`;
+				args: {
+					workspace: {
+						type: "string",
+						description: "Workspace ID. Defaults to the selected workspace."
+					},
+					category: {
+						type: "string",
+						description: "Category bucket (tab). Defaults to \"생성된 세그먼트\" — the UI's initial tab."
+					},
+					search: {
+						type: "string",
+						description: "Name-contains filter. Empty matches everything."
+					},
+					page: {
+						type: "string",
+						description: "Page number (0-indexed).",
+						default: "0"
+					},
+					json: {
+						type: "boolean",
+						description: "Emit machine-readable JSON to stdout.",
+						default: false
+					}
+				},
+				async run({ args }) {
+					const session = await readSession();
+					if (!session) {
+						emitNotAuthenticated(args.json);
+						return exitAfterFlush(ExitCode.NotAuthenticated);
+					}
+					const workspaceId = await resolveWorkspaceArg(args, session.currentWorkspaceId);
+					if (workspaceId === null) return exitAfterFlush(ExitCode.Usage);
+					const pageRaw = String(args.page);
+					const pageNum = Number(pageRaw);
+					if (!Number.isFinite(pageNum) || !Number.isInteger(pageNum) || pageNum < 0) {
+						const message = `--page must be a non-negative integer (got ${JSON.stringify(pageRaw)})`;
 						if (args.json) emitJson({
 							ok: false,
-							reason: "invalid-id",
+							reason: "invalid-page",
 							message
 						});
 						else process.stderr.write(`${message}\n`);
 						return exitAfterFlush(ExitCode.Usage);
 					}
-					workspaceId = parsed;
-				} else workspaceId = session.currentWorkspaceId;
-				if (workspaceId === void 0) {
-					if (args.json) emitJson({
-						ok: false,
-						reason: "no-workspace-selected"
-					});
-					else process.stderr.write("No workspace selected. Pass `--workspace <id>` or run `aitcc workspace use <id>`.\n");
-					return exitAfterFlush(ExitCode.Usage);
-				}
-				try {
-					const detail = await fetchWorkspaceDetail(workspaceId, session.cookies);
-					if (args.json) {
-						emitJson({
-							ok: true,
-							workspaceId: detail.workspaceId,
-							workspaceName: detail.workspaceName,
-							extra: detail.extra ?? {}
-						});
+					try {
+						const page = await fetchWorkspaceSegments({
+							workspaceId,
+							...args.category !== void 0 ? { category: String(args.category) } : {},
+							...args.search !== void 0 ? { search: String(args.search) } : {},
+							page: pageNum
+						}, session.cookies);
+						const category = args.category !== void 0 ? String(args.category) : "생성된 세그먼트";
+						if (args.json) {
+							emitJson({
+								ok: true,
+								workspaceId,
+								category,
+								segments: page.contents,
+								totalPage: page.totalPage,
+								currentPage: page.currentPage
+							});
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						if (page.contents.length === 0) {
+							process.stdout.write(`Workspace ${workspaceId} (${category}): no segments on page ${page.currentPage}\n`);
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						process.stdout.write(`Workspace ${workspaceId} (${category}): ${page.contents.length} segment(s), page ${page.currentPage} of ${page.totalPage}\n`);
+						for (const s of page.contents) {
+							const id = typeof s.id === "string" || typeof s.id === "number" ? s.id : typeof s.segmentId === "string" || typeof s.segmentId === "number" ? s.segmentId : "-";
+							const name = typeof s.name === "string" ? s.name : typeof s.title === "string" ? s.title : "-";
+							const userCount = typeof s.userCount === "number" ? String(s.userCount) : typeof s.count === "number" ? String(s.count) : "-";
+							process.stdout.write(`${id}\t${name}\t${userCount}\n`);
+						}
 						return exitAfterFlush(ExitCode.Ok);
+					} catch (err) {
+						return emitFailureFromError(args.json, err);
 					}
-					process.stdout.write(`Workspace ${detail.workspaceId}: ${detail.workspaceName}\n`);
-					if (detail.extra) for (const [k, v] of Object.entries(detail.extra)) process.stdout.write(`  ${k}: ${formatScalar(v)}\n`);
-					return exitAfterFlush(ExitCode.Ok);
-				} catch (err) {
-					return emitFailureFromError(args.json, err);
 				}
-			}
+			}) }
 		})
 	}
 });
@@ -4091,7 +5317,9 @@ runMain(defineCommand({
 		app: appCommand,
 		members: membersCommand,
 		keys: keysCommand,
-		notices: noticesCommand
+		notices: noticesCommand,
+		me: meCommand,
+		completion: completionCommand
 	}
 }));
 //#endregion