@skyramp/mcp 0.4.2-rc.1 → 0.4.2-rc.2

package/build/tools/runExistingTestsTool.d.ts

@@ -1,138 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { WorkspaceConfig } from "../workspace/workspace.js";
-import { ParsedExternalRun } from "../types/ExternalTestExecution.js";
-import { SUPPORTED_FRAMEWORKS } from "../workspace/frameworks.js";
-/** Test-run lifecycle resolved from a service's workspace.yml runtimeDetails. */
-export interface ResolvedRunConfig {
-    serviceName: string;
-    framework: Framework;
-    testRunCommand: string;
-    testEnv?: Record<string, string>;
-    /** Repo-relative globs this suite owns; empty/absent means it accepts any selector. */
-    pathGlobs?: string[];
-}
-type Framework = (typeof SUPPORTED_FRAMEWORKS)[number];
-/** Binds a framework to its pure parse/buildArgs pair + how its report is
- *  obtained. The generic IO shell {@link runExternalSuite} is the only place
- *  that spawns a process; adding a framework is a new ReaderSpec + registry entry. */
-interface ReaderSpec {
-    framework: Framework;
-    /** Where the machine-readable report lands: a temp file, or the process stdout. */
-    outputVia: "file" | "stdout";
-    /** Env var pointing the reporter at the temp report path (e.g. Playwright). */
-    reportEnvVar?: string;
-    buildArgs(input: {
-        selectors: string[];
-        mode: "confirm" | "verify";
-        project?: string;
-        reportPath: string;
-    }): string[];
-    parse(report: unknown, opts: {
-        truncated: boolean;
-    }): ParsedExternalRun;
-}
-/** True when a framework has an execution reader (playwright/pytest/jest/vitest/mocha). */
-export declare function frameworkHasReader(framework?: string): boolean;
-/** Extract the last complete top-level JSON object from a stdout blob that may
- *  carry interleaved non-JSON (e.g. a test's console.log before mocha's json
- *  reporter dumps its object). Scans brace depth while respecting string/escape
- *  context so braces inside strings do not miscount. Throws if none found. */
-export declare function extractLastJsonObject(s: string): string;
-export interface RunExistingTestsParams {
-    workspacePath: string;
-    service?: string;
-    testSelectors?: string[];
-    mode?: "confirm" | "verify";
-    project?: string;
-    stateFile?: string;
-    repository: string;
-    timeoutMs?: number;
-    maxTests?: number;
-}
-export interface PlaywrightRunOpts {
-    workspacePath: string;
-    selectors: string[];
-    mode: "confirm" | "verify";
-    project?: string;
-    timeoutMs?: number;
-    truncated: boolean;
-}
-/** Injectable IO seam so the orchestration in {@link runExternalTests} is unit
- *  testable without a real workspace file or Playwright process. */
-export interface RunExistingTestsDeps {
-    readConfig: (workspacePath: string) => Promise<WorkspaceConfig>;
-    runner: (cfg: ResolvedRunConfig, opts: PlaywrightRunOpts) => Promise<ParsedExternalRun>;
-    now: () => string;
-}
-/** The routed suite list: every runnable suite to execute, plus the suites that
- *  were skipped (with a reason). A suite is runnable when its framework has a
- *  registered reader (its testRunCommand is required non-empty by the schema). */
-export interface RunConfigResolution {
-    runs: ResolvedRunConfig[];
-    skips: {
-        service: string;
-        reason: string;
-    }[];
-}
-/**
- * Resolves the runnable suites from workspace.yml (SKYR-4002). Enumerates every
- * (service, suite) via resolveSuites; a suite is runnable when its framework has
- * a registered reader (Playwright, pytest, jest, vitest, Mocha) — testRunCommand
- * is required non-empty by the schema. Suites whose framework has no reader become
- * skips-with-reason (never a throw). Every runnable suite runs. Throws only for an
- * explicitly-named unknown service.
- */
-export declare function resolveRunConfig(config: WorkspaceConfig, opts?: {
-    service?: string;
-}): RunConfigResolution;
-/** Selectors partitioned into those this suite owns and those it does not. */
-export interface SelectorRouting {
-    kept: string[];
-    dropped: string[];
-}
-/**
- * Partitions `selectors` into the ones this suite owns and the ones it does not,
- * using the suite's own `pathGlobs` from workspace.yml.
- *
- * One repo commonly hosts several runners (mocha for a core package, vitest for
- * app packages, Playwright for e2e), and handing a runner another runner's spec is
- * not a test failure — it is a loader crash that yields no report at all. Which
- * suite owns which paths is a fact about the repo, so it is recorded as config the
- * user can read and correct, rather than guessed at run time. Run 30297865488 is
- * the cautionary case: routing on a guessed framework tag sent Ghost's Playwright
- * specs away from the Playwright suite, and nothing ran.
- *
- * A suite with no globs owns everything. That is deliberate: absent globs means
- * the suite is unscoped, not that it owns nothing, and narrowing on no
- * information would silently shrink the run.
- */
-export declare function routeSelectorsToSuite(input: {
-    selectors: string[];
-    /** The suite's repo-relative globs; absent/empty means it accepts every selector. */
-    pathGlobs?: string[];
-    /** Absolute test-file paths from analyze_changes, used to canonicalize a selector. */
-    knownTestFiles?: string[];
-    workspacePath: string;
-}): SelectorRouting;
-/** Combines per-suite runs into one ParsedExternalRun for the tool's summary
- *  text: sums counts, concatenates results, ANDs environmentHealthy, joins the
- *  unhealthy details. */
-export declare function aggregateRuns(parsed: ParsedExternalRun[]): ParsedExternalRun;
-/**
- * Generic IO shell for every framework reader: append the reporter + scoped
- * selectors to the suite's `testRunCommand`, spawn it via bash (so a wrapper
- * entrypoint's `exec "$@"` receives the flags), read the machine-readable
- * report (temp file or captured stdout), and hand it to `spec.parse`. A missing
- * or unparseable report is the exit-code rung: `environmentHealthy:false` with
- * the stderr tail — never PR signal, never throws.
- */
-export declare function runExternalSuite(spec: ReaderSpec, cfg: ResolvedRunConfig, opts: PlaywrightRunOpts): Promise<ParsedExternalRun>;
-export declare function runPlaywright(cfg: ResolvedRunConfig, opts: PlaywrightRunOpts): Promise<ParsedExternalRun>;
-/**
- * Orchestrates an external test run: resolve config → apply maxTests cap → run →
- * persist a record to the state file. Pure of MCP/registration concerns and
- * fully injectable for tests.
- */
-export declare function runExternalTests(params: RunExistingTestsParams, deps?: RunExistingTestsDeps): Promise<ParsedExternalRun>;
-export declare function registerRunExistingTestsTool(server: McpServer): void;
-export {};