@duyquangnvx/create-agent-cli 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -4,6 +4,17 @@ What changed in each release of `@duyquangnvx/agent-cli` (the Runtime) and `@duy
 
 ## Unreleased
 
+## v0.7.0 (2026-10-20)
+
+### Added
+
+- Every Runtime code is exported under its name: `OUTPUT_EXISTS`, `PROJECT_INVALID`, `INVALID_INPUT`, `UNKNOWN_OPTION`, `UNKNOWN_COMMAND`, `UNKNOWN_FIELD`, `CONFIRMATION_REQUIRED`, `CONFIRMATION_MISMATCH`, `NOT_CONFIRMED`, `TOOL_FAILED`, `TOOL_MISSING`, `DOCTOR_PROBLEMS`, `INTERNAL`, `NOT_GLOBAL_INSTALL`, `REGISTRY_UNREACHABLE`, `REGISTRY_AUTH`, `INSTALL_FAILED`, `NPM_FAILED` and `NO_LATEST`. The agent-cli skill says which of them a Command may throw, and asserts codes through them.
+- A CLI's `doctor` rows read the Project file as `ctx.project`, which was always `undefined` there. `doctor` reads the file once for all its rows; a row that reads `ctx.project` while the file is unusable is skipped, since the `project` row reports it. See `DoctorCheck.run`. The agent-cli skill's example adds a `tag` row that reads it.
+
+### Changed
+
+- **Breaking:** `doctor`'s `project` row carries the code of the failed read, so a Project file its schema rejects fails `doctor` with `PROJECT_INVALID` instead of `DOCTOR_PROBLEMS` (still exit 2), the code a Command fails with on the same file. The row's message adds the error's hint.
+
 ## v0.6.0 (2026-10-20)
 
 ### Changed

package/dist/bin.js

@@ -5795,7 +5795,7 @@ var UsageError = class extends CliError {
 		this.name = "UsageError";
 	}
 };
-const INTERNAL_CODE = "INTERNAL";
+const INTERNAL = "INTERNAL";
 function errnoOf(error) {
 	return error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : void 0;
 }
@@ -5835,7 +5835,7 @@ function fieldsOf$1(error, format) {
 		};
 	}
 	return {
-		code: INTERNAL_CODE,
+		code: INTERNAL,
 		message: messageOf(error),
 		hint: bugHint(format)
 	};
@@ -7190,22 +7190,41 @@ function nodeRow(cli) {
 		}
 	};
 }
-function projectRow(projectFile) {
-	const { file } = projectFile;
+/** A row's thrown error as its problem: a `CliError` with its hint and code, anything else a bug. */
+function problemOfError(name, error) {
+	if (error instanceof CliError) return {
+		state: "problem",
+		message: `${error.message}; ${error.hint}`,
+		code: error.code
+	};
+	return {
+		state: "problem",
+		message: `the ${name} row hit a bug: ${messageOf(error)}`
+	};
+}
+function readProject(projectFile, ctx) {
+	if (projectFile === void 0) return {
+		ok: true,
+		project: void 0
+	};
+	try {
+		return {
+			ok: true,
+			project: projectOf(projectFile, ctx.cwd, ctx.fileError)
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			error
+		};
+	}
+}
+function projectRow({ file }, read) {
 	return {
 		name: "project",
 		run: (ctx) => {
-			let project;
-			try {
-				project = projectOf(projectFile, ctx.cwd, ctx.fileError);
-			} catch (error) {
-				if (error instanceof CliError && error.code === "PROJECT_INVALID") return {
-					state: "problem",
-					message: error.message
-				};
-				throw error;
-			}
-			return ok(project === void 0 ? `none found: no ${file} at or above ${ctx.cwd}` : join(project.root, file));
+			if (!read.ok) return problemOfError("project", read.error);
+			return ok(read.project === void 0 ? `none found: no ${file} at or above ${ctx.cwd}` : join(read.project.root, file));
 		}
 	};
 }
@@ -7273,11 +7292,11 @@ function skillRow(cli) {
 	};
 }
 /** Every row `doctor` reports, in order: the fixed rows around the CLI's own and its tools'. */
-function doctorChecks(cli, launch) {
+function doctorChecks(cli, launch, read) {
 	return [
 		buildRow(cli),
 		nodeRow(cli),
-		...cli.project === void 0 ? [] : [projectRow(cli.project)],
+		...cli.project === void 0 ? [] : [projectRow(cli.project, read)],
 		...cli.doctor ?? [],
 		...toolRows(cli.tools ?? [], cli.commands),
 		installRow(cli, launch),
@@ -7310,28 +7329,29 @@ function problemOf(check, error, { signal, deadline, ms }) {
 		state: "problem",
 		message: `${check.name} did not answer within ${ms / MS_PER_SECOND} s`
 	};
-	if (error instanceof CliError) return {
-		state: "problem",
-		message: `${error.message}; ${error.hint}`,
-		code: error.code
-	};
-	return {
-		state: "problem",
-		message: `the ${check.name} row hit a bug: ${messageOf(error)}`
-	};
+	return problemOfError(check.name, error);
 }
-function withSignal(ctx, signal) {
-	return Object.create(ctx, { signal: { value: signal } });
+function rowContext(ctx, signal, read) {
+	return Object.create(ctx, {
+		signal: { value: signal },
+		project: { get: () => {
+			if (!read.ok) throw read.error;
+			return read.project;
+		} }
+	});
 }
-async function rowOf(check, ctx) {
+async function rowOf(check, ctx, read) {
 	const ms = check.deadlineMs ?? DEFAULT_DEADLINE_MS;
 	const signal = ctx.deadline(ms);
 	let finding;
 	try {
-		finding = await Promise.race([Promise.resolve().then(() => check.run(withSignal(ctx, signal))), untilAborted(signal)]);
+		finding = await Promise.race([Promise.resolve().then(() => check.run(rowContext(ctx, signal, read))), untilAborted(signal)]);
 	} catch (error) {
 		if (ctx.signal.aborted) return void 0;
-		finding = problemOf(check, error, {
+		finding = !read.ok && error === read.error ? {
+			state: "skipped",
+			message: "the Project file is unusable; the project row says why"
+		} : problemOf(check, error, {
 			signal: ctx.signal,
 			deadline: signal,
 			ms
@@ -7379,7 +7399,8 @@ function doctorCommand(cli, launch) {
 		effect: "read",
 		output: reportSchema,
 		run: async (_input, ctx) => {
-			const checked = (await Promise.all(doctorChecks(cli, launch).map((check) => rowOf(check, ctx)))).filter((row) => row !== void 0);
+			const read = readProject(cli.project, ctx);
+			const checked = (await Promise.all(doctorChecks(cli, launch, read).map((check) => rowOf(check, ctx, read)))).filter((row) => row !== void 0);
 			const rows = checked.map(({ row }) => row);
 			const report = {
 				rows,
@@ -8075,7 +8096,7 @@ const RUNTIME_EXIT_CLASSES = {
 	[STDIN_STALLED]: "caller",
 	[INTERRUPTED]: "interrupted",
 	[DEADLINE_EXCEEDED]: "wait",
-	[INTERNAL_CODE]: "bug",
+	[INTERNAL]: "bug",
 	[PERMISSION_DENIED]: "operator",
 	[DISK_FULL]: "operator",
 	[NOT_FOUND]: "caller",
@@ -9387,14 +9408,14 @@ async function runProcess(cli) {
 }
 //#endregion
 //#region package.json
-var version$1 = "0.6.0";
+var version$1 = "0.7.0";
 var description = "Creates a new Agent CLI repository wired to @duyquangnvx/agent-cli.";
 //#endregion
 //#region src/build.ts
 const build = {
-	"sha": "6821473",
+	"sha": "10574f5",
 	"dirty": false,
-	"builtAt": "2026-10-20T02:08:46.888Z"
+	"builtAt": "2026-10-20T03:42:41.670Z"
 };
 //#endregion
 //#region src/steps.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duyquangnvx/create-agent-cli",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "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.6.0",
+    "@duyquangnvx/agent-cli": "0.7.0",
     "tsdown": "0.23.0",
     "zod": "4.6.7"
   },