@skyramp/mcp 0.4.1 → 0.4.2-rc.2

package/build/utils/screenRoutes.js

@@ -39,7 +39,16 @@ import { extractSourceRoutes } from "./sourceRouteExtractor.js";
 /** Files that can import, and therefore render, a frontend module. */
 const FRONTEND_SOURCE_EXT = /\.(ts|tsx|js|jsx|mjs|cjs|vue|svelte|dart)$/i;
 const SKIP_DIRS = new Set([
-    "node_modules", ".git", "dist", "build", "out", ".next", ".nuxt", ".svelte-kit", "coverage", "vendor",
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    "out",
+    ".next",
+    ".nuxt",
+    ".svelte-kit",
+    "coverage",
+    "vendor",
 ]);
 /** Walk cap. Hitting it means the index is incomplete, and an incomplete index
  *  cannot honestly say "nothing mounts this" — the whole repository answers
@@ -65,7 +74,9 @@ function toPosix(value) {
     return value.replace(/\\/g, "/");
 }
 function stripExtension(file) {
-    return /\.d\.ts$/i.test(file) ? file.slice(0, -5) : file.slice(0, file.length - path.posix.extname(file).length);
+    return /\.d\.ts$/i.test(file)
+        ? file.slice(0, -5)
+        : file.slice(0, file.length - path.posix.extname(file).length);
 }
 /** The strings an import specifier can use to name this file: the file itself, the
  *  file without its extension, and for an `index.*` module its directory. */
@@ -94,7 +105,9 @@ function normalizeRelative(relativePath) {
  *  and this index is keyed by the stem instead because the specifier is already
  *  isolated by the time we get here. */
 function stemKeys(file) {
-    return [...new Set(buildPathSignatures(file).map((signature) => signature.slice(0, -1)))];
+    return [
+        ...new Set(buildPathSignatures(file).map((signature) => signature.slice(0, -1))),
+    ];
 }
 /**
  * The candidate repository paths an import specifier could name.
@@ -125,8 +138,11 @@ function specifierCandidates(spec) {
     if (segments.length === 1)
         return { relative: false, paths: [] };
     const paths = [clean];
-    const scopedPackageShape = segments[0].length > 1 && segments[0].startsWith("@") && segments.length < 3;
-    if (!scopedPackageShape && (/^[@~#]/.test(segments[0]) || segments[0] === "src")) {
+    const scopedPackageShape = segments[0].length > 1 &&
+        segments[0].startsWith("@") &&
+        segments.length < 3;
+    if (!scopedPackageShape &&
+        (/^[@~#]/.test(segments[0]) || segments[0] === "src")) {
         paths.push(segments.slice(1).join("/"));
     }
     return { relative: false, paths };
@@ -217,7 +233,11 @@ function readTanStackRouteTree(repositoryPath, treeFile, filesByStem) {
         }
         const preLoader = /^\s*preLoaderRoute:\s*typeof\s+(\w+)/.exec(line);
         if (preLoader && pendingId !== undefined && pendingFullPath !== undefined) {
-            blocks.push({ id: pendingId, fullPath: pendingFullPath, ident: preLoader[1] });
+            blocks.push({
+                id: pendingId,
+                fullPath: pendingFullPath,
+                ident: preLoader[1],
+            });
             pendingId = undefined;
             pendingFullPath = undefined;
         }
@@ -316,7 +336,9 @@ function flutterPackages(repositoryPath) {
     for (const parent of PUBSPEC_MONOREPO_PARENTS) {
         let entries;
         try {
-            entries = fs.readdirSync(path.join(repositoryPath, parent), { withFileTypes: true });
+            entries = fs.readdirSync(path.join(repositoryPath, parent), {
+                withFileTypes: true,
+            });
         }
         catch {
             continue;
@@ -360,7 +382,9 @@ function dartPackagePath(spec, packages) {
 export function frameworkRouteFor(relativePath, framework) {
     // Next.js and Nuxt accept their routing directory at the root or under `src/`,
     // and neither spelling appears in the URL.
-    const below = relativePath.startsWith("src/") ? relativePath.slice(4) : relativePath;
+    const below = relativePath.startsWith("src/")
+        ? relativePath.slice(4)
+        : relativePath;
     switch (framework) {
         case "next":
             return nextRoute(below);
@@ -381,7 +405,9 @@ function bracketParam(segment) {
 /** Segments the Next app router organises the tree with and leaves out of the
  *  URL: route groups `(shop)`, private folders `_internal`, slots `@modal`. */
 function isNextAppOrganisingSegment(segment) {
-    return /^\(.+\)$/.test(segment) || segment.startsWith("_") || segment.startsWith("@");
+    return (/^\(.+\)$/.test(segment) ||
+        segment.startsWith("_") ||
+        segment.startsWith("@"));
 }
 function nextRoute(below) {
     const app = /^app\/(.*)$/.exec(below);
@@ -394,7 +420,11 @@ function nextRoute(below) {
         // `template`, `loading`, `error` and `not-found` wrap a page without being one.
         if (segments.pop() !== "page")
             return undefined;
-        return "/" + segments.filter((s) => !isNextAppOrganisingSegment(s)).map(bracketParam).join("/");
+        return ("/" +
+            segments
+                .filter((s) => !isNextAppOrganisingSegment(s))
+                .map(bracketParam)
+                .join("/"));
     }
     const pages = /^pages\/(.*)$/.exec(below);
     if (!pages)
@@ -411,14 +441,22 @@ function nextRoute(below) {
         return undefined;
     // No route groups in this router — `(shop)` is a literal directory name.
     const segments = stem.replace(/(?:^|\/)index$/, "").split("/");
-    return "/" + segments.filter((s) => s !== "").map(bracketParam).join("/");
+    return ("/" +
+        segments
+            .filter((s) => s !== "")
+            .map(bracketParam)
+            .join("/"));
 }
 function nuxtRoute(below) {
     const pages = /^pages\/(.*)\.vue$/.exec(below);
     if (!pages)
         return undefined;
     const segments = pages[1].replace(/(?:^|\/)index$/, "").split("/");
-    return "/" + segments.filter((s) => s !== "").map(nuxtParam).join("/");
+    return ("/" +
+        segments
+            .filter((s) => s !== "")
+            .map(nuxtParam)
+            .join("/"));
 }
 /** Nuxt 3 spells a parameter `[id]`, Nuxt 2 spells it `_id`. The underscore names
  *  one only as the WHOLE segment: a blanket rule made `order_total` `/order:total`. */
@@ -438,7 +476,11 @@ function svelteKitRoute(below) {
     if (segments.pop() !== "+page.svelte")
         return undefined;
     // The one non-Next framework with route groups, spelled the same way.
-    return "/" + segments.filter((s) => !/^\(.+\)$/.test(s)).map(svelteParam).join("/");
+    return ("/" +
+        segments
+            .filter((s) => !/^\(.+\)$/.test(s))
+            .map(svelteParam)
+            .join("/"));
 }
 /** SvelteKit adds an optional parameter, `[[lang]]`, to the bracket spellings. */
 function svelteParam(segment) {
@@ -476,7 +518,9 @@ function fileSystemRouteEntries(files) {
  *  through the stem index first: the route tree names hundreds of entry files, and
  *  comparing each against every file in the repository is quadratic. */
 function resolveWithin(dir, spec, filesByStem) {
-    const base = spec.startsWith(".") ? path.posix.normalize(path.posix.join(dir, spec)) : spec;
+    const base = spec.startsWith(".")
+        ? path.posix.normalize(path.posix.join(dir, spec))
+        : spec;
     const lastSegment = base.split("/").pop();
     if (!lastSegment)
         return undefined;
@@ -515,7 +559,9 @@ function collectRouteEntries(repositoryPath, files, fileSet, filesByStem, packag
     }
     if (packages.size > 0) {
         for (const route of extractDartRoutes(repositoryPath)) {
-            const relative = route.componentFile ? toPosix(path.relative(repositoryPath, route.componentFile)) : undefined;
+            const relative = route.componentFile
+                ? toPosix(path.relative(repositoryPath, route.componentFile))
+                : undefined;
             // A widget this reader could not trace to a file leaves the table short of
             // a route, the same way an unresolved web component does.
             if (relative && fileSet.has(relative))
@@ -533,7 +579,9 @@ function collectRouteEntries(repositoryPath, files, fileSet, filesByStem, packag
     for (const route of extractSourceRoutes(repositoryPath)) {
         if (!route.path)
             continue;
-        const relative = route.componentFile ? toPosix(path.relative(repositoryPath, route.componentFile)) : undefined;
+        const relative = route.componentFile
+            ? toPosix(path.relative(repositoryPath, route.componentFile))
+            : undefined;
         if (relative && fileSet.has(relative)) {
             entries.push({ pattern: route.path, entryFile: relative });
             continue;
@@ -601,7 +649,13 @@ function buildIndex(repositoryPath) {
             }
         }
     }
-    return { fileSet, importers, patternsByEntry, tableComplete: table.complete, importsComplete };
+    return {
+        fileSet,
+        importers,
+        patternsByEntry,
+        tableComplete: table.complete,
+        importsComplete,
+    };
 }
 // ── Query ───────────────────────────────────────────────────────────────────
 function candidatesFor(index, file) {
@@ -708,7 +762,9 @@ export function createScreenRouteLookup(repositoryPath) {
 /** The routes for a file, without the evidence. */
 export function createScreenRouteResolver(repositoryPath) {
     const lookup = createScreenRouteLookup(repositoryPath);
-    return (relativePath) => lookup.candidatesFor(relativePath)?.map((candidate) => candidate.routePattern);
+    return (relativePath) => lookup
+        .candidatesFor(relativePath)
+        ?.map((candidate) => candidate.routePattern);
 }
 /** The same answer with its evidence: every route, and the import chain that
  *  reaches the file from that route's entry file. */

package/build/utils/skyrampMdContent.d.ts

@@ -2,4 +2,4 @@
  * Skill content for skyramp.md — installed at auto-discovery paths: ~/.claude/skills/skyramp/SKILLS.md, ~/.cursor/skills/skyramp/SKILLS.md, ~/.github/skills/skyramp.md
  * Follows the SKILL.md specification: https://agentskills.io/what-are-skills#the-skill-md-file
  */
-export declare const SKYRAMP_MD_CONTENT = "---\nname: skyramp\ndescription: Generate, execute, and maintain API tests (smoke, contract, fuzz, load, integration, E2E, UI) using Skyramp MCP tools.\n---\n\n# Skyramp\n\n## When to use this skill\nUse this skill whenever the user asks to generate, run, or maintain API tests. Always read `<workspace-root>/.skyramp/workspace.yml` first to get `language`, `framework`, `outputDir`, and `api.baseUrl` \u2014 do not ask the user for values already present.\n\n---\n\n## Tools\n\n### Workspace Setup\n1. **`skyramp_initialize_workspace`** \u2014 Create or update `.skyramp/workspace.yml` in a git repository workspace. Scan the repo for all services before calling. Required before any other Skyramp tool.\n\n### Test Generation\n2. **`skyramp_smoke_test_generation`** \u2014 Verify an endpoint is reachable and returns a valid response.\n3. **`skyramp_contract_test_generation`** \u2014 Validate implementation matches OpenAPI/Swagger schema.\n4. **`skyramp_fuzz_test_generation`** \u2014 Send malformed or boundary inputs to find edge cases and security issues.\n5. **`skyramp_load_test_generation`** \u2014 Test performance under concurrent load. Optional: `loadDuration`, `loadNumThreads`. Accepts `trace` instead of `apiSchema`/`endpointURL`.\n6. **`skyramp_integration_test_generation`** \u2014 Multi-step workflows across one or more services. Supply one of: `apiSchema`+`endpointURL`, `trace`, or `scenarioFile`. Do not combine them.\n7. **`skyramp_e2e_test_generation`** \u2014 Full user journey covering UI and backend. Requires `trace` and `playwrightInput` zip. Do not pass `apiSchema` or `endpointURL`.\n8. **`skyramp_ui_test_generation`** \u2014 UI-only tests from Playwright recordings. Requires `playwrightInput` zip.\n\n### Trace Generation\n9. **`skyramp_start_trace_collection`** \u2014 Start capturing backend traffic. Set `playwright: true` for UI or E2E tests. Use an absolute path for `outputDir`.\n10. **`skyramp_stop_trace_collection`** \u2014 Stop capture and save the trace. Use the same `outputDir` and `playwrightEnabled` values as start.\n11. **`skyramp_scenario_test_generation`** \u2014 Scenario trace generation. Describe a multi-step flow in natural language to produce a scenario file. Pass output to `skyramp_integration_test_generation` via `scenarioFile`.\n\n### Test Execution\n12. **`skyramp_execute_test`** \u2014 Run a single Skyramp-generated test file. Required: `workspacePath`, `language`, `testType`, `testFile`. Optional: `stateFile` (writes execution results back for health analysis). For multiple tests, call sequentially to avoid env var conflicts.\n\n### Test Analysis & Maintenance\n13. **`skyramp_analyze_changes`** \u2014 Unified entry point: scans endpoints, discovers tests, computes diff. Takes `repositoryPath` and `scope`. Returns `stateFile` + recommendations.\n14. **`skyramp_analyze_test_health`** \u2014 Drift and health assessment for existing tests. Takes `stateFile`. Returns LLM prompt for scoring.\n15. **`skyramp_actions`** \u2014 Execute UPDATE / REGENERATE / VERIFY / DELETE actions. Takes `stateFile`. Call after analyze_test_health.\n\n### Code Quality\n16. **`skyramp_fix_errors`** \u2014 Fix compilation or runtime errors in a generated test file.\n17. **`skyramp_modularization`** \u2014 Refactor a test file into reusable modules. Set `isTraceBased: true` for trace-based tests.\n18. **`skyramp_reuse_code`** \u2014 Pull shared helpers from other Skyramp tests. Only when `code_reuse` was `true` at generation time.\n\n### Authentication\n19. **`skyramp_login`** \u2014 Log in to the Skyramp platform.\n20. **`skyramp_logout`** \u2014 Log out from the Skyramp platform.\n\n---\n\n## Prompts\n\nPrefer invoking a prompt over manually chaining tools \u2014 prompts run the full workflow automatically.\n\n- **`skyramp_trace_prompt`** \u2014 Trace collection setup and execution.\n- **`skyramp_test_health_analysis`** \u2014 Full maintenance flow (discover \u2192 drift \u2192 health \u2192 actions).\n- **`skyramp_testbot`** \u2014 PR-scoped recommendations + maintenance + report. Required: `prTitle`, `prDescription`, `repositoryPath`.\n\n---\n\n## Workflows\n\nUse these when a prompt is not available.\n\n**Generate and run a test**\nRead `.skyramp/workspace.yml` \u2192 Call appropriate generation tool \u2192 `skyramp_execute_test`\n\n**Trace-based test (integration / load / E2E / UI)**\n`skyramp_start_trace_collection` (set `playwright: true` for UI/E2E) \u2192 User exercises the app \u2192 `skyramp_stop_trace_collection` \u2192 Call target generation tool with `trace` (and `playwrightInput` for E2E/UI)\n\n**Scenario \u2192 integration test**\n`skyramp_scenario_test_generation` \u2192 `skyramp_integration_test_generation` with `scenarioFile`\n\n**Recommend tests for a PR**\n`skyramp_analyze_changes` (with `scope: \"branch_diff\"`) \u2192 follow enrichment steps \u2192 `skyramp_recommend_tests` \u2192 Generate recommended tests\n\n**Maintain existing tests**\n`skyramp_analyze_changes` \u2192 `skyramp_analyze_test_health` \u2192 *(optional)* execute tests via `skyramp_execute_test` with `stateFile` param (writes results back) \u2192 `skyramp_actions` (do not skip)\n\n---\n\n## Conventions\n\n- **`endpointURL`** \u2014 Full URL to a specific endpoint, not just the base URL. Build from `api.baseUrl` + path (e.g. `http://localhost:8000/api/v1/users`).\n- **`outputDir`** \u2014 Use absolute paths for both test output and trace collection.\n- **Mutually exclusive inputs** \u2014 `apiSchema`/`endpointURL`, `trace`, and `scenarioFile` are mutually exclusive for integration and load tests. Use exactly one.\n- **Sequential execution** \u2014 Execute tests sequentially (not in parallel) to avoid environment variable conflicts with `SKYRAMP_TEST_BASE_URL`.\n";
+export declare const SKYRAMP_MD_CONTENT = "---\nname: skyramp\ndescription: Generate, execute, and maintain API tests (smoke, contract, fuzz, load, integration, E2E, UI) using Skyramp MCP tools.\n---\n\n# Skyramp\n\n## When to use this skill\nUse this skill whenever the user asks to generate, run, or maintain API tests. Always read `<workspace-root>/.skyramp/workspace.yml` first to get `language`, `framework`, `outputDir`, and `api.baseUrl` \u2014 do not ask the user for values already present.\n\n---\n\n## Tools\n\n### Workspace Setup\n1. **`skyramp_initialize_workspace`** \u2014 Create or update `.skyramp/workspace.yml` in a git repository workspace. Scan the repo for all services before calling. Required before any other Skyramp tool.\n\n### Test Generation\n2. **`skyramp_smoke_test_generation`** \u2014 Verify an endpoint is reachable and returns a valid response.\n3. **`skyramp_contract_test_generation`** \u2014 Validate implementation matches OpenAPI/Swagger schema.\n4. **`skyramp_fuzz_test_generation`** \u2014 Send malformed or boundary inputs to find edge cases and security issues.\n5. **`skyramp_load_test_generation`** \u2014 Test performance under concurrent load. Optional: `loadDuration`, `loadNumThreads`. Accepts `trace` instead of `apiSchema`/`endpointURL`.\n6. **`skyramp_integration_test_generation`** \u2014 Multi-step workflows across one or more services. Supply one of: `apiSchema`+`endpointURL`, `trace`, or `scenarioFile`. Do not combine them.\n7. **`skyramp_e2e_test_generation`** \u2014 Full user journey covering UI and backend. Requires `trace` and `playwrightInput` zip. Do not pass `apiSchema` or `endpointURL`.\n8. **`skyramp_ui_test_generation`** \u2014 UI-only tests from Playwright recordings. Requires `playwrightInput` zip.\n\n### Trace Generation\n9. **`skyramp_start_trace_collection`** \u2014 Start capturing backend traffic. Set `playwright: true` for UI or E2E tests. Use an absolute path for `outputDir`.\n10. **`skyramp_stop_trace_collection`** \u2014 Stop capture and save the trace. Use the same `outputDir` and `playwrightEnabled` values as start.\n11. **`skyramp_scenario_test_generation`** \u2014 Scenario trace generation. Describe a multi-step flow in natural language to produce a scenario file. Pass output to `skyramp_integration_test_generation` via `scenarioFile`.\n\n### Test Execution\n12. **`skyramp_execute_test`** \u2014 Run one test file and record the verdict from the exit code. Required: `testFile`, `language`, `testType`, `repository`. To run on this host, pass `commandOverride` (the command for that one file) with `cwd`. Omit `commandOverride` to run in the Skyramp executor instead, which needs `workspacePath`. Optional: `stateFile` (writes execution results back for health analysis). Output is capped at the last 200,000 characters.\n\n### Test Analysis & Maintenance\n13. **`skyramp_analyze_changes`** \u2014 Unified entry point: scans endpoints, discovers tests, computes diff. Takes `repositoryPath` and `scope`. Returns `stateFile` + recommendations.\n14. **`skyramp_analyze_test_health`** \u2014 Drift and health assessment for existing tests. Takes `stateFile`. Returns LLM prompt for scoring.\n15. **`skyramp_actions`** \u2014 Execute UPDATE / REGENERATE / VERIFY / DELETE actions. Takes `stateFile`. Call after analyze_test_health.\n\n### Code Quality\n16. **`skyramp_fix_errors`** \u2014 Fix compilation or runtime errors in a generated test file.\n17. **`skyramp_modularization`** \u2014 Refactor a test file into reusable modules. Set `isTraceBased: true` for trace-based tests.\n18. **`skyramp_reuse_code`** \u2014 Pull shared helpers from other Skyramp tests. Only when `code_reuse` was `true` at generation time.\n\n### Authentication\n19. **`skyramp_login`** \u2014 Log in to the Skyramp platform.\n20. **`skyramp_logout`** \u2014 Log out from the Skyramp platform.\n\n---\n\n## Prompts\n\nPrefer invoking a prompt over manually chaining tools \u2014 prompts run the full workflow automatically.\n\n- **`skyramp_trace_prompt`** \u2014 Trace collection setup and execution.\n- **`skyramp_test_health_analysis`** \u2014 Full maintenance flow (discover \u2192 drift \u2192 health \u2192 actions).\n- **`skyramp_testbot`** \u2014 PR-scoped recommendations + maintenance + report. Required: `prTitle`, `prDescription`, `repositoryPath`.\n\n---\n\n## Workflows\n\nUse these when a prompt is not available.\n\n**Generate and run a test**\nRead `.skyramp/workspace.yml` \u2192 Call appropriate generation tool \u2192 `skyramp_execute_test`\n\n**Trace-based test (integration / load / E2E / UI)**\n`skyramp_start_trace_collection` (set `playwright: true` for UI/E2E) \u2192 User exercises the app \u2192 `skyramp_stop_trace_collection` \u2192 Call target generation tool with `trace` (and `playwrightInput` for E2E/UI)\n\n**Scenario \u2192 integration test**\n`skyramp_scenario_test_generation` \u2192 `skyramp_integration_test_generation` with `scenarioFile`\n\n**Recommend tests for a PR**\n`skyramp_analyze_changes` (with `scope: \"branch_diff\"`) \u2192 follow enrichment steps \u2192 `skyramp_recommend_tests` \u2192 Generate recommended tests\n\n**Maintain existing tests**\n`skyramp_analyze_changes` \u2192 `skyramp_analyze_test_health` \u2192 *(optional)* execute tests via `skyramp_execute_test` with `stateFile` param (writes results back) \u2192 `skyramp_actions` (do not skip)\n\n---\n\n## Conventions\n\n- **`endpointURL`** \u2014 Full URL to a specific endpoint, not just the base URL. Build from `api.baseUrl` + path (e.g. `http://localhost:8000/api/v1/users`).\n- **`outputDir`** \u2014 Use absolute paths for both test output and trace collection.\n- **Mutually exclusive inputs** \u2014 `apiSchema`/`endpointURL`, `trace`, and `scenarioFile` are mutually exclusive for integration and load tests. Use exactly one.\n- **Sequential execution** \u2014 Execute tests sequentially (not in parallel) to avoid environment variable conflicts with `SKYRAMP_TEST_BASE_URL`.\n";

package/build/utils/skyrampMdContent.js

@@ -34,7 +34,7 @@ Use this skill whenever the user asks to generate, run, or maintain API tests. A
 11. **\`skyramp_scenario_test_generation\`** — Scenario trace generation. Describe a multi-step flow in natural language to produce a scenario file. Pass output to \`skyramp_integration_test_generation\` via \`scenarioFile\`.
 
 ### Test Execution
-12. **\`skyramp_execute_test\`** — Run a single Skyramp-generated test file. Required: \`workspacePath\`, \`language\`, \`testType\`, \`testFile\`. Optional: \`stateFile\` (writes execution results back for health analysis). For multiple tests, call sequentially to avoid env var conflicts.
+12. **\`skyramp_execute_test\`** — Run one test file and record the verdict from the exit code. Required: \`testFile\`, \`language\`, \`testType\`, \`repository\`. To run on this host, pass \`commandOverride\` (the command for that one file) with \`cwd\`. Omit \`commandOverride\` to run in the Skyramp executor instead, which needs \`workspacePath\`. Optional: \`stateFile\` (writes execution results back for health analysis). Output is capped at the last 200,000 characters.
 
 ### Test Analysis & Maintenance
 13. **\`skyramp_analyze_changes\`** — Unified entry point: scans endpoints, discovers tests, computes diff. Takes \`repositoryPath\` and \`scope\`. Returns \`stateFile\` + recommendations.

package/build/utils/skyrampSdkVersion.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The Skyramp SDK version installed beside this server, which is the version the
+ * generated tests are written against.
+ *
+ * Read once: it cannot change while the process runs. The SDK is a direct
+ * dependency that this server imports at load time, so it is always installed
+ * here — a read failure is a broken install, not a state to degrade into.
+ */
+export declare const SKYRAMP_SDK_VERSION: string;

package/build/utils/skyrampSdkVersion.js

@@ -0,0 +1,16 @@
+import { readFileSync } from "fs";
+import { createRequire } from "module";
+const require = createRequire(import.meta.url);
+/**
+ * The Skyramp SDK version installed beside this server, which is the version the
+ * generated tests are written against.
+ *
+ * Read once: it cannot change while the process runs. The SDK is a direct
+ * dependency that this server imports at load time, so it is always installed
+ * here — a read failure is a broken install, not a state to degrade into.
+ */
+export const SKYRAMP_SDK_VERSION = readInstalledSdkVersion();
+function readInstalledSdkVersion() {
+    const manifest = require.resolve("@skyramp/skyramp/package.json");
+    return JSON.parse(readFileSync(manifest, "utf8")).version;
+}

package/build/utils/sourceRouteExtractor.js

@@ -135,7 +135,8 @@ function findRouterFiles(repoPath) {
             // hosts a `defineModule({ routes: [...] })` call.
             if (lower.startsWith("index.")) {
                 const ext = path.extname(lower);
-                return indexExtensions.has(ext) && full.includes(`${path.sep}modules${path.sep}`);
+                return (indexExtensions.has(ext) &&
+                    full.includes(`${path.sep}modules${path.sep}`));
             }
             return false;
         },
@@ -529,8 +530,10 @@ function resolveExportedSymbolToString(filePath, exportedName, cache, depth) {
                 // `export default <expr>` — direct default export.
                 return resolveExpressionToString(stmt.expression, filePath, imports, localConsts, cache, depth + 1);
             }
-            if (ts.isExportDeclaration(stmt) && stmt.exportClause &&
-                ts.isNamedExports(stmt.exportClause) && !stmt.moduleSpecifier) {
+            if (ts.isExportDeclaration(stmt) &&
+                stmt.exportClause &&
+                ts.isNamedExports(stmt.exportClause) &&
+                !stmt.moduleSpecifier) {
                 // `export { X as default }` — local re-export aliased as default.
                 for (const elt of stmt.exportClause.elements) {
                     if (elt.name.text !== "default")
@@ -643,7 +646,9 @@ function resolveModuleSpecifier(spec, fromDir, cache) {
     const viaPaths = resolveViaTsconfigPaths(spec, tsconfig);
     if (viaPaths)
         return viaPaths;
-    return tsconfig.baseUrl ? resolveImportPath(tsconfig.baseUrl, spec) : undefined;
+    return tsconfig.baseUrl
+        ? resolveImportPath(tsconfig.baseUrl, spec)
+        : undefined;
 }
 /** The file a `paths` alias names, trying the most specific pattern first and,
  *  within one pattern, the first target that exists. */
@@ -1052,7 +1057,8 @@ function dataRouterRoutesFromArray(arr, prefix, filePath, imports, localConsts,
             else if (name === "element" || name === "component") {
                 componentName = componentIdentifierOf(prop.initializer);
             }
-            else if (name === "children" && ts.isArrayLiteralExpression(prop.initializer)) {
+            else if (name === "children" &&
+                ts.isArrayLiteralExpression(prop.initializer)) {
                 childrenArray = prop.initializer;
             }
         }
@@ -1141,7 +1147,8 @@ function defineModuleRoutesFromCall(call, filePath, imports, localConsts, cache)
             if (idVal !== null)
                 moduleId = idVal;
         }
-        else if (propName === "routes" && ts.isArrayLiteralExpression(prop.initializer)) {
+        else if (propName === "routes" &&
+            ts.isArrayLiteralExpression(prop.initializer)) {
             routesArray = prop.initializer;
         }
     }

package/build/utils/telemetry.d.ts

@@ -14,6 +14,7 @@ export interface RepositoryInfo {
  * forms, with or without the trailing ".git". Returns undefined if no match.
  */
 export declare function parseRepositoryFromRemoteUrl(remoteUrl: string): RepositoryInfo | undefined;
+export declare function getLocalRepositoryInfo(cwd: string): Promise<RepositoryInfo>;
 /**
  * Resolves source-repository attribution for telemetry, segmenting usage per
  * customer/repo.

package/build/utils/telemetry.js

@@ -7,6 +7,7 @@ import { execFile } from "child_process";
 import { promisify } from "util";
 import { isTestbotEnabled } from "./featureFlags.js";
 import { logger } from "./logger.js";
+import { parseOwnerRepo } from "./repositorySlug.js";
 const execFileAsync = promisify(execFile);
 export function getEntryPoint() {
     return isTestbotEnabled() ? "testbot" : "mcp";
@@ -32,17 +33,19 @@ export function getCIPlatform() {
  * forms, with or without the trailing ".git". Returns undefined if no match.
  */
 export function parseRepositoryFromRemoteUrl(remoteUrl) {
-    const match = remoteUrl.trim().match(/[:/]([^/]+)\/([^/.]+?)(?:\.git)?$/);
-    if (!match)
+    const repository = parseOwnerRepo(remoteUrl);
+    if (!repository)
         return undefined;
-    const [, owner, repo] = match;
-    return { repository: `${owner}/${repo}`, repositoryOwner: owner };
+    return { repository, repositoryOwner: repository.split("/")[0] };
 }
 // Memoize the local git lookup per working directory so we shell out at most
 // once per cwd for the lifetime of the MCP server process. The value is the
 // resolved RepositoryInfo (possibly empty when not a git repo / no remote).
+//
+// Also read outside telemetry: the testbot and SUT resources name their
+// repository from the checkout's own remote, the same way the action does.
 const localRepoInfoCache = new Map();
-async function getLocalRepositoryInfo(cwd) {
+export async function getLocalRepositoryInfo(cwd) {
     const cached = localRepoInfoCache.get(cwd);
     if (cached)
         return cached;

package/build/utils/testDependencyPolicy.d.ts

@@ -0,0 +1,9 @@
+export declare const NPM_TEST_PACKAGES: ReadonlySet<string>;
+export declare const PYTHON_TEST_PACKAGES: ReadonlySet<string>;
+export declare const JAVA_TEST_PACKAGES: ReadonlySet<string>;
+export interface TestDependencyVerification {
+    ok: boolean;
+    checkedFiles: string[];
+    violations: string[];
+}
+export declare function verifyTestDependencyChanges(repositoryPath: string): Promise<TestDependencyVerification>;