@printwithsynergy/synergy-mcp 0.1.1

package/dist/tools/stack-health-grid.js

@@ -0,0 +1,110 @@
+/**
+ * stack_health_grid — fetch /healthz (and /v1/contract when available)
+ * across the configured prod URLs for the stack, in parallel, and
+ * return a grid with status code + latency + version skew.
+ *
+ * Audit finding #15 in the cross-stack audit caught five different
+ * health/contract endpoint patterns. This tool branches per-service
+ * so the caller doesn't have to.
+ */
+import { z } from "zod";
+import { KNOWN_REPOS, PROD_URLS } from "../config.js";
+export const StackHealthGridInput = z.object({
+    repos: z
+        .array(z.string())
+        .optional()
+        .describe("Optional subset of repo names to check (e.g. ['codex-pdf', 'lint-pdf']). When omitted, checks every repo with a configured PROD URL."),
+    timeout_ms: z
+        .number()
+        .int()
+        .positive()
+        .default(5000)
+        .describe("Per-request timeout in ms. The whole grid still resolves; rows that time out get `status: 'timeout'`."),
+});
+/** Per-repo endpoint discovery — matches the divergence audit
+ *  finding #15 documented. */
+function endpointsFor(repo) {
+    switch (repo) {
+        case "codex-pdf":
+            return [
+                { endpoint: "v1/healthz", path: "/v1/healthz" },
+                { endpoint: "v1/contract", path: "/v1/contract" },
+            ];
+        case "lint-pdf":
+            return [
+                { endpoint: "health", path: "/health" },
+                { endpoint: "ready", path: "/ready" },
+            ];
+        case "compile-pdf":
+            return [
+                { endpoint: "v1/healthz", path: "/v1/healthz" },
+                { endpoint: "v1/contract", path: "/v1/contract" },
+            ];
+        case "synergy":
+            return [{ endpoint: "healthz", path: "/healthz" }];
+        case "platform":
+            return [{ endpoint: "healthz", path: "/healthz" }];
+        case "lens-pdf":
+            return []; // npm library — no HTTP surface
+    }
+}
+async function probe(url, timeout_ms) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), timeout_ms);
+    const t0 = performance.now();
+    try {
+        const res = await fetch(url, { signal: ctrl.signal });
+        const latency_ms = Math.round(performance.now() - t0);
+        let body_summary = "";
+        try {
+            const text = await res.text();
+            body_summary = text.slice(0, 200).replace(/\s+/g, " ").trim();
+        }
+        catch {
+            body_summary = "<unreadable body>";
+        }
+        return { status: res.status, latency_ms, body_summary };
+    }
+    catch (err) {
+        const latency_ms = Math.round(performance.now() - t0);
+        if (err instanceof Error && err.name === "AbortError") {
+            return { status: "timeout", latency_ms, body_summary: "" };
+        }
+        return {
+            status: "error",
+            latency_ms,
+            body_summary: err instanceof Error ? err.message : String(err),
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function stackHealthGrid(input) {
+    const subset = input.repos
+        ? input.repos.filter((r) => KNOWN_REPOS.includes(r))
+        : KNOWN_REPOS;
+    const notes = [];
+    const tasks = [];
+    for (const repo of subset) {
+        const base = PROD_URLS[repo];
+        if (!base) {
+            notes.push(`repo ${repo}: no PROD URL configured (set SYNERGY_MCP_URL_${repo
+                .toUpperCase()
+                .replace(/-/g, "_")})`);
+            continue;
+        }
+        for (const ep of endpointsFor(repo)) {
+            const url = `${base}${ep.path}`;
+            tasks.push(probe(url, input.timeout_ms).then((r) => ({
+                repo,
+                url,
+                endpoint: ep.endpoint,
+                ...r,
+            })));
+        }
+    }
+    const rows = await Promise.all(tasks);
+    return { rows, notes };
+}
+//# sourceMappingURL=stack-health-grid.js.map

package/dist/tools/stack-health-grid.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@printwithsynergy/synergy-mcp",
+  "version": "0.1.1",
+  "description": "Cross-stack dev-audit MCP server for the Print With Synergy stack — blast-radius queries, floor-pin grid, pattern audit, and stack health grid across codex-pdf / lint-pdf / lens-pdf / compile-pdf / synergy / platform.",
+  "license": "AGPL-3.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/printwithsynergy/synergy-mcp.git"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "synergy-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CLAUDE.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check src",
+    "lint:fix": "biome check --write src",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.0",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vite": "^6.4.2",
+    "vitest": "^4.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2",
+      "esbuild": "^0.25.0"
+    }
+  },
+  "packageManager": "pnpm@9.15.0"
+}