@duyquangnvx/create-agent-cli 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -4,6 +4,17 @@ What changed in each release of `@duyquangnvx/agent-cli` (the Runtime) and `@duy
 
 ## Unreleased
 
+## v0.17.0 (2026-10-27)
+
+### Added
+
+- A fifth Effect, `act`, for a Command that changes the state of a program already running, such as a page in a browser tab, rather than files or remote services. It is declared as a read Command is, with `run` and the new `ActCommand` type, and cannot declare a Plan or `rows`. Its help says so and that running it again may act again, its `--help --json` gives `"effect": "act"`, and of the Standard flags it gets only `--json`. The agent-cli skill says when to pick `act` over `read` and `write`.
+- The Scaffolder's `AGENTS.md` names the `act` and `serve` Effects beside `read`, `write` and `destructive`.
+
+### Upgrade from v0.16.0
+
+- Nothing to do.
+
 ## v0.16.0 (2026-10-27)
 
 ### Changed

package/dist/bin.js

@@ -6429,6 +6429,7 @@ const FORCE_FLAG = standardFlag("--force", {
 });
 const EFFECT_FLAGS = {
 	read: [JSON_FLAG],
+	act: [JSON_FLAG],
 	write: [JSON_FLAG, DRY_RUN_FLAG],
 	destructive: [
 		JSON_FLAG,
@@ -9115,6 +9116,7 @@ function groupHelp(group, style) {
 }
 const EFFECT_NOTES = {
 	read: "changes nothing",
+	act: "changes the state of a running program, not files or services; may act again each time it runs",
 	write: "changes something; show the Plan with --dry-run",
 	destructive: "changes something hard to undo; show the Plan with --dry-run, run with --confirm",
 	serve: "changes nothing; prints its data at once, then runs until Ctrl-C, which exits 0"
@@ -9504,7 +9506,7 @@ async function execute(command, input, ctx, { dryRun, confirm, yes, page, invoca
 		...input,
 		...page
 	}, ctx), (data, style) => command.render(data, style));
-	if (command.effect === "read") return outcomeOf(await command.run(input, ctx), (data, style) => command.render(data, style));
+	if (command.effect === "read" || command.effect === "act") return outcomeOf(await command.run(input, ctx), (data, style) => command.render(data, style));
 	if (command.effect === "serve") {
 		let end = () => {};
 		const ended = new Promise((resolve) => {
@@ -10253,14 +10255,14 @@ async function runProcess(cli) {
 }
 //#endregion
 //#region package.json
-var version$1 = "0.16.0";
+var version$1 = "0.17.0";
 var description = "Creates a new Agent CLI repository wired to @duyquangnvx/agent-cli.";
 //#endregion
 //#region src/build.ts
 const build = {
-	"sha": "648fa57",
+	"sha": "8bb3938",
 	"dirty": false,
-	"builtAt": "2026-10-27T10:21:48.000Z"
+	"builtAt": "2026-10-27T10:54:44.000Z"
 };
 //#endregion
 //#region src/fill.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duyquangnvx/create-agent-cli",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Creates a new Agent CLI repository wired to @duyquangnvx/agent-cli.",
   "type": "module",
   "engines": {
@@ -20,7 +20,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@duyquangnvx/agent-cli": "0.16.0",
+    "@duyquangnvx/agent-cli": "0.17.0",
     "tsdown": "0.23.0",
     "zod": "4.6.7"
   },

package/template/AGENTS.md

@@ -19,7 +19,7 @@ Greenfield with no deployments or users: change code directly. Breaking changes
 ## Coding standards
 
 - Every Command is declared in `src/cli.ts` with the `defineCommand` that `agentCli<Ports>()` returns: a description, realistic examples, Zod schemas for args and options (with `.describe()` on each field), and its Effect.
-- A Command never prints. A `read` Command returns data from `run` and turns it into short text in `render`. A `write` or `destructive` Command returns a Plan from `plan`, with no side effects, and performs it in `apply`; the Runtime adds `--dry-run`, and `--confirm` for a destructive one.
+- A Command never prints. A `read` Command returns data from `run` and turns it into short text in `render`. An `act` Command, which changes the state of a program already running rather than files or services, does the same with no Plan. A `write` or `destructive` Command returns a Plan from `plan`, with no side effects, and performs it in `apply`; the Runtime adds `--dry-run`, and `--confirm` for a destructive one. A `serve` Command returns data from `start` and keeps running until `ctx.signal` aborts.
 - A Command that writes files names them in `outputs(plan)`, and the Runtime refuses to overwrite one without `--force`. A Command that costs money states it in `cost(plan)`, a sentence or `undefined` when cheap, and the Runtime refuses a costly run without `--yes`.
 - A Command reaches a remote service through a port: an interface in `src/ports.ts`, built by the `ports` factory passed to `defineCli` and read as `ctx.ports`. It writes files through `ctx.files` and runs programs through `ctx.spawn`, so a test replaces each of them.
 - Every error code is declared once in a `defineErrors` table passed to `defineCli({ errors })`, with the Exit class that must act on it and an optional `details` schema, and thrown through `cliError(errors, code, { message, hint })`, whose `hint` names the command to run next. An undeclared code, and anything else thrown, becomes an internal error (exit 70), whose stack trace `{{debugVariable}}=1` shows.