@theholocron/cli 5.0.0-alpha.54 → 5.0.0-alpha.56

package/dist/cli.mjs

@@ -24,6 +24,8 @@ import { createGitHubClient } from "@theholocron/github-client";
 import { PostHogSink } from "@theholocron/observability/analytics";
 import { NoopAnalyticsSink, NoopErrorSink, redactObject } from "@theholocron/observability/core";
 import { SentrySink } from "@theholocron/observability/errors";
+import load from "@commitlint/load";
+import lint from "@commitlint/lint";
 import { promisify } from "node:util";
 import { ConfigFileError, loadConfigFile } from "@theholocron/datapad";
 import search from "@inquirer/search";
@@ -1219,6 +1221,7 @@ const COMMAND_CONTEXTS = {
 	"skills install": "global",
 	"skills remove": "global",
 	"skills update": "global",
+	"lint commit-msg": "global",
 	run: "repo-aware",
 	ci: "repo-aware",
 	"config show": "repo-aware",
@@ -4171,12 +4174,21 @@ function createIgnoreConfig$1() {
 }
 //#endregion
 //#region src/templates/configs/commit-msg/commit-msg
-var commit_msg_default = "# --config <resolved shared path> (config-resolution workstream, #676) — falls\n# back to commitlint's own auto-discovery of a local commitlint.config.ts when\n# the shared package's built dist/ isn't present (not installed, or a stale\n# install predating this file).\nCOMMITLINT_CONFIG=\"node_modules/@theholocron/commitlint-config/dist/index.js\"\nif [ -f \"$COMMITLINT_CONFIG\" ]; then\n	npx --no -- commitlint --config \"$COMMITLINT_CONFIG\" --edit \"$1\"\nelse\n	npx --no -- commitlint --edit \"$1\"\nfi\n";
+var commit_msg_default = "__HOLOCRON_SCRIPT__ lint commit-msg \"$1\"\n";
 //#endregion
 //#region src/templates/configs/commit-msg/create-config.ts
 const { workflowHeader: workflowHeader$8 } = createHeader({ source: "packages/cli/src/templates/configs/commit-msg/create-config.ts" });
-function createConfig$7() {
-	return `${workflowHeader$8("shebang")}${commit_msg_default}`;
+/**
+* `.husky/commit-msg` — lints the commit message via `holocron lint
+* commit-msg` (holocron#789), the real programmatic replacement for
+* shelling out to `commitlint --edit`. Installed by `holocron setup` when
+* hooks are enabled. Same `__HOLOCRON_SCRIPT__` substitution as `pre-push`.
+*
+* @param holocronScript - the command that invokes the CLI. Defaults to
+*   `pnpm exec holocron`; the source repo passes `node packages/cli/dist/cli.mjs`.
+*/
+function createConfig$7(holocronScript = "pnpm exec holocron") {
+	return `${workflowHeader$8("shebang")}${commit_msg_default.replace("__HOLOCRON_SCRIPT__", holocronScript)}`;
 }
 //#endregion
 //#region src/templates/configs/devmoji/create-config.ts
@@ -5279,7 +5291,7 @@ async function runSetup(input) {
 		}));
 		print(formatStep(steps[steps.length - 1]));
 		steps.push(await runStep("source", "write .husky/commit-msg", dryRun, async () => {
-			await source.writeRepoFile(".husky/commit-msg", createConfig$7());
+			await source.writeRepoFile(".husky/commit-msg", createConfig$7(config.holocronScript));
 		}));
 		print(formatStep(steps[steps.length - 1]));
 		if (hooksEnabled) {
@@ -7651,6 +7663,63 @@ async function runUpgradeNode(input) {
 	};
 }
 //#endregion
+//#region src/commit-lint/lint-message.ts
+/**
+* Lints one commit message string against an already-loaded commitlint
+* config. The genuinely environment-independent half of commit-message
+* linting (holocron#789) — *obtaining* a `QualifiedConfig` differs by
+* caller (Sentinel isolates itself from any ambient config since it runs
+* standalone, away from a real repo checkout; `lintCommitMsgFile` below
+* just lets cosmiconfig discover the invoking repo's own
+* `commitlint.config.*`, matching `commitlint --edit`'s own contract) —
+* but linting one message against a loaded config is identical either way.
+*
+* Real `@commitlint/lint` — the same programmatic API `@commitlint/cli`
+* itself uses internally — never a reimplementation of commitlint's rules.
+*/
+/** `parserPreset.parserOpts`, if the loaded config sets one — same lookup `@commitlint/cli`'s own `selectParserOpts()` does. */
+function selectParserOpts(parserPreset) {
+	return parserPreset?.parserOpts;
+}
+async function lintCommitMessage(message, loaded) {
+	const opts = {
+		/* istanbul ignore next -- see comment above */
+		parserOpts: selectParserOpts(loaded.parserPreset) ?? {},
+		plugins: loaded.plugins,
+		/* istanbul ignore next -- see comment above */
+		ignores: loaded.ignores ?? [],
+		defaultIgnores: loaded.defaultIgnores !== false
+	};
+	const outcome = await lint(message, loaded.rules, opts);
+	if (outcome.valid) return [];
+	return outcome.errors.map((error) => ({
+		rule: error.name,
+		message: error.message
+	}));
+}
+//#endregion
+//#region src/commit-lint/lint-commit-msg-file.ts
+/**
+* `holocron lint commit-msg <file>` — a real programmatic replacement for
+* shelling out to `commitlint --edit "$1"` from `.husky/commit-msg`
+* (holocron#789). Matches that CLI's own contract exactly: `file` is a
+* path to the commit message being written (the arg git's `commit-msg`
+* hook passes as `$1`), no `--config` override needed — `@commitlint/load`
+* runs from `cwd` with no seed, so cosmiconfig's own normal upward search
+* discovers the invoking repo's real `commitlint.config.*` file, exactly
+* as `commitlint --edit` (no `--config` flag) already does today. Unlike
+* Sentinel's `loadIsolatedConfig()`, no isolation is needed here — this
+* runs inside a real repo checkout with a real `node_modules`, not
+* standalone on a server.
+*/
+async function lintCommitMsgFile(filePath, cwd = process.cwd()) {
+	const violations = await lintCommitMessage(await readFile(filePath, "utf8"), await load({}, { cwd }));
+	return {
+		valid: violations.length === 0,
+		violations
+	};
+}
+//#endregion
 //#region src/config/load-config.ts
 /**
 * `holocron.config.{ts,js,mjs,cjs,json}` loader.
@@ -7761,7 +7830,9 @@ const numeric = (value) => /^\d+$/.test(value) ? true : "enter a number";
 * The full command surface, hand-maintained in parallel with `cli.ts`'s
 * yargs registrations (this module does not introspect yargs at runtime).
 * `run <task>` is deliberately excluded — it's CI/scripting-oriented, and an
-* interactive prompt in front of it would work against that.
+* interactive prompt in front of it would work against that. `lint
+* commit-msg <file>` is excluded for the same reason: it's invoked
+* exclusively from `.husky/commit-msg "$1"`, never typed by a human.
 */
 const COMMAND_REGISTRY = [
 	{
@@ -8670,7 +8741,17 @@ try {
 			scope: argv.all ? "all" : "required",
 			...argv.filter ? { filter: argv.filter } : {}
 		}).status === "fail") process.exitCode = 1;
-	}).command("sync-github", "Sync workflow templates and composite actions to theholocron/.github", (y) => y.option("repo", {
+	}).command("lint", "Lint content locally against the org's shared rules", (y) => y.command("commit-msg <file>", "Lint a commit message file — matches `commitlint --edit`'s own contract, for use from .husky/commit-msg", (yy) => yy.positional("file", {
+		type: "string",
+		demandOption: true,
+		describe: "Path to the commit message file (git's commit-msg hook passes this as $1)."
+	}), async (argv) => {
+		const result = await lintCommitMsgFile(argv.file, argv.cwd);
+		if (!result.valid) {
+			for (const violation of result.violations) console.error(`✖ ${violation.rule}: ${violation.message}`);
+			process.exitCode = 1;
+		}
+	}), () => {}).command("sync-github", "Sync workflow templates and composite actions to theholocron/.github", (y) => y.option("repo", {
 		type: "string",
 		default: "theholocron/.github",
 		describe: "Target org/repo (default: theholocron/.github)"