@rune-cli/rune 0.0.4 → 0.0.6

package/dist/cli.mjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { i as successResult, n as runManifestCommand, r as failureResult, t as writeCommandExecutionResult } from "./write-result-qylmqXvG.mjs";
+import { a as isHelpFlag, i as successResult, n as runManifestCommand, o as isVersionFlag, r as failureResult, t as writeCommandExecutionResult } from "./write-result-DOrdlrbw.mjs";
 import { fileURLToPath } from "node:url";
 import { build } from "esbuild";
 import { cp, mkdir, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 import ts from "typescript";
 //#region package.json
-var version = "0.0.4";
+var version = "0.0.6";
 //#endregion
 //#region src/manifest/generate-manifest.ts
 const COMMAND_ENTRY_FILE = "index.ts";
@@ -116,26 +116,31 @@ function resolveCommandsDirectory(projectRoot) {
 function resolveDistDirectory(projectRoot) {
 	return path.join(projectRoot, DIST_DIRECTORY_NAME);
 }
-async function readProjectCliName(projectRoot) {
+async function readProjectCliInfo(projectRoot) {
 	const packageJsonPath = path.join(projectRoot, "package.json");
 	try {
 		const packageJsonContents = await readFile(packageJsonPath, "utf8");
 		const packageJson = JSON.parse(packageJsonContents);
+		let name;
 		if (packageJson.bin && typeof packageJson.bin === "object") {
 			const binNames = Object.keys(packageJson.bin).sort((left, right) => left.localeCompare(right));
-			if (binNames.length > 0) return binNames[0];
+			if (binNames.length > 0) name = binNames[0];
 		}
-		if (packageJson.name && packageJson.name.length > 0) return packageJson.name.split("/").at(-1) ?? packageJson.name;
+		if (!name && packageJson.name && packageJson.name.length > 0) name = packageJson.name.split("/").at(-1) ?? packageJson.name;
+		return {
+			name: name ?? path.basename(projectRoot),
+			version: packageJson.version
+		};
 	} catch (error) {
 		if (error.code !== "ENOENT") throw error;
 	}
-	return path.basename(projectRoot);
+	return { name: path.basename(projectRoot) };
 }
 async function assertCommandsDirectoryExists(commandsDirectory) {
 	if (!(await stat(commandsDirectory).catch((error) => {
 		if (error.code === "ENOENT") return;
 		throw error;
-	}))?.isDirectory()) throw new Error(`Commands directory not found: ${commandsDirectory}`);
+	}))?.isDirectory()) throw new Error(`Commands directory not found at ${COMMANDS_DIRECTORY_NAME}. Create it or check the --project <path> option.`);
 }
 //#endregion
 //#region src/cli/build-command.ts
@@ -200,13 +205,14 @@ async function copyBuiltAssets(sourceDirectory, distDirectory) {
 		await cp(sourceEntryPath, distEntryPath);
 	}));
 }
-function renderBuiltCliEntry(cliName, runtimeImportPath) {
+function renderBuiltCliEntry(cliName, version, runtimeImportPath) {
 	return `import { readFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 
 import { runManifestCommand, writeCommandExecutionResult } from ${JSON.stringify(runtimeImportPath)};
 
 const cliName = ${JSON.stringify(cliName)};
+const version = ${JSON.stringify(version)};
 const distDirectoryUrl = new URL("./", import.meta.url);
 const manifestPath = fileURLToPath(new URL("./${BUILD_MANIFEST_FILENAME}", distDirectoryUrl));
 const manifestContents = await readFile(manifestPath, "utf8");
@@ -226,6 +232,7 @@ const result = await runManifestCommand({
   manifest: runtimeManifest,
   rawArgs: process.argv.slice(2),
   cliName,
+  version,
   cwd: process.cwd(),
 });
 
@@ -292,12 +299,12 @@ async function buildCommandEntries(projectRoot, sourceDirectory, distDirectory,
 		write: true
 	});
 }
-async function buildCliEntry(projectRoot, distDirectory, cliName) {
+async function buildCliEntry(projectRoot, distDirectory, cliName, version) {
 	const runtimeHelperEntryPath = await resolveRuntimeHelperEntryPath();
 	await build({
 		absWorkingDir: projectRoot,
 		stdin: {
-			contents: renderBuiltCliEntry(cliName, `./${path.basename(runtimeHelperEntryPath)}`),
+			contents: renderBuiltCliEntry(cliName, version, `./${path.basename(runtimeHelperEntryPath)}`),
 			loader: "ts",
 			resolveDir: path.dirname(runtimeHelperEntryPath),
 			sourcefile: "rune-built-cli-entry.ts"
@@ -341,7 +348,7 @@ async function runBuildCommand(options) {
 		await assertCommandsDirectoryExists(commandsDirectory);
 		const sourceManifest = await generateCommandManifest({ commandsDirectory });
 		const builtManifest = createBuiltManifest(sourceManifest, sourceDirectory);
-		const cliName = await readProjectCliName(projectRoot);
+		const cliInfo = await readProjectCliInfo(projectRoot);
 		await rm(distDirectory, {
 			recursive: true,
 			force: true
@@ -349,7 +356,7 @@ async function runBuildCommand(options) {
 		await writeBuiltRuntimeFiles(distDirectory, builtManifest);
 		await Promise.all([
 			buildCommandEntries(projectRoot, sourceDirectory, distDirectory, sourceManifest),
-			buildCliEntry(projectRoot, distDirectory, cliName),
+			buildCliEntry(projectRoot, distDirectory, cliInfo.name, cliInfo.version),
 			copyBuiltAssets(sourceDirectory, distDirectory)
 		]);
 		return successResult(`Built CLI to ${path.join(distDirectory, BUILD_CLI_FILENAME)}\n`);
@@ -386,6 +393,8 @@ Examples:
 async function runDevCommand(options) {
 	try {
 		const projectRoot = resolveProjectPath(options);
+		const cliInfo = await readProjectCliInfo(projectRoot);
+		if (cliInfo.version && options.rawArgs.length === 1 && isVersionFlag(options.rawArgs[0])) return successResult(`${cliInfo.name} v${cliInfo.version}\n`);
 		const commandsDirectory = resolveCommandsDirectory(projectRoot);
 		await assertCommandsDirectoryExists(commandsDirectory);
 		const manifest = await generateCommandManifest({ commandsDirectory });
@@ -393,7 +402,8 @@ async function runDevCommand(options) {
 		return runManifestCommand({
 			manifest,
 			rawArgs: options.rawArgs,
-			cliName: await readProjectCliName(projectRoot),
+			cliName: cliInfo.name,
+			version: cliInfo.version,
 			cwd: options.cwd
 		});
 	} catch (error) {
@@ -410,19 +420,13 @@ function tryParseProjectOption(argv, index) {
 	};
 	if (token === "--project") {
 		const nextToken = argv[index + 1];
-		if (!nextToken) return failureResult("Missing value for --project");
+		if (!nextToken) return failureResult("Missing value for --project. Usage: --project <path>");
 		return {
 			projectPath: nextToken,
 			nextIndex: index + 2
 		};
 	}
 }
-function isHelpFlag(token) {
-	return token === "--help" || token === "-h";
-}
-function isVersionFlag(token) {
-	return token === "--version" || token === "-V";
-}
 function getRuneVersion() {
 	return version;
 }
@@ -507,7 +511,7 @@ async function runRuneCli(options) {
 			cwd: options.cwd
 		});
 	}
-	return failureResult(`Unknown rune command: ${subcommand}`);
+	return failureResult(`Unknown command: ${subcommand}. Available commands: build, dev`);
 }
 //#endregion
 //#region src/cli.ts

package/dist/runtime.d.mts

@@ -30,6 +30,7 @@ interface RunManifestCommandOptions {
   readonly manifest: CommandManifest;
   readonly rawArgs: readonly string[];
   readonly cliName: string;
+  readonly version?: string | undefined;
   readonly cwd?: string | undefined;
   readonly loadCommand?: LoadCommandFn | undefined;
 }

package/dist/runtime.mjs

@@ -1,2 +1,2 @@
-import { n as runManifestCommand, t as writeCommandExecutionResult } from "./write-result-qylmqXvG.mjs";
+import { n as runManifestCommand, t as writeCommandExecutionResult } from "./write-result-DOrdlrbw.mjs";
 export { runManifestCommand, writeCommandExecutionResult };

package/dist/{write-result-qylmqXvG.mjs → write-result-DOrdlrbw.mjs}

@@ -1,5 +1,13 @@
 import { a as parseCommand, i as isSchemaField, n as executeCommand, r as formatFieldTypeHint } from "./dist-Bcn0FpHi.mjs";
 import { pathToFileURL } from "node:url";
+//#region src/cli/flags.ts
+function isHelpFlag(token) {
+	return token === "--help" || token === "-h";
+}
+function isVersionFlag(token) {
+	return token === "--version" || token === "-V";
+}
+//#endregion
 //#region src/cli/result.ts
 function successResult(stdout) {
 	return {
@@ -60,7 +68,8 @@ async function formatUsageArguments(fields) {
 function getOptionUsageSuffix(fields) {
 	return fields.length === 0 ? "" : "[options]";
 }
-function renderGroupHelp(manifest, node, cliName) {
+function renderGroupHelp(options) {
+	const { manifest, node, cliName, version } = options;
 	const nodeMap = createCommandManifestNodeMap(manifest);
 	const entries = node.childNames.map((childName) => {
 		return {
@@ -70,6 +79,14 @@ function renderGroupHelp(manifest, node, cliName) {
 	});
 	const parts = [`Usage: ${formatCommandName(cliName, node.pathSegments)} <command>`];
 	if (entries.length > 0) parts.push(`Subcommands:\n${formatSectionEntries(entries)}`);
+	const optionEntries = [{
+		label: "-h, --help",
+		description: "Show help"
+	}, ...node.pathSegments.length === 0 && version ? [{
+		label: "-V, --version",
+		description: "Show the version number"
+	}] : []];
+	parts.push(`Options:\n${formatSectionEntries(optionEntries)}`);
 	return `${parts.join("\n\n")}\n`;
 }
 async function renderCommandHelp(command, pathSegments, cliName) {
@@ -102,7 +119,12 @@ function renderUnknownCommandMessage(route, cliName) {
 }
 async function renderResolvedHelp(options) {
 	if (options.route.kind === "unknown") return renderUnknownCommandMessage(options.route, options.cliName);
-	if (options.route.kind === "group") return renderGroupHelp(options.manifest, options.route.node, options.cliName);
+	if (options.route.kind === "group") return renderGroupHelp({
+		manifest: options.manifest,
+		node: options.route.node,
+		cliName: options.cliName,
+		version: options.version
+	});
 	return renderCommandHelp(await (options.loadCommand ?? defaultLoadCommand)(options.route.node), options.route.matchedPath, options.cliName);
 }
 //#endregion
@@ -126,7 +148,7 @@ function isOptionLikeToken(token) {
 	return token === "--" || token.startsWith("-");
 }
 function getHelpRequested(args) {
-	return args.includes("--help") || args.includes("-h");
+	return args.some(isHelpFlag);
 }
 function getSuggestionThreshold(candidate) {
 	return Math.max(2, Math.floor(candidate.length / 3));
@@ -182,12 +204,14 @@ function resolveCommandPath(manifest, rawArgs) {
 //#endregion
 //#region src/manifest/run-manifest-command.ts
 async function runManifestCommand(options) {
+	if (options.version && options.rawArgs.length === 1 && isVersionFlag(options.rawArgs[0])) return successResult(`${options.cliName} v${options.version}\n`);
 	const route = resolveCommandPath(options.manifest, options.rawArgs);
 	if (route.kind === "unknown" || route.kind === "group" || route.helpRequested) {
 		const output = await renderResolvedHelp({
 			manifest: options.manifest,
 			route,
 			cliName: options.cliName,
+			version: options.version,
 			loadCommand: options.loadCommand
 		});
 		return route.kind === "unknown" ? failureResult(output) : successResult(output);
@@ -222,4 +246,4 @@ async function writeCommandExecutionResult(result) {
 	process.exitCode = result.exitCode;
 }
 //#endregion
-export { successResult as i, runManifestCommand as n, failureResult as r, writeCommandExecutionResult as t };
+export { isHelpFlag as a, successResult as i, runManifestCommand as n, isVersionFlag as o, failureResult as r, writeCommandExecutionResult as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rune-cli/rune",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "Rune is a CLI framework built around the concept of file-based command routing.",
   "homepage": "https://github.com/morinokami/rune#readme",
   "bugs": {
@@ -43,7 +43,7 @@
   },
   "devDependencies": {
     "@types/node": "24.12.0",
-    "@typescript/native-preview": "7.0.0-dev.20260317.1",
+    "@typescript/native-preview": "7.0.0-dev.20260322.1",
     "typescript": "5.9.3",
     "vite-plus": "v0.1.13",
     "@rune-cli/core": "0.0.0"