@wervt/cli 0.2.3 → 0.2.4

package/dist/index.mjs

@@ -493,6 +493,61 @@ const tokens = defineCommand({
 		}
 	}
 });
+const tasks = defineCommand({
+	meta: {
+		name: "tasks",
+		description: "List an app's tasks and schedules, or run one now"
+	},
+	args: {
+		app: {
+			type: "positional",
+			required: true,
+			description: "App name"
+		},
+		run: {
+			type: "string",
+			description: "Run this task now and wait for it"
+		},
+		payload: {
+			type: "string",
+			description: "JSON payload for --run"
+		},
+		json: {
+			type: "boolean",
+			description: "Print JSON"
+		},
+		...connection
+	},
+	async run({ args }) {
+		if (args.run) {
+			const payload = args.payload ? JSON.parse(args.payload) : {};
+			const result = await (await api(`/v1/apps/${args.app}/tasks/${encodeURIComponent(args.run)}/run`, args, {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify({ payload })
+			})).json();
+			if (args.json) console.log(JSON.stringify(result));
+			else {
+				const color = result.status === "ok" ? "green" : result.status === "error" ? "red" : "yellow";
+				const took = result.durationMs === void 0 ? "" : ` in ${result.durationMs} ms`;
+				console.log(`${styleText(color, result.status)}${took}${result.error ? `: ${result.error}` : ""}`);
+				if (result.result !== void 0 && result.result !== null) console.log(JSON.stringify(result.result, null, 2));
+			}
+			if (result.status !== "ok") process.exitCode = 1;
+			return;
+		}
+		const list = await (await api(`/v1/apps/${args.app}/tasks`, args)).json();
+		if (args.json) return console.log(JSON.stringify(list));
+		if (!list.tasks.length) return console.log(`${args.app} has no tasks.`);
+		console.log(styleText("dim", `Schedules in ${list.timezone}`));
+		for (const task of list.tasks) {
+			const schedules = task.schedules.length ? task.schedules.map((s) => `${s.cron}${s.next ? styleText("dim", ` (next ${s.next})`) : ""}`).join(", ") : styleText("dim", "manual only");
+			console.log(`${styleText("bold", task.name)}${task.running ? styleText("cyan", " running") : ""}  ${schedules}`);
+			if (task.description) console.log(`  ${styleText("dim", task.description)}`);
+		}
+		console.log(styleText("dim", `\nRecent runs: wervt logs ${args.app} 'type:=Task' --since 1d`));
+	}
+});
 const remove = defineCommand({
 	meta: {
 		name: "delete",
@@ -762,6 +817,7 @@ runMain(defineCommand({
 		access,
 		env,
 		tokens,
+		tasks,
 		delete: remove,
 		login,
 		whoami,

package/package.json

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

package/skill/SKILL.md

@@ -33,7 +33,8 @@ cd <name>
 The app comes with `AGENTS.md`, skills in `.claude/skills/` and a deploy workflow. **Read
 `AGENTS.md` before writing code** and follow it: server routes, valibot validation, Drizzle schema
 and migrations, live data with shapes, users, logging, and what the isolate runtime can't do
-(no filesystem, no child processes, no long-running work, no WebSockets, no cron).
+(no filesystem, no child processes, no long-running work, no WebSockets). Periodic work goes
+into tasks (`defineTask` + `nitro.scheduledTasks`), which wervt runs on schedule.
 
 Before picking a name, run `wervt apps` so you don't overwrite an existing app. If the user named an
 existing app, work in its repository instead.
@@ -90,6 +91,8 @@ release lists the commit.
 pnpm exec wervt apps                           # every app, active release, URL
 pnpm exec wervt releases <name>                # newest first, with commit and author
 pnpm exec wervt logs <name> 'status:>=500' --since 1d --json
+pnpm exec wervt tasks <name>                   # tasks, schedules, next runs
+pnpm exec wervt tasks <name> --run <task>      # run one now
 pnpm exec wervt rollback <name>                # the previous release (migrations stay)
 ```