@skyramp/mcp 0.3.2-rc.pom-4 → 0.3.2

package/build/workspace/workspace.d.ts

@@ -1,17 +1,24 @@
 import { z } from "zod";
 export declare const WORKSPACE_DIR = ".skyramp";
 export declare const WORKSPACE_FILENAME = "workspace.yml";
+export { SUPPORTED_FRAMEWORKS } from "./frameworks.js";
 export declare const serviceSchema: z.ZodObject<{
     serviceName: z.ZodString;
     repository: z.ZodOptional<z.ZodString>;
     language: z.ZodOptional<z.ZodEnum<["python", "typescript", "javascript", "java"]>>;
-    framework: z.ZodOptional<z.ZodEnum<["playwright", "pytest", "robot", "junit"]>>;
+    framework: z.ZodOptional<z.ZodEnum<["playwright", "pytest", "robot", "junit", "vitest", "jest", "mocha", "go", "rspec", "jasmine"]>>;
     testDirectory: z.ZodOptional<z.ZodString>;
     api: z.ZodOptional<z.ZodObject<{
         schemaPath: z.ZodOptional<z.ZodString>;
         authType: z.ZodOptional<z.ZodEnum<["bearer", "basic", "oauth", "apiKey", "cookie", "session", "token", "none"]>>;
         authHeader: z.ZodOptional<z.ZodString>;
         authScheme: z.ZodOptional<z.ZodString>;
+        /** Query params always attached to every generated request for this
+         *  service (e.g. RBAC context an authorization layer requires beyond
+         *  the auth header). Literal values only — no env-var interpolation.
+         *  Explicit per-request queryParams always win on a key collision
+         *  (SKYR-4050). */
+        defaultQueryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         baseUrl: z.ZodOptional<z.ZodString>;
         /** SUT serves self-signed TLS (e.g. a kind kube-apiserver) — generated
          *  tests should skip certificate verification for this service (SKYR-3961).
@@ -22,6 +29,7 @@ export declare const serviceSchema: z.ZodObject<{
         authScheme?: string | undefined;
         schemaPath?: string | undefined;
         authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
+        defaultQueryParams?: Record<string, string> | undefined;
         baseUrl?: string | undefined;
         skipTLSVerify?: boolean | undefined;
     }, {
@@ -29,32 +37,75 @@ export declare const serviceSchema: z.ZodObject<{
         authScheme?: string | undefined;
         schemaPath?: string | undefined;
         authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
+        defaultQueryParams?: Record<string, string> | undefined;
         baseUrl?: string | undefined;
         skipTLSVerify?: boolean | undefined;
     }>>;
     runtimeDetails: z.ZodOptional<z.ZodObject<{
         serverStartCommand: z.ZodOptional<z.ZodString>;
-        runtime: z.ZodEnum<["local", "docker", "k8s"]>;
+        serverStopCommand: z.ZodOptional<z.ZodString>;
+        runtime: z.ZodEffects<z.ZodNativeEnum<typeof import("../types/TestTypes.js").RuntimeEnvironment>, import("../types/TestTypes.js").RuntimeEnvironment, unknown>;
         dockerNetwork: z.ZodOptional<z.ZodString>;
         k8sNamespace: z.ZodOptional<z.ZodString>;
         k8sContext: z.ZodOptional<z.ZodString>;
+        testSuites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            framework: z.ZodOptional<z.ZodEnum<["playwright", "pytest", "robot", "junit", "vitest", "jest", "mocha", "go", "rspec", "jasmine"]>>;
+            testRunCommand: z.ZodString;
+            testEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            pathGlobs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            canaryStatus: z.ZodOptional<z.ZodEnum<["proven", "unproven"]>>;
+            /** Why it could not be proven — required by the prompt when unproven. */
+            canaryDetail: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            testRunCommand: string;
+            framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+            testEnv?: Record<string, string> | undefined;
+            pathGlobs?: string[] | undefined;
+            canaryStatus?: "proven" | "unproven" | undefined;
+            canaryDetail?: string | undefined;
+        }, {
+            testRunCommand: string;
+            framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+            testEnv?: Record<string, string> | undefined;
+            pathGlobs?: string[] | undefined;
+            canaryStatus?: "proven" | "unproven" | undefined;
+            canaryDetail?: string | undefined;
+        }>, "many">>;
     }, "strict", z.ZodTypeAny, {
-        runtime: "local" | "docker" | "k8s";
+        runtime: import("../types/TestTypes.js").RuntimeEnvironment;
         dockerNetwork?: string | undefined;
         k8sNamespace?: string | undefined;
         k8sContext?: string | undefined;
         serverStartCommand?: string | undefined;
+        serverStopCommand?: string | undefined;
+        testSuites?: {
+            testRunCommand: string;
+            framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+            testEnv?: Record<string, string> | undefined;
+            pathGlobs?: string[] | undefined;
+            canaryStatus?: "proven" | "unproven" | undefined;
+            canaryDetail?: string | undefined;
+        }[] | undefined;
     }, {
-        runtime: "local" | "docker" | "k8s";
+        runtime?: unknown;
         dockerNetwork?: string | undefined;
         k8sNamespace?: string | undefined;
         k8sContext?: string | undefined;
         serverStartCommand?: string | undefined;
+        serverStopCommand?: string | undefined;
+        testSuites?: {
+            testRunCommand: string;
+            framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+            testEnv?: Record<string, string> | undefined;
+            pathGlobs?: string[] | undefined;
+            canaryStatus?: "proven" | "unproven" | undefined;
+            canaryDetail?: string | undefined;
+        }[] | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
     serviceName: string;
     language?: "python" | "typescript" | "javascript" | "java" | undefined;
-    framework?: "playwright" | "pytest" | "robot" | "junit" | undefined;
+    framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
     repository?: string | undefined;
     testDirectory?: string | undefined;
     api?: {
@@ -62,20 +113,30 @@ export declare const serviceSchema: z.ZodObject<{
         authScheme?: string | undefined;
         schemaPath?: string | undefined;
         authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
+        defaultQueryParams?: Record<string, string> | undefined;
         baseUrl?: string | undefined;
         skipTLSVerify?: boolean | undefined;
     } | undefined;
     runtimeDetails?: {
-        runtime: "local" | "docker" | "k8s";
+        runtime: import("../types/TestTypes.js").RuntimeEnvironment;
         dockerNetwork?: string | undefined;
         k8sNamespace?: string | undefined;
         k8sContext?: string | undefined;
         serverStartCommand?: string | undefined;
+        serverStopCommand?: string | undefined;
+        testSuites?: {
+            testRunCommand: string;
+            framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+            testEnv?: Record<string, string> | undefined;
+            pathGlobs?: string[] | undefined;
+            canaryStatus?: "proven" | "unproven" | undefined;
+            canaryDetail?: string | undefined;
+        }[] | undefined;
     } | undefined;
 }, {
     serviceName: string;
     language?: "python" | "typescript" | "javascript" | "java" | undefined;
-    framework?: "playwright" | "pytest" | "robot" | "junit" | undefined;
+    framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
     repository?: string | undefined;
     testDirectory?: string | undefined;
     api?: {
@@ -83,15 +144,25 @@ export declare const serviceSchema: z.ZodObject<{
         authScheme?: string | undefined;
         schemaPath?: string | undefined;
         authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
+        defaultQueryParams?: Record<string, string> | undefined;
         baseUrl?: string | undefined;
         skipTLSVerify?: boolean | undefined;
     } | undefined;
     runtimeDetails?: {
-        runtime: "local" | "docker" | "k8s";
+        runtime?: unknown;
         dockerNetwork?: string | undefined;
         k8sNamespace?: string | undefined;
         k8sContext?: string | undefined;
         serverStartCommand?: string | undefined;
+        serverStopCommand?: string | undefined;
+        testSuites?: {
+            testRunCommand: string;
+            framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+            testEnv?: Record<string, string> | undefined;
+            pathGlobs?: string[] | undefined;
+            canaryStatus?: "proven" | "unproven" | undefined;
+            canaryDetail?: string | undefined;
+        }[] | undefined;
     } | undefined;
 }>;
 export declare const workspaceConfigSchema: z.ZodObject<{
@@ -128,13 +199,19 @@ export declare const workspaceConfigSchema: z.ZodObject<{
         serviceName: z.ZodString;
         repository: z.ZodOptional<z.ZodString>;
         language: z.ZodOptional<z.ZodEnum<["python", "typescript", "javascript", "java"]>>;
-        framework: z.ZodOptional<z.ZodEnum<["playwright", "pytest", "robot", "junit"]>>;
+        framework: z.ZodOptional<z.ZodEnum<["playwright", "pytest", "robot", "junit", "vitest", "jest", "mocha", "go", "rspec", "jasmine"]>>;
         testDirectory: z.ZodOptional<z.ZodString>;
         api: z.ZodOptional<z.ZodObject<{
             schemaPath: z.ZodOptional<z.ZodString>;
             authType: z.ZodOptional<z.ZodEnum<["bearer", "basic", "oauth", "apiKey", "cookie", "session", "token", "none"]>>;
             authHeader: z.ZodOptional<z.ZodString>;
             authScheme: z.ZodOptional<z.ZodString>;
+            /** Query params always attached to every generated request for this
+             *  service (e.g. RBAC context an authorization layer requires beyond
+             *  the auth header). Literal values only — no env-var interpolation.
+             *  Explicit per-request queryParams always win on a key collision
+             *  (SKYR-4050). */
+            defaultQueryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             baseUrl: z.ZodOptional<z.ZodString>;
             /** SUT serves self-signed TLS (e.g. a kind kube-apiserver) — generated
              *  tests should skip certificate verification for this service (SKYR-3961).
@@ -145,6 +222,7 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             authScheme?: string | undefined;
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
+            defaultQueryParams?: Record<string, string> | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         }, {
@@ -152,32 +230,75 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             authScheme?: string | undefined;
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
+            defaultQueryParams?: Record<string, string> | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         }>>;
         runtimeDetails: z.ZodOptional<z.ZodObject<{
             serverStartCommand: z.ZodOptional<z.ZodString>;
-            runtime: z.ZodEnum<["local", "docker", "k8s"]>;
+            serverStopCommand: z.ZodOptional<z.ZodString>;
+            runtime: z.ZodEffects<z.ZodNativeEnum<typeof import("../types/TestTypes.js").RuntimeEnvironment>, import("../types/TestTypes.js").RuntimeEnvironment, unknown>;
             dockerNetwork: z.ZodOptional<z.ZodString>;
             k8sNamespace: z.ZodOptional<z.ZodString>;
             k8sContext: z.ZodOptional<z.ZodString>;
+            testSuites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                framework: z.ZodOptional<z.ZodEnum<["playwright", "pytest", "robot", "junit", "vitest", "jest", "mocha", "go", "rspec", "jasmine"]>>;
+                testRunCommand: z.ZodString;
+                testEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                pathGlobs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                canaryStatus: z.ZodOptional<z.ZodEnum<["proven", "unproven"]>>;
+                /** Why it could not be proven — required by the prompt when unproven. */
+                canaryDetail: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                testRunCommand: string;
+                framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+                testEnv?: Record<string, string> | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
+            }, {
+                testRunCommand: string;
+                framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+                testEnv?: Record<string, string> | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
+            }>, "many">>;
         }, "strict", z.ZodTypeAny, {
-            runtime: "local" | "docker" | "k8s";
+            runtime: import("../types/TestTypes.js").RuntimeEnvironment;
             dockerNetwork?: string | undefined;
             k8sNamespace?: string | undefined;
             k8sContext?: string | undefined;
             serverStartCommand?: string | undefined;
+            serverStopCommand?: string | undefined;
+            testSuites?: {
+                testRunCommand: string;
+                framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+                testEnv?: Record<string, string> | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
+            }[] | undefined;
         }, {
-            runtime: "local" | "docker" | "k8s";
+            runtime?: unknown;
             dockerNetwork?: string | undefined;
             k8sNamespace?: string | undefined;
             k8sContext?: string | undefined;
             serverStartCommand?: string | undefined;
+            serverStopCommand?: string | undefined;
+            testSuites?: {
+                testRunCommand: string;
+                framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+                testEnv?: Record<string, string> | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
+            }[] | undefined;
         }>>;
     }, "strict", z.ZodTypeAny, {
         serviceName: string;
         language?: "python" | "typescript" | "javascript" | "java" | undefined;
-        framework?: "playwright" | "pytest" | "robot" | "junit" | undefined;
+        framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
         repository?: string | undefined;
         testDirectory?: string | undefined;
         api?: {
@@ -185,20 +306,30 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             authScheme?: string | undefined;
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
+            defaultQueryParams?: Record<string, string> | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         } | undefined;
         runtimeDetails?: {
-            runtime: "local" | "docker" | "k8s";
+            runtime: import("../types/TestTypes.js").RuntimeEnvironment;
             dockerNetwork?: string | undefined;
             k8sNamespace?: string | undefined;
             k8sContext?: string | undefined;
             serverStartCommand?: string | undefined;
+            serverStopCommand?: string | undefined;
+            testSuites?: {
+                testRunCommand: string;
+                framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+                testEnv?: Record<string, string> | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
+            }[] | undefined;
         } | undefined;
     }, {
         serviceName: string;
         language?: "python" | "typescript" | "javascript" | "java" | undefined;
-        framework?: "playwright" | "pytest" | "robot" | "junit" | undefined;
+        framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
         repository?: string | undefined;
         testDirectory?: string | undefined;
         api?: {
@@ -206,15 +337,25 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             authScheme?: string | undefined;
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
+            defaultQueryParams?: Record<string, string> | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         } | undefined;
         runtimeDetails?: {
-            runtime: "local" | "docker" | "k8s";
+            runtime?: unknown;
             dockerNetwork?: string | undefined;
             k8sNamespace?: string | undefined;
             k8sContext?: string | undefined;
             serverStartCommand?: string | undefined;
+            serverStopCommand?: string | undefined;
+            testSuites?: {
+                testRunCommand: string;
+                framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+                testEnv?: Record<string, string> | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
+            }[] | undefined;
         } | undefined;
     }>, "many">>;
 }, "strict", z.ZodTypeAny, {
@@ -232,7 +373,7 @@ export declare const workspaceConfigSchema: z.ZodObject<{
     services?: {
         serviceName: string;
         language?: "python" | "typescript" | "javascript" | "java" | undefined;
-        framework?: "playwright" | "pytest" | "robot" | "junit" | undefined;
+        framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
         repository?: string | undefined;
         testDirectory?: string | undefined;
         api?: {
@@ -240,15 +381,25 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             authScheme?: string | undefined;
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
+            defaultQueryParams?: Record<string, string> | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         } | undefined;
         runtimeDetails?: {
-            runtime: "local" | "docker" | "k8s";
+            runtime: import("../types/TestTypes.js").RuntimeEnvironment;
             dockerNetwork?: string | undefined;
             k8sNamespace?: string | undefined;
             k8sContext?: string | undefined;
             serverStartCommand?: string | undefined;
+            serverStopCommand?: string | undefined;
+            testSuites?: {
+                testRunCommand: string;
+                framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+                testEnv?: Record<string, string> | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
+            }[] | undefined;
         } | undefined;
     }[] | undefined;
 }, {
@@ -266,7 +417,7 @@ export declare const workspaceConfigSchema: z.ZodObject<{
     services?: {
         serviceName: string;
         language?: "python" | "typescript" | "javascript" | "java" | undefined;
-        framework?: "playwright" | "pytest" | "robot" | "junit" | undefined;
+        framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
         repository?: string | undefined;
         testDirectory?: string | undefined;
         api?: {
@@ -274,21 +425,32 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             authScheme?: string | undefined;
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
+            defaultQueryParams?: Record<string, string> | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         } | undefined;
         runtimeDetails?: {
-            runtime: "local" | "docker" | "k8s";
+            runtime?: unknown;
             dockerNetwork?: string | undefined;
             k8sNamespace?: string | undefined;
             k8sContext?: string | undefined;
             serverStartCommand?: string | undefined;
+            serverStopCommand?: string | undefined;
+            testSuites?: {
+                testRunCommand: string;
+                framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+                testEnv?: Record<string, string> | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
+            }[] | undefined;
         } | undefined;
     }[] | undefined;
 }>;
 export type Service = z.infer<typeof serviceSchema>;
 export type ServiceApi = NonNullable<Service["api"]>;
 export type ServiceRuntimeDetails = NonNullable<Service["runtimeDetails"]>;
+export type TestSuite = NonNullable<ServiceRuntimeDetails["testSuites"]>[number];
 export type WorkspaceConfig = z.infer<typeof workspaceConfigSchema>;
 export type WorkspaceSection = NonNullable<WorkspaceConfig["workspace"]>;
 export type MetadataSection = NonNullable<WorkspaceConfig["metadata"]>;
@@ -308,7 +470,7 @@ export declare function validateWorkspaceConfig(config: unknown): z.SafeParseRet
     services?: {
         serviceName: string;
         language?: "python" | "typescript" | "javascript" | "java" | undefined;
-        framework?: "playwright" | "pytest" | "robot" | "junit" | undefined;
+        framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
         repository?: string | undefined;
         testDirectory?: string | undefined;
         api?: {
@@ -316,15 +478,25 @@ export declare function validateWorkspaceConfig(config: unknown): z.SafeParseRet
             authScheme?: string | undefined;
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
+            defaultQueryParams?: Record<string, string> | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         } | undefined;
         runtimeDetails?: {
-            runtime: "local" | "docker" | "k8s";
+            runtime?: unknown;
             dockerNetwork?: string | undefined;
             k8sNamespace?: string | undefined;
             k8sContext?: string | undefined;
             serverStartCommand?: string | undefined;
+            serverStopCommand?: string | undefined;
+            testSuites?: {
+                testRunCommand: string;
+                framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+                testEnv?: Record<string, string> | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
+            }[] | undefined;
         } | undefined;
     }[] | undefined;
 }, {
@@ -342,7 +514,7 @@ export declare function validateWorkspaceConfig(config: unknown): z.SafeParseRet
     services?: {
         serviceName: string;
         language?: "python" | "typescript" | "javascript" | "java" | undefined;
-        framework?: "playwright" | "pytest" | "robot" | "junit" | undefined;
+        framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
         repository?: string | undefined;
         testDirectory?: string | undefined;
         api?: {
@@ -350,15 +522,25 @@ export declare function validateWorkspaceConfig(config: unknown): z.SafeParseRet
             authScheme?: string | undefined;
             schemaPath?: string | undefined;
             authType?: "none" | "token" | "bearer" | "basic" | "oauth" | "apiKey" | "cookie" | "session" | undefined;
+            defaultQueryParams?: Record<string, string> | undefined;
             baseUrl?: string | undefined;
             skipTLSVerify?: boolean | undefined;
         } | undefined;
         runtimeDetails?: {
-            runtime: "local" | "docker" | "k8s";
+            runtime: import("../types/TestTypes.js").RuntimeEnvironment;
             dockerNetwork?: string | undefined;
             k8sNamespace?: string | undefined;
             k8sContext?: string | undefined;
             serverStartCommand?: string | undefined;
+            serverStopCommand?: string | undefined;
+            testSuites?: {
+                testRunCommand: string;
+                framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+                testEnv?: Record<string, string> | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
+            }[] | undefined;
         } | undefined;
     }[] | undefined;
 }>;

package/build/workspace/workspace.js

@@ -14,12 +14,17 @@ import { execFile } from "child_process";
 import { promisify } from "util";
 import yaml from "js-yaml";
 import { z } from "zod";
+import { SUPPORTED_FRAMEWORKS } from "./frameworks.js";
+import { runtimeEnvironmentInputSchema } from "../types/TestTypes.js";
 const execFileAsync = promisify(execFile);
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
 export const WORKSPACE_DIR = ".skyramp";
 export const WORKSPACE_FILENAME = "workspace.yml";
+// SUPPORTED_FRAMEWORKS lives in the dependency-free ./frameworks module (imported
+// above for the schema below) and is re-exported here for existing importers.
+export { SUPPORTED_FRAMEWORKS } from "./frameworks.js";
 // ---------------------------------------------------------------------------
 // Zod schemas (source of truth — types are inferred from these below)
 // ---------------------------------------------------------------------------
@@ -31,7 +36,7 @@ export const serviceSchema = z
     // so the same serviceName can appear once per repo without colliding.
     repository: z.string().optional(),
     language: z.enum(["python", "typescript", "javascript", "java"]).optional(),
-    framework: z.enum(["playwright", "pytest", "robot", "junit"]).optional(),
+    framework: z.enum(SUPPORTED_FRAMEWORKS).optional(),
     testDirectory: z.string().optional(),
     api: z
         .object({
@@ -50,6 +55,12 @@ export const serviceSchema = z
             .optional(),
         authHeader: z.string().optional(),
         authScheme: z.string().optional(),
+        /** Query params always attached to every generated request for this
+         *  service (e.g. RBAC context an authorization layer requires beyond
+         *  the auth header). Literal values only — no env-var interpolation.
+         *  Explicit per-request queryParams always win on a key collision
+         *  (SKYR-4050). */
+        defaultQueryParams: z.record(z.string()).optional(),
         baseUrl: z.string().optional(),
         /** SUT serves self-signed TLS (e.g. a kind kube-apiserver) — generated
          *  tests should skip certificate verification for this service (SKYR-3961).
@@ -60,11 +71,50 @@ export const serviceSchema = z
         .optional(),
     runtimeDetails: z
         .object({
+        // existing comms axis — how the runner reaches the app
         serverStartCommand: z.string().optional(),
-        runtime: z.enum(["local", "docker", "k8s"]),
+        serverStopCommand: z.string().optional(),
+        runtime: runtimeEnvironmentInputSchema,
         dockerNetwork: z.string().optional(),
         k8sNamespace: z.string().optional(),
         k8sContext: z.string().optional(),
+        // External-suite test contract (SKYR-4002). A service hosts one or more
+        // runnable suites — record each under testSuites, even a single suite
+        // (there is no flat single-suite form). Written by the SUT adapt_workflow
+        // bootstrap (skyramp_testbot_sut), read at run time by
+        // skyramp_run_existing_tests. Each suite carries its own framework
+        // (falling back to the service's), testRunCommand, testEnv, and pathGlobs
+        // — the repo-relative paths that suite owns, used to route a selector to
+        // the one suite that can run it. One service can host multiple frameworks.
+        testSuites: z
+            .array(z
+            .object({
+            framework: z.enum(SUPPORTED_FRAMEWORKS).optional(),
+            testRunCommand: z.string().min(1),
+            testEnv: z.record(z.string(), z.string()).optional(),
+            pathGlobs: z.array(z.string()).optional(),
+            // Did SUT setup actually run one test from this suite?
+            //
+            // "Is the environment proven" and "should maintenance work on this
+            // suite" are independent, and collapsing them costs one way or the
+            // other. The prompt used to make recording free, so a suite could
+            // read as covered while never having executed. Requiring proof
+            // instead would drop exactly the suite a user most wants
+            // maintained: a self-provisioning e2e suite whose substrate the
+            // setup cannot stand up. Run 30402703836 shows why that trade is
+            // bad — with its Playwright environment dead, static analysis
+            // still found the stale POM testid and fixed it correctly.
+            //
+            // So an unproven suite STAYS and is still maintained; this records
+            // that its environment was never validated, and canaryDetail says
+            // what it needs. Absent means unproven (older artifacts predate
+            // this field), which is the safe reading.
+            canaryStatus: z.enum(["proven", "unproven"]).optional(),
+            /** Why it could not be proven — required by the prompt when unproven. */
+            canaryDetail: z.string().optional(),
+        })
+            .strict())
+            .optional(),
     })
         .strict()
         .optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyramp/mcp",
-  "version": "0.3.2-rc.pom-4",
+  "version": "0.3.2",
   "main": "build/index.js",
   "exports": {
     ".": "./build/index.js",
@@ -33,6 +33,7 @@
     "pretty": "npx prettier --write .",
     "lint": "eslint src --ext .ts",
     "lint:fix": "eslint src --ext .ts --fix",
+    "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
     "test": "node --experimental-vm-modules node_modules/.bin/jest"
   },
   "files": [
@@ -67,10 +68,11 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.24.3",
     "@playwright/test": "^1.55.0",
-    "@skyramp/skyramp": "1.3.36",
+    "@skyramp/skyramp": "1.3.37",
     "dockerode": "^5.0.0",
     "fast-glob": "^3.3.3",
     "js-yaml": "^4.1.1",
+    "picomatch": "^4.0.5",
     "playwright": "file:vendor/skyramp-playwright-1.58.2-skyramp.8.14.3.tgz",
     "simple-git": "^3.30.0",
     "typescript": "^5.8.3",
@@ -82,6 +84,7 @@
     "@types/js-yaml": "^4.0.9",
     "@types/mocha": "^10.0.10",
     "@types/node": "^22.15.19",
+    "@types/picomatch": "^4.0.3",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "eslint": "^9.0.0",