@decohere/ci-tools 0.0.1-dev.11 → 0.0.1-dev.110

package/tests/github/smoke-create-launcher.test.mjs

@@ -0,0 +1,71 @@
+import { fileURLToPath } from "node:url";
+import { describe, expect, it, vi } from "vitest";
+import { runCreateLauncherSmoke } from "../../src/github/smoke-create-launcher.mjs";
+
+const fs = await vi.importActual("node:fs");
+const PUBLISH_YML = fileURLToPath(
+	new URL("../../../../.github/workflows/publish.yml", import.meta.url),
+);
+
+describe("runCreateLauncherSmoke", () => {
+	it("execs npx from a temp directory, not the repo root", () => {
+		/** @type {{ cmd: string, args: string[], opts: { cwd?: string } }[]} */
+		const calls = [];
+		const written = [];
+
+		const result = runCreateLauncherSmoke({
+			createVersion: "0.0.1-dev.80",
+			authToken: "tok",
+			tmpdir: () => "/tmp",
+			mkdtempSync: (prefix) => `${prefix}abc`,
+			writeFileSync: (path, body) => {
+				written.push({ path, body });
+			},
+			spawnSync: (cmd, args, opts) => {
+				calls.push({ cmd, args, opts });
+				return { status: 0 };
+			},
+			stdio: "pipe",
+		});
+
+		expect(result.workDir).toBe("/tmp/decohere-create-smoke-abc");
+		expect(result.workDir).not.toBe(process.cwd());
+		expect(calls).toHaveLength(1);
+		expect(calls[0].cmd).toBe("npx");
+		expect(calls[0].args).toEqual(["--yes", "@decohere/create@0.0.1-dev.80", "--help"]);
+		expect(calls[0].opts.cwd).toBe("/tmp/decohere-create-smoke-abc");
+		expect(calls[0].opts.cwd).not.toBe(process.cwd());
+		expect(written).toEqual([
+			{
+				path: "/tmp/decohere-create-smoke-abc/.npmrc",
+				body: "@decohere:registry=https://registry.npmjs.org/\n//registry.npmjs.org/:_authToken=tok\n",
+			},
+		]);
+	});
+
+	it("fails closed without version or token", () => {
+		expect(() => runCreateLauncherSmoke({ createVersion: "", authToken: "tok" })).toThrow(
+			"CREATE_VERSION is required",
+		);
+		expect(() =>
+			runCreateLauncherSmoke({ createVersion: "0.0.1-dev.80", authToken: "" }),
+		).toThrow("NODE_AUTH_TOKEN is required");
+	});
+});
+
+describe("publish.yml create smoke + tag", () => {
+	const yml = fs.readFileSync(PUBLISH_YML, "utf8");
+
+	it("wires create smoke through the isolated launcher", () => {
+		expect(yml).toContain("node projects/ci-tools/src/github/smoke-create-launcher.mjs");
+		expect(yml).toContain("CREATE_VERSION:");
+		expect(yml).not.toContain("npx --yes");
+	});
+
+	it("grants the tag job actions:read so publish-prepare can download CI artifacts", () => {
+		const tag = yml.slice(yml.indexOf("\n  tag:"));
+		const perms = tag.slice(tag.indexOf("permissions:"), tag.indexOf("steps:"));
+		expect(perms).toMatch(/contents:\s*write/);
+		expect(perms).toMatch(/actions:\s*read/);
+	});
+});

package/tests/pages/bench-page.test.mjs

@@ -0,0 +1,106 @@
+import { describe, expect, it } from "vitest";
+import { buildBenchmarkHtml, trendSvg } from "../../src/pages/bench-page.mjs";
+
+const context = (benchEnv, cores) => ({
+	benchEnv,
+	os: { platform: "linux", arch: "x64" },
+	cpu: { model: "Test CPU", count: cores },
+	memoryGb: 16,
+	node: "v24.1.0",
+});
+
+const run = (date, sha, results) => ({ date, sha, results });
+const result = (id, median, label = id) => ({
+	id,
+	label,
+	unit: "ms",
+	median,
+	p90: median * 1.2,
+	min: median,
+	max: median,
+	samples: 5,
+});
+
+const history = {
+	version: 2,
+	contexts: {
+		ci: {
+			context: context("gh-actions-node24", 4),
+			runs: [
+				run("2026-10-20T03:17:00Z", "bbbbbbbbbbbb", [
+					result("flux.serve.start", 90, "spawn <to> ready"),
+					result("forge.build.debug", 9),
+				]),
+				run("2026-10-19T03:17:00Z", "aaaaaaaaaaaa", [
+					result("flux.serve.start", 100, "spawn <to> ready"),
+				]),
+			],
+		},
+		laptop: {
+			context: context("(local)", 24),
+			runs: [run("2026-10-01T10:00:00Z", "cccccccccccc", [result("flux.serve.start", 40)])],
+		},
+	},
+};
+
+describe("buildBenchmarkHtml", () => {
+	it("explains an empty history instead of rendering empty charts", () => {
+		const html = buildBenchmarkHtml({ version: 2, contexts: {} });
+		expect(html).toContain("No benchmark history yet");
+		expect(html).not.toContain("<svg");
+	});
+
+	it("draws one card per benchmark, grouped, with a line per machine that ran it", () => {
+		const html = buildBenchmarkHtml(history, { branch: "main", sha: "0123456789abcdef" });
+
+		expect(html.match(/<article class="card">/g)).toHaveLength(2);
+		expect(html.indexOf("flux serve (real process)")).toBeLessThan(
+			html.indexOf("<h2>forge build</h2>"),
+		);
+		const serveCard = html.slice(
+			html.indexOf("<code>flux.serve.start</code>"),
+			html.indexOf("<code>forge.build.debug</code>"),
+		);
+		expect(serveCard.match(/<polyline/g)).toHaveLength(2);
+		expect(html).toContain("built from main @ <code>0123456789ab</code>");
+	});
+
+	it("shows the latest median and the change from the previous run on the newest machine", () => {
+		const html = buildBenchmarkHtml(history);
+		expect(html).toContain("<strong>90.0 ms</strong> median · p90 108 ms");
+		expect(html).toContain('<span class="change better">10.0% faster</span>');
+	});
+
+	it("dates each result and links its commit, in the latest table and on each card", () => {
+		const html = buildBenchmarkHtml(history);
+		expect(html).toContain("<th>Run</th><th>Commit</th>");
+		expect(html).toContain("<td>2026-10-20 03:17 UTC</td>");
+		expect(html).toContain(
+			'<a href="https://github.com/typesmiths/decohere/commit/bbbbbbbbbbbb"><code>bbbbbbb</code></a>',
+		);
+		expect(html).toContain('<p class="when">Last run 2026-10-20 03:17 UTC</p>');
+	});
+
+	it("escapes labels from the history", () => {
+		const html = buildBenchmarkHtml(history);
+		expect(html).toContain("spawn &lt;to&gt; ready");
+		expect(html).not.toContain("spawn <to> ready");
+	});
+});
+
+describe("trendSvg", () => {
+	it("places a single point without dividing by a zero time range", () => {
+		const svg = trendSvg([
+			{
+				color: "red",
+				points: [{ time: 1, date: "2026-10-20", sha: "abc", median: 5, p90: 6 }],
+			},
+		]);
+		expect(svg).toContain("<circle");
+		expect(svg).not.toContain("NaN");
+	});
+
+	it("draws nothing when no machine has a point", () => {
+		expect(trendSvg([])).toBe("");
+	});
+});

package/src/coverage/enforce-thresholds.mjs

@@ -1,144 +0,0 @@
-import { existsSync, readdirSync, readFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { pathToFileURL } from "node:url";
-import { parseLcovByProject } from "../lib/lcov.mjs";
-
-function parseArgs(argv) {
-	const options = {
-		lcov: ".forge/coverage/lcov.info",
-		thresholds: null,
-		thresholdsModule: null,
-		projectsDir: "projects",
-	};
-
-	for (let index = 0; index < argv.length; index += 1) {
-		const arg = argv[index];
-		if (arg === "--lcov") {
-			options.lcov = argv[index + 1] ?? options.lcov;
-			index += 1;
-			continue;
-		}
-		if (arg === "--thresholds") {
-			options.thresholds = argv[index + 1] ?? options.thresholds;
-			index += 1;
-			continue;
-		}
-		if (arg === "--thresholds-module") {
-			options.thresholdsModule = argv[index + 1] ?? options.thresholdsModule;
-			index += 1;
-			continue;
-		}
-		if (arg === "--projectsDir") {
-			options.projectsDir = argv[index + 1] ?? options.projectsDir;
-			index += 1;
-		}
-	}
-
-	return options;
-}
-
-async function resolveThresholds(options) {
-	if (options.thresholdsModule) {
-		const moduleUrl = pathToFileURL(resolve(options.thresholdsModule)).href;
-		const mod = await import(moduleUrl);
-		const thresholds = mod.projectCoverageThresholds;
-		if (typeof thresholds !== "object" || thresholds == null) {
-			console.error(
-				`Module ${options.thresholdsModule} must export a 'projectCoverageThresholds' object.`,
-			);
-			process.exit(1);
-		}
-		return thresholds;
-	}
-
-	const path = options.thresholds ?? "coverage.config.json";
-	if (!existsSync(path)) {
-		console.error(`Thresholds config not found: ${path}`);
-		process.exit(1);
-	}
-	const parsed = JSON.parse(readFileSync(path, "utf8"));
-	if (typeof parsed !== "object" || parsed == null) {
-		console.error(
-			"Thresholds config must be a JSON object mapping project => minimum coverage percentage.",
-		);
-		process.exit(1);
-	}
-	return parsed;
-}
-
-function formatPct(value) {
-	return `${value.toFixed(2)}%`;
-}
-
-async function main() {
-	const options = parseArgs(process.argv.slice(2));
-	const lcovPath = resolve(options.lcov);
-	const projectsDirPath = resolve(options.projectsDir);
-
-	if (!existsSync(lcovPath)) {
-		console.error(`LCOV file not found: ${lcovPath}`);
-		console.error("Run coverage first (example: npm run test:coverage)");
-		process.exit(1);
-	}
-
-	if (!existsSync(projectsDirPath)) {
-		console.error(`Projects directory not found: ${projectsDirPath}`);
-		process.exit(1);
-	}
-
-	const thresholds = await resolveThresholds(options);
-	const projectDirs = readdirSync(projectsDirPath, { withFileTypes: true })
-		.filter((entry) => entry.isDirectory())
-		.map((entry) => entry.name)
-		.sort((left, right) => left.localeCompare(right));
-
-	const coverageByProject = parseLcovByProject(readFileSync(lcovPath, "utf8"));
-
-	const missingThresholds = projectDirs.filter(
-		(projectName) => thresholds[projectName] == null,
-	);
-	if (missingThresholds.length > 0) {
-		console.error("Missing coverage thresholds for projects:");
-		for (const projectName of missingThresholds) console.error(`- ${projectName}`);
-		console.error(
-			"Update projectCoverageThresholds in vitest.config.ts to include all project directories.",
-		);
-		process.exit(1);
-	}
-
-	const failures = [];
-	console.log("Project line coverage thresholds");
-
-	for (const projectName of projectDirs) {
-		const projectCoverage = coverageByProject.get(projectName) ?? {
-			totalLines: 0,
-			coveredLines: 0,
-		};
-		const currentPct =
-			projectCoverage.totalLines === 0
-				? 0
-				: (projectCoverage.coveredLines / projectCoverage.totalLines) * 100;
-		const minimumPct = Number(thresholds[projectName]);
-		const passed = Number.isFinite(minimumPct) && currentPct >= minimumPct;
-
-		console.log(
-			`${passed ? "✅" : "❌"} ${projectName}: ${formatPct(currentPct)} (min ${formatPct(minimumPct)})`,
-		);
-
-		if (!passed) failures.push({ projectName, currentPct, minimumPct });
-	}
-
-	if (failures.length > 0) {
-		console.error("\nCoverage threshold check failed:");
-		for (const failure of failures) {
-			console.error(
-				`- ${failure.projectName}: ${formatPct(failure.currentPct)} is below ${formatPct(failure.minimumPct)}`,
-			);
-		}
-		process.exit(1);
-	}
-
-	console.log("\nAll project coverage thresholds passed.");
-}
-
-main();

package/src/pages/clear-bench-history.mjs

@@ -1,27 +0,0 @@
-#!/usr/bin/env node
-
-// Clear benchmark history for this publish (workflow_dispatch with clear-history=true)
-
-import { writeFileSync } from "node:fs";
-import { mkdir } from "node:fs/promises";
-
-const HISTORY_DIR = "projects/ci-tools/dist/ci/bench";
-const HISTORY_FILE = `${HISTORY_DIR}/bench-history.json`;
-
-try {
-	await mkdir(HISTORY_DIR, { recursive: true });
-	writeFileSync(
-		HISTORY_FILE,
-		JSON.stringify(
-			{
-				runs: {},
-			},
-			null,
-			2,
-		),
-	);
-	console.log("✓ Cleared benchmark history");
-} catch (error) {
-	console.error("Error clearing benchmark history:", error.message);
-	process.exit(1);
-}

package/src/pages/keep-prior-bench-badge.mjs

@@ -1,38 +0,0 @@
-#!/usr/bin/env node
-
-// Keep prior bench badge if no code changes; create fallback if none exists
-
-import { execSync } from "node:child_process";
-import { existsSync, writeFileSync } from "node:fs";
-import { mkdir } from "node:fs/promises";
-
-const BADGES_DIR = "projects/ci-tools/dist/ci/badges";
-const BADGE_FILE = `${BADGES_DIR}/bench.svg`;
-const PAGES_URL = "https://typesmiths.github.io/decohere/badges/bench.svg";
-
-const FALLBACK_BADGE = `<svg xmlns="http://www.w3.org/2000/svg" width="120" height="20" role="img" aria-label="bench: unavailable">
-  <title>bench: unavailable</title>
-  <rect width="120" height="20" fill="#555"/>
-  <rect x="46" width="74" height="20" fill="#9f9f9f"/>
-  <text x="24" y="14" fill="#fff" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11" text-anchor="middle">bench</text>
-  <text x="83" y="14" fill="#fff" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11" text-anchor="middle">unavailable</text>
-</svg>`;
-
-try {
-	if (!existsSync(BADGE_FILE)) {
-		await mkdir(BADGES_DIR, { recursive: true });
-
-		try {
-			execSync(`curl -fsSL "${PAGES_URL}" -o "${BADGE_FILE}"`, {
-				stdio: "pipe",
-			});
-			console.log("✓ Restored prior bench badge from Pages");
-		} catch {
-			console.warn("::warning::No prior bench badge found on Pages; creating fallback badge.");
-			writeFileSync(BADGE_FILE, FALLBACK_BADGE);
-		}
-	}
-} catch (error) {
-	console.error("Error keeping prior bench badge:", error.message);
-	process.exit(1);
-}