@testrelic/mcp 2.1.0

package/dist/config.js

@@ -0,0 +1,233 @@
+import { z } from "zod";
+import { readFileSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolve, join } from "node:path";
+/**
+ * All Zod schemas live here. The public type surface is defined directly
+ * below and is verified against `src/config.d.ts` by `scripts/copy-config.js`
+ * to keep the two surfaces in lock-step.
+ *
+ * The v2 config is radically simpler than v1: the MCP talks to exactly one
+ * upstream (cloud-platform-app). Everything else — Jira, Amplitude, Loki,
+ * GitHub — is resolved server-side from the authenticated user's org
+ * integrations. See cloud-platform-app/server/src/routes/mcp.routes.ts.
+ */
+export const CapabilitySchema = z.enum([
+    "core",
+    "coverage",
+    "creation",
+    "healing",
+    "impact",
+    "triage",
+    "signals",
+    "devtools",
+    "config",
+]);
+export const TransportSchema = z.enum(["stdio", "http"]);
+export const LogLevelSchema = z.enum(["debug", "info", "warn", "error"]);
+export const ServerConfigSchema = z
+    .object({
+    port: z.number().int().min(1).max(65535).optional(),
+    host: z.string().optional(),
+    transport: TransportSchema.optional(),
+})
+    .strict();
+export const TimeoutConfigSchema = z
+    .object({
+    action: z.number().int().positive().optional(),
+    upstream: z.number().int().positive().optional(),
+    analysis: z.number().int().positive().optional(),
+})
+    .strict();
+/**
+ * The ONE place users configure authentication. Everything else is pulled
+ * automatically from /api/v1/mcp/bootstrap once the MCP authenticates.
+ */
+export const CloudConfigSchema = z
+    .object({
+    baseUrl: z.string().optional(),
+    token: z.string().optional(),
+    defaultRepoId: z.string().optional(),
+})
+    .strict();
+export const ConfigSchema = z
+    .object({
+    server: ServerConfigSchema.optional(),
+    capabilities: z.array(CapabilitySchema).optional(),
+    timeouts: TimeoutConfigSchema.optional(),
+    outputDir: z.string().optional(),
+    cacheDir: z.string().optional(),
+    isolated: z.boolean().optional(),
+    saveSession: z.boolean().optional(),
+    sharedRepoContext: z.boolean().optional(),
+    cloud: CloudConfigSchema.optional(),
+    logLevel: LogLevelSchema.optional(),
+    mockMode: z.boolean().optional(),
+    mockServerUrl: z.string().optional(),
+    tokenBudgetPerTool: z.number().int().positive().optional(),
+})
+    .strict();
+const DEFAULT_CLOUD_URL = "https://app.testrelic.ai/api/v1";
+const TOKEN_FILE = join(homedir(), ".testrelic", "token");
+/**
+ * Read the token from ~/.testrelic/token if it exists. Silently returns
+ * undefined otherwise — callers decide whether missing = fatal.
+ */
+export function readTokenFile(path = TOKEN_FILE) {
+    try {
+        if (!existsSync(path))
+            return undefined;
+        const text = readFileSync(path, "utf-8").trim();
+        return text.length > 0 ? text : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function tokenFilePath() {
+    return TOKEN_FILE;
+}
+/**
+ * Load a JSON config file from disk and validate it.
+ */
+export function loadConfigFile(path) {
+    const absolute = resolve(path);
+    if (!existsSync(absolute)) {
+        throw new Error(`Config file not found: ${absolute}`);
+    }
+    const text = readFileSync(absolute, "utf-8");
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (err) {
+        throw new Error(`Config file ${absolute} is not valid JSON: ${err.message}`);
+    }
+    const result = ConfigSchema.safeParse(parsed);
+    if (!result.success) {
+        throw new Error(`Config file ${absolute} failed validation: ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`);
+    }
+    return result.data;
+}
+/**
+ * Merge precedence (highest wins): CLI flags > env > config file > defaults.
+ */
+export function mergeConfig(...layers) {
+    const merged = {};
+    for (const layer of layers) {
+        if (!layer)
+            continue;
+        merged.server = { ...merged.server, ...layer.server };
+        merged.timeouts = { ...merged.timeouts, ...layer.timeouts };
+        merged.cloud = { ...merged.cloud, ...layer.cloud };
+        if (layer.capabilities)
+            merged.capabilities = [...layer.capabilities];
+        if (layer.outputDir !== undefined)
+            merged.outputDir = layer.outputDir;
+        if (layer.cacheDir !== undefined)
+            merged.cacheDir = layer.cacheDir;
+        if (layer.isolated !== undefined)
+            merged.isolated = layer.isolated;
+        if (layer.saveSession !== undefined)
+            merged.saveSession = layer.saveSession;
+        if (layer.sharedRepoContext !== undefined)
+            merged.sharedRepoContext = layer.sharedRepoContext;
+        if (layer.logLevel !== undefined)
+            merged.logLevel = layer.logLevel;
+        if (layer.mockMode !== undefined)
+            merged.mockMode = layer.mockMode;
+        if (layer.mockServerUrl !== undefined)
+            merged.mockServerUrl = layer.mockServerUrl;
+        if (layer.tokenBudgetPerTool !== undefined)
+            merged.tokenBudgetPerTool = layer.tokenBudgetPerTool;
+    }
+    return merged;
+}
+/**
+ * Apply defaults and normalize.
+ *
+ * In mockMode, the cloud baseUrl defaults to `${mockServerUrl}/api/v1` so the
+ * MCP transparently hits the local mock-server. Otherwise it defaults to the
+ * production platform URL and pulls the token from ~/.testrelic/token.
+ */
+export function resolveConfig(config = {}) {
+    const parsed = ConfigSchema.parse(config);
+    const cwd = process.cwd();
+    const port = parsed.server?.port;
+    const transport = parsed.server?.transport ?? (port ? "http" : "stdio");
+    const mockMode = parsed.mockMode ?? false;
+    const mockServerUrl = parsed.mockServerUrl ?? "http://localhost:4000";
+    const baseUrl = parsed.cloud?.baseUrl
+        ?? (mockMode ? `${mockServerUrl}/api/v1` : DEFAULT_CLOUD_URL);
+    const token = parsed.cloud?.token ?? readTokenFile() ?? "";
+    return {
+        server: {
+            port: port ?? 0,
+            host: parsed.server?.host ?? "127.0.0.1",
+            transport,
+        },
+        capabilities: Array.from(new Set(["core", ...(parsed.capabilities ?? [])])),
+        timeouts: {
+            action: parsed.timeouts?.action ?? 5_000,
+            upstream: parsed.timeouts?.upstream ?? 60_000,
+            analysis: parsed.timeouts?.analysis ?? 30_000,
+        },
+        outputDir: parsed.outputDir ?? resolve(cwd, ".testrelic-output"),
+        cacheDir: parsed.cacheDir ?? resolve(cwd, ".testrelic-cache"),
+        isolated: parsed.isolated ?? false,
+        saveSession: parsed.saveSession ?? true,
+        sharedRepoContext: parsed.sharedRepoContext ?? true,
+        cloud: {
+            baseUrl,
+            token,
+            defaultRepoId: parsed.cloud?.defaultRepoId,
+        },
+        logLevel: parsed.logLevel ?? "info",
+        mockMode,
+        mockServerUrl,
+        tokenBudgetPerTool: parsed.tokenBudgetPerTool ?? 4_000,
+    };
+}
+/**
+ * Pick config from environment variables. Only reads at top level — no secret
+ * values are logged.
+ */
+export function configFromEnv(env = process.env) {
+    const c = {};
+    const caps = env.TESTRELIC_MCP_CAPS;
+    if (caps) {
+        c.capabilities = caps
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean);
+    }
+    if (env.TESTRELIC_MCP_PORT)
+        c.server = { port: Number(env.TESTRELIC_MCP_PORT) };
+    if (env.TESTRELIC_MCP_HOST)
+        c.server = { ...c.server, host: env.TESTRELIC_MCP_HOST };
+    if (env.TESTRELIC_MCP_OUTPUT_DIR)
+        c.outputDir = env.TESTRELIC_MCP_OUTPUT_DIR;
+    if (env.TESTRELIC_MCP_CACHE_DIR)
+        c.cacheDir = env.TESTRELIC_MCP_CACHE_DIR;
+    if (env.TESTRELIC_MCP_ISOLATED) {
+        c.isolated = env.TESTRELIC_MCP_ISOLATED === "1" || env.TESTRELIC_MCP_ISOLATED === "true";
+    }
+    if (env.TESTRELIC_MCP_LOG_LEVEL)
+        c.logLevel = env.TESTRELIC_MCP_LOG_LEVEL;
+    if (env.MOCK_SERVER_URL)
+        c.mockServerUrl = env.MOCK_SERVER_URL;
+    if (env.TESTRELIC_MOCK_MODE) {
+        c.mockMode = env.TESTRELIC_MOCK_MODE === "1" || env.TESTRELIC_MOCK_MODE === "true";
+    }
+    const cloud = {};
+    if (env.TESTRELIC_CLOUD_URL)
+        cloud.baseUrl = env.TESTRELIC_CLOUD_URL;
+    if (env.TESTRELIC_MCP_TOKEN)
+        cloud.token = env.TESTRELIC_MCP_TOKEN;
+    if (env.TESTRELIC_DEFAULT_REPO_ID)
+        cloud.defaultRepoId = env.TESTRELIC_DEFAULT_REPO_ID;
+    if (Object.keys(cloud).length > 0)
+        c.cloud = cloud;
+    return c;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,MAAM;IACN,UAAU;IACV,UAAU;IACV,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,UAAU;IACV,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAMzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IACnD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE;CACtC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACjD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,MAAM,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IAClD,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACnC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACzC,KAAK,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACnC,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;IACnC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC3D,CAAC;KACD,MAAM,EAAE,CAAC;AA2BZ,MAAM,iBAAiB,GAAG,iCAAiC,CAAC;AAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,UAAU;IACrD,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QACxC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,uBAAwB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,eAAe,QAAQ,uBAAuB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/H,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAG,MAAiC;IAC9D,MAAM,MAAM,GAAW,EAAE,CAAC;IAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACtD,MAAM,CAAC,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC5D,MAAM,CAAC,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QACnD,IAAI,KAAK,CAAC,YAAY;YAAE,MAAM,CAAC,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;QACtE,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACtE,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACnE,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACnE,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;YAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QAC5E,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS;YAAE,MAAM,CAAC,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC;QAC9F,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACnE,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACnE,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS;YAAE,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;QAClF,IAAI,KAAK,CAAC,kBAAkB,KAAK,SAAS;YAAE,MAAM,CAAC,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAC;IACnG,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE;IAC/C,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;IACjC,MAAM,SAAS,GAAc,MAAM,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC;IAC1C,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,uBAAuB,CAAC;IACtE,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO;WAChC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,IAAI,aAAa,EAAE,IAAI,EAAE,CAAC;IAC3D,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,IAAI,IAAI,CAAC;YACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,WAAW;YACxC,SAAS;SACV;QACD,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAa,CAAC,MAAM,EAAE,GAAI,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAkB,CAAC,CAAC,CAAC;QACzG,QAAQ,EAAE;YACR,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK;YACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,IAAI,MAAM;YAC7C,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,IAAI,MAAM;SAC9C;QACD,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,mBAAmB,CAAC;QAChE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,kBAAkB,CAAC;QAC7D,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;QAClC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI;QACvC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,IAAI;QACnD,KAAK,EAAE;YACL,OAAO;YACP,KAAK;YACL,aAAa,EAAE,MAAM,CAAC,KAAK,EAAE,aAAa;SAC3C;QACD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM;QACnC,QAAQ;QACR,aAAa;QACb,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,KAAK;KACvD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,MAAM,CAAC,GAAW,EAAE,CAAC;IACrB,MAAM,IAAI,GAAG,GAAG,CAAC,kBAAkB,CAAC;IACpC,IAAI,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,YAAY,GAAG,IAAI;aAClB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAiB,CAAC;IACrC,CAAC;IACD,IAAI,GAAG,CAAC,kBAAkB;QAAE,CAAC,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;IAChF,IAAI,GAAG,CAAC,kBAAkB;QAAE,CAAC,CAAC,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,kBAAkB,EAAE,CAAC;IACrF,IAAI,GAAG,CAAC,wBAAwB;QAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,wBAAwB,CAAC;IAC7E,IAAI,GAAG,CAAC,uBAAuB;QAAE,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,uBAAuB,CAAC;IAC1E,IAAI,GAAG,CAAC,sBAAsB,EAAE,CAAC;QAC/B,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,sBAAsB,KAAK,GAAG,IAAI,GAAG,CAAC,sBAAsB,KAAK,MAAM,CAAC;IAC3F,CAAC;IACD,IAAI,GAAG,CAAC,uBAAuB;QAAE,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,uBAAmC,CAAC;IACtF,IAAI,GAAG,CAAC,eAAe;QAAE,CAAC,CAAC,aAAa,GAAG,GAAG,CAAC,eAAe,CAAC;IAC/D,IAAI,GAAG,CAAC,mBAAmB,EAAE,CAAC;QAC5B,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,mBAAmB,KAAK,GAAG,IAAI,GAAG,CAAC,mBAAmB,KAAK,MAAM,CAAC;IACrF,CAAC;IAED,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,IAAI,GAAG,CAAC,mBAAmB;QAAE,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,mBAAmB,CAAC;IACrE,IAAI,GAAG,CAAC,mBAAmB;QAAE,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,mBAAmB,CAAC;IACnE,IAAI,GAAG,CAAC,yBAAyB;QAAE,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,yBAAyB,CAAC;IACvF,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;IAEnD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/context/code-map.d.ts

@@ -0,0 +1,35 @@
+import type { CacheManager } from "../cache/index.js";
+import type { ClientBundle } from "../clients/index.js";
+import type { CodeNode } from "../types/index.js";
+/**
+ * Code map — an AST-extracted index of functions/classes in a target repo.
+ *
+ * v2 only has ONE real mode: local-disk walking (tree-sitter with regex
+ * fallback). cloud-platform-app does not yet expose a remote code-map
+ * endpoint, so `loadRemote` returns empty. Kept as an API hook for when
+ * the platform starts pre-computing code maps.
+ *
+ * We push each node into the vector store so semantic queries work.
+ */
+export declare class CodeMap {
+    private readonly clients;
+    private readonly cache;
+    private readonly ns;
+    private local;
+    constructor(clients: ClientBundle, cache: CacheManager);
+    loadRemote(project_id: string): Promise<CodeNode[]>;
+    loadLocal(repoRoot: string, opts?: {
+        maxFiles?: number;
+        extensions?: string[];
+    }): Promise<CodeNode[]>;
+    search(query: string, k?: number): Promise<Array<{
+        id: string;
+        score: number;
+        text: string;
+        meta?: Record<string, unknown>;
+    }>>;
+    private indexVectors;
+    private walk;
+    private tryLoadTreeSitter;
+}
+//# sourceMappingURL=code-map.d.ts.map

package/dist/context/code-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-map.d.ts","sourceRoot":"","sources":["../../src/context/code-map.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;;;;;;GASG;AAEH,qBAAa,OAAO;IAKhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;IACjC,OAAO,CAAC,KAAK,CAAiC;gBAG3B,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,YAAY;IAGzB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUnD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA2BzG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;YAIxH,YAAY;IAW1B,OAAO,CAAC,IAAI;YAuBE,iBAAiB;CAmBhC"}

package/dist/context/code-map.js

@@ -0,0 +1,187 @@
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { extname, join, relative } from "node:path";
+import { getLogger } from "../logger.js";
+/**
+ * Code map — an AST-extracted index of functions/classes in a target repo.
+ *
+ * v2 only has ONE real mode: local-disk walking (tree-sitter with regex
+ * fallback). cloud-platform-app does not yet expose a remote code-map
+ * endpoint, so `loadRemote` returns empty. Kept as an API hook for when
+ * the platform starts pre-computing code maps.
+ *
+ * We push each node into the vector store so semantic queries work.
+ */
+export class CodeMap {
+    clients;
+    cache;
+    ns = "code-map";
+    local = new Map();
+    constructor(clients, cache) {
+        this.clients = clients;
+        this.cache = cache;
+    }
+    async loadRemote(project_id) {
+        const key = this.cache.key("code-map:remote", { project_id });
+        const hit = this.cache.get(key);
+        if (hit)
+            return hit.value;
+        const { data } = await this.clients.testrelic.getCodeMap(project_id);
+        this.cache.set(key, data, { ttlSeconds: 3_600, namespace: this.ns });
+        await this.indexVectors(data);
+        return data;
+    }
+    async loadLocal(repoRoot, opts = {}) {
+        if (this.local.has(repoRoot))
+            return this.local.get(repoRoot);
+        const extensions = new Set(opts.extensions ?? [".ts", ".tsx", ".js", ".jsx"]);
+        const nodes = [];
+        const files = [];
+        this.walk(repoRoot, extensions, files, opts.maxFiles ?? 2_500);
+        const parser = await this.tryLoadTreeSitter();
+        for (const file of files) {
+            let text;
+            try {
+                text = readFileSync(file, "utf-8");
+            }
+            catch {
+                continue;
+            }
+            const rel = relative(repoRoot, file);
+            if (parser) {
+                nodes.push(...extractWithTreeSitter(parser, rel, text));
+            }
+            else {
+                nodes.push(...extractWithRegex(rel, text));
+            }
+        }
+        this.local.set(repoRoot, nodes);
+        await this.indexVectors(nodes);
+        return nodes;
+    }
+    async search(query, k = 8) {
+        return this.cache.vector.search(query, k);
+    }
+    async indexVectors(nodes) {
+        for (const n of nodes) {
+            const text = `${n.kind} ${n.name} in ${n.file} (lines ${n.start_line}-${n.end_line}) ${(n.tags ?? []).join(" ")}`;
+            await this.cache.vector.upsert({
+                id: n.id,
+                text,
+                meta: { file: n.file, kind: n.kind, name: n.name, start_line: n.start_line, end_line: n.end_line },
+            });
+        }
+    }
+    walk(dir, exts, out, limit) {
+        if (out.length >= limit)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (out.length >= limit)
+                return;
+            if (e === "node_modules" || e.startsWith(".") || e === "dist" || e === "build")
+                continue;
+            const p = join(dir, e);
+            let st;
+            try {
+                st = statSync(p);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory())
+                this.walk(p, exts, out, limit);
+            else if (exts.has(extname(e)))
+                out.push(p);
+        }
+    }
+    async tryLoadTreeSitter() {
+        try {
+            // @ts-ignore optional native dep
+            const tsMod = await import("tree-sitter").catch(() => null);
+            // @ts-ignore optional native dep
+            const langMod = await import("tree-sitter-typescript").catch(() => null);
+            if (!tsMod || !langMod)
+                return null;
+            const raw = tsMod;
+            const Parser = raw.default ?? raw;
+            const parser = new Parser();
+            const tsLang = langMod.typescript ?? langMod.default?.typescript;
+            parser.setLanguage(tsLang);
+            return parser;
+        }
+        catch (err) {
+            getLogger().debug({ err }, "tree-sitter unavailable, using regex fallback");
+            return null;
+        }
+    }
+}
+function extractWithTreeSitter(parser, file, text) {
+    // Keep the AST walk minimal — we just want function/class nodes.
+    try {
+        const tree = parser.parse(text);
+        const nodes = [];
+        walkAst(tree.rootNode, file, nodes);
+        return nodes;
+    }
+    catch {
+        return extractWithRegex(file, text);
+    }
+}
+function walkAst(node, file, out) {
+    const kindMap = {
+        function_declaration: "function",
+        method_definition: "method",
+        class_declaration: "class",
+        arrow_function: "function",
+        function: "function",
+    };
+    const kind = kindMap[node.type];
+    if (kind) {
+        const nameNode = node.childForFieldName("name");
+        const name = nameNode?.text ?? "<anonymous>";
+        out.push({
+            id: `${file}:${name}:${node.startPosition.row + 1}`,
+            file,
+            name,
+            kind,
+            start_line: node.startPosition.row + 1,
+            end_line: node.endPosition.row + 1,
+        });
+    }
+    for (const child of node.namedChildren ?? [])
+        walkAst(child, file, out);
+}
+function extractWithRegex(file, text) {
+    const out = [];
+    const lines = text.split(/\r?\n/);
+    const patterns = [
+        { re: /^\s*(?:export\s+)?(?:async\s+)?function\s+(\w+)/g, kind: "function" },
+        { re: /^\s*(?:export\s+)?class\s+(\w+)/g, kind: "class" },
+        { re: /^\s*(?:public|private|protected)?\s*(?:async\s+)?(\w+)\s*\([^)]*\)\s*[:{]/g, kind: "method" },
+    ];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        for (const { re, kind } of patterns) {
+            re.lastIndex = 0;
+            const m = re.exec(line);
+            if (m && m[1]) {
+                out.push({
+                    id: `${file}:${m[1]}:${i + 1}`,
+                    file,
+                    name: m[1],
+                    kind,
+                    start_line: i + 1,
+                    end_line: i + 1,
+                });
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=code-map.js.map

package/dist/context/code-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-map.js","sourceRoot":"","sources":["../../src/context/code-map.ts"],"names":[],"mappings":"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"}

package/dist/context/correlator.d.ts

@@ -0,0 +1,32 @@
+import type { CoverageGap, CoverageReport, UserJourney } from "../types/index.js";
+import type { CoverageMap } from "./coverage-map.js";
+import type { JourneyGraph } from "./journey-graph.js";
+/**
+ * Correlator — the canonical 95% formulas live here.
+ *
+ *   userCoverage  = |{j ∈ top_journeys: ∃ test mapping to j}| / |top_journeys|
+ *   testCoverage  = |covered_code_nodes| / |reachable_code_nodes_from_journeys|
+ *
+ * We also compute the *weighted* user coverage (by Amplitude user count) which
+ * is what product teams care about in practice: covering one high-traffic
+ * journey is worth more than covering ten long-tail ones.
+ */
+export interface CorrelationResult {
+    user_coverage: number;
+    user_coverage_weighted: number;
+    test_coverage: number;
+    covered_journey_ids: string[];
+    uncovered_journeys: UserJourney[];
+    total_journeys: number;
+    total_users_tracked: number;
+    total_users_covered: number;
+}
+export declare class Correlator {
+    private readonly journeys;
+    private readonly coverage;
+    constructor(journeys: JourneyGraph, coverage: CoverageMap);
+    correlate(project_id: string): Promise<CorrelationResult>;
+    coverageReport(project_id: string): Promise<CoverageReport>;
+    rankedGaps(project_id: string, limit?: number): Promise<CoverageGap[]>;
+}
+//# sourceMappingURL=correlator.d.ts.map

package/dist/context/correlator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlator.d.ts","sourceRoot":"","sources":["../../src/context/correlator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAqB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;GASG;AAEH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,kBAAkB,EAAE,WAAW,EAAE,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,WAAW;IAG3B,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0CzD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAoB3D,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAsBhF"}

package/dist/context/correlator.js

@@ -0,0 +1,106 @@
+export class Correlator {
+    journeys;
+    coverage;
+    constructor(journeys, coverage) {
+        this.journeys = journeys;
+        this.coverage = coverage;
+    }
+    async correlate(project_id) {
+        const [top, testMap] = await Promise.all([
+            this.journeys.top(project_id, 500),
+            this.coverage.load(project_id),
+        ]);
+        const journeysCoveredByTest = new Set();
+        const codeNodesCovered = new Set();
+        const codeNodesReachable = new Set();
+        for (const entry of testMap) {
+            for (const jid of entry.journey_ids)
+                journeysCoveredByTest.add(jid);
+            for (const cn of entry.code_node_ids)
+                codeNodesCovered.add(cn);
+        }
+        // Treat every journey's implied nodes as reachable — the test map encodes
+        // (test, node) pairs. For "reachable" we use the union of *all* code nodes
+        // appearing anywhere in the test map as our denominator, which is a proxy
+        // for "reachable from the app's exercised surface".
+        for (const entry of testMap) {
+            for (const cn of entry.code_node_ids)
+                codeNodesReachable.add(cn);
+        }
+        const totalJourneys = top.length;
+        const coveredCount = top.filter((j) => journeysCoveredByTest.has(j.id)).length;
+        const totalUsers = top.reduce((s, j) => s + (j.user_count ?? 0), 0) || 1;
+        const coveredUsers = top
+            .filter((j) => journeysCoveredByTest.has(j.id))
+            .reduce((s, j) => s + (j.user_count ?? 0), 0);
+        return {
+            user_coverage: totalJourneys > 0 ? coveredCount / totalJourneys : 0,
+            user_coverage_weighted: coveredUsers / totalUsers,
+            test_coverage: codeNodesReachable.size > 0 ? codeNodesCovered.size / codeNodesReachable.size : 0,
+            covered_journey_ids: Array.from(journeysCoveredByTest),
+            uncovered_journeys: top.filter((j) => !journeysCoveredByTest.has(j.id)),
+            total_journeys: totalJourneys,
+            total_users_tracked: totalUsers,
+            total_users_covered: coveredUsers,
+        };
+    }
+    async coverageReport(project_id) {
+        const r = await this.correlate(project_id);
+        return {
+            project_id,
+            generated_at: new Date().toISOString(),
+            user_coverage: r.user_coverage,
+            test_coverage: r.test_coverage,
+            total_journeys: r.total_journeys,
+            covered_journeys: r.total_journeys - r.uncovered_journeys.length,
+            uncovered_journeys: r.uncovered_journeys.length,
+            total_code_nodes: r.total_users_tracked > 0 ? Math.round(r.total_users_tracked) : 0,
+            covered_code_nodes: Math.round(r.total_users_covered),
+            gaps_summary: r.uncovered_journeys.slice(0, 5).map((j) => ({
+                journey_id: j.id,
+                user_count: j.user_count,
+                reason: j.events.join(" → "),
+            })),
+        };
+    }
+    async rankedGaps(project_id, limit = 20) {
+        const r = await this.correlate(project_id);
+        const total = r.total_users_tracked || 1;
+        const testMap = await this.coverage.load(project_id);
+        const gaps = r.uncovered_journeys
+            .sort((a, b) => (b.user_count ?? 0) - (a.user_count ?? 0))
+            .slice(0, limit)
+            .map((j) => {
+            const partialOverlaps = findPartialOverlaps(j, testMap);
+            return {
+                journey_id: j.id,
+                journey_name: j.name,
+                user_count: j.user_count,
+                session_count: j.session_count,
+                events: j.events,
+                pp_coverage_gain: (j.user_count / total) * 100,
+                partial_overlaps: partialOverlaps.length > 0 ? partialOverlaps : undefined,
+            };
+        });
+        return gaps;
+    }
+}
+function findPartialOverlaps(journey, testMap) {
+    const jevents = new Set(journey.events);
+    return testMap
+        .map((t) => {
+        // Overlap proxy: if the test touches at least one event in the journey
+        // via tags like `@journey:<id>` or `@event:<name>`, we consider partial.
+        const tagEvents = (t.tags ?? []).filter((tag) => tag.startsWith("@event:")).map((tag) => tag.replace("@event:", ""));
+        let matches = 0;
+        for (const e of tagEvents)
+            if (jevents.has(e))
+                matches++;
+        const overlap = matches / journey.events.length;
+        return { test_id: t.test_id, overlap };
+    })
+        .filter((x) => x.overlap > 0)
+        .sort((a, b) => b.overlap - a.overlap)
+        .slice(0, 3);
+}
+//# sourceMappingURL=correlator.js.map

package/dist/context/correlator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlator.js","sourceRoot":"","sources":["../../src/context/correlator.ts"],"names":[],"mappings":"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"}

package/dist/context/coverage-map.d.ts

@@ -0,0 +1,25 @@
+import type { CacheManager } from "../cache/index.js";
+import type { ClientBundle } from "../clients/index.js";
+import type { TestCoverageEntry } from "../types/index.js";
+/**
+ * Coverage map — `test_id -> { journey_ids[], code_node_ids[] }`.
+ *
+ * Built from three sources server-side:
+ *   1. Run artefacts (inferred network calls, selectors touched).
+ *   2. Static tags on tests (e.g. `@journey:checkout-guest`).
+ *   3. AST-extracted API calls (best-effort).
+ *
+ * This module just caches the platform's `/test-map` response.
+ */
+export declare class CoverageMap {
+    private readonly clients;
+    private readonly cache;
+    private readonly ns;
+    constructor(clients: ClientBundle, cache: CacheManager);
+    load(project_id: string): Promise<TestCoverageEntry[]>;
+    byTestId(project_id: string, test_id: string): Promise<TestCoverageEntry | undefined>;
+    testsCoveringJourney(project_id: string, journey_id: string): Promise<TestCoverageEntry[]>;
+    testsTouchingCodeNode(project_id: string, code_node_id: string): Promise<TestCoverageEntry[]>;
+    invalidate(): void;
+}
+//# sourceMappingURL=coverage-map.d.ts.map