@skyramp/mcp 0.4.4-rc.2 → 0.5.0-rc.2

package/build/tool-phases.js

@@ -1,25 +1,87 @@
-export const TOOL_PHASE_MAP = {
-    skyramp_recommend_tests: "analyzing",
-    skyramp_analyze_changes: "analyzing",
-    skyramp_register_test_plan: "analyzing",
-    skyramp_smoke_test_generation: "generating",
-    skyramp_fuzz_test_generation: "generating",
-    skyramp_contract_test_generation: "generating",
-    skyramp_load_test_generation: "generating",
-    skyramp_integration_test_generation: "generating",
-    skyramp_e2e_test_generation: "generating",
-    skyramp_ui_test_generation: "generating",
-    skyramp_ui_load_test_generation: "generating",
-    skyramp_batch_scenario_test_generation: "generating",
-    skyramp_mock_generation: "generating",
-    skyramp_batch_mock_generation: "generating",
-    skyramp_generate_enriched_integration_test: "generating",
-    skyramp_enrich_test_with_mocks: "generating",
-    skyramp_execute_test: { before: "maintaining", after: "executing" },
-    skyramp_execute_fleet: { before: "maintaining", after: "executing" },
-    skyramp_analyze_test_health: "maintaining",
-    skyramp_submit_report: "reporting",
+import { ESSENTIAL_TOOLS } from "./playwright/essentialTools.js";
+export const NOT_GATED = "not gated";
+const EXECUTION_PHASE = { before: "maintaining", after: "executing" };
+export const TOOLS = {
+    skyramp_analyze_changes: { phase: "analyzing", entitlement: "analyze" },
+    skyramp_analyze_test_health: {
+        phase: "maintaining",
+        entitlement: "analyze",
+    },
+    // A prompt, not a tool; listed for its phase.
+    skyramp_recommend_tests: { phase: "analyzing", entitlement: "recommend" },
+    skyramp_register_test_plan: { phase: "analyzing", entitlement: "recommend" },
+    skyramp_resolve_screen: { entitlement: "recommend" },
+    skyramp_smoke_test_generation: {
+        phase: "generating",
+        entitlement: "generate",
+    },
+    skyramp_fuzz_test_generation: {
+        phase: "generating",
+        entitlement: "generate",
+    },
+    skyramp_contract_test_generation: {
+        phase: "generating",
+        entitlement: "generate",
+    },
+    skyramp_load_test_generation: {
+        phase: "generating",
+        entitlement: "generate",
+    },
+    skyramp_integration_test_generation: {
+        phase: "generating",
+        entitlement: "generate",
+    },
+    skyramp_e2e_test_generation: { phase: "generating", entitlement: "generate" },
+    skyramp_ui_test_generation: { phase: "generating", entitlement: "generate" },
+    skyramp_ui_load_test_generation: {
+        phase: "generating",
+        entitlement: "generate",
+    },
+    skyramp_batch_scenario_test_generation: {
+        phase: "generating",
+        entitlement: "generate",
+    },
+    skyramp_mock_generation: { phase: "generating", entitlement: "generate" },
+    skyramp_batch_mock_generation: {
+        phase: "generating",
+        entitlement: "generate",
+    },
+    skyramp_generate_enriched_integration_test: {
+        phase: "generating",
+        entitlement: "generate",
+    },
+    skyramp_enrich_test_with_mocks: {
+        phase: "generating",
+        entitlement: "generate",
+    },
+    skyramp_reuse_code: { entitlement: "generate" },
+    skyramp_modularization: { entitlement: "generate" },
+    skyramp_enhance_assertions: { entitlement: "generate" },
+    skyramp_enhance_assertions_snapshot: { entitlement: "generate" },
+    skyramp_verify_enhance_assertions: { entitlement: "generate" },
+    skyramp_align_assertions: { entitlement: "generate" },
+    skyramp_verify_test_dependencies: { entitlement: "generate" },
+    skyramp_fix_errors: { entitlement: "generate" },
+    skyramp_actions: { entitlement: "generate" },
+    skyramp_one_click_tool: { entitlement: "generate" },
+    skyramp_preflight_mock_check: { entitlement: "generate" },
+    skyramp_setup_local_dev_worker: { entitlement: "generate" },
+    skyramp_query_proxy_mocks: { entitlement: "generate" },
+    ...Object.fromEntries([...ESSENTIAL_TOOLS].map((name) => [
+        name,
+        { entitlement: "generate" },
+    ])),
+    skyramp_execute_test: { phase: EXECUTION_PHASE, entitlement: "execute" },
+    skyramp_execute_fleet: { phase: EXECUTION_PHASE, entitlement: "execute" },
+    skyramp_start_trace_collection: { entitlement: "execute" },
+    skyramp_stop_trace_collection: { entitlement: "execute" },
+    skyramp_submit_report: { phase: "reporting", entitlement: NOT_GATED },
+    skyramp_login: { entitlement: NOT_GATED },
+    skyramp_logout: { entitlement: NOT_GATED },
+    skyramp_init_scan: { entitlement: NOT_GATED },
+    skyramp_init_workspace: { entitlement: NOT_GATED },
 };
+export const TOOL_PHASE_MAP = Object.fromEntries(Object.entries(TOOLS).flatMap(([name, entry]) => entry.phase === undefined ? [] : [[name, entry.phase]]));
 /** Tools whose phase depends on context — listed here for consumer discovery. */
 export const CONTEXT_DEPENDENT_TOOLS = new Set(Object.entries(TOOL_PHASE_MAP)
     .filter((entry) => typeof entry[1] === "object")
@@ -28,25 +90,3 @@ export const CONTEXT_DEPENDENT_TOOLS = new Set(Object.entries(TOOL_PHASE_MAP)
 export const GENERATING_TOOLS = new Set(Object.entries(TOOL_PHASE_MAP)
     .filter((entry) => typeof entry[1] === "string" && entry[1] === "generating")
     .map((entry) => entry[0]));
-/** Tools that intentionally have no progress phase (infrastructure/utility). */
-export const TOOLS_WITHOUT_PHASE = new Set([
-    "skyramp_login",
-    "skyramp_logout",
-    "skyramp_init_scan",
-    "skyramp_init_workspace",
-    "skyramp_one_click_tool",
-    "skyramp_setup_local_dev_worker",
-    "skyramp_actions",
-    "skyramp_start_trace_collection",
-    "skyramp_stop_trace_collection",
-    "skyramp_fix_errors",
-    "skyramp_modularization",
-    "skyramp_reuse_code",
-    "skyramp_enhance_assertions",
-    "skyramp_enhance_assertions_snapshot",
-    "skyramp_verify_enhance_assertions",
-    "skyramp_align_assertions",
-    "skyramp_preflight_mock_check",
-    "skyramp_query_proxy_mocks",
-    "skyramp_verify_test_dependencies",
-]);

package/build/tools/workspace/initScanWorkspaceTool.d.ts

@@ -1,4 +1,14 @@
 import { McpServer } from "@modelcontextprotocol/server";
-export declare function issueScanToken(): string;
+import { type ScanRelatedRepository } from "../../prompts/initialize-workspace/initializeWorkspacePrompt.js";
+/** What a scan token was issued for: when it expires, and the related
+ *  repositories its scan named, which skyramp_init_workspace verifies the
+ *  services against. */
+export interface ScanGrant {
+    expiry: number;
+    relatedRepositories: ScanRelatedRepository[];
+}
+export declare function issueScanToken(relatedRepositories?: ScanRelatedRepository[]): string;
+/** The grant of a valid, unexpired token, without consuming it. */
+export declare function scanTokenGrant(token: string): ScanGrant | undefined;
 export declare function validateAndConsumeScanToken(token: string): boolean;
 export declare function registerInitScanWorkspaceTool(server: McpServer): void;

package/build/tools/workspace/initScanWorkspaceTool.js

@@ -1,24 +1,33 @@
 import { z } from "zod";
 import { randomUUID } from "crypto";
+import fs from "fs";
 import { WorkspaceConfigManager } from "../../workspace/workspace.js";
+import { resolveRealPath, tryRepositorySlug, } from "../../utils/repositorySlug.js";
 import { logger } from "../../utils/logger.js";
 import { AnalyticsService } from "../../services/AnalyticsService.js";
-import { INIT_WORKSPACE_INSTRUCTIONS } from "../../prompts/initialize-workspace/initializeWorkspacePrompt.js";
+import { buildInitWorkspaceInstructions, } from "../../prompts/initialize-workspace/initializeWorkspacePrompt.js";
 const TOOL_NAME = "skyramp_init_scan";
-// Token store: token -> expiry timestamp (ms)
 const scanTokens = new Map();
 const TOKEN_TTL_MS = 10 * 60 * 1000; // 10 minutes
-export function issueScanToken() {
+export function issueScanToken(relatedRepositories = []) {
     const token = randomUUID();
-    scanTokens.set(token, Date.now() + TOKEN_TTL_MS);
+    scanTokens.set(token, {
+        expiry: Date.now() + TOKEN_TTL_MS,
+        relatedRepositories,
+    });
     return token;
 }
+/** The grant of a valid, unexpired token, without consuming it. */
+export function scanTokenGrant(token) {
+    const grant = scanTokens.get(token);
+    return grant && Date.now() < grant.expiry ? grant : undefined;
+}
 export function validateAndConsumeScanToken(token) {
-    const expiry = scanTokens.get(token);
-    if (!expiry)
+    const grant = scanTokens.get(token);
+    if (!grant)
         return false;
     scanTokens.delete(token);
-    return Date.now() < expiry;
+    return Date.now() < grant.expiry;
 }
 const initScanWorkspaceSchema = z.object({
     workspacePath: z.string().describe("Path to the workspace/repository root"),
@@ -26,12 +35,66 @@ const initScanWorkspaceSchema = z.object({
         .boolean()
         .default(false)
         .describe("Set to true to force a re-scan even if .skyramp/workspace.yml already exists. Default is false."),
+    relatedRepositories: z
+        .array(z.object({
+        repositoryPath: z
+            .string()
+            .describe("Path to the related repository's checkout"),
+        repository: z
+            .string()
+            .optional()
+            .describe("The related repository's owner/repo. Defaults to the one its checkout's origin remote names."),
+    }))
+        .optional()
+        .describe("The other repositories of a multi-repository Target. Each is scanned into the one workspace.yml at workspacePath, its services carrying its owner/repo as `repository`; none gets a workspace.yml of its own. Omit for a single repository."),
+    testRepositoryPath: z
+        .string()
+        .optional()
+        .describe("Path to the separate test repository generated tests are delivered into, when there is one. Each service's testDirectory is then read from, and relative to, that checkout."),
 });
+const OWNER_REPO = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+function isDirectory(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Each related repository with its owner/repo, or the first problem with them:
+ * a checkout that is not a directory, is the workspace itself, or names no
+ * owner/repo, and a repository listed twice. Paths compare with symlinks
+ * resolved, and owner/repo case-insensitively, as GitHub does.
+ */
+async function resolveRelatedRepositories(workspacePath, entries) {
+    const repos = [];
+    const workspaceReal = await resolveRealPath(workspacePath);
+    for (const entry of entries) {
+        const at = entry.repositoryPath;
+        if (!isDirectory(at))
+            return { error: `relatedRepositories: ${at} is not a directory` };
+        if ((await resolveRealPath(at)) === workspaceReal)
+            return {
+                error: `relatedRepositories: ${at} is workspacePath itself; list only the other repositories`,
+            };
+        const repository = entry.repository?.trim() || (await tryRepositorySlug(at));
+        if (!repository || !OWNER_REPO.test(repository))
+            return {
+                error: `relatedRepositories: no owner/repo for ${at}${repository ? ` ("${repository}" is not owner/repo)` : " (its checkout has no origin remote)"}; pass its repository`,
+            };
+        if (repos.some((r) => r.repository.toLowerCase() === repository.toLowerCase()))
+            return { error: `relatedRepositories: ${repository} is listed twice` };
+        repos.push({ repository, repositoryPath: at });
+    }
+    return { repos };
+}
 export function registerInitScanWorkspaceTool(server) {
     server.registerTool(TOOL_NAME, {
         description: "Call this FIRST, before any other Skyramp tool (test generation, execution, analysis), whenever workspacePath is a git repository and .skyramp/workspace.yml does not exist at its root. " +
             "PREREQUISITE for skyramp_init_workspace. " +
             "Scans a repository and returns instructions for discovering all services, along with a scanToken. " +
+            "For a Target spanning several repositories, call it ONCE with the others in relatedRepositories, so all their services go into one workspace.yml. " +
             "Follow the instructions to build the services array, then pass both to skyramp_init_workspace to create the workspace config.",
         inputSchema: initScanWorkspaceSchema,
     }, async (params) => {
@@ -39,6 +102,8 @@ export function registerInitScanWorkspaceTool(server) {
         const recordParams = {
             workspacePath: params.workspacePath,
             force: String(params.force || false),
+            relatedRepositories: String(params.relatedRepositories?.length ?? 0),
+            testRepository: String(Boolean(params.testRepositoryPath)),
         };
         try {
             const manager = new WorkspaceConfigManager(params.workspacePath);
@@ -53,12 +118,38 @@ export function registerInitScanWorkspaceTool(server) {
                     isError: false,
                 };
             }
-            const token = issueScanToken();
+            const related = await resolveRelatedRepositories(params.workspacePath, params.relatedRepositories ?? []);
+            if ("error" in related) {
+                errorResult = {
+                    content: [{ type: "text", text: related.error }],
+                    isError: true,
+                };
+                return errorResult;
+            }
+            if (params.testRepositoryPath &&
+                !isDirectory(params.testRepositoryPath)) {
+                errorResult = {
+                    content: [
+                        {
+                            type: "text",
+                            text: `testRepositoryPath: ${params.testRepositoryPath} is not a directory`,
+                        },
+                    ],
+                    isError: true,
+                };
+                return errorResult;
+            }
+            const token = issueScanToken(related.repos);
+            const instructions = buildInitWorkspaceInstructions({
+                workspacePath: params.workspacePath,
+                relatedRepositories: related.repos,
+                testRepositoryPath: params.testRepositoryPath,
+            });
             return {
                 content: [
                     {
                         type: "text",
-                        text: `SCAN TOKEN: ${token}\n\nSave this token — you MUST pass it as scanToken when calling skyramp_init_workspace.\n\n${INIT_WORKSPACE_INSTRUCTIONS}`,
+                        text: `SCAN TOKEN: ${token}\n\nSave this token — you MUST pass it as scanToken when calling skyramp_init_workspace.\n\n${instructions}`,
                     },
                 ],
                 isError: false,

package/build/tools/workspace/initializeWorkspaceTool.js

@@ -7,7 +7,8 @@ import yaml from "js-yaml";
 import { logger } from "../../utils/logger.js";
 import { AnalyticsService } from "../../services/AnalyticsService.js";
 import { SKYRAMP_IMAGE_VERSION } from "../../utils/versions.js";
-import { validateAndConsumeScanToken } from "./initScanWorkspaceTool.js";
+import { scanTokenGrant, validateAndConsumeScanToken, } from "./initScanWorkspaceTool.js";
+import { verifyWorkspaceServices } from "../../workspace/workspaceVerifier.js";
 import { upsertServicesByRepo } from "./serviceUpsert.js";
 import { isInsideDir } from "../../utils/gitStaging.js";
 import { EXECUTOR_VIDEOS_DIR, EXECUTOR_WORK_DIR, isInsideExecutorWorkDir, } from "../../utils/executorWorkDir.js";
@@ -110,7 +111,7 @@ export function registerInitializeWorkspaceTool(server) {
             "1. Fresh init: PREREQUISITE: Call skyramp_init_scan first to get a scanToken and discover services. " +
             "Then call this tool to write .skyramp/workspace.yml with the discovered services and scanToken. " +
             "2. Edit existing workspace.yml: omit scanToken, set force: true, and pass the FULL updated services array (overwrite, not merge — fields not in the array are dropped). " +
-            "The services schema is strict: any field not in the schema (e.g. inventing `serverStopCommand` on `runtimeDetails`) fails validation and the call is rejected.",
+            "The services schema is strict: any field not in the schema (e.g. inventing `healthUrl` on `runtimeDetails`) fails validation and the call is rejected.",
         inputSchema: initializeWorkspaceSchema,
         _meta: {
             keywords: [
@@ -182,11 +183,46 @@ export function registerInitializeWorkspaceTool(server) {
                 if (badMerged)
                     return badTestDirectoryResult(badMerged);
             }
+            // The verifier, before the token is spent: a refusal asks for a
+            // corrected retry, which must be able to reuse the same token. Only the
+            // incoming services: a merge must not be blocked by an older entry.
+            const grant = params.scanToken
+                ? scanTokenGrant(params.scanToken)
+                : undefined;
+            const issues = verifyWorkspaceServices(params.services, {
+                workspacePath,
+                relatedRepositories: grant?.relatedRepositories,
+            });
+            if (issues.length > 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `${manager.getConfigPath()} was not written: ${issues.length} problem(s) with the services.\n${issues.map((i) => `- ${i}`).join("\n")}\nFix each one and call skyramp_init_workspace again with the full corrected services array${grant ? " and the same scanToken, which is still valid" : ""}.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
             // scanToken is required for fresh init; for edits (force:true on an
             // existing workspace.yml) the caller supplies the full services array
-            // directly and we skip the token check.
+            // directly and no token is needed. A token passed with an edit is still
+            // validated and spent, so a successful write never leaves it reusable.
             const isEdit = alreadyExists && params.force;
-            if (!isEdit) {
+            if (isEdit && params.scanToken) {
+                if (!validateAndConsumeScanToken(params.scanToken)) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "Invalid or expired scanToken. An edit of an existing workspace.yml needs none: call again with force: true and no scanToken.",
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+            }
+            else if (!isEdit) {
                 if (!params.scanToken) {
                     return {
                         content: [

package/build/utils/versions.d.ts

@@ -1,4 +1,4 @@
-export declare const SKYRAMP_IMAGE_VERSION = "v1.3.50";
-export declare const EXECUTOR_DOCKER_IMAGE = "skyramp/executor:v1.3.50";
-export declare const WORKER_DOCKER_IMAGE = "skyramp/worker:v1.3.50";
+export declare const SKYRAMP_IMAGE_VERSION = "v1.3.51";
+export declare const EXECUTOR_DOCKER_IMAGE = "skyramp/executor:v1.3.51";
+export declare const WORKER_DOCKER_IMAGE = "skyramp/worker:v1.3.51";
 export declare const WORKER_CONTROL_PORT = 35142;

package/build/utils/versions.js

@@ -1,4 +1,4 @@
-export const SKYRAMP_IMAGE_VERSION = "v1.3.50";
+export const SKYRAMP_IMAGE_VERSION = "v1.3.51";
 export const EXECUTOR_DOCKER_IMAGE = `skyramp/executor:${SKYRAMP_IMAGE_VERSION}`;
 export const WORKER_DOCKER_IMAGE = `skyramp/worker:${SKYRAMP_IMAGE_VERSION}`;
 // Control port the Skyramp worker listens on (SDK `CONTAINER_PORT`).

package/build/workspace/workspace.d.ts

@@ -5,24 +5,8 @@ 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: "python";
-        typescript: "typescript";
-        javascript: "javascript";
-        java: "java";
-    }>>;
-    framework: z.ZodOptional<z.ZodEnum<{
-        playwright: "playwright";
-        pytest: "pytest";
-        robot: "robot";
-        junit: "junit";
-        vitest: "vitest";
-        jest: "jest";
-        mocha: "mocha";
-        go: "go";
-        rspec: "rspec";
-        jasmine: "jasmine";
-    }>>;
+    language: z.ZodOptional<z.ZodString>;
+    framework: z.ZodOptional<z.ZodString>;
     testDirectory: z.ZodOptional<z.ZodString>;
     api: z.ZodOptional<z.ZodObject<{
         schemaPath: z.ZodOptional<z.ZodString>;
@@ -46,49 +30,30 @@ export declare const serviceSchema: z.ZodObject<{
         baseUrl: z.ZodOptional<z.ZodString>;
         skipTLSVerify: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
-    runtimeDetails: z.ZodOptional<z.ZodObject<{
+    runtimeDetails: z.ZodOptional<z.ZodPipe<z.ZodObject<{
         serverStartCommand: z.ZodOptional<z.ZodString>;
         serverStopCommand: z.ZodOptional<z.ZodString>;
         runtime: z.ZodPreprocess<z.ZodEnum<typeof 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.ZodPipe<z.ZodObject<{
-            framework: z.ZodOptional<z.ZodEnum<{
-                playwright: "playwright";
-                pytest: "pytest";
-                robot: "robot";
-                junit: "junit";
-                vitest: "vitest";
-                jest: "jest";
-                mocha: "mocha";
-                go: "go";
-                rspec: "rspec";
-                jasmine: "jasmine";
-            }>>;
-            testRunCommand: z.ZodString;
-            pathGlobs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            canaryStatus: z.ZodOptional<z.ZodEnum<{
-                proven: "proven";
-                unproven: "unproven";
-            }>>;
-            canaryDetail: z.ZodOptional<z.ZodString>;
-            testEnv: z.ZodOptional<z.ZodUnknown>;
-        }, z.core.$strict>, z.ZodTransform<{
-            testRunCommand: string;
-            framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | 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;
-            pathGlobs?: string[] | undefined;
-            canaryStatus?: "proven" | "unproven" | undefined;
-            canaryDetail?: string | undefined;
-            testEnv?: unknown;
-        }>>>>;
-    }, z.core.$strict>>;
+        testSuites: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strict>, z.ZodTransform<{
+        runtime: import("../types/TestTypes.js").RuntimeEnvironment;
+        serverStartCommand?: string | undefined;
+        serverStopCommand?: string | undefined;
+        dockerNetwork?: string | undefined;
+        k8sNamespace?: string | undefined;
+        k8sContext?: string | undefined;
+    }, {
+        runtime: import("../types/TestTypes.js").RuntimeEnvironment;
+        serverStartCommand?: string | undefined;
+        serverStopCommand?: string | undefined;
+        dockerNetwork?: string | undefined;
+        k8sNamespace?: string | undefined;
+        k8sContext?: string | undefined;
+        testSuites?: unknown;
+    }>>>;
 }, z.core.$strict>;
 export declare const workspaceConfigSchema: z.ZodObject<{
     workspace: z.ZodOptional<z.ZodObject<{
@@ -105,24 +70,8 @@ export declare const workspaceConfigSchema: z.ZodObject<{
     services: z.ZodOptional<z.ZodArray<z.ZodObject<{
         serviceName: z.ZodString;
         repository: z.ZodOptional<z.ZodString>;
-        language: z.ZodOptional<z.ZodEnum<{
-            python: "python";
-            typescript: "typescript";
-            javascript: "javascript";
-            java: "java";
-        }>>;
-        framework: z.ZodOptional<z.ZodEnum<{
-            playwright: "playwright";
-            pytest: "pytest";
-            robot: "robot";
-            junit: "junit";
-            vitest: "vitest";
-            jest: "jest";
-            mocha: "mocha";
-            go: "go";
-            rspec: "rspec";
-            jasmine: "jasmine";
-        }>>;
+        language: z.ZodOptional<z.ZodString>;
+        framework: z.ZodOptional<z.ZodString>;
         testDirectory: z.ZodOptional<z.ZodString>;
         api: z.ZodOptional<z.ZodObject<{
             schemaPath: z.ZodOptional<z.ZodString>;
@@ -146,55 +95,35 @@ export declare const workspaceConfigSchema: z.ZodObject<{
             baseUrl: z.ZodOptional<z.ZodString>;
             skipTLSVerify: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
-        runtimeDetails: z.ZodOptional<z.ZodObject<{
+        runtimeDetails: z.ZodOptional<z.ZodPipe<z.ZodObject<{
             serverStartCommand: z.ZodOptional<z.ZodString>;
             serverStopCommand: z.ZodOptional<z.ZodString>;
             runtime: z.ZodPreprocess<z.ZodEnum<typeof 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.ZodPipe<z.ZodObject<{
-                framework: z.ZodOptional<z.ZodEnum<{
-                    playwright: "playwright";
-                    pytest: "pytest";
-                    robot: "robot";
-                    junit: "junit";
-                    vitest: "vitest";
-                    jest: "jest";
-                    mocha: "mocha";
-                    go: "go";
-                    rspec: "rspec";
-                    jasmine: "jasmine";
-                }>>;
-                testRunCommand: z.ZodString;
-                pathGlobs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                canaryStatus: z.ZodOptional<z.ZodEnum<{
-                    proven: "proven";
-                    unproven: "unproven";
-                }>>;
-                canaryDetail: z.ZodOptional<z.ZodString>;
-                testEnv: z.ZodOptional<z.ZodUnknown>;
-            }, z.core.$strict>, z.ZodTransform<{
-                testRunCommand: string;
-                framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | 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;
-                pathGlobs?: string[] | undefined;
-                canaryStatus?: "proven" | "unproven" | undefined;
-                canaryDetail?: string | undefined;
-                testEnv?: unknown;
-            }>>>>;
-        }, z.core.$strict>>;
+            testSuites: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strict>, z.ZodTransform<{
+            runtime: import("../types/TestTypes.js").RuntimeEnvironment;
+            serverStartCommand?: string | undefined;
+            serverStopCommand?: string | undefined;
+            dockerNetwork?: string | undefined;
+            k8sNamespace?: string | undefined;
+            k8sContext?: string | undefined;
+        }, {
+            runtime: import("../types/TestTypes.js").RuntimeEnvironment;
+            serverStartCommand?: string | undefined;
+            serverStopCommand?: string | undefined;
+            dockerNetwork?: string | undefined;
+            k8sNamespace?: string | undefined;
+            k8sContext?: string | undefined;
+            testSuites?: unknown;
+        }>>>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;
 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"]>;
@@ -214,8 +143,8 @@ export declare function validateWorkspaceConfig(config: unknown): z.ZodSafeParse
     services?: {
         serviceName: string;
         repository?: string | undefined;
-        language?: "python" | "typescript" | "javascript" | "java" | undefined;
-        framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
+        language?: string | undefined;
+        framework?: string | undefined;
         testDirectory?: string | undefined;
         api?: {
             schemaPath?: string | undefined;
@@ -237,13 +166,6 @@ export declare function validateWorkspaceConfig(config: unknown): z.ZodSafeParse
             dockerNetwork?: string | undefined;
             k8sNamespace?: string | undefined;
             k8sContext?: string | undefined;
-            testSuites?: {
-                testRunCommand: string;
-                framework?: "playwright" | "pytest" | "robot" | "junit" | "vitest" | "jest" | "mocha" | "go" | "rspec" | "jasmine" | undefined;
-                pathGlobs?: string[] | undefined;
-                canaryStatus?: "proven" | "unproven" | undefined;
-                canaryDetail?: string | undefined;
-            }[] | undefined;
         } | undefined;
     }[] | undefined;
 }>;
@@ -273,9 +195,17 @@ export declare class WorkspaceConfigManager {
     /**
      * Initialize workspace — creates .skyramp/workspace.yml with repo info.
      * Auto-detects repoName and repoUrl from git when not provided.
-     * Produces an empty services array and default metadata timestamps.
+     * Produces an empty services array and default metadata timestamps. Over an
+     * existing file it keeps that file's createdAt: the workspace was created
+     * then, however often it is rewritten.
      */
     initialize(workspaceInfo?: WorkspaceSection): Promise<WorkspaceConfig>;
+    /**
+     * The existing file's metadata.createdAt, read leniently: a rewrite is often
+     * the repair of a file that no longer validates, and its createdAt still
+     * stands. Undefined when there is no file or it records none.
+     */
+    private existingCreatedAt;
     /**
      * Update the metadata section of an existing workspace config.
      * Only the provided fields are merged; metadata.updatedAt is refreshed