@printwithsynergy/synergy-mcp 0.1.1

package/README.md

@@ -0,0 +1,160 @@
+# synergy-mcp
+
+Cross-stack dev-audit MCP server for the [Print With Synergy](https://printwithsynergy.com)
+stack.
+
+Serves four tools over the MCP stdio transport, scoped to the six repos in the
+stack — `codex-pdf`, `lint-pdf`, `lens-pdf`, `compile-pdf`, `synergy`, `platform`:
+
+| Tool                 | What it answers                                                       |
+| -------------------- | --------------------------------------------------------------------- |
+| `blast_radius`       | Who breaks if I change this symbol / route / env var?                 |
+| `floor_pin_grid`     | Which repo pins which org package, at which version?                  |
+| `pattern_audit`      | Which repos have CI / consume-surface / RFC 7807 / deep CLAUDE.md? |
+| `stack_health_grid`  | What does `/healthz` + `/v1/contract` say across the prod URLs?       |
+
+Built to close gaps the cross-stack architecture audit surfaced — pin drift,
+pattern divergence, "lens vs lens-server" naming collisions, ad-hoc health
+endpoint shapes.
+
+## Install
+
+```bash
+npm install -g @printwithsynergy/synergy-mcp
+# or use npx directly from your MCP client config
+```
+
+## Configure
+
+The server needs to know where your six repo working trees live. Two ways:
+
+### 1. Stack root (recommended)
+
+If you clone every repo into a single parent directory:
+
+```bash
+export SYNERGY_MCP_STACK_ROOT=$HOME/code/printwithsynergy
+# expects $HOME/code/printwithsynergy/{codex-pdf,lint-pdf,lens-pdf,compile-pdf,synergy,platform}
+```
+
+### 2. Per-repo overrides
+
+For non-uniform paths:
+
+```bash
+export SYNERGY_MCP_PATH_CODEX_PDF=/path/to/codex-pdf
+export SYNERGY_MCP_PATH_LINT_PDF=/path/to/lint-pdf
+# ... one per repo
+```
+
+Per-repo env wins over `SYNERGY_MCP_STACK_ROOT` for the same repo. Repos that
+don't resolve are simply skipped — tools return rows for whatever is available
+plus a `notes[]` entry naming the missing repo.
+
+### Prod URLs (for `stack_health_grid` only)
+
+Defaults match the production hostnames the audit catalogued; override per
+service:
+
+```bash
+export SYNERGY_MCP_URL_CODEX_PDF=https://codex.lintpdf.com
+export SYNERGY_MCP_URL_LINT_PDF=https://lintpdf.com
+export SYNERGY_MCP_URL_COMPILE_PDF=https://compilepdf.com
+export SYNERGY_MCP_URL_SYNERGY=https://...        # not set by default
+export SYNERGY_MCP_URL_PLATFORM=https://...       # not set by default
+# lens-pdf has no HTTP surface (npm library only) — no URL needed.
+```
+
+## Use from Claude Code
+
+Add to your Claude Code MCP config (`~/.config/claude-code/mcp.json` or
+project-local equivalent):
+
+```json
+{
+  "mcpServers": {
+    "synergy-mcp": {
+      "command": "npx",
+      "args": ["-y", "@printwithsynergy/synergy-mcp"],
+      "env": {
+        "SYNERGY_MCP_STACK_ROOT": "/Users/you/code/printwithsynergy"
+      }
+    }
+  }
+}
+```
+
+Tools then show up as `mcp__synergy_mcp__blast_radius`,
+`mcp__synergy_mcp__floor_pin_grid`, etc.
+
+## Tools
+
+### `blast_radius`
+
+```json
+{
+  "target": "CodexDocument",
+  "kind": "symbol"
+}
+```
+
+Kinds: `symbol` | `route` | `env_var`. Default `symbol`.
+
+Returns per-hit `{ repo, file, line, text, kind }` where `kind` is one of
+`import` | `usage` | `route` | `env`.
+
+Implementation note: regex-based (Python `from X import Y`, TS
+`import { Y } from 'X'`, plus bare-name usage). Not AST.
+[`ctxo`](https://github.com/anthropics/code-review-graph) ships a real AST
+backed blast-radius for TS/Go/C# but doesn't have a Python plugin yet; this
+tool fills the gap with the working substitute that lint-pdf's `CLAUDE.md`
+already calls out.
+
+### `floor_pin_grid`
+
+```json
+{ "package": "codex-pdf" }
+```
+
+Or omit `package` to return rows for every detected org package.
+
+Audit finding #2 — the bug it would have caught on day one: lint-pdf pinning
+`codex-pdf>=1.19.0` with no upper bound while compile-pdf pinned `<2.0`.
+
+### `pattern_audit`
+
+```json
+{ "patterns": ["has_ci", "has_problem_details_errors"] }
+```
+
+Omit `patterns` to run every known probe. Each row is
+`{ repo, pattern, present, evidence }`. Available patterns are listed in the
+result's `available_patterns` field.
+
+Probes are intentionally cheap (file existence, shallow grep). Audit findings
+#1, #6, #13, and #4 each get a probe.
+
+### `stack_health_grid`
+
+```json
+{ "timeout_ms": 5000 }
+```
+
+Optional `repos: ["codex-pdf", "synergy"]` to subset.
+
+Each row: `{ repo, url, endpoint, status, latency_ms, body_summary }`. Endpoint
+mapping per repo matches audit finding #15.
+
+## Develop
+
+```bash
+pnpm install
+pnpm dev                    # tsx watch
+pnpm typecheck              # tsc --noEmit
+pnpm test                   # vitest run
+pnpm build                  # tsc → dist/
+```
+
+## License
+
+AGPL-3.0-or-later, matching the rest of the printwithsynergy engine stack.

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+export type RepoName = "codex-pdf" | "lint-pdf" | "lens-pdf" | "compile-pdf" | "synergy" | "platform";
+export declare const KNOWN_REPOS: RepoName[];
+/** Language tag drives which AST / pattern set to use. */
+export type RepoLang = "python" | "typescript";
+export declare const REPO_LANG: Record<RepoName, RepoLang>;
+/** Prod URLs for stack_health_grid. Override via env. */
+export declare const PROD_URLS: Record<RepoName, string | null>;
+/** Resolve the working-tree path for a single repo, or null. */
+export declare function resolveRepoPath(repo: RepoName): string | null;
+/** Resolve all six repo paths. Missing repos appear as null. */
+export declare function resolveAllRepoPaths(): Record<RepoName, string | null>;
+/** True if any repo resolves; the caller can surface `config_missing`. */
+export declare function hasAnyRepo(): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,UAAU,GACV,UAAU,GACV,aAAa,GACb,SAAS,GACT,UAAU,CAAC;AAEf,eAAO,MAAM,WAAW,EAAE,QAAQ,EAOjC,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE/C,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAOhD,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CASrD,CAAC;AAUF,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAW7D;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC,CAMrE;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,IAAI,OAAO,CAEpC"}

package/dist/config.js

@@ -0,0 +1,78 @@
+/**
+ * Stack configuration.
+ *
+ * synergy-mcp serves a cross-stack dev-audit MCP over six repos in
+ * the Print With Synergy stack. It needs to know where each repo's
+ * working tree is on the host. Two ways to tell it:
+ *
+ * 1. Env vars (per-repo): SYNERGY_MCP_PATH_CODEX_PDF=/path/to/codex-pdf
+ *    (...one per repo). Highest priority.
+ * 2. Stack root env: SYNERGY_MCP_STACK_ROOT=/path/to/clones — assumes
+ *    each repo is a sibling directory named after the repo. This is
+ *    the common case when you clone all six into a single
+ *    `printwithsynergy/` directory.
+ *
+ * If neither is set, the server starts but every tool returns an
+ * empty result with a `config_missing` flag so the caller can prompt
+ * the user to configure.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+export const KNOWN_REPOS = [
+    "codex-pdf",
+    "lint-pdf",
+    "lens-pdf",
+    "compile-pdf",
+    "synergy",
+    "platform",
+];
+export const REPO_LANG = {
+    "codex-pdf": "python",
+    "lint-pdf": "python",
+    "compile-pdf": "python",
+    "lens-pdf": "typescript",
+    synergy: "typescript",
+    platform: "typescript",
+};
+/** Prod URLs for stack_health_grid. Override via env. */
+export const PROD_URLS = {
+    "codex-pdf": process.env.SYNERGY_MCP_URL_CODEX_PDF ?? "https://codex.lintpdf.com",
+    "lint-pdf": process.env.SYNERGY_MCP_URL_LINT_PDF ?? "https://lintpdf.com",
+    "compile-pdf": process.env.SYNERGY_MCP_URL_COMPILE_PDF ?? "https://compilepdf.com",
+    "lens-pdf": null, // npm library — no prod URL
+    synergy: process.env.SYNERGY_MCP_URL_SYNERGY ?? null,
+    platform: process.env.SYNERGY_MCP_URL_PLATFORM ?? null,
+};
+/**
+ * Map a RepoName to its env-var-friendly UPPERCASE_SNAKE form, e.g.
+ * "codex-pdf" → "CODEX_PDF". Used to look up SYNERGY_MCP_PATH_<NAME>.
+ */
+function envKey(repo) {
+    return repo.toUpperCase().replace(/-/g, "_");
+}
+/** Resolve the working-tree path for a single repo, or null. */
+export function resolveRepoPath(repo) {
+    const perRepoEnv = process.env[`SYNERGY_MCP_PATH_${envKey(repo)}`];
+    if (perRepoEnv && existsSync(perRepoEnv))
+        return perRepoEnv;
+    const stackRoot = process.env.SYNERGY_MCP_STACK_ROOT;
+    if (stackRoot) {
+        const guess = join(stackRoot, repo);
+        if (existsSync(guess))
+            return guess;
+    }
+    return null;
+}
+/** Resolve all six repo paths. Missing repos appear as null. */
+export function resolveAllRepoPaths() {
+    const result = {};
+    for (const repo of KNOWN_REPOS) {
+        result[repo] = resolveRepoPath(repo);
+    }
+    return result;
+}
+/** True if any repo resolves; the caller can surface `config_missing`. */
+export function hasAnyRepo() {
+    return KNOWN_REPOS.some((r) => resolveRepoPath(r) !== null);
+}
+//# 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;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAUjC,MAAM,CAAC,MAAM,WAAW,GAAe;IACrC,WAAW;IACX,UAAU;IACV,UAAU;IACV,aAAa;IACb,SAAS;IACT,UAAU;CACX,CAAC;AAKF,MAAM,CAAC,MAAM,SAAS,GAA+B;IACnD,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,QAAQ;IACpB,aAAa,EAAE,QAAQ;IACvB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,YAAY;CACvB,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,SAAS,GAAoC;IACxD,WAAW,EACT,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,2BAA2B;IACtE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,qBAAqB;IACzE,aAAa,EACX,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,wBAAwB;IACrE,UAAU,EAAE,IAAI,EAAE,4BAA4B;IAC9C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,IAAI;IACpD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,IAAI;CACvD,CAAC;AAEF;;;GAGG;AACH,SAAS,MAAM,CAAC,IAAc;IAC5B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,eAAe,CAAC,IAAc;IAC5C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAE5D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACrD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACpC,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAA6C,EAAE,CAAC;IAC5D,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAyC,CAAC;AACnD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,UAAU;IACxB,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAC9D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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,166 @@
+#!/usr/bin/env node
+/**
+ * synergy-mcp — cross-stack dev-audit MCP server for the Print With
+ * Synergy stack. Serves four tools over stdio:
+ *
+ *  - blast_radius — find every call site of a symbol / route / env
+ *    var across the six configured repos.
+ *  - floor_pin_grid — the (repo × org-package × version-spec) matrix.
+ *  - pattern_audit — the (repo × architectural-pattern) matrix.
+ *  - stack_health_grid — parallel /healthz + /v1/contract probes
+ *    across the prod URLs.
+ *
+ * Configuration is via environment variables — see ./config.ts.
+ * Designed to run from Claude Code via `npx @printwithsynergy/synergy-mcp`
+ * (or installed globally) over the stdio transport.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { hasAnyRepo } from "./config.js";
+import { BlastRadiusInput, blastRadius } from "./tools/blast-radius.js";
+import { FloorPinGridInput, floorPinGrid } from "./tools/floor-pin-grid.js";
+import { PatternAuditInput, patternAudit } from "./tools/pattern-audit.js";
+import { StackHealthGridInput, stackHealthGrid, } from "./tools/stack-health-grid.js";
+const SERVER_NAME = "synergy-mcp";
+const SERVER_VERSION = "0.1.0";
+const TOOLS = [
+    {
+        name: "blast_radius",
+        description: "Find every call site of a symbol, HTTP route, or env var across the printwithsynergy stack's six repos (codex-pdf, lint-pdf, lens-pdf, compile-pdf, synergy, platform). Use to answer 'who breaks if I change X?' before refactoring across the seam.",
+        schema: BlastRadiusInput,
+        handler: blastRadius,
+    },
+    {
+        name: "floor_pin_grid",
+        description: "Return the (repo × org-package × version-spec) matrix across pyproject.toml dependencies + package.json {dependencies,devDependencies,peerDependencies}. Detects drift — e.g. one repo pinning codex-pdf>=1.19.0 with no upper bound while another caps at <2.0.",
+        schema: FloorPinGridInput,
+        handler: floorPinGrid,
+    },
+    {
+        name: "pattern_audit",
+        description: "Return the (repo × pattern) matrix for the architectural patterns the cross-stack audit found inconsistently applied. Patterns include presence of CI workflows, the /v1/contract endpoint, consume-surface-audit / engine-purity tripwires, RFC 7807 Problem Details, and CLAUDE.md depth.",
+        schema: PatternAuditInput,
+        handler: patternAudit,
+    },
+    {
+        name: "stack_health_grid",
+        description: "Fetch /healthz and /v1/contract (where exposed) across the configured prod URLs for the stack, in parallel, returning status code + latency + body summary per probe. Branches per-repo for the five different endpoint shapes the audit cataloged.",
+        schema: StackHealthGridInput,
+        handler: stackHealthGrid,
+    },
+];
+/** Render a Zod object schema to a minimal JSON Schema. */
+function toJsonSchema(zod) {
+    const shape = zod.shape;
+    const properties = {};
+    const required = [];
+    for (const [key, raw] of Object.entries(shape)) {
+        const field = raw;
+        const description = field.description ?? undefined;
+        const entry = { description };
+        let inner = field;
+        if (field instanceof z.ZodOptional || field instanceof z.ZodDefault) {
+            inner = field._def.innerType;
+        }
+        else {
+            required.push(key);
+        }
+        if (inner instanceof z.ZodString) {
+            entry.type = "string";
+        }
+        else if (inner instanceof z.ZodNumber) {
+            entry.type = "number";
+        }
+        else if (inner instanceof z.ZodBoolean) {
+            entry.type = "boolean";
+        }
+        else if (inner instanceof z.ZodEnum) {
+            entry.type = "string";
+            entry.enum = inner._def.values;
+        }
+        else if (inner instanceof z.ZodArray) {
+            entry.type = "array";
+            entry.items = { type: "string" };
+        }
+        else {
+            entry.type = "object";
+        }
+        properties[key] = entry;
+    }
+    const out = {
+        type: "object",
+        properties,
+    };
+    if (required.length > 0)
+        out.required = required;
+    return out;
+}
+async function main() {
+    const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        const tools = TOOLS.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: toJsonSchema(t.schema),
+        }));
+        return { tools };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const tool = TOOLS.find((t) => t.name === name);
+        if (!tool) {
+            return {
+                content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                isError: true,
+            };
+        }
+        if (!hasAnyRepo() && name !== "stack_health_grid") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No repos configured. Set SYNERGY_MCP_STACK_ROOT to the directory containing your six repo clones, or SYNERGY_MCP_PATH_<REPO> per-repo (e.g. SYNERGY_MCP_PATH_CODEX_PDF=/path/to/codex-pdf).",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const parsed = tool.schema.safeParse(args ?? {});
+        if (!parsed.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Invalid arguments for ${name}: ${parsed.error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const result = await tool.handler(parsed.data);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: `Tool error: ${msg}` }],
+                isError: true,
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Lifecycle: server runs until stdio closes.
+}
+main().catch((err) => {
+    console.error("synergy-mcp fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/blast-radius.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { type RepoName } from "../config.js";
+export declare const BlastRadiusInput: z.ZodObject<{
+    target: z.ZodString;
+    kind: z.ZodDefault<z.ZodEnum<["symbol", "route", "env_var"]>>;
+    repos: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    max_results_per_repo: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    target: string;
+    kind: "symbol" | "route" | "env_var";
+    max_results_per_repo: number;
+    repos?: string[] | undefined;
+}, {
+    target: string;
+    kind?: "symbol" | "route" | "env_var" | undefined;
+    repos?: string[] | undefined;
+    max_results_per_repo?: number | undefined;
+}>;
+export interface BlastRadiusHit {
+    repo: RepoName;
+    file: string;
+    line: number;
+    text: string;
+    kind: "import" | "usage" | "route" | "env";
+}
+export interface BlastRadiusResult {
+    target: string;
+    kind: z.infer<typeof BlastRadiusInput>["kind"];
+    hits: BlastRadiusHit[];
+    notes: string[];
+}
+export declare function blastRadius(input: z.infer<typeof BlastRadiusInput>): Promise<BlastRadiusResult>;
+//# sourceMappingURL=blast-radius.d.ts.map

package/dist/tools/blast-radius.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blast-radius.d.ts","sourceRoot":"","sources":["../../src/tools/blast-radius.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAIL,KAAK,QAAQ,EAEd,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAyB3B,CAAC;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;CAC5C;AA0JD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC,iBAAiB,CAAC,CA2B5B"}