@ait-co/console-cli 0.1.10 → 0.1.12

package/dist/cli.mjs

@@ -161,10 +161,10 @@ async function executeAndUnwrap(url, init, fetchImpl) {
 }
 //#endregion
 //#region src/api/mini-apps.ts
-const BASE$2 = "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$2}/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$2}/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$2}/workspaces/${workspaceId}/mini-app/${miniAppId}/with-draft`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/${miniAppId}/with-draft`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -222,9 +222,303 @@ async function fetchMiniAppWithDraft(workspaceId, miniAppId, cookies, opts = {})
 function isRecordOrNull(v) {
 	return v === null || typeof v === "object" && !Array.isArray(v);
 }
+async function fetchMiniAppRatings(params, cookies, opts = {}) {
+	const page = params.page ?? 0;
+	const size = params.size ?? 20;
+	const sortField = params.sortField ?? "CREATED_AT";
+	const sortDirection = params.sortDirection ?? "DESC";
+	const raw = await requestConsoleApi({
+		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 } : {}
+	});
+	if (raw === null || typeof raw !== "object") throw new Error(`Unexpected ratings shape for app=${params.miniAppId}`);
+	const rec = raw;
+	const ratingsRaw = rec.ratings;
+	if (!Array.isArray(ratingsRaw)) throw new Error(`Unexpected ratings shape: ratings is not an array (app=${params.miniAppId})`);
+	const ratings = ratingsRaw.map((r) => {
+		if (r === null || typeof r !== "object") return {};
+		return r;
+	});
+	const pagingRaw = rec.paging;
+	if (pagingRaw === null || typeof pagingRaw !== "object") throw new Error(`Unexpected ratings shape: paging missing (app=${params.miniAppId})`);
+	const p = pagingRaw;
+	return {
+		ratings,
+		paging: {
+			pageNumber: typeof p.pageNumber === "number" ? p.pageNumber : page,
+			pageSize: typeof p.pageSize === "number" ? p.pageSize : size,
+			hasNext: Boolean(p.hasNext),
+			totalCount: typeof p.totalCount === "number" ? p.totalCount : 0
+		},
+		averageRating: typeof rec.averageRating === "number" ? rec.averageRating : 0,
+		totalReviewCount: typeof rec.totalReviewCount === "number" ? rec.totalReviewCount : 0
+	};
+}
+async function fetchUserReports(params, cookies, opts = {}) {
+	const pageSize = params.pageSize ?? 20;
+	const qs = new URLSearchParams();
+	qs.set("pageSize", String(pageSize));
+	if (params.cursor !== void 0) qs.set("cursor", params.cursor);
+	const raw = await requestConsoleApi({
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-apps/${params.miniAppId}/user-reports?` + qs.toString(),
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object") throw new Error(`Unexpected user-reports shape for app=${params.miniAppId}`);
+	const rec = raw;
+	const reportsRaw = rec.reports;
+	if (!Array.isArray(reportsRaw)) throw new Error(`Unexpected user-reports shape: reports is not an array (app=${params.miniAppId})`);
+	return {
+		reports: reportsRaw.map((r) => {
+			if (r === null || typeof r !== "object") return {};
+			return r;
+		}),
+		nextCursor: typeof rec.nextCursor === "string" ? rec.nextCursor : null,
+		hasMore: Boolean(rec.hasMore)
+	};
+}
+async function fetchBundles(params, cookies, opts = {}) {
+	const qs = new URLSearchParams();
+	if (params.page !== void 0) qs.set("page", String(params.page));
+	if (params.tested !== void 0) qs.set("tested", String(params.tested));
+	if (params.deployStatus !== void 0) qs.set("deployStatus", params.deployStatus);
+	const query = qs.toString();
+	const raw = await requestConsoleApi({
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/bundles` + (query ? `?${query}` : ""),
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object") throw new Error(`Unexpected bundles shape for app=${params.miniAppId}`);
+	const rec = raw;
+	const contentsRaw = rec.contents;
+	if (!Array.isArray(contentsRaw)) throw new Error(`Unexpected bundles shape: contents is not an array (app=${params.miniAppId})`);
+	return {
+		contents: contentsRaw.map((b) => {
+			if (b === null || typeof b !== "object") return {};
+			return b;
+		}),
+		totalPage: typeof rec.totalPage === "number" ? rec.totalPage : 0,
+		currentPage: typeof rec.currentPage === "number" ? rec.currentPage : 0
+	};
+}
+async function fetchConversionMetrics(params, cookies, opts = {}) {
+	const qs = new URLSearchParams();
+	qs.set("refresh", String(params.refresh ?? false));
+	qs.set("timeUnitType", params.timeUnitType);
+	qs.set("startDate", params.startDate);
+	qs.set("endDate", params.endDate);
+	const raw = await requestConsoleApi({
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/conversion-metrics?${qs.toString()}`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object") throw new Error(`Unexpected metrics shape for app=${params.miniAppId}`);
+	const rec = raw;
+	const metricsRaw = rec.metrics;
+	if (!Array.isArray(metricsRaw)) throw new Error(`Unexpected metrics shape: metrics is not an array (app=${params.miniAppId})`);
+	return {
+		metrics: metricsRaw.map((m) => {
+			if (m === null || typeof m !== "object") return {};
+			return m;
+		}),
+		cacheTime: typeof rec.cacheTime === "string" ? rec.cacheTime : void 0
+	};
+}
+async function fetchCerts(workspaceId, miniAppId, cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/${miniAppId}/certs`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (!Array.isArray(raw)) throw new Error(`Unexpected certs shape for app=${miniAppId}: not an array`);
+	return raw.map((c) => {
+		if (c === null || typeof c !== "object") return {};
+		return c;
+	});
+}
+async function fetchShareRewards(params, cookies, opts = {}) {
+	const qs = new URLSearchParams();
+	qs.set("search", params.search ?? "");
+	const raw = await requestConsoleApi({
+		url: `${BASE$4}/workspaces/${params.workspaceId}/mini-app/${params.miniAppId}/share-rewards?${qs.toString()}`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (!Array.isArray(raw)) throw new Error(`Unexpected share-rewards shape for app=${params.miniAppId}: not an array`);
+	return raw.map((r) => {
+		if (r === null || typeof r !== "object") return {};
+		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$4}/workspaces/${workspaceId}/mini-app/${miniAppId}/bundles/deployed`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null) return null;
+	if (typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Unexpected deployed-bundle shape for app=${miniAppId}`);
+	return raw;
+}
 async function createMiniApp(workspaceId, payload, cookies, opts = {}) {
 	return normalizeCreateResult(await requestConsoleApi({
-		url: `${BASE$2}/workspaces/${workspaceId}/mini-app/review`,
+		url: `${BASE$4}/workspaces/${workspaceId}/mini-app/review`,
 		method: "POST",
 		cookies,
 		body: payload,
@@ -257,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$2}/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();
@@ -507,7 +801,7 @@ async function emitFailureFromError(json, err) {
 	emitApiError(json, err.message);
 	return exitAfterFlush(ExitCode.ApiError);
 }
-function parsePositiveInt(raw) {
+function parsePositiveInt$1(raw) {
 	if (!/^[1-9]\d*$/.test(raw)) return null;
 	const n = Number.parseInt(raw, 10);
 	return Number.isSafeInteger(n) ? n : null;
@@ -535,7 +829,7 @@ async function resolveWorkspaceContext(args) {
 	let workspaceId;
 	if (args.workspace) {
 		const raw = String(args.workspace);
-		const parsed = parsePositiveInt(raw);
+		const parsed = parsePositiveInt$1(raw);
 		if (parsed === null) {
 			const message = `--workspace must be a positive integer (got ${raw})`;
 			if (args.json) emitJson({
@@ -563,6 +857,21 @@ async function resolveWorkspaceContext(args) {
 		workspaceId
 	};
 }
+/**
+* Session-only sibling of `resolveWorkspaceContext` for commands that
+* don't need a workspace id (notices come from a shared Toss workspace,
+* whoami is self-scoped). Same "exits on miss, returns null to force
+* `if (!session) return`" pattern.
+*/
+async function requireSession(json) {
+	const session = await readSession();
+	if (!session) {
+		emitNotAuthenticated(json);
+		await exitAfterFlush(ExitCode.NotAuthenticated);
+		return null;
+	}
+	return session;
+}
 //#endregion
 //#region src/config/app-manifest.ts
 var ManifestError = class extends Error {
@@ -1046,7 +1355,7 @@ function reviewStateFor(entry) {
 	const raw = entry.reviewState ?? entry.status;
 	return typeof raw === "string" ? raw : void 0;
 }
-const lsCommand$3 = defineCommand({
+const lsCommand$4 = defineCommand({
 	meta: {
 		name: "ls",
 		description: "List mini-apps in the selected workspace."
@@ -1126,7 +1435,7 @@ function parseAppId(raw) {
 	if (!Number.isFinite(n) || !Number.isInteger(n) || n <= 0) return null;
 	return n;
 }
-const showCommand$1 = defineCommand({
+const showCommand$2 = defineCommand({
 	meta: {
 		name: "show",
 		description: "Show full details of a mini-app, including fields only visible in the draft view."
@@ -1261,150 +1570,1390 @@ function deriveReviewState(env) {
 }
 const POLL_MIN_INTERVAL_SEC = 30;
 const POLL_MAX_INTERVAL_SEC = 3600;
-const appCommand = defineCommand({
+const statusCommand = defineCommand({
 	meta: {
-		name: "app",
-		description: "Inspect mini-apps in a workspace."
+		name: "status",
+		description: "Show the derived review state of a mini-app (under-review / rejected / approved)."
 	},
-	subCommands: {
-		ls: lsCommand$3,
-		show: showCommand$1,
-		status: defineCommand({
-			meta: {
-				name: "status",
-				description: "Show the derived review state of a mini-app (under-review / rejected / approved)."
-			},
-			args: {
-				id: {
-					type: "positional",
-					description: "Mini-app ID.",
-					required: true
-				},
-				workspace: {
-					type: "string",
-					description: "Workspace ID. Defaults to the selected workspace."
-				},
-				watch: {
-					type: "boolean",
-					description: "Poll until the review state flips off `under-review` (rejected or approved). Combine with `--interval <seconds>`.",
-					default: false
-				},
-				interval: {
-					type: "string",
-					description: "Polling interval in seconds when --watch is set. Clamped to [30, 3600].",
-					default: "60"
-				},
-				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 status: invalid id ${JSON.stringify(args.id)}\n`);
-					return exitAfterFlush(ExitCode.Usage);
-				}
-				const intervalRaw = Number(args.interval);
-				if (!Number.isFinite(intervalRaw) || intervalRaw <= 0) {
-					if (args.json) emitJson({
-						ok: false,
-						reason: "invalid-config",
-						field: "interval",
-						message: `--interval must be a positive number (got ${JSON.stringify(args.interval)})`
-					});
-					else process.stderr.write(`app status: invalid --interval ${JSON.stringify(args.interval)}\n`);
-					return exitAfterFlush(ExitCode.Usage);
-				}
-				const intervalSec = Math.max(POLL_MIN_INTERVAL_SEC, Math.min(POLL_MAX_INTERVAL_SEC, Math.floor(intervalRaw)));
-				const ctx = await resolveWorkspaceContext(args);
-				if (!ctx) return;
-				const { session, workspaceId } = ctx;
-				const emit = (status) => {
-					if (args.json) emitJson({
-						ok: true,
-						workspaceId,
-						appId,
-						...status
-					});
-					else process.stdout.write(`App ${appId} (ws ${workspaceId}): ${status.state}` + (status.rejectedMessage ? `\n  reason: ${status.rejectedMessage}` : "") + "\n");
-				};
-				try {
-					const once = async () => {
-						return deriveReviewState(await fetchMiniAppWithDraft(workspaceId, appId, session.cookies));
-					};
-					if (!args.watch) {
-						emit(await once());
-						return exitAfterFlush(ExitCode.Ok);
-					}
-					let lastState = null;
-					while (true) {
-						const status = await once();
-						if (args.json) emit(status);
-						else if (status.state !== lastState) emit(status);
-						lastState = status.state;
-						if (status.state !== "under-review") return exitAfterFlush(ExitCode.Ok);
-						await new Promise((resolve) => setTimeout(resolve, intervalSec * 1e3));
-					}
-				} catch (err) {
-					return emitFailureFromError(args.json, err);
-				}
+	args: {
+		id: {
+			type: "positional",
+			description: "Mini-app ID.",
+			required: true
+		},
+		workspace: {
+			type: "string",
+			description: "Workspace ID. Defaults to the selected workspace."
+		},
+		watch: {
+			type: "boolean",
+			description: "Poll until the review state flips off `under-review` (rejected or approved). Combine with `--interval <seconds>`.",
+			default: false
+		},
+		interval: {
+			type: "string",
+			description: "Polling interval in seconds when --watch is set. Clamped to [30, 3600].",
+			default: "60"
+		},
+		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 status: invalid id ${JSON.stringify(args.id)}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const intervalRaw = Number(args.interval);
+		if (!Number.isFinite(intervalRaw) || intervalRaw <= 0) {
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-config",
+				field: "interval",
+				message: `--interval must be a positive number (got ${JSON.stringify(args.interval)})`
+			});
+			else process.stderr.write(`app status: invalid --interval ${JSON.stringify(args.interval)}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const intervalSec = Math.max(POLL_MIN_INTERVAL_SEC, Math.min(POLL_MAX_INTERVAL_SEC, Math.floor(intervalRaw)));
+		const ctx = await resolveWorkspaceContext(args);
+		if (!ctx) return;
+		const { session, workspaceId } = ctx;
+		const emit = (status) => {
+			if (args.json) emitJson({
+				ok: true,
+				workspaceId,
+				appId,
+				...status
+			});
+			else process.stdout.write(`App ${appId} (ws ${workspaceId}): ${status.state}` + (status.rejectedMessage ? `\n  reason: ${status.rejectedMessage}` : "") + "\n");
+		};
+		try {
+			const once = async () => {
+				return deriveReviewState(await fetchMiniAppWithDraft(workspaceId, appId, session.cookies));
+			};
+			if (!args.watch) {
+				emit(await once());
+				return exitAfterFlush(ExitCode.Ok);
 			}
-		}),
-		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
-				}
-			},
-			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 } : {}
-				});
+			let lastState = null;
+			while (true) {
+				const status = await once();
+				if (args.json) emit(status);
+				else if (status.state !== lastState) emit(status);
+				lastState = status.state;
+				if (status.state !== "under-review") return exitAfterFlush(ExitCode.Ok);
+				await new Promise((resolve) => setTimeout(resolve, intervalSec * 1e3));
 			}
-		})
-	}
-});
+		} catch (err) {
+			return emitFailureFromError(args.json, err);
+		}
+	}
+});
+const VALID_SORT_FIELDS = ["CREATED_AT", "SCORE"];
+const VALID_SORT_DIRECTIONS = ["ASC", "DESC"];
+function parseNonNegativeInt(raw, field) {
+	const n = Number(raw);
+	if (!Number.isFinite(n) || !Number.isInteger(n) || n < 0) return { error: `--${field} must be a non-negative integer (got ${JSON.stringify(raw)})` };
+	return { value: n };
+}
+const ratingsCommand = defineCommand({
+	meta: {
+		name: "ratings",
+		description: "List user ratings and reviews left for a mini-app."
+	},
+	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"
+		},
+		"sort-field": {
+			type: "string",
+			description: "Sort field: CREATED_AT (default) or SCORE.",
+			default: "CREATED_AT"
+		},
+		"sort-direction": {
+			type: "string",
+			description: "Sort direction: ASC or DESC (default).",
+			default: "DESC"
+		},
+		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 ratings: invalid id ${JSON.stringify(args.id)}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const pageResult = parseNonNegativeInt(args.page, "page");
+		if ("error" in pageResult) {
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-config",
+				field: "page",
+				message: pageResult.error
+			});
+			else process.stderr.write(`app ratings: ${pageResult.error}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const sizeResult = parseNonNegativeInt(args.size, "size");
+		if ("error" in sizeResult) {
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-config",
+				field: "size",
+				message: sizeResult.error
+			});
+			else process.stderr.write(`app ratings: ${sizeResult.error}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		if (sizeResult.value === 0) {
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-config",
+				field: "size",
+				message: "--size must be at least 1"
+			});
+			else process.stderr.write("app ratings: --size must be at least 1\n");
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const sortField = args["sort-field"];
+		if (!VALID_SORT_FIELDS.includes(sortField)) {
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-config",
+				field: "sort-field",
+				message: `--sort-field must be one of ${VALID_SORT_FIELDS.join("|")} (got ${JSON.stringify(sortField)})`
+			});
+			else process.stderr.write(`app ratings: invalid --sort-field ${JSON.stringify(sortField)}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const sortDirection = args["sort-direction"];
+		if (!VALID_SORT_DIRECTIONS.includes(sortDirection)) {
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-config",
+				field: "sort-direction",
+				message: `--sort-direction must be one of ${VALID_SORT_DIRECTIONS.join("|")} (got ${JSON.stringify(sortDirection)})`
+			});
+			else process.stderr.write(`app ratings: invalid --sort-direction ${JSON.stringify(sortDirection)}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const ctx = await resolveWorkspaceContext(args);
+		if (!ctx) return;
+		const { session, workspaceId } = ctx;
+		try {
+			const result = await fetchMiniAppRatings({
+				workspaceId,
+				miniAppId: appId,
+				page: pageResult.value,
+				size: sizeResult.value,
+				sortField,
+				sortDirection
+			}, session.cookies);
+			if (args.json) {
+				emitJson({
+					ok: true,
+					workspaceId,
+					appId,
+					page: pageResult.value,
+					size: sizeResult.value,
+					sortField,
+					sortDirection,
+					averageRating: result.averageRating,
+					totalReviewCount: result.totalReviewCount,
+					paging: result.paging,
+					ratings: result.ratings
+				});
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			process.stdout.write(`App ${appId} (ws ${workspaceId}): ${result.totalReviewCount} review(s), avg ${result.averageRating.toFixed(2)}\n`);
+			if (result.ratings.length === 0) {
+				process.stdout.write("No ratings on this page.\n");
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			for (const r of result.ratings) {
+				const score = typeof r.score === "number" ? r.score : r.rating ?? "-";
+				const author = typeof r.nickname === "string" ? r.nickname : typeof r.userName === "string" ? r.userName : "(anon)";
+				const text = typeof r.content === "string" ? r.content : typeof r.reviewContent === "string" ? r.reviewContent : "";
+				const createdAt = typeof r.createdAt === "string" ? r.createdAt : typeof r.reviewedAt === "string" ? r.reviewedAt : "";
+				process.stdout.write(`${score}\t${createdAt}\t${author}\t${text}\n`);
+			}
+			if (result.paging.hasNext) process.stdout.write(`(more: --page ${pageResult.value + 1} for next ${sizeResult.value})\n`);
+			return exitAfterFlush(ExitCode.Ok);
+		} catch (err) {
+			return emitFailureFromError(args.json, err);
+		}
+	}
+});
+const reportsCommand = defineCommand({
+	meta: {
+		name: "reports",
+		description: "List user-submitted reports (신고 내역) for a mini-app."
+	},
+	args: {
+		id: {
+			type: "positional",
+			description: "Mini-app ID.",
+			required: true
+		},
+		workspace: {
+			type: "string",
+			description: "Workspace ID. Defaults to the selected workspace."
+		},
+		"page-size": {
+			type: "string",
+			description: "Page size (default 20).",
+			default: "20"
+		},
+		cursor: {
+			type: "string",
+			description: "Opaque cursor from a previous response `nextCursor`."
+		},
+		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 reports: invalid id ${JSON.stringify(args.id)}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const pageSizeResult = parseNonNegativeInt(args["page-size"], "page-size");
+		if ("error" in pageSizeResult) {
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-config",
+				field: "page-size",
+				message: pageSizeResult.error
+			});
+			else process.stderr.write(`app reports: ${pageSizeResult.error}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		if (pageSizeResult.value === 0) {
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-config",
+				field: "page-size",
+				message: "--page-size must be at least 1"
+			});
+			else process.stderr.write("app reports: --page-size must be at least 1\n");
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const ctx = await resolveWorkspaceContext(args);
+		if (!ctx) return;
+		const { session, workspaceId } = ctx;
+		try {
+			const result = await fetchUserReports({
+				workspaceId,
+				miniAppId: appId,
+				pageSize: pageSizeResult.value,
+				...typeof args.cursor === "string" && args.cursor.length > 0 ? { cursor: args.cursor } : {}
+			}, session.cookies);
+			if (args.json) {
+				emitJson({
+					ok: true,
+					workspaceId,
+					appId,
+					pageSize: pageSizeResult.value,
+					cursor: args.cursor ?? null,
+					nextCursor: result.nextCursor,
+					hasMore: result.hasMore,
+					reports: result.reports
+				});
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			process.stdout.write(`App ${appId} (ws ${workspaceId}): ${result.reports.length} report(s) on this page\n`);
+			if (result.reports.length === 0) {
+				process.stdout.write("No reports.\n");
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			for (const r of result.reports) {
+				const id = typeof r.id === "string" || typeof r.id === "number" ? r.id : "-";
+				const reason = typeof r.reason === "string" ? r.reason : r.reportType ?? "-";
+				const text = typeof r.content === "string" ? r.content : typeof r.detail === "string" ? r.detail : "";
+				const createdAt = typeof r.createdAt === "string" ? r.createdAt : typeof r.reportedAt === "string" ? r.reportedAt : "";
+				process.stdout.write(`${id}\t${createdAt}\t${reason}\t${text}\n`);
+			}
+			if (result.hasMore && result.nextCursor) process.stdout.write(`(more: --cursor ${result.nextCursor})\n`);
+			return exitAfterFlush(ExitCode.Ok);
+		} catch (err) {
+			return emitFailureFromError(args.json, err);
+		}
+	}
+});
+const bundlesCommand = defineCommand({
+	meta: {
+		name: "bundles",
+		description: "Inspect upload bundles for a mini-app."
+	},
+	subCommands: {
+		ls: defineCommand({
+			meta: {
+				name: "ls",
+				description: "List upload bundles for a mini-app (page-based pagination)."
+			},
+			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"
+				},
+				tested: {
+					type: "string",
+					description: "Filter: `true` to show only tested bundles (or `false`)."
+				},
+				"deploy-status": {
+					type: "string",
+					description: "Filter by deploy status (e.g. DEPLOYED)."
+				},
+				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 bundles ls: invalid id ${JSON.stringify(args.id)}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				const pageResult = parseNonNegativeInt(args.page, "page");
+				if ("error" in pageResult) {
+					if (args.json) emitJson({
+						ok: false,
+						reason: "invalid-config",
+						field: "page",
+						message: pageResult.error
+					});
+					else process.stderr.write(`app bundles ls: ${pageResult.error}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				let tested;
+				if (args.tested !== void 0) if (args.tested === "true") tested = true;
+				else if (args.tested === "false") tested = false;
+				else {
+					if (args.json) emitJson({
+						ok: false,
+						reason: "invalid-config",
+						field: "tested",
+						message: `--tested must be "true" or "false" (got ${JSON.stringify(args.tested)})`
+					});
+					else process.stderr.write(`app bundles ls: invalid --tested ${JSON.stringify(args.tested)}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				const ctx = await resolveWorkspaceContext(args);
+				if (!ctx) return;
+				const { session, workspaceId } = ctx;
+				try {
+					const result = await fetchBundles({
+						workspaceId,
+						miniAppId: appId,
+						page: pageResult.value,
+						...tested !== void 0 ? { tested } : {},
+						...typeof args["deploy-status"] === "string" && args["deploy-status"].length > 0 ? { deployStatus: args["deploy-status"] } : {}
+					}, session.cookies);
+					if (args.json) {
+						emitJson({
+							ok: true,
+							workspaceId,
+							appId,
+							page: pageResult.value,
+							totalPage: result.totalPage,
+							currentPage: result.currentPage,
+							bundles: result.contents
+						});
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					process.stdout.write(`App ${appId} (ws ${workspaceId}): page ${result.currentPage + 1}/${Math.max(result.totalPage, 1)}, ${result.contents.length} bundle(s)\n`);
+					if (result.contents.length === 0) {
+						process.stdout.write("No bundles on this page.\n");
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					for (const b of result.contents) {
+						const id = typeof b.id === "string" || typeof b.id === "number" ? b.id : "-";
+						const version = typeof b.version === "string" ? b.version : "-";
+						const status = typeof b.deployStatus === "string" ? b.deployStatus : "-";
+						const createdAt = typeof b.createdAt === "string" ? b.createdAt : "";
+						process.stdout.write(`${id}\t${version}\t${status}\t${createdAt}\n`);
+					}
+					if (result.currentPage + 1 < result.totalPage) process.stdout.write(`(more: --page ${result.currentPage + 1})\n`);
+					return exitAfterFlush(ExitCode.Ok);
+				} catch (err) {
+					return emitFailureFromError(args.json, err);
+				}
+			}
+		}),
+		deployed: defineCommand({
+			meta: {
+				name: "deployed",
+				description: "Show the currently deployed bundle for a mini-app (or null if none)."
+			},
+			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)})`
+					});
+					else process.stderr.write(`app bundles deployed: invalid id ${JSON.stringify(args.id)}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				const ctx = await resolveWorkspaceContext(args);
+				if (!ctx) return;
+				const { session, workspaceId } = ctx;
+				try {
+					const bundle = await fetchDeployedBundle(workspaceId, appId, session.cookies);
+					if (args.json) {
+						emitJson({
+							ok: true,
+							workspaceId,
+							appId,
+							bundle
+						});
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					if (bundle === null) {
+						process.stdout.write(`App ${appId} (ws ${workspaceId}): no deployed bundle\n`);
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					const id = typeof bundle.id === "string" || typeof bundle.id === "number" ? bundle.id : "-";
+					const version = typeof bundle.version === "string" ? bundle.version : "-";
+					const status = typeof bundle.deployStatus === "string" ? bundle.deployStatus : "-";
+					const deployedAt = typeof bundle.deployedAt === "string" ? bundle.deployedAt : "";
+					process.stdout.write(`App ${appId} deployed bundle:\n`);
+					process.stdout.write(`  id          ${id}\n`);
+					process.stdout.write(`  version     ${version}\n`);
+					process.stdout.write(`  status      ${status}\n`);
+					process.stdout.write(`  deployedAt  ${deployedAt}\n`);
+					return exitAfterFlush(ExitCode.Ok);
+				} catch (err) {
+					return emitFailureFromError(args.json, err);
+				}
+			}
+		})
+	}
+});
+const certsCommand = defineCommand({
+	meta: {
+		name: "certs",
+		description: "Inspect mTLS certificates for a mini-app."
+	},
+	subCommands: { ls: defineCommand({
+		meta: {
+			name: "ls",
+			description: "List mTLS certificates issued for a mini-app."
+		},
+		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)})`
+				});
+				else process.stderr.write(`app certs ls: invalid id ${JSON.stringify(args.id)}\n`);
+				return exitAfterFlush(ExitCode.Usage);
+			}
+			const ctx = await resolveWorkspaceContext(args);
+			if (!ctx) return;
+			const { session, workspaceId } = ctx;
+			try {
+				const certs = await fetchCerts(workspaceId, appId, session.cookies);
+				if (args.json) {
+					emitJson({
+						ok: true,
+						workspaceId,
+						appId,
+						certs
+					});
+					return exitAfterFlush(ExitCode.Ok);
+				}
+				if (certs.length === 0) {
+					process.stdout.write(`App ${appId} (ws ${workspaceId}): no mTLS certs\n`);
+					return exitAfterFlush(ExitCode.Ok);
+				}
+				process.stdout.write(`App ${appId} (ws ${workspaceId}): ${certs.length} cert(s)\n`);
+				for (const c of certs) {
+					const id = typeof c.id === "string" || typeof c.id === "number" ? c.id : typeof c.certId === "string" || typeof c.certId === "number" ? c.certId : "-";
+					const cn = typeof c.commonName === "string" ? c.commonName : "-";
+					const createdAt = typeof c.createdAt === "string" ? c.createdAt : "";
+					const expiresAt = typeof c.expiresAt === "string" ? c.expiresAt : typeof c.validUntil === "string" ? c.validUntil : "";
+					process.stdout.write(`${id}\t${cn}\t${createdAt}\t${expiresAt}\n`);
+				}
+				return exitAfterFlush(ExitCode.Ok);
+			} catch (err) {
+				return emitFailureFromError(args.json, err);
+			}
+		}
+	}) }
+});
+const VALID_TIME_UNITS = [
+	"DAY",
+	"WEEK",
+	"MONTH"
+];
+function parseIsoDate(raw, field) {
+	if (!/^\d{4}-\d{2}-\d{2}$/.test(raw)) return { error: `--${field} must be YYYY-MM-DD (got ${JSON.stringify(raw)})` };
+	const d = /* @__PURE__ */ new Date(`${raw}T00:00:00Z`);
+	if (Number.isNaN(d.getTime())) return { error: `--${field} is not a valid date (got ${JSON.stringify(raw)})` };
+	return { value: raw };
+}
+function todayLocalIso() {
+	const d = /* @__PURE__ */ new Date();
+	return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+function daysAgoLocalIso(days) {
+	const d = /* @__PURE__ */ new Date();
+	d.setDate(d.getDate() - days);
+	return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+const appCommand = defineCommand({
+	meta: {
+		name: "app",
+		description: "Inspect mini-apps in a workspace."
+	},
+	subCommands: {
+		ls: lsCommand$4,
+		show: showCommand$2,
+		status: statusCommand,
+		ratings: ratingsCommand,
+		reports: reportsCommand,
+		bundles: bundlesCommand,
+		certs: certsCommand,
+		metrics: defineCommand({
+			meta: {
+				name: "metrics",
+				description: "Show conversion metrics for a mini-app over a date range."
+			},
+			args: {
+				id: {
+					type: "positional",
+					description: "Mini-app ID.",
+					required: true
+				},
+				workspace: {
+					type: "string",
+					description: "Workspace ID. Defaults to the selected workspace."
+				},
+				"time-unit": {
+					type: "string",
+					description: "Bucket size: DAY | WEEK | MONTH.",
+					default: "DAY"
+				},
+				start: {
+					type: "string",
+					description: "Start date (YYYY-MM-DD). Defaults to 30 days before --end."
+				},
+				end: {
+					type: "string",
+					description: "End date (YYYY-MM-DD). Defaults to today (host local)."
+				},
+				refresh: {
+					type: "boolean",
+					description: "Bypass server-side cache.",
+					default: false
+				},
+				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 metrics: invalid id ${JSON.stringify(args.id)}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				const timeUnit = String(args["time-unit"]).toUpperCase();
+				if (!VALID_TIME_UNITS.includes(timeUnit)) {
+					const message = `--time-unit must be one of ${VALID_TIME_UNITS.join("|")} (got ${JSON.stringify(args["time-unit"])})`;
+					if (args.json) emitJson({
+						ok: false,
+						reason: "invalid-time-unit",
+						message
+					});
+					else process.stderr.write(`${message}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				const endResult = parseIsoDate(args.end ? String(args.end) : todayLocalIso(), "end");
+				if ("error" in endResult) {
+					if (args.json) emitJson({
+						ok: false,
+						reason: "invalid-date",
+						message: endResult.error
+					});
+					else process.stderr.write(`${endResult.error}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				const startResult = parseIsoDate(args.start ? String(args.start) : daysAgoLocalIso(30), "start");
+				if ("error" in startResult) {
+					if (args.json) emitJson({
+						ok: false,
+						reason: "invalid-date",
+						message: startResult.error
+					});
+					else process.stderr.write(`${startResult.error}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				if (startResult.value > endResult.value) {
+					const message = `--start (${startResult.value}) must be on or before --end (${endResult.value})`;
+					if (args.json) emitJson({
+						ok: false,
+						reason: "invalid-date",
+						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 fetchConversionMetrics({
+						workspaceId,
+						miniAppId: appId,
+						timeUnitType: timeUnit,
+						startDate: startResult.value,
+						endDate: endResult.value,
+						refresh: args.refresh
+					}, session.cookies);
+					if (args.json) {
+						emitJson({
+							ok: true,
+							workspaceId,
+							appId,
+							timeUnitType: timeUnit,
+							startDate: startResult.value,
+							endDate: endResult.value,
+							...result.cacheTime !== void 0 ? { cacheTime: result.cacheTime } : {},
+							metrics: result.metrics
+						});
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					const header = `App ${appId} (ws ${workspaceId}) · ${timeUnit} · ${startResult.value} → ${endResult.value}`;
+					if (result.metrics.length === 0) {
+						process.stdout.write(`${header}: no metrics\n`);
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					process.stdout.write(`${header}: ${result.metrics.length} bucket(s)\n`);
+					for (const m of result.metrics) {
+						const date = typeof m.date === "string" ? m.date : typeof m.bucketDate === "string" ? m.bucketDate : "";
+						const impressions = typeof m.impressions === "number" ? m.impressions : typeof m.impressionCount === "number" ? m.impressionCount : "";
+						const clicks = typeof m.clicks === "number" ? m.clicks : typeof m.clickCount === "number" ? m.clickCount : "";
+						process.stdout.write(`${date}\t${impressions}\t${clicks}\n`);
+					}
+					return exitAfterFlush(ExitCode.Ok);
+				} catch (err) {
+					return emitFailureFromError(args.json, err);
+				}
+			}
+		}),
+		"share-rewards": defineCommand({
+			meta: {
+				name: "share-rewards",
+				description: "Inspect share-reward promotions for a mini-app."
+			},
+			subCommands: { ls: defineCommand({
+				meta: {
+					name: "ls",
+					description: "List share-reward promotions configured for a mini-app."
+				},
+				args: {
+					id: {
+						type: "positional",
+						description: "Mini-app ID.",
+						required: true
+					},
+					workspace: {
+						type: "string",
+						description: "Workspace ID. Defaults to the selected workspace."
+					},
+					search: {
+						type: "string",
+						description: "Filter by title (server-side title-contains match). Empty matches everything."
+					},
+					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 share-rewards ls: invalid id ${JSON.stringify(args.id)}\n`);
+						return exitAfterFlush(ExitCode.Usage);
+					}
+					const ctx = await resolveWorkspaceContext(args);
+					if (!ctx) return;
+					const { session, workspaceId } = ctx;
+					try {
+						const rewards = await fetchShareRewards({
+							workspaceId,
+							miniAppId: appId,
+							...args.search !== void 0 ? { search: String(args.search) } : {}
+						}, session.cookies);
+						if (args.json) {
+							emitJson({
+								ok: true,
+								workspaceId,
+								appId,
+								rewards
+							});
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						if (rewards.length === 0) {
+							process.stdout.write(`App ${appId} (ws ${workspaceId}): no share-reward promotions\n`);
+							return exitAfterFlush(ExitCode.Ok);
+						}
+						process.stdout.write(`App ${appId} (ws ${workspaceId}): ${rewards.length} share-reward(s)\n`);
+						for (const r of rewards) {
+							const id = typeof r.id === "string" || typeof r.id === "number" ? r.id : typeof r.rewardId === "string" || typeof r.rewardId === "number" ? r.rewardId : "-";
+							const title = typeof r.title === "string" ? r.title : typeof r.name === "string" ? r.name : "-";
+							const status = typeof r.status === "string" ? r.status : "-";
+							process.stdout.write(`${id}\t${title}\t${status}\n`);
+						}
+						return exitAfterFlush(ExitCode.Ok);
+					} catch (err) {
+						return emitFailureFromError(args.json, err);
+					}
+				}
+			}) }
+		}),
+		messages: defineCommand({
+			meta: {
+				name: "messages",
+				description: "Inspect smart-message (formerly push) campaigns for a mini-app."
+			},
+			subCommands: { ls: defineCommand({
+				meta: {
+					name: "ls",
+					description: "List smart-message campaigns (formerly \"push\" — the 스마트 발송 menu)."
+				},
+				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
+					}
+				},
+				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)."
+				},
+				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
+					}
+				},
+				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."
+			},
+			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."
+			},
+			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);
+				}
+			}
+		}),
+		"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)})`
+					});
+					else process.stderr.write(`app service-status: invalid id ${JSON.stringify(args.id)}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				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);
+				}
+			}
+		}),
+		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
+				}
+			},
+			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$1 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
+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$1}/workspaces/${workspaceId}/api-keys`,
+		url: `${BASE$3}/workspaces/${workspaceId}/api-keys`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -1484,7 +3033,8 @@ const keysCommand = defineCommand({
 });
 //#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";
+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,
@@ -1492,6 +3042,28 @@ async function fetchConsoleMemberUserInfo(cookies, opts = {}) {
 		...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
 function isResponse(m) {
@@ -2146,11 +3718,59 @@ 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 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
+const BASE$1 = "https://apps-in-toss.toss.im/console/api-public/v3/appsintossconsole";
 async function fetchWorkspaceMembers(workspaceId, cookies, opts = {}) {
 	const raw = await requestConsoleApi({
-		url: `${BASE}/workspaces/${workspaceId}/members`,
+		url: `${BASE$1}/workspaces/${workspaceId}/members`,
 		cookies,
 		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
 	});
@@ -2235,6 +3855,257 @@ const membersCommand = defineCommand({
 		}
 	}) }
 });
+const BASE = "https://api-public.toss.im/api-public/v3/ipd-thor/api/v1";
+async function fetchNotices(params, cookies, opts = {}) {
+	const qs = new URLSearchParams();
+	qs.set("page", String(params.page ?? 0));
+	qs.set("size", String(params.size ?? 20));
+	if (params.titleContains !== void 0) qs.set("title__icontains", params.titleContains);
+	const raw = await requestConsoleApi({
+		url: `${BASE}/workspaces/129/posts?${qs.toString()}`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object") throw new Error("Unexpected notices shape: not an object");
+	const rec = raw;
+	const resultsRaw = rec.results;
+	if (!Array.isArray(resultsRaw)) throw new Error("Unexpected notices shape: results is not an array");
+	const results = resultsRaw.map((r) => {
+		if (r === null || typeof r !== "object") return {};
+		return r;
+	});
+	return {
+		page: typeof rec.page === "number" ? rec.page : 1,
+		pageSize: typeof rec.pageSize === "number" ? rec.pageSize : params.size ?? 20,
+		count: typeof rec.count === "number" ? rec.count : results.length,
+		next: typeof rec.next === "string" ? rec.next : null,
+		previous: typeof rec.previous === "string" ? rec.previous : null,
+		results
+	};
+}
+async function fetchNoticeCategories(cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${BASE}/workspaces/129/categories`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (!Array.isArray(raw)) throw new Error("Unexpected categories shape: not an array");
+	return raw.map((c) => {
+		if (c === null || typeof c !== "object") return {};
+		return c;
+	});
+}
+async function fetchNoticePost(postId, cookies, opts = {}) {
+	const raw = await requestConsoleApi({
+		url: `${BASE}/workspaces/129/posts/${postId}`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`Unexpected notice-post shape for id=${postId}`);
+	return raw;
+}
+//#endregion
+//#region src/commands/notices.ts
+function parsePositiveInt(raw, field) {
+	const n = Number(raw);
+	if (!Number.isFinite(n) || !Number.isInteger(n) || n < 0) return { error: `--${field} must be a non-negative integer (got ${JSON.stringify(raw)})` };
+	return { value: n };
+}
+const noticesCommand = defineCommand({
+	meta: {
+		name: "notices",
+		description: "Read Apps in Toss notices (공지사항). Shared across all users."
+	},
+	subCommands: {
+		ls: defineCommand({
+			meta: {
+				name: "ls",
+				description: "List notices (공지사항) from Apps in Toss."
+			},
+			args: {
+				page: {
+					type: "string",
+					description: "Page number (0-indexed).",
+					default: "0"
+				},
+				size: {
+					type: "string",
+					description: "Page size.",
+					default: "20"
+				},
+				search: {
+					type: "string",
+					description: "Filter by title substring (case-insensitive)."
+				},
+				json: {
+					type: "boolean",
+					description: "Emit machine-readable JSON.",
+					default: false
+				}
+			},
+			async run({ args }) {
+				const session = await requireSession(args.json);
+				if (!session) return;
+				const pageResult = parsePositiveInt(args.page, "page");
+				if ("error" in pageResult) {
+					if (args.json) emitJson({
+						ok: false,
+						reason: "invalid-config",
+						field: "page",
+						message: pageResult.error
+					});
+					else process.stderr.write(`notices ls: ${pageResult.error}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				const sizeResult = parsePositiveInt(args.size, "size");
+				if ("error" in sizeResult) {
+					if (args.json) emitJson({
+						ok: false,
+						reason: "invalid-config",
+						field: "size",
+						message: sizeResult.error
+					});
+					else process.stderr.write(`notices ls: ${sizeResult.error}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				if (sizeResult.value === 0) {
+					if (args.json) emitJson({
+						ok: false,
+						reason: "invalid-config",
+						field: "size",
+						message: "--size must be at least 1"
+					});
+					else process.stderr.write("notices ls: --size must be at least 1\n");
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				try {
+					const result = await fetchNotices({
+						page: pageResult.value,
+						size: sizeResult.value,
+						...typeof args.search === "string" && args.search.length > 0 ? { titleContains: args.search } : {}
+					}, session.cookies);
+					if (args.json) {
+						emitJson({
+							ok: true,
+							page: result.page,
+							pageSize: result.pageSize,
+							count: result.count,
+							hasNext: result.next !== null,
+							notices: result.results
+						});
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					process.stdout.write(`Notices: page ${result.page}, ${result.results.length}/${result.count} shown\n`);
+					if (result.results.length === 0) {
+						process.stdout.write("No notices on this page.\n");
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					for (const n of result.results) {
+						const id = typeof n.id === "string" || typeof n.id === "number" ? n.id : "-";
+						const category = typeof n.category === "string" ? n.category : "-";
+						const title = typeof n.title === "string" ? n.title : "";
+						const publishedTime = typeof n.publishedTime === "string" ? n.publishedTime : "";
+						process.stdout.write(`${id}\t${publishedTime}\t[${category}]\t${title}\n`);
+					}
+					if (result.next !== null) process.stdout.write(`(more: --page ${result.page + 1})\n`);
+					return exitAfterFlush(ExitCode.Ok);
+				} catch (err) {
+					return emitFailureFromError(args.json, err);
+				}
+			}
+		}),
+		show: defineCommand({
+			meta: {
+				name: "show",
+				description: "Show a single notice post by ID."
+			},
+			args: {
+				id: {
+					type: "positional",
+					description: "Notice post ID.",
+					required: true
+				},
+				json: {
+					type: "boolean",
+					description: "Emit machine-readable JSON.",
+					default: false
+				}
+			},
+			async run({ args }) {
+				const postId = Number(args.id);
+				if (!Number.isFinite(postId) || !Number.isInteger(postId) || postId <= 0) {
+					if (args.json) emitJson({
+						ok: false,
+						reason: "invalid-id",
+						message: `notice id must be a positive integer (got ${JSON.stringify(args.id)})`
+					});
+					else process.stderr.write(`notices show: invalid id ${JSON.stringify(args.id)}\n`);
+					return exitAfterFlush(ExitCode.Usage);
+				}
+				const session = await requireSession(args.json);
+				if (!session) return;
+				try {
+					const notice = await fetchNoticePost(postId, session.cookies);
+					if (args.json) {
+						emitJson({
+							ok: true,
+							id: postId,
+							notice
+						});
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					const title = typeof notice.title === "string" ? notice.title : "";
+					const subtitle = typeof notice.subtitle === "string" ? notice.subtitle : "";
+					const category = typeof notice.category === "string" ? notice.category : "";
+					const publishedTime = typeof notice.publishedTime === "string" ? notice.publishedTime : "";
+					const body = typeof notice.fullDescription === "string" ? notice.fullDescription : typeof notice.shortDescription === "string" ? notice.shortDescription : "";
+					process.stdout.write(`# ${title}\n`);
+					if (subtitle) process.stdout.write(`${subtitle}\n`);
+					process.stdout.write(`\n[${category}] ${publishedTime}\n\n`);
+					process.stdout.write(body);
+					if (!body.endsWith("\n")) process.stdout.write("\n");
+					return exitAfterFlush(ExitCode.Ok);
+				} catch (err) {
+					return emitFailureFromError(args.json, err);
+				}
+			}
+		}),
+		categories: defineCommand({
+			meta: {
+				name: "categories",
+				description: "List notice categories and their post counts."
+			},
+			args: { json: {
+				type: "boolean",
+				description: "Emit machine-readable JSON.",
+				default: false
+			} },
+			async run({ args }) {
+				const session = await requireSession(args.json);
+				if (!session) return;
+				try {
+					const categories = await fetchNoticeCategories(session.cookies);
+					if (args.json) {
+						emitJson({
+							ok: true,
+							categories
+						});
+						return exitAfterFlush(ExitCode.Ok);
+					}
+					for (const c of categories) {
+						const id = typeof c.id === "string" || typeof c.id === "number" ? c.id : "-";
+						const name = typeof c.name === "string" ? c.name : "-";
+						const postCount = typeof c.postCount === "number" ? c.postCount : 0;
+						process.stdout.write(`${id}\t${postCount}\t${name}\n`);
+					}
+					return exitAfterFlush(ExitCode.Ok);
+				} catch (err) {
+					return emitFailureFromError(args.json, err);
+				}
+			}
+		})
+	}
+});
 //#endregion
 //#region src/github.ts
 const REPO_OWNER = "apps-in-toss-community";
@@ -2348,7 +4219,7 @@ function resolveVersion() {
 		if (typeof injected === "string" && injected.length > 0) return injected;
 	} catch {}
 	try {
-		return "0.1.10";
+		return "0.1.12";
 	} catch {}
 	return "0.0.0-dev";
 }
@@ -2601,138 +4472,455 @@ async function runBackgroundUpdateCheck(json) {
 		if (typeof t.unref === "function") t.unref();
 	})]);
 }
-const whoamiCommand = defineCommand({
+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/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
+	};
+}
+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 {
+		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
+	};
+}
+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 {
+		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
+	};
+}
+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)
+		};
+	});
+}
+//#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);
+}
+const lsCommand = 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);
+		}
+	}
+});
+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."
+		},
+		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})`;
+				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 {
+			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) {
+			return emitFailureFromError(args.json, err);
+		}
+	}
+});
+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;
+	}
+	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;
+	}
+	return selected;
+}
+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: {
@@ -2740,62 +4928,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",
@@ -2804,114 +4953,158 @@ const workspaceCommand = defineCommand({
 				}
 			},
 			async run({ args }) {
-				const raw = String(args.id);
-				const parsed = parsePositiveInt(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(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);
 				}
-			}
+			}) }
 		})
 	}
 });
@@ -2931,7 +5124,9 @@ runMain(defineCommand({
 		workspace: workspaceCommand,
 		app: appCommand,
 		members: membersCommand,
-		keys: keysCommand
+		keys: keysCommand,
+		notices: noticesCommand,
+		me: meCommand
 	}
 }));
 //#endregion