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

package/build/workspace/workspace.d.ts

@@ -13,6 +13,12 @@ export declare const serviceSchema: z.ZodObject<{
         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).
@@ -23,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;
     }, {
@@ -30,12 +37,14 @@ 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>;
@@ -43,41 +52,54 @@ export declare const serviceSchema: 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>>;
-            selectorStyle: z.ZodOptional<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;
-            selectorStyle?: 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;
-            selectorStyle?: 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;
-            selectorStyle?: 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;
-            selectorStyle?: string | undefined;
+            pathGlobs?: string[] | undefined;
+            canaryStatus?: "proven" | "unproven" | undefined;
+            canaryDetail?: string | undefined;
         }[] | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
@@ -91,20 +113,24 @@ 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;
-            selectorStyle?: string | undefined;
+            pathGlobs?: string[] | undefined;
+            canaryStatus?: "proven" | "unproven" | undefined;
+            canaryDetail?: string | undefined;
         }[] | undefined;
     } | undefined;
 }, {
@@ -118,20 +144,24 @@ 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;
-            selectorStyle?: string | undefined;
+            pathGlobs?: string[] | undefined;
+            canaryStatus?: "proven" | "unproven" | undefined;
+            canaryDetail?: string | undefined;
         }[] | undefined;
     } | undefined;
 }>;
@@ -176,6 +206,12 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             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).
@@ -186,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;
         }, {
@@ -193,12 +230,14 @@ 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>;
@@ -206,41 +245,54 @@ export declare const workspaceConfigSchema: 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>>;
-                selectorStyle: z.ZodOptional<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;
-                selectorStyle?: 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;
-                selectorStyle?: 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;
-                selectorStyle?: 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;
-                selectorStyle?: string | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
             }[] | undefined;
         }>>;
     }, "strict", z.ZodTypeAny, {
@@ -254,20 +306,24 @@ 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;
-                selectorStyle?: string | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
             }[] | undefined;
         } | undefined;
     }, {
@@ -281,20 +337,24 @@ 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;
-                selectorStyle?: string | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
             }[] | undefined;
         } | undefined;
     }>, "many">>;
@@ -321,20 +381,24 @@ 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;
-                selectorStyle?: string | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
             }[] | undefined;
         } | undefined;
     }[] | undefined;
@@ -361,20 +425,24 @@ 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;
-                selectorStyle?: string | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
             }[] | undefined;
         } | undefined;
     }[] | undefined;
@@ -410,20 +478,24 @@ 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;
-                selectorStyle?: string | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
             }[] | undefined;
         } | undefined;
     }[] | undefined;
@@ -450,20 +522,24 @@ 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;
-                selectorStyle?: string | undefined;
+                pathGlobs?: string[] | undefined;
+                canaryStatus?: "proven" | "unproven" | undefined;
+                canaryDetail?: string | undefined;
             }[] | undefined;
         } | undefined;
     }[] | undefined;

package/build/workspace/workspace.js

@@ -15,6 +15,7 @@ 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
@@ -54,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).
@@ -66,7 +73,8 @@ export const serviceSchema = 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(),
@@ -75,15 +83,35 @@ export const serviceSchema = z
         // (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, and testEnv — one
-        // service can host multiple frameworks.
+        // (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(),
-            selectorStyle: 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(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyramp/mcp",
-  "version": "0.3.2-rc.pom-3",
+  "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",

package/build/adapters/jestAdapter.test.d.ts

@@ -1 +0,0 @@
-export {};

package/build/adapters/jestAdapter.test.js

@@ -1,93 +0,0 @@
-import path from "path";
-import { fileURLToPath } from "url";
-import { readFileSync } from "fs";
-import { parseJestJson, buildJestArgs, buildVitestArgs } from "./jestAdapter.js";
-const here = path.dirname(fileURLToPath(import.meta.url));
-function loadFixture(name) {
-    return JSON.parse(readFileSync(path.join(here, "__fixtures__", `${name}.json`), "utf8"));
-}
-describe("parseJestJson", () => {
-    describe("jest healthy variety report", () => {
-        const parsed = parseJestJson(loadFixture("jest-healthy"));
-        const byId = (s) => parsed.results.find((r) => r.testId.includes(s));
-        it("keeps the environment healthy (a broken test file is PR signal, not env)", () => {
-            expect(parsed.environmentHealthy).toBe(true);
-        });
-        it("maps passed/failed/todo and a file testExecError to pass/fail/skipped/error", () => {
-            expect(byId("adds numbers").status).toBe("pass");
-            expect(byId("detects a regression").status).toBe("fail");
-            expect(byId("todo later").status).toBe("skipped");
-            expect(byId("broken.test.js").status).toBe("error");
-        });
-        it("builds a testId from file + ancestorTitles + title", () => {
-            expect(byId("adds numbers").testId).toBe("/repo/src/math.test.js › math › adds numbers");
-            expect(byId("adds numbers").file).toBe("/repo/src/math.test.js");
-        });
-        it("captures a failure message for fail and file-exec error", () => {
-            expect(byId("detects a regression").message).toMatch(/Expected: 2/);
-            expect(byId("broken.test.js").message).toMatch(/SyntaxError/);
-        });
-        it("summarizes ran/failed/errored/skipped (skipped not in ran)", () => {
-            expect(parsed.summary).toMatchObject({ failed: 1, errored: 1, skipped: 1 });
-            expect(parsed.summary.ran).toBe(3);
-        });
-    });
-    describe("real jest syntax-error shape (no testExecError, top-level message)", () => {
-        // Confirmed against a REAL jest run (Step 7 smoke): a syntax error produces
-        // `status: "failed"`, `assertionResults: []`, and a top-level `message` —
-        // no `testExecError` object at all. Must map to "error" same as the
-        // testExecError shape.
-        const parsed = parseJestJson({
-            testResults: [
-                {
-                    name: "/repo/src/broken2.test.js",
-                    status: "failed",
-                    message: "SyntaxError: Unexpected token, expected \",\"",
-                    assertionResults: [],
-                },
-            ],
-        });
-        it("maps a message-only file failure to a single error result", () => {
-            expect(parsed.results).toHaveLength(1);
-            expect(parsed.results[0].status).toBe("error");
-            expect(parsed.results[0].message).toMatch(/SyntaxError/);
-            expect(parsed.summary).toMatchObject({ errored: 1, failed: 0, skipped: 0 });
-        });
-    });
-    describe("vitest report through the shared reader", () => {
-        const parsed = parseJestJson(loadFixture("vitest-healthy"));
-        it("parses vitest's jest-compatible json identically", () => {
-            expect(parsed.summary).toMatchObject({ failed: 0, errored: 0, skipped: 1 });
-            expect(parsed.summary.ran).toBe(1);
-            expect(parsed.results.find((r) => r.testId.includes("works")).status).toBe("pass");
-        });
-    });
-    it("honors an explicit truncated flag", () => {
-        expect(parseJestJson(loadFixture("jest-healthy"), { truncated: true }).summary.truncated).toBe(true);
-    });
-});
-describe("buildJestArgs", () => {
-    it("forces --json + --outputFile and passes files", () => {
-        const args = buildJestArgs({ selectors: ["src/a.test.js"], mode: "confirm", reportPath: "/tmp/r.json" });
-        expect(args).toContain("--json");
-        expect(args).toContain("--outputFile=/tmp/r.json");
-        expect(args).toContain("src/a.test.js");
-        expect(args).not.toContain("--bail=1");
-    });
-    it("bails at first failure in probe mode and filters by name via -t", () => {
-        const args = buildJestArgs({ selectors: ["src/a.test.js::renders header"], mode: "probe", reportPath: "/tmp/r.json" });
-        expect(args).toContain("--bail=1");
-        const ti = args.indexOf("-t");
-        expect(ti).toBeGreaterThanOrEqual(0);
-        expect(args[ti + 1]).toContain("renders header");
-        expect(args).toContain("src/a.test.js");
-    });
-});
-describe("buildVitestArgs", () => {
-    it("forces --reporter=json + --outputFile (vitest form)", () => {
-        const args = buildVitestArgs({ selectors: ["src/a.test.ts"], mode: "confirm", reportPath: "/tmp/r.json" });
-        expect(args).toContain("--reporter=json");
-        expect(args).toContain("--outputFile=/tmp/r.json");
-        expect(args).not.toContain("--json");
-    });
-});

package/build/adapters/mochaAdapter.test.d.ts

@@ -1 +0,0 @@
-export {};