@theholocron/astromech 5.0.0-alpha.17 → 5.0.0-alpha.170

package/dist/lint/index.d.mts

@@ -0,0 +1,99 @@
+import { QualifiedConfig } from "@commitlint/types";
+//#region src/lint/alex-config/alex-config.d.ts
+/**
+ * The org's canonical `alex` (inclusive-language) config, as raw parsed
+ * data rather than the pre-rendered file strings `createRcConfig()`/
+ * `createIgnoreConfig()` produce for `holocron repo setup` to write into a
+ * repo's own `.alexrc.json`/`.alexignore`.
+ *
+ * `.alexrc.json` is explicitly "generated by `holocron repo setup` — do not
+ * edit manually" (this repo's own `AGENTS.md`) — the real source of truth
+ * is this JSON file, one canonical copy, not each repo's synced one. A
+ * central Sentinel check (holocron#769/#793) reads it directly rather
+ * than fetching each repo's own copy via the Contents API — the same "one
+ * config, not N copies" reasoning `@theholocron/commitlint-config` already
+ * established for commit-message linting.
+ */
+declare const ALEX_CONFIG: {
+  allow: string[];
+};
+//#endregion
+//#region src/lint/alex-ignore-patterns/alex-ignore-patterns.d.ts
+/**
+ * Glob-ish path patterns `alex` skips. Kept as a literal here rather than
+ * importing `../templates/configs/alexjs/alexignore` directly — that file
+ * (like `commit-msg`/`pre-push`) is deliberately extensionless, matching
+ * the real filename `holocron repo setup` writes, which ECMAScript's own
+ * module resolution (`moduleResolution: "nodenext"`) can't import across
+ * a package boundary without an extension. Keep in sync with that file by
+ * hand; it changes rarely.
+ */
+declare const ALEX_IGNORE_PATTERNS: string[];
+//#endregion
+//#region src/lint/editorconfig-checker-exclude/editorconfig-checker-exclude.d.ts
+/**
+ * The paths editorconfig-checker skips, read from the same
+ * `editorconfig-checker.json` template `holocron repo setup` writes as a repo's
+ * `.editorconfig-checker.json` — so Sentinel's central editorconfig check
+ * (holocron#927) excludes exactly what CI's editorconfig-checker does, from
+ * one source.
+ *
+ * The exclusion that matters most is `\.md$` / `\.mdx$`: the generated
+ * `.editorconfig` gives every file tab indentation, but
+ * `@theholocron/prettier-config` formats markdown with spaces, so a README's
+ * indented code example would fail one tool or the other. Markdown is left
+ * to prettier and markdownlint.
+ *
+ * Each entry is a regular-expression source, matched against a
+ * repo-relative path, as editorconfig-checker itself treats them.
+ */
+declare const EDITORCONFIG_CHECKER_EXCLUDE: readonly string[];
+//#endregion
+//#region src/lint/is-editorconfig-excluded/is-editorconfig-excluded.d.ts
+/** `true` when `path` matches any {@link EDITORCONFIG_CHECKER_EXCLUDE} pattern. */
+declare function isEditorConfigExcluded(path: string): boolean;
+//#endregion
+//#region src/lint/lint-message/lint-message.type.d.ts
+interface CommitMessageViolation {
+  /** Rule name, e.g. `"subject-empty"`. */
+  rule: string;
+  /** commitlint's own message for the failure, e.g. `"subject may not be empty"`. */
+  message: string;
+}
+//#endregion
+//#region src/lint/lint-message/lint-message.d.ts
+declare function lintCommitMessage(message: string, loaded: QualifiedConfig): Promise<CommitMessageViolation[]>;
+//#endregion
+//#region src/lint/lint-commit-msg-file/lint-commit-msg-file.type.d.ts
+interface LintCommitMsgFileResult {
+  valid: boolean;
+  violations: CommitMessageViolation[];
+}
+//#endregion
+//#region src/lint/lint-commit-msg-file/lint-commit-msg-file.d.ts
+declare function lintCommitMsgFile(filePath: string, cwd?: string): Promise<LintCommitMsgFileResult>;
+//#endregion
+//#region src/lint/prettier-ignore-patterns/prettier-ignore-patterns.d.ts
+/**
+ * The org's canonical prettier ignore-pattern list for a central Sentinel
+ * check (holocron#769/#819) — the `PRETTIER_CONFIG` object itself doesn't
+ * need a home here, since `@theholocron/prettier-config`'s default export
+ * already *is* one canonical, importable config (the same "one config,
+ * not N copies" reasoning `@theholocron/commitlint-config` established for
+ * commit-message linting, and `ALEX_CONFIG` established for inclusive
+ * language) — only the ignore list is a Sentinel-specific decision that
+ * belongs alongside `ALEX_IGNORE_PATTERNS`, not inside the config package.
+ *
+ * Reuses `ALEX_IGNORE_PATTERNS`' own entries (`.github/*`, `CHANGELOG.md`,
+ * `LICENSE` all independently confirmed to fail a real `prettier.check()`
+ * today — machine-generated or unparseable content, same reasoning that
+ * excluded them from alex), plus `pnpm-lock.yaml` — prettier-specific
+ * (alex never reads a lockfile, but prettier would try to reformat it):
+ * machine-written by pnpm's own writer, and not gitignored (lockfiles are
+ * tracked), so prettier picks it up by default. Reformatting it
+ * fights every subsequent `pnpm install` (this repo's own `.prettierignore`
+ * already excludes it for that exact reason).
+ */
+declare const PRETTIER_IGNORE_PATTERNS: string[];
+//#endregion
+export { ALEX_CONFIG, ALEX_IGNORE_PATTERNS, type CommitMessageViolation, EDITORCONFIG_CHECKER_EXCLUDE, type LintCommitMsgFileResult, PRETTIER_IGNORE_PATTERNS, isEditorConfigExcluded, lintCommitMessage, lintCommitMsgFile };

package/dist/lint/index.mjs

@@ -0,0 +1,143 @@
+import { n as alexrc_default, t as editorconfig_checker_default } from "../editorconfig-checker-DPejtR5z.mjs";
+import { readFile } from "node:fs/promises";
+import load from "@commitlint/load";
+import lint from "@commitlint/lint";
+//#region src/lint/alex-config/alex-config.ts
+/**
+* The org's canonical `alex` (inclusive-language) config, as raw parsed
+* data rather than the pre-rendered file strings `createRcConfig()`/
+* `createIgnoreConfig()` produce for `holocron repo setup` to write into a
+* repo's own `.alexrc.json`/`.alexignore`.
+*
+* `.alexrc.json` is explicitly "generated by `holocron repo setup` — do not
+* edit manually" (this repo's own `AGENTS.md`) — the real source of truth
+* is this JSON file, one canonical copy, not each repo's synced one. A
+* central Sentinel check (holocron#769/#793) reads it directly rather
+* than fetching each repo's own copy via the Contents API — the same "one
+* config, not N copies" reasoning `@theholocron/commitlint-config` already
+* established for commit-message linting.
+*/
+const ALEX_CONFIG = alexrc_default;
+//#endregion
+//#region src/lint/alex-ignore-patterns/alex-ignore-patterns.ts
+/**
+* Glob-ish path patterns `alex` skips. Kept as a literal here rather than
+* importing `../templates/configs/alexjs/alexignore` directly — that file
+* (like `commit-msg`/`pre-push`) is deliberately extensionless, matching
+* the real filename `holocron repo setup` writes, which ECMAScript's own
+* module resolution (`moduleResolution: "nodenext"`) can't import across
+* a package boundary without an extension. Keep in sync with that file by
+* hand; it changes rarely.
+*/
+const ALEX_IGNORE_PATTERNS = [
+	".github/*",
+	"CHANGELOG.md",
+	"LICENSE"
+];
+//#endregion
+//#region src/lint/editorconfig-checker-exclude/editorconfig-checker-exclude.ts
+/**
+* The paths editorconfig-checker skips, read from the same
+* `editorconfig-checker.json` template `holocron repo setup` writes as a repo's
+* `.editorconfig-checker.json` — so Sentinel's central editorconfig check
+* (holocron#927) excludes exactly what CI's editorconfig-checker does, from
+* one source.
+*
+* The exclusion that matters most is `\.md$` / `\.mdx$`: the generated
+* `.editorconfig` gives every file tab indentation, but
+* `@theholocron/prettier-config` formats markdown with spaces, so a README's
+* indented code example would fail one tool or the other. Markdown is left
+* to prettier and markdownlint.
+*
+* Each entry is a regular-expression source, matched against a
+* repo-relative path, as editorconfig-checker itself treats them.
+*/
+const EDITORCONFIG_CHECKER_EXCLUDE = editorconfig_checker_default.Exclude;
+//#endregion
+//#region src/lint/is-editorconfig-excluded/is-editorconfig-excluded.ts
+/** `true` when `path` matches any {@link EDITORCONFIG_CHECKER_EXCLUDE} pattern. */
+function isEditorConfigExcluded(path) {
+	return EDITORCONFIG_CHECKER_EXCLUDE.some((pattern) => new RegExp(pattern).test(path));
+}
+//#endregion
+//#region src/lint/lint-message/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
+* 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/lint/lint-commit-msg-file/lint-commit-msg-file.ts
+/**
+* `holocron run 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/lint/prettier-ignore-patterns/prettier-ignore-patterns.ts
+/**
+* The org's canonical prettier ignore-pattern list for a central Sentinel
+* check (holocron#769/#819) — the `PRETTIER_CONFIG` object itself doesn't
+* need a home here, since `@theholocron/prettier-config`'s default export
+* already *is* one canonical, importable config (the same "one config,
+* not N copies" reasoning `@theholocron/commitlint-config` established for
+* commit-message linting, and `ALEX_CONFIG` established for inclusive
+* language) — only the ignore list is a Sentinel-specific decision that
+* belongs alongside `ALEX_IGNORE_PATTERNS`, not inside the config package.
+*
+* Reuses `ALEX_IGNORE_PATTERNS`' own entries (`.github/*`, `CHANGELOG.md`,
+* `LICENSE` all independently confirmed to fail a real `prettier.check()`
+* today — machine-generated or unparseable content, same reasoning that
+* excluded them from alex), plus `pnpm-lock.yaml` — prettier-specific
+* (alex never reads a lockfile, but prettier would try to reformat it):
+* machine-written by pnpm's own writer, and not gitignored (lockfiles are
+* tracked), so prettier picks it up by default. Reformatting it
+* fights every subsequent `pnpm install` (this repo's own `.prettierignore`
+* already excludes it for that exact reason).
+*/
+const PRETTIER_IGNORE_PATTERNS = [...ALEX_IGNORE_PATTERNS, "pnpm-lock.yaml"];
+//#endregion
+export { ALEX_CONFIG, ALEX_IGNORE_PATTERNS, EDITORCONFIG_CHECKER_EXCLUDE, PRETTIER_IGNORE_PATTERNS, isEditorConfigExcluded, lintCommitMessage, lintCommitMsgFile };

package/dist/load-DdHEVFlG.mjs

@@ -0,0 +1,55 @@
+import { loadLayered } from "@theholocron/datapad";
+//#region src/config/schema/schema.ts
+/**
+* The `tasks` config shape — the single manifest of what a repo runs.
+* Read from a dedicated `astromech.config.*` file or the `tasks` key of
+* `holocron.config.*` (see {@link loadTasksConfig}).
+*
+* Runtime validation is the loader's job, not this type's — the type only
+* describes what an author writes.
+*/
+/** Normalise a `TaskConfigItem` to a full {@link TaskEntry} with defaults applied. */
+function normalizeTaskEntry(item) {
+	return {
+		ci: true,
+		local: true,
+		...typeof item === "string" ? { name: item } : item
+	};
+}
+//#endregion
+//#region src/config/coerce-tasks/coerce-tasks.ts
+/** A bare item array is shorthand for `{ tasks: [...] }`. */
+function coerceTasks(value) {
+	if (value == null) return void 0;
+	return Array.isArray(value) ? { tasks: value } : value;
+}
+//#endregion
+//#region src/config/load/load.ts
+/**
+* Resolve the task manifest for a repo: the `tasks` key of
+* `holocron.config.*`, then a dedicated `astromech.config.*` merged on
+* top (dedicated wins; item arrays concatenate). Returns `{}` when
+* neither source is present.
+*
+* `walkUp: true` — `holocron run`/`ci` are usable from any subdirectory of
+* a repo, not only its exact root (datapad walks up to the nearest `.git`
+* boundary; see `@theholocron/datapad`'s own doc comment).
+*
+* A caller that has already loaded `holocron.config.*` passes it as
+* `options.holocron` so it is not found and loaded again.
+*/
+async function loadTasksConfig(cwd, options = {}) {
+	return (await loadLayered({
+		cwd,
+		name: "astromech",
+		walkUp: true,
+		fallback: {
+			file: "holocron",
+			key: "tasks",
+			preloaded: options.holocron
+		},
+		coerce: (raw) => coerceTasks(raw)
+	}))?.config ?? {};
+}
+//#endregion
+export { coerceTasks as n, normalizeTaskEntry as r, loadTasksConfig as t };

package/dist/{schema-D01VYg43.d.mts → schema.type-BJmfOafW.d.mts}

@@ -1,18 +1,10 @@
-//#region src/config/schema.d.ts
-/**
- * The `tasks` config shape — the single manifest of what a repo runs.
- * Read from a dedicated `astromech.config.*` file or the `tasks` key of
- * `holocron.config.*` (see {@link loadTasksConfig}).
- *
- * Runtime validation is the loader's job, not this type's — the type only
- * describes what an author writes.
- */
+//#region src/config/schema/schema.type.d.ts
 interface TaskEntry {
   /** Registry task name — `verification.unitTests`, `sourceQuality.staticAnalysis`, `delivery.build`, … */
   name: string;
   /**
    * Emit a `.github/workflows/<name>.yml` thin caller and include the task
-   * in `holocron ci`. Default `true`.
+   * in `holocron run ci`. Default `true`.
    */
   ci?: boolean;
   /**
@@ -24,7 +16,7 @@ interface TaskEntry {
   /**
    * The task's CI check context (from `WORKFLOW_CHECK_CONTEXTS`) is a
    * required status check in branch protection (`astromech.requiredChecks()`)
-   * and part of `holocron ci`'s default run.
+   * and part of `holocron run ci`'s default run.
    */
   required?: boolean;
   /** Per-repo overrides on the same channel the reusable workflow reads. */
@@ -40,6 +32,15 @@ interface TaskEntry {
   turbo?: {
     /** Extra env vars turbo hashes into this task's cache key, appended to the registry default (empty when the task has none). */
     passThroughEnv?: string[];
+    /**
+     * Extra input globs appended to the registry default's `inputs`
+     * (holocron#845) — for a package whose layout the registry's
+     * `"src/**"` default doesn't cover (e.g. a flat-layout package with
+     * no `src/` directory at all). Appended, not replaced: the
+     * registry's other inputs (`package.json`, `tsdown.config.ts`, …)
+     * stay tracked without needing to be repeated here.
+     */
+    inputs?: string[];
   };
 }
 /** A task is either its bare name (all defaults) or an entry object. */
@@ -58,12 +59,12 @@ interface TasksConfig {
   /**
    * Required status-check contexts not backed by a task — codecov gates,
    * a bundle-build check, … Appended to `astromech.requiredChecks()` after the
-   * `required`-task contexts. (`DCO` is prepended by `holocron setup` itself.)
+   * `required`-task contexts. (`DCO` is prepended by `holocron repo setup` itself.)
    */
   extraRequiredChecks?: string[];
   /**
-   * Git hooks `holocron setup` installs. `true` / `{ prePush: true }` writes
-   * `.husky/pre-push` (runs `holocron ci`); `false` / `{ prePush: false }`
+   * Git hooks `holocron repo setup` installs. `true` / `{ prePush: true }` writes
+   * `.husky/pre-push` (runs `holocron run ci`); `false` / `{ prePush: false }`
    * opts out. Omitted → on for `protection: "strict"` repos, off otherwise.
    * When enabled, `packageScripts()` also emits `prepare: "husky"`.
    */
@@ -71,7 +72,5 @@ interface TasksConfig {
     prePush?: boolean;
   };
 }
-/** Normalise a `TaskConfigItem` to a full {@link TaskEntry} with defaults applied. */
-declare function normalizeTaskEntry(item: TaskConfigItem): Required<Pick<TaskEntry, "name" | "ci" | "local">> & TaskEntry;
 //#endregion
-export { normalizeTaskEntry as i, TaskEntry as n, TasksConfig as r, TaskConfigItem as t };
+export { TaskEntry as n, TasksConfig as r, TaskConfigItem as t };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@theholocron/astromech",
-  "version": "5.0.0-alpha.17",
-  "description": "The Holocron task runner — one task manifest drives `holocron run`, `holocron ci`, the CI workflows, package.json scripts, linters, and required checks.",
+  "version": "5.0.0-alpha.170",
+  "description": "The Holocron task runner — one task manifest drives `holocron run`, `holocron run ci`, the CI workflows, package.json scripts, linters, and required checks.",
   "keywords": [
     "ci",
     "holocron",
@@ -31,19 +31,33 @@
       "types": "./dist/config/index.d.mts",
       "import": "./dist/config/index.mjs",
       "default": "./dist/config/index.mjs"
+    },
+    "./lint": {
+      "types": "./dist/lint/index.d.mts",
+      "import": "./dist/lint/index.mjs",
+      "default": "./dist/lint/index.mjs"
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@theholocron/datapad": "5.0.0-alpha.17"
+    "@commitlint/lint": "^21.2.3",
+    "@commitlint/load": "^21.2.3",
+    "@commitlint/types": "^21.2.3",
+    "@theholocron/fs-utils": "^1.16.0",
+    "@theholocron/json-utils": "^1.16.0",
+    "@theholocron/pkg-utils": "^1.16.0",
+    "@theholocron/datapad": "5.0.0-alpha.170"
   },
   "devDependencies": {
-    "@theholocron/eslint-config": "^8.0.0",
-    "@theholocron/tsconfig": "^8.0.0",
-    "@theholocron/tsdown-config": "^8.0.0",
-    "@theholocron/vitest-config": "^8.0.0",
+    "@commitlint/config-conventional": "^21.2.3",
+    "@theholocron/commitlint-config": "^8.8.0",
+    "@theholocron/eslint-config": "^8.8.0",
+    "@theholocron/rollup-plugin-transform-template": "^8.8.0",
+    "@theholocron/tsconfig": "^8.8.0",
+    "@theholocron/tsdown-config": "^8.8.0",
+    "@theholocron/vitest-config": "^8.8.0",
     "@types/node": "^26",
     "@vitest/coverage-v8": "^4.1.11",
     "@vitest/eslint-plugin": "^1.6.27",
@@ -52,8 +66,7 @@
     "globals": "^17.11.0",
     "tsdown": "^0.22.14",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.11",
-    "@theholocron/rollup-plugin-transform-template": "5.0.0-alpha.17"
+    "vitest": "^4.1.11"
   },
   "engines": {
     "node": ">=22"

package/dist/schema-Cf5dfaDO.mjs

@@ -1,11 +0,0 @@
-//#region src/config/schema.ts
-/** Normalise a `TaskConfigItem` to a full {@link TaskEntry} with defaults applied. */
-function normalizeTaskEntry(item) {
-	return {
-		ci: true,
-		local: true,
-		...typeof item === "string" ? { name: item } : item
-	};
-}
-//#endregion
-export { normalizeTaskEntry as t };