@theholocron/cli 3.64.0 → 3.66.0

package/README.md

@@ -209,13 +209,15 @@ all three. See the [telemetry guide](https://docs.theholocron.dev/holocron/telem
   implement
 - `src/config.ts` — config schema, `defineConfig`, `resolveConfig`,
   `CapabilityConfigPackage`
-- `src/load-config.ts` — `loadConfig` — reads JSON/JS/TS config files
+- `src/config/load-config.ts` — `loadConfig` — reads `holocron.config.*`
+  (file discovery via [`@theholocron/datapad`](../datapad))
 - `src/define-config.ts` — `defineConfig` typed pass-through
 - `src/logger.ts` — CLI-side `@theholocron/logger` wiring (`buildCliLogger`,
   `resolveLogLevel`)
 - `src/loader.ts` — `PluginLoader` — dynamic-imports plugins, resolves
   capability config packages, builds the capability registry
-- `src/cli.ts` — yargs entry, dispatches subcommands
+- `src/cli.ts` — yargs entry, dispatches subcommands. `holocron run` is
+  delegated to [`@theholocron/astromech`](../astromech) (`createAstromech`).
 - `src/commands/` — `setup`, `sync`, `doctor`, `deploy`, `secret set`,
   `secrets sync`, `npm publish-initial`, `sync-github`, `upgrade node`,
   `plugin create`, `auth`

package/dist/cli.mjs

@@ -3,6 +3,7 @@ import { createRequire } from "node:module";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import path, { basename, dirname, join, relative, resolve } from "node:path";
 import { checkbox, input, select } from "@inquirer/prompts";
+import { createAstromech } from "@theholocron/astromech";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import { AuthError, ProviderApiError, ProviderApiError as ProviderApiError$1, createRestClient } from "@theholocron/http-client";
@@ -22,6 +23,7 @@ import { createGitHubClient } from "@theholocron/github-client";
 import * as Sentry from "@sentry/node";
 import { PostHog } from "posthog-node";
 import { promisify } from "node:util";
+import { ConfigFileError, loadConfigFile } from "@theholocron/datapad";
 //#region src/env.ts
 /** Singleton env for simple global lookups throughout the CLI. */
 const env = createEnvLookup();
@@ -6698,74 +6700,32 @@ async function runUpgradeNode(input) {
 //#endregion
 //#region src/config/load-config.ts
 /**
-* `holocron.config.{json,js,ts}` file loader.
+* `holocron.config.{ts,js,mjs,cjs,json}` loader.
 *
-* Search order: json → js → ts. JSON is parsed directly; JS is loaded
-* via native dynamic import; TS is loaded via `tsImport` from tsx (a
-* runtime dep) so operators can write typed configs with `defineConfig`
-* without needing a separate build step.
+* File discovery + module loading (typed configs via `tsx`, no build
+* step) is delegated to `@theholocron/datapad`. This module keeps the
+* holocron-specific parts: filling `name` / `repo.name` defaults and
+* running the config through `resolveConfig`.
 *
-* All three forms are validated through the same `resolveConfig` path.
-* Implements the lookup-order contract from issue #75 / #81.
+* Probe order is TS-first (`.ts` → `.js` → `.mjs` → `.cjs` → `.json`) —
+* see ADR-0010 / issue #75 / #81.
 */
 const execFileAsync = promisify(execFile);
-const CANDIDATE_FILENAMES = [
-	"holocron.config.json",
-	"holocron.config.js",
-	"holocron.config.ts"
-];
-var ConfigFileError = class extends Error {
-	name = "ConfigFileError";
-};
 /**
 * Read + parse + resolve `holocron.config.*` from the given directory.
-* Search order: json → js → ts. Throws `ConfigFileError` if nothing
-* found, or `ConfigError` if the config is malformed / invalid.
+* Throws {@link ConfigFileError} when nothing is found or a file cannot
+* be loaded, or `ConfigError` when the config is invalid.
 */
 async function loadConfig(cwd) {
-	for (const filename of CANDIDATE_FILENAMES) {
-		const fullPath = join(cwd, filename);
-		if (await fileExists(fullPath)) {
-			if (filename.endsWith(".json")) return {
-				resolved: await loadJson(fullPath),
-				filepath: fullPath
-			};
-			if (filename.endsWith(".ts")) return {
-				resolved: await loadTs(fullPath),
-				filepath: fullPath
-			};
-			return {
-				resolved: await loadJs(fullPath),
-				filepath: fullPath
-			};
-		}
-	}
-	throw new ConfigFileError(`no holocron.config.{json,js,ts} found in ${cwd}. Create one — see the README for the schema.`);
-}
-async function loadJson(filepath) {
-	const raw = await readFile(filepath, "utf8");
-	let parsed;
-	try {
-		parsed = JSON.parse(raw);
-	} catch (err) {
-		throw new ConfigError(`${filepath} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
-	}
-	return resolveConfig(await deriveDefaults(dirname(filepath), parsed));
-}
-async function loadJs(filepath) {
-	const mod = await import(pathToFileURL(filepath).href);
-	return resolveConfig(await deriveDefaults(dirname(filepath), extractRaw(filepath, mod)));
-}
-async function loadTs(filepath) {
-	const { tsImport } = await import("tsx/esm/api");
-	const mod = await tsImport(pathToFileURL(filepath).href, import.meta.url);
-	return resolveConfig(await deriveDefaults(dirname(filepath), extractRaw(filepath, mod)));
-}
-function extractRaw(filepath, mod) {
-	const outer = mod.default;
-	const raw = outer?.__esModule === true ? outer.default : outer;
-	if (raw === void 0 || raw === null) throw new ConfigFileError(`${filepath} must have a default export (use \`export default defineConfig({…})\`)`);
-	return raw;
+	const found = await loadConfigFile({
+		cwd,
+		name: "holocron"
+	});
+	if (!found) throw new ConfigFileError(`no holocron.config.{ts,js,mjs,cjs,json} found in ${cwd}. Create one — see the README for the schema.`);
+	return {
+		resolved: resolveConfig(await deriveDefaults(dirname(found.filepath), found.config)),
+		filepath: found.filepath
+	};
 }
 async function deriveDefaults(configDir, raw) {
 	const result = { ...raw };
@@ -6806,13 +6766,6 @@ function parseGitRemoteUrl(url) {
 	const sshMatch = url.match(/github\.com:([^/]+\/[^/]+?)(?:\.git)?$/);
 	if (sshMatch) return sshMatch[1];
 }
-async function fileExists(path) {
-	try {
-		return (await stat(path)).isFile();
-	} catch {
-		return false;
-	}
-}
 //#endregion
 //#region src/update-notifier.ts
 const PACKAGE_NAME = "@theholocron/cli";
@@ -7276,6 +7229,29 @@ try {
 			},
 			...argv.steps && argv.steps.length > 0 ? { steps: argv.steps } : {}
 		})).summary.fail > 0) process.exitCode = 1;
+	}).command("run <task> [passthrough..]", "Run a task locally (test, typecheck, lint, build) — figures out turbo / the tool / the package manager", (y) => y.positional("task", {
+		type: "string",
+		demandOption: true,
+		describe: "Task name (test, typecheck, lint, build). See `holocron run --help`."
+	}).positional("passthrough", {
+		type: "string",
+		array: true,
+		describe: "Args forwarded to the tool — put them after `--`."
+	}).option("required", {
+		type: "boolean",
+		default: false,
+		describe: "Fail (exit 1) if this repo has no such task, instead of skipping."
+	}), (argv) => {
+		const { logger } = buildCliLogger(argv, { command: "run" });
+		const report = createAstromech({
+			cwd: argv.cwd,
+			logger
+		}).run(argv.task, {
+			passthrough: argv.passthrough ?? [],
+			dryRun: argv.dryRun,
+			required: argv.required
+		});
+		if (report.status === "fail" || report.status === "unknown") process.exitCode = 1;
 	}).command("sync-github", "Sync workflow templates and composite actions to theholocron/.github", (y) => y.option("repo", {
 		type: "string",
 		default: "theholocron/.github",