test: cover sparsekernel referenced schemas

Author: AbrahamGreenman

scripts/check-sparsekernel-openapi.mjs

@@ -240,13 +240,10 @@ export function checkSparseKernelOpenApi({ openapiText, daemonSource, clientSour
   }
 
   const mappedSchemaNames = new Set(CLIENT_SCHEMA_MAPPINGS.map((item) => item.schemaName));
-  const referencedSchemaNames = [...collectSchemaRefs(openapi)]
-    .filter((ref) => ref.startsWith("#/components/schemas/"))
-    .map((ref) => ref.slice("#/components/schemas/".length));
   pushSetDiff(
     errors,
     "SparseKernel OpenAPI referenced schemas missing client parity mapping",
-    new Set(referencedSchemaNames),
+    collectOpenApiReferencedSchemaNames(openapi),
     mappedSchemaNames,
   );
 
@@ -311,6 +308,14 @@ export function collectOpenApiRequestBodySchemaNames(paths) {
   return schemaNames;
 }
 
+export function collectOpenApiReferencedSchemaNames(openapi) {
+  return new Set(
+    [...collectSchemaRefs(openapi)]
+      .filter((ref) => ref.startsWith("#/components/schemas/"))
+      .map((ref) => ref.slice("#/components/schemas/".length)),
+  );
+}
+
 export function collectOpenApiInlineRequestBodyRoutes(paths) {
   const routes = new Set();
   for (const [routePath, operations] of Object.entries(paths)) {

test/scripts/check-sparsekernel-openapi.test.ts

@@ -1,6 +1,7 @@
 import { describe, expect, it } from "vitest";
 import {
   collectOpenApiInlineRequestBodyRoutes,
+  collectOpenApiReferencedSchemaNames,
   collectOpenApiRequestBodySchemaNames,
 } from "../../scripts/check-sparsekernel-openapi.mjs";
 
@@ -26,6 +27,45 @@ describe("scripts/check-sparsekernel-openapi", () => {
     expect([...collectOpenApiRequestBodySchemaNames(paths)]).toEqual(["EnqueueTaskInput"]);
   });
 
+  it("collects all referenced component schemas for client parity coverage", () => {
+    const openapi = {
+      paths: {
+        "/tasks": {
+          get: {
+            responses: {
+              "200": {
+                content: {
+                  "application/json": {
+                    schema: {
+                      type: "array",
+                      items: { $ref: "#/components/schemas/Task" },
+                    },
+                  },
+                },
+              },
+            },
+          },
+        },
+        "/tasks/enqueue": {
+          post: {
+            requestBody: {
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/EnqueueTaskInput" },
+                },
+              },
+            },
+          },
+        },
+      },
+    };
+
+    expect([...collectOpenApiReferencedSchemaNames(openapi)].sort()).toEqual([
+      "EnqueueTaskInput",
+      "Task",
+    ]);
+  });
+
   it("finds inline request body schemas that bypass client parity mappings", () => {
     const paths = {
       "/leases/release-expired": {