@wervt/cli 0.2.8 → 0.2.10

package/dist/index.mjs

@@ -204,6 +204,15 @@ const deploy = defineCommand({
 			default: true,
 			description: "Build before deploying"
 		},
+		check: {
+			type: "string",
+			description: "Pages to request once the release started, a 5xx fails (default: /)"
+		},
+		"rollback-on-fail": {
+			type: "boolean",
+			default: false,
+			description: "Go back to the previous release when a page check fails"
+		},
 		...connection
 	},
 	async run({ args }) {
@@ -227,7 +236,10 @@ const deploy = defineCommand({
 		spinner.stop(`Packed ${bundle.files} files (${(bundle.data.byteLength / 1024).toFixed(0)} kB)`);
 		spinner.start("Uploading");
 		const source = await deploySource(dir);
-		const res = await api(`/v1/apps/${name}/deploys`, args, {
+		const query = new URLSearchParams();
+		if (args.check !== void 0) query.set("check", args.check);
+		if (args["rollback-on-fail"]) query.set("rollbackOnFail", "1");
+		const res = await api(`/v1/apps/${name}/deploys${query.size ? `?${query}` : ""}`, args, {
 			method: "POST",
 			headers: {
 				"content-type": "application/gzip",
@@ -273,6 +285,15 @@ const deploy = defineCommand({
 					process.exitCode = 1;
 					return;
 				}
+				if (event.step === "check-failed") {
+					const failed = event.failed.map((check) => `${check.path} (${check.status || "no answer"})`).join(", ");
+					p.log.error(`Release ${event.release} started, but failed: ${failed}`);
+					if (event.message) p.log.message(event.message);
+					if (event.restored) p.log.info(`${name} is back on ${event.restored}.`);
+					else p.log.warn(`It stays active. Fix it or run \`wervt rollback ${name}\`.`);
+					process.exitCode = 1;
+					continue;
+				}
 				if (event.step === "storage-failed") {
 					p.log.warn(`Storage isn't set up: ${event.message}. The app runs; files won't work yet.`);
 					continue;
@@ -695,6 +716,73 @@ const logs = defineCommand({
 		for (const entry of entries.reverse()) printLog(entry, Boolean(args.json));
 	}
 });
+const SPARKS = "▁▂▃▄▅▆▇█";
+const stats = defineCommand({
+	meta: {
+		name: "stats",
+		description: "Show an app's visitors, page views and top pages (cookieless analytics)"
+	},
+	args: {
+		app: {
+			type: "positional",
+			required: true,
+			description: "App name"
+		},
+		range: {
+			type: "string",
+			default: "7d",
+			description: "24h, 7d, 30d or 90d"
+		},
+		path: {
+			type: "string",
+			description: "Only views of this path"
+		},
+		referrer: {
+			type: "string",
+			description: "Only visits from this referrer host ('' for direct)"
+		},
+		country: {
+			type: "string",
+			description: "Only visits from this country (ISO code, e.g. DE)"
+		},
+		json: {
+			type: "boolean",
+			description: "Print JSON"
+		},
+		...connection
+	},
+	async run({ args }) {
+		const params = new URLSearchParams({ range: args.range });
+		for (const key of [
+			"path",
+			"referrer",
+			"country"
+		]) if (args[key] !== void 0) params.set(key, args[key]);
+		const report = await (await api(`/v1/apps/${args.app}/analytics?${params.toString()}`, args)).json();
+		if (args.json) return console.log(JSON.stringify(report));
+		const { totals, series } = report;
+		const peak = Math.max(1, ...series.map((point) => point.views));
+		const spark = series.map((point) => point.views ? SPARKS[Math.min(7, Math.floor(point.views / peak * 7.99))] : " ").join("");
+		console.log(`${styleText("bold", String(totals.visitors))} visitors  ${styleText("bold", String(totals.views))} page views` + (totals.users ? `  ${styleText("bold", String(totals.users))} signed-in users` : "") + styleText("dim", `  (last ${report.range}, visitors unique per day)`));
+		console.log(styleText("cyan", spark), styleText("dim", `per ${report.bucket}, peak ${peak}`));
+		const section = (title, rows, none) => {
+			if (!rows.length) return;
+			console.log(`\n${styleText("bold", title)}`);
+			const width = Math.max(...rows.map((row) => String(row.visitors).length));
+			for (const row of rows.slice(0, 5)) console.log(`  ${String(row.visitors).padStart(width)}  ${row.value || styleText("dim", none)}`);
+		};
+		section("Pages", report.top.path, "(none)");
+		section("Referrers", report.top.referrer, "direct");
+		section("Countries", report.top.country, "unknown");
+		section("Devices", report.top.device, "unknown");
+		section("Browsers", report.top.browser, "unknown");
+		if (report.events.length) {
+			console.log(`\n${styleText("bold", "Events")}`);
+			const width = Math.max(...report.events.map((event) => String(event.count).length));
+			for (const event of report.events.slice(0, 10)) console.log(`  ${String(event.count).padStart(width)}  ${event.name}${event.label ? styleText("dim", ` ${event.label}`) : ""}`);
+		}
+	}
+});
 const whoami = defineCommand({
 	meta: {
 		name: "whoami",
@@ -854,6 +942,7 @@ runMain(defineCommand({
 		env,
 		tokens,
 		tasks,
+		stats,
 		delete: remove,
 		login,
 		whoami,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wervt/cli",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "Deploy and manage apps on wervt.",
   "keywords": [
     "agents",

package/skill/SKILL.md

@@ -49,8 +49,10 @@ existing app, work in its repository instead.
   individual designs, Nuxt UI + the `nuxt-ui-mobile` skill for pure phone apps. Details in the
   app's `AGENTS.md`.
 - Users: wervt signs people in. Use `useWervtUser()`; never build login, passwords or OAuth.
-- Browser agents: add a tool in `server/tools/` (`defineTool`) for each main thing a user does in
-  the app, so agents in the browser can do it too (WebMCP). Details in the app's `AGENTS.md`.
+- AI agents: add a tool in `server/tools/` (`defineTool`) for each main thing a user does in the
+  app, so agents can do it too: in the browser (WebMCP) and from Claude Code, Cursor and other
+  MCP clients at `https://<app>.wervt.app/mcp`, signed in through wervt. Details in the app's
+  `AGENTS.md`.
 - After changing `server/db/schema.ts`: `pnpm db:generate`, and commit the migration.
 - `pnpm dev` runs against a local wervt stack, which the user may not have. When it isn't running,
   don't set one up: `pnpm build` plus `pnpm exec vp check --fix` are the checks, and the
@@ -70,9 +72,11 @@ pnpm exec wervt env <name> --set KEY=value        # server env vars, applied fro
   decide that. Private, with the user's email allowed, is the safe default.
 - Secrets for `wervt env` (API keys) come from the user. Ask them to run the command themselves
   (`! pnpm exec wervt env <name> --set API_KEY=…`) instead of pasting the value to you.
-- Then open the URL `wervt deploy` printed (curl it: expect 200, or a redirect to sign-in for
-  private apps) and check `pnpm exec wervt logs <name> 'level:error' --since 15m`. Fix and
-  redeploy until both are clean.
+- `wervt deploy` requests `/` once the release started and fails (exit 1, with the first logged
+  error) on a 5xx. Add the pages you changed: `--check /,/todos,/api/todos`. The checks are
+  anonymous, so pages behind a sign-in only show they don't crash without a user.
+- Then open the URL `wervt deploy` printed and check
+  `pnpm exec wervt logs <name> 'level:error' --since 15m`. Fix and redeploy until both are clean.
 
 ## 5. Deploy on push (when the user wants a repository)