unitbob 0.2.3 → 0.2.4

package/dist/files/behavioral.js

@@ -1,4 +1,4 @@
-import { mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { mkdirSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { assertUnitbobPath } from "./artifactPath.js";
 // The behavioral suite lives under its own root: the main `.feature` plus its
@@ -9,14 +9,21 @@ import { assertUnitbobPath } from "./artifactPath.js";
 // blob only so `check` can execute it locally.
 export const BEHAVIORAL_DIR = '.unitbob/behavioral';
 // Write a behavioral artifact envelope (main file + support files) under the
-// behavioral root, after checking every path is safe. The root is wiped first
-// so a stale file from a previous version never lingers. Returns the absolute
-// path of the materialized main file.
-export function materializeBehavioral(projectRoot, artifact) {
+// behavioral root, after checking every path is safe. Stale suite artifacts are
+// removed while the separately provisioned runner environment is preserved.
+// Returns the absolute path of the materialized main file.
+export function materializeBehavioral(projectRoot, artifact, runner) {
     const files = [artifact, ...(artifact.support_files ?? [])];
     for (const file of files)
         assertUnitbobPath(file.path, BEHAVIORAL_DIR);
-    rmSync(join(projectRoot, BEHAVIORAL_DIR), { recursive: true, force: true });
+    const behavioralRoot = join(projectRoot, BEHAVIORAL_DIR);
+    const runnerEntries = RUNNER_ENVIRONMENT_ENTRIES[runner] ?? EMPTY_ENTRIES;
+    mkdirSync(behavioralRoot, { recursive: true });
+    for (const entry of readdirSync(behavioralRoot)) {
+        if (!runnerEntries.has(entry)) {
+            rmSync(join(behavioralRoot, entry), { recursive: true, force: true });
+        }
+    }
     let mainPath = '';
     for (const file of files) {
         const dest = join(projectRoot, file.path);
@@ -27,3 +34,9 @@ export function materializeBehavioral(projectRoot, artifact) {
     }
     return { mainPath };
 }
+const EMPTY_ENTRIES = new Set();
+const RUNNER_ENVIRONMENT_ENTRIES = {
+    cucumber: new Set(['.bundle', 'Gemfile', 'Gemfile.lock']),
+    'cucumber-js': new Set(['node_modules', 'package.json', 'package-lock.json', 'pnpm-lock.yaml', 'yarn.lock']),
+    'pytest-bdd': new Set(['.venv']),
+};

package/dist/runner/bdd.js

@@ -34,20 +34,18 @@ export function runBddSuite(projectRoot, runner, mainPath) {
 async function runCucumberRuby(projectRoot) {
     const features = join(BEHAVIORAL_ROOT, 'features');
     const steps = join(BEHAVIORAL_ROOT, 'step_definitions');
-    const localBin = join(projectRoot, 'bin', 'cucumber');
     const sidecarGemfile = join(projectRoot, BEHAVIORAL_ROOT, 'Gemfile');
-    const hasSidecarGemfile = existsSync(sidecarGemfile);
-    const command = executable(localBin) ? localBin : 'bundle';
-    const base = executable(localBin) ? [] : ['exec', 'cucumber'];
-    const args = [...base, features, '--require', steps, '--format', 'message', '--out', CUCUMBER_REPORT];
+    if (!existsSync(sidecarGemfile)) {
+        throw missingRunner('Cucumber');
+    }
+    const command = 'bundle';
+    const args = ['exec', 'cucumber', features, '--require', steps, '--format', 'message', '--out', CUCUMBER_REPORT];
     const env = {
         ...process.env,
         RAILS_ENV: 'test',
         UNITBOB_REPO_ROOT: projectRoot,
     };
-    if (hasSidecarGemfile) {
-        env.BUNDLE_GEMFILE = join(BEHAVIORAL_ROOT, 'Gemfile');
-    }
+    env.BUNDLE_GEMFILE = join(BEHAVIORAL_ROOT, 'Gemfile');
     const result = await runProcess(command, args, {
         cwd: projectRoot,
         timeoutMs: BDD_TIMEOUT_MS,
@@ -55,16 +53,20 @@ async function runCucumberRuby(projectRoot) {
     });
     return finalize(result, command, args, projectRoot, CUCUMBER_REPORT);
 }
+function missingRunner(name) {
+    return new Error(`Behavioral runner missing (${name}). Run suite-prepare to provision it under ${BEHAVIORAL_ROOT}/, then run the checks again.`);
+}
 // JS/TS: `@cucumber/cucumber` (cucumber-js) with the message formatter written
 // to a file.
 async function runCucumberJs(projectRoot) {
     const features = join(BEHAVIORAL_ROOT, 'features');
     const steps = join(BEHAVIORAL_ROOT, 'step_definitions', '**', '*');
     const sidecarBin = join(projectRoot, BEHAVIORAL_ROOT, 'node_modules', '.bin', 'cucumber-js');
-    const command = executable(sidecarBin) ? sidecarBin : 'npx';
-    const baseArgs = executable(sidecarBin) ? [] : ['cucumber-js'];
+    if (!executable(sidecarBin)) {
+        throw missingRunner('Cucumber JS');
+    }
+    const command = sidecarBin;
     const args = [
-        ...baseArgs,
         features,
         '--require',
         steps,
@@ -122,11 +124,7 @@ async function pickPython(projectRoot) {
     if (executable(sidecarVenvPytest)) {
         return sidecarVenvPytest;
     }
-    const probe = await runProcess('python3', ['-m', 'pytest', '--version'], {
-        cwd: projectRoot,
-        timeoutMs: 10_000,
-    }).catch(() => ({ stdout: '', stderr: '', code: 1 }));
-    return probe.code === 0 ? 'python3' : 'python';
+    throw missingRunner('pytest-bdd');
 }
 function executable(path) {
     try {

package/dist/verbs/run.js

@@ -18,7 +18,7 @@ export async function run(config, _args, deps) {
             suite_file: { path: item.suite_file.path, content: item.suite_file.content },
             runner_manifest: item.runner_manifest,
         }),
-        materializeBehavioral: (projectRoot, item) => materializeBehavioral(projectRoot, item.suite_file).mainPath,
+        materializeBehavioral: (projectRoot, item) => materializeBehavioral(projectRoot, item.suite_file, item.runner_manifest.runner).mainPath,
         runStructural: runStructuralByRunner,
         runBehavioral: runBddSuite,
         validateStack,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unitbob",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Unitbob connector — thin local hands for the Unitbob Rails brain. Owns no domain logic: it runs tools, relays bytes over the wire, and prints what the server returns.",
   "type": "module",
   "bin": {