@skyramp/mcp 0.4.1 → 0.4.2-rc.1

package/build/tools/test-management/registerTestPlanTool.d.ts

@@ -1,7 +1,6 @@
 import { z } from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StateManager, UnifiedAnalysisState } from "../../utils/AnalysisStateManager.js";
-import { TestType } from "../../types/TestTypes.js";
 import { PlanResult } from "../../recommendation/registerPlan.js";
 import { ObjectionAnswer, PlanChange, PlanDefect, PlanInput, PlanMaintenance, VerifyContext } from "../../recommendation/types.js";
 /** The whole run's state file: the primary repository at the root, every related
@@ -195,16 +194,15 @@ export declare const declarationFieldsSchema: z.ZodObject<{
 export declare function hoistDeclarationFields(value: unknown): unknown;
 declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     scenarioName: z.ZodEffects<z.ZodString, string, string>;
-    repository: z.ZodOptional<z.ZodString>;
+    repository: z.ZodString;
     description: z.ZodString;
     category: z.ZodEnum<["new_endpoint", "bug_caught", "requirement_conflict", "business_rule", "security_boundary", "data_integrity", "breaking_change", "auth", "error_handling", "workflow", "data_validation", "crud"]>;
-    testType: z.ZodEnum<[TestType.CONTRACT, TestType.INTEGRATION, TestType.E2E, TestType.UI]>;
-    steps: z.ZodArray<z.ZodEffects<z.ZodObject<{
+    testType: z.ZodEnum<[import("../../types/TestTypes.js").TestType.CONTRACT, import("../../types/TestTypes.js").TestType.INTEGRATION, import("../../types/TestTypes.js").TestType.E2E, import("../../types/TestTypes.js").TestType.UI]>;
+    steps: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodObject<{
         order: z.ZodNumber;
         method: z.ZodEffects<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "TRACE", "CONNECT", "assert", "click", "drag", "drag-hold", "hover", "inspect", "navigate", "press", "release", "tap", "type", "wait", "OPERATION"]>, "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "type" | "TRACE" | "CONNECT" | "assert" | "click" | "drag" | "drag-hold" | "hover" | "inspect" | "navigate" | "press" | "release" | "tap" | "wait" | "OPERATION", unknown>;
         path: z.ZodEffects<z.ZodString, string, string>;
         description: z.ZodOptional<z.ZodString>;
-        interactionType: z.ZodOptional<z.ZodString>;
         requestBody: z.ZodOptional<z.ZodUnknown>;
         queryParams: z.ZodOptional<z.ZodUnknown>;
         omits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -215,7 +213,6 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         order: number;
         description?: string | undefined;
         queryParams?: unknown;
-        interactionType?: string | undefined;
         requestBody?: unknown;
         expectedStatusCode?: number | undefined;
         omits?: string[] | undefined;
@@ -225,7 +222,6 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         method?: unknown;
         description?: string | undefined;
         queryParams?: unknown;
-        interactionType?: string | undefined;
         requestBody?: unknown;
         expectedStatusCode?: number | undefined;
         omits?: string[] | undefined;
@@ -235,7 +231,6 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         order: number;
         description?: string | undefined;
         queryParams?: unknown;
-        interactionType?: string | undefined;
         requestBody?: unknown;
         expectedStatusCode?: number | undefined;
         omits?: string[] | undefined;
@@ -245,7 +240,24 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         method?: unknown;
         description?: string | undefined;
         queryParams?: unknown;
-        interactionType?: string | undefined;
+        requestBody?: unknown;
+        expectedStatusCode?: number | undefined;
+        omits?: string[] | undefined;
+    }>, {
+        path: string;
+        method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "type" | "TRACE" | "CONNECT" | "assert" | "click" | "drag" | "drag-hold" | "hover" | "inspect" | "navigate" | "press" | "release" | "tap" | "wait" | "OPERATION";
+        order: number;
+        description?: string | undefined;
+        queryParams?: unknown;
+        requestBody?: unknown;
+        expectedStatusCode?: number | undefined;
+        omits?: string[] | undefined;
+    }, {
+        path: string;
+        order: number;
+        method?: unknown;
+        description?: string | undefined;
+        queryParams?: unknown;
         requestBody?: unknown;
         expectedStatusCode?: number | undefined;
         omits?: string[] | undefined;
@@ -509,7 +521,8 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     }>>;
 }, "strict", z.ZodTypeAny, {
     description: string;
-    testType: TestType.CONTRACT | TestType.INTEGRATION | TestType.E2E | TestType.UI;
+    repository: string;
+    testType: import("../../types/TestTypes.js").TestType.CONTRACT | import("../../types/TestTypes.js").TestType.INTEGRATION | import("../../types/TestTypes.js").TestType.E2E | import("../../types/TestTypes.js").TestType.UI;
     category: "new_endpoint" | "bug_caught" | "requirement_conflict" | "business_rule" | "security_boundary" | "data_integrity" | "breaking_change" | "auth" | "error_handling" | "workflow" | "data_validation" | "crud";
     scenarioName: string;
     steps: {
@@ -518,12 +531,10 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         order: number;
         description?: string | undefined;
         queryParams?: unknown;
-        interactionType?: string | undefined;
         requestBody?: unknown;
         expectedStatusCode?: number | undefined;
         omits?: string[] | undefined;
     }[];
-    repository?: string | undefined;
     declarations?: {
         expected: {
             outcome: "pass" | "fail";
@@ -565,7 +576,8 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     } | undefined;
 }, {
     description: string;
-    testType: TestType.CONTRACT | TestType.INTEGRATION | TestType.E2E | TestType.UI;
+    repository: string;
+    testType: import("../../types/TestTypes.js").TestType.CONTRACT | import("../../types/TestTypes.js").TestType.INTEGRATION | import("../../types/TestTypes.js").TestType.E2E | import("../../types/TestTypes.js").TestType.UI;
     category: "new_endpoint" | "bug_caught" | "requirement_conflict" | "business_rule" | "security_boundary" | "data_integrity" | "breaking_change" | "auth" | "error_handling" | "workflow" | "data_validation" | "crud";
     scenarioName: string;
     steps: {
@@ -574,12 +586,10 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         method?: unknown;
         description?: string | undefined;
         queryParams?: unknown;
-        interactionType?: string | undefined;
         requestBody?: unknown;
         expectedStatusCode?: number | undefined;
         omits?: string[] | undefined;
     }[];
-    repository?: string | undefined;
     declarations?: {
         expected: {
             outcome: "pass" | "fail";
@@ -621,7 +631,8 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     } | undefined;
 }>, {
     description: string;
-    testType: TestType.CONTRACT | TestType.INTEGRATION | TestType.E2E | TestType.UI;
+    repository: string;
+    testType: import("../../types/TestTypes.js").TestType.CONTRACT | import("../../types/TestTypes.js").TestType.INTEGRATION | import("../../types/TestTypes.js").TestType.E2E | import("../../types/TestTypes.js").TestType.UI;
     category: "new_endpoint" | "bug_caught" | "requirement_conflict" | "business_rule" | "security_boundary" | "data_integrity" | "breaking_change" | "auth" | "error_handling" | "workflow" | "data_validation" | "crud";
     scenarioName: string;
     steps: {
@@ -630,12 +641,10 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         order: number;
         description?: string | undefined;
         queryParams?: unknown;
-        interactionType?: string | undefined;
         requestBody?: unknown;
         expectedStatusCode?: number | undefined;
         omits?: string[] | undefined;
     }[];
-    repository?: string | undefined;
     declarations?: {
         expected: {
             outcome: "pass" | "fail";
@@ -677,7 +686,8 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     } | undefined;
 }, {
     description: string;
-    testType: TestType.CONTRACT | TestType.INTEGRATION | TestType.E2E | TestType.UI;
+    repository: string;
+    testType: import("../../types/TestTypes.js").TestType.CONTRACT | import("../../types/TestTypes.js").TestType.INTEGRATION | import("../../types/TestTypes.js").TestType.E2E | import("../../types/TestTypes.js").TestType.UI;
     category: "new_endpoint" | "bug_caught" | "requirement_conflict" | "business_rule" | "security_boundary" | "data_integrity" | "breaking_change" | "auth" | "error_handling" | "workflow" | "data_validation" | "crud";
     scenarioName: string;
     steps: {
@@ -686,12 +696,10 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         method?: unknown;
         description?: string | undefined;
         queryParams?: unknown;
-        interactionType?: string | undefined;
         requestBody?: unknown;
         expectedStatusCode?: number | undefined;
         omits?: string[] | undefined;
     }[];
-    repository?: string | undefined;
     declarations?: {
         expected: {
             outcome: "pass" | "fail";
@@ -733,7 +741,8 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     } | undefined;
 }>, {
     description: string;
-    testType: TestType.CONTRACT | TestType.INTEGRATION | TestType.E2E | TestType.UI;
+    repository: string;
+    testType: import("../../types/TestTypes.js").TestType.CONTRACT | import("../../types/TestTypes.js").TestType.INTEGRATION | import("../../types/TestTypes.js").TestType.E2E | import("../../types/TestTypes.js").TestType.UI;
     category: "new_endpoint" | "bug_caught" | "requirement_conflict" | "business_rule" | "security_boundary" | "data_integrity" | "breaking_change" | "auth" | "error_handling" | "workflow" | "data_validation" | "crud";
     scenarioName: string;
     steps: {
@@ -742,12 +751,10 @@ declare const registerPlannedTestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         order: number;
         description?: string | undefined;
         queryParams?: unknown;
-        interactionType?: string | undefined;
         requestBody?: unknown;
         expectedStatusCode?: number | undefined;
         omits?: string[] | undefined;
     }[];
-    repository?: string | undefined;
     declarations?: {
         expected: {
             outcome: "pass" | "fail";
@@ -815,22 +822,25 @@ export declare function buildRegistration(params: RegisterTestPlanParams, regist
  * case-insensitive checkout and is not found on a case-sensitive one. CI is the
  * case-sensitive one, so that is the answer a real run gets.
  */
-export declare function makeCitedFileCheck(state: RunState): (relativePath: string) => boolean;
+export declare function makeCitedFileCheck(state: RunState): (relativePath: string, repository?: string) => boolean;
 /**
  * The route patterns that render a changed frontend file, across every repository
  * of the run.
  *
- * Built like {@link makeCitedFileCheck}: one resolver per checkout, asked in turn,
- * so a planned test does not have to say which repository its file lives in. The
- * scan is lazy inside each resolver and reused across planned tests, so a plan with
- * ten UI tests reads a repository once.
+ * One resolver per checkout, keyed by repository, and only the named repository is
+ * asked. The scan is lazy inside each resolver and reused across planned tests, so
+ * a plan with ten UI tests reads a repository once.
+ *
+ * KEYED, not asked in turn, for the reason {@link changedFilesFor} is: two
+ * repositories can hold the same relative file, and answering from whichever was
+ * scanned first checked a planned test against another repository's routes.
  *
- * A repository that CAN speak for the file wins: `undefined` from a resolver means
- * "not my file, or not a framework I read", so it is skipped, and the first
- * definite answer is returned. Every resolver saying `undefined` is the answer the
- * check stays silent on.
+ * A repository this run does not know answers `undefined`, so the check stays
+ * silent — `changedFile:unknownRepository` is what objects to the name. There is no
+ * fallback for a single-repository run: every run keys its repositories by the
+ * `owner/repo` read off the origin remote, so the name is always matchable.
  */
-export declare function makeScreenRouteResolver(state: RunState): (relativePath: string) => string[] | undefined;
+export declare function makeScreenRouteResolver(state: RunState): (relativePath: string, repository: string) => string[] | undefined;
 /** Every fact the verifiers check against, gathered once per registration. */
 export declare function buildVerifyContext(state: RunState): Promise<VerifyContext>;
 /**