[spec-gen-sdk-runner] Align dependencies, add workflow to run unit tests

.github/workflows/spec-gen-sdk-runner-test.yaml

@@ -0,0 +1,32 @@
+name: spec-gen-sdk-runner - Test
+
+on:
+  push:
+    branches:
+      - main
+      - typespec-next
+  pull_request:
+    paths:
+      - package-lock.json
+      - package.json
+      - tsconfig.json
+      - .github/workflows/_reusable-eng-tools-test.yaml
+      - .github/workflows/spec-gen-sdk-runner-test.yaml
+      - eng/tools/package.json
+      - eng/tools/tsconfig.json
+      - eng/tools/spec-gen-sdk-runner/**
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  specGenSdkRunner:
+    name: spec-gen-sdk-runner
+    uses: ./.github/workflows/_reusable-eng-tools-test.yaml
+    with:
+      package: spec-gen-sdk-runner
+      lint: true
+      sparse-checkout-paths: |
+        specification/common-types
+        specification/contosowidgetmanager

eng/tools/spec-gen-sdk-runner/package.json

@@ -1,4 +1,4 @@
 {
   "name": "@azure-tools/spec-gen-sdk-runner",
   "private": true,
   "type": "module",
@@ -15,12 +15,12 @@
     "test:ci": "vitest run --coverage --reporter=verbose"
   },
   "engines": {
-    "node": ">= 18.0.0"
+    "node": ">=20.0.0"
   },
   "devDependencies": {
     "@types/node": "^18.19.31",
-    "@vitest/coverage-c8": "^0.33.0",
+    "@vitest/coverage-v8": "^3.0.5",
     "typescript": "~5.6.2",
-    "vitest": "^3.0.7"
+    "vitest": "^3.0.5"
   }
 }

eng/tools/spec-gen-sdk-runner/src/utils.ts

@@ -1,4 +1,4 @@
 import { spawn, spawnSync, exec } from "node:child_process";
 import path from "node:path";
 import fs from "node:fs";
 import { LogLevel, logMessage } from "./log.js";
@@ -60,7 +60,7 @@
  * Get the relative path from the specification folder
  */
 export function getRelativePathFromSpecification(absolutePath: string): string {
-  const specificationIndex = absolutePath.indexOf("specification/");
+  const specificationIndex = absolutePath.indexOf(path.normalize("specification/"));
   if (specificationIndex !== -1) {
     return absolutePath.slice(Math.max(0, specificationIndex));
   }

eng/tools/spec-gen-sdk-runner/test/utils/createCombinedSpecs.test.ts

@@ -1,5 +1,6 @@
 import { describe, test, expect } from "vitest";
 import { createCombinedSpecs, type SpecResults } from "../../src/utils.js";
+import path from "node:path";
 
 describe("createCombinedSpecs", () => {
   test("combines specs from readme and typespec paths", () => {
@@ -26,9 +27,9 @@
     expect(result[0].specs).toContain("api.json");
     expect(result[0].specs).toContain("main.tsp");
     expect(result[0].specs).toContain("client.tsp");
-    expect(result[0].readmeMd).toBe("specification/apicenter/data-plane/readme.md");
+    expect(result[0].readmeMd).toBe(path.normalize("specification/apicenter/data-plane/readme.md"));
     expect(result[0].typespecProject).toBe(
-      "specification/apicenter/ApiCenter.DataApi/tspconfig.yaml",
+      path.normalize("specification/apicenter/ApiCenter.DataApi/tspconfig.yaml"),
     );
   });
 

eng/tools/spec-gen-sdk-runner/test/utils/searchRelatedTypeSpecProjectBySharedLibrary.test.ts

@@ -1,4 +1,4 @@
 import { describe, test, expect } from "vitest";
 import { searchRelatedTypeSpecProjectBySharedLibrary } from "../../src/utils.js";
 import { fileURLToPath } from "node:url";
 import path from "node:path";
@@ -10,17 +10,17 @@
 
   test("finds related TypeSpec projects for shared libraries", () => {
     const sharedLibraries = [
-      "specification/contosowidgetmanager/Contoso.WidgetManager.Shared/main.tsp",
+      path.normalize("specification/contosowidgetmanager/Contoso.WidgetManager.Shared/main.tsp"),
     ];
 
     const result = searchRelatedTypeSpecProjectBySharedLibrary(sharedLibraries, {
       searchFileRegex: /^tspconfig\.yaml$/,
       specRepoFolder: repoRoot,
     });
-
+    const expectedPath = path.normalize("specification/contosowidgetmanager/Contoso.WidgetManager");
     expect(Object.keys(result)).toHaveLength(1);
-    expect(result["specification/contosowidgetmanager/Contoso.WidgetManager"]).toBeDefined();
-    expect(result["specification/contosowidgetmanager/Contoso.WidgetManager"]).toContain(
+    expect(result[expectedPath]).toBeDefined();
+    expect(result[expectedPath]).toContain(
       sharedLibraries[0],
     );
   });
@@ -35,7 +35,7 @@
   });
 
   test("handles non-existent directories", () => {
-    const sharedLibraries = ["specification/nonexistent/Shared/main.tsp"];
+    const sharedLibraries = [path.normalize("specification/nonexistent/Shared/main.tsp")];
 
     const result = searchRelatedTypeSpecProjectBySharedLibrary(sharedLibraries, {
       searchFileRegex: /^tspconfig\.yaml$/,

eng/tools/spec-gen-sdk-runner/test/utils/utils.test.ts

@@ -1,4 +1,4 @@
 import { describe, test, expect } from "vitest";
 import {
   findFilesRecursive,
   findReadmeFiles,
@@ -14,16 +14,14 @@
 describe("Utils", () => {
   describe("findFilesRecursive", () => {
     test("finds all tspconfig.yaml files recursively", () => {
-      const results = findFilesRecursive(
-        `${repoRoot}/specification/contosowidgetmanager`,
-        "tspconfig.yaml",
-      );
+      const searchPath = path.normalize(`${repoRoot}/specification/contosowidgetmanager`);
+      const results = findFilesRecursive(searchPath, "tspconfig.yaml");
       expect(results).toHaveLength(2);
       expect(results).toContain(
-        "specification/contosowidgetmanager/Contoso.Management/tspconfig.yaml",
+        path.normalize("specification/contosowidgetmanager/Contoso.Management/tspconfig.yaml"),
       );
       expect(results).toContain(
-        "specification/contosowidgetmanager/Contoso.WidgetManager/tspconfig.yaml",
+        path.normalize("specification/contosowidgetmanager/Contoso.WidgetManager/tspconfig.yaml"),
       );
     });
 
@@ -46,10 +44,15 @@
 
   describe("findReadmeFiles", () => {
     test("finds all readme.md files in directory", () => {
-      const results = findReadmeFiles(`${repoRoot}/specification/contosowidgetmanager`);
+      const searchPath = path.normalize(`${repoRoot}/specification/contosowidgetmanager`);
+      const results = findReadmeFiles(searchPath);
       expect(results).toHaveLength(2);
-      expect(results).toContain("specification/contosowidgetmanager/resource-manager/readme.md");
-      expect(results).toContain("specification/contosowidgetmanager/data-plane/readme.md");
+      expect(results).toContain(
+        path.normalize("specification/contosowidgetmanager/resource-manager/readme.md"),
+      );
+      expect(results).toContain(
+        path.normalize("specification/contosowidgetmanager/data-plane/readme.md"),
+      );
     });
 
     test("returns empty array for directory without readme files", () => {
@@ -63,9 +66,9 @@
   describe("getRelativePathFromSpecification", () => {
     test("extracts path from specification folder", () => {
       const result = getRelativePathFromSpecification(
-        "/repo/root/specification/apicenter/resource-manager/readme.md",
+        path.normalize("/repo/root/specification/apicenter/resource-manager/readme.md"),
       );
-      expect(result).toBe("specification/apicenter/resource-manager/readme.md");
+      expect(result).toBe(path.normalize("specification/apicenter/resource-manager/readme.md"));
     });
 
     test("returns original path if specification is not found", () => {
@@ -76,9 +79,9 @@
 
     test("handles paths with multiple specification occurrences", () => {
       const result = getRelativePathFromSpecification(
-        "/repo/root/specification/old/specification/apicenter/readme.md",
+        path.normalize("/repo/root/specification/old/specification/apicenter/readme.md"),
       );
-      expect(result).toBe("specification/old/specification/apicenter/readme.md");
+      expect(result).toBe(path.normalize("specification/old/specification/apicenter/readme.md"));
     });
 
     test("handles empty path", () => {