@ait-co/console-cli 0.1.8 → 0.1.10

package/dist/cli.mjs

@@ -204,6 +204,24 @@ 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`,
+		cookies,
+		...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+	});
+	if (raw === null || typeof raw !== "object") throw new Error(`Unexpected with-draft shape for mini-app=${miniAppId}`);
+	const rec = raw;
+	return {
+		current: isRecordOrNull(rec.current) ? rec.current : null,
+		draft: isRecordOrNull(rec.draft) ? rec.draft : null,
+		approvalType: typeof rec.approvalType === "string" ? rec.approvalType : null,
+		rejectedMessage: typeof rec.rejectedMessage === "string" ? rec.rejectedMessage : null
+	};
+}
+function isRecordOrNull(v) {
+	return v === null || typeof v === "object" && !Array.isArray(v);
+}
 async function createMiniApp(workspaceId, payload, cookies, opts = {}) {
 	return normalizeCreateResult(await requestConsoleApi({
 		url: `${BASE$2}/workspaces/${workspaceId}/mini-app/review`,
@@ -1028,64 +1046,312 @@ function reviewStateFor(entry) {
 	const raw = entry.reviewState ?? entry.status;
 	return typeof raw === "string" ? raw : void 0;
 }
+const lsCommand$3 = defineCommand({
+	meta: {
+		name: "ls",
+		description: "List mini-apps in the selected workspace."
+	},
+	args: {
+		workspace: {
+			type: "string",
+			description: "Workspace ID. Defaults to the selected workspace (`aitcc workspace use`)."
+		},
+		json: {
+			type: "boolean",
+			description: "Emit machine-readable JSON to stdout.",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const ctx = await resolveWorkspaceContext(args);
+		if (!ctx) return;
+		const { session, workspaceId } = ctx;
+		try {
+			const [apps, review] = await Promise.all([fetchMiniApps(workspaceId, session.cookies), fetchReviewStatus(workspaceId, session.cookies)]);
+			if (args.json) {
+				const joined = apps.map((app) => {
+					const reviewState = reviewStateFor(findReviewEntry(review.miniApps, app.id));
+					return {
+						id: app.id,
+						name: app.name ?? null,
+						...reviewState !== void 0 ? { reviewState } : {},
+						extra: app.extra
+					};
+				});
+				emitJson({
+					ok: true,
+					workspaceId,
+					hasPolicyViolation: review.hasPolicyViolation,
+					apps: joined
+				});
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			if (apps.length === 0) {
+				process.stdout.write(`No apps in workspace ${workspaceId}.\n`);
+				if (review.hasPolicyViolation) process.stderr.write("Note: workspace-wide policy violation flag is set.\n");
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			for (const app of apps) {
+				const reviewState = reviewStateFor(findReviewEntry(review.miniApps, app.id)) ?? "-";
+				const name = app.name ?? "(unnamed)";
+				process.stdout.write(`${app.id}\t${name}\t${reviewState}\n`);
+			}
+			if (review.hasPolicyViolation) process.stderr.write("Note: workspace-wide policy violation flag is set.\n");
+			return exitAfterFlush(ExitCode.Ok);
+		} catch (err) {
+			return emitFailureFromError(args.json, err);
+		}
+	}
+});
+function pickMiniAppView(envelope, view) {
+	const extract = (side) => {
+		if (side === null) return null;
+		const ma = side.miniApp;
+		if (ma !== null && typeof ma === "object" && !Array.isArray(ma)) return ma;
+		return null;
+	};
+	const draft = extract(envelope.draft);
+	const current = extract(envelope.current);
+	if (view === "draft") return draft;
+	if (view === "current") return current;
+	if (current !== null && draft !== null) return {
+		...current,
+		...draft
+	};
+	return draft ?? current;
+}
+function parseAppId(raw) {
+	if (raw === void 0 || raw === "") return null;
+	const n = Number(raw);
+	if (!Number.isFinite(n) || !Number.isInteger(n) || n <= 0) return null;
+	return n;
+}
+const showCommand$1 = defineCommand({
+	meta: {
+		name: "show",
+		description: "Show full details of a mini-app, including fields only visible in the draft view."
+	},
+	args: {
+		id: {
+			type: "positional",
+			description: "Mini-app ID (the numeric `appId` from `app ls` or `app register`).",
+			required: true
+		},
+		workspace: {
+			type: "string",
+			description: "Workspace ID. Defaults to the selected workspace."
+		},
+		view: {
+			type: "string",
+			description: "Which view to render: `draft` (default), `current`, or `merged`.",
+			default: "draft"
+		},
+		json: {
+			type: "boolean",
+			description: "Emit machine-readable JSON to stdout.",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const appId = parseAppId(args.id);
+		if (appId === null) {
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-id",
+				message: `app id must be a positive integer (got ${JSON.stringify(args.id)})`
+			});
+			else process.stderr.write(`app show: invalid id ${JSON.stringify(args.id)}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const view = args.view;
+		if (view !== "draft" && view !== "current" && view !== "merged") {
+			if (args.json) emitJson({
+				ok: false,
+				reason: "invalid-config",
+				field: "view",
+				message: `--view must be one of draft|current|merged (got ${JSON.stringify(view)})`
+			});
+			else process.stderr.write(`app show: invalid --view ${JSON.stringify(view)}\n`);
+			return exitAfterFlush(ExitCode.Usage);
+		}
+		const ctx = await resolveWorkspaceContext(args);
+		if (!ctx) return;
+		const { session, workspaceId } = ctx;
+		try {
+			const envelope = await fetchMiniAppWithDraft(workspaceId, appId, session.cookies);
+			const miniApp = pickMiniAppView(envelope, view);
+			if (args.json) {
+				emitJson({
+					ok: true,
+					workspaceId,
+					appId,
+					view,
+					miniApp
+				});
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			if (miniApp === null) {
+				if (view === "current" && envelope.draft !== null) process.stdout.write(`App ${appId} has no \`current\` view yet (not reviewed). Try --view draft.\n`);
+				else process.stdout.write(`App ${appId} has no data for view=${view}.\n`);
+				return exitAfterFlush(ExitCode.Ok);
+			}
+			const pick = (k) => {
+				const v = miniApp[k];
+				return v === null || v === void 0 ? "-" : String(v);
+			};
+			const images = Array.isArray(miniApp.images) ? miniApp.images : [];
+			const impression = miniApp.impression !== null && typeof miniApp.impression === "object" ? miniApp.impression : {};
+			const keywords = Array.isArray(impression.keywordList) ? impression.keywordList : [];
+			const categoryPaths = Array.isArray(impression.categoryPaths) ? impression.categoryPaths : [];
+			process.stdout.write(`# App ${appId} (view=${view})\n\n`);
+			process.stdout.write(`Name (ko)      ${pick("title")}\n`);
+			process.stdout.write(`Name (en)      ${pick("titleEn")}\n`);
+			process.stdout.write(`App slug       ${pick("appName")}\n`);
+			process.stdout.write(`Status         ${pick("status")}\n`);
+			process.stdout.write(`Home page      ${pick("homePageUri")}\n`);
+			process.stdout.write(`CS email       ${pick("csEmail")}\n`);
+			process.stdout.write(`Logo           ${pick("iconUri")}\n`);
+			process.stdout.write(`Subtitle       ${pick("description")}\n`);
+			const detail = typeof miniApp.detailDescription === "string" ? `${[...miniApp.detailDescription].length} chars` : "-";
+			process.stdout.write(`Detail desc    ${detail}\n`);
+			process.stdout.write(`Images         ${images.length}\n`);
+			process.stdout.write(`Keywords       ${keywords.length} (${keywords.join(", ")})\n`);
+			const firstPath = categoryPaths[0];
+			if (firstPath && typeof firstPath === "object") {
+				const fp = firstPath;
+				const parts = [];
+				for (const key of [
+					"group",
+					"category",
+					"subCategory"
+				]) {
+					const node = fp[key];
+					if (node !== null && typeof node === "object") {
+						const nm = node.name;
+						if (typeof nm === "string") parts.push(nm);
+					}
+				}
+				process.stdout.write(`Category       ${parts.join(" > ") || "-"}\n`);
+			} else process.stdout.write(`Category       -\n`);
+			return exitAfterFlush(ExitCode.Ok);
+		} catch (err) {
+			return emitFailureFromError(args.json, err);
+		}
+	}
+});
+function deriveReviewState(env) {
+	const hasCurrent = env.current !== null;
+	const hasDraft = env.draft !== null;
+	const approvalType = env.approvalType;
+	const rejectedMessage = env.rejectedMessage;
+	let state;
+	if (approvalType === null) state = "not-submitted";
+	else if (rejectedMessage !== null) state = "rejected";
+	else if (!hasCurrent) state = "under-review";
+	else if (hasDraft) state = "approved-with-edits";
+	else state = "approved";
+	if (approvalType !== null && approvalType !== "REVIEW" && state === "under-review") state = "unknown";
+	return {
+		state,
+		approvalType,
+		rejectedMessage,
+		hasCurrent,
+		hasDraft
+	};
+}
+const POLL_MIN_INTERVAL_SEC = 30;
+const POLL_MAX_INTERVAL_SEC = 3600;
 const appCommand = defineCommand({
 	meta: {
 		name: "app",
 		description: "Inspect mini-apps in a workspace."
 	},
 	subCommands: {
-		ls: defineCommand({
+		ls: lsCommand$3,
+		show: showCommand$1,
+		status: defineCommand({
 			meta: {
-				name: "ls",
-				description: "List mini-apps in the selected workspace."
+				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 (`aitcc workspace use`)."
+					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 to stdout.",
+					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 [apps, review] = await Promise.all([fetchMiniApps(workspaceId, session.cookies), fetchReviewStatus(workspaceId, session.cookies)]);
-					if (args.json) {
-						const joined = apps.map((app) => {
-							const reviewState = reviewStateFor(findReviewEntry(review.miniApps, app.id));
-							return {
-								id: app.id,
-								name: app.name ?? null,
-								...reviewState !== void 0 ? { reviewState } : {},
-								extra: app.extra
-							};
-						});
-						emitJson({
-							ok: true,
-							workspaceId,
-							hasPolicyViolation: review.hasPolicyViolation,
-							apps: joined
-						});
+					const once = async () => {
+						return deriveReviewState(await fetchMiniAppWithDraft(workspaceId, appId, session.cookies));
+					};
+					if (!args.watch) {
+						emit(await once());
 						return exitAfterFlush(ExitCode.Ok);
 					}
-					if (apps.length === 0) {
-						process.stdout.write(`No apps in workspace ${workspaceId}.\n`);
-						if (review.hasPolicyViolation) process.stderr.write("Note: workspace-wide policy violation flag is set.\n");
-						return exitAfterFlush(ExitCode.Ok);
-					}
-					for (const app of apps) {
-						const reviewState = reviewStateFor(findReviewEntry(review.miniApps, app.id)) ?? "-";
-						const name = app.name ?? "(unnamed)";
-						process.stdout.write(`${app.id}\t${name}\t${reviewState}\n`);
+					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));
 					}
-					if (review.hasPolicyViolation) process.stderr.write("Note: workspace-wide policy violation flag is set.\n");
-					return exitAfterFlush(ExitCode.Ok);
 				} catch (err) {
 					return emitFailureFromError(args.json, err);
 				}
@@ -2082,7 +2348,7 @@ function resolveVersion() {
 		if (typeof injected === "string" && injected.length > 0) return injected;
 	} catch {}
 	try {
-		return "0.1.8";
+		return "0.1.10";
 	} catch {}
 	return "0.0.0-dev";
 }