@norskvideo/ctl-dev-kit 0.2.40 → 0.2.42

package/doc-guide/engine-verdict.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env bun
+export interface EngineVerdict {
+    ok: boolean;
+    reason: string;
+}
+export declare function engineVerdict(output: string): EngineVerdict;

package/doc-guide/engine-verdict.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env bun
+/**
+ * Whether a doc-guide engine tier that exited non-zero failed for real, or only
+ * a teardown hook ran out of time after every guide's test had passed. Each
+ * product's scripts/doc-guide/regen-manual.sh asks this, from the tier's own
+ * output, instead of "are the capture files on disk": that rule passed a
+ * composition guide that hung after two captures (2026-10-03) and passed any
+ * guide whose assertions failed after its captures were written. The engine
+ * tier is also half of the publish gate (dev-kit conventions/build-image.yml),
+ * so what it forgives, the gate forgives.
+ *
+ * Forgiven: every result line a test passed, apart from unnamed hook failures
+ * in guides that also passed a test. Anything else -- a named test failing, a
+ * guide whose only result is a failed hook (its setup never finished), or no
+ * results at all -- is a real failure.
+ *
+ * Reads both runners' list output: bun test (`(pass) guide > test [ms]`,
+ * `(fail) guide > (unnamed)` for a hook) and Playwright (`✓ n [project] ›
+ * file:line › guide › test (t)`; an afterAll failing after every test passed
+ * belongs to no test, so it leaves only ✓ lines).
+ *
+ *   bun engine-verdict.ts <captured engine-tier output>
+ *   exit 0 = teardown only (continue), 1 = real failure (abort)
+ *
+ * Imports only node: it runs inside product repos (see publish/product-channel.ts).
+ */
+import { readFileSync } from "node:fs";
+/** Colour escapes (ESC [ ... m), built from a string: lint refuses a control
+ *  character in a regex literal. */
+const ANSI = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
+const BUN = /\((pass|fail)\) (.+?) > (.+?) \[[\d.]+m?s\]\s*$/;
+const PLAYWRIGHT = /([✓✘])\s+\d+ \[[^\]]*\] › [^›]+ › (.+?) › (.+?) \([\d.]+m?s\)\s*$/;
+function results(output) {
+    const out = [];
+    for (const raw of output.split("\n")) {
+        const line = raw.replace(ANSI, "");
+        const b = line.match(BUN);
+        if (b) {
+            out.push({ guide: b[2], test: b[3], passed: b[1] === "pass" });
+            continue;
+        }
+        const p = line.match(PLAYWRIGHT);
+        if (p)
+            out.push({ guide: p[2], test: p[3], passed: p[1] === "✓" });
+    }
+    return out;
+}
+export function engineVerdict(output) {
+    const all = results(output);
+    if (all.length === 0)
+        return { ok: false, reason: "no test results in the engine tier's output" };
+    const failedTests = all.filter((r) => !r.passed && r.test !== "(unnamed)");
+    const passedGuides = new Set(all.filter((r) => r.passed).map((r) => r.guide));
+    const hookOnlyGuides = [
+        ...new Set(all.filter((r) => !r.passed && r.test === "(unnamed)" && !passedGuides.has(r.guide)).map((r) => r.guide)),
+    ];
+    const problems = [
+        ...failedTests.map((r) => `failed: ${r.guide} > ${r.test}`),
+        ...hookOnlyGuides.map((g) => `never ran (only a hook result): ${g}`),
+    ];
+    return problems.length ? { ok: false, reason: problems.join("; ") } : { ok: true, reason: "teardown only" };
+}
+if (import.meta.main) {
+    const path = process.argv[2];
+    if (!path) {
+        console.error("usage: engine-verdict.ts <captured engine-tier output>");
+        process.exit(2);
+    }
+    const verdict = engineVerdict(readFileSync(path, "utf8"));
+    console.log(verdict.ok ? `engine tier: ${verdict.reason}` : `engine tier failed: ${verdict.reason}`);
+    process.exit(verdict.ok ? 0 : 1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-dev-kit",
-  "version": "0.2.40",
+  "version": "0.2.42",
   "type": "module",
   "exports": {
     "./create-product": "./create-product/create-product.ts",
@@ -8,6 +8,7 @@
     "./doc-guide/build-manual": "./doc-guide/build-manual.js",
     "./doc-guide/bundle": "./doc-guide/bundle.js",
     "./doc-guide/docs-release": "./doc-guide/docs-release.js",
+    "./doc-guide/engine-verdict": "./doc-guide/engine-verdict.js",
     "./doc-guide/guides-config": "./doc-guide/guides-config.js",
     "./doc-guide/instance-proxy": "./doc-guide/instance-proxy.js",
     "./doc-guide/live-browser": "./doc-guide/live-browser.js",
@@ -36,10 +37,10 @@
   },
   "devDependencies": {
     "@norskvideo/ctl-oas-to-ts": "^0.1.0",
-    "@norskvideo/norsk-sdk": "1.3.1-2026-10-04-dc313351",
-    "@norskvideo/norsk-studio": "1.30.0-2026-10-04-e672beb6",
-    "@norskvideo/norsk-studio-builder": "1.30.0-2026-10-04-e672beb6",
-    "@norskvideo/norsk-studio-built-ins": "1.30.0-2026-10-04-e672beb6",
+    "@norskvideo/norsk-sdk": "1.3.1-2026-10-04-f034e83d",
+    "@norskvideo/norsk-studio": "1.30.0-2026-10-05-3d2846dc",
+    "@norskvideo/norsk-studio-builder": "1.30.0-2026-10-05-3d2846dc",
+    "@norskvideo/norsk-studio-built-ins": "1.30.0-2026-10-05-3d2846dc",
     "@playwright/test": "^1.59.0",
     "@types/bun": "latest",
     "@types/cors": "^2.8.17",