@decohere/ci-tools 0.0.1-dev.3 → 0.0.1-dev.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decohere/ci-tools",
-  "version": "0.0.1-dev.3",
+  "version": "0.0.1-dev.30",
   "description": "CI utility scripts for badge generation, coverage reporting, pages artifact assembly, and GitHub API tooling",
   "keywords": [
     "typescript",

package/src/bench/bench.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * bench.mjs — run the forgev2 benchmark and compare against the last saved baseline.
+ * bench.mjs — run the forge benchmark and compare against the last saved baseline.
  *
  * Usage:
  *   node bench.mjs              — run and compare, do not save
@@ -34,9 +34,9 @@ const HISTORY_FILE = join(
 	"projects/ci-tools/dist/ci/bench/bench-history.json",
 );
 const VITEST_BIN = join(WORKSPACE_ROOT, "node_modules/.bin/vitest");
-const BENCH_FILE = "projects/forge/e2e/build.benchmark.bench.ts";
+const BENCH_FILE = "projects/terminal/e2e/build.benchmark.bench.ts";
 const CONFIG = join(WORKSPACE_ROOT, "vitest.e2e.config.ts");
-const TRACE_LOG_DIR = join(WORKSPACE_ROOT, ".forge", "logs");
+const TRACE_LOG_DIR = join(WORKSPACE_ROOT, ".decohere", "logs");
 const MAX_RUNS = 10;
 const command = process.argv[2] ?? "run";
 

package/src/bench/trace.mjs

@@ -7,8 +7,8 @@ import { join } from "node:path";
 const WORKSPACE_ROOT = process.cwd();
 const VITEST_BIN = join(WORKSPACE_ROOT, "node_modules/.bin/vitest");
 const CONFIG = join(WORKSPACE_ROOT, "vitest.e2e.config.ts");
-const TRACE_SPEC = "projects/forge/e2e/build.trace.e2e.spec.ts";
-const TRACE_LOG_DIR = join(WORKSPACE_ROOT, ".forge", "logs");
+const TRACE_SPEC = "projects/terminal/e2e/build.trace.e2e.spec.ts";
+const TRACE_LOG_DIR = join(WORKSPACE_ROOT, ".decohere", "logs");
 
 function truthy(value, defaultValue = false) {
 	if (value == null) return defaultValue;

package/src/coverage/badge.mjs

@@ -10,8 +10,8 @@ import path from "node:path";
 import { parseLcovByProject } from "../lib/lcov.mjs";
 import { createBadgeSvg, getColor } from "../lib/svg.mjs";
 
-const summaryPath = path.resolve(".forge/coverage/coverage-summary.json");
-const lcovPath = path.resolve(".forge/coverage/lcov.info");
+const summaryPath = path.resolve("dist/coverage/coverage-summary.json");
+const lcovPath = path.resolve("dist/coverage/lcov.info");
 const badgesDirectory = path.resolve("projects/ci-tools/dist/ci/badges");
 const globalBadgePath = path.join(badgesDirectory, "coverage.svg");
 const projectBadgesDirectory = path.join(badgesDirectory, "projects");

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

@@ -0,0 +1,27 @@
+#!/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

@@ -0,0 +1,38 @@
+#!/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);
+}

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

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+
+// Restore benchmark history from Pages, or initialize empty if not found
+
+import { execSync } from "node:child_process";
+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`;
+const PAGES_URL = "https://typesmiths.github.io/decohere/data/bench-history.json";
+
+try {
+	await mkdir(HISTORY_DIR, { recursive: true });
+
+	try {
+		execSync(`curl -fsSL "${PAGES_URL}" -o "${HISTORY_FILE}"`, {
+			stdio: "pipe",
+		});
+		console.log("✓ Restored benchmark history from Pages");
+	} catch {
+		console.log("No benchmark history on Pages; starting from empty history");
+		writeFileSync(
+			HISTORY_FILE,
+			JSON.stringify(
+				{
+					runs: {},
+				},
+				null,
+				2,
+			),
+		);
+	}
+} catch (error) {
+	console.error("Error restoring benchmark history:", error.message);
+	process.exit(1);
+}

package/src/release/capture-version.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * Capture final version metadata from package.json
+ * Outputs version and is_prerelease flags for GitHub Actions
+ */
+
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+
+try {
+	const packageJson = JSON.parse(readFileSync(join(process.cwd(), "package.json"), "utf8"));
+	const version = packageJson.version;
+
+	if (!version) {
+		console.error("No version found in package.json");
+		process.exit(1);
+	}
+
+	console.log(`version=${version}`);
+
+	// Check if prerelease (has hyphen in version)
+	const isPrerelease = version.includes("-");
+	console.log(`is_prerelease=${isPrerelease}`);
+} catch (e) {
+	console.error(`Failed to capture version: ${e.message}`);
+	process.exit(1);
+}

package/src/release/npm-links.mjs

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/**
+ * Generate npm package links for all @decohere packages
+ * Outputs markdown formatted links for GitHub release notes
+ */
+
+import { readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+
+const VERSION = process.argv[2] || process.env.VERSION;
+
+if (!VERSION) {
+	console.error("VERSION not provided as argument or env var");
+	process.exit(1);
+}
+
+let links = "## Published Packages\n\n";
+const projectsDir = join(process.cwd(), "projects");
+
+try {
+	const projects = readdirSync(projectsDir);
+
+	for (const project of projects) {
+		const pkgPath = join(projectsDir, project, "package.json");
+		try {
+			const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+			if (pkg.name?.startsWith("@decohere/")) {
+				links += `- [\`${pkg.name}@${VERSION}\`](https://www.npmjs.com/package/${pkg.name}/v/${VERSION})\n`;
+			}
+		} catch {
+			// Skip projects without package.json
+		}
+	}
+
+	console.log(links);
+} catch (e) {
+	console.error(`Failed to generate npm links: ${e.message}`);
+	process.exit(1);
+}

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

@@ -5,15 +5,15 @@ import {
 	parseLcovFiles,
 } from "../../src/lib/lcov.mjs";
 
-const sampleLcov = `SF:projects/forge/forge/src/index.ts
+const sampleLcov = `SF:projects/forge/src/index.ts
 LF:10
 LH:9
 end_of_record
-SF:projects/forge/forge/src/build/index.ts
+SF:projects/forge/src/build/index.ts
 LF:20
 LH:15
 end_of_record
-SF:projects/hearth/src/index.ts
+SF:projects/nexus/src/index.ts
 LF:5
 LH:5
 end_of_record
@@ -32,7 +32,7 @@ end_of_record
 
 describe("getProjectFromPath", () => {
 	it("extracts project name from projects/ path", () => {
-		expect(getProjectFromPath("projects/forge/forge/src/index.ts")).toBe("forge");
+		expect(getProjectFromPath("projects/forge/src/index.ts")).toBe("forge");
 	});
 
 	it("returns undefined for unrecognized paths", () => {
@@ -46,13 +46,13 @@ describe("parseLcovByProject", () => {
 		expect(result.get("forge")).toBeDefined();
 		expect(result.get("forge").totalLines).toBe(30);
 		expect(result.get("forge").coveredLines).toBe(24);
-		expect(result.get("hearth")).toBeDefined();
-		expect(result.get("hearth").totalLines).toBe(5);
-		expect(result.get("hearth").coveredLines).toBe(5);
+		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/forge/src/empty.ts\nLF:0\nLH:0\nend_of_record\n`;
+		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);
 	});