@skyramp/mcp 0.2.6 → 0.2.150-rc.mntnc

package/build/utils/AnalysisStateManager.js

@@ -119,6 +119,15 @@ export class StateManager {
         if (stateFilePath) {
             this.stateFile = stateFilePath;
         }
+        else if (stateType === "analysis" && process.env.RUNNER_TEMP) {
+            // In CI (testbot action), RUNNER_TEMP is a job-isolated dir that both the
+            // action and this tool can independently derive — no LLM input needed.
+            // TODO: interim step — remove this branch when stateFile and summaryOutputFile are merged
+            // (see getTestbotPrompt TODO). RUNNER_TEMP is GitHub Actions-specific; other CI systems
+            // (Jenkins, GitLab, Buildkite) must set it explicitly. Once merged, path flows through
+            // summaryOutputFile which is already testbot-controlled and CI-agnostic.
+            this.stateFile = path.join(process.env.RUNNER_TEMP, "skyramp", "analyze-changes-state.json");
+        }
         else {
             const baseDir = stateDir || os.tmpdir();
             const prefix = STATE_FILE_PREFIXES[stateType];
@@ -260,7 +269,7 @@ export class StateManager {
      * @returns Number of files deleted
      */
     static async cleanupOldFiles(maxAgeHours = 24, stateDir, stateTypes) {
-        const baseDir = stateDir || os.tmpdir();
+        const baseDir = stateDir || (process.env.RUNNER_TEMP ? path.join(process.env.RUNNER_TEMP, "skyramp") : os.tmpdir());
         const files = await fs.promises.readdir(baseDir).catch(() => []);
         const statePrefixes = stateTypes
             ? stateTypes.map((t) => STATE_FILE_PREFIXES[t])

package/build/utils/AnalysisStateManager.test.d.ts

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

package/build/utils/analyze-openapi.d.ts

@@ -0,0 +1 @@
+export declare function analyzeOpenAPIWithGivenEndpoint(apiSchemaInput: string, uriInput: string, pathParamsInput: string): Promise<string | null>;

package/build/utils/branchDiff.d.ts

@@ -0,0 +1,18 @@
+export interface BranchDiffData {
+    currentBranch: string;
+    baseBranch: string;
+    changedFiles: string[];
+    /** Full unified diff content. */
+    diffContent: string;
+    diffStat: string;
+    /** Files newly created in this branch (--- /dev/null in diff header). Relative paths. */
+    newFiles: string[];
+    /** Files deleted in this branch (+++ /dev/null in diff header). Relative paths. */
+    deletedFiles: string[];
+}
+/**
+ * Extract every file path mentioned in a unified-diff `diff --git` header.
+ * Always uses the `b/` form so renames return the new path.
+ */
+export declare function parseChangedFilesFromDiff(rawDiff: string): string[];
+export declare function computeBranchDiff(repositoryPath: string, providedBaseBranch?: string): Promise<BranchDiffData>;

package/build/utils/dartRouteExtractor.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Dart route extraction for Flutter apps using the `go_router` package.
+ *
+ * Walks the repo's Dart sources looking for GoRoute declarations with
+ * string-literal `path:` arguments:
+ *
+ *   GoRoute(path: '/login', builder: (ctx, st) => LoginScreen())
+ *   GoRoute(path: "/profile/:id", builder: ...)
+ *
+ * Why regex (not a Dart compiler): Dart parsers (analyzer, dart-analyzer
+ * package) require a Dart SDK install. Regex on the GoRoute string-literal-path
+ * subset gives ~95% coverage of real customer apps with zero install cost.
+ * Constants like `path: _kHome` are deliberately skipped — emitting them
+ * as a URL `_kHome` would mislead the agent worse than dropping them.
+ *
+ * Each route also carries metadata to support diff-matching in the caller
+ * (findCandidatePagesByDartRoute):
+ *
+ *   - `screenWidgets`: identifiers referenced as builder/pageBuilder targets,
+ *     e.g. `AuthorsScreen`. Resolved through the file's imports to absolute
+ *     paths in `screenFiles`.
+ *   - `screenFiles`: the imported source files those identifiers come from.
+ *   - `isRedirectOnly`: true if the GoRoute has `redirect:` but no
+ *     `builder:` or `pageBuilder:` — these don't render UI, just redirect.
+ *
+ * Scope choices for slice 1:
+ *   - GoRouter only (`MaterialApp.routes` and `auto_route` deferred)
+ *   - String-literal `path:` only (no constant resolution)
+ *   - Nested GoRoutes emit each declaration verbatim — the absolute parent
+ *     plus relative children. Caller may compose them later.
+ */
+/** A route declaration discovered in Dart source. */
+export interface DartRoute {
+    /** URL path string from the GoRoute(path: ...) declaration (verbatim). */
+    path: string;
+    /** Dart file the declaration was found in (absolute path). */
+    declaredIn: string;
+    /** Widget identifiers referenced from builder:/pageBuilder: (e.g. `AuthorsScreen`). */
+    screenWidgets: string[];
+    /** Resolved absolute paths for screenWidgets via the file's imports. */
+    screenFiles: string[];
+    /** True when GoRoute has `redirect:` but no `builder:`/`pageBuilder:` — no UI. */
+    isRedirectOnly: boolean;
+}
+export declare function extractDartRoutes(repositoryPath: string): DartRoute[];

package/build/utils/dartRouteExtractor.test.d.ts

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

package/build/utils/docker.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pull a Docker image by name.
+ *
+ * When `dockerPlatform` is provided, pulls with that exact platform — no
+ * fallback logic runs.  Use this for images whose platform is known ahead
+ * of time (e.g. executor is amd64-only).
+ *
+ * When `dockerPlatform` is omitted, uses the host architecture and falls
+ * back to linux/amd64 if the arm64 pull fails or the image doesn't land
+ * locally (Docker Desktop quirk on Apple Silicon).
+ */
+export declare function pullDockerImage(imageName: string, dockerPlatform?: string): Promise<void>;
+/**
+ * Check if a Docker image exists locally for the given reference (repo:tag or digest).
+ * Uses image inspect (daemon name resolution), not listImages tag scanning.
+ * Returns true if found, false if the image is not present (404).
+ * Throws for any other error (e.g. Docker daemon unreachable) so callers can skip pulling.
+ */
+export declare function dockerImageExistsLocally(imageName: string): Promise<boolean>;

package/build/utils/docker.test.d.ts

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

package/build/utils/docker.test.js

@@ -1,5 +1,12 @@
+// @ts-nocheck - Jest ESM type inference issues
+import { jest } from "@jest/globals";
 // Mock logger before importing docker module
-jest.mock("./logger.js", () => ({
+const mockInspect = jest.fn();
+const mockGetImage = jest.fn(() => ({ inspect: mockInspect }));
+const mockFollowProgress = jest.fn();
+const mockPull = jest.fn();
+const mockModem = { followProgress: mockFollowProgress };
+jest.unstable_mockModule("./logger.js", () => ({
     logger: {
         debug: jest.fn(),
         info: jest.fn(),
@@ -7,18 +14,12 @@ jest.mock("./logger.js", () => ({
         warning: jest.fn(),
     },
 }));
-// Mock dockerode before importing docker module
-const mockInspect = jest.fn();
-const mockGetImage = jest.fn(() => ({ inspect: mockInspect }));
-const mockFollowProgress = jest.fn();
-const mockPull = jest.fn();
-const mockModem = { followProgress: mockFollowProgress };
 jest.mock("dockerode", () => jest.fn().mockImplementation(() => ({
     getImage: mockGetImage,
     pull: mockPull,
     modem: mockModem,
 })));
-import { dockerImageExistsLocally, pullDockerImage } from "./docker.js";
+const { dockerImageExistsLocally, pullDockerImage } = await import("./docker.js");
 // Helper: make docker.pull succeed (stream ends without error)
 function mockPullSuccess() {
     const fakeStream = {};
@@ -54,7 +55,7 @@ describe("dockerImageExistsLocally", () => {
     });
 });
 describe("pullDockerImage", () => {
-    const IMAGE = "skyramp/executor:v1.3.27";
+    const IMAGE = "skyramp/executor:v1.3.28";
     beforeEach(() => jest.clearAllMocks());
     describe("on amd64 host", () => {
         const originalArch = process.arch;

package/build/utils/featureFlags.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Feature flag helpers.
+ *
+ * Each helper in this module reads a `SKYRAMP_FEATURE_*` env var and returns
+ * a boolean. These helpers treat a flag as ON only when the env var is
+ * exactly `"1"`; anything else (unset, empty, "0", "true", "false", etc.) is
+ * treated as OFF.
+ */
+/**
+ * Gates BOTH consumer-side contract tests AND the SDK's "default mode"
+ * fallback (where omitting both `providerMode` and `consumerMode` causes the
+ * SDK to generate BOTH provider and consumer tests).
+ *
+ * `providerMode` itself is exposed regardless of this flag.
+ *
+ * When OFF (default):
+ *   - `skyramp_contract_test_generation` only exposes provider-mode
+ *     parameters in its input schema, and the tool description, validation,
+ *     and post-generation instructions all assume provider-only behavior.
+ *   - The SDK is always invoked with `providerMode: true`, so the
+ *     "neither mode set ⇒ generate both" default cannot leak through. Only
+ *     a provider contract test is ever generated.
+ *   - Testbot recommendation prompts no longer suggest `consumerMode: true`
+ *     contract tests.
+ *
+ * When ON (`SKYRAMP_FEATURE_CONTRACT_CONSUMER_MODE=1`):
+ *   - Restores the previous behavior: `consumerMode` / `consumerOutput` are
+ *     exposed on the input schema, recommendation prompts mention consumer
+ *     contract tests, and the SDK's "no mode set ⇒ generate both" default
+ *     is preserved.
+ */
+export declare function isContractConsumerModeEnabled(): boolean;
+/**
+ * Returns true when running inside a TestBot environment
+ * (SKYRAMP_FEATURE_TESTBOT=1).
+ */
+export declare function isTestbotEnabled(): boolean;

package/build/utils/featureFlags.test.d.ts

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

package/build/utils/gitStaging.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Check whether `child` is inside `parent` using resolved paths with
+ * a trailing separator to avoid prefix false positives (e.g. /tmp/test-repo2
+ * should not match /tmp/test-repo).
+ */
+export declare function isInsideDir(child: string, parent: string): boolean;
+/**
+ * In cross-repo mode, redirects an outputDir to be under the test repo clone
+ * if it isn't already. Returns the original path unchanged when testsRepoDir
+ * is unset or the path is already inside it.
+ */
+export declare function resolveOutputDir(outputDir: string, testsRepoDir: string | undefined): string;
+/**
+ * Stages a file path an MCP tool just wrote into the git index by
+ * running `git add -- <path>`.
+ *
+ * Automatically detects the git root of the target path so that staging
+ * works correctly in cross-repo mode (test repo clone separate from the
+ * source repo).
+ *
+ * Gated by the SKYRAMP_FEATURE_TESTBOT=1 env var, which is set only
+ * inside a testbot CI run.
+ */
+export declare function stageGeneratedPaths(filePath: string, cwd?: string): Promise<void>;

package/build/utils/gitStaging.test.d.ts

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

package/build/utils/gitStaging.test.js

@@ -1,4 +1,7 @@
-jest.mock("./logger.js", () => ({
+import { jest } from "@jest/globals";
+const execFileMock = jest.fn();
+const execFileSyncMock = jest.fn();
+jest.unstable_mockModule("./logger.js", () => ({
     logger: {
         debug: jest.fn(),
         info: jest.fn(),
@@ -6,14 +9,17 @@ jest.mock("./logger.js", () => ({
         error: jest.fn(),
     },
 }));
-jest.mock("fs", () => ({
+jest.unstable_mockModule("fs", () => ({
+    default: {
+        statSync: (p) => ({
+            isDirectory: () => !p.includes("."),
+        }),
+    },
     statSync: (p) => ({
         isDirectory: () => !p.includes("."),
     }),
 }));
-const execFileMock = jest.fn();
-const execFileSyncMock = jest.fn();
-jest.mock("child_process", () => ({
+jest.unstable_mockModule("child_process", () => ({
     execFile: (cmd, args, opts, cb) => {
         const result = execFileMock(cmd, args, opts);
         const cbErr = result && typeof result === "object" && "err" in result
@@ -26,8 +32,8 @@ jest.mock("child_process", () => ({
     },
     execFileSync: (cmd, args, opts) => execFileSyncMock(cmd, args, opts),
 }));
-import { stageGeneratedPaths } from "./gitStaging.js";
-import { logger } from "./logger.js";
+const { stageGeneratedPaths } = await import("./gitStaging.js");
+const { logger } = await import("./logger.js");
 const loggerInfoMock = logger.info;
 let originalTestbotEnv;
 beforeAll(() => {

package/build/utils/httpDefaults.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared HTTP method defaults used across scenario drafting and test generation.
+ */
+/**
+ * Returns the conventional success status code for a given HTTP method.
+ *   POST   → 201 Created
+ *   DELETE → 204 No Content
+ *   other  → 200 OK
+ */
+export declare function inferExpectedStatus(method: string): number;

package/build/utils/httpDefaults.test.d.ts

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

package/build/utils/initAgent.d.ts

@@ -0,0 +1,36 @@
+import { WORKER_DOCKER_IMAGE } from "./versions.js";
+export { WORKER_DOCKER_IMAGE };
+/**
+ * Install or refresh SKYRAMP_MD_CONTENT at global skill discovery paths only (~/.claude, ~/.cursor, ~/.github/skills).
+ * No workspace path required. Creates files if missing; overwrites if content differs.
+ */
+export declare function ensureSkyrampMdInstalled(): Promise<void>;
+/**
+ * Skyramp init:
+ * install/refresh global skill files (~/.claude, ~/.cursor, ~/.github/skills) (errors logged but do not block init),
+ * check which images are missing, then kick off any needed pulls in the background and return immediately.
+ * Deduplication for the MCP oninitialized path is handled by registerInitTriggerOnMCPInitialized in this module.
+ *
+ * Pull improvements over the previous SkyrampClient.initAgent() FFI approach:
+ * - Skip-if-present: each image is checked independently via a fast daemon inspect (~5ms)
+ *   before any pull is attempted, avoiding unnecessary network calls.
+ * - Pull only what is missing: if one image is already present, only the other is pulled.
+ *   Previously both images were always pulled regardless.
+ * - Parallel pulls: missing images are pulled concurrently via Promise.all, halving
+ *   wall-clock time when both need to be downloaded.
+ * - Arch-aware: pull platform is detected from process.arch (linux/arm64 on Apple Silicon,
+ *   linux/amd64 otherwise) with an automatic amd64 fallback if no arm64 manifest exists
+ *   (e.g. skyramp/executor is amd64-only; skyramp/worker supports both).
+ * - No FFI overhead: direct Dockerode calls replace the Go shared-library bridge,
+ *   removing the cost of loading the .so and marshalling output through a C string.
+ * - Cleaner error propagation: structured errors from Dockerode replace parsing a
+ *   stringified Go output from the C FFI boundary.
+ */
+export declare function initCheck(): Promise<void>;
+/**
+ * Runs initCheck asynchronously after the MCP handshake completes.
+ * Prevents duplicate concurrent runs and skips future runs after a successful init.
+ * If initCheck fails, a later call can retry within the same process.
+ * Assign to server.server.oninitialized in main().
+ */
+export declare function registerInitTriggerOnMCPInitialized(): Promise<void>;

package/build/utils/language-helper.d.ts

@@ -0,0 +1,6 @@
+export interface LanguageStepsParams {
+    language: string;
+    testType?: string;
+    framework?: string;
+}
+export declare function getLanguageSteps(params: LanguageStepsParams): string;

package/build/utils/logger.d.ts

@@ -0,0 +1,11 @@
+export declare class McpLogger {
+    private loggerName;
+    constructor(loggerName?: string);
+    private sendLogMessage;
+    debug(message: string, data?: any): void;
+    info(message: string, data?: any): void;
+    warning(message: string, data?: any): void;
+    error(message: string, data?: any): void;
+    critical(message: string, data?: any): void;
+}
+export declare const logger: McpLogger;

package/build/utils/normalizeParams.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Normalize tool parameters to handle common LLM mistakes:
+ * - Case-insensitive language/framework values
+ * - Common parameter name aliases
+ */
+/**
+ * Normalize language and framework to lowercase accepted values.
+ */
+export declare function normalizeLanguageParams(params: Record<string, any>): void;
+/**
+ * Resolve common parameter name aliases that LLMs use.
+ * e.g., zipPath -> playwrightInput, testFilePath -> testFile
+ */
+export declare function resolveParamAliases(params: Record<string, any>, aliases: Record<string, string>): void;

package/build/utils/normalizeSkyrampImports.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Ensure `expect` is imported from `@skyramp/skyramp` rather than `@playwright/test`.
+ * - Strips `expect` from any `@playwright/test` import (keeps other identifiers).
+ * - If the file uses `expect(...)`, ensures an `@skyramp/skyramp` import carries `expect`.
+ * Returns the original string if no rewrite was needed.
+ */
+export declare function normalizeSkyrampExpectImport(source: string): string;
+/**
+ * Normalize the `expect` import in a file on disk. No-op if the file is missing,
+ * unreadable, or already correct. Errors are swallowed — this is a safety net,
+ * not a blocking step.
+ */
+export declare function normalizeSkyrampImportsInFile(testFile: string | undefined): void;

package/build/utils/pr-comment-parser.d.ts

@@ -0,0 +1,31 @@
+/**
+ * PR Comment Parser — extracts TestBot history from GitHub PR comments.
+ *
+ * Parses previous Skyramp TestBot comments on a PR to build context
+ * about what has already been recommended, implemented, and tested.
+ * This prevents re-recommendations and enables contextual awareness
+ * across the PR lifecycle.
+ */
+export interface PRTestContext {
+    prNumber: number;
+    previousRecommendations: Array<{
+        testType: string;
+        endpoint: string;
+        scenarioName?: string;
+        status: "recommended" | "implemented" | "dismissed";
+        commentId: string;
+    }>;
+    implementedTestFiles: string[];
+    executionResults: Array<{
+        testFile: string;
+        status: "pass" | "fail" | "skipped";
+        timestamp: string;
+    }>;
+}
+/**
+ * Fetch and parse PR comments to build TestBot history context.
+ *
+ * Uses the `gh` CLI (available in CI and local dev environments with
+ * GitHub CLI installed). Falls back gracefully if `gh` is unavailable.
+ */
+export declare function parsePRComments(repoOwner: string, repoName: string, prNumber: number, _token?: string): Promise<PRTestContext>;

package/build/utils/pr-comment-parser.test.d.ts

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

package/build/utils/pr-comment-parser.test.js

@@ -1,9 +1,10 @@
-import { parsePRComments } from "./pr-comment-parser.js";
-import { execFileSync } from "child_process";
-jest.mock("child_process", () => ({
-    execFileSync: jest.fn(),
+import { jest } from "@jest/globals";
+// Mock child_process before importing the module under test
+const mockedExecFileSync = jest.fn();
+jest.unstable_mockModule("child_process", () => ({
+    execFileSync: mockedExecFileSync,
 }));
-const mockedExecFileSync = execFileSync;
+const { parsePRComments } = await import("./pr-comment-parser.js");
 // ---------------------------------------------------------------------------
 // Fixture helpers — build PR comment bodies matching the real renderReport()
 // output wrapped in the progress comment from testbot/src/progress.ts.

package/build/utils/projectMetadata.d.ts

@@ -0,0 +1,15 @@
+export type ProjectType = "rest-api" | "frontend" | "full-stack" | "microservices" | "library" | "cli" | "other";
+export type DeploymentPattern = "microservices" | "full-stack" | "containerized-monolith" | "traditional" | "unknown";
+export interface ProjectMeta {
+    projectType: ProjectType;
+    primaryLanguage: string;
+    primaryFramework: string;
+    deploymentPattern: DeploymentPattern;
+    languages: string[];
+    frameworks: string[];
+    runtime: string;
+    isContainerized: boolean;
+    hasDockerCompose: boolean;
+    hasCiCd: boolean;
+}
+export declare function detectProjectMetadata(repositoryPath: string): ProjectMeta;

package/build/utils/projectMetadata.test.d.ts

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

package/build/utils/proxy-terminal.d.ts

@@ -0,0 +1,2 @@
+export default function openProxyTerminal(): Promise<void>;
+export declare function closeProxyTerminal(): Promise<void>;

package/build/utils/repoScanner.d.ts

@@ -0,0 +1,27 @@
+export interface ScannedEndpoint {
+    path: string;
+    methods: string[];
+    sourceFile: string;
+}
+/**
+ * Returns the relative paths of entry-point files that define the routing
+ * hierarchy for this repository. The LLM reads these files in Step 1.5 to
+ * trace router/module nesting and build an authoritative path resolution table.
+ *
+ * Intentionally returns only file paths — no extracted lines. Static regex
+ * extraction is fragile and framework-specific; the LLM reads the files directly
+ * and understands any framework's routing syntax.
+ */
+export declare function grepRouterMountingContext(repositoryPath: string): string[];
+/**
+ * Return relative paths of all source files that are likely to define API
+ * routes. Two-pass strategy:
+ *   1. Fast: filename matches ROUTE_FILE_PATTERN (no file I/O needed).
+ *   2. Content: files not matched by name are read and checked for both a
+ *      URL-path literal AND an HTTP method registration. This covers any
+ *      framework the filename filter misses — Axum, Ktor, .NET, Hono, etc.
+ * Result is capped at MAX_CANDIDATE_FILES to keep the LLM prompt bounded.
+ */
+export declare function findCandidateRouteFiles(repositoryPath: string): string[];
+export declare function scanAllRepoEndpoints(repositoryPath: string): ScannedEndpoint[];
+export declare function scanRelatedEndpoints(repositoryPath: string, changedFiles: string[]): ScannedEndpoint[];

package/build/utils/repoScanner.test.d.ts

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

package/build/utils/routeParsers.d.ts

@@ -0,0 +1,53 @@
+import { BranchDiffData } from "./branchDiff.js";
+import type { ScannedEndpoint } from "./repoScanner.js";
+export interface ParsedDiffEndpoint {
+    method: string;
+    path: string;
+    sourceFile: string;
+}
+export declare function nextjsFileToApiPath(filePath: string): string | null;
+export declare const UI_FILE_EXTENSIONS: readonly ["tsx", "jsx", "vue", "svelte", "html", "xml"];
+export declare const UI_FILE_GIT_PATHSPEC: string;
+export declare const UI_FILE_EXTENSIONS_PIPED: string;
+export declare function parseRouteLine(line: string, sourceFile: string): ParsedDiffEndpoint | null;
+/**
+ * Scan all route definitions in a single source file, combining prefix declarations
+ * with method-level annotations. Two orthogonal state machines run in parallel:
+ *
+ * 1. Class-prefix (Spring, NestJS, ASP.NET, Kotlin):
+ *    @Controller/@RestController/@RequestMapping (class level) + class declaration →
+ *    activates classPrefix, applied to all @Get/@Post/@GetMapping etc. below.
+ *
+ * 2. Router-variable prefix (FastAPI, Flask Blueprint):
+ *    varName = APIRouter(prefix=...) or Blueprint(url_prefix=...) — handles both
+ *    single-line and multi-line declarations — maps the variable name to its prefix.
+ *    Applied when @varName.method(...) is seen.
+ *
+ * Falls back to pure parseRouteLine for all other frameworks (Express inline, Gin,
+ * Rails, Laravel, Actix, Hapi, Go stdlib, etc.), which remain unaffected.
+ */
+export declare function parseFileEndpoints(content: string, sourceFile: string): ParsedDiffEndpoint[];
+export declare const SKIP_PATH_SEGMENTS: Set<string>;
+/**
+ * Extract the primary resource key from an endpoint path for use as a dedup key.
+ *
+ * For top-level resources (e.g. "/api/v1/orders/{id}") returns the resource name ("orders").
+ * For sub-resources (e.g. "/orders/{id}/items") returns "orders_items" — including the
+ * parent prevents "/orders/{id}/items" and "/products/{id}/items" from colliding on "items".
+ */
+export declare function extractResourceFromPath(endpointPath: string): string;
+export interface ClassifiedEndpoints {
+    /** Endpoints in scanned catalog whose sourceFile is in changedFiles (not new/deleted). */
+    changedEndpoints: ScannedEndpoint[];
+    /** Endpoints whose sourceFile is in a newly-created file. */
+    newEndpoints: ScannedEndpoint[];
+    /** Endpoints whose sourceFile is in a deleted file (recovered from base branch). */
+    removedEndpoints: ScannedEndpoint[];
+    /** Changed files that don't map to any scanned endpoint. */
+    unmatchedFiles: string[];
+    changedFiles: string[];
+    currentBranch: string;
+    baseBranch: string;
+    affectedServices: string[];
+}
+export declare function classifyEndpointsByChangedFiles(diffData: BranchDiffData, scannedEndpoints: ScannedEndpoint[], deletedFileEndpoints?: ScannedEndpoint[]): ClassifiedEndpoints;