@ubean/cli 0.5.0 → 0.5.2

package/dist/cli.js

@@ -2,7 +2,7 @@ import { A as summarizeBundle, D as compareBundleBaseline, E as createFsOps, O a
 import { existsSync, mkdirSync, readFileSync, watch } from "node:fs";
 import { basename, join, relative, resolve } from "pathe";
 import { extname, normalize, sep } from "node:path";
-import { getLogger, setDebugLogging } from "@ubean/shared/logger";
+import { getLogger, setDebugLogging, setMinLevel } from "@ubean/shared/logger";
 import { defineCommand, runMain } from "citty";
 import { BUILTIN_MODULES, isBuiltinDisabled, loadUbeanConfig, resolveModules, resolvePrerenderConfig, resolveSsrConfig } from "@ubean/config";
 import { mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
@@ -22,7 +22,7 @@ import { ubeanPlugin } from "@ubean/build/vite";
 import { VUE_PLUGIN_INCLUDE, ubeanVite } from "@ubean/build/vue";
 import { getVueLocaleParam, toVueRouterLocalePath } from "@ubean/i18n";
 import { ubeanIslandsPlugin } from "@ubean/islands/vite";
-import { findAvailablePort, findUserViteConfig, waitForPort } from "@ubean/shared/node";
+import { findAvailablePort, findUserViteConfig, getLanAddresses, isLoopbackHost, isWildcardHost, waitForPort } from "@ubean/shared/node";
 import { execSync, spawn } from "node:child_process";
 //#region src/config.ts
 const logger$11 = getLogger("cli");
@@ -490,6 +490,32 @@ const buildCommand = {
 //#region src/dev-server/vite-server.ts
 const logger$8 = getLogger("dev-server");
 /**
+* 收编 Vite 原生日志(hmr update、依赖预构建提示等)到 ubean 分类闸门:
+* - info 级别(如 `[vite] hmr update /src/x.vue`)默认静默;`logging.lifecycle` 开启时以 `[vite]` 前缀透传
+* - warn/error 始终透传(不可静默)
+*/
+function createGatedViteLogger(logging) {
+	return {
+		info(msg) {
+			if (logging.lifecycle) logger$8.info(`[vite] ${msg}`);
+		},
+		warn(msg) {
+			logger$8.warn(msg);
+		},
+		warnOnce(msg) {
+			logger$8.warn(msg);
+		},
+		error(msg) {
+			logger$8.error(msg);
+		},
+		clearScreen() {},
+		hasWarned: false,
+		hasErrorLogged() {
+			return false;
+		}
+	};
+}
+/**
 * Compute the vue-router locale param (e.g. `:locale(zh)?`) from the resolved
 * i18n routing config, mirroring `localeVueParamFromI18n` (`@ubean/build`).
 * Returns `''` when i18n is disabled or no prefix is needed.
@@ -760,6 +786,7 @@ async function createViteDevServer(options) {
 	viteServer = await createServer$1({
 		root: cwd,
 		configFile: userViteConfig ?? false,
+		customLogger: createGatedViteLogger({ lifecycle: config.logging.lifecycle }),
 		resolve: { dedupe: ["vue", "vue-router"] },
 		server: {
 			middlewareMode: { server: httpServer },
@@ -867,7 +894,9 @@ async function createViteDevServer(options) {
 		app.resetInit();
 	}
 	enhanceAppWithVite(currentApp, currentLayouts);
-	const getUrl = () => `http://${host}:${actualPort}`;
+	const displayHost = isWildcardHost(host) ? "localhost" : host;
+	const getNetworkUrls = () => isLoopbackHost(host) ? [] : getLanAddresses().map((address) => `http://${address}:${actualPort}`);
+	const getUrl = () => `http://${displayHost}:${actualPort}`;
 	return {
 		get port() {
 			return actualPort;
@@ -902,7 +931,8 @@ async function createViteDevServer(options) {
 			options.onListen?.({
 				port: actualPort,
 				host,
-				url: getUrl()
+				url: getUrl(),
+				networkUrls: getNetworkUrls()
 			});
 		},
 		async stop() {
@@ -969,12 +999,13 @@ var ViteNodeDevRunner = class {
 			app: this.currentApp,
 			layouts: this.currentLayouts,
 			devtools: this.options.devtools,
-			onListen: ({ port, host, url }) => {
+			onListen: ({ port, host, url, networkUrls }) => {
 				this._port = port;
 				this.options.onListen?.({
 					port,
 					host,
-					url
+					url,
+					networkUrls
 				});
 			}
 		});
@@ -1096,7 +1127,13 @@ function formatDiagnostics(diagnostics) {
 		warnings
 	};
 }
-function logDiagnostics(diagnostics) {
+/**
+* 输出能力诊断结果。
+*
+* `'auto'` 语义(默认):健康时静默 —— "All capability checks passed" 仅在
+* `verbose` 时输出;告警/错误属于 warn/error 级别,始终输出。
+*/
+function logDiagnostics(diagnostics, options = {}) {
 	const { errors, warnings } = formatDiagnostics(diagnostics);
 	if (errors.length > 0) {
 		logger$7.error(`Capability errors (${errors.length}):`);
@@ -1106,7 +1143,7 @@ function logDiagnostics(diagnostics) {
 		logger$7.warn(`Capability warnings (${warnings.length}):`);
 		for (const w of warnings) logger$7.warn(w);
 	}
-	if (errors.length === 0 && warnings.length === 0) logger$7.info("All capability checks passed");
+	if (errors.length === 0 && warnings.length === 0 && options.verbose) logger$7.info("All capability checks passed");
 }
 //#endregion
 //#region src/dev.ts
@@ -1160,6 +1197,14 @@ const devCommand = {
 			description: "Exit if the port is already in use, instead of auto-incrementing",
 			default: false
 		},
+		verbose: {
+			type: "boolean",
+			description: "Show detailed startup logs (directories, scan, codegen, diagnostics, reload events)"
+		},
+		logRequests: {
+			type: "boolean",
+			description: "Log each request (GET /path 200 12ms). Ignored in ssg/spa modes."
+		},
 		open: {
 			type: "boolean",
 			description: "Open browser on startup"
@@ -1172,27 +1217,47 @@ const devCommand = {
 	},
 	async run({ args }) {
 		const cwd = resolve(args.cwd || process.cwd());
-		logger$6.info("Starting ubean dev server...");
 		registerBuiltinPresets();
 		const config = await loadUbeanConfig(cwd);
+		const logging = config.logging;
+		if (args.verbose) {
+			logging.scan = true;
+			logging.lifecycle = true;
+			logging.diagnostics = true;
+		}
+		if (args.logRequests) {
+			logging.request = true;
+			logging.requestSuppressed = false;
+		}
+		const backendCapable = config.mode === "fullstack" || config.mode === "backend";
+		if (logging.request && !backendCapable) {
+			logging.request = false;
+			logging.requestSuppressed = true;
+		}
+		if (logging.requestSuppressed) logger$6.warn(`Request logging is not applicable in "${config.mode}" mode — skipping.`);
+		setMinLevel(logging.level);
+		const startedAt = Date.now();
+		if (logging.lifecycle) logger$6.info("Starting ubean dev server...");
 		const port = Number(args.port) || config.dev.port;
 		const host = args.host || config.dev.host;
-		logger$6.info(`Root directory: ${config.rootDir}`);
-		logger$6.info(`Source directory: ${config.srcDir}`);
 		const preset = resolvePresetByName(config.build.preset);
-		logger$6.info(`Preset: ${preset.name}`);
+		if (logging.scan) {
+			logger$6.info(`Root directory: ${config.rootDir}`);
+			logger$6.info(`Source directory: ${config.srcDir}`);
+			logger$6.info(`Preset: ${preset.name}`);
+		}
 		const capabilities = createCapabilitySet(preset.capabilities || {});
-		logger$6.info("Running capability diagnostics...");
+		if (logging.scan) logger$6.info("Running capability diagnostics...");
 		const diagnostics = diagnoseCapabilities(preset.name, preset.capabilities || {}, NODE_REQUIREMENTS);
-		logDiagnostics(diagnostics);
+		logDiagnostics(diagnostics, { verbose: logging.diagnostics });
 		if (!diagnostics.valid) logger$6.warn("Some capability requirements are not met. Dev server may not function correctly.");
-		let { app: currentApp, layouts: currentLayouts, scanResult: currentScanResult } = await buildApp(cwd, config);
+		let { app: currentApp, layouts: currentLayouts, scanResult: currentScanResult } = await buildApp(cwd, config, logging);
 		let rescanInProgress = false;
 		async function rescan() {
 			if (rescanInProgress) return;
 			rescanInProgress = true;
 			try {
-				const { app: newApp, layouts: newLayouts, scanResult } = await buildApp(cwd, config);
+				const { app: newApp, layouts: newLayouts, scanResult } = await buildApp(cwd, config, logging);
 				currentApp = newApp;
 				currentLayouts = newLayouts;
 				currentScanResult = scanResult;
@@ -1205,6 +1270,8 @@ const devCommand = {
 				rescanInProgress = false;
 			}
 		}
+		let reloadStartedAt = Date.now();
+		let lastChangedFile = null;
 		const runner = await createDevRunner({
 			cwd,
 			srcDir: config.srcDir,
@@ -1232,25 +1299,36 @@ const devCommand = {
 				getCustomTabs: () => getCustomTabs(),
 				triggerRescan: () => rescan()
 			},
-			onListen({ url }) {
+			onListen({ url, networkUrls }) {
 				const label = (text) => dim(text);
-				const lines = [`${green(bold("🚀 ubean dev server ready"))}\n`, `  → ${label("Local:")}      ${cyan(url)}`];
+				const modeSuffix = dim(` (${config.mode} · ${preset.name})`);
+				const lines = [
+					`${green(bold(`🚀 ubean dev server ready in ${Date.now() - startedAt}ms`))}${modeSuffix}\n`,
+					`  → ${label("Local:")}      ${cyan(url)}`,
+					...(networkUrls || []).map((n) => `  → ${label("Network:")}    ${cyan(n)}`)
+				];
 				const hasBackend = config.mode !== "ssg" && config.mode !== "spa";
 				if (hasBackend) lines.push(`  → ${label("Scalar UI:")}  ${cyan(`${url}/_scalar`)}`, `  → ${label("OpenAPI:")}    ${cyan(`${url}/_openapi.json`)}`);
 				if (config.devtools.enabled) lines.push(`  → ${label("DevTools:")}   ${cyan(`${url}${config.devtools.route}`)}`);
 				lines.push(`  → ${dim("Press Ctrl+C to stop")}`);
 				logger$6.info(lines.join("\n"));
 				if (hasBackend) generateOpenApiTypesFromServer(url, { outDir: resolve(cwd, ".ubean") }).then((filePath) => {
-					if (filePath) logger$6.info(`OpenAPI types generated: ${filePath}`);
+					if (filePath && logging.scan) logger$6.info(`OpenAPI types generated: ${filePath}`);
 				}).catch((err) => {
 					logger$6.warn(`Failed to generate OpenAPI types: ${err instanceof Error ? err.message : String(err)}`);
 				});
 			},
 			onBeforeReload() {
-				logger$6.info("Reloading...");
+				reloadStartedAt = Date.now();
+				if (logging.lifecycle) logger$6.info("Reloading...");
 			},
 			onAfterReload() {
-				logger$6.info("Reloaded");
+				if (logging.lifecycle) logger$6.info("Reloaded");
+				else {
+					const file = lastChangedFile ? dim(` · ${lastChangedFile}`) : "";
+					logger$6.info(dim(`↻ Reloaded in ${Date.now() - reloadStartedAt}ms${file}`));
+				}
+				lastChangedFile = null;
 			}
 		});
 		try {
@@ -1279,13 +1357,14 @@ const devCommand = {
 			async onChange(events) {
 				const relevantEvents = events.filter((e) => /\.(ts|js|vue|mjs|cjs|json)$/.test(e.relativePath) && !e.relativePath.includes(".bak"));
 				if (relevantEvents.length === 0) return;
-				logger$6.info(`File change detected: ${relevantEvents[0].relativePath}`);
+				lastChangedFile = relevantEvents[0].relativePath;
+				if (logging.lifecycle) logger$6.info(`File change detected: ${lastChangedFile}`);
 				await rescan();
 			}
 		});
 		watcher.start();
 		const cleanup = async () => {
-			logger$6.info("\nShutting down...");
+			if (logging.lifecycle) logger$6.info("\nShutting down...");
 			watcher.stop();
 			await runner.stop();
 			process.exit(0);
@@ -1294,16 +1373,20 @@ const devCommand = {
 		process.on("SIGTERM", cleanup);
 	}
 };
-async function buildApp(cwd, config) {
-	logger$6.info("Scanning project files...");
+/** 默认跳过请求日志的内部路径前缀(`/_health`、`/_devtools`、`/_openapi.json`、Vite 内部 `/@id/...` 等)。 */
+const REQUEST_LOG_INTERNAL_PREFIXES = ["/_", "/@"];
+/** 请求日志中,超过该毫秒数的请求提升为 warn(慢请求告警)。 */
+const REQUEST_LOG_SLOW_THRESHOLD = 1e3;
+async function buildApp(cwd, config, logging) {
+	if (logging.scan) logger$6.info("Scanning project files...");
 	const result = await scanProject({
 		cwd,
 		srcDir: config.srcDir,
 		dirs: config.dir,
 		ignore: config.scanOptions?.ignore
 	});
-	logger$6.info(`Found ${result.apiRoutes.length} API routes, ${result.pages.length} pages, ${result.layouts.length} layouts, ${result.middlewares.length} middlewares, ${result.plugins.length} plugins`);
-	logger$6.info("Generating type definitions...");
+	if (logging.scan) logger$6.info(`Found ${result.apiRoutes.length} API routes, ${result.pages.length} pages, ${result.layouts.length} layouts, ${result.middlewares.length} middlewares, ${result.plugins.length} plugins`);
+	if (logging.scan) logger$6.info("Generating type definitions...");
 	await generateTypes(result, {
 		cwd,
 		srcDir: config.srcDir,
@@ -1336,9 +1419,29 @@ async function buildApp(cwd, config) {
 		cache: config.cache,
 		seoConventions: { srcDir: resolve(cwd, config.srcDir) }
 	});
+	const requestStartTimes = /* @__PURE__ */ new WeakMap();
+	const isInternalPath = (path) => REQUEST_LOG_INTERNAL_PREFIXES.some((p) => path.startsWith(p));
 	app.hooks.hook("request:start", (c) => {
+		requestStartTimes.set(c, Date.now());
 		logger$6.debug(`${c.req.method} ${c.req.path}`);
 	});
+	app.hooks.hook("request:end", (c, res) => {
+		if (!logging.request) return;
+		const start = requestStartTimes.get(c);
+		const duration = start === void 0 ? 0 : Date.now() - start;
+		const line = `${c.req.method} ${c.req.path} ${res.status} ${duration}ms`;
+		if (res.status >= 500) {
+			logger$6.error(line);
+			return;
+		}
+		if (isInternalPath(c.req.path)) return;
+		if (res.status >= 400 || duration >= REQUEST_LOG_SLOW_THRESHOLD) logger$6.warn(line);
+		else logger$6.info(line);
+	});
+	app.hooks.hook("request:error", (c, err) => {
+		if (!logging.request) return;
+		logger$6.error(`${c.req.method} ${c.req.path} ERROR ${err instanceof Error ? err.message : String(err)}`);
+	});
 	return {
 		app,
 		layouts: result.layouts,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/cli",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "CLI for ubean (ubean-next binary: dev, build, prepare, init, preview, page, env, config, devtools, api/layout/middleware/cron/plugin scaffolds) plus the Vite dev server runner",
   "bin": {
     "ubean-next": "./bin/ubean-next.mjs"
@@ -24,15 +24,15 @@
     }
   },
   "dependencies": {
-    "@ubean/app": "0.5.0",
-    "@ubean/build": "0.5.0",
-    "@ubean/client": "0.5.0",
-    "@ubean/config": "0.5.0",
-    "@ubean/i18n": "0.5.0",
-    "@ubean/islands": "0.5.0",
-    "@ubean/preset": "0.5.0",
-    "@ubean/scan": "0.5.0",
-    "@ubean/shared": "0.5.0",
+    "@ubean/app": "0.5.2",
+    "@ubean/build": "0.5.2",
+    "@ubean/client": "0.5.2",
+    "@ubean/config": "0.5.2",
+    "@ubean/i18n": "0.5.2",
+    "@ubean/islands": "0.5.2",
+    "@ubean/preset": "0.5.2",
+    "@ubean/scan": "0.5.2",
+    "@ubean/shared": "0.5.2",
     "citty": "^0.2.2",
     "kolorist": "^1.8.0",
     "pathe": "^2.0.3"
@@ -45,8 +45,8 @@
     "vite-plus": "0.3.1"
   },
   "peerDependencies": {
-    "@ubean/content": "0.5.0",
-    "@ubean/devtools": "0.5.0",
+    "@ubean/content": "0.5.2",
+    "@ubean/devtools": "0.5.2",
     "@vitejs/plugin-vue": "^6.0.8",
     "vite": "npm:@voidzero-dev/vite-plus-core@0.3.1"
   },