@norskvideo/ctl-test-harness 0.1.25 → 0.1.27

package/cli-command.d.ts

@@ -1 +1,11 @@
+export interface CliCommandDeps {
+    env: Record<string, string | undefined>;
+    cwd: string;
+    /** This module's directory: packages/test-harness/{src,dist}. */
+    here: string;
+    exists: (path: string) => boolean;
+    /** Is `norsk-ctl` executable on PATH? */
+    onPath: () => boolean;
+}
+export declare function resolveCliCommand(d: CliCommandDeps): string[];
 export declare const cliCommand: string[];

package/cli-command.js

@@ -2,15 +2,19 @@
 //
 //   1. NORSK_CTL_BINARY=/path/to/norsk-ctl-<os>-<cpu>  — an explicit compiled
 //      binary, or "auto" to pick the platform binary under <cwd>/dist.
-//   2. The in-workspace CLI source, if this harness sits beside a norsk-ctl
-//      package (monorepo dev + in-repo product tests) — run via `bun run`.
-//   3. `norsk-ctl` on PATH — the fallback for a consumer of the published
-//      harness that has the CLI installed (the split-repo case).
+//   2. Inside the norsk-ctl monorepo (the cwd is under the checkout this
+//      harness sits in): the in-workspace CLI source, run via `bun run` — the
+//      monorepo's own tests test the source.
+//   3. `norsk-ctl` on PATH — a consumer of the published harness (the
+//      split-repo case), or a product that LINKS the harness from a monorepo
+//      checkout: its dev shell's pinned CLI is the one under test, and running
+//      the linked source instead costs ~30s per daemon start on a Mac.
+//   4. The in-workspace source anyway, when nothing is on PATH.
 //
 // Spread into spawn args: [...cliCommand, "serve"].
 import { existsSync } from "node:fs";
 import { arch, platform } from "node:os";
-import { dirname, resolve } from "node:path";
+import { delimiter, dirname, join, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 const here = dirname(fileURLToPath(import.meta.url));
 function platformBinaryName() {
@@ -18,28 +22,52 @@ function platformBinaryName() {
     const cpu = arch() === "arm64" ? "arm64" : "x64";
     return `norsk-ctl-${os}-${cpu}`;
 }
-function resolveBinary() {
-    const env = process.env.NORSK_CTL_BINARY;
+function resolveBinary(d) {
+    const env = d.env.NORSK_CTL_BINARY;
     if (!env)
         return null;
-    const candidate = env === "auto" ? resolve(process.cwd(), "dist", platformBinaryName()) : resolve(env);
-    if (!existsSync(candidate)) {
+    const candidate = env === "auto" ? resolve(d.cwd, "dist", platformBinaryName()) : resolve(env);
+    if (!d.exists(candidate)) {
         throw new Error(`NORSK_CTL_BINARY not found: ${candidate}`);
     }
     return candidate;
 }
-function resolveWorkspaceSource() {
-    // packages/test-harness/{src,dist} -> packages/norsk-ctl/cli/src/index.ts.
-    const source = resolve(here, "../../norsk-ctl/cli/src/index.ts");
-    return existsSync(source) ? source : null;
+/** packages/test-harness/{src,dist} -> packages/norsk-ctl/cli/src/index.ts. */
+function workspaceSource(d) {
+    const source = resolve(d.here, "../../norsk-ctl/cli/src/index.ts");
+    return d.exists(source) ? source : null;
 }
-function resolveCliCommand() {
-    const binary = resolveBinary();
+/** packages/test-harness/{src,dist} -> the monorepo root. */
+function insideMonorepo(d) {
+    const root = resolve(d.here, "../../..");
+    const cwd = resolve(d.cwd);
+    return cwd === root || cwd.startsWith(root + sep);
+}
+export function resolveCliCommand(d) {
+    const binary = resolveBinary(d);
     if (binary)
         return [binary];
-    const source = resolveWorkspaceSource();
+    const source = workspaceSource(d);
+    if (source && insideMonorepo(d))
+        return ["bun", "run", source];
+    if (d.onPath())
+        return ["norsk-ctl"];
     if (source)
         return ["bun", "run", source];
     return ["norsk-ctl"];
 }
-export const cliCommand = resolveCliCommand();
+/** A PATH scan rather than Bun.which: the probe doc-guide tier imports this
+ *  module under Node (Playwright). */
+function norskCtlOnPath() {
+    return (process.env.PATH ?? "")
+        .split(delimiter)
+        .filter(Boolean)
+        .some((dir) => existsSync(join(dir, "norsk-ctl")));
+}
+export const cliCommand = resolveCliCommand({
+    env: process.env,
+    cwd: process.cwd(),
+    here,
+    exists: existsSync,
+    onPath: norskCtlOnPath,
+});

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "@norskvideo/ctl-test-harness",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "type": "module",
   "exports": {
     ".": {
       "types": "./index.d.ts",
       "default": "./index.js"
     },
+    "./cli-command": {
+      "types": "./cli-command.d.ts",
+      "default": "./cli-command.js"
+    },
     "./daemon": {
       "types": "./daemon.d.ts",
       "default": "./daemon.js"