@wervt/cli 0.2.7 → 0.2.9

package/dist/index.mjs

@@ -695,6 +695,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 +921,7 @@ runMain(defineCommand({
 		env,
 		tokens,
 		tasks,
+		stats,
 		delete: remove,
 		login,
 		whoami,

package/package.json

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

package/skill/SKILL.md

@@ -49,6 +49,8 @@ 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`.
 - 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