@kryptosai/mcp-observatory 0.3.0

package/dist/src/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAI1E,MAAM,UAAU,oBAAoB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,aAAqB;IACzD,MAAM,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAqB,EACrB,MAAc;IAEd,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,OAAO,CACrE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CACzB,OAAO,CAAC;IACT,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5E,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAK,IAAgC,CAAC,cAAc,CAAC,KAAK,MAAM,EAAE,CAAC;QACtI,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IACD,+EAA+E;IAC/E,mEAAmE;IACnE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAK,IAAgC,CAAC,cAAc,CAAC,KAAK,KAAK,EAAE,CAAC;QACrI,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,sGAAsG;IACtG,OAAO,IAAgB,CAAC;AAC1B,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,120 @@
+export declare const SCHEMA_VERSION = "1.0.0";
+export type ArtifactType = "run" | "diff";
+export type Gate = "pass" | "fail";
+export type CheckStatus = "pass" | "fail" | "partial" | "unsupported" | "flaky" | "skipped";
+export type CheckId = "tools" | "prompts" | "resources" | "tools-invoke";
+export declare const STATUS_RANK: Record<CheckStatus, number>;
+export interface LocalProcessTargetConfig {
+    targetId: string;
+    adapter: "local-process";
+    command: string;
+    args: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    timeoutMs?: number;
+    metadata?: Record<string, string>;
+}
+export interface HttpTargetConfig {
+    targetId: string;
+    adapter: "http";
+    url: string;
+    authToken?: string;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    metadata?: Record<string, string>;
+}
+export type TargetConfig = LocalProcessTargetConfig | HttpTargetConfig;
+export interface TargetSnapshot {
+    targetId: string;
+    adapter: TargetConfig["adapter"];
+    command: string;
+    args: string[];
+    url?: string;
+    cwd?: string;
+    metadata?: Record<string, string>;
+    serverVersion?: string;
+    serverName?: string;
+}
+export interface EnvironmentSnapshot {
+    platform: string;
+    nodeVersion: string;
+}
+export interface EvidenceSummary {
+    endpoint: string;
+    advertised: boolean;
+    responded: boolean;
+    minimalShapePresent: boolean;
+    itemCount?: number;
+    identifiers?: string[];
+    diagnostics?: string[];
+    schemas?: Record<string, object>;
+}
+export interface CheckResult {
+    id: CheckId;
+    capability: CheckId;
+    status: CheckStatus;
+    durationMs: number;
+    message: string;
+    evidence: EvidenceSummary[];
+}
+export interface StatusCounts {
+    total: number;
+    pass: number;
+    fail: number;
+    partial: number;
+    unsupported: number;
+    flaky: number;
+    skipped: number;
+}
+export interface RunSummary extends StatusCounts {
+    gate: Gate;
+}
+export interface RunArtifact {
+    artifactType: "run";
+    schemaVersion: typeof SCHEMA_VERSION;
+    gate: Gate;
+    runId: string;
+    createdAt: string;
+    toolVersion: string;
+    target: TargetSnapshot;
+    environment: EnvironmentSnapshot;
+    summary: RunSummary;
+    checks: CheckResult[];
+    fatalError?: string;
+}
+export interface DiffEntry {
+    id: CheckId;
+    capability: CheckId;
+    fromStatus?: CheckStatus;
+    toStatus?: CheckStatus;
+    message: string;
+}
+export interface SchemaDriftEntry {
+    capability: CheckId;
+    name: string;
+    changes: string[];
+}
+export interface DiffSummary {
+    regressions: number;
+    recoveries: number;
+    unchanged: number;
+    added: number;
+    removed: number;
+    schemaDriftCount?: number;
+    gate: Gate;
+}
+export interface DiffArtifact {
+    artifactType: "diff";
+    schemaVersion: typeof SCHEMA_VERSION;
+    gate: Gate;
+    baseRunId: string;
+    headRunId: string;
+    createdAt: string;
+    summary: DiffSummary;
+    regressions: DiffEntry[];
+    recoveries: DiffEntry[];
+    unchanged: DiffEntry[];
+    added: DiffEntry[];
+    removed: DiffEntry[];
+    schemaDrift?: SchemaDriftEntry[];
+}

package/dist/src/types.js

@@ -0,0 +1,5 @@
+export const SCHEMA_VERSION = "1.0.0";
+export const STATUS_RANK = {
+    pass: 6, partial: 5, flaky: 4, unsupported: 3, skipped: 2, fail: 1
+};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAatC,MAAM,CAAC,MAAM,WAAW,GAAgC;IACtD,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;CACnE,CAAC"}

package/dist/src/utils/failure-diagnosis.d.ts

@@ -0,0 +1,2 @@
+import type { TargetConfig } from "../types.js";
+export declare function formatConnectionFailureDiagnosis(target: TargetConfig, rawMessage: string, stderrLines: string[]): string;

package/dist/src/utils/failure-diagnosis.js

@@ -0,0 +1,90 @@
+function buildCommand(target) {
+    if (target.adapter === "http") {
+        return target.url;
+    }
+    return [target.command, ...target.args].join(" ");
+}
+function trimLines(lines, limit = 5) {
+    return lines.slice(-limit);
+}
+function classifyFailure(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes("timed out")) {
+        return {
+            diagnosis: "The server did not complete MCP initialization before the configured timeout.",
+            likelyCauses: [
+                "The package may start a browser, app shell, or background service instead of staying attached to stdio.",
+                "The target may need extra startup flags, credentials, or environment variables before it becomes usable.",
+                "The timeout may simply be too low for this package on first boot."
+            ],
+            nextSteps: [
+                "Run the command manually and confirm it stays attached to stdio instead of launching and idling elsewhere.",
+                "Check the package docs for required flags, auth, or setup steps before MCP initialization.",
+                "If the command is otherwise correct, raise `timeoutMs` and try again."
+            ]
+        };
+    }
+    if (lower.includes("connection closed") || lower.includes("closed")) {
+        return {
+            diagnosis: "The process exited or detached before MCP initialization completed.",
+            likelyCauses: [
+                "The package may expect extra startup arguments or environment variables.",
+                "The package may not behave like a plain local-process stdio target under this invocation.",
+                "The server may be crashing immediately and only leaving clues on stderr."
+            ],
+            nextSteps: [
+                "Run the command manually and look for usage output, auth prompts, or crash text.",
+                "Check whether the package expects a different transport or an app-oriented startup flow.",
+                "Use the recent stderr lines below before assuming this is a harness bug."
+            ]
+        };
+    }
+    if (lower.includes("enoent") || lower.includes("spawn")) {
+        return {
+            diagnosis: "The command could not be started successfully.",
+            likelyCauses: [
+                "The executable may be missing from PATH.",
+                "The target may need `npx` or a different command name.",
+                "The cwd or local package layout may not match the intended invocation."
+            ],
+            nextSteps: [
+                "Run the command manually and confirm the executable exists.",
+                "Switch to `npx -y <package>` or an explicit binary path if needed.",
+                "Double-check the target `cwd`, `command`, and `args` values."
+            ]
+        };
+    }
+    return {
+        diagnosis: "The target did not behave like a healthy plain stdio MCP server during startup.",
+        likelyCauses: [
+            "The package may need additional startup configuration.",
+            "The package may prefer a different transport or runtime shape.",
+            "The process may be failing before MCP initialize is reachable."
+        ],
+        nextSteps: [
+            "Run the command manually and inspect stdout/stderr behavior.",
+            "Check package docs for startup requirements before assuming protocol failure.",
+            "Treat this as ecosystem signal first; only change the harness if the package should work over stdio as invoked."
+        ]
+    };
+}
+export function formatConnectionFailureDiagnosis(target, rawMessage, stderrLines) {
+    const details = classifyFailure(rawMessage);
+    const recentStderr = trimLines(stderrLines);
+    const lines = [
+        `Could not establish a plain stdio MCP session for target \`${target.targetId}\`.`,
+        `Command: ${buildCommand(target)}`,
+        `Diagnosis: ${details.diagnosis}`,
+        `Raw error: ${rawMessage}`,
+        `Likely causes:`,
+        ...details.likelyCauses.map((cause) => `- ${cause}`),
+        `Next steps:`,
+        ...details.nextSteps.map((step) => `- ${step}`)
+    ];
+    if (recentStderr.length > 0) {
+        lines.push("Recent stderr:");
+        lines.push(...recentStderr.map((line) => `- ${line}`));
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=failure-diagnosis.js.map

package/dist/src/utils/failure-diagnosis.js.map

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

package/dist/src/utils/ids.d.ts

@@ -0,0 +1,2 @@
+export declare function buildRunId(date?: Date): string;
+export declare function slugify(value: string): string;

package/dist/src/utils/ids.js

@@ -0,0 +1,13 @@
+import { randomUUID } from "node:crypto";
+export function buildRunId(date = new Date()) {
+    const timestamp = date.toISOString().replaceAll(":", "").replaceAll(".", "");
+    return `run_${timestamp}_${randomUUID().slice(0, 8)}`;
+}
+export function slugify(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 64);
+}
+//# sourceMappingURL=ids.js.map

package/dist/src/utils/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/utils/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,UAAU,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7E,OAAO,OAAO,SAAS,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/src/utils/schema-stub.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generate minimal valid JSON from a JSON Schema inputSchema.
+ * Used to construct arguments for safe tool invocation during health checks.
+ */
+export declare function stubFromSchema(schema: Record<string, unknown> | undefined): Record<string, unknown>;
+/**
+ * Returns true if a tool is safe to invoke during health checks:
+ * - Has no required parameters, OR
+ * - Has readOnlyHint annotation set to true
+ */
+export declare function isSafeToInvoke(tool: {
+    inputSchema?: Record<string, unknown>;
+    annotations?: Record<string, unknown>;
+}): boolean;

package/dist/src/utils/schema-stub.js

@@ -0,0 +1,61 @@
+/**
+ * Generate minimal valid JSON from a JSON Schema inputSchema.
+ * Used to construct arguments for safe tool invocation during health checks.
+ */
+export function stubFromSchema(schema) {
+    if (schema === undefined) {
+        return {};
+    }
+    const required = Array.isArray(schema["required"]) ? schema["required"] : [];
+    const properties = (schema["properties"] ?? {});
+    if (required.length === 0) {
+        return {};
+    }
+    const stub = {};
+    for (const field of required) {
+        const prop = properties[field];
+        stub[field] = stubValue(prop);
+    }
+    return stub;
+}
+function stubValue(prop) {
+    if (prop === undefined) {
+        return "";
+    }
+    switch (prop["type"]) {
+        case "string":
+            return "";
+        case "number":
+        case "integer":
+            return 0;
+        case "boolean":
+            return false;
+        case "array":
+            return [];
+        case "object":
+            return {};
+        default:
+            return "";
+    }
+}
+/**
+ * Returns true if a tool is safe to invoke during health checks:
+ * - Has no required parameters, OR
+ * - Has readOnlyHint annotation set to true
+ */
+export function isSafeToInvoke(tool) {
+    const annotations = tool.annotations;
+    if (annotations?.["readOnlyHint"] === true) {
+        return true;
+    }
+    const schema = tool.inputSchema;
+    if (schema === undefined) {
+        return true;
+    }
+    const required = schema["required"];
+    if (!Array.isArray(required) || required.length === 0) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=schema-stub.js.map

package/dist/src/utils/schema-stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-stub.js","sourceRoot":"","sources":["../../../src/utils/schema-stub.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAA2C;IACxE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAE,MAAM,CAAC,UAAU,CAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAA4C,CAAC;IAE3F,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,IAAyC;IAC1D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,QAAQ,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC;QACf,KAAK,OAAO;YACV,OAAO,EAAE,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC;QACZ;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAG9B;IACC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACrC,IAAI,WAAW,EAAE,CAAC,cAAc,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;IAChC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/validate.d.ts

@@ -0,0 +1,4 @@
+import type { DiffArtifact, RunArtifact, TargetConfig } from "./types.js";
+export declare function validateTargetConfig(data: unknown): TargetConfig;
+export declare function validateRunArtifact(data: unknown): RunArtifact;
+export declare function validateDiffArtifact(data: unknown): DiffArtifact;

package/dist/src/validate.js

@@ -0,0 +1,97 @@
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireString(obj, field, label) {
+    const value = obj[field];
+    if (typeof value !== "string" || value.length === 0) {
+        throw new Error(`${label} is missing required field '${field}'.`);
+    }
+    return value;
+}
+function requireArray(obj, field, label) {
+    const value = obj[field];
+    if (!Array.isArray(value)) {
+        throw new Error(`${label} is missing required field '${field}' (expected an array).`);
+    }
+    return value;
+}
+export function validateTargetConfig(data) {
+    if (!isObject(data)) {
+        throw new Error("Target config must be a JSON object.");
+    }
+    const targetId = requireString(data, "targetId", "Target config");
+    const adapter = requireString(data, "adapter", "Target config");
+    if (adapter === "http") {
+        const url = requireString(data, "url", "Target config");
+        return {
+            targetId,
+            adapter: "http",
+            url,
+            authToken: typeof data["authToken"] === "string" ? data["authToken"] : undefined,
+            headers: isObject(data["headers"]) ? data["headers"] : undefined,
+            timeoutMs: typeof data["timeoutMs"] === "number" ? data["timeoutMs"] : undefined,
+            metadata: isObject(data["metadata"]) ? data["metadata"] : undefined,
+        };
+    }
+    if (adapter !== "local-process") {
+        throw new Error(`Target config has unsupported adapter '${adapter}'. Supported: 'local-process', 'http'.`);
+    }
+    const command = requireString(data, "command", "Target config");
+    const argsRaw = requireArray(data, "args", "Target config");
+    const args = argsRaw.map((arg, i) => {
+        if (typeof arg !== "string") {
+            throw new Error(`Target config args[${i}] must be a string.`);
+        }
+        return arg;
+    });
+    return {
+        targetId,
+        adapter,
+        command,
+        args,
+        cwd: typeof data["cwd"] === "string" ? data["cwd"] : undefined,
+        env: isObject(data["env"]) ? data["env"] : undefined,
+        timeoutMs: typeof data["timeoutMs"] === "number" ? data["timeoutMs"] : undefined,
+        metadata: isObject(data["metadata"]) ? data["metadata"] : undefined,
+    };
+}
+export function validateRunArtifact(data) {
+    if (!isObject(data)) {
+        throw new Error("Expected a run artifact but got a non-object value.");
+    }
+    if (data["artifactType"] !== "run") {
+        throw new Error(`Expected a run artifact but got artifactType='${String(data["artifactType"])}'.`);
+    }
+    requireString(data, "runId", "Run artifact");
+    requireString(data, "createdAt", "Run artifact");
+    requireString(data, "schemaVersion", "Run artifact");
+    requireString(data, "toolVersion", "Run artifact");
+    requireArray(data, "checks", "Run artifact");
+    if (!isObject(data["target"])) {
+        throw new Error("Run artifact is missing required field 'target'.");
+    }
+    if (!isObject(data["environment"])) {
+        throw new Error("Run artifact is missing required field 'environment'.");
+    }
+    if (!isObject(data["summary"])) {
+        throw new Error("Run artifact is missing required field 'summary'.");
+    }
+    return data;
+}
+export function validateDiffArtifact(data) {
+    if (!isObject(data)) {
+        throw new Error("Expected a diff artifact but got a non-object value.");
+    }
+    if (data["artifactType"] !== "diff") {
+        throw new Error(`Expected a diff artifact but got artifactType='${String(data["artifactType"])}'.`);
+    }
+    requireString(data, "baseRunId", "Diff artifact");
+    requireString(data, "headRunId", "Diff artifact");
+    requireString(data, "createdAt", "Diff artifact");
+    requireString(data, "schemaVersion", "Diff artifact");
+    if (!isObject(data["summary"])) {
+        throw new Error("Diff artifact is missing required field 'summary'.");
+    }
+    return data;
+}
+//# sourceMappingURL=validate.js.map

package/dist/src/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/validate.ts"],"names":[],"mappings":"AAEA,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,aAAa,CAAC,GAA4B,EAAE,KAAa,EAAE,KAAa;IAC/E,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,+BAA+B,KAAK,IAAI,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,GAA4B,EAAE,KAAa,EAAE,KAAa;IAC9E,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,+BAA+B,KAAK,wBAAwB,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IAEhE,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;QACxD,OAAO;YACL,QAAQ;YACR,OAAO,EAAE,MAAM;YACf,GAAG;YACH,SAAS,EAAE,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;YAChF,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAA2B,CAAC,CAAC,CAAC,SAAS;YAC1F,SAAS,EAAE,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;YAChF,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAA2B,CAAC,CAAC,CAAC,SAAS;SAC9F,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,eAAe,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,0CAA0C,OAAO,wCAAwC,CAAC,CAAC;IAC7G,CAAC;IAED,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAClC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ;QACR,OAAO;QACP,OAAO;QACP,IAAI;QACJ,GAAG,EAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QAC9D,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAA2B,CAAC,CAAC,CAAC,SAAS;QAC9E,SAAS,EAAE,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;QAChF,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAA2B,CAAC,CAAC,CAAC,SAAS;KAC9F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,KAAK,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,iDAAiD,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC;IACrG,CAAC;IACD,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC7C,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IACjD,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;IACrD,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;IACnD,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IAE7C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,IAA8B,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,MAAM,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,kDAAkD,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC;IACtG,CAAC;IACD,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;IAClD,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;IAClD,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;IAClD,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;IAEtD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,IAA+B,CAAC;AACzC,CAAC"}

package/dist/src/version.d.ts

@@ -0,0 +1 @@
+export declare const TOOL_VERSION: string;

package/dist/src/version.js

@@ -0,0 +1,21 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+function resolveVersion() {
+    const dir = path.dirname(fileURLToPath(import.meta.url));
+    // Walk up looking for package.json (works in both src/ dev and dist/src/ packed)
+    for (const relative of ["../package.json", "../../package.json"]) {
+        try {
+            const content = readFileSync(path.resolve(dir, relative), "utf8");
+            const pkg = JSON.parse(content);
+            if (pkg.version)
+                return pkg.version;
+        }
+        catch {
+            // continue searching
+        }
+    }
+    return "0.0.0";
+}
+export const TOOL_VERSION = resolveVersion();
+//# sourceMappingURL=version.js.map

package/dist/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,SAAS,cAAc;IACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,iFAAiF;IACjF,KAAK,MAAM,QAAQ,IAAI,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,EAAE,CAAC;QACjE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;YAClE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAyB,CAAC;YACxD,IAAI,GAAG,CAAC,OAAO;gBAAE,OAAO,GAAG,CAAC,OAAO,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@kryptosai/mcp-observatory",
+  "version": "0.3.0",
+  "description": "Regression intelligence for MCP targets: detect, diff, and explain interoperability drift over time.",
+  "license": "MIT",
+  "type": "module",
+  "private": false,
+  "homepage": "https://github.com/KryptosAI/mcp-observatory#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KryptosAI/mcp-observatory.git"
+  },
+  "bugs": {
+    "url": "https://github.com/KryptosAI/mcp-observatory/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": "./dist/src/index.js"
+  },
+  "bin": {
+    "mcp-observatory": "./dist/src/cli.js"
+  },
+  "files": [
+    "dist/src",
+    "README.md",
+    "LICENSE",
+    "schemas"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "cli": "tsx src/cli.ts",
+    "integration:real": "tsx scripts/run-real-server-matrix.ts",
+    "lint": "eslint .",
+    "prepack": "npm run build",
+    "proof:refresh": "tsx scripts/refresh-proof-artifacts.ts",
+    "release:prep": "node scripts/release.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "validate:artifacts": "tsx scripts/validate-artifacts.ts",
+    "verify:packed-install": "node scripts/verify-packed-install.mjs",
+    "smoke": "npm run cli -- run --target tests/fixtures/sample-target-config.json && npm run cli -- diff --base tests/fixtures/sample-run-a.json --head tests/fixtures/sample-run-b.json"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cli",
+    "regression-testing",
+    "interoperability",
+    "observability"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "commander": "14.0.2"
+  },
+  "devDependencies": {
+    "ajv": "8.17.1",
+    "@eslint/js": "9.39.1",
+    "@types/node": "24.10.1",
+    "@typescript-eslint/eslint-plugin": "8.46.3",
+    "@typescript-eslint/parser": "8.46.3",
+    "eslint": "9.39.1",
+    "globals": "16.5.0",
+    "tsx": "4.20.6",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.46.3",
+    "vitest": "4.0.8",
+    "zod": "4.1.12"
+  }
+}