raven-mcp 1.7.0 → 1.8.0

package/dist/api-contract.d.ts

@@ -0,0 +1,36 @@
+export type ShapeSchema = {
+    required?: string[];
+    types?: Record<string, "string" | "number" | "boolean" | "object" | "array">;
+};
+export type Query = {
+    name: string;
+    method?: "GET" | "POST";
+    path?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    expect?: {
+        contains?: string[];
+        equals?: Record<string, unknown>;
+    };
+};
+export type QueryVerdict = {
+    name: string;
+    verdict: "shape-valid" | "shape-invalid" | "confident-wrong" | "uncertain";
+    reason: string;
+    offending?: string;
+    status?: number;
+};
+export type ApiContractResult = {
+    results: QueryVerdict[];
+    shape_valid_count: number;
+    confident_wrong_count: number;
+    shape_invalid_count: number;
+    uncertain_count: number;
+};
+export declare function getPath(obj: unknown, path: string): unknown;
+export declare function validateShape(response: unknown, schema: ShapeSchema): {
+    valid: boolean;
+    offending?: string;
+    reason: string;
+};
+export declare function runApiContract(endpointUrl: string, queries: Query[], schema: ShapeSchema): Promise<ApiContractResult>;

package/dist/api-contract.js

@@ -0,0 +1,235 @@
+export function getPath(obj, path) {
+    const segments = path.split(".");
+    let current = obj;
+    for (let index = 0; index < segments.length; index += 1) {
+        const segment = segments[index];
+        if (Array.isArray(current)) {
+            if (!isArrayIndex(segment)) {
+                return undefined;
+            }
+            const arrayIndex = Number(segment);
+            if (arrayIndex >= current.length) {
+                return undefined;
+            }
+            current = current[arrayIndex];
+            continue;
+        }
+        if (!isRecord(current)) {
+            return undefined;
+        }
+        if (!Object.prototype.hasOwnProperty.call(current, segment)) {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+export function validateShape(response, schema) {
+    const required = schema.required || [];
+    for (let index = 0; index < required.length; index += 1) {
+        const path = required[index];
+        if (getPath(response, path) === undefined) {
+            return {
+                valid: false,
+                offending: path,
+                reason: "missing required path: " + path
+            };
+        }
+    }
+    const types = schema.types || {};
+    const entries = Object.entries(types);
+    for (let index = 0; index < entries.length; index += 1) {
+        const path = entries[index][0];
+        const expected = entries[index][1];
+        const value = getPath(response, path);
+        if (value === undefined) {
+            continue;
+        }
+        if (!matchesType(value, expected)) {
+            return {
+                valid: false,
+                offending: path,
+                reason: "type mismatch at " + path + ": expected " + expected
+            };
+        }
+    }
+    return { valid: true, reason: "all checks passed" };
+}
+export async function runApiContract(endpointUrl, queries, schema) {
+    const results = [];
+    for (let index = 0; index < queries.length; index += 1) {
+        const query = queries[index];
+        const controller = new AbortController();
+        const timeout = setTimeout(function abortRequest() {
+            controller.abort();
+        }, 10000);
+        let response;
+        try {
+            response = await fetch(endpointUrl + (query.path || ""), {
+                method: query.method || "GET",
+                headers: requestHeaders(query),
+                body: query.method === "POST" ? JSON.stringify(query.body) : undefined,
+                signal: controller.signal
+            });
+        }
+        catch (error) {
+            results.push({
+                name: query.name,
+                verdict: "uncertain",
+                reason: errorMessage(error)
+            });
+            clearTimeout(timeout);
+            continue;
+        }
+        clearTimeout(timeout);
+        let parsed;
+        try {
+            parsed = await response.json();
+        }
+        catch {
+            results.push({
+                name: query.name,
+                verdict: "uncertain",
+                reason: "non-JSON response",
+                status: response.status
+            });
+            continue;
+        }
+        if (response.status < 200 || response.status >= 300) {
+            results.push({
+                name: query.name,
+                verdict: "uncertain",
+                reason: "HTTP " + response.status,
+                status: response.status
+            });
+            continue;
+        }
+        const shape = validateShape(parsed, schema);
+        if (!shape.valid) {
+            results.push({
+                name: query.name,
+                verdict: "shape-invalid",
+                reason: shape.reason,
+                offending: shape.offending,
+                status: response.status
+            });
+            continue;
+        }
+        const expected = query.expect;
+        const confidentWrong = expected ? checkExpectations(parsed, expected) : null;
+        if (confidentWrong) {
+            results.push({
+                name: query.name,
+                verdict: "confident-wrong",
+                reason: confidentWrong.reason,
+                offending: confidentWrong.offending,
+                status: response.status
+            });
+            continue;
+        }
+        results.push({
+            name: query.name,
+            verdict: "shape-valid",
+            reason: "all checks passed",
+            status: response.status
+        });
+    }
+    return tallyResults(results);
+}
+function isArrayIndex(segment) {
+    return /^\d+$/.test(segment);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function matchesType(value, expected) {
+    if (expected === "array") {
+        return Array.isArray(value);
+    }
+    if (expected === "object") {
+        return typeof value === "object" && value !== null && !Array.isArray(value);
+    }
+    return typeof value === expected;
+}
+function requestHeaders(query) {
+    if (!query.headers && query.method !== "POST") {
+        return undefined;
+    }
+    const headers = { ...(query.headers || {}) };
+    if (query.method === "POST" && !hasHeader(headers, "content-type")) {
+        headers["Content-Type"] = "application/json";
+    }
+    return headers;
+}
+function hasHeader(headers, name) {
+    const names = Object.keys(headers);
+    const target = name.toLowerCase();
+    for (let index = 0; index < names.length; index += 1) {
+        if (names[index].toLowerCase() === target) {
+            return true;
+        }
+    }
+    return false;
+}
+function checkExpectations(parsed, expected) {
+    const serialized = JSON.stringify(parsed);
+    const contains = expected.contains || [];
+    for (let index = 0; index < contains.length; index += 1) {
+        const expectedString = contains[index];
+        if (!serialized.includes(expectedString)) {
+            return {
+                reason: "expected string not found: " + expectedString,
+                offending: expectedString
+            };
+        }
+    }
+    const equals = expected.equals || {};
+    const entries = Object.entries(equals);
+    for (let index = 0; index < entries.length; index += 1) {
+        const path = entries[index][0];
+        const expectedValue = entries[index][1];
+        const actualValue = getPath(parsed, path);
+        if (JSON.stringify(actualValue) !== JSON.stringify(expectedValue)) {
+            return {
+                reason: "value mismatch at " + path,
+                offending: path
+            };
+        }
+    }
+    return null;
+}
+function tallyResults(results) {
+    let shapeValidCount = 0;
+    let confidentWrongCount = 0;
+    let shapeInvalidCount = 0;
+    let uncertainCount = 0;
+    for (let index = 0; index < results.length; index += 1) {
+        const result = results[index];
+        if (result.verdict === "shape-valid") {
+            shapeValidCount += 1;
+        }
+        else if (result.verdict === "confident-wrong") {
+            confidentWrongCount += 1;
+        }
+        else if (result.verdict === "shape-invalid") {
+            shapeInvalidCount += 1;
+        }
+        else if (result.verdict === "uncertain") {
+            uncertainCount += 1;
+        }
+    }
+    return {
+        results,
+        shape_valid_count: shapeValidCount,
+        confident_wrong_count: confidentWrongCount,
+        shape_invalid_count: shapeInvalidCount,
+        uncertain_count: uncertainCount
+    };
+}
+function errorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=api-contract.js.map

package/dist/api-contract.js.map

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

package/dist/contract.d.ts

@@ -0,0 +1,29 @@
+export type ContractSpec = {
+    mode?: "tokens" | "envelope";
+    tokens?: string[];
+    fields?: string[];
+    schemaVersionPattern?: string;
+};
+export type FileInput = {
+    path: string;
+    content: string;
+};
+export type LayerReport = {
+    path: string;
+    present: string[];
+    missing: string[];
+    ordering_issues: string[];
+    schema_version?: string | null;
+};
+export type ContractResult = {
+    verdict: "PASS" | "BLOCK";
+    mode: string;
+    layers: LayerReport[];
+    cross_layer: {
+        inconsistent_tokens: string[];
+        schema_versions?: Record<string, string | null>;
+        missing_fields?: Record<string, string[]>;
+    };
+    block_reasons: string[];
+};
+export declare function auditContract(spec: ContractSpec, files: FileInput[]): ContractResult;

package/dist/contract.js

@@ -0,0 +1,310 @@
+export function auditContract(spec, files) {
+    const mode = resolveMode(spec);
+    if (files.length === 0 || isEmptySpec(spec)) {
+        return emptyResult(mode);
+    }
+    if (mode === "envelope") {
+        return auditEnvelopeContract(spec, files);
+    }
+    return auditTokenContract(spec, files);
+}
+function resolveMode(spec) {
+    if (spec.mode) {
+        return spec.mode;
+    }
+    if (spec.tokens && spec.tokens.length > 0) {
+        return "tokens";
+    }
+    if (spec.fields && spec.fields.length > 0) {
+        return "envelope";
+    }
+    if (Array.isArray(spec.tokens)) {
+        return "tokens";
+    }
+    if (Array.isArray(spec.fields)) {
+        return "envelope";
+    }
+    return "tokens";
+}
+function isEmptySpec(spec) {
+    return (!spec.mode &&
+        !Array.isArray(spec.tokens) &&
+        !Array.isArray(spec.fields) &&
+        typeof spec.schemaVersionPattern !== "string");
+}
+function emptyResult(mode) {
+    return {
+        verdict: "PASS",
+        mode,
+        layers: [],
+        cross_layer: {
+            inconsistent_tokens: []
+        },
+        block_reasons: []
+    };
+}
+function auditTokenContract(spec, files) {
+    const tokens = spec.tokens || [];
+    const distinctTokens = uniqueStrings(tokens);
+    const layers = [];
+    for (let i = 0; i < files.length; i += 1) {
+        const file = files[i];
+        layers.push(auditTokenLayer(file, tokens, distinctTokens));
+    }
+    const inconsistentTokens = findInconsistentTokens(distinctTokens, layers);
+    const blockReasons = tokenBlockReasons(layers, inconsistentTokens);
+    return {
+        verdict: blockReasons.length > 0 ? "BLOCK" : "PASS",
+        mode: "tokens",
+        layers,
+        cross_layer: {
+            inconsistent_tokens: inconsistentTokens
+        },
+        block_reasons: blockReasons
+    };
+}
+function auditTokenLayer(file, tokens, distinctTokens) {
+    const present = [];
+    const missing = [];
+    for (let i = 0; i < tokens.length; i += 1) {
+        const token = tokens[i];
+        if (file.content.indexOf(token) !== -1) {
+            present.push(token);
+        }
+        else {
+            missing.push(token);
+        }
+    }
+    return {
+        path: file.path,
+        present,
+        missing,
+        ordering_issues: findOrderingIssues(file.content, distinctTokens)
+    };
+}
+function findOrderingIssues(content, tokens) {
+    const issues = [];
+    for (let i = 0; i < tokens.length; i += 1) {
+        const shorter = tokens[i];
+        const shorterIndex = content.indexOf(shorter);
+        if (shorterIndex === -1) {
+            continue;
+        }
+        for (let j = 0; j < tokens.length; j += 1) {
+            const longer = tokens[j];
+            if (shorter === longer || !hasOrderingRisk(shorter, longer)) {
+                continue;
+            }
+            const longerIndex = content.indexOf(longer);
+            if (longerIndex !== -1 && shorterIndex < longerIndex) {
+                issues.push("token '" +
+                    shorter +
+                    "' appears before longer '" +
+                    longer +
+                    "' — prefix-ordering risk (match longer tokens first)");
+            }
+        }
+    }
+    return issues;
+}
+function hasOrderingRisk(shorter, longer) {
+    if (longer.length <= shorter.length) {
+        return false;
+    }
+    if (longer.indexOf(shorter) !== -1) {
+        return true;
+    }
+    const shorterParts = splitTokenPrefix(shorter);
+    const longerParts = splitTokenPrefix(longer);
+    if (shorterParts.prefix === "" ||
+        shorterParts.prefix !== longerParts.prefix ||
+        shorterParts.body === "" ||
+        shorterParts.body === longerParts.body) {
+        return false;
+    }
+    return longerParts.body.indexOf(shorterParts.body) !== -1;
+}
+function splitTokenPrefix(token) {
+    const match = /^[^A-Za-z0-9_]+/.exec(token);
+    const prefix = match ? match[0] : "";
+    return {
+        prefix,
+        body: token.slice(prefix.length)
+    };
+}
+function findInconsistentTokens(tokens, layers) {
+    const inconsistentTokens = [];
+    for (let i = 0; i < tokens.length; i += 1) {
+        const token = tokens[i];
+        let foundPresent = false;
+        let foundMissing = false;
+        for (let j = 0; j < layers.length; j += 1) {
+            const layer = layers[j];
+            if (layer.present.indexOf(token) !== -1) {
+                foundPresent = true;
+            }
+            if (layer.missing.indexOf(token) !== -1) {
+                foundMissing = true;
+            }
+        }
+        if (foundPresent && foundMissing) {
+            inconsistentTokens.push(token);
+        }
+    }
+    return inconsistentTokens;
+}
+function tokenBlockReasons(layers, inconsistentTokens) {
+    const blockReasons = [];
+    for (let i = 0; i < layers.length; i += 1) {
+        const layer = layers[i];
+        if (layer.missing.length > 0) {
+            blockReasons.push(layer.path + ": missing tokens " + quoteList(layer.missing));
+        }
+        for (let j = 0; j < layer.ordering_issues.length; j += 1) {
+            blockReasons.push(layer.path + ": " + layer.ordering_issues[j]);
+        }
+    }
+    for (let i = 0; i < inconsistentTokens.length; i += 1) {
+        const token = inconsistentTokens[i];
+        blockReasons.push("token '" +
+            token +
+            "' inconsistent across layers: present in " +
+            formatPaths(pathsWithToken(layers, token, true)) +
+            ", missing in " +
+            formatPaths(pathsWithToken(layers, token, false)));
+    }
+    return blockReasons;
+}
+function auditEnvelopeContract(spec, files) {
+    const fields = spec.fields || [];
+    const hasSchemaVersionPattern = typeof spec.schemaVersionPattern === "string";
+    const schemaVersionPattern = typeof spec.schemaVersionPattern === "string"
+        ? new RegExp(spec.schemaVersionPattern)
+        : null;
+    const schemaVersions = {};
+    const missingFields = {};
+    const layers = [];
+    for (let i = 0; i < files.length; i += 1) {
+        const file = files[i];
+        const layer = {
+            path: file.path,
+            present: [],
+            missing: [],
+            ordering_issues: []
+        };
+        if (schemaVersionPattern) {
+            const match = schemaVersionPattern.exec(file.content);
+            const schemaVersion = match && typeof match[1] === "string" ? match[1] : null;
+            layer.schema_version = schemaVersion;
+            schemaVersions[file.path] = schemaVersion;
+        }
+        const fileMissingFields = missingLiteralFields(fields, file.content);
+        if (fileMissingFields.length > 0) {
+            missingFields[file.path] = fileMissingFields;
+        }
+        layers.push(layer);
+    }
+    const crossLayer = {
+        inconsistent_tokens: [],
+        missing_fields: missingFields
+    };
+    if (hasSchemaVersionPattern) {
+        crossLayer.schema_versions = schemaVersions;
+    }
+    const blockReasons = envelopeBlockReasons(spec.schemaVersionPattern, layers, schemaVersions, missingFields);
+    return {
+        verdict: blockReasons.length > 0 ? "BLOCK" : "PASS",
+        mode: "envelope",
+        layers,
+        cross_layer: crossLayer,
+        block_reasons: blockReasons
+    };
+}
+function missingLiteralFields(fields, content) {
+    const missingFields = [];
+    for (let i = 0; i < fields.length; i += 1) {
+        const field = fields[i];
+        if (content.indexOf(field) === -1) {
+            missingFields.push(field);
+        }
+    }
+    return missingFields;
+}
+function envelopeBlockReasons(schemaVersionPattern, layers, schemaVersions, missingFields) {
+    const blockReasons = [];
+    if (typeof schemaVersionPattern === "string") {
+        for (let i = 0; i < layers.length; i += 1) {
+            const layer = layers[i];
+            if (layer.schema_version === null) {
+                blockReasons.push(layer.path + ": missing schema version using pattern '" + schemaVersionPattern + "'");
+            }
+        }
+        const versionGroups = groupSchemaVersionPaths(schemaVersions);
+        if (versionGroups.versions.length > 1) {
+            blockReasons.push("schema versions differ across layers: " + formatVersionGroups(versionGroups));
+        }
+    }
+    const missingFieldPaths = Object.keys(missingFields);
+    for (let i = 0; i < missingFieldPaths.length; i += 1) {
+        const path = missingFieldPaths[i];
+        blockReasons.push(path + ": missing fields " + quoteList(missingFields[path]));
+    }
+    return blockReasons;
+}
+function groupSchemaVersionPaths(schemaVersions) {
+    const versions = [];
+    const pathsByVersion = {};
+    const paths = Object.keys(schemaVersions);
+    for (let i = 0; i < paths.length; i += 1) {
+        const path = paths[i];
+        const version = schemaVersions[path];
+        if (version === null) {
+            continue;
+        }
+        if (!pathsByVersion[version]) {
+            pathsByVersion[version] = [];
+            versions.push(version);
+        }
+        pathsByVersion[version].push(path);
+    }
+    return { versions, pathsByVersion };
+}
+function pathsWithToken(layers, token, present) {
+    const paths = [];
+    for (let i = 0; i < layers.length; i += 1) {
+        const layer = layers[i];
+        const tokenList = present ? layer.present : layer.missing;
+        if (tokenList.indexOf(token) !== -1) {
+            paths.push(layer.path);
+        }
+    }
+    return paths;
+}
+function uniqueStrings(values) {
+    const uniqueValues = [];
+    for (let i = 0; i < values.length; i += 1) {
+        if (uniqueValues.indexOf(values[i]) === -1) {
+            uniqueValues.push(values[i]);
+        }
+    }
+    return uniqueValues;
+}
+function quoteList(values) {
+    const quotedValues = [];
+    for (let i = 0; i < values.length; i += 1) {
+        quotedValues.push("'" + values[i] + "'");
+    }
+    return quotedValues.join(", ");
+}
+function formatPaths(paths) {
+    return "[" + quoteList(paths) + "]";
+}
+function formatVersionGroups(versionGroups) {
+    const formattedGroups = [];
+    for (let i = 0; i < versionGroups.versions.length; i += 1) {
+        const version = versionGroups.versions[i];
+        formattedGroups.push("'" + version + "' in " + formatPaths(versionGroups.pathsByVersion[version]));
+    }
+    return formattedGroups.join(", ");
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

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