miladyai 2.0.0-alpha.27

package/dist/cli/argv.js

@@ -0,0 +1,63 @@
+//#region src/cli/argv.ts
+const HELP_FLAGS = new Set(["-h", "--help"]);
+const VERSION_FLAGS = new Set([
+	"-v",
+	"-V",
+	"--version"
+]);
+const FLAG_TERMINATOR = "--";
+function hasHelpOrVersion(argv) {
+	return argv.some((arg) => HELP_FLAGS.has(arg) || VERSION_FLAGS.has(arg));
+}
+function hasFlag(argv, name) {
+	const args = argv.slice(2);
+	for (const arg of args) {
+		if (arg === FLAG_TERMINATOR) break;
+		if (arg === name) return true;
+	}
+	return false;
+}
+function getVerboseFlag(argv, options) {
+	if (hasFlag(argv, "--verbose")) return true;
+	if (options?.includeDebug && hasFlag(argv, "--debug")) return true;
+	return false;
+}
+function getCommandPath(argv, depth = 2) {
+	const args = argv.slice(2);
+	const path = [];
+	for (let i = 0; i < args.length; i += 1) {
+		const arg = args[i];
+		if (!arg) continue;
+		if (arg === "--") break;
+		if (arg.startsWith("-")) continue;
+		path.push(arg);
+		if (path.length >= depth) break;
+	}
+	return path;
+}
+function getPrimaryCommand(argv) {
+	const [primary] = getCommandPath(argv, 1);
+	return primary ?? null;
+}
+function buildParseArgv(params) {
+	const baseArgv = params.rawArgs && params.rawArgs.length > 0 ? params.rawArgs : params.fallbackArgv && params.fallbackArgv.length > 0 ? params.fallbackArgv : process.argv;
+	const programName = params.programName ?? "";
+	const normalizedArgv = programName && baseArgv[0] === programName ? baseArgv.slice(1) : baseArgv[0]?.endsWith("milady") || baseArgv[0]?.endsWith("miladyai") ? baseArgv.slice(1) : baseArgv;
+	const executable = (normalizedArgv[0]?.split(/[/\\]/).pop() ?? "").toLowerCase();
+	if (normalizedArgv.length >= 2 && (isNodeExecutable(executable) || isBunExecutable(executable))) return normalizedArgv;
+	return [
+		"node",
+		programName || "milady",
+		...normalizedArgv
+	];
+}
+const nodeExecutablePattern = /^node-\d+(?:\.\d+)*(?:\.exe)?$/;
+function isNodeExecutable(executable) {
+	return executable === "node" || executable === "node.exe" || executable === "nodejs" || executable === "nodejs.exe" || nodeExecutablePattern.test(executable);
+}
+function isBunExecutable(executable) {
+	return executable === "bun" || executable === "bun.exe";
+}
+
+//#endregion
+export { buildParseArgv, getCommandPath, getPrimaryCommand, getVerboseFlag, hasHelpOrVersion };

package/dist/cli/banner.js

@@ -0,0 +1,34 @@
+import { cyberGreen, isRich, theme } from "../terminal/theme.js";
+import { ascii } from "../ascii.js";
+import { resolveCommitHash } from "./git-commit.js";
+
+//#region src/cli/banner.ts
+let bannerEmitted = false;
+function formatCliBannerLine(version, options = {}) {
+	const commitLabel = options.commit ?? resolveCommitHash({ env: options.env }) ?? "unknown";
+	const rich = options.richTty ?? isRich();
+	const title = "milAIdy";
+	if (rich) return `${theme.heading(title)} ${theme.info(version)} ${theme.muted(`(${commitLabel})`)}`;
+	return `${title} ${version} (${commitLabel})`;
+}
+function formatAsciiBanner(rich) {
+	if (rich) return ascii.split("\n").map((line) => cyberGreen(line)).join("\n");
+	return ascii;
+}
+function emitCliBanner(version, options = {}) {
+	if (bannerEmitted) return;
+	const argv = options.argv ?? process.argv;
+	if (!process.stdout.isTTY) return;
+	if (argv.some((a) => a === "--json" || a.startsWith("--json="))) return;
+	if (argv.some((a) => a === "--version" || a === "-V" || a === "-v")) return;
+	const art = formatAsciiBanner(options.richTty ?? isRich());
+	const line = formatCliBannerLine(version, options);
+	process.stdout.write(`\n${art}\n\n${line}\n\n`);
+	bannerEmitted = true;
+}
+function hasEmittedCliBanner() {
+	return bannerEmitted;
+}
+
+//#endregion
+export { emitCliBanner, formatCliBannerLine, hasEmittedCliBanner };

package/dist/cli/cli-name.js

@@ -0,0 +1,21 @@
+import path from "node:path";
+
+//#region src/cli/cli-name.ts
+const CLI_NAME = "milady";
+/** Matches a milady command with optional package-runner prefix (pnpm, bun, npm, bunx, npx). */
+const CLI_PREFIX_RE = /^(?:((?:pnpm|bun|npm|bunx|npx)\s+))?(milady)\b/;
+function resolveCliName(argv = process.argv) {
+	const argv1 = argv[1];
+	if (!argv1) return CLI_NAME;
+	const base = path.basename(argv1).trim();
+	return base === CLI_NAME ? base : CLI_NAME;
+}
+function replaceCliName(command, cliName = resolveCliName()) {
+	if (!command.trim() || !CLI_PREFIX_RE.test(command)) return command;
+	return command.replace(CLI_PREFIX_RE, (_match, runner) => {
+		return `${runner ?? ""}${cliName}`;
+	});
+}
+
+//#endregion
+export { replaceCliName, resolveCliName };

package/dist/cli/cli-utils.js

@@ -0,0 +1,16 @@
+//#region src/cli/cli-utils.ts
+async function runCommandWithRuntime(runtime, action, onError) {
+	try {
+		await action();
+	} catch (err) {
+		if (onError) {
+			onError(err);
+			return;
+		}
+		runtime.error(String(err));
+		runtime.exit(1);
+	}
+}
+
+//#endregion
+export { runCommandWithRuntime };

package/dist/cli/git-commit.js

@@ -0,0 +1,78 @@
+import { createRequire } from "node:module";
+import path from "node:path";
+import fs from "node:fs";
+
+//#region src/cli/git-commit.ts
+function formatCommit(value) {
+	const trimmed = value?.trim();
+	if (!trimmed) return null;
+	return trimmed.slice(0, 7);
+}
+function resolveGitHead(startDir) {
+	let current = startDir;
+	for (let i = 0; i < 12; i += 1) {
+		const gitPath = path.join(current, ".git");
+		try {
+			const stat = fs.statSync(gitPath);
+			if (stat.isDirectory()) return path.join(gitPath, "HEAD");
+			if (stat.isFile()) {
+				const match = fs.readFileSync(gitPath, "utf-8").match(/gitdir:\s*(.+)/i);
+				if (match?.[1]) return path.join(path.resolve(current, match[1].trim()), "HEAD");
+			}
+		} catch (err) {
+			if (err.code !== "ENOENT") throw err;
+		}
+		const parent = path.dirname(current);
+		if (parent === current) break;
+		current = parent;
+	}
+	return null;
+}
+function readCommitFromPackageJson() {
+	try {
+		const pkg = createRequire(import.meta.url)("../../package.json");
+		return formatCommit(pkg.gitHead ?? pkg.githead);
+	} catch (err) {
+		if (err.code === "MODULE_NOT_FOUND") return null;
+		throw err;
+	}
+}
+function readCommitFromBuildInfo() {
+	const req = createRequire(import.meta.url);
+	for (const candidate of ["../build-info.json", "./build-info.json"]) try {
+		const formatted = formatCommit(req(candidate).commit);
+		if (formatted) return formatted;
+	} catch (err) {
+		if (err.code !== "MODULE_NOT_FOUND") throw err;
+	}
+	return null;
+}
+function readCommitFromGitHead(cwd) {
+	const headPath = resolveGitHead(cwd);
+	if (!headPath) return null;
+	const head = fs.readFileSync(headPath, "utf-8").trim();
+	if (!head) return null;
+	if (head.startsWith("ref:")) {
+		const ref = head.replace(/^ref:\s*/i, "").trim();
+		const refPath = path.resolve(path.dirname(headPath), ref);
+		return formatCommit(fs.readFileSync(refPath, "utf-8").trim());
+	}
+	return formatCommit(head);
+}
+let cachedCommit;
+function resolveCommitHash(options = {}) {
+	if (cachedCommit !== void 0) return cachedCommit;
+	const env = options.env ?? process.env;
+	cachedCommit = formatCommit(env.GIT_COMMIT?.trim() || env.GIT_SHA?.trim()) ?? readCommitFromBuildInfo() ?? readCommitFromPackageJson() ?? (() => {
+		try {
+			return readCommitFromGitHead(options.cwd ?? process.cwd());
+		} catch (err) {
+			if (err.code === "ENOENT") return null;
+			throw err;
+		}
+	})();
+	return cachedCommit;
+}
+
+//#endregion
+export { resolveCommitHash };

package/dist/cli/parse-duration.js

@@ -0,0 +1,15 @@
+//#region src/cli/parse-duration.ts
+function parseDurationMs(raw, opts) {
+	const trimmed = String(raw ?? "").trim().toLowerCase();
+	if (!trimmed) throw new Error("invalid duration (empty)");
+	const m = /^(\d+(?:\.\d+)?)(ms|s|m|h|d)?$/.exec(trimmed);
+	if (!m) throw new Error(`invalid duration: ${raw}`);
+	const value = Number(m[1]);
+	if (!Number.isFinite(value) || value < 0) throw new Error(`invalid duration: ${raw}`);
+	const unit = m[2] ?? opts?.defaultUnit ?? "ms";
+	const multiplier = unit === "ms" ? 1 : unit === "s" ? 1e3 : unit === "m" ? 6e4 : unit === "h" ? 36e5 : 864e5;
+	return Math.round(value * multiplier);
+}
+
+//#endregion
+export { parseDurationMs };