@opengsd/gsd-core 1.11.0 → 1.13.0

package/scripts/{test-failure-reasons.cjs → gsd-test-gate-reasons.cjs}

@@ -1,5 +1,11 @@
 'use strict';
 
+// Renamed (was `test-failure-reasons.cjs`): the old basename matched Node's
+// `test-*.EXT` test-collection pattern, so the remote push-gate runner
+// collected and executed this SOURCE file as a test while GitHub CI (which
+// globs only tests/**/*.test.cjs) never saw it — see
+// scripts/lint-source-test-name-collision.cjs.
+
 const TEST_GATE_REASON = Object.freeze({
   PASS: 'pass',
   TEST_FAILURE: 'test_failure',

package/scripts/lib/ci-job-timing.cjs

@@ -0,0 +1,72 @@
+'use strict';
+
+/**
+ * scripts/lib/ci-job-timing.cjs
+ *
+ * Pure budget-percentage arithmetic shared by the in-job near-cap check
+ * (scripts/ci-check-job-near-cap.cjs) and the scheduled trending report
+ * (scripts/ci-timeout-report.cjs). See #4036.
+ */
+
+/** A job at or above this fraction of its `timeout-minutes` cap is "near-cap". */
+const THRESHOLD_PCT = 0.9;
+
+/**
+ * @param {{startedAt: string, completedAt: string, timeoutMinutes: number}} args
+ * @returns {{elapsedMs: number, capMs: number, pct: number}}
+ */
+function computeElapsedPct({ startedAt, completedAt, timeoutMinutes }) {
+  if (!Number.isFinite(timeoutMinutes) || timeoutMinutes <= 0) {
+    throw new Error(`timeoutMinutes must be a positive finite number, got ${timeoutMinutes}`);
+  }
+
+  const startMs = new Date(startedAt).getTime();
+  const endMs = new Date(completedAt).getTime();
+
+  if (!Number.isFinite(startMs)) {
+    throw new Error(`startedAt is not a valid timestamp: ${startedAt}`);
+  }
+  if (!Number.isFinite(endMs)) {
+    throw new Error(`completedAt is not a valid timestamp: ${completedAt}`);
+  }
+
+  const elapsedMs = endMs - startMs;
+  if (elapsedMs < 0) {
+    throw new Error(`completedAt (${completedAt}) is before startedAt (${startedAt})`);
+  }
+
+  const capMs = timeoutMinutes * 60000;
+  return { elapsedMs, capMs, pct: elapsedMs / capMs };
+}
+
+/**
+ * @param {number} pct
+ * @param {number} [threshold]
+ * @returns {boolean}
+ */
+function isNearCap(pct, threshold = THRESHOLD_PCT) {
+  return pct >= threshold;
+}
+
+/**
+ * @param {{label: string, pct: number, elapsedMs: number, capMs: number}} args
+ * @returns {{warningLine: string, summaryMarkdown: string}}
+ */
+function formatNearCapNotice({ label, pct, elapsedMs, capMs }) {
+  const pctStr = `${Math.round(pct * 100)}%`;
+  const elapsedMin = (elapsedMs / 60000).toFixed(1);
+  const capMin = (capMs / 60000).toFixed(1);
+  const detail = `${label} at ${pctStr} of its ${capMin}m cap (${elapsedMin}m elapsed)`;
+
+  return {
+    warningLine: `::warning title=CI budget::${detail}`,
+    summaryMarkdown: `- **${label}** — ${pctStr} of ${capMin}m cap (${elapsedMin}m elapsed)`,
+  };
+}
+
+module.exports = {
+  THRESHOLD_PCT,
+  computeElapsedPct,
+  isNearCap,
+  formatNearCapNotice,
+};