@decohere/ci-tools 0.0.1-dev.10

package/src/release/push-prerelease-commit.mjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * Publish prerelease version commit via PR
+ * Validates working tree, pushes prerelease commit to a release branch,
+ * and creates/updates a PR targeting the protected base branch.
+ */
+
+import { execSync } from "node:child_process";
+
+function run(command) {
+	return execSync(command, { encoding: "utf8" }).trim();
+}
+
+function runInherit(command, env) {
+	execSync(command, { stdio: "inherit", env });
+}
+
+try {
+	// Check if working tree is dirty
+	const status = run("git status --porcelain");
+	if (status.trim().length > 0) {
+		console.error(
+			"::error::Working tree is dirty after version/dependency sync; refusing to publish with uncommitted changes.",
+		);
+		console.log(status);
+		process.exit(1);
+	}
+
+	// Compare HEAD with origin and create a PR branch targeting an explicit base branch.
+	const head = run("git rev-parse HEAD");
+	const sourceBranch = process.env.GITHUB_REF_NAME || run("git rev-parse --abbrev-ref HEAD");
+	const channel = process.env.RELEASE_CHANNEL ?? "beta";
+	const baseBranch = process.env.RELEASE_BASE_BRANCH || sourceBranch;
+	const releasePrBranch = `release/${channel}-${sourceBranch}-to-${baseBranch}`;
+	const token = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+
+	try {
+		const origin = run(`git rev-parse origin/${sourceBranch}`);
+
+		if (head !== origin) {
+			console.log(
+				`Publishing release commit via PR branch origin/${releasePrBranch} (base: origin/${baseBranch})`,
+			);
+			runInherit(`git push origin HEAD:${releasePrBranch} --force`, process.env);
+
+			if (token == null || token.length === 0) {
+				throw new Error("Missing GITHUB_TOKEN/GH_TOKEN for PR upsert");
+			}
+
+			const version = process.env.RELEASE_VERSION ?? "(unknown)";
+			const ownerRepo = run("git config --get remote.origin.url")
+				.replace(/^.*github\.com[:/]/, "")
+				.replace(/\.git$/, "");
+
+			runInherit(
+				[
+					"node projects/ci-tools/src/github/create-or-update-pr.mjs",
+					`--title "chore(release): ${channel} ${version}"`,
+					`--base "${baseBranch}"`,
+					`--head "${releasePrBranch}"`,
+					`--body "Automated ${channel} version bump and dependency sync.\\n\\n- Channel: ${channel}\\n- Version: ${version}\\n- Source branch: ${sourceBranch}\\n- Base branch: ${baseBranch}\\n- Source commit: ${head}\\n\\nGenerated by pull-request workflow."`,
+					`--owner "${ownerRepo.split("/")[0]}"`,
+					`--repo "${ownerRepo.split("/")[1]}"`,
+				].join(" "),
+				{ ...process.env, GITHUB_TOKEN: token },
+			);
+		} else {
+			console.log("No prerelease version commit to push.");
+		}
+	} catch (err) {
+		const message = err?.message ?? "";
+		if (
+			message.includes(`origin/${sourceBranch}`) &&
+			message.includes("Needed a single revision")
+		) {
+			console.log(`Remote branch origin/${sourceBranch} not found, skipping push.`);
+		} else {
+			console.error("::error::Failed to publish release commit via PR branch.");
+			throw err;
+		}
+	}
+} catch (e) {
+	console.error(`Push failed: ${e.message}`);
+	process.exit(1);
+}

package/src/release/sync-dependencies.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * Sync cross-library dependency versions
+ * Conditionally runs sync with or without commit based on DRY_RUN flag
+ */
+
+import { execSync } from "node:child_process";
+
+const DRY_RUN = process.env.DRY_RUN === "true";
+const TERMINAL_CLI = process.env.TERMINAL_CLI || "dist/debug/projects/terminal/src/cli.js";
+const DECOHERE_CONFIG = process.env.DECOHERE_CONFIG || ".decohere.js";
+
+const baseCmd = `node "${TERMINAL_CLI}" --log-level trace --config-file "${DECOHERE_CONFIG}" forge dependencies --configuration release sync`;
+
+try {
+	if (DRY_RUN) {
+		console.log(`[DRY RUN] ${baseCmd}`);
+		execSync(baseCmd, { stdio: "inherit" });
+	} else {
+		const commitCmd = `${baseCmd} --commit --message "chore: version packages and sync cross-library dependencies [skip ci]"`;
+		console.log(`Syncing with commit...`);
+		execSync(commitCmd, { stdio: "inherit" });
+	}
+} catch (e) {
+	console.error(`Dependency sync failed: ${e.message}`);
+	process.exit(1);
+}

package/tests/lib/lcov.test.mjs

@@ -0,0 +1,84 @@
+import { describe, expect, it } from "vitest";
+import {
+	getProjectFromPath,
+	parseLcovByProject,
+	parseLcovFiles,
+} from "../../src/lib/lcov.mjs";
+
+const sampleLcov = `SF:projects/forge/src/index.ts
+LF:10
+LH:9
+end_of_record
+SF:projects/forge/src/build/index.ts
+LF:20
+LH:15
+end_of_record
+SF:projects/nexus/src/index.ts
+LF:5
+LH:5
+end_of_record
+`;
+
+const sampleLcovWithLines = `SF:projects/anvil/src/index.ts
+DA:1,1
+DA:2,1
+DA:3,0
+DA:4,0
+DA:5,1
+LF:5
+LH:3
+end_of_record
+`;
+
+describe("getProjectFromPath", () => {
+	it("extracts project name from projects/ path", () => {
+		expect(getProjectFromPath("projects/forge/src/index.ts")).toBe("forge");
+	});
+
+	it("returns undefined for unrecognized paths", () => {
+		expect(getProjectFromPath("src/index.ts")).toBeUndefined();
+	});
+});
+
+describe("parseLcovByProject", () => {
+	it("groups files by project and sums coverage", () => {
+		const result = parseLcovByProject(sampleLcov);
+		expect(result.get("forge")).toBeDefined();
+		expect(result.get("forge").totalLines).toBe(30);
+		expect(result.get("forge").coveredLines).toBe(24);
+		expect(result.get("nexus")).toBeDefined();
+		expect(result.get("nexus").totalLines).toBe(5);
+		expect(result.get("nexus").coveredLines).toBe(5);
+	});
+
+	it("ignores records with LF:0", () => {
+		const lcov = `SF:projects/forge/src/empty.ts\nLF:0\nLH:0\nend_of_record\n`;
+		const result = parseLcovByProject(lcov);
+		expect(result.size).toBe(0);
+	});
+});
+
+describe("parseLcovFiles", () => {
+	it("returns per-file coverage with uncovered line numbers", () => {
+		const result = parseLcovFiles(sampleLcovWithLines);
+		const file = result.find((f) => f.sourcePath === "projects/anvil/src/index.ts");
+		expect(file).toBeDefined();
+		expect(file.totalLines).toBe(5);
+		expect(file.coveredLines).toBe(3);
+		expect(file.uncoveredLineNumbers).toEqual([3, 4]);
+		expect(file.uncoveredLines).toBe(2);
+	});
+
+	it("includes files with 100% coverage", () => {
+		const lcov = `SF:projects/anvil/src/full.ts\nDA:1,1\nDA:2,1\nLF:2\nLH:2\nend_of_record\n`;
+		const result = parseLcovFiles(lcov);
+		expect(result).toHaveLength(1);
+		expect(result[0].uncoveredLineNumbers).toEqual([]);
+	});
+
+	it("excludes files with LF:0", () => {
+		const lcov = `SF:projects/anvil/src/empty.ts\nLF:0\nLH:0\nend_of_record\n`;
+		const result = parseLcovFiles(lcov);
+		expect(result).toHaveLength(0);
+	});
+});

package/tests/lib/svg.test.mjs

@@ -0,0 +1,94 @@
+import { describe, expect, it } from "vitest";
+import { createBadgeSvg, getColor, statusToColor, statusToText } from "../../src/lib/svg.mjs";
+
+describe("getColor", () => {
+	it("returns green for >= 90%", () => {
+		expect(getColor(90)).toBe("#2ea043");
+		expect(getColor(100)).toBe("#2ea043");
+	});
+
+	it("returns light green for >= 80%", () => {
+		expect(getColor(80)).toBe("#3fb950");
+		expect(getColor(89)).toBe("#3fb950");
+	});
+
+	it("returns yellow for >= 70%", () => {
+		expect(getColor(70)).toBe("#9a6700");
+		expect(getColor(79)).toBe("#9a6700");
+	});
+
+	it("returns orange for >= 60%", () => {
+		expect(getColor(60)).toBe("#db6d28");
+		expect(getColor(69)).toBe("#db6d28");
+	});
+
+	it("returns red for < 60%", () => {
+		expect(getColor(59)).toBe("#cf222e");
+		expect(getColor(0)).toBe("#cf222e");
+	});
+});
+
+describe("createBadgeSvg", () => {
+	it("generates valid SVG with label and value", () => {
+		const svg = createBadgeSvg("Coverage", "92.5%", "#2ea043");
+		expect(svg).toContain("<svg");
+		expect(svg).toContain("Coverage");
+		expect(svg).toContain("92.5%");
+		expect(svg).toContain("#2ea043");
+		expect(svg).toContain("</svg>");
+	});
+
+	it("sets aria-label with label and value", () => {
+		const svg = createBadgeSvg("CI Main", "passing", "#2ea043");
+		expect(svg).toContain('aria-label="CI Main: passing"');
+	});
+
+	it("sets title element", () => {
+		const svg = createBadgeSvg("Coverage", "75%", "#9a6700");
+		expect(svg).toContain("<title>Coverage: 75%</title>");
+	});
+});
+
+describe("statusToColor", () => {
+	it("returns orange for in_progress", () => {
+		expect(statusToColor("in_progress", null)).toBe("#fb8500");
+	});
+
+	it("returns green for success", () => {
+		expect(statusToColor("completed", "success")).toBe("#2ea043");
+	});
+
+	it("returns red for failure", () => {
+		expect(statusToColor("completed", "failure")).toBe("#cf222e");
+	});
+
+	it("returns gray for cancelled", () => {
+		expect(statusToColor("completed", "cancelled")).toBe("#6e7781");
+	});
+
+	it("returns gray for unknown", () => {
+		expect(statusToColor("completed", "unknown")).toBe("#6e7781");
+	});
+});
+
+describe("statusToText", () => {
+	it("returns 'running' for in_progress", () => {
+		expect(statusToText("in_progress", null)).toBe("running");
+	});
+
+	it("returns 'passing' for success", () => {
+		expect(statusToText("completed", "success")).toBe("passing");
+	});
+
+	it("returns 'failing' for failure", () => {
+		expect(statusToText("completed", "failure")).toBe("failing");
+	});
+
+	it("returns 'cancelled' for cancelled", () => {
+		expect(statusToText("completed", "cancelled")).toBe("cancelled");
+	});
+
+	it("returns 'unknown' for unrecognized state", () => {
+		expect(statusToText("completed", "timed_out")).toBe("unknown");
+	});
+});