@norskvideo/ctl-dev-kit 0.2.1 → 0.2.2

package/conventions/CLAUDE.core.md

@@ -59,7 +59,11 @@
   `deployment/iterate.sh` (`bun run iterate`); model new ones on it. Two gotchas it
   encodes: (1) the **built image name must satisfy the license's imageRef** — the
   licensed repo (e.g. `norskvideo/norsk-<x>-product`), not a throwaway `:dev` name;
-  `product add` 400s on a mismatch, so build UNDER that repo. (2) the **license must
+  `product add` 400s on a mismatch, so build UNDER that repo. `licenseTemplate.json`
+  records that entry (this product at the image this repo builds) and is what a
+  license gets minted from; CI's licence-template step fails if it is missing or
+  names another image, so change its `imageRef` whenever `PUBLISH_IMAGE` or the
+  build script's `IMAGE_TAG` default changes. (2) the **license must
   entitle both `norsk-studio` and the product** (the runtime does the
   studio<->media handshake as `norsk-studio`). Needs a running daemon
   (`norsk-ctl serve`) + `norsk-ctl` on PATH (the nix shell) + `NORSK_LICENSE_FILE`.

package/create-product/create-product.ts

@@ -215,6 +215,7 @@ function conventionFiles(ctx: ShapeContext, shape: ShapeModule): GeneratedFile[]
     { path: ".github/workflows/build-image.yml", content: fillProduct(canon.buildImage) },
     { path: ".github/actions/ci-status-dispatch/action.yml", content: loadAsset("ci-status-dispatch.yml") },
     { path: "manifest.seed.json", content: seedJson(ctx) },
+    { path: "licenseTemplate.json", content: licenseTemplateJson(ctx) },
     { path: "deployment/build-image.sh", content: buildImageWrapper(ctx), executable: true },
   ];
 }
@@ -233,6 +234,17 @@ function seedJson(ctx: ShapeContext): string {
   )}\n`;
 }
 
+// The licence this product needs, as CI's licence-template step checks it: this
+// product at the image the repo builds. Until PUBLISH_IMAGE is set that is the
+// build script's IMAGE_TAG default, `<name>:dev`, whose repo part is the name.
+function licenseTemplateJson(ctx: ShapeContext): string {
+  return `${JSON.stringify(
+    { products: [{ product: ctx.name, imageRef: ctx.name, versionConstraint: "*", mode: "designer" }] },
+    null,
+    2,
+  )}\n`;
+}
+
 function buildImageWrapper(ctx: ShapeContext): string {
   // The gate requires the find_dev_kit function verbatim and a `source` of a
   // dev-kit build/ script; the surrounding wrapper (tag, port) is per-product.

package/licence/check-template.ts

@@ -102,11 +102,10 @@ if (import.meta.main) {
   try {
     contents = readFileSync(file, "utf8");
   } catch {
-    // Absence is not yet an error: the turnkeys' templates wait on their
-    // customer-facing image names being settled. Flipping this to a failure is
-    // a one-line change once every repo carries one.
-    console.log(`licence-template: no ${file} — not yet required in this repo`);
-    process.exit(0);
+    // Every fleet repo carries one and create-product emits one, so absence is
+    // a repo that has stopped saying which licence it needs.
+    console.error(`licence-template: no ${file} — declare the product and image this repo's licence must entitle`);
+    process.exit(1);
   }
   const problems = templateProblems(contents, { product, image });
   if (problems.length) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-dev-kit",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "type": "module",
   "exports": {
     "./create-product": "./create-product/create-product.ts",