@norskvideo/ctl-dev-kit 0.1.3 → 0.1.5

package/build/flake.nix

@@ -1,14 +1,16 @@
 # Product build + dev shell — single-sourced in @norskvideo/ctl-dev-kit and
 # copied verbatim into each split product repo (nix needs a flake.nix at the repo
 # root for `nix develop`; it can't pull one from an npm package at CI bootstrap).
-# The copy is drift-gated (Workstream I), same model as the fenced CLAUDE.md core.
+# The copy is to be drift-gated (Workstream I; not yet enforced), same model as
+# the fenced CLAUDE.md core.
 #
-# Two shells:
-#   nix develop        -> build tools only (bun, cargo/rustc, git). This is what
-#                         CI (build-image) uses; it must stay lean and must NOT
-#                         depend on fetching the ctl binary.
-#   nix develop .#dev  -> the above PLUS the pinned `norsk-ctl` daemon on PATH,
-#                         for the local product dev loop (serve + product add).
+# Three shells:
+#   nix develop         -> build tools (bun, cargo/rustc, git) + the pinned
+#   nix develop .#dev      `norsk-ctl` daemon on PATH. The everyday product dev
+#                          shell; the two are equivalent.
+#   nix develop .#build -> build tools only, no ctl. What CI (build-image /
+#                          integration) uses, so image builds never depend on the
+#                          ctl binary channel.
 #
 # `norsk-ctl` is the released daemon binary pulled from the S3 channel and pinned
 # by version+hash (reproducible). It is NOT built from source here — a product
@@ -77,14 +79,19 @@
             pkgs.git
           ];
         in {
-          # CI (build-image) uses this — lean, no ctl fetch.
+          # Everyday dev shell — build tools + the pinned norsk-ctl daemon.
+          # `nix develop` and `nix develop .#dev` are equivalent.
           default = pkgs.mkShell {
-            buildInputs = buildTools;
+            buildInputs = buildTools ++ [ (mkCtl system) ];
           };
-          # Local product dev loop — build tools + the pinned daemon on PATH.
           dev = pkgs.mkShell {
             buildInputs = buildTools ++ [ (mkCtl system) ];
           };
+          # Lean shell for CI (build-image / integration) — no ctl fetch, so
+          # image builds never depend on the ctl binary channel.
+          build = pkgs.mkShell {
+            buildInputs = buildTools;
+          };
         });
     };
 }

package/conventions/CLAUDE.core.md

@@ -2,11 +2,11 @@
 <!--
   This block is the SHARED conventions core, single-sourced in
   @norskvideo/ctl-dev-kit (conventions/CLAUDE.core.md). It is copied verbatim
-  into each product repo's CLAUDE.md between these fenced markers, and a
-  drift-check gate (Workstream I) fails CI if a copy diverges from the dev-kit's
-  version. Do NOT hand-edit a copy — edit the dev-kit source and re-sync. The
-  per-product tail (this product's build, iterate loop, gotchas) lives OUTSIDE
-  the markers and is yours to own.
+  into each product repo's CLAUDE.md between these fenced markers. A drift-check
+  gate is planned (Workstream I) to fail CI if a copy diverges from the dev-kit's
+  version — until it lands, do NOT hand-edit a copy: edit the dev-kit source and
+  re-sync. The per-product tail (this product's build, iterate loop, gotchas)
+  lives OUTSIDE the markers and is yours to own.
 
   It is copied (not `@import`ed) on purpose: CLAUDE.md's value is being read
   verbatim by a human on GitHub with no tooling, and an @import shows a human a

package/local-dev/README.md

@@ -13,8 +13,9 @@ dependency; it is the released binary, pinned by version+hash in the repo's
 it on `PATH`:
 
 ```sh
-nix develop .#dev        # build tools (bun, cargo/rustc, git) + the pinned norsk-ctl
-#   nix develop          # build-only shell — no ctl (this is what CI build-image uses)
+nix develop              # build tools (bun, cargo/rustc, git) + the pinned norsk-ctl
+#   nix develop .#dev    # equivalent alias
+#   nix develop .#build  # lean shell, no ctl — what CI (build-image/integration) uses
 
 norsk-ctl serve          # daemon on :8333, oauth2 proxy on :9443
 norsk-ctl --version      # confirm the pinned build
@@ -102,9 +103,9 @@ Leave the hooks unset to launch the pinned tags the product declares.
 Use this when you are changing the **daemon itself** (packages/norsk-ctl) and
 want the product to launch through your build instead of the pinned binary. The
 daemon is a single process on `:8333` — where you start it from is irrelevant, so
-just run it out of your checkout and drive it with the same checkout's CLI. Skip
-`nix develop .#dev` (its pinned `norsk-ctl` would shadow yours); the plain
-`nix develop` shell is enough on the product side.
+just run it out of your checkout and drive it with the same checkout's CLI. Use
+`nix develop .#build` on the product side so the flake's pinned `norsk-ctl`
+doesn't shadow the one you're running from source.
 
 ```sh
 # 1. daemon, from your ctl checkout (root `cli` script -> packages/norsk-ctl cli)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-dev-kit",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "exports": {
     "./package.json": "./package.json"