@duyquangnvx/create-agent-cli 0.24.0 → 0.26.0

package/CHANGELOG.md

@@ -4,6 +4,22 @@ What changed in each release of `@duyquangnvx/agent-cli` (the Runtime) and `@duy
 
 ## Unreleased
 
+## v0.26.0 (2026-11-06)
+
+### Added
+
+- `ctx.dryRun` tells a Command whether the run is a dry run: true only in the `plan` of a run given `--dry-run`, false in `apply` and in every Command without a Plan. A plan whose reads change something of their own, such as a stored login, can skip that change without reading the command line.
+
+## v0.25.0 (2026-11-05)
+
+### Changed
+
+- **Breaking:** a failure of Exit class `wait`, such as `DEADLINE_EXCEEDED` or a pending approval, prints `wait:` rather than `error:` in text mode, in yellow, since nothing is broken yet. Its exit code, hint, Next steps and `--json` form stay as they were. Root help describes exit 75 as "not done yet: do what the hint says, then run it again". A CLI whose tests pin these strings updates them.
+
+### Fixed
+
+- The Scaffolder's README sentence to paste keeps its `<your task>` placeholder when rendered. A CLI that exists already adds the backticks to that line in its README.
+
 ## v0.24.0 (2026-11-05)
 
 ### Added

package/dist/bin.js

@@ -6033,11 +6033,15 @@ function printedDetail(error, format) {
 	const value = Reflect.get(details, key);
 	return typeof value === "string" ? value : void 0;
 }
+function labelOf(error, { isBug, isWait, style }) {
+	if (isWait(error)) return style.yellow("wait:");
+	return style.red(isBug(error) ? "internal error:" : "error:");
+}
 function errorLines(error, format) {
 	const fields = fieldsOf$1(error, format);
 	const blocks = [printedDetail(error, format), debugTrace(error, format)].filter((block) => block !== void 0);
 	const { style } = format;
-	const label = style.red(format.isBug(error) ? "internal error:" : "error:");
+	const label = labelOf(error, format);
 	const between = blocks.map((block) => `${block}\n`).join("");
 	const runs = (fields.next ?? []).map((line) => `${style.cyan("run:")} ${line}\n`).join("");
 	return `${label} ${fields.message}\n${between}${style.cyan("hint:")} ${fields.hint}\n${runs}`;
@@ -7085,9 +7089,9 @@ function secretRows(secrets, commands) {
 /** The bundler's stamp, absent when the CLI runs unbundled. Read per call, so a test can define it. */
 function buildStamp() {
 	return {
-		"sha": "45caa4e",
+		"sha": "ed7073b",
 		"dirty": false,
-		"builtAt": "2026-11-05T07:43:22.000Z"
+		"builtAt": "2026-11-06T05:43:19.000Z"
 	};
 }
 /** The first line of `--version`: the version, and the commit and time of a stamped build. */
@@ -9367,6 +9371,9 @@ function exitClassOfOne(error, errors) {
 function isBug(error, errors) {
 	return exitClassOfOne(error, errors) === "bug";
 }
+function isWait(error, errors) {
+	return exitClassOfOne(error, errors) === "wait";
+}
 const ACT_FIRST = [
 	"caller",
 	"operator",
@@ -10023,7 +10030,7 @@ const EXIT_MEANINGS = {
 	caller: "the caller fixes its command",
 	operator: "the operator acts on their machine",
 	source: "someone at the source acts",
-	wait: "nobody acts: wait, then run it again"
+	wait: "not done yet: do what the hint says, then run it again"
 };
 function exitCodeRows(cli) {
 	return [
@@ -10207,7 +10214,8 @@ function errorText(error, format) {
 	const text = formatRuntimeError(error, {
 		...format,
 		runAs: format.invocation.runAs,
-		isBug: (each) => isBug(each, format.errors)
+		isBug: (each) => isBug(each, format.errors),
+		isWait: (each) => isWait(each, format.errors)
 	});
 	const { usageHelp, json } = format;
 	return usageHelp !== void 0 && !json && error instanceof UsageError ? `${text}\n${usageHelp}` : text;
@@ -11231,7 +11239,7 @@ function portsBaseOf(scope, signal) {
 	};
 }
 function contextOf(portsBase, control, parts) {
-	const { ports, project, force, secrets = [], rerun, deliver, notice } = parts;
+	const { ports, project, force, dryRun, secrets = [], rerun, deliver, notice } = parts;
 	const declared = new Set(secrets.map(({ name }) => name));
 	return {
 		...portsBase,
@@ -11249,6 +11257,7 @@ function contextOf(portsBase, control, parts) {
 		},
 		project,
 		force,
+		dryRun,
 		rerun,
 		poll: (check, { intervalMs, signal: stop }) => poll(portsBase.clock, check, intervalMs, stop === void 0 ? control.signal : AbortSignal.any([control.signal, stop])),
 		deliver,
@@ -11372,6 +11381,7 @@ async function runCommand(cli, routed, options, write, baseFormat) {
 		ports: once(() => ports(portsBase)),
 		project,
 		force: flags.force,
+		dryRun: flags.dryRun,
 		secrets: command.secrets,
 		rerun: rerunOf,
 		notice: (text) => write.stderr(noticeLine(text, routed.json)),
@@ -11604,7 +11614,7 @@ async function runProcess(cli) {
 //#region package.json
 var package_default = {
 	name: "@duyquangnvx/create-agent-cli",
-	version: "0.24.0",
+	version: "0.26.0",
 	description: "Creates a new Agent CLI repository wired to @duyquangnvx/agent-cli.",
 	type: "module",
 	engines: { "node": ">=22.12.0" },

package/package.json

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

package/partials/global/installLines.md

@@ -1,5 +1,5 @@
 Paste this to your coding agent, with your task in it:
 
-> Run `{{setupLine}}`, then use {{binName}} to <your task>.
+> Run `{{setupLine}}`, then use {{binName}} to `<your task>`.
 
 That line installs the CLI and its skill. In a terminal it works the same.