@dawmatt/api-grade-mcp 0.1.0

package/README.md

@@ -0,0 +1,128 @@
+# @dawmatt/api-grade-mcp
+
+MCP (Model Context Protocol) server that exposes api-grade capabilities as six AI tools — grade OpenAPI and AsyncAPI specifications directly from Claude Code, GitHub Copilot, or any MCP-compatible AI host.
+
+## Installation
+
+```bash
+npm install -g @dawmatt/api-grade-mcp
+```
+
+Or use without installing (recommended):
+
+```bash
+npx -y @dawmatt/api-grade-mcp
+```
+
+## Quick Start
+
+### Claude Code
+
+```bash
+claude mcp add api-grade -- npx -y @dawmatt/api-grade-mcp
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "api-grade": {
+      "command": "npx",
+      "args": ["-y", "@dawmatt/api-grade-mcp"]
+    }
+  }
+}
+```
+
+### GitHub Copilot (VS Code Agent mode)
+
+Create `.vscode/mcp.json` in your project root:
+
+```json
+{
+  "servers": {
+    "api-grade": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@dawmatt/api-grade-mcp"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `grade-api` | Letter grade, score, and summary — token-efficient overview |
+| `grade-api-detailed` | Full grade with all violations and diagnostics |
+| `assert-api-grade` | Pass/fail assertion for a minimum grade threshold |
+| `grade-api-quick-fixes-only` | Classified list of quick fixes (safe, non-breaking improvements) for AI-assisted correction |
+| `set-ruleset-config` | Set the default Spectral ruleset at session, workspace, or global scope |
+| `get-ruleset-config` | Get the active Spectral ruleset and which scope is effective |
+
+## Usage Examples
+
+Once configured, ask your AI tool naturally:
+
+```
+Grade the API at /workspace/my-api/openapi.yaml
+```
+
+```
+Check whether /workspace/my-api/openapi.yaml meets a minimum grade of B
+```
+
+```
+Apply quick fixes to /workspace/my-api/openapi.yaml
+```
+
+```
+Set the workspace default ruleset to https://github.example.com/org/standards/raw/main/ruleset.yaml
+```
+
+## Default Ruleset Configuration
+
+All grading tools support an optional `rulesetPath` per-request. To avoid supplying it every time, configure a default:
+
+- **Session** — in-memory, cleared on restart
+- **Workspace** — saved to `.api-grade/config.json` in the project root
+- **Global** — saved to `~/.api-grade/config.json`
+
+Precedence: per-request → session → workspace → global → built-in.
+
+Supported auth: GitHub PAT (`GITHUB_TOKEN` env var) and Microsoft Entra ID (device code flow).
+
+## Supported Spec Formats
+
+- OpenAPI 2.x (Swagger)
+- OpenAPI 3.x
+- AsyncAPI 2.x
+- AsyncAPI 3.x
+
+## Requirements
+
+- Node.js ≥ 20.0.0
+
+## Related Packages
+
+| Package | Purpose |
+|---------|---------|
+| [`@dawmatt/api-grade`](https://www.npmjs.com/package/@dawmatt/api-grade) | CLI tool — grade specs from the terminal |
+| [`@dawmatt/api-grade-core`](https://www.npmjs.com/package/@dawmatt/api-grade-core) | Grading engine — embed in your own tools |
+| [`@dawmatt/backstage-plugin-api-grade`](https://www.npmjs.com/package/@dawmatt/backstage-plugin-api-grade) | Backstage frontend card plugin |
+| [`@dawmatt/backstage-plugin-api-grade-backend`](https://www.npmjs.com/package/@dawmatt/backstage-plugin-api-grade-backend) | Backstage backend grading plugin |
+
+## Documentation
+
+- [Quick Start](https://github.com/DawMatt/api-grade/blob/main/docs/mcp/quick-start.md) — install and configure in minutes
+- [Configuration Reference](https://github.com/DawMatt/api-grade/blob/main/docs/mcp/configuration.md) — default rulesets, auth, and scope precedence
+- [Troubleshooting](https://github.com/DawMatt/api-grade/blob/main/docs/mcp/troubleshooting.md) — common issues and solutions
+- [Full Documentation](https://github.com/DawMatt/api-grade)
+
+## License
+
+MIT

package/dist/auth/entra.d.ts

@@ -0,0 +1,8 @@
+export declare class EntraAuthRequired extends Error {
+    readonly userCode: string;
+    readonly verificationUri: string;
+    readonly expiresIn: number;
+    constructor(userCode: string, verificationUri: string, expiresIn: number);
+}
+export declare function acquireEntraToken(tenantId: string, clientId: string): Promise<string>;
+//# sourceMappingURL=entra.d.ts.map

package/dist/auth/entra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entra.d.ts","sourceRoot":"","sources":["../../src/auth/entra.ts"],"names":[],"mappings":"AAMA,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,QAAQ,EAAE,MAAM;aAChB,eAAe,EAAE,MAAM;aACvB,SAAS,EAAE,MAAM;gBAFjB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM;CAKpC;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4C3F"}

package/dist/auth/entra.js

@@ -0,0 +1,59 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+const ENTRA_CACHE_PATH = join(homedir(), '.api-grade', 'entra-token-cache.json');
+export class EntraAuthRequired extends Error {
+    userCode;
+    verificationUri;
+    expiresIn;
+    constructor(userCode, verificationUri, expiresIn) {
+        super(`Entra ID authentication required. Visit ${verificationUri} and enter code ${userCode}.`);
+        this.userCode = userCode;
+        this.verificationUri = verificationUri;
+        this.expiresIn = expiresIn;
+        this.name = 'EntraAuthRequired';
+    }
+}
+export async function acquireEntraToken(tenantId, clientId) {
+    const { PublicClientApplication } = await import('@azure/msal-node');
+    const cachePlugin = {
+        async beforeCacheAccess(ctx) {
+            const data = await readFile(ENTRA_CACHE_PATH, 'utf-8').catch(() => '');
+            if (data)
+                ctx.tokenCache.deserialize(data);
+        },
+        async afterCacheAccess(ctx) {
+            if (ctx.cacheHasChanged) {
+                await mkdir(dirname(ENTRA_CACHE_PATH), { recursive: true });
+                await writeFile(ENTRA_CACHE_PATH, ctx.tokenCache.serialize(), 'utf-8');
+            }
+        },
+    };
+    const pca = new PublicClientApplication({
+        auth: { clientId, authority: `https://login.microsoftonline.com/${tenantId}` },
+        cache: { cachePlugin },
+    });
+    const scopes = [`api://${clientId}/.default`];
+    const accounts = await pca.getTokenCache().getAllAccounts();
+    if (accounts.length > 0) {
+        try {
+            const result = await pca.acquireTokenSilent({ scopes, account: accounts[0] });
+            if (result?.accessToken)
+                return result.accessToken;
+        }
+        catch {
+            // fall through to device-code flow
+        }
+    }
+    const result = await pca.acquireTokenByDeviceCode({
+        scopes,
+        deviceCodeCallback: (response) => {
+            throw new EntraAuthRequired(response.userCode, response.verificationUri, response.expiresIn);
+        },
+    });
+    if (!result?.accessToken) {
+        throw new Error('Entra ID token acquisition failed');
+    }
+    return result.accessToken;
+}
+//# sourceMappingURL=entra.js.map

package/dist/auth/entra.js.map

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

package/dist/auth/github.d.ts

@@ -0,0 +1,10 @@
+export declare const INITIAL_FETCH_TIMEOUT_MS = 5000;
+export declare const RETRY_FETCH_TIMEOUT_MS = 30000;
+export declare class RulesetAuthError extends Error {
+    readonly reason: 'auth-failed' | 'network-unreachable';
+    readonly url: string;
+    constructor(reason: 'auth-failed' | 'network-unreachable', url: string);
+}
+export declare function fetchRulesetContent(url: string, token: string | undefined, timeoutMs: number): Promise<string>;
+export declare function fetchRulesetWithGithubPat(url: string, token: string, timeoutMs: number): Promise<string>;
+//# sourceMappingURL=github.d.ts.map

package/dist/auth/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/auth/github.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,MAAM,EAAE,aAAa,GAAG,qBAAqB;aAC7C,GAAG,EAAE,MAAM;gBADX,MAAM,EAAE,aAAa,GAAG,qBAAqB,EAC7C,GAAG,EAAE,MAAM;CAK9B;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/dist/auth/github.js

@@ -0,0 +1,42 @@
+export const INITIAL_FETCH_TIMEOUT_MS = 5_000;
+export const RETRY_FETCH_TIMEOUT_MS = 30_000;
+export class RulesetAuthError extends Error {
+    reason;
+    url;
+    constructor(reason, url) {
+        super(`Failed to fetch ruleset from ${url}: ${reason}`);
+        this.reason = reason;
+        this.url = url;
+        this.name = 'RulesetAuthError';
+    }
+}
+export async function fetchRulesetContent(url, token, timeoutMs) {
+    const controller = new AbortController();
+    const id = setTimeout(() => controller.abort(), timeoutMs);
+    const headers = token ? { Authorization: `Bearer ${token}` } : {};
+    try {
+        const res = await fetch(url, { headers, signal: controller.signal });
+        if (res.status === 401 || res.status === 403) {
+            throw new RulesetAuthError('auth-failed', url);
+        }
+        if (!res.ok) {
+            throw new RulesetAuthError('network-unreachable', url);
+        }
+        return res.text();
+    }
+    catch (e) {
+        if (e instanceof RulesetAuthError)
+            throw e;
+        if (e instanceof Error && e.name === 'AbortError') {
+            throw new RulesetAuthError('network-unreachable', url);
+        }
+        throw new RulesetAuthError('network-unreachable', url);
+    }
+    finally {
+        clearTimeout(id);
+    }
+}
+export async function fetchRulesetWithGithubPat(url, token, timeoutMs) {
+    return fetchRulesetContent(url, token, timeoutMs);
+}
+//# sourceMappingURL=github.js.map

package/dist/auth/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/auth/github.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAC9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAEvB;IACA;IAFlB,YACkB,MAA6C,EAC7C,GAAW;QAE3B,KAAK,CAAC,gCAAgC,GAAG,KAAK,MAAM,EAAE,CAAC,CAAC;QAHxC,WAAM,GAAN,MAAM,CAAuC;QAC7C,QAAG,GAAH,GAAG,CAAQ;QAG3B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,KAAyB,EACzB,SAAiB;IAEjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,OAAO,GAA2B,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1F,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACrE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC7C,MAAM,IAAI,gBAAgB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,gBAAgB,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,gBAAgB;YAAE,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAClD,MAAM,IAAI,gBAAgB,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,GAAW,EACX,KAAa,EACb,SAAiB;IAEjB,OAAO,mBAAmB,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC"}

package/dist/config/resolve-ruleset.d.ts

@@ -0,0 +1,3 @@
+import type { RulesetConfig, RulesetResolution, SessionState } from '../types.js';
+export declare function resolveRuleset(perRequestPath: string | undefined | null, sessionState: SessionState, workspaceConfig: RulesetConfig | null, globalConfig: RulesetConfig | null): RulesetResolution;
+//# sourceMappingURL=resolve-ruleset.d.ts.map

package/dist/config/resolve-ruleset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-ruleset.d.ts","sourceRoot":"","sources":["../../src/config/resolve-ruleset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAElF,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACzC,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,aAAa,GAAG,IAAI,EACrC,YAAY,EAAE,aAAa,GAAG,IAAI,GACjC,iBAAiB,CAkCnB"}

package/dist/config/resolve-ruleset.js

@@ -0,0 +1,31 @@
+export function resolveRuleset(perRequestPath, sessionState, workspaceConfig, globalConfig) {
+    if (perRequestPath != null && perRequestPath !== '') {
+        return { rulesetPath: perRequestPath, scope: 'per-request', auth: null };
+    }
+    if (sessionState.sessionRulesetOverride === 'builtin') {
+        return { rulesetPath: null, scope: 'built-in', auth: null };
+    }
+    if (sessionState.defaultRuleset?.rulesetPath != null) {
+        return {
+            rulesetPath: sessionState.defaultRuleset.rulesetPath,
+            scope: 'session',
+            auth: sessionState.defaultRuleset.auth,
+        };
+    }
+    if (workspaceConfig?.rulesetPath != null) {
+        return {
+            rulesetPath: workspaceConfig.rulesetPath,
+            scope: 'workspace',
+            auth: workspaceConfig.auth,
+        };
+    }
+    if (globalConfig?.rulesetPath != null) {
+        return {
+            rulesetPath: globalConfig.rulesetPath,
+            scope: 'global',
+            auth: globalConfig.auth,
+        };
+    }
+    return { rulesetPath: null, scope: 'built-in', auth: null };
+}
+//# sourceMappingURL=resolve-ruleset.js.map

package/dist/config/resolve-ruleset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-ruleset.js","sourceRoot":"","sources":["../../src/config/resolve-ruleset.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAC5B,cAAyC,EACzC,YAA0B,EAC1B,eAAqC,EACrC,YAAkC;IAElC,IAAI,cAAc,IAAI,IAAI,IAAI,cAAc,KAAK,EAAE,EAAE,CAAC;QACpD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC3E,CAAC;IAED,IAAI,YAAY,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9D,CAAC;IAED,IAAI,YAAY,CAAC,cAAc,EAAE,WAAW,IAAI,IAAI,EAAE,CAAC;QACrD,OAAO;YACL,WAAW,EAAE,YAAY,CAAC,cAAc,CAAC,WAAW;YACpD,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,YAAY,CAAC,cAAc,CAAC,IAAI;SACvC,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,EAAE,WAAW,IAAI,IAAI,EAAE,CAAC;QACzC,OAAO;YACL,WAAW,EAAE,eAAe,CAAC,WAAW;YACxC,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,eAAe,CAAC,IAAI;SAC3B,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,EAAE,WAAW,IAAI,IAAI,EAAE,CAAC;QACtC,OAAO;YACL,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,YAAY,CAAC,IAAI;SACxB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC9D,CAAC"}

package/dist/config/ruleset-config.d.ts

@@ -0,0 +1,13 @@
+import type { RulesetConfig } from '../types.js';
+export declare class ConfigWriteError extends Error {
+    readonly cause?: unknown | undefined;
+    readonly code = "CONFIG_WRITE_ERROR";
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare function getWorkspaceConfigPath(): string;
+export declare function getGlobalConfigPath(): string;
+export declare function loadWorkspaceConfig(): Promise<RulesetConfig | null>;
+export declare function loadGlobalConfig(): Promise<RulesetConfig | null>;
+export declare function saveWorkspaceConfig(config: RulesetConfig): Promise<void>;
+export declare function saveGlobalConfig(config: RulesetConfig): Promise<void>;
+//# sourceMappingURL=ruleset-config.d.ts.map

package/dist/config/ruleset-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruleset-config.d.ts","sourceRoot":"","sources":["../../src/config/ruleset-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,qBAAa,gBAAiB,SAAQ,KAAK;IAEZ,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IADrD,QAAQ,CAAC,IAAI,wBAAwB;gBACzB,OAAO,EAAE,MAAM,EAAW,KAAK,CAAC,EAAE,OAAO,YAAA;CAItD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAuBD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAEzE;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAEtE;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E"}

package/dist/config/ruleset-config.js

@@ -0,0 +1,49 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+export class ConfigWriteError extends Error {
+    cause;
+    code = 'CONFIG_WRITE_ERROR';
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'ConfigWriteError';
+    }
+}
+export function getWorkspaceConfigPath() {
+    return join(process.cwd(), '.api-grade', 'config.json');
+}
+export function getGlobalConfigPath() {
+    return join(homedir(), '.api-grade', 'config.json');
+}
+async function loadConfig(filePath) {
+    try {
+        const data = await readFile(filePath, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+async function saveConfig(filePath, config) {
+    try {
+        await mkdir(dirname(filePath), { recursive: true });
+        await writeFile(filePath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    catch (err) {
+        throw new ConfigWriteError(`Could not write config to ${filePath}: ${err instanceof Error ? err.message : String(err)}`, err);
+    }
+}
+export async function loadWorkspaceConfig() {
+    return loadConfig(getWorkspaceConfigPath());
+}
+export async function loadGlobalConfig() {
+    return loadConfig(getGlobalConfigPath());
+}
+export async function saveWorkspaceConfig(config) {
+    return saveConfig(getWorkspaceConfigPath(), config);
+}
+export async function saveGlobalConfig(config) {
+    return saveConfig(getGlobalConfigPath(), config);
+}
+//# sourceMappingURL=ruleset-config.js.map

package/dist/config/ruleset-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruleset-config.js","sourceRoot":"","sources":["../../src/config/ruleset-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAEH;IAD7B,IAAI,GAAG,oBAAoB,CAAC;IACrC,YAAY,OAAe,EAAW,KAAe;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,UAAK,GAAL,KAAK,CAAU;QAEnD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AACtD,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,QAAgB,EAAE,MAAqB;IAC/D,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,gBAAgB,CACxB,6BAA6B,QAAQ,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC5F,GAAG,CACJ,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,OAAO,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,OAAO,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAqB;IAC7D,OAAO,UAAU,CAAC,sBAAsB,EAAE,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAqB;IAC1D,OAAO,UAAU,CAAC,mBAAmB,EAAE,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,6 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+const server = createServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBpE,wBAAgB,YAAY,IAAI,SAAS,CAUxC"}

package/dist/server.js

@@ -0,0 +1,33 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { resolve, dirname } from 'node:path';
+import { registerGradeTool } from './tools/grade.js';
+import { registerAssertGradeTool } from './tools/assert-grade.js';
+import { registerGradeDetailedTool } from './tools/grade-detailed.js';
+import { registerQuickFixesOnlyTool } from './tools/quick-fixes-only.js';
+import { registerSetRulesetConfigTool } from './tools/set-ruleset-config.js';
+import { registerGetRulesetConfigTool } from './tools/get-ruleset-config.js';
+function getVersion() {
+    try {
+        const require = createRequire(import.meta.url);
+        const __dirname = dirname(fileURLToPath(import.meta.url));
+        const pkg = require(resolve(__dirname, '../package.json'));
+        return pkg.version;
+    }
+    catch {
+        return '0.1.0';
+    }
+}
+export function createServer() {
+    const server = new McpServer({ name: 'api-grade', version: getVersion() });
+    const sessionState = { defaultRuleset: null, sessionRulesetOverride: null };
+    registerGradeTool(server, sessionState);
+    registerAssertGradeTool(server, sessionState);
+    registerGradeDetailedTool(server, sessionState);
+    registerQuickFixesOnlyTool(server, sessionState);
+    registerSetRulesetConfigTool(server, sessionState);
+    registerGetRulesetConfigTool(server, sessionState);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAG7E,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAwB,CAAC;QAClF,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAiB,EAAE,cAAc,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC;IAC1F,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,uBAAuB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC9C,yBAAyB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAChD,0BAA0B,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjD,4BAA4B,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnD,4BAA4B,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/assert-grade.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { SessionState } from '../types.js';
+export declare function registerAssertGradeTool(server: McpServer, sessionState: SessionState): void;
+//# sourceMappingURL=assert-grade.d.ts.map

package/dist/tools/assert-grade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-grade.d.ts","sourceRoot":"","sources":["../../src/tools/assert-grade.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,GAAG,IAAI,CAiJ3F"}

package/dist/tools/assert-grade.js

@@ -0,0 +1,132 @@
+import { statSync, writeFileSync, unlinkSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { GradeEngine, gradeToNumber, LETTER_GRADE_ORDER } from '@dawmatt/api-grade-core';
+import { mcpError, buildAuthFailureResponse, ERROR_CODES } from '../utils/errors.js';
+import { loadWorkspaceConfig, loadGlobalConfig } from '../config/ruleset-config.js';
+import { resolveRuleset } from '../config/resolve-ruleset.js';
+import { fetchRulesetContent, RulesetAuthError, INITIAL_FETCH_TIMEOUT_MS, RETRY_FETCH_TIMEOUT_MS } from '../auth/github.js';
+import { EntraAuthRequired, acquireEntraToken } from '../auth/entra.js';
+export function registerAssertGradeTool(server, sessionState) {
+    server.tool('assert-api-grade', 'Assert that an API specification meets a minimum grade threshold. Returns a structured pass/fail result. Use this in AI-assisted code review workflows or quality gates. Grade ordering: A (best) > B > C > D > F (worst).', {
+        specPath: z
+            .string()
+            .describe('Absolute or relative path to the OpenAPI or AsyncAPI specification file (YAML or JSON)'),
+        minimumGrade: z
+            .enum(['A', 'B', 'C', 'D', 'F'])
+            .describe('The minimum acceptable grade. The assertion passes if the actual grade is equal to or better than this value (A > B > C > D > F).'),
+        rulesetPath: z
+            .string()
+            .optional()
+            .describe('Optional path to a custom Spectral-compatible ruleset file'),
+        recoveryOption: z
+            .enum(['retry', 'use-builtin-once', 'use-builtin-session', 'cancel'])
+            .optional()
+            .describe('Recovery action when the configured default ruleset is inaccessible. Only supply in response to a RULESET_AUTH_FAILED response.'),
+    }, async ({ specPath, minimumGrade, rulesetPath, recoveryOption }) => {
+        if (!LETTER_GRADE_ORDER.includes(minimumGrade)) {
+            return mcpError(ERROR_CODES.INVALID_GRADE, `Invalid minimumGrade '${minimumGrade}'. Must be one of: A, B, C, D, F.`, { minimumGrade });
+        }
+        if (recoveryOption === 'cancel') {
+            return mcpError(ERROR_CODES.REQUEST_CANCELLED, 'Grading request cancelled by user.', { specPath });
+        }
+        if (recoveryOption === 'use-builtin-session') {
+            sessionState.sessionRulesetOverride = 'builtin';
+        }
+        const workspaceConfig = await loadWorkspaceConfig();
+        const globalConfig = await loadGlobalConfig();
+        const resolved = resolveRuleset(rulesetPath, sessionState, workspaceConfig, globalConfig);
+        let effectiveRulesetPath = resolved.rulesetPath ?? undefined;
+        let tempRulesetFile;
+        if (resolved.rulesetPath?.startsWith('http')) {
+            if (recoveryOption === 'use-builtin-once') {
+                effectiveRulesetPath = undefined;
+            }
+            else {
+                const timeoutMs = recoveryOption === 'retry' ? RETRY_FETCH_TIMEOUT_MS : INITIAL_FETCH_TIMEOUT_MS;
+                try {
+                    let content;
+                    if (resolved.auth?.type === 'github-pat') {
+                        const token = resolved.auth.githubToken ?? process.env.GITHUB_TOKEN ?? '';
+                        content = await fetchRulesetContent(resolved.rulesetPath, token || undefined, timeoutMs);
+                    }
+                    else if (resolved.auth?.type === 'entra-id' && resolved.auth.tenantId && resolved.auth.clientId) {
+                        const token = await acquireEntraToken(resolved.auth.tenantId, resolved.auth.clientId);
+                        content = await fetchRulesetContent(resolved.rulesetPath, token, timeoutMs);
+                    }
+                    else {
+                        content = await fetchRulesetContent(resolved.rulesetPath, undefined, timeoutMs);
+                    }
+                    tempRulesetFile = join(tmpdir(), `api-grade-ruleset-${Date.now()}.yaml`);
+                    writeFileSync(tempRulesetFile, content);
+                    effectiveRulesetPath = tempRulesetFile;
+                }
+                catch (err) {
+                    if (err instanceof EntraAuthRequired) {
+                        return {
+                            content: [{
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        error: ERROR_CODES.ENTRA_AUTH_REQUIRED,
+                                        deviceCodeUrl: err.verificationUri,
+                                        userCode: err.userCode,
+                                        expiresIn: err.expiresIn,
+                                        message: `Complete Entra ID sign-in: Visit ${err.verificationUri} and enter code ${err.userCode}`,
+                                    }),
+                                }],
+                            isError: true,
+                        };
+                    }
+                    const reason = err instanceof RulesetAuthError ? err.reason : 'network-unreachable';
+                    return buildAuthFailureResponse(reason, resolved.rulesetPath, resolved.scope, `Could not fetch ruleset from '${resolved.rulesetPath}' (${resolved.scope} default): ${reason.replace('-', ' ')}.`);
+                }
+            }
+        }
+        else if (effectiveRulesetPath) {
+            try {
+                statSync(effectiveRulesetPath);
+            }
+            catch {
+                return mcpError(ERROR_CODES.RULESET_NOT_FOUND, `The ruleset file '${effectiveRulesetPath}' does not exist. Check the path and try again.`, { rulesetPath: effectiveRulesetPath });
+            }
+        }
+        try {
+            statSync(specPath);
+        }
+        catch {
+            if (tempRulesetFile)
+                try {
+                    unlinkSync(tempRulesetFile);
+                }
+                catch { /* ignore */ }
+            return mcpError(ERROR_CODES.SPEC_NOT_FOUND, `The specification file '${specPath}' does not exist. Check the path and try again.`, { specPath });
+        }
+        try {
+            const engine = new GradeEngine();
+            const result = await engine.grade({ specPath, rulesetPath: effectiveRulesetPath });
+            const actual = result.letterGrade;
+            const passed = gradeToNumber(actual) <= gradeToNumber(minimumGrade);
+            const response = {
+                passed,
+                actual,
+                minimum: minimumGrade,
+                specPath: result.specPath,
+                numericScore: result.numericScore,
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(response) }] };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return mcpError(ERROR_CODES.GRADE_ENGINE_ERROR, `GradeEngine error: ${message}`, { specPath });
+        }
+        finally {
+            if (tempRulesetFile)
+                try {
+                    unlinkSync(tempRulesetFile);
+                }
+                catch { /* ignore */ }
+        }
+    });
+}
+//# sourceMappingURL=assert-grade.js.map

package/dist/tools/assert-grade.js.map

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

package/dist/tools/configure-ruleset.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { SessionState } from '../types.js';
+export declare function registerConfigureRulesetTool(server: McpServer, sessionState: SessionState): void;
+//# sourceMappingURL=configure-ruleset.d.ts.map

package/dist/tools/configure-ruleset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-ruleset.d.ts","sourceRoot":"","sources":["../../src/tools/configure-ruleset.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,OAAO,KAAK,EAAE,YAAY,EAA6B,MAAM,aAAa,CAAC;AAE3E,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,GAAG,IAAI,CAwHhG"}