@theholocron/astromech 4.17.1 → 4.17.2

package/README.md

@@ -91,6 +91,7 @@ const astromech = createAstromech({ cwd, config, orgContext: { org, domain } });
 astromech.thinCallers(); // Map<"<name>.yml", yaml>  — one per templated, ci-enabled task
 astromech.packageScripts(); // { holocron: "holocron", lint: "holocron run lint", … }
 astromech.requiredChecks(); // ["Lint / Conclusion", "codecov/patch", …]  — branch-protection contexts
+astromech.codecovConfig(existing); // codecov.yml content — merges into `existing`, or scaffolds fresh when null
 astromech.ci({ scope: "required" }); // CiReport — run the gating checks locally, in CI order
 ```
 
@@ -122,6 +123,18 @@ only.
 `holocron run` itself does not read the config yet — that (and
 `holocron ci`) come in later phases (epic #581).
 
+### `codecov.yml`
+
+`codecovConfig(existing)` generates this repo's `codecov.yml` — component
+`paths` derived from `packages/*`, same manifest-derived category as
+`thinCallers()`. Pass the current file's content (or `null`) and it either
+merges the `individual_components` list in (preserving everything else in the
+file — thresholds, flags, custom rules) or scaffolds a fresh file from the
+base template. `holocron setup` writes the result via the `source` capability;
+this method never touches the filesystem beyond reading `packages/*` under
+`cwd`. Moved here from `@theholocron/cli` (#650) — the coverage setup tracks
+the `test` task, the same way required checks track `tasks`.
+
 ## Lint parity
 
 One linter list drives both CI and local — no asymmetry. Source: the

package/dist/index.d.mts

@@ -363,9 +363,53 @@ interface Astromech {
    * the list; this method is policy-free (manifest only).
    */
   requiredChecks(): string[];
+  /**
+   * This repo's `codecov.yml` — component `paths` derived from `packages/*`.
+   * Pass the current file's content (`null` if none exists yet) to either
+   * merge the component list in or scaffold a fresh file. Policy-free same
+   * as {@link requiredChecks} — `holocron setup` owns writing the result.
+   */
+  codecovConfig(existing: string | null): string;
 }
 declare function createAstromech(options: AstromechOptions): Astromech;
 //#endregion
+//#region src/codecov.d.ts
+/**
+ * `codecov.yml` generation — a manifest-derived artifact (component `paths`
+ * come from workspace packages; the status targets track the `test` task's
+ * coverage setup), the same category as the reusable `test.yml` this package
+ * also generates. Moved out of `@theholocron/cli` (theholocron/holocron#650)
+ * — `holocron setup`'s codecov step now calls {@link codecovConfig} instead
+ * of importing this logic directly.
+ */
+interface WorkspacePackage {
+  slug: string;
+  name: string;
+}
+declare function codecovComponentBlock(packages: WorkspacePackage[]): string;
+/**
+ * Ensure every codecov status default carries `if_not_found: success`, so an
+ * infra-only PR (dep bump, config, lockfile — no coverable change) passes
+ * instead of hanging forever on a required check codecov never posts.
+ *
+ * Injects the key on the line after each `target:` that sits inside a status
+ * block (`coverage.status.*.default` or a `statuses:` list item — indent ≥ 8,
+ * or ≥ 8 for a `- type:` list entry), when the immediate sibling lines do not
+ * already declare it.
+ */
+declare function ensureIfNotFound(yaml: string): string;
+declare function mergeCodecovComponents(existing: string, packages: WorkspacePackage[]): string;
+/** Every public `packages/*` workspace, sorted by slug. `[]` when there's no `packages/` dir. */
+declare function readWorkspacePackages(repoRoot: string): WorkspacePackage[];
+/** A brand-new `codecov.yml` — the scaffold header + the base template + this repo's component list. */
+declare function createCodecovConfig(packages: WorkspacePackage[]): string;
+/**
+ * The full pipeline `holocron setup` needs: read this repo's public
+ * `packages/*`, then either merge them into an `existing` `codecov.yml` or
+ * scaffold a new one.
+ */
+declare function codecovConfig(repoRoot: string, existing: string | null): string;
+//#endregion
 //#region src/linters.d.ts
 /**
  * The linter registry — one list of linter names (from `config.tasks`'
@@ -539,4 +583,4 @@ declare const WORKFLOW_TEMPLATE_PROPERTIES: Record<string, string>;
  */
 declare function reusableTemplates(): Map<string, string>;
 //#endregion
-export { type Astromech, type AstromechOptions, CI_ORDER, type CiJobReport, type CiOptions, type CiReport, type ExecFn, type JobDef, KNOWN_TASKS, KNOWN_WORKFLOWS, LINTERS, LINTER_NAMES, type LinterDef, type LocalRunner, type OrgContext, type PreviewConfig, REUSABLE_ACTIONS, REUSABLE_WORKFLOWS, type RunLogger, type RunOptions, type RunTaskInput, type RunTaskReport, type SuperLinterConfig, TASKS, type TaskDef, WORKFLOW_CHECK_CONTEXTS, WORKFLOW_TEMPLATES, WORKFLOW_TEMPLATE_PROPERTIES, baselineSuperLinterEnv, createAstromech, deriveDeployPaths, extractPreviewConfig, generateCombinedDeployContent, generateThinCallerContent, lintThinCallerWith, normalizeWorkflowWith, requiredChecks, resolveLinters, reusableTemplates, runCi, runTask, superLinterConfig };
+export { type Astromech, type AstromechOptions, CI_ORDER, type CiJobReport, type CiOptions, type CiReport, type ExecFn, type JobDef, KNOWN_TASKS, KNOWN_WORKFLOWS, LINTERS, LINTER_NAMES, type LinterDef, type LocalRunner, type OrgContext, type PreviewConfig, REUSABLE_ACTIONS, REUSABLE_WORKFLOWS, type RunLogger, type RunOptions, type RunTaskInput, type RunTaskReport, type SuperLinterConfig, TASKS, type TaskDef, WORKFLOW_CHECK_CONTEXTS, WORKFLOW_TEMPLATES, WORKFLOW_TEMPLATE_PROPERTIES, type WorkspacePackage, baselineSuperLinterEnv, codecovComponentBlock, codecovConfig, createAstromech, createCodecovConfig, deriveDeployPaths, ensureIfNotFound, extractPreviewConfig, generateCombinedDeployContent, generateThinCallerContent, lintThinCallerWith, mergeCodecovComponents, normalizeWorkflowWith, readWorkspacePackages, requiredChecks, resolveLinters, reusableTemplates, runCi, runTask, superLinterConfig };

package/dist/index.mjs

@@ -931,6 +931,108 @@ function taskName(item) {
 	return typeof item === "string" ? item : item.name;
 }
 //#endregion
+//#region src/templates/codecov/codecov.yml
+var codecov_default = "codecov:\n  require_ci_to_pass: true\n\ncoverage:\n  precision: 2\n  round: down\n  status:\n    project:\n      default:\n        target: auto\n        threshold: 2%\n        # Infra-only PRs (dep bumps, config, lockfile) touch no coverable code,\n        # so codecov produces no report to compare. Pass instead of blocking\n        # forever on a required check that will never post.\n        if_not_found: success\n    patch:\n      default:\n        target: 80%\n        if_not_found: success\n\ncomment:\n  layout: \"reach,diff,flags,components\"\n  behavior: default\n  require_changes: true\n\ncomponent_management:\n  default_rules:\n    statuses:\n      - type: patch\n        target: 80%\n        if_not_found: success\n  individual_components:\n";
+//#endregion
+//#region src/codecov.ts
+/**
+* `codecov.yml` generation — a manifest-derived artifact (component `paths`
+* come from workspace packages; the status targets track the `test` task's
+* coverage setup), the same category as the reusable `test.yml` this package
+* also generates. Moved out of `@theholocron/cli` (theholocron/holocron#650)
+* — `holocron setup`'s codecov step now calls {@link codecovConfig} instead
+* of importing this logic directly.
+*/
+const INDIVIDUAL_COMPONENTS_MARKER = "  individual_components:";
+function scaffoldHeader() {
+	return [
+		`# Scaffolded by holocron setup — edit this file freely.`,
+		`# Source:  theholocron/holocron · packages/astromech/src/codecov.ts`,
+		``
+	].join("\n");
+}
+function codecovComponentBlock(packages) {
+	if (packages.length === 0) return "\n    []\n";
+	return "\n" + packages.flatMap(({ slug }) => [
+		`    - component_id: ${slug}`,
+		`      name: "${slug}"`,
+		`      paths:`,
+		`        - packages/${slug}/**`,
+		``
+	]).join("\n");
+}
+/**
+* Ensure every codecov status default carries `if_not_found: success`, so an
+* infra-only PR (dep bump, config, lockfile — no coverable change) passes
+* instead of hanging forever on a required check codecov never posts.
+*
+* Injects the key on the line after each `target:` that sits inside a status
+* block (`coverage.status.*.default` or a `statuses:` list item — indent ≥ 8,
+* or ≥ 8 for a `- type:` list entry), when the immediate sibling lines do not
+* already declare it.
+*/
+function ensureIfNotFound(yaml) {
+	const lines = yaml.split("\n");
+	const out = [];
+	for (let i = 0; i < lines.length; i++) {
+		const line = lines[i];
+		out.push(line);
+		const m = /^(\s{8,})target:\s+\S+\s*$/.exec(line);
+		if (!m) continue;
+		const indent = m[1];
+		let alreadySet = false;
+		for (let j = i + 1; j < lines.length; j++) {
+			const sib = lines[j];
+			if (sib.trim() === "") continue;
+			const sibIndent = sib.match(/^\s*/)[0].length;
+			if (sibIndent < indent.length) break;
+			if (sibIndent === indent.length && /^\s*if_not_found\s*:/.test(sib)) {
+				alreadySet = true;
+				break;
+			}
+			if (sibIndent === indent.length && /^\s*(- |\w)/.test(sib) && !/^\s*(threshold|flags|paths|branches)\s*:/.test(sib)) break;
+		}
+		if (!alreadySet) out.push(`${indent}if_not_found: success`);
+	}
+	return out.join("\n");
+}
+function mergeCodecovComponents(existing, packages) {
+	const idx = existing.indexOf(INDIVIDUAL_COMPONENTS_MARKER);
+	if (idx === -1) return ensureIfNotFound(existing);
+	return ensureIfNotFound(existing.slice(0, idx + 24)) + codecovComponentBlock(packages);
+}
+/** Every public `packages/*` workspace, sorted by slug. `[]` when there's no `packages/` dir. */
+function readWorkspacePackages(repoRoot) {
+	const packagesDir = join(repoRoot, "packages");
+	if (!existsSync(packagesDir)) return [];
+	const packages = [];
+	for (const entry of readdirSync(packagesDir, { withFileTypes: true })) {
+		if (!entry.isDirectory()) continue;
+		try {
+			const raw = readFileSync(join(packagesDir, entry.name, "package.json"), "utf8");
+			const pkg = JSON.parse(raw);
+			if (typeof pkg.name === "string") packages.push({
+				slug: entry.name,
+				name: pkg.name
+			});
+		} catch {}
+	}
+	return packages.sort((a, b) => a.slug.localeCompare(b.slug));
+}
+/** A brand-new `codecov.yml` — the scaffold header + the base template + this repo's component list. */
+function createCodecovConfig(packages) {
+	return `${scaffoldHeader()}${codecov_default.trimEnd()}${codecovComponentBlock(packages)}`;
+}
+/**
+* The full pipeline `holocron setup` needs: read this repo's public
+* `packages/*`, then either merge them into an `existing` `codecov.yml` or
+* scaffold a new one.
+*/
+function codecovConfig(repoRoot, existing) {
+	const packages = readWorkspacePackages(repoRoot);
+	return existing != null ? mergeCodecovComponents(existing, packages) : createCodecovConfig(packages);
+}
+//#endregion
 //#region src/required-checks.ts
 /**
 * `requiredChecks(config)` — the branch-protection required-status-check list,
@@ -1238,8 +1340,9 @@ function createAstromech(options) {
 			rootFiles: rootFiles()
 		}),
 		reusableTemplates: () => reusableTemplates(),
-		requiredChecks: () => requiredChecks(options.config ?? {})
+		requiredChecks: () => requiredChecks(options.config ?? {}),
+		codecovConfig: (existing) => codecovConfig(options.cwd, existing)
 	};
 }
 //#endregion
-export { CI_ORDER, KNOWN_TASKS, KNOWN_WORKFLOWS, LINTERS, LINTER_NAMES, REUSABLE_ACTIONS, REUSABLE_WORKFLOWS, TASKS, WORKFLOW_CHECK_CONTEXTS, WORKFLOW_TEMPLATES, WORKFLOW_TEMPLATE_PROPERTIES, baselineSuperLinterEnv, createAstromech, deriveDeployPaths, extractPreviewConfig, generateCombinedDeployContent, generateThinCallerContent, lintThinCallerWith, normalizeWorkflowWith, requiredChecks, resolveLinters, reusableTemplates, runCi, runTask, superLinterConfig };
+export { CI_ORDER, KNOWN_TASKS, KNOWN_WORKFLOWS, LINTERS, LINTER_NAMES, REUSABLE_ACTIONS, REUSABLE_WORKFLOWS, TASKS, WORKFLOW_CHECK_CONTEXTS, WORKFLOW_TEMPLATES, WORKFLOW_TEMPLATE_PROPERTIES, baselineSuperLinterEnv, codecovComponentBlock, codecovConfig, createAstromech, createCodecovConfig, deriveDeployPaths, ensureIfNotFound, extractPreviewConfig, generateCombinedDeployContent, generateThinCallerContent, lintThinCallerWith, mergeCodecovComponents, normalizeWorkflowWith, readWorkspacePackages, requiredChecks, resolveLinters, reusableTemplates, runCi, runTask, superLinterConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/astromech",
-  "version": "4.17.1",
+  "version": "4.17.2",
   "description": "The Holocron task runner — one task manifest drives `holocron run`, `holocron ci`, the CI workflows, package.json scripts, linters, and required checks.",
   "keywords": [
     "ci",
@@ -37,7 +37,7 @@
     "dist"
   ],
   "dependencies": {
-    "@theholocron/datapad": "4.17.1"
+    "@theholocron/datapad": "4.17.2"
   },
   "devDependencies": {
     "@theholocron/eslint-config": "^8.0.0",
@@ -53,7 +53,7 @@
     "tsdown": "^0.22.14",
     "typescript": "^5.9.3",
     "vitest": "^4.1.11",
-    "@theholocron/rollup-plugin-transform-template": "4.17.1"
+    "@theholocron/rollup-plugin-transform-template": "4.17.2"
   },
   "engines": {
     "node": ">=22"