@duyquangnvx/create-agent-cli 0.9.1 → 0.10.1

package/CHANGELOG.md

@@ -4,6 +4,22 @@ What changed in each release of `@duyquangnvx/agent-cli` (the Runtime) and `@duy
 
 ## Unreleased
 
+## v0.10.1 (2026-10-22)
+
+### Changed
+
+- A scaffolded CLI's tests create their temp folders under one root that `test/global-setup.ts` removes after the run, so they leave nothing in `$TMPDIR`.
+
+## v0.10.0 (2026-10-21)
+
+### Changed
+
+- `ctx.commandLine` and every hint that names a command to run again end in ` < <name file>` when an `orStdin` arg was given `-`, so the rerun sends the text again; the hint of a stdin that never ends still names the line as typed.
+
+### Fixed
+
+- `--dry-run` text no longer prints an empty `outputs:` line when `outputs` returns no files; `--json` still gives `outputs: []`.
+
 ## v0.9.1 (2026-10-20)
 
 ### Fixed

package/dist/bin.js

@@ -6141,8 +6141,9 @@ const SHELL_SAFE = /^[\w@%+=:,./-]+$/;
 function quoted$1(token) {
 	return SHELL_SAFE.test(token) ? token : `'${token.replaceAll("'", `'\\''`)}'`;
 }
-function pasteable(cliName, tokens) {
-	return [cliName, ...tokens].map(quoted$1).join(" ");
+function pasteable(cliName, tokens, stdinArg) {
+	const line = [cliName, ...tokens].map(quoted$1).join(" ");
+	return stdinArg === void 0 ? line : `${line} < <${stdinArg} file>`;
 }
 function split(argv) {
 	const end = argv.indexOf("--");
@@ -6169,16 +6170,16 @@ function without(flag, takes, tokens) {
 }
 /**
 * The caller's command line as typed, ready to paste, with each flag in `remove` dropped along with
-* its value and the words in `add` placed before any `--`.
+* its value, the words in `add` placed before any `--`, and the stdin arg's file redirected in.
 */
-function commandLineOf({ cliName, argv, flags }, { add = [], remove = [] } = {}) {
+function commandLineOf({ cliName, argv, flags, stdinArg }, { add = [], remove = [] } = {}) {
 	const { options, operands } = split(argv);
 	const takes = new Map(flags.map((known) => [known.flag, known.takes]));
 	return pasteable(cliName, [
 		...remove.reduce((tokens, flag) => without(flag, takes.get(flag) ?? "nothing", tokens), options),
 		...add,
 		...operands
-	]);
+	], stdinArg);
 }
 function renamed(token, renames) {
 	const [flag = token, ...value] = token.split("=");
@@ -6187,9 +6188,9 @@ function renamed(token, renames) {
 	return value.length === 0 ? name : `${name}=${value.join("=")}`;
 }
 /** The caller's command line, ready to paste, with each flag in `renames` typed as its new name. */
-function commandLineRenaming({ cliName, argv }, renames) {
+function commandLineRenaming({ cliName, argv, stdinArg }, renames) {
 	const { options, operands } = split(argv);
-	return pasteable(cliName, [...options.map((token) => renamed(token, renames)), ...operands]);
+	return pasteable(cliName, [...options.map((token) => renamed(token, renames)), ...operands], stdinArg);
 }
 //#endregion
 //#region ../agent-cli/dist/usage.js
@@ -8700,7 +8701,7 @@ function dryRunOutcome(command, plan) {
 		},
 		render: (style) => [
 			renderPlan(style),
-			...outputs === void 0 ? [] : ["outputs:", ...outputs.map((path) => `  ${path}`)],
+			...outputs === void 0 || outputs.length === 0 ? [] : ["outputs:", ...outputs.map((path) => `  ${path}`)],
 			...cost === void 0 ? [] : [`cost: ${cost}`]
 		].join("\n")
 	};
@@ -8842,11 +8843,17 @@ function invalidInput(commandLine, invocation, unknown, otherLines) {
 		hint: correctable ? `did you mean \`${commandLineRenaming(invocation, renames)}\`?` : `run \`${commandLine} --help\` to see the expected input`
 	});
 }
-async function stdinTextOf(spec, operands, read) {
+function stdinFieldOf(spec, operands) {
 	const index = spec.args.findIndex((field) => field.stdin);
-	const field = spec.args[index];
-	if (field === void 0 || operands[index]?.value !== "-") return void 0;
-	return {
+	return operands[index]?.value === "-" ? spec.args[index] : void 0;
+}
+/** The name of the routed Command's arg given `-`, which takes its text from stdin. */
+function stdinArgOf({ spec, words }) {
+	return stdinFieldOf(spec, tokenize(words, knownFlags(spec)).operands)?.name;
+}
+async function stdinTextOf(spec, operands, read) {
+	const field = stdinFieldOf(spec, operands);
+	return field === void 0 ? void 0 : {
 		field,
 		text: await read(field)
 	};
@@ -9111,16 +9118,17 @@ async function runCommand(cli, routed, options, write, baseFormat) {
 	const platform = options.platform ?? process.platform;
 	const ports = portsOf(cli, options.ports);
 	const packageRoot = packageRootOf(options.bin, cwd);
-	const fileError = fileErrorOf({
-		callerLine: commandLineOf(baseFormat.invocation),
-		env,
-		platform
-	});
 	const progress = (message) => write.stderr(progressLine(message, routed.json));
 	const invocation = {
 		...baseFormat.invocation,
-		flags: knownFlags(routed.spec)
+		flags: knownFlags(routed.spec),
+		stdinArg: stdinArgOf(routed)
 	};
+	const fileError = fileErrorOf({
+		callerLine: commandLineOf(invocation),
+		env,
+		platform
+	});
 	const format = {
 		...baseFormat,
 		bugs: () => manifestAt(packageRoot).bugs,
@@ -9128,6 +9136,10 @@ async function runCommand(cli, routed, options, write, baseFormat) {
 		invocation
 	};
 	const typedLine = (change) => commandLineOf(invocation, change);
+	const callerLine = commandLineOf({
+		...invocation,
+		stdinArg: void 0
+	});
 	let resumeHint;
 	const control = new RunControl({
 		commandLine,
@@ -9136,7 +9148,7 @@ async function runCommand(cli, routed, options, write, baseFormat) {
 		progress,
 		runDeadline: command.deadline === void 0 ? void 0 : {
 			ms: command.deadline.ms,
-			hint: () => resumeHint ?? stdinNeverEndedHint(typedLine())
+			hint: () => resumeHint ?? stdinNeverEndedHint(callerLine)
 		}
 	});
 	const failed = (error, finishSideTask) => {
@@ -9153,7 +9165,7 @@ async function runCommand(cli, routed, options, write, baseFormat) {
 			if (isTerminal(stdin)) progress(readingLine(field.name, platform));
 			return readStdin(stdin, control.signal, {
 				clock,
-				stalled: () => stdinStalled(typedLine())
+				stalled: () => stdinStalled(callerLine)
 			});
 		});
 	} catch (error) {
@@ -9409,14 +9421,14 @@ async function runProcess(cli) {
 }
 //#endregion
 //#region package.json
-var version$1 = "0.9.1";
+var version$1 = "0.10.1";
 var description = "Creates a new Agent CLI repository wired to @duyquangnvx/agent-cli.";
 //#endregion
 //#region src/build.ts
 const build = {
-	"sha": "3014a0a",
+	"sha": "0e1aa22",
 	"dirty": false,
-	"builtAt": "2026-10-20T10:05:03.000Z"
+	"builtAt": "2026-10-22T01:43:18.000Z"
 };
 //#endregion
 //#region src/steps.ts

package/package.json

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

package/template/test/global-setup.ts

@@ -0,0 +1,13 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+// Workers and the processes they spawn read the temp dir from these variables, so every
+// temp folder a test makes lands under one root that the teardown removes, even after a failure.
+export default function setup(): () => void {
+  const root = mkdtempSync(join(tmpdir(), "{{binName}}-test-"));
+  process.env.TMPDIR = root;
+  process.env.TEMP = root;
+  process.env.TMP = root;
+  return () => rmSync(root, { recursive: true, force: true, maxRetries: 3 });
+}

package/template/vitest.config.ts

@@ -2,6 +2,7 @@ import { defineConfig } from "vitest/config";
 
 export default defineConfig({
   test: {
+    globalSetup: ["test/global-setup.ts"],
     include: ["test/**/*.test.ts"],
   },
 });