@theholocron/cli 3.55.1 → 3.56.0

package/dist/cli.mjs

@@ -13,8 +13,8 @@ import ora from "ora";
 import chalk from "chalk";
 import { execFile, execFileSync, spawnSync } from "node:child_process";
 import { homedir } from "node:os";
-import { access, copyFile, mkdir, readFile, readdir, rm, stat, symlink, unlink, writeFile } from "node:fs/promises";
 import { createLogger, parseLogLevel } from "@theholocron/logger";
+import { access, copyFile, mkdir, readFile, readdir, rm, stat, symlink, unlink, writeFile } from "node:fs/promises";
 import { createHash } from "node:crypto";
 import { generateReadme } from "@theholocron/components-doc/markdown";
 import { getClients, getConfigs, getDocs, getPlugins, getSkills, getThemes, getUtils } from "@theholocron/registry-doc";
@@ -896,6 +896,66 @@ async function runDeploy(input) {
 	}
 }
 //#endregion
+//#region src/logger.ts
+/**
+* CLI-side wiring for `@theholocron/logger`.
+*
+* `logger` is the operational-output channel — internal state, debug
+* traces, errors, structured context that routes to Axiom. It runs in
+* parallel to `print` (user-facing UX output) and does not replace it.
+*/
+/**
+* Resolve the explicit level to hand to `createLogger`, in priority order:
+*
+* 1. `--verbose` → `"debug"`   2. `--quiet` → `"error"`
+* 3. `HOLOCRON_LOG_LEVEL` env var
+* 4. `holocron.config` `log.level` (`configLevel`)
+*
+* Returns `undefined` when nothing applies — `createLogger` then defaults
+* to `"info"`. Resolving the full chain here (rather than passing
+* `configLevel` straight through) keeps config below the env var.
+*/
+function resolveLogLevel(argv, configLevel) {
+	if (argv.verbose) return "debug";
+	if (argv.quiet) return "error";
+	return parseLogLevel(env.get("HOLOCRON_LOG_LEVEL")) ?? configLevel;
+}
+let root;
+let rootLevel;
+let rootCommand;
+/**
+* The process-wide root logger. Built once (from `cli.ts`'s middleware,
+* with the command name + flags + env). Rebuilt at most once more when a
+* command's handler supplies its `holocron.config` `log.level` — a case
+* the flag/env-only first pass could not have known — as long as no
+* higher-priority `--verbose` / `--quiet` already fixed the level. That
+* rebuild generates a fresh `runId`, which is harmless: nothing logs
+* between the middleware and the handler.
+*/
+function buildCliLogger(argv, opts = {}) {
+	const { command, configLevel } = opts;
+	if (command) rootCommand = command;
+	const level = resolveLogLevel(argv, configLevel);
+	const rebuildForConfig = configLevel !== void 0 && level !== rootLevel && !argv.verbose && !argv.quiet;
+	if (!root || rebuildForConfig) {
+		const built = createLogger(level ? { level } : {});
+		root = {
+			logger: rootCommand ? built.logger.child({ command: rootCommand }) : built.logger,
+			runId: built.runId
+		};
+		rootLevel = level;
+	}
+	return root;
+}
+/** Lazily-memoized `Logger` for module-level call sites with no `argv` in scope. */
+function getLogger() {
+	return (root ??= createLogger()).logger;
+}
+/** The current root logger's correlation id, if a root has been built. */
+function getRunId() {
+	return root?.runId;
+}
+//#endregion
 //#region src/commands/doctor.ts
 async function runDoctor(input) {
 	const print = input.print ?? ((line) => console.log(line));
@@ -924,7 +984,14 @@ async function runDoctor(input) {
 			rows.push(row);
 		}
 	}
+	const log = getLogger();
 	for (const row of rows) {
+		log[row.status === "fail" ? "warn" : "info"]({
+			capability: row.capability,
+			provider: row.provider,
+			status: row.status,
+			detail: row.message
+		}, `doctor: ${row.capability}`);
 		const label = `${pad(row.capability, 14)} via ${pad(row.provider, 14)}  ${row.message}`;
 		if (row.status === "ok") print(`  ${style.success(label)}`);
 		else if (row.status === "fail") print(`  ${style.fail(label)}`);
@@ -3112,59 +3179,6 @@ var dependabot_default = "version: 2\nupdates:\n  - package-ecosystem: npm\n
 //#region src/templates/labeler.yml
 var labeler_default = "bug:\n  - '^fix'\n\nchore:\n  - '^chore(?!\\(deps)'\n\nci:\n  - '^ci'\n\ndependencies:\n  - '^chore\\(deps'\n\ndocumentation:\n  - '^docs'\n\nenhancement:\n  - '^feat'\n\nperformance:\n  - '^perf'\n\nrefactor:\n  - '^refactor'\n\ntest:\n  - '^test'\n";
 //#endregion
-//#region src/logger.ts
-/**
-* CLI-side wiring for `@theholocron/logger`.
-*
-* `logger` is the operational-output channel — internal state, debug
-* traces, errors, structured context that routes to Axiom. It runs in
-* parallel to `print` (user-facing UX output) and does not replace it.
-*/
-/**
-* Resolve the explicit level to hand to `createLogger`, in priority order:
-*
-* 1. `--verbose` → `"debug"`   2. `--quiet` → `"error"`
-* 3. `HOLOCRON_LOG_LEVEL` env var
-* 4. `holocron.config` `log.level` (`configLevel`)
-*
-* Returns `undefined` when nothing applies — `createLogger` then defaults
-* to `"info"`. Resolving the full chain here (rather than passing
-* `configLevel` straight through) keeps config below the env var.
-*/
-function resolveLogLevel(argv, configLevel) {
-	if (argv.verbose) return "debug";
-	if (argv.quiet) return "error";
-	return parseLogLevel(env.get("HOLOCRON_LOG_LEVEL")) ?? configLevel;
-}
-let root;
-let rootLevel;
-/**
-* The process-wide root logger. Built once (from `cli.ts`'s middleware,
-* with flags + env only). Rebuilt at most once more when a command's
-* handler supplies its `holocron.config` `log.level` — a case the
-* flag/env-only first pass could not have known — as long as no
-* higher-priority `--verbose` / `--quiet` already fixed the level. That
-* rebuild generates a fresh `runId`, which is harmless: nothing logs
-* between the middleware and the handler.
-*/
-function buildCliLogger(argv, configLevel) {
-	const level = resolveLogLevel(argv, configLevel);
-	const rebuildForConfig = configLevel !== void 0 && level !== rootLevel && !argv.verbose && !argv.quiet;
-	if (!root || rebuildForConfig) {
-		root = createLogger(level ? { level } : {});
-		rootLevel = level;
-	}
-	return root;
-}
-/** Lazily-memoized `Logger` for module-level call sites with no `argv` in scope. */
-function getLogger() {
-	return (root ??= createLogger()).logger;
-}
-/** The current root logger's correlation id, if a root has been built. */
-function getRunId() {
-	return root?.runId;
-}
-//#endregion
 //#region src/commands/setup-workflows/index.ts
 /**
 * Thin workflow wrapper templates for `holocron setup`.
@@ -3989,6 +4003,18 @@ const BALANCED_REPO_SETTINGS = {
 //#endregion
 //#region src/commands/setup/run-step.ts
 async function runStep(capability, step, dryRun, body, opts = {}) {
+	const result = await execStep(capability, step, dryRun, body, opts);
+	const { status, message, reason } = result;
+	getLogger()[status === "fail" ? "warn" : "info"]({
+		capability,
+		step,
+		status,
+		...message ? { detail: message } : {},
+		...reason ? { reason } : {}
+	}, `${capability}.${step}`);
+	return result;
+}
+async function execStep(capability, step, dryRun, body, opts = {}) {
 	if (dryRun) return {
 		capability,
 		step,
@@ -6164,14 +6190,26 @@ async function fileExists(path) {
 }
 //#endregion
 //#region src/telemetry.ts
-const DSN = "https://95cbb72ad5636c94e119a5405ee8f55f@o4508238154104832.ingest.us.sentry.io/4511810950791168";
+const FALLBACK_DSN = "https://95cbb72ad5636c94e119a5405ee8f55f@o4508238154104832.ingest.us.sentry.io/4511810950791168";
+/**
+* Resolve the Sentry DSN — the `errors` capability's self-contained
+* activation, per ADR-0007:
+*
+*   HOLOCRON_SENTRY_DSN  →  SENTRY_DSN  →  built-in fallback
+*
+* A consumer repo with `SENTRY_DSN` set gets CLI errors routed to its own
+* project with no config. Opt out entirely with `HOLOCRON_TELEMETRY=false`.
+*/
+function resolveDsn() {
+	return env.get("HOLOCRON_SENTRY_DSN") ?? env.get("SENTRY_DSN") ?? FALLBACK_DSN;
+}
 function isEnabled() {
-	return !(env.get("HOLOCRON_TELEMETRY") === "false" || Boolean(env.get("NO_HOLOCRON_TELEMETRY"))) && true;
+	return !(env.get("HOLOCRON_TELEMETRY") === "false" || Boolean(env.get("NO_HOLOCRON_TELEMETRY"))) && resolveDsn() !== "";
 }
 function init(version) {
 	if (!isEnabled()) return;
 	Sentry.init({
-		dsn: DSN,
+		dsn: resolveDsn(),
 		release: `holocron@${version}`,
 		environment: env.get("CI") ? "ci" : "local",
 		tracesSampleRate: 1,
@@ -6394,9 +6432,10 @@ try {
 		default: false,
 		describe: "Set the log level to error — suppress info and warn."
 	}).middleware((argv) => {
-		finishCommand = startCommand(argv._.slice(0, 2).join(" ") || "unknown");
+		const name = argv._.slice(0, 2).join(" ") || "unknown";
+		finishCommand = startCommand(name);
 		printRunId = Boolean(argv.debug || argv.verbose);
-		buildCliLogger(argv);
+		buildCliLogger(argv, { command: name });
 	}).command("version", "Print the CLI version", () => {}, () => {
 		console.log(`holocron ${CLI_VERSION}`);
 	}).command("clone", "Clone all repos in a GitHub org as siblings under a single directory", (y) => y.option("org", {
@@ -6430,7 +6469,7 @@ try {
 		const tokens = tokenContext(argv.token);
 		if (!tokens) return;
 		const loaded = await loadConfig(argv.cwd);
-		buildCliLogger(argv, loaded.resolved.log?.level);
+		buildCliLogger(argv, { configLevel: loaded.resolved.log?.level });
 		if ((await runDoctor({
 			loaded,
 			context: {
@@ -6448,7 +6487,7 @@ try {
 		const tokens = tokenContext(argv.token);
 		if (!tokens) return;
 		const loaded = await loadConfig(argv.cwd);
-		buildCliLogger(argv, loaded.resolved.log?.level);
+		buildCliLogger(argv, { configLevel: loaded.resolved.log?.level });
 		if ((await runSetup({
 			loaded,
 			context: {
@@ -6514,7 +6553,7 @@ try {
 		const scopeArg = argv.scope;
 		const scope = parseScope(scopeArg);
 		const loaded = await loadConfig(argv.cwd);
-		buildCliLogger(argv, loaded.resolved.log?.level);
+		buildCliLogger(argv, { configLevel: loaded.resolved.log?.level });
 		if ((await runSecretSet({
 			loaded,
 			context: {
@@ -6544,7 +6583,7 @@ try {
 		const tokens = tokenContext(argv.token);
 		if (!tokens) return;
 		const loaded = await loadConfig(argv.cwd);
-		buildCliLogger(argv, loaded.resolved.log?.level);
+		buildCliLogger(argv, { configLevel: loaded.resolved.log?.level });
 		if ((await runSecretsSync({
 			loaded,
 			context: {
@@ -6573,7 +6612,7 @@ try {
 		const tokens = tokenContext(argv.token);
 		if (!tokens) return;
 		const loaded = await loadConfig(argv.cwd);
-		buildCliLogger(argv, loaded.resolved.log?.level);
+		buildCliLogger(argv, { configLevel: loaded.resolved.log?.level });
 		if ((await runDeploy({
 			loaded,
 			context: {
@@ -6601,7 +6640,7 @@ try {
 		const tokens = tokenContext(argv.token);
 		if (!tokens) return;
 		const loaded = await loadConfig(argv.cwd);
-		buildCliLogger(argv, loaded.resolved.log?.level);
+		buildCliLogger(argv, { configLevel: loaded.resolved.log?.level });
 		if ((await runCleanupPreview({
 			loaded,
 			context: {
@@ -6649,7 +6688,7 @@ try {
 		const tokens = tokenContext(argv.token);
 		if (!tokens) return;
 		const loaded = await loadConfig(argv.cwd);
-		buildCliLogger(argv, loaded.resolved.log?.level);
+		buildCliLogger(argv, { configLevel: loaded.resolved.log?.level });
 		if ((await runSync({
 			loaded,
 			context: {
@@ -6706,7 +6745,7 @@ try {
 		default: false
 	}), async (argv) => {
 		const loaded = await loadConfig(argv.cwd);
-		buildCliLogger(argv, loaded.resolved.log?.level);
+		buildCliLogger(argv, { configLevel: loaded.resolved.log?.level });
 		if ((await runSyncReadme({
 			loaded,
 			context: {