@norskvideo/ctl-dev-kit 0.1.3 → 0.1.4

package/build/flake.nix

@@ -3,12 +3,13 @@
 # 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.
 #
-# 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 +78,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/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.4",
   "type": "module",
   "exports": {
     "./package.json": "./package.json"