@kidd-cli/cli 0.1.4 → 0.2.0

package/dist/commands/build.mjs

@@ -41,7 +41,8 @@ const buildCommand = command({
 			ctx.logger.note(formatBuildNote({
 				cwd,
 				entryFile: buildOutput.entryFile,
-				outDir: buildOutput.outDir
+				outDir: buildOutput.outDir,
+				version: buildOutput.version
 			}), "Bundle");
 			return;
 		}
@@ -63,7 +64,8 @@ const buildCommand = command({
 		ctx.logger.note(formatBuildNote({
 			cwd,
 			entryFile: buildOutput.entryFile,
-			outDir: buildOutput.outDir
+			outDir: buildOutput.outDir,
+			version: buildOutput.version
 		}), "Bundle");
 		ctx.logger.note(formatBinariesNote({
 			binaries: compileOutput.binaries,
@@ -133,7 +135,22 @@ function resolveExistingCompile(value) {
 * @returns A formatted string with entry and output directory.
 */
 function formatBuildNote(params) {
-	return [`entry   ${relative(params.cwd, params.entryFile)}`, `output  ${relative(params.cwd, params.outDir)}`].join("\n");
+	return [
+		`entry    ${relative(params.cwd, params.entryFile)}`,
+		`output   ${relative(params.cwd, params.outDir)}`,
+		...formatVersionLine(params.version)
+	].join("\n");
+}
+/**
+* Format a version line for the build note, if a version is available.
+*
+* @private
+* @param version - The version string, or undefined.
+* @returns A single-element array with the formatted line, or an empty array.
+*/
+function formatVersionLine(version) {
+	if (!version) return [];
+	return [`version  ${version}`];
 }
 /**
 * Format compiled binaries into an aligned, multi-line string for display.

package/dist/commands/commands.mjs

@@ -43,21 +43,79 @@ async function resolveSubcommands(commands) {
 /**
 * Recursively build a sorted tree of entries from a CommandMap.
 *
+* Commands listed in the order array appear first in the specified order;
+* omitted commands fall back to alphabetical sort.
+*
 * @private
 * @param commandMap - The map of command names to Command objects.
+* @param order - Optional array of command names defining display order.
 * @returns A sorted array of TreeEntry nodes.
 */
-async function buildTree(commandMap) {
-	const entries = Object.entries(commandMap).toSorted(([a], [b]) => a.localeCompare(b));
+async function buildTree(commandMap, order) {
+	const entries = sortEntries({
+		entries: Object.entries(commandMap),
+		order
+	});
 	return Promise.all(entries.map(async ([name, cmd]) => {
 		return {
-			children: await buildTree(await resolveSubcommands(cmd.commands)),
+			children: await buildTree(await resolveSubcommands(cmd.commands), cmd.order),
 			description: cmd.description ?? "",
 			name
 		};
 	}));
 }
 /**
+* Sort command entries with ordered names first (in specified order),
+* remaining names alphabetically.
+*
+* Validates the order array against available command names and logs a
+* warning for unknown or duplicate entries rather than failing silently.
+*
+* @private
+* @param params - The command entries and optional order array.
+* @returns Sorted array of entries.
+*/
+function sortEntries(params) {
+	const { entries, order } = params;
+	if (!order || order.length === 0) return entries.toSorted(([a], [b]) => a.localeCompare(b));
+	const validOrder = validateOrder({
+		commandNames: entries.map(([name]) => name),
+		order
+	});
+	const entryMap = new Map(entries);
+	const orderedSet = new Set(validOrder);
+	const ordered = validOrder.filter((name) => entryMap.has(name)).map((name) => [name, entryMap.get(name)]);
+	const remaining = entries.filter(([name]) => !orderedSet.has(name)).toSorted(([a], [b]) => a.localeCompare(b));
+	return [...ordered, ...remaining];
+}
+/**
+* Validate the order array by filtering out unknown and duplicate names.
+*
+* Logs warnings for invalid entries so developers see the mismatch
+* during `kidd commands` introspection, matching the runtime behaviour.
+*
+* @private
+* @param params - The order array and available command names.
+* @returns A deduplicated array of valid order names.
+*/
+function validateOrder(params) {
+	const { commandNames, order } = params;
+	const nameSet = new Set(commandNames);
+	const seen = /* @__PURE__ */ new Set();
+	return order.filter((name) => {
+		if (seen.has(name)) {
+			console.warn(`Warning: duplicate command name "${name}" in order array`);
+			return false;
+		}
+		seen.add(name);
+		if (!nameSet.has(name)) {
+			console.warn(`Warning: unknown command "${name}" in order array`);
+			return false;
+		}
+		return true;
+	});
+}
+/**
 * Render a tree of entries into an ASCII tree string.
 *
 * @private

package/dist/index.mjs

@@ -31,6 +31,7 @@ const manifest = await loadCLIManifest(import.meta.dirname);
 await cli({
 	commands: `${import.meta.dirname}/commands`,
 	description: manifest.description,
+	help: { header: `${manifest.name} v${manifest.version}` },
 	name: manifest.name,
 	version: manifest.version
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kidd-cli/cli",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "DX companion CLI for the kidd framework",
   "keywords": [
     "cli",
@@ -26,10 +26,10 @@
     "liquidjs": "^10.25.0",
     "picocolors": "^1.1.1",
     "zod": "^4.3.6",
-    "@kidd-cli/bundler": "0.1.3",
-    "@kidd-cli/config": "0.1.3",
-    "@kidd-cli/core": "0.3.0",
-    "@kidd-cli/utils": "0.1.3"
+    "@kidd-cli/bundler": "0.2.0",
+    "@kidd-cli/config": "0.1.4",
+    "@kidd-cli/core": "0.4.0",
+    "@kidd-cli/utils": "0.1.4"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",